前言¶

做 DSH 時，常有一類等待場景：編譯在跑，測試在跑，長任務還掛在會話裏。此時想短暫切換一下，但不希望離開 dsh web，也不想把任務上下文切走。

dsh-whale-cards 是一個可安裝到 DeepSeek Harness（DSH）Web 的本地遊戲館插件：它提供幾個策展小遊戲，以及一個原創鯨魚夥伴「瀾音」。等待期間可以打開一局，隨時收起，之後再從同一步繼續。

它面向的是 DSH / 智能體開發者的本地工作流：在宿主界面裏增加一個低打擾、可恢復、可本地運行的休閒入口。它也是社區插件，不應被理解爲“官方應用商店”裏的官方應用。

這是什麼¶

changer-changer/dsh-whale-cards 是一個面向 DSH Web 的本地遊戲館插件。倉庫許可證爲 MIT。

它提供三類本地小遊戲：

• 鯨牌茶歇
• 港灣對決
• 潮汐拾光

插件還提供跨遊戲陪伴角色瀾音，並支持斷點續玩。

它的基本分工是：

• 經典模式使用本地規則與確定性 AI，不消耗 Token。
• Agent 模式爲每局創建獨立 DSH Agent Session，由瀾音作出合法決策，會調用所選模型並消耗 Token。

運行要求¶

下面這幾個環境條件需要滿足：

• DeepSeek Harness 0.1.0-rc.7 兼容版本
• Node.js ^22.19.0 或 >=24.0.0
• 可用的 dsh 和 pnpm；dsh plugin 會在 profile 內調用 pnpm

另外，DSH 仍處於 developer preview。插件發佈前應在目標 DSH 版本上重新構建、測試，並做真實 Web 冒煙測試。

核心能力¶

下面介紹這個插件明確提供的能力。

本地遊戲館¶

插件在 DSH Web 裏提供本地遊戲館，包含：

• 鯨牌茶歇
• 港灣對決
• 潮汐拾光

存檔按遊戲隔離，打開對應遊戲即可繼續之前的對局。

經典模式¶

經典模式使用本地規則與確定性 AI。

它的特點是：

• 不調用模型
• 不消耗 Token
• 決策由本地規則與本地 AI 完成

適合只想玩牌、不想觸發模型調用的場景。

Agent 模式¶

Agent 模式會爲每局創建獨立 DSH Agent Session。

在這一模式下：

• 瀾音負責作出合法決策
• 會調用所選模型
• 會消耗 Token
• 玩家可以直接與瀾音聊天，或觸發對局內的快捷表達

Agent 只能選擇本輪引擎生成的合法動作 ID。真實狀態變更由本地規則引擎校驗執行。

瀾音陪伴¶

瀾音是跨遊戲的原創陪伴角色。

它可以：

• 進行真實模型聊天
• 提供 Soul 視圖
• 使用瀏覽器持久化長期記憶
• 根據局勢生成相關臺詞與表情

模型不可用時，遊戲可以降級爲本地臺詞或本地決策。

斷點續玩¶

插件支持斷點續玩。

收起遊戲後，牌局會凍結並保存。刷新頁面、切換 DSH 會話或稍後重新打開時，可以恢復。

非阻塞提醒¶

當 DSH 任務完成或需要確認時，插件只顯示一次非阻塞提醒。

它不會暫停遊戲，也不會搶焦點。

本地化與無附加服務¶

插件明確做到：

• 無賬號
• 無廣告
• 無聯網對戰
• 無遙測

模型調用是唯一外部依賴。模型不可用時，遊戲可降級爲本地臺詞或本地決策。

安裝¶

下面給出本地倉庫安裝流程。

先克隆倉庫，進入插件目錄，安裝依賴並構建：

git clone <this-repository-url>
cd <this-repository>/dsh-whale-cards
npm ci
npm run build

構建完成後，將插件安裝到 DSH 的 web profile：

dsh plugin --profile web add .

安裝後先檢查配置，再啓動 Web：

dsh --profile web --dump-config
dsh web

經過上面的步驟，插件進入 DSH Web 後，可以從浮動入口進入遊戲館。

典型用法¶

下面是可復現的使用路徑。

1. 打開 dsh web。點擊浮動入口展開遊戲館；點擊入口右側「直達」，可以直接進入你設置的默認遊戲。
2. 在大廳選擇遊戲。沒有存檔時開始新對局；有未完成對局時，遊戲卡會顯示「有存檔」，打開即可繼續。
3. 在大廳選擇「經典模式」或「Agent 模式」，並設置「直達」默認打開的遊戲。
4. Agent 對局中，可以點擊「教我這一步」「認真點」「放我一馬」，也可以自由聊天。
5. 記憶 tab 可查看、編輯、刪除瀾音記住的事項；Soul tab 可查看人格、當前牌局 Session 和上下文策略。
6. 收起遊戲後，牌局凍結並保存。刷新頁面、切換 DSH 會話或稍後重新打開時，可以恢復。

成本與模型邊界¶

這裏需要區分兩種模式。

經典模式¶

經典模式不調用模型，不消耗 Token。

它依賴本地規則與確定性 AI，適合離線、低成本的本地對局。

Agent 模式¶

Agent 模式會調用所選模型，並消耗 Token。

它還會使用兩個只讀會話工具：

• search_sessions：最多返回 5 條
• inspect_session：查看最近 12 條

這兩個工具可能將相關會話片段發送給所選模型。使用 Agent 模式時，應按所選模型服務的隱私條款評估。

決策邊界¶

Agent 不能繞過本地規則。

它只能選擇本輪引擎生成的合法動作 ID。真實狀態變更由本地規則引擎校驗執行。

模型不可用時，可以降級爲本地臺詞或本地決策。

數據與卸載¶

本地數據¶

插件的數據主要放在瀏覽器 localStorage。

需要注意：

• 瀏覽器 localStorage 存檔不是機密存儲
• 可以手動 removeItem 清理
• 卸載插件後，瀏覽器本地存檔會保留

如果你在意本地殘留，應在卸載後自行清理對應瀏覽器存儲。

卸載¶

卸載命令是：

dsh plugin --profile web remove dsh-whale-cards

卸載後，瀏覽器本地存檔仍會保留。

適用場景與注意¶

這個插件適合在 DSH Web 內使用、希望短休息不打斷長任務的人。

適合：

• 等待編譯、測試或長任務時打開一局
• 只使用本地規則、不想消耗 Token
• 想測試 Agent 模式下瀾音與所選模型的交互
• 希望遊戲可收起、可恢復、不搶焦點

需要注意：

• 插件會接入 DSH 的模型配置與會話能力，安裝前應檢查源碼與 MIT 許可證。
• Agent 模式會調用所選模型並消耗 Token。
• Agent 模式可能通過會話工具讀取相關會話片段，並將其發送給所選模型。
• 瀏覽器 localStorage 存檔不是機密存儲，卸載後仍會保留。
• DSH 仍處於 developer preview，發佈前應在目標 DSH 版本重新構建、測試和真實 Web 冒煙測試。
• 如果從 Git commit 安裝，可能觸發 pnpm 10+ 阻止 prepare 構建腳本；需要按錯誤信息將確切包鍵加入 Web profile 的 pnpm-workspace.yaml allowBuilds。
• README 不假定該包已發佈到 npm registry。
• 項目沒有複製或打包 Small-tailqwq/dsh-deep-whale 的代碼、美術、角色設計、臺詞或音頻。

結尾¶

dsh-whale-cards 的價值比較具體：在 DSH Web 裏提供一個本地遊戲館，支持斷點續玩，支持經典本地模式和 Agent 模式，並且儘量不打斷任務、不搶焦點。

當前已覈實資料提供了倉庫地址，但未提供可確認的目錄頁 URL，因此這裏只給出倉庫鏈接。

• GitHub: https://github.com/changer-changer/dsh-whale-cards
• 許可證: MIT