前言¶
在 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）。
