DeepSeek Harness 插件

HYClub/deepseek-harness-game-studios

Star 数 ★ 16 分类 AGI 架构探索 收录于 2026-10-17

Claude Code Game Studios(CCGS v1.1.2,MIT)的 DeepSeek Harness 移植:76 个技能、49 个代理与钩子桥。

安装

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:HYClub/deepseek-harness-game-studios

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

安装 · 实现状态 · 项目结构 · 测试你的定制 · 验证 · 许可证

把一次 DeepSeek Harness 会话变成一间完整的游戏工作室。 49 个代理。79 个技能。一支协调好的 AI 团队。

本仓库是 Claude Code Game Studios(CCGS) 到 DeepSeek Harness(DSH)的移植,不是从零自研:技能、代理、规则、文档都来自上游(MIT); 本仓库提供 DSH 原生运行时(Node 钩子、技能生成、机器级安装、插件桥)。

来源与版本

上游项目 Donchitos/Claude-Code-Game-Studios
本移植锁定的上游版本 v1.1.2(commit b21fa0f,2026-09-29)
上游许可证 MIT(Copyright © 2026 Donchitos),本仓库沿用
本仓库 deepseek-harness-game-studios(DSGS)v0.2.2
移植方式 双栈同源:.claude/ 是内容源(上游原文,逐字保留);.dsh/** 由 tools/build-dsh.mjs 生成

上游面向 Claude Code(.claude/、.sh 钩子、bash 一行流、@path 导入)。这些在 DSH 下无法直接运行 (没有 bash 工具、管道捕获子进程被沙箱拒绝、不展开 @path)。本项目不改上游内容,而是生成 DSH 可运行的等价物,并验证内容零丢失。

插件包把框架打包在 payload/ 下 —— 使用插件时你不需要看它。

安装

① 网页版

插件 → 添加插件 → 填 https://github.com/HYClub/deepseek-harness-game-studios → 安装 → 重启 dsh web。

dsh plugin --profile web add https://github.com/HYClub/deepseek-harness-game-studios

② 桌面版

打开桌面客户端,插件 → 添加插件 → 填同一个 URL → 安装 → 重启客户端。

插件首次加载时会自动把框架装到机器级(~/.dsh/dsgs 与用户级引导技能)。之后:

新建工作区 → 新会话 → 打 /start

/start 会自己判断该工作区有没有初始化:没有就先初始化,然后带你走引导。

升级

在初始化过的工作区里输入(0.2.1 及以上版本才有 /update):

/update

它会读出已安装版本与最新版本,把要执行的命令先给你看,你同意之后才执行。装完重启客户端,新技能在新会话里出现。

这个工作区初始化了吗? 项目根目录下有 .dsh/skills/start/SKILL.md 或 .dsgs-installed.json 就算初始化过。 两个都没有的话:在 DSH 里打开这个项目,新开一个会话打 /start —— 初始化一次即可,以后在这个项目里随时可以 /update。

从 0.2.0 或更早版本过来? /update 从 0.2.1 才有,所以第一次升级要手动:

dsh plugin --profile web remove deepseek-harness-game-studios
dsh plugin --profile web add https://github.com/HYClub/deepseek-harness-game-studios

桌面版用户走 插件 面板(见下)。之后每次升级都是一条 /update。

桌面版:插件 profile 由应用独占,命令行改不了它。打开 插件 → 卸载 deepseek-harness-game-studios → 添加插件 粘贴 https://github.com/HYClub/deepseek-harness-game-studios → 安装 → 重启。 /update 照样会帮你查版本,并告诉什么时候需要这么做。

插件会往你机器上写什么(与撤销)

路径 内容
~/.dsh/dsgs/** 框架载荷(技能、代理、规则、钩子、工具、文档、指令文件)
~/.dsh/skills/dsgs-init/SKILL.md、~/.dsh/skills/start/SKILL.md 用户级引导技能

它绝不触碰任何项目目录,也绝不覆盖项目里的文件。撤销:

Remove-Item -Recurse -Force "$env:USERPROFILE\.dsh\dsgs"
Remove-Item -Recurse -Force "$env:USERPROFILE\.dsh\skills\dsgs-init","$env:USERPROFILE\.dsh\skills\start"
# 再卸载插件并重启 dsh web

实现状态

✅ 已实现(均有实测证据)

项 状态 说明
技能 ✅ 上游 74 个全部移植,逐个可 /调用
代理角色卡 ✅ 49 个,.dsh/agents/<name>.md + 委派约定
规则 ✅ 13 条,含上游"路径作用域规则引擎"的等价替代:PostToolUse 钩子在每次写入/编辑后注入命中的规则原文
钩子 ✅ 上游 12 个脚本 → 14 个 Node 重写版,经 dsh-hooks-claude-code 桥接;9 个上游事件全覆盖
钩子真实执行 ✅ 挂载 10/10 · 协议 12/12 · 事件活体 6/9 —— 在装有官方 bridge 包的机器上测得;没有该包的环境会报 SKIP,而不是假失败
配置解析 ✅ project.yaml 单一来源;resolve_config / __call resolve_setting 的 Node 端口
辅助脚本 ✅ 上游每个 .sh 都有 Node 端口(.dsh/scripts/*.mjs),沙箱内可运行
内容保真 ✅ 258 文件 / 42,895 行:96.0% 逐字、3.1% 已记录改写、0.5% 结构性、0.4% 换写法、0 行无法解释的丢失
机器级安装 ✅ 插件自带载荷(924 个文件)并在首次加载时安装;空工作区打 /start 即可用它初始化
/statusline ✅ 工作室状态行 阶段 · 姿态 · epic > story · Sprint n/m · 引擎(+13 单测)
嵌套委派 ✅ subagent.maxDepth: 2 实测「父 → 子 → 孙」(DSH 默认 1)
共享规则真正到达项目 ✅ CLAUDE.md 里的 @path 导入被改写成「需要时读某个文件」——本运行时不展开 @,不这么做的话那些标准文档只是被引用、从未被读
角色工具边界 ✅ 每张代理角色卡写明"本角色应只用哪些工具",并统一成本运行时的工具名。属软约束:运行时无法按代理限定工具集
一键式插件 ✅ 一个包 = 钩子桥 + 状态行投影 + 载荷自装
DSGS 专有技能 ✅ statusline、dsgs-install(上游没有)

⚠️ 部分等价 —— 能用,但有一处明确的限制

项 能用的部分 限制与原因
3 个钩子事件 映射已实现并单测 Notification、PreCompact、PostCompact 在 DSH 没有事件源,只能到挂载级验证(活体 6/9)
逐代理工具白名单 每张角色卡正文写明边界(工具边界 …:read, glob, grep, …),委派时模型读得到 DSH 的 subagent 不接受按代理限定工具集,也没有代理注册中心,运行时无法强制
bash ↔ Node 逐字节对照 能跑的每一对都逐字节一致;依赖 YAML 的 2 对是受控断言(数量不符即失败;有 python3 的环境用 PARITY_REQUIRE_ALL=1 禁止 SKIP) 本机 Git Bash 的 python3 是 Store 占位程序,bash 侧读不了 YAML

❌ 无法等价 —— 原因与替代

项 原因 替代
输入框上方的停靠状态条 DSH 的前端插件清单只收 @deepseek-ai/*(实测 60+ 条全为官方包,本包即使补 dsh.client 声明仍不在其中) /statusline 技能 + node .dsh/statusline.mjs;运行时字段(轮次/token/缓存/上下文%)由 DSH 自带状态条覆盖
PreToolUse 的事前提醒 tools/pre-execute 只携带 allow/deny/cancel/ask;additionalContexts 只从工具最终结果读取;执行中 agent.inject() 无效 validate-commit / validate-push 同时注册在 PostToolUse(提醒在动作之后到达);要事前阻断可把插件行设为 advisory: deny
!cmd`` 预执行行 DSH 没有预执行 改写为「前置命令」块,由模型自己运行

项目结构

.claude/                     # 上游内容源(MIT,逐字保留)
  settings.json              # 钩子、权限、安全规则
  agents/                    # 49 个代理定义
  skills/                    # 74 个技能(每技能一个目录)
  hooks/                     # 14 个脚本 —— 13 个事件钩子 + yaml-helper.sh
  rules/                     # 13 条路径作用域编码标准
  statusline.sh              # 上游状态行脚本(作参考保留)
  docs/                      # 工作流目录、39 个模板与写作指南
.dsh/                        # 由 tools/build-dsh.mjs 生成 —— 不要手改
  agents/  skills/  rules/  hooks/  scripts/  docs/
tools/                       # 生成器、校验器、Node 端口、插件、安装器
dsh-src/                     # DSH 专有手写叠加层(生成时并入 .dsh/)
DSGS Skill Testing Framework/  # 技能与代理自身的 QA
design/ src/ assets/ tests/ prototypes/ production/   # 你的项目

测试你自己的定制

DSGS 是给你改的模板。DSGS Skill Testing Framework/ 用来验证改过或新写的技能是否还站得住: 全部技能与代理的目录、按类别的质量评分表、行为规格,以及写规格用的模板。

/skill-test static [name]     # 结构 linter
/skill-test category [name]   # 按类别的质量评分
/skill-test spec [name]       # 行为规格断言
/skill-test audit             # 技能与代理的覆盖报告
/skill-improve [name]         # 测试-修复-复测循环;分数下降就回退

它测的是框架,永远不是你的游戏 —— 游戏的测试放在 tests/。

验证

pwsh -File tools/verify-port.ps1        # 7 步:生成 → 结构 → 引用 → 保真 → 钩子 → 挂载 → 套件
node tools/check-dsh.mjs                # skills=79 agents=49 rules=13 hooks=14 errors=0 warnings=0
node tools/verify-fidelity.mjs          # unexplained 0 / 内容零丢失(258 文件,42,895 行)
node tools/verify-hooks-mount.mjs       # 10/10 挂载用例
node tools/verify-hooks-bridge.mjs      # 12/12
node tools/verify-hooks-events.mjs      # 6/9 活体 + 3 仅挂载

支持本项目(以及上游)

DSGS 是移植:原始工作 —— 74 个技能、49 个代理、13 条规则与全部文档 —— 由上游作者完成, 他本人的支持渠道在上游仓库。 如果这个项目帮你省了时间,请优先支持上游作者。与 DSH 移植本身相关的 issue 与贡献请提到本仓库。

许可证

MIT License —— 见 LICENSE。上游版权 © 2026 Donchitos;移植层(生成器、Node 钩子、插件、 安装器、DSGS 专有技能)以同一许可证发布。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。