PerryLink/dsh-local-ai

🤖 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 · हिन्दी

---

📖 生态实测知识库（实测数据，不是营销）：插件开发指南 · 选型实测数据 · 维护取舍判据。

⭐ 如果它帮到了你

这个插件是 DSH 插件家族的一员（40+ 个，全部 Apache-2.0）。如果你在用，给个 star —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。

English: part of a 40+ plugin family for DeepSeek Harness. If it is useful, a star helps the next person find it — nothing is gated behind it.

What is dsh-local-ai?

DeepSeek Harness 的本地模型（Ollama）接入。

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

同一次运行，动图版。

Compatibility

项目	状态
Harness	DeepSeek Harness dsh-v0.2.1-alpha.1（2026-10-04 核验：三把 typecheck 尺子（已装包、CI、checkout）+ 142 项测试 + self-contained/artifacts 门；已适配 0.1.7 的内容块联合 —— 工具结果现为一等 tool 角色消息，旧日志里的 tool-result 包裹块仍可读取）。peer 范围接纳全部受支持线：>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0 || >=0.2.0-rc.1 <0.3.0-0；dev/test 钉号 0.2.0-rc.2。
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 仅用于进程探测）；不捆绑模型文件。

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

dsh plugin --profile web add github:PerryLink/dsh-local-ai

# 1. 把 bundle 安装进你的 profile
dsh plugin --profile web add github:PerryLink/dsh-local-ai

# 或从 npm（正式发布版）
dsh plugin --profile web add dsh-local-ai

# 2. 在 profile patch（cordis.yml）里配置路由并重启
dsh --profile web

最小路由配置（该规则在 cordis.patch.yml 里以注释形式给出）：

- insert:
    - id: dsh-local-ai
      name: dsh-local-ai
      config:
        route:
          - model: llama3.2
            keywords: ["confidential", "offline"]

验证 row 是否挂载：

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 —— 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 对每个键都有行内注释。

Key	Default	Meaning
baseURL	http://127.0.0.1:11434	Ollama HTTP API 基础 URL；会追加 /api/* 路径
requestTimeoutMs	30000	单次请求 HTTP 超时（毫秒）
graceMs	15000	健康检查 CLI 探测的子进程终止宽限
defaultContextWindow	8192	模型无精确值时的上下文容量
maxTokens	4096	模型无精确值时的单请求输出上限
temperature	(none)	默认采样温度（0..2）；省略则用提供方默认值
vision	true	模型报告 vision 能力时声明并序列化图片支持；false 保持纯文本路由
visionCacheTtlMs	30000	/api/show 能力探测的缓存毫秒数（0 关闭缓存；pull/remove 会使该模型失效）
models	[]	Harness 可见名 → Ollama 模型映射
models[].name	(required)	Harness 可见模型名（GenerateOptions.model）
models[].model	= name	Ollama 模型 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[].maxTokens	4096	该后端无精确值时的输出上限
backends[].temperature	(none)	该后端的采样温度
route	[]	本地模型路由规则（首个命中生效）
route[].model	(required)	目标本地模型名
route[].provider	ollama	目标 provider id：ollama 或 openai:<name>
route[].purpose	(none)	任务类型匹配：compaction / session-title
route[].keywords	[]	不区分大小写的请求关键词
route[].always	false	把所有符合条件的请求路由到此模型

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 宕机不会卡死对话。唯一例外：带 IMAGE_OFFLOAD_REQUIRED 的失败会被重新抛出而不回退云端——该码是官方图像卸载回路在要求这条本地路由卸下保留图片，回退会跳过回路并把本应只在本地的请求静默发往远端提供方。
• 模型可见 ⟺ 已记录 —— 路由只改变由哪个提供方服务请求（assistant 消息会以 ollama 来源记录）；不凭空新增模型可见输入。

Known limitations

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

Development

pnpm install        # node ^22.19 || >=24
pnpm run typecheck  # tsc：src + 测试，对发布版 0.2.0-rc.2 类型
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

Interoperability with other DSH plugins

已对照 DSH 0.2.0-rc.2（本 README 面向的运行时）与 2026-10-05 实测的高星插件集验证。

本插件不干扰其他插件，包括广泛安装的高星插件：

• 无工具名冲突。 所有工具都带命名空间，不占用任何已被内置工具或其他插件持有的裸名。
• 无服务键冲突。 不提供任何服务键，因此不存在服务键冲突。
• 无 slot 冲突。 不注册客户端 slot key，因此不参与 shadows-shipped-ui 座位争抢。
• 无 HTTP 路由冲突。 不注册任何 webServer 前缀。
• 无 patch 层冲突。 组合包 patch 只 insert 自己那一行，从不覆写内置行的 config。
• 无全局改写。 不改原型、不改写 process.env、不替换全局 fetch dispatcher。

共享事件监听器在构造上就不互相干扰。 它用 ctx.on() 监听顺序敏感事件 llm/stream —— Cordis 的广播语义：每个监听器都会运行，任何一个都无法饿死其他监听器。此处每个监听器都通过 next() 委托，因此链条绝不会被短路；改写作用在 next() 产出的值上，而不是用它顶替返回：

• llm/stream — also used by dsh-routing-suite (7000★).

静态证据：dsh-plugin-doctor 的 K10–K13 在本仓全部为 pass。

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 维护的 DeepSeek Harness 插件家族成员：34 个活跃维护，名册共 42 个，其中 5 个已冻结、3 个已退役——每一个都在下表保留自己的行，原因见「状态」列。如果它能帮到你，其他的也会：

Plugin	一句话	状态
dsh-auto-review	Second-model auto-review on the approval chain, fail-closed by default
dsh-autotier	Automatic strong/cheap model-tier routing with deterministic risk guards and a /tier command
dsh-background-agents	Durable background child agents with a Web UI sidebar, messaging and interrupt	🚫 已退役 — 见上方说明
dsh-budget	Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel.	🧊 已冻结 — 见仓库 README
dsh-catalog	DSH Desktop Market standard catalog source for the PerryLink family
dsh-cert-mcp	Read-only MCP server exposing the certification registry: grades, snapshots and five-dimension evidence
dsh-checkpoint-rewind	Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore
dsh-claude-move	Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH	🧊 已冻结 — 见仓库 README
dsh-click	Cross-platform native desktop control for DeepSeek Harness — Windows first.
dsh-composer-history	Terminal-style input history for the web composer: arrows, Ctrl+R search
dsh-data-quality	Dataset quality checks and citation cross-checks (the optional numeric bridge consumed here)
dsh-defend	Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness.	🧊 已冻结 — 见仓库 README
dsh-doublecheck	Engineering-discipline guard: requirements grill, test gates, adversary review
dsh-draw	Unified static-image generation routing for DeepSeek Harness.	🧊 已冻结 — 见仓库 README
dsh-fast	Read-only performance diagnostics for DeepSeek Harness.
dsh-fund-research	Deterministic research reports for Chinese public mutual funds
dsh-github	GitHub PR/issues integration for DSH, every write gated by approval
dsh-industry-research	Industry research orchestration that seals its deliverables through this plugin's ctx.researchReport.assemble
dsh-laya	Laya typed decisions (noul/choice/score) as a first-class Cordis service and model-visible tools
dsh-library	Local document knowledge base for DeepSeek Harness.
dsh-local-ai	Local-model (Ollama) integration for DeepSeek Harness.
dsh-lsp-actions	LSP diagnostics, formatting, completion, code actions and rename over language servers
dsh-mask	PII masking middleware: anonymize at the model boundary, restore at the display layer
dsh-mcp-panel	Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors
dsh-memento	Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool
dsh-observe	OpenTelemetry and Langfuse observability exporter for DeepSeek Harness.
dsh-output-styles	Claude Code outputStyles-equivalent runtime style switching
dsh-permission-rules	Claude Code-style declarative allow/deny/ask permission rules with audit
dsh-plugin-certification	Community certification registry with repro-checkable grades and badges
dsh-plugin-doctor	Zero-dependency static + sandbox smoke detector for DSH plugins
dsh-plugin-guide	Plugin-development knowledge base as an on-demand agent skill
dsh-plugin-kit	Shared zero-runtime-dependency toolkit for the PerryLink DSH plugins
dsh-plugin-upgrade	One-package, one-corridor-index plugin upgrade skill: routes a repository to the matching closed corridor card
dsh-plugin-upgrade-015	Merged 0.1.3-alpha.1 → 0.1.5-rc.1 upgrade corridor card plus a zero-dependency seam scanner	🚫 已退役 —— 走廊由 dsh-plugin-upgrade 承担
dsh-reach	Multi-channel approval/question bridge: WeChat/Telegram/Feishu, session console	🧊 已冻结 — 见仓库 README
dsh-research-report	Verifiable research-report engine: content-addressed evidence ledger and sealed versions
dsh-score	Multi-dimensional quality scoring for DeepSeek Harness plugins.
dsh-session-pin	Pin sessions in the Web sidebar with durable ordering	🚫 已退役 — 见上方说明
dsh-session-sync	Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store.
dsh-skill-pack-security	Security-audit skill pack: secret scan, dependency and supply-chain review
dsh-talk	Voice-first session loop for DeepSeek Harness: talk to it, hear it answer.
dsh-team-rooms	Cross-session team rooms: shared message bus, task board and timeline	🚫 已退役 — 见上方说明
dsh-test-drive	Isolated install-and-smoke test drives for DeepSeek Harness plugins.
dsh-ticktick	TickTick/Dida365 task bridge: session-header panel + 11 tools
dsh-translate	Vendor parameter translation and deterministic JSON repair for DeepSeek Harness.

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 身份校验与你的确认。