前言¶
在 DeepSeek Harness（DSH）裏，Agent 預設需要在會話開始前確定。已有做法通常是在 Web UI 的預設選擇器裏手動選擇；如果希望在新會話裏用一條斜槓命令完成同樣切換，dsh-gamemode 提供了一個入口。
下面介紹它的能力、安裝方式、用法和限制。
這是什麼¶
dsh-gamemode 是一個 DSH 斜槓命令插件：/gamemode 1 用於一鍵切換到 DeepSeek Harness 內置“創造模式”（cordis Agent 預設）。維護者爲 XCNXNXNX。
它解決的是一個具體問題：在會話還沒有開始之前，用命令把當前 live agent 切換到目標 Agent 預設，並記錄這個選擇。
核心功能¶
dsh-gamemode 支持以下命令和記錄行爲：
1、支持 /gamemode 1 或 /gamemode creative，切換到創造模式（cordis 預設）。
2、支持 /gamemode 0 或 /gamemode survival，切換到標準模式（standard 預設）。
3、支持 /gamemode，查看當前會話預設。
4、執行與 Web UI 預設選擇器相同的操作：recompose live agent 到目標預設的 standing mount。
5、記錄 agent-preset/selected，以便 resume / fork 時重建同一組合。
6、包聲明 dsh.bundle，cordis.patch.yml 自動插入插件行。
從插件行爲看，核心動作是：
ctx.agentPresets.recompose(agent.ctx, presetId)
agent.session.append('agent-preset/selected', { agentPreset })
第一句把當前 live agent 重新掛到目標預設的 standing mount；第二句落盤持久選擇，使 resume / fork 時能重建同一組合。
安裝與啓用¶
在 profile 名爲 web 的環境中，使用下面的安裝命令：
dsh plugin --profile web add dsh-gamemode
如果你的 profile 名不是 web，需要把命令中的 web 替換爲自己的 profile 名。
安裝後，插件包聲明的 dsh.bundle 和 cordis.patch.yml 會自動插入插件行。
典型用法¶
先創建或確認一個新會話，再發送第一條消息前執行切換命令。
| 命令 | 作用 |
|---|---|
/gamemode 1（或 /gamemode creative） |
切換到創造模式（cordis 預設） |
/gamemode 0（或 /gamemode survival） |
切換到標準模式（standard 預設） |
/gamemode |
查看當前會話預設 |
限制與官方界面一致：Agent 預設只能在會話尚未開始（還沒有 turn/start）時切換；對話開始後預設鎖定。原因是歷史是在舊組合下產生的。
因此典型步驟是：
1、新建會話。
2、在發送第一條消息前執行 /gamemode 1。
3、如需切回標準模式，執行 /gamemode 0。
4、用 /gamemode 查看當前會話預設。
適用場景與注意¶
適合在新會話開始前需要在 standard 與 cordis 之間切換的 DSH 用戶。如果你已經在對話中，這個插件不能改變已產生歷史對應的預設。
使用前注意：
1、插件以當前 dsh 進程權限運行。安裝前應檢查源碼、依賴和許可證。
2、許可證爲 BSD-3-Clause。
3、peerDependencies 中的 @deepseek-ai/cordis、@deepseek-ai/dsh-agent-presets、@deepseek-ai/dsh-commands 被標記爲 optional。
4、如果本地構建，構建命令爲：
bash scripts/build.sh
安裝/注入生成的包可使用 DSH 插件工具鏈，例如 dev_inject_plugin。
結尾¶
dsh-gamemode 的價值不在於新增一套預設系統，而是把 DSH 已有的預設切換路徑做成一條斜槓命令：在新會話開始前，用 /gamemode 1 切到 cordis，用 /gamemode 0 切到 standard，並用 /gamemode 查看當前選擇。
鏈接：
- GitHub：
https://github.com/XCNXNXNX/dsh-gamemode - 目錄頁：URL 未確認，因此不在此列出。
