⚡ deepseek-forge

你的 DeepSeek Harness 开发锻造工坊——装上就能干活，不必 fork，不必魔改，不必重新发明轮子。

别的工具让你配半天环境才能开始写代码，我们让你今天就能开始。deepseek-forge 是一套按需安装的开发能力包：GitHub、浏览器验证、九种开发工作流、一个会帮你盯着 token 消耗的监督员——全都长在 Harness 原生机制上，卸载即净，不留后遗症。

兼容说明：安装命令与各组件包继续沿用 dsh-devkit 命名（CLI 为 npx dsh-devkit），既有 profile 不受影响。

✨ 它能为你做什么

• 审慎而强大：危险操作（删库、强推、读凭据、改权限……）自动走审批，凭据形状的参数直接拒，绝不给模型拿你的 secret 当工具参数的机会。
• 按任务启用，不刷存在感：GitHub / 浏览器 / 运行时扩展默认隐身，任务需要时一个 devkit_capability 唤起，turn 结束自动收回。你的提示词里不该躺着二十个用不上的 schema。
• 九种开箱即用的开发 Skill：修 CI、啃 GitHub Issue、审 PR、安全重构、前端调试、环境排障——都是"先看证据再动手"的干活流程，不是空话。
• 临时能力，随用随走：受信任的 Cordis 扩展按需加载、停止、卸载，生命周期全交给 Harness 自己管，我们不搞第二套注册表。
• Token Watch：你的 token 账房先生。消耗超限后台审查、长时间工作定期体检、判定异常才请你拍板——详见下文。

🚀 30 秒上手

要求 Node.js 22.19+（22.x）或 24+，以及随 Node 附赠的 npx。不需要全局安装 Harness——dsh-devkit 优先用你 PATH 里已有的 dsh，没有就自动 npx @deepseek-ai/dsh。

先体检：

npx dsh-devkit doctor

打开安装选择界面（方向键移动、空格选择、回车安装）：

npx dsh-devkit install --profile web

嫌交互慢？直接上预设：

npx dsh-devkit install --preset frontend --profile web   # 前端选手全家桶
npx dsh-devkit install --preset backend --profile web    # 后端选手全家桶
npx dsh-devkit install --preset full --profile web       # 成年人不做选择

也可以自己点菜：

npx dsh-devkit install --modules core,github,browser --profile web

常用选项：--dry-run（只看命令不执行）、--no-verify（装完跳过配置检查）、--profile <name>（装到指定 profile）。全局装过的话，直接用 dsh-devkit ... 代替 npx dsh-devkit ...。

📦 组件全家桶

组件	用途
core	风险操作提醒、凭据保护和开发 Skills。建议装。
github	GitHub Issue、PR、仓库和 Actions 工作流。
browser	基于 Playwright 的页面检查与浏览器调试。
runtime	Harness 临时 Cordis 扩展工具，仅用于受信任代码。
token-watch	消耗超限/长时间工作时后台并行审查，异常时暂停并请用户裁决。

🔐 GitHub 凭据

用 GitHub 组件前，在启动 Harness 的环境里提供 fine-grained PAT：

$env:GITHUB_PERSONAL_ACCESS_TOKEN = '<fine-grained PAT>'

export GITHUB_PERSONAL_ACCESS_TOKEN='<fine-grained PAT>'

只授目标仓库和当前任务需要的权限，别把真实 token 写进仓库、配置、聊天或命令历史——让系统的凭据管理来注入，它比你的剪贴板安全。

🧭 开始使用

装完启动 Harness：

dsh --profile web

没有全局 dsh 时：

npx --yes @deepseek-ai/dsh --profile web

• GitHub 能力默认按任务启用，让 agent 加载 setup-github Skill 即可。
• 浏览器能力需要时加载 setup-browser Skill；只有 Playwright 明确提示时才装浏览器文件。
• 出问题别慌：加载 troubleshoot-devkit Skill，或 npx dsh-devkit doctor。
• Runtime 组件只运行你信任的扩展代码——你懂的。

🎯 Token Watch：你的 token 账房先生

长任务跑着跑着，模型钻进死胡同狂烧 token——这种事我们见多了。token-watch 就是为此生的：

• 消耗审查：10 分钟窗口烧掉 30 万 token？后台立刻开个子代理审查这段活动，主任务照跑，不打断。只有两种时候它会叫停：审查期间窗口继续飙到硬停线（默认 60 万），或审查判定异常。
• 进度体检：连续干满 30 分钟？自动检查一下模型是不是在钻牛角尖——反复试同一个失败方案、重复读同一份文件、空转没进展，一眼看穿。
• 请用户拍板：判定异常才弹窗：继续 / 停止 / 关闭功能。审查子代理保留工具权限、能自己读文件核实，但最终必须给结构化结论。
• 随时关掉：一句 token_watch 工具调用，或弹窗里一键关闭。审查失败一律放行，绝不卡住你的会话。

npx dsh-devkit install --modules core,token-watch --profile web

🧹 卸载

npx dsh-devkit uninstall --modules core,github,browser,runtime,token-watch --profile web

装了啥就卸啥，干净利落。

⚠️ 安全边界（说人话版）

DevKit 会减少不必要的工具暴露，并为多类高风险操作增加审批或拒绝，但它不是安全沙箱。真正的安全边界依然是：Harness 的 sandbox、subprocess/approval policy、操作系统权限和远程服务权限。我们负责把风险摊到你面前，你负责拍板——架构与限制详见 DECISIONS.md，路线图见 TODO.md。

🛠️ 从源码运行

正式用户优先 npx dsh-devkit ...。想给本项目贡献代码？

git clone https://github.com/ophielel/deepseek-forge.git
cd deepseek-forge
pnpm install --frozen-lockfile
node ./packages/installer/lib/cli.js doctor
node ./packages/installer/lib/cli.js install --profile web --harness <path-to-deepseek-harness>