前言¶
在 DeepSeek Harness（DSH）里做游戏或复杂交互项目，常见做法是零散地写技能、规则，或临时让子代理扮演不同角色。流程一拉长，就容易缺少统一的工作流、角色分工和钩子约束，和「工作室式」协作差距很大。
Claude Code 生态里已有 Claude Code Game Studios（CCGS） 这类一站式游戏开发框架。DSH 的运行环境与 Claude Code 不同（例如无 bash 工具、沙箱限制子进程、@path 不展开），不能直接跑上游包。deepseek-harness-game-studios（DSGS，维护者 HYClub，社区分类：工作流）把 CCGS v1.1.2（MIT）移植到 DSH：一个插件包内包含钩子桥、工作室状态行，以及可机器级自装的框架载荷（技能、代理、规则等），在空工作区用 /start 即可走 onboarding。
这是什么¶
DSGS 是 CCGS 的 DSH 原生运行时移植，不是从零重写：技能、代理、规则与文档来自上游 MIT 内容；本仓库提供 Node 钩子、技能生成、机器级安装与插件桥接。仓库自述版本 v0.1.8，跟踪上游 commit b21fa0f（2026-09-29）。内容源在 .claude/，可运行的 DSH 等价物由 tools/build-dsh.mjs 生成到 .dsh/。
一句话：49 个代理、76 个技能（README 实现状态表记为上游 74 个技能均已移植，另含 DSGS 专有技能）、13 条规则、14 个 Node 钩子（覆盖上游 9 个事件），打包成「一次安装、任意空目录 /start 初始化工作区」的工作流插件。
核心功能¶
下面介绍已在 README「Implementation status」中标注为已实现、且与 package 描述一致的能力。
一站式插件包¶
- 钩子桥：上游 12 个脚本改写为 14 个 Node 实现，经
dsh-hooks-claude-code桥接；9 个上游事件均有映射（实时触发覆盖 6/9；Notification、PreCompact、PostCompact在 DSH 侧无事件源，仅在挂载层验证）。 - 状态行：
/statusline技能及node .dsh/statusline.mjs，展示工作室阶段、姿态、史诗/故事、Sprint、引擎等信息（README 称相对上游停靠状态条，DSH 客户端清单不收录非@deepseek-ai/*包，故用技能替代）。 - 自装载荷：首次加载插件时在机器级安装框架到
~/.dsh/dsgs，并写入用户级引导技能；不修改项目目录内已有文件。
工作流与协作¶
- 技能：上游 74 个技能均可通过
/name调用；另有 DSGS 专有技能如statusline、dsgs-install。 - 代理：49 张角色卡（
.dsh/agents/<name>.md）及委派约定；嵌套委派subagent.maxDepth: 2（DSH 默认为 1）。 - 规则：13 条；路径作用域规则引擎的等价实现为 PostToolUse 钩子在每次 write/edit 后注入匹配规则文本。
- 配置：以
project.yaml为单一来源；提供 Node 版resolve_config/resolve_setting。 - 脚本：上游每个
.sh均有沙箱内可运行的 Node 端口（.dsh/scripts/*.mjs）。
内容保真¶
README 称对上游 258 个文件 / 42,895 行 做度量：96.0% 逐字保留，其余为文档化改写或结构差异，0 未解释丢失。空工作区经 /start 初始化约 928 项（README 实现状态表）。
安装与启用¶
安装前请自行阅读 GitHub 仓库 源码与 MIT 许可证。插件以当前 dsh 进程权限运行，会在用户目录写入文件（见下一节）。
图形界面¶
Plugins → Add plugin → 粘贴 https://github.com/HYClub/deepseek-harness-game-studios → Install → 重启 dsh web。
命令行¶
dsh plugin --profile web add https://github.com/HYClub/deepseek-harness-game-studios
然后 重启 dsh web。
首次加载后，框架会安装到机器级路径；之后在新工作目录、新会话中输入：
/start
/start 会检查工作区是否已初始化；若未初始化则先初始化，再引导 onboarding。
插件写入的路径与撤销¶
| 路径 | 含义 |
|---|---|
~/.dsh/dsgs/** |
框架载荷（技能、代理、规则、钩子、工具、文档等） |
~/.dsh/skills/dsgs-init/SKILL.md、~/.dsh/skills/start/SKILL.md |
用户级引导技能 |
撤销示例（README 原文，PowerShell）：
Remove-Item -Recurse -Force "$env:USERPROFILE\.dsh\dsgs"
Remove-Item -Recurse -Force "$env:USERPROFILE\.dsh\skills\dsgs-init","$env:USERPROFILE\.dsh\skills\start"
# then uninstall the plugin and restart dsh web
卸载插件并再次重启 dsh web。
典型用法¶
- 按上文安装插件并重启
dsh web。 - 在新的工作目录打开新会话。
- 输入
/start，完成工作区初始化与 onboarding。 - 日常可用
/statusline查看工作室状态行；各业务技能按上游命名以/技能名调用（具体清单见安装后的~/.dsh/dsgs或项目内.dsh/skills）。 - 若需改技能或代理，README 指出 DSGS 是可编辑模板，并附带
DSGS Skill Testing Framework/用于检验自定义技能（细节见仓库文档）。
适用场景与限制¶
适合：希望在 DSH 里用接近 CCGS 的多角色、多技能、规则与钩子驱动方式做游戏或大型交互项目；希望一个插件完成桥接与载荷安装，而不是手工拷贝 .claude/ 目录。
需注意：
- DSH 社区插件目录（如 SkillHub 条目页）为独立生态站点，与 DeepSeek / 幻方无官方从属关系；安装来源以你信任的 GitHub URL 为准。
- 未实现或仅有替代方案（README 表格）：Composer 上方停靠状态条（用
/statusline替代）；PreToolUse 事前提醒（DSH 无等价上下文字段，部分校验改在 PostToolUse，或通过插件行advisory: deny事前拦截）；每代理工具白名单与自动发现（用角色卡与toolFilter/persona约定）；@path导入（合并为.dsh/docs/studio-rules.md按需阅读）。 - 运行环境要求 Node >= 20（见
package.json的engines）。
结尾¶
DSGS 把 CCGS v1.1.2 的工作室能力搬到 DSH：一条官方安装命令 + 重启 web + 新目录 /start，即可在本地获得大规模技能、代理与钩子工作流。进一步细节、项目结构与自测说明见仓库 README（含 简体中文 README）。
