代码工程特化版 Code-DSH/deepseek-harness-code

DeepSeek Harness Code
为代码而生 —— DeepSeek Harness 的代码工程专精版 DeepSeek Harness 的深度专精版本，专注代码生成、项目重构与工程调试。
English · 简体中文专用智能体 · 集成理念 · 架构 · 为什么不是套壳 · 长时间运行 · 构建

[!IMPORTANT]
DeepSeek Harness Code 是社区项目，不是 DeepSeek 官方发布，与 DeepSeek 没有隶属关系。
桌面端把 Code-DSH 维护的 Harness 固定为 Git 子模块；构建时和首次启动时都不会安装官方 npm DSH 系列。

为代码而生 —— DeepSeek Harness 的代码工程专精版。

为代码锻造：深度专精的编码智能体

通用智能体应付日常杂事很在行，一碰到复杂软件工程就露怯 —— 不懂项目上下文，不熟文件树，也摸不清构建链路。
DeepSeek Harness Code 正是为解决这个问题而生。作为 DeepSeek Harness 的专用分支，它把模型的推理能力集中投向高质量软件代码——从单文件修改到多模块协同重构，提供端到端工程支持。通用智能体受困于泛化的工具调度和模糊的上下文管理；而代码工程是一门严谨的确定性技艺。我们丢掉通用场景的包袱，把推理与真实软件环境深度绑定（AST 解析、终端、代码沙箱、Diff 编辑）——直击工程本质。

为什么要专用化？

- 精准的工程上下文——深度代码索引与文件依赖感知，不再丢失上下文。
- 原生终端与 Diff——输出的不是纯文本，而是规范补丁，并带沙箱化测试执行。
- 极低的接入成本——开箱即用，可直接嵌入现有编辑器和命令行工作流。

集成理念

我们不追求无边界的复杂度，而是坚持一套为代码量身定制的工程理念：

1. 场景专用——聚焦代码生命周期，砍掉一切与编程无关的臃肿设计。
2. 模块解耦——调度器与工具链解耦，可自由插拔自定义 LSP、Linter 和沙箱。
3. 确定性交付——以测试和验证驱动，用真实执行结果取代模型幻觉。
4. 可控可追溯——完整的变更日志与回滚，确保每次修改都安全透明。

DHC 仍是社区项目，基于公开的 Harness 格式和 Code-DSH 维护的运行时构建。不捆绑任何模型权重，也不替换任何服务商边界。

QQ 社区

加入 DHC 社区 QQ 群，分享反馈、使用技巧和项目讨论。

- QQ 群： 1107534919

一套完整的 DeepSeek Harness 发行版

这是一套完整、自洽的 Harness 发行版——不是模型启动器，也不是插件合集。维护中的 Base 和 Web 包把 DeepSeek Agent 技术栈的核心整合进一个应用：

- 模型与推理——V4 Pro / V4 Flash 目录，推理强度 off / high / max，1M 上下文，重试与流式输出。
- 技能——运行时、文件发现、Skills UI、徽章，以及官方 Skill 工具。
- 智能体工作流——Standard 预设，Goal / Plan / Todo / Jobs / Workflow，压缩、检查点与持久会话。
- 工具——文件读取/搜索/编辑，Bash / PowerShell，Web，用户提问，审批，子代理，反馈与交付物。
- 插件平台——官方插件清单，外加集成的桌面端与 Anchored Standard 包。
- 桌面端可靠性——原生生命周期、安全桥接、健康恢复、轮转诊断与独立 Watchdog。

所有内容都按同一产品边界固定版本、打包并验证。

让 BETA1 体验现代化

BETA1 打好了地基，但早期的 Web 体验把关键问题留给了用户。DHC 在其上构建一层现代应用：

- 长会话记忆 —— 约束桌面端的增长路径，轮换诊断信息，防止恢复流程重叠，淘汰被取代的进程。
- Web 卡死 —— 检测持续无响应的渲染进程，替换窗口而不破坏健康的 Harness。
- 脆弱的生命周期 —— 接管启动、就绪、串行重启、有界关闭、端口重试，以及感知会话的恢复。
- 零散的能力 —— 把运行时、插件、技能、工具、工作流、提问、审批和扩展打包成一个经过测试的整体。
- 桌面端缺口 —— 补上原生菜单、托盘、关闭偏好、系统外观、快捷键、过渡动画、设置和无障碍诊断。

目标不是分叉协议，而是在保留官方 Harness 模型的前提下，让体验更完整、更现代、更可靠。

更完整的 V4 Pro 体验

V4 Pro 是这套集成地基中的一项重要能力，而不是它唯一的中心。固定版本的适配器发布 deepseek-v4-pro / deepseek-v4-flash，推理档位为 off / high / max。应用打包的是集成与运行时——不是模型权重；凭据仍留在官方 Harness 设置里。

工具面锚定

下一步不是靠某个关键词去「打开推理」，而是控制首个请求的工具面，从而保住 V4 Pro 本可以达到的高质量轨迹。

- Standard：一开始就暴露 25 个工具，容易掉进低效的 Let me...，Project2 约 9,192。
- Minimal：只留 Shell + Read，更容易回到 We need...，Project2 约 9,699。

dsh-anchored-standard 用首请求锚定 + 动态提升解决这个问题：先只暴露 bash + str_replace_editor，等第一次持久调用之后再解锁全部 25 个工具。在原生 Windows 上 Project2 连续拿到 98 / 99。

[!NOTE]
off / high / max 是官方档位；锚定只改变各阶段暴露的工具目录，不碰私有字段，也不碰隐藏的 CoT。

不只是 Web 套壳

| 能力 | 基础 Web 套壳 | DeepSeek Harness Code |
| 运行时 | 加载远程页面 | 打包 Chromium + 维护过的 Harness + 插件，使用系统 Node |
| 模型集成 | 继承页面里的模型 | 一等公民的 V4 Pro / Flash 目录与推理控制 |
| 智能体工具集 | 无 | 插件、技能、Goal / Plan / Workflow、提问、子代理 |
| 进程归属 | 页面就是产品 | 桌面宿主接管 Harness 的启动、就绪、重启、关闭 |
| 长会话健康 | 手动刷新 | 互不重叠的健康探测，以及基于证据的恢复 |
| Web 冻结 | 重载整个应用 | 检测无响应的渲染进程，重建窗口，保持 Harness 存活 |
| 服务故障 | UI 停止后才察觉 | 连续探测失败或子进程退出后自动恢复 |
| 桌面崩溃 | 没有独立层级 | 仅走 IPC 的 Watchdog，带有限退避与熔断 |
| 内存压力 | 继承无上限增长 | 约束增长路径，轮转日志，淘汰失败进程 |
| 诊断 | 只有浏览器控制台 | 脱敏后的 Electron / Harness / Watchdog 日志，应用内可查 |
| 桌面集成 | 只有窗口边框 | 原生托盘 / 菜单、关闭策略、系统主题、快捷键 |
| 安全边界 | preload 权限过宽 | Harness 仅监听回环地址 + 五组经过校验的 preload |
| 分发 | 依赖外部环境 | 自包含应用，自动探测常见安装位置 |

轻量封装解决的是「像应用一样打开这个网站」；DHC 解决的是「把 Harness 当作有韧性的桌面编码系统来用」。

为长时间运行而设计

长会话很少轰然崩溃——压力是一点点积累的：渲染进程卡住、子进程退出、检查重叠、日志无限增长、僵尸进程赖着不走。

- 健康监测——每 5s 探测一次，连续 3 次失败或子进程退出后串行恢复。
- 渲染进程恢复——必须持续无响应 30s 才重建窗口；一旦恢复响应就取消，健康的 Harness 不会被杀。
- Watchdog——异常断开后按 1s / 2s 有限重启；5 分钟内第 3 次崩溃触发熔断。
- 有界关闭——与 Watchdog 握手，请求 Harness 优雅退出，最多等 8s 再升级处理。
- 有界诊断——脱敏，按 5×10 MB 轮转，不会无限堆积。
- 恢复不重叠——并发故障收敛为一次操作。
- 不盲目重放——健康的服务绝不被杀，中断的请求绝不自动重放。

现代桌面体验

- 自包含宿主，系统 Node——Chromium / Harness / 插件 / Watchdog 打包进 .app，运行在 Node 22.19+ 或 24+（不支持 Node 23），首次启动安装到用户数据目录，即使在精简的 GUI PATH 下也能自动探测。
- 官方 Harness 界面——会话、配置档、服务商、工作区、提问流程都保持官方原样。
- 集成设置——运行时状态、重启、日志、关闭行为都在通用设置里，使用官方 UI 组件。
- 原生生命周期——从常驻托盘 / 菜单打开、重启、查看日志、退出；关闭到托盘或直接退出。
- 系统外观——浅色 / 深色启动界面、平台标题栏、官方单色素材、支持减少动态效果。
- 顺滑导航——可用时启用 View Transitions，否则回退到 CSS，不强制布局。
- 工作区韧性——经过校验的 Standard 切换与官方会话恢复。
- 可选局域网访问 —— 默认关闭；开启后，由 Electron 持有的 HTTP 代理监听本地网卡，Harness 仍留在回环地址。密码留空时，局域网内能连上的设备可直接访问；配置了密码，则 HTTP 和 WebSocket 流量都会触发浏览器 Basic Auth。
- 技能 —— Superpowers 6.2.0 安装到 <DSH_HOME>/skills，绝不覆盖用户自己的目录。
- 全局 Agent Protocol —— <DSH_HOME>/AGENTS.md：不存在时自动安装，仅在仍由应用管理时升级，绝不覆盖用户自己的文件，并可通过 Use Bundled Global Prompt… 切换到带时间戳的备份。
- 全局 dsh 不受影响 —— 启动时绝不运行 npm install -g，也绝不改动用户自己管理的全局命令行。
- 更新需用户确认 —— 只使用经过 SHA-256 校验的资源；Windows 保留当前 NSIS 目录，Linux AppImage 替换持久化的 $APPIMAGE 文件，Debian 软件包仍需手动处理。
- 本地化预设 —— anchored-standard / router-standard / router-spec，名称双语，ID 不变。
- 安全实验 —— Anchored Standard 作为独立 bundle，在维护中的 Harness 0.1.1-rc.2.code.1 上失败即回落到 Standard。

功能矩阵

| 领域 | 包含内容 |
| 桌面宿主 | 加固窗口、启动页、原生菜单、托盘 |
| Harness | Code-DSH 系列 0.1.1-rc.2.code.1，回环地址，单一 Home |
| V4 模型 | 官方目录以及 off / high / max |
| 技术栈 | 技能、Goal / Plan / Workflow / Todo / Jobs / questions |
| 技能 | Superpowers 6.2.0，绝不覆盖用户 |
| 全局提示词 | AGENTS.md 所有权安全的安装与备份切换 |
| 全局命令行 | 由用户管理；应用绝不安装或修改 |
| 预设 | 默认 Standard，可选 anchored / router |
| 恢复 | 健康探测、重启、渲染进程替换、端口重试 |
| 看门狗 | 独立 IPC、有界重启与熔断 |
| 插件 | Desktop、UI Motion、Model2、Find、Routing、Settings Tools、Plugin Market 等 |
| 诊断 | 启动证据、运行时状态、脱敏轮转日志 |
| 安全 | 沙箱化渲染进程、无 Node 集成、校验过的 IPC |
| 打包 | macOS Universal DMG；Windows NSIS；Linux AppImage/deb |

路由套件

内置社区项目 dsh-routing-suite，每次启动自动加载：
- 离线快照 — 应用资源内固定三个组件（@dsh-external/dsh-super-injector、@dsh-external/dsh-mode-boost、router-standard + router-spec）。
- 固定基线 — injector 0.3.3 / mode-boost 0.1.0 / router-preset 0.2.0@eff787e，SHA-256 记录在 build/routing-suite/versions.json。
- 公开 CLI 对账 — 走系统 Node 加内置 pnpm，执行 dsh plugin --profile web add（desktop、ui-motion、model2、prompt-principles、vision-router、better-sidebar、LAN access、composition、Super Injector、Mode Boost、find-plugin、settings-tools、plugin-market）。维护版 Harness 负责 manifest 对账。只有受管名单未变时，校验通过的应用自有标记才会跳过重复的 CLI 添加；标记缺失或不匹配、包根目录/标识变化、配置档依赖缺失、或遇到外部 store，都会重新对账。完整维护版运行时自带子代理包；不再有 linkOnly 后处理。
- 更新需审核 — 只在应用发新版时进行，解压前校验 SHA-256，绝不在后台下载可变代码。
- 所有权安全 — 绝不覆盖无关插件或用户自有预设，旧版 Home 仅做复制式迁移。

架构

图 1 — Code Agent 桌面架构。Electron Main 负责窗口/子进程/桥接；Harness 负责会话/协议；Watchdog 负责重启；Preload 负责校验。详见 overview 与 lifecycle。中文版：system-zh.svg

一张图看懂：宿主创建窗口，解析系统 Node，通过公开 CLI 对账插件，在回环地址上启动维护版 dsh web，并用互不重叠的 5 秒探测做健康检查；Preload 是渲染进程与主进程之间唯一的接缝（preferences、lanAccess、runtime、updater、bundledPlugins）；Harness 子进程使用 DSH_HOME/~/.dsh；Watchdog 通过 IPC 重启，退避有上限；持久化数据留在 .app 之外。

完整边界见 overview 与 lifecycle，支持浅色/深色自适应。

安全模型

- 渲染进程沙箱化，不集成 Node。
- 只有固定的 preferences、lanAccess、runtime、updater、bundledPlugins 这几组 preload。
- 执行桌面操作前先校验 IPC 载荷。
- Harness 自身只绑定回环地址。LAN 访问默认关闭；可选启用 Electron 反向代理，监听 0.0.0.0。密码留空时允许可信局域网直接访问；配置密码后，HTTP 与 WebSocket 流量走浏览器 Basic Auth。仅限可信局域网 HTTP，不承诺可暴露公网，也不承诺 TLS。
- 凭据留在官方 Harness 设置里，绝不进 bundle。
- 日志不记录凭据、Authorization、Cookie、提示词和响应。
- 外部导航 allow / open-external 策略。

平台状态

| 平台 | 目标 | BETA3 发布门槛 |
| macOS | macOS 12+，Intel 和 Apple Silicon | Universal DMG 原生验证通过 |
| Windows | Windows 10+，x64 和 arm64 | 原生 NSIS 安装/运行验证通过 |
| Linux | x64 和 arm64 | 原生 AppImage/deb 验证通过 |

BETA6 现在是 GitHub Latest，作为更新器测试版本。原生 Windows/Linux x64+arm64 和 macOS Intel/Apple-Silicon 的安装/运行/无 Node 验证已在 Run 33140759412 通过。旧版 DHSC 构建可以通过 Settings → General → Check for updates 接收 BETA6，使用大小/SHA-256 更新清单契约。

在 macOS 上安装

当前包未签名。把 DeepSeek Harness Code.app 复制到 /Applications 后，信任的接收方可以只针对这个应用移除隔离属性：

xattr -dr com.apple.quarantine "/Applications/DeepSeek Harness Code.app"

不要全局关闭 Gatekeeper。参见完整的未签名指南。

从源码构建

要求

- Node.js 22.19+ 或 24+（工具链和运行时；不支持 Node 23）
- pnpm 11.19.0（通过下面固定的命令）
- 平台原生打包工具

git clone https://github.com/Code-DSH/deepseek-harness-code.git
cd deepseek-harness-code
npm exec --yes --package=pnpm@11.19.0 -- pnpm install --frozen-lockfile
npm exec --yes --package=pnpm@11.19.0 -- pnpm test

构建并启动：

npm exec --yes --package=pnpm@11.19.0 -- pnpm start

打包：

npm exec --yes --package=pnpm@11.19.0 -- pnpm dist:mac
npm exec --yes --package=pnpm@11.19.0 -- pnpm dist:win
npm exec --yes --package=pnpm@11.19.0 -- pnpm dist:linux

发布包和 update-manifest.json 只在推送 v 标签并通过验证后，由 GitHub Actions 生成；本地 dist: 仅供验证。

验证

npm exec --yes --package=pnpm@11.19.0 -- pnpm build
npm exec --yes --package=pnpm@11.19.0 -- pnpm test
npm exec --yes --package=pnpm@11.19.0 -- pnpm check
npm exec --yes --package=pnpm@11.19.0 -- pnpm check:memory
node scripts/verify-macos-artifact.mjs release/DeepSeek-Harness-Code-*.dmg --universal

文档

- 项目意图
- 架构概览 / 生命周期
- 架构图（英文） · 架构图（中文）
- 测试策略 / 验收
- 故障排查 / 未签名安装

路线图

- 可复现的持久性基准测试（5s 探针 / 30s 渲染器 / 8s 关闭）。
- 原生 Linux 正式版（AppImage/deb 已通过 CI）。
- 针对锚定工具面的配对 Project2 验证。
- 非重放式故障注入。
- 版本化、由技能驱动的交付。
- 通过固定的 Code-DSH 子模块与本地哈希的 0.1.1-rc.2.code.1 系列，跟踪上游插件 API。

贡献

欢迎提交 Issue 和 PR。运行时行为变更应附带针对性测试，并更新权威文档。结论要有证据支撑；切勿附带密钥、Cookie、提示词或响应内容。

请先阅读 AGENTS.md 和文档索引。

许可证

MIT License。

致谢

基于官方 DeepSeek Harness 和 Electron 构建。DeepSeek 打下了基础；这个社区项目专注于桌面生命周期、集成、恢复、打包，以及长时间运行的 Code Agent 可用性。

免责声明

社区维护的软件。「DeepSeek」仅用于标识与上游的兼容性；不暗示任何隶属关系、认可或官方支持。