鱼皮AI导航
鱼皮AI导航
  • 主页
  • 社区
  • AI工具
  • AI知识库
  • AI提示词
  • MCP
  • Skills
  • AI学习资源
  • AI资讯
  • GitHub开源
登录/注册

dsh-local-ai

DeepSeek Harness 的 Ollama 接入:模型管理、健康检查、基于规则的本地路由与云端回退。

模型接入
访问 GitHub
文档README

🤖 dsh-local-ai

  • 1024 商店渠道:先 npm i -g dsh1024,再 dsh1024 plugin --profile web add dsh-local-ai(计入 deepseek1024.com 安装排行)。

DeepSeek Harness 的本地模型(Ollama)接入。

发现、拉取、删除、查看本地模型,按任务类型或关键词把请求分流到本地模型并在失败时自动回退云端,通过 /ollama 一键查看状态总览。

官方仓库。 本仓库是 dsh-local-ai 的唯一官方仓库,由 PerryLink 维护。其他账号下的同名仓库与本项目无关。

English · 简体中文 · Español · Português · हिन्दी


Compatibility

项目状态
HarnessDeepSeek Harness dsh-v0.1.3-alpha.1(2026-09-04 已适配):会话信封保留 ignorable 字段但仅用于存量日志读取兼容——Session.append 仍无法盖章,门控行为不变。已于 2026-09-06 对照 dsh-v0.1.3-alpha.1 master checkout 核验(完整门控链 + profile 安装冒烟)。
Node^22.19.0 || >=24.0.0
后端Ollama(本地 HTTP API + CLI 探测)
模型纯文本路由(inputModalities: ['text']);支持工具调用与工具结果

What you get

dsh-local-ai 让 Ollama 成为 DeepSeek Harness 的一等本地模型提供方:

  • 发现与管理 — ollama_list(已安装模型 / 运行中 / 磁盘占用)、ollama_show(参数尺寸、量化、上下文长度)、ollama_pull、ollama_remove。
  • 健康检查 — 进程存活(经 ollama CLI)与 API 响应(经 /api/version),作为两个独立信号报告。
  • 官方适配器 — 通过 ctx.llm.registerAdapter(LlmAdapter)注册 ollama 提供方路由,支持配置模型映射与 temperature / max-tokens / stop 参数翻译。
  • 本地路由 — model_route 规则按任务类型(purpose)、不区分大小写的关键词或 always 分流到本地模型,本地路由在产出内容前失败时自动回退云端。
  • /ollama 命令 — 一键状态总览:模型、磁盘占用、健康、建议。
  • 零依赖、HTTP 优先 — 一切走 Ollama HTTP API(CLI 仅用于进程探测);不捆绑模型文件。
▼
text
复制代码
request (loop) │ llm/stream 瀑布 ├─ 命中规则? ──▶ 路由到 ollama ──▶ Ollama /api/chat(NDJSON 流) │ └─ 先失败 ─▶ 回退云端(next()) └─ 未命中 ──▶ 云端提供方 tools ──▶ /api/tags · /api/ps · /api/show · /api/pull · /api/delete health ──▶ /api/version(API)+ ollama list(进程)

Quick start

▼
sh
复制代码
# 1. 把 bundle 安装进你的 profile dsh plugin --profile web add "github:PerryLink/dsh-local-ai#main" # 或从 npm(正式发布版) dsh plugin --profile web add dsh-local-ai # 2. 在 profile patch(cordis.yml)里配置路由并重启 dsh --profile web

最小路由配置(该规则在 cordis.patch.yml 里以注释形式给出):

▼
yaml
复制代码
- insert: - id: dsh-local-ai name: dsh-local-ai config: route: - model: llama3.2 keywords: ["confidential", "offline"]

验证 row 是否挂载:

▼
sh
复制代码
dsh --profile web --dump-config | grep -A2 'id: dsh-local-ai'

Install & uninstall

  • git 通道(最新 main):dsh plugin --profile web add "github:PerryLink/dsh-local-ai#main" —— prepare 脚本只使用生产依赖构建。
  • npm 通道(正式发布版):dsh plugin --profile web add dsh-local-ai。
  • tarball 通道:在本仓库 pnpm pack,然后 dsh plugin --profile web add ./dsh-local-ai-<version>.tgz。
  • 卸载:dsh plugin --profile web remove dsh-local-ai(或从 profile patch 移除该 row)。

如果 pnpm 对本包报告 ERR_PNPM_IGNORED_BUILDS,请在 pnpm-workspace.yaml 里加 allowBuilds: { esbuild: true } —— dsh CLI 会打印精确片段。

Configuration

所有可调参数都是 Schemastery Config 字段(可在 cordis.yml 中修改)。按 id 覆盖会替换整个 row —— 重述你需要的每个键。cordis.patch.yml 对每个键都有行内注释。

KeyDefaultMeaning
baseURLhttp://127.0.0.1:11434Ollama HTTP API 基础 URL;会追加 /api/* 路径
requestTimeoutMs30000单次请求 HTTP 超时(毫秒)
graceMs15000健康检查 CLI 探测的子进程终止宽限
defaultContextWindow8192模型无精确值时的上下文容量
maxTokens4096模型无精确值时的单请求输出上限
temperature(none)默认采样温度(0..2);省略则用提供方默认值
visiontrue模型报告 vision 能力时声明并序列化图片支持;false 保持纯文本路由
models[]Harness 可见名 → Ollama 模型映射
models[].name(required)Harness 可见模型名(GenerateOptions.model)
models[].model= nameOllama 模型 id
models[].contextWindow(none)该模型的上下文容量
models[].maxTokens(none)该模型的输出上限
models[].temperature(none)该模型的采样温度
backends[]OpenAI 兼容的本地后端(LM Studio / vLLM / llama.cpp)
backends[].name(required)后端名;注册为 provider id openai:<name>
backends[].baseURL(required)后端 base URL(含 /v1),如 http://127.0.0.1:1234/v1
backends[].apiKey(none)可选 bearer API key(多数本地服务器留空)
backends[].models[]界面可见名 → 后端模型映射
backends[].maxTokens4096该后端无精确值时的输出上限
backends[].temperature(none)该后端的采样温度
route[]本地模型路由规则(首个命中生效)
route[].model(required)目标本地模型名
route[].providerollama目标 provider id:ollama 或 openai:<name>
route[].purpose(none)任务类型匹配:compaction / session-title
route[].keywords[]不区分大小写的请求关键词
route[].alwaysfalse把所有符合条件的请求路由到此模型

Tools & surfaces

界面类型作用
ollama_list工具列出已安装模型、运行中模型与磁盘占用
ollama_show工具显示参数尺寸、量化、上下文长度、family、format
ollama_pull工具拉取(下载)模型
ollama_remove工具删除模型
ollama_health工具进程存活 + API 响应
/ollama命令一键状态总览(模型 + 健康 + 建议)

消费 公开 host 服务 ctx.llm(registerAdapter)、ctx.tools、ctx.subprocess(CLI 探测)、ctx.commands。默认不短路 llm/stream —— 路由监听器在无规则命中时透传(next())。

Permissions & data

  • 权限:对您配置的 Ollama 端点的 network:outbound;无原生代码、无文件系统访问、无存储。
  • 数据:展示给模型或用户的每个模型列表/详情、健康事实与错误消息在展示前都经过脱敏(去除端点 userinfo 与密钥查询参数、剥离控制字符、限制长度)。工具与命令结果由 harness 自身的 tool/command 机制记录。
  • 凭据:插件不存储也不读取任何凭据。它只向您配置的端点发起 HTTP 请求,外加本地 ollama list 进程探测。

Security boundaries

  • 默认不重路由 —— route 列表默认为空;请求只有通过显式规则或显式选择 ollama 提供方才会到达本地模型。
  • 展示前脱敏 —— 端点地址与本地路径在进入工具输出、/ollama 命令或错误消息前都会被脱敏。
  • 零捆绑模型 —— 下载与存储是 Ollama 自己的事;包内不含任何模型。
  • 失败响亮、失败可控 —— 非法配置导致挂载失败;本地路由在产出内容前失败会回退云端(next()),因此 Ollama 宕机不会卡死对话。
  • 模型可见 ⟺ 已记录 —— 路由只改变由哪个提供方服务请求(assistant 消息会以 ollama 来源记录);不凭空新增模型可见输入。

Known limitations

  • npm 0.1.2-rc.1 —— 针对 @deepseek-ai/dsh@0.1.2-rc.1 开发与测试;更新版本的 harness 基线预期可用,但由每月 compat workflow 验证。
  • 模型声明 vision 时启用视觉 — /api/show capabilities 含 vision 的模型声明 inputModalities: ["text","image"],并在用户消息上携带 base64 图片载荷(可用 vision: false 退出);纯文本模型仍拒绝图片内容(UNSUPPORTED_CONTENT)。
  • 中途失败不回退 —— 本地路由一旦开始产出内容,之后的失败会透传(无法撤回);只有首个 token 前的失败才回退云端。

Development

▼
sh
复制代码
pnpm install # node ^22.19 || >=24 pnpm run typecheck # tsc:src + 测试,对发布版 0.1.2-rc.1 类型 pnpm run typecheck:ci # 严格 tsc,对发布版 rc.2 类型(关闭 skipLibCheck) pnpm test # vitest:真实 Context/LlmRuntime/ToolRuntime/CommandRuntime/subprocess 机制 pnpm run test:coverage # 覆盖率门禁(90/80/90/90) pnpm run build # tsdown 打包 + tsc 声明(lib/) pnpm run verify:self-contained # 依赖声明均来自 registry pnpm run verify:artifacts # 构建产物 ESM 面 + bundle patch 存在 node scripts/check-readme-sync.mjs # 五语 README 同步门禁 node scripts/check-endpoints.mjs # M3 端点存活探测(Ollama /api/version) pnpm pack # 发布用 tarball

Topics

dsh, dsh-plugin, deepseek-harness, deepseek, cordis, ollama, local-llm, local-models, offline, privacy, model-routing

Contributors

  • @PerryLink — 创建者与维护者:适配器、路由、工具、健康检查、脱敏与五语文档。
  • @LABEST-IA — 工具调用 CallId 修复(PR #2),以及工具调用槽位与视觉支持的报告(issue #1、#3、#5)。

PerryLink DSH Plugin Family

这是 PerryLink 维护的 37 个 DeepSeek Harness 插件 之一。如果它能帮到你,其他的也会:

PluginOne-liner
dsh-auto-review审批链上的第二模型自动审查,默认失败关闭
dsh-background-agents带 Web UI 侧栏、消息与中断的持久后台子代理
dsh-budgetDeepSeek Harness 的成本治理:预算、碳排与延迟一屏呈现。
dsh-checkpoint-rewindClaude Code /rewind 等价:快照、会话 fork、一次性恢复
dsh-claude-move把 Claude Code 会话、记忆、技能与 CLAUDE.md 迁入 DSH
dsh-click跨平台原生桌面控制(DeepSeek Harness),Windows 优先。
dsh-composer-historyWeb 输入框的终端式历史:方向键、Ctrl+R 搜索
dsh-data-quality数据集质量检查与引文核查(本插件可选消费的数字核查桥)
dsh-defendDeepSeek Harness 的提示注入、越狱与密钥泄露防护。
dsh-doublecheck工程纪律守卫:需求质询、测试门禁、对手评审
dsh-drawDeepSeek Harness 的统一静态图像生成路由。
dsh-fastDeepSeek Harness 只读性能诊断。
dsh-fund-research面向中国公募基金的确定性研究报告
dsh-github面向 DSH 的 GitHub PR/issues 集成,每次写入经审批门控
dsh-industry-research行业研究编排,经本插件的 ctx.researchReport.assemble 封存交付物
dsh-libraryDeepSeek Harness 的本地文档知识库。
dsh-lsp-actions通过语言服务器的 LSP 诊断、格式化、补全、代码操作与重命名
dsh-maskPII 脱敏中间件:模型边界匿名化、展示层还原
dsh-mcp-panel只读 MCP 运行时面板:/mcp 命令 + 带状态、工具与错误的 Settings 标签页
dsh-memento审批门控的跨会话记忆:ctx.memory 接缝 + SQLite + 记忆工具
dsh-observeDeepSeek Harness 的 OpenTelemetry 与 Langfuse 可观测导出器。
dsh-output-stylesClaude Code outputStyles 等价的运行时风格切换
dsh-permission-rulesClaude Code 风格声明式 allow/deny/ask 权限规则,带审计
dsh-personal-directive个人指令注入器:顶栏开关(框架版)
dsh-plugin-guide作为按需代理技能的插件开发知识库
dsh-reach多渠道审批/提问桥接:微信/Telegram/飞书,会话控制台
dsh-research-report可验证研究报告引擎:内容寻址证据账本与封存版本
dsh-scoreDeepSeek Harness 插件的多维质量评分。
dsh-session-pin在 Web 侧栏置顶会话,带持久排序
dsh-session-syncDeepSeek Harness 的跨设备会话同步——会话存储的专用 git 镜像。
dsh-skill-pack-security安全审计技能包:密钥扫描、依赖与供应链审查
dsh-talkDeepSeek Harness 的语音优先会话闭环:对它说,听它答。
dsh-test-driveDeepSeek Harness 插件的隔离试装冒烟。
dsh-ticktickTickTick/滴答清单任务桥接:会话头面板 + 11 个工具
dsh-translateDeepSeek Harness 的厂商参数翻译与确定性 JSON 修复。
dsh-wechat微信 ↔ DSH 桥接(Tencent iLink 机器人):文本/图片/文件/语音,聊天内审批卡片

License

Apache License 2.0 © 2026 dsh-local-ai contributors

从 DSH Desktop 市场安装

所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览:市场 → 来源 → 添加来源 → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选中。安装仍需通过市场的 npm 身份校验与你的确认。

模型接入

快捷安装

复制到终端去安装插件

dshplugin--profilewebaddgithub:PerryLink/dsh-local-ai

温馨提示

装插件等于在本机跑第三方代码,权限与你相同,能读文件、用凭据、访问网络,工具审批管不到。请只装可信来源,并尽量锁定 commit。

站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
🔥热门工具
朱雀AI检测朱雀AI检测
朱雀AI检测助手朱雀AI检测助手
LovartLovart
老鱼简历老鱼简历
WritePass官网WritePass官网
面多多面多多
CursorCursor
星月写作星月写作
零感AI零感AI
墨得问题墨得问题
dsh 插件推荐
dsh-subscriptions
通过 OAuth 将 ChatGPT Codex、Claude、Grok 与 Antigravity 订阅注册为 DeepSeek Harness 的 LLM 提供方,无需为其配置 API Key。
dsh-zhipu-toolkit
智谱 BigModel GLM 双端点模型目录(Coding Plan 与普通 API),支持实时模型发现与实测校准的思考档位映射,提供凭据、端点与默认推理档的可视化设置卡片。
dsh-qwen38-compaction-fix
针对 NInfer 托管的 qwen3.8-27b 网关的压缩修复:在 dsh 上下文压缩与会话标题调用中关闭思考,避免 xhigh 推理耗尽全部输出预算;同一思路适用于其他启动方式,本包仅面向 NInfer。
dsh-model-sync
一键同步 / 自动同步供应商模型列表,与 /v1/models 保持一致。
dsh-openrouter-provider-advisor
按量化、速度、缓存重度价格、上下文和可用率为当前 DSH 模型推荐 OpenRouter 供应商,并支持一键切换以帮助降低 token 成本。