前言¶

DSH 的插件機制允許在 harness 中掛接輔助行爲。dsh-digipet 是一個 DSH 插件，它把真實工作回合、消息、工具調用和報錯轉化爲寵物經驗，並按系譜分支進化。它的邊界明確：不註冊工具、不寫會話事件，零 token 且模型不可見。下面介紹它的用途、安裝、命令和限制。

這是什麼¶

swaylq/dsh-digipet 是一個在 DeepSeek Harness 中孵化的“數碼獸”插件。它監聽事件，按規則增加 XP；寵物從數碼蛋到究極體，並沿龍、賢者、聖翼、病毒等系譜分支進化。

倉庫目錄爲 swaylq/dsh-digipet，許可證爲 MIT。package.json 要求：

node >=20

核心能力¶

經驗來源¶

下面四個事件是插件監聽的事件點：

agent/turn-stopping
agent/inbox/claimed
tools/result
agent/error

插件按規則增加 XP。事件只表示“發生了什麼類型的事”，不讀取用戶代碼或會話內容。

進化線¶

寵物生命週期從數碼蛋到究極體。進化可以沿龍、賢者、聖翼、病毒等系譜分支。觸發進化儀式的命令是：

/pet evolve

模型不可見¶

插件不註冊工具，不調用 agent.inject()，不寫會話事件：

agent.inject()

它對每一次模型請求的貢獻是零字節。

狀態落盤¶

存檔寫入：

$DSH_HOME/digipet/state.json

寫盤採用臨時文件、fsync、原子 rename，並按 1.5 秒節流落盤：

fsync
rename

防刷與遷移¶

當飽食度大於 90% 時，經驗收益降到 15%，作爲防刷機制。支持 0.1.x 舊存檔在下次啓動時自動無損遷移。

信任邊界¶

插件無網絡訪問，只讀自己的存檔文件，只寫自己的 state.json。它不否決、不改寫、不延遲真實流程。

安裝與啓用¶

README 給出的安裝命令使用 --profile web：

dsh plugin --profile web add github:swaylq/dsh-digipet

執行後重啓 dsh，然後在任意會話中執行：

/pet hatch

典型用法¶

常用命令如下：

/pet
/pet hatch
/pet evolve
/pet name <名字>
/pet dex
/pet story
/pet about

• /pet：查看立繪、XP、飽食度、心情、四維屬性和累計吞食。
• /pet hatch：孵蛋。
• /pet evolve：觸發進化儀式。
• /pet name <名字>：給寵物起名。
• /pet dex：查看圖鑑，未見過的形態顯示爲 ???。
• /pet story：查看一生的大事記。
• /pet about：查看機制說明與信任立場。

適用場景與注意¶

適合在 DSH 會話中使用插件輔助記錄工作事件，並通過 /pet、/pet dex 等命令查看狀態與圖鑑的開發者。插件以當前 dsh 進程權限運行，安裝前應檢查源碼、package.json 和 MIT 許可證，並確認 --profile web 示例是否符合目標環境。

需要注意：

• 一個 DSH home 一隻寵物，同機的所有 profile、會話、子 agent 共享它。
• 多個 dsh 進程同時跑時，存檔爲後寫者勝。
• 工具分類依賴名稱正則啓發，第三方工具命名奇怪時會被當成中性飼料。
• 進化門檻與食譜不可配置。
• 會話流裏的摺疊行會把立繪拍平成一行，需要點開卡片查看完整版。
• “數碼寶貝 / Digimon”是萬代南夢宮商標，本項目與其無任何關聯。

結尾¶

dsh-digipet 把真實工作回合、消息、工具調用和報錯變成可觀察的寵物經驗，同時保持零 token 和模型不可見。倉庫地址：

https://github.com/swaylq/dsh-digipet