<div align="center">

🤖 dsh-local-ai

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

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

      

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

</div>

---

Compatibility

| 项目 | 状态 | |---|---| | Harness | DeepSeek Harness 0.1.1-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

# 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 里以注释形式给出）：

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

Tools & surfaces

消费 公开 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

• 仅 rc.2 —— 针对 @deepseek-ai/dsh@0.1.1-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.1.1-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 同步门禁
pnpm pack           # 发布用 tarball

Topics

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

Contributors

• @PerryLink — 创建者与维护者：适配器、路由、工具、健康检查、脱敏与五语文档。

PerryLink DSH Plugin Family

本项目是由 PerryLink 维护的 29 个 DeepSeek Harness 插件之一。如果这个对你有用，其他插件很可能也会：

License

[Apache License 2.0](LICENSE) © 2026 dsh-local-ai contributors