终端编码客户端withlovehub/harness-code

Harness Code

基于 DeepSeek 官方 Harness Runtime 的终端原生客户端
不开浏览器，不用 localhost，一条 npm 命令即可安装

English · 简体中文 ·
npm ·
路线图 ·
参与贡献

[!IMPORTANT]
Harness Code 是独立社区项目，并非 DeepSeek 官方产品。Agent 核心由 DeepSeek 官方开源 Harness npm 模块组合而成。

快速开始

需要 Node.js 22.19 或更高版本。

npm install --global harness-code
deepseek

第一次启动会直接进入终端连接向导。粘贴 DeepSeek API Key、通过官方接口验证、选择模型，即可开始使用，不需要提前配置环境变量。

为什么做 Harness Code？

DeepSeek 官方 Harness 已经提供 Agent 循环、模型适配、工具、沙箱、会话、上下文精简、Skills、Goals 和 Subagent 等核心能力。Harness Code 没有重写这些核心，而是补上一个完整的终端产品体验。

- 官方 Runtime 核心：直接使用已发布的 @deepseek-ai/dsh-* 模块，而不是重新实现 Agent。
- 真正的终端原生：本地进程通过 ACP stdio 通信，不需要浏览器、Electron、HTTP Server 或 localhost 端口。
- 一条命令完整安装：npm 会同时安装终端客户端和运行所需的官方 Harness 模块。
- 现代 Coding Agent 体验：命令中心、权限模式、模型选择器、Thinking 状态、Token 用量、上下文精简和 Skills。
- 安全的首次配置：通过 DeepSeek 官方 API 验证 Key，并在 Windows 使用当前用户 DPAPI 加密保存。

功能对比

| | Harness Code | 官方 Harness Web 客户端 | Headless ACP Demo |
|---|---:|---:|---:|
| 官方 Harness Runtime | 是 | 是 | 是 |
| 交互式终端 UI | 是 | 否 | 否 |
| 是否需要浏览器或 localhost | 不需要 | 需要 | 不需要 |
| 常驻 / 命令中心 | 内置 | Web 操作 | 无 |
| 模型、推理等级、精简和 Skills | 内置 | Web UI | API 层 |
| npm 全局安装 | 支持 | 支持 | 面向开发者 |

工作原理

你的终端
│
▼
Harness Code TUI
│  通过 stdin/stdout 传输 ACP JSON-RPC
▼
DeepSeek 官方 Harness Runtime
├─ DeepSeek 模型适配器
├─ Agent 与持久会话循环
├─ 文件系统和 Shell 工具
├─ 沙箱与人工授权
└─ 上下文精简与工作区指令

上述组件均作为本地进程运行，正常使用时只有模型适配器会连接 https://api.deepseek.com。

交互命令

输入 / 打开命令中心，使用方向键选择、Tab 补全、Enter 执行。

| 分类 | 命令 |
|---|---|
| 连接与模型 | /connect、/model（/models）、/effort |
| 会话 | /clear、/compact、/context、/copy、/export、/usage |
| 权限 | /mode、/permissions、/plan |
| 工作区 | /skills、/reload-skills、/pwd、/diff、/init、/memory |
| Agent 工作流 | /review、/security-review、/test、/simplify、/explain、/fix |
| 诊断 | /doctor、/config、/help、/exit |

常用快捷键包括：Esc 取消任务、Shift+Tab 切换权限、Alt+P 切换模型、Alt+E 切换推理等级、空闲时 Ctrl+D 退出。

权限模式

| 模式 | Harness 策略 | 行为 |
|---|---|---|
| plan | read-only | 只读调查并拒绝提权操作。 |
| agent | workspace-write | 允许修改工作区，扩大影响前询问。 |
| yolo | danger-full-access | 自动批准操作，仅建议用于可丢弃环境。 |

API Key 与模型管理

deepseek auth login
deepseek auth status
deepseek auth logout

Windows 会使用当前用户的 DPAPI 加密保存 DeepSeek 凭据，不会把 Key 写入终端历史。自动化场景仍可临时使用 DEEPSEEK_API_KEY 和 DEEPSEEK_MODEL 覆盖本地设置。

单次任务与自动化

deepseek -p "解释这个仓库"
deepseek --mode plan -p "审查认证流程"
deepseek --json -p "总结公开 API"

从源码开发

git clone https://github.com/withlovehub/harness-code.git
cd harness-code
npm install
npm run check

CI 会在 Windows、Linux、Node.js 22 和 24 上验证类型、测试、构建、Runtime 启动与完整 npm 安装链路。

项目状态

Harness Code 当前是可用的社区预览版。你可以查看路线图、提交 Issue，或参与 Discussion。

上游 ACP 当前仍以新建会话启动，并流式提交已确认的回复内容，而不是暴露逐 Token 的私有推理。Harness Code 只展示安全的任务摘要、执行阶段和官方报告的用量，不会暴露或伪造私有思维链。

参与贡献

欢迎提交 Bug、功能建议、文档改进和范围明确的 Pull Request。请先阅读 CONTRIBUTING.md，也可以从 good first issue 开始。

许可证与归属

Harness Code 使用 MIT 许可证。上游归属和商标说明请参阅 NOTICE。DeepSeek 和 DeepSeek Harness 的相关权利归各自所有者。