lobbenedesign/deepseek-harness-coder

DeepSeek HarnessCoder

一个非官方的开源桌面伴侣应用，面向 @deepseek-ai/dsh（DeepSeek Harness），适用于 macOS 和 Windows。

并非分支（fork）。 本项目不包含 DeepSeek Harness 的任何源代码。它是一个独立的 Electron 应用，将 dsh 作为子进程启动，嵌入其官方本地 Web UI，并通过 dsh 自身暴露的扩展点（cordis.patch.yml）扩展其配置。可以把二者的关系类比为 VS Code 与 Node.js：大量构建于其上，而非其分支。

Agent 面板

它是什么

DeepSeek Harness 以 CLI + 本地 Web UI（dsh web，运行于 http://127.0.0.1:3080）的形式发布，具备真实的智能体轨迹视图、文件编辑和插件管理功能——但没有桌面外壳，除了原始配置文件之外没有模型管理 UI，也没有菜单栏应用体验。DeepSeek HarnessCoder 将其封装为一个 IDE 风格的桌面应用，设计语言受 Google Antigravity 启发：

- Agent 面板——真实的 dsh Web UI，被嵌入其中，周围环绕着自定义的深色/玻璃拟态标题栏和侧边栏。
- 集成终端——一个辅助的、独立的 shell 面板（xterm.js + node-pty），用于直接访问 CLI。
- 日志面板——dsh 进程的实时 stdout/stderr，因此调试崩溃或错误配置时无需另开终端。
- 模型无关的模型管理器——由于 dsh 基于插件且与提供商无关，本应用添加了一个 UI 来真正利用这一点：
- 提供商（Providers）标签页——为 OpenRouter（通过一个密钥即可使用 Claude、Gemini、Qwen、GLM、Kimi 等）、Google Gemini、Mistral、Moonshot Kimi、Zhipu GLM、Hugging Face Inference、本地 Ollama 提供一键预设，并为任何其他 OpenAI 兼容端点提供通用的“自定义”条目。
- Ollama 标签页——查看已安装的本地模型，安装/卸载新模型，并一键将某个模型激活为智能体的模型（无需手动编辑 YAML）。每个已安装的模型还有一个“提升上下文窗口”操作，可创建一个具有更高 num_ctx 的派生模型（无需重新下载）——Ollama 的默认运行时上下文往往远低于模型架构所支持的大小，这是智能体在任务中途幻觉出文件路径的常见原因。
- Hugging Face 标签页——搜索公共 Hub 目录（GGUF 模型，可通过 Ollama 的 hf.co/ 支持免费安装）。
- OpenRouter 标签页——浏览公共 OpenRouter 模型目录，以挑选要添加到你的提供商中的模型。
- 始终可见的模型指示器——标题栏上的一个胶囊标签始终显示本应用已配置的提供商/模型，因此你永远不会搞不清自己正在使用什么运行。
- 待审批通知——当嵌入的智能体打开对话框（最常见的是审批请求）时，会触发原生操作系统通知，因此你无需一直将 Agent 标签页保持在前台。

截图

| Agent | 终端 |
|---|---|
| Agent | 终端 |
| 模型 — 提供商 | 模型 — Ollama |
|---|---|
| 提供商 | Ollama |

| 模型 — Hugging Face | 模型 — OpenRouter |
|---|---|
| Hugging Face | OpenRouter |

| 日志 |
|---|
| 日志 |

技术栈

- Electron（桌面外壳，通过 electron-builder 生成 macOS .dmg/.app 和 Windows NSIS .exe）
- React + Vite（渲染器 UI）
- xterm.js + node-pty（集成终端）
- js-yaml（安全读写 dsh 的 cordis.patch.yml，每次写入前始终备份）
- Electron safeStorage（API 密钥静态加密，仅在进程启动时作为环境变量注入 — 绝不写入 dsh 自身的文件）

模型配置的实际工作原理

你在此应用中添加的提供商会写入 ~/.dsh/profiles/web/cordis.patch.yml 中的 llm-pi-ai 条目下。确切的 schema 并未由 DeepSeek 公开文档化，因此这是从真实的 dsh 启动失败（ValidationError: $.providers expected object）逆向工程得出的，而非猜测：providers 必须是一个以提供商 id 为键的对象，且每个模型必须是 { id: "model-name" }，而不是裸字符串。对该文件的每次写入都会先备份，并在提交前作为 YAML 重新验证。

Anthropic/Claude 没有原生 OpenAI 兼容端点，因此未作为一键预设提供 — 通过 OpenRouter 路由是经过验证的方式，可通过单个密钥访问它（以及 Gemini、Qwen、GLM、Kimi）。

快速开始

git clone https://github.com/lobbenedesign/deepseek-harness-coder.git
cd deepseek-harness-coder
npm install
npm run dev        # Vite dev server + Electron, with hot reload

构建安装程序：

npm run build       # produces dist-electron/.dmg (mac) and .exe (win)

dsh 本身会在你首次启动应用时通过 npx @deepseek-ai/dsh web 按需获取 — 你需要安装 Node.js ^22.19.0 或 >=24。

已知限制

- 尚无代码签名/公证 — 未签名的构建会被 Gatekeeper（macOS）和 SmartScreen（Windows）标记。
- 标题栏的“活动模型”胶囊反映的是此应用写入 dsh 配置的内容，而非对 dsh 内部会话状态的实时读取（不存在此类 API）— 运行中会话内的最终激活仍在 dsh 自身的“Models”设置中进行。
- 审批通知功能是一种启发式机制（它在嵌入式 UI 内任何对话框打开时触发，而非专门针对审批提示），因为 dsh 未为此暴露事件。

许可证

MIT — 参见 LICENSE。DeepSeek Harness（@deepseek-ai/dsh）由 DeepSeek AI 独立开发，与本项目无关联。

DeepSeek HarnessCoder (Italiano)
一个非官方、开源的桌面伴侣应用，面向 @deepseek-ai/dsh（DeepSeek Harness），支持 macOS 和 Windows。

这不是一个 fork。 本项目不包含 DeepSeek Harness 源代码的任何一行。它是一个独立的 Electron 应用，将 dsh 作为子进程启动，集成其官方的本地 Web 界面，并通过 dsh 自身暴露的扩展点（cordis.patch.yml）扩展其配置。这与 VS Code 和 Node.js 之间的关系属于同一类型：在其之上大量构建，而非 fork。

它是什么

DeepSeek Harness 以 CLI + 本地 Web 界面（dsh web，位于 http://127.0.0.1:3080）的形式分发，具备真正的智能体轨迹视图、文件编辑和插件管理——但没有桌面外壳，没有超出原始配置文件之外的模型管理 UI，也没有原生应用体验。DeepSeek HarnessCoder 将其封装进一个 IDE 风格的桌面应用中，灵感来自 Google Antigravity 的视觉语言：

- Agent 面板——集成后的真正的 dsh Web 界面，周围环绕着自定义的标题栏和深色/玻璃拟态侧边栏。
- 集成终端——一个独立的次级 shell 面板（xterm.js + node-pty），用于原始 CLI 访问。
- 日志面板——dsh 进程的实时 stdout/stderr，这样你就不必为了弄清一次崩溃或一个错误配置而打开单独的终端。
- 模型无关的模型管理——由于 dsh 基于插件且对提供商无关，本应用添加了一个 UI 来真正利用这一点：
- Provider 选项卡——一键即用的预设，适用于 OpenRouter（用一个 key 即可访问 Claude、Gemini、Qwen、GLM、Kimi 等）、Google Gemini、Mistral、Moonshot Kimi、Zhipu GLM、Hugging Face Inference、本地 Ollama，外加一个“自定义”条目，适用于任何其他 OpenAI 兼容端点。
- Ollama 选项卡——查看已安装的本地模型，安装/卸载新模型，并一键将某个模型激活为智能体的大脑（无需手动编辑 YAML）。每个已安装的模型还有一个“增大上下文窗口”操作，它会创建一个带有更高 num_ctx 的派生变体（无需重新下载权重）——Ollama 的默认上下文通常远低于模型架构所能支持的规模，这是长任务期间文件名幻觉的常见原因。
- Hugging Face 选项卡——搜索 Hub 的公共目录（GGUF 模型，可通过 Ollama 的 hf.co/ 支持免费在本地安装）。
- OpenRouter 选项卡——浏览 OpenRouter 的公共模型目录，以选择要添加到你的提供商中的内容。
- 始终可见的模型指示器——标题栏中的一个胶囊标签始终显示本应用配置的是哪个提供商/模型，因此你永远不必猜测自己正在使用什么。
- 待处理批准通知 — 当内置代理打开对话框（通常是批准请求）时，会触发一条操作系统原生通知，因此你无需始终将 Agent 标签页保持在前台。

截图

参见上方英文版截图部分——图片是相同的。

技术栈

- Electron（桌面外壳，通过 electron-builder 为 macOS 生成 .dmg/.app，为 Windows 生成 NSIS .exe 安装程序）
- React + Vite（用户界面）
- xterm.js + node-pty（内置终端）
- js-yaml（安全读写 dsh 的 cordis.patch.yml，每次写入前始终自动备份）
- Electron safeStorage（API key 在本地保持加密，仅在进程启动时作为环境变量注入——绝不写入 dsh 的文件中）

模型配置的实际工作原理

你在此应用中添加的提供商会写入 ~/.dsh/profiles/web/cordis.patch.yml 中一个 llm-pi-ai 条目下。确切的结构并未由 DeepSeek 公开文档化，因此并非猜测，而是从 dsh 的真实启动错误中推断出来的（ValidationError: $.providers expected object）：providers 必须是一个对象，其键为提供商 id，且每个模型必须是 { id: "模型名称" }，而不是裸字符串。每次写入该文件前都会自动备份，并在保存前重新验证为 YAML。

Anthropic/Claude 没有原生 OpenAI 兼容的端点，因此不提供为直接预设——通过 OpenRouter 路由是经过验证的接入方式（连同 Gemini、Qwen、GLM、Kimi），只需一个 key。

快速开始

git clone https://github.com/lobbenedesign/deepseek-harness-coder.git
cd deepseek-harness-coder
npm install
npm run dev        # Vite 开发服务器 + Electron，支持热重载

构建安装程序：

npm run build       # 生成 dist-electron/.dmg (mac) 和 .exe (win)

dsh 会在应用首次启动时通过 npx @deepseek-ai/dsh web 即时下载——需要安装 Node.js ^22.19.0 或 >=24。

已知限制

- 尚无签名/公证——未签名的构建会被 Gatekeeper（macOS）和 SmartScreen（Windows）警告。
- 标题栏中的“活动模型”胶囊反映的是此应用写入 dsh 配置的内容，而非会话内部状态的实时读取（不存在用于此目的的 API）——会话中的最终激活仍取决于 dsh 原生的“模型”设置。
- 批准通知是启发式的（对内置界面中打开的任何对话框都会触发，而非专门针对批准请求），因为 dsh 未暴露专用事件。

许可证

MIT——参见 LICENSE。DeepSeek Harness（@deepseek-ai/dsh）由 DeepSeek AI 独立开发，与本项目无关联。