前言¶
給常駐 agent 做開發時，一個繞不開的問題是「作息」由誰控制。常見做法是在外部寫定時器、心跳或巡檢腳本，按固定節奏喚醒 agent——節奏寫死在代碼裏，agent 沒有時間感，消息來了也只能等下一輪。
dsh-agent-life 走的是另一條路：插件只提供睡眠、狀態感知、整點報時這幾個循環原語，零規則。何時睡、睡多久、醒來做什麼，全部由 agent 自主判斷。下面介紹它的定位、核心功能和安裝配置。
這是什麼¶
dsh-agent-life 是一個 DSH（DeepSeek Harness）插件，作者 jonah791，MIT 許可證，當前版本 0.1.0（截至 2026-09-07）。一句話定位：數字生命循環原語——可打斷的 sleep（到期自我喚醒）+ 醒來狀態注入 + 事故文件讀取 + 決策日誌。
設計原則是「只提供原語，不做決策」：插件不規定作息表，只保證睡眠可以被安排、可以被打斷、醒來時能感知時間流逝。
核心功能¶
life_sleep：可打斷的進程內 wait¶
睡眠實現爲進程內 wait：到期自動自我喚醒；主人消息隨時打斷（即時事件監聽）。
即時插話¶
任何 user 事件立即取消睡眠定時器，消息不用等睡眠結束才被處理。這是睡眠可被打斷的機制基礎。
life_status：狀態感知¶
查看當前時間、安排中的睡眠、守護事故記錄（免疫層可見性）。
整點報時¶
時間消息注入上下文最後面。同小時零注入，防止破壞緩存命中；跨小時自動更新。實現上通過 agent/pre-step waterfall（prepend 最前註冊）完成，時間永遠在上下文末尾。
時間感來自差值¶
喚醒消息攜帶「睡了多久 + 期間新增事件數」，無心跳、無巡檢。agent 對時間流逝的感知來自這兩個差值，而不是外部定時器不斷喂數據。
安裝¶
官方安裝方式是手動 clone 到 self-plugins 目錄並構建。先進入你的 self-plugins 目錄，clone 倉庫，再裝依賴、編譯：
cd <你的 self-plugins 目錄>
git clone https://github.com/jonah791/dsh-agent-life.git
cd dsh-agent-life
pnpm install
pnpm build
依賴方面，插件通過 peerDependencies 聲明瞭對 DeepSeek 官方包的依賴，包括 @deepseek-ai/dsh-agent ^0.0.1-rc.1、@deepseek-ai/dsh-llm ^0.0.1-rc.1、@deepseek-ai/dsh-tools ^0.0.1-rc.1、@deepseek-ai/cordis ^4.0.1-rc.1、@deepseek-ai/schemastery ^3.18.1-rc.1。安裝前確認你的 DSH 環境滿足這些版本要求。
配置¶
插件有兩個配置項，默認值均爲空，啓用前需要按自己的環境填寫：
| 配置項 | 說明 |
|---|---|
incidentPath |
守護事故文件路徑 |
dataDir |
決策日誌目錄 |
典型用法¶
按上面的步驟安裝並配置好兩個路徑後，插件的運行流程是這樣的：
- agent 通過 life_sleep 安排一次睡眠；
- 睡眠期間若有消息進來，user 事件即時監聽會立即取消定時器，消息即刻送達；
- 正常睡到點時自動喚醒，喚醒消息帶上「睡了多久 + 期間新增事件數」，agent 據此建立時間感；
- 每逢跨小時，整點報時把當前時間注入上下文末尾，同小時內不重複注入。
作者還有一個相關項目「我的數字生命愛麗絲 — 插件生態中心」，可作爲該插件的整體架構參考：https://github.com/jonah791/alice-digital-life
適用場景與注意¶
適合的場景：想讓常駐 agent 具備自主作息、又不想在外部維護心跳和巡檢邏輯的開發者；需要 agent 對時間流逝有感知、同時保證用戶消息即時到達的場景。
使用前注意：
1、插件以當前 dsh 進程的權限運行，安裝前應檢查源碼與許可證（本項目爲 MIT）。
2、官方只提供手動 git clone 加構建的安裝方式，資料中沒有 dsh plugin add 之類的命令，不要憑名稱拼接安裝命令。
3、incidentPath 與 dataDir 默認值爲空，需要自行配置才能啓用對應能力。
結尾¶
dsh-agent-life 的價值在於把作息控制權交還給 agent：插件只提供睡眠、狀態、報時三個原語，節奏由 agent 自己定，開發者不必再寫外部調度腳本。
- GitHub 倉庫：https://github.com/jonah791/dsh-agent-life
- 社區目錄頁（獨立社區站點，非官方應用商店）：https://www.skillhub.cn/plugins/jonah791/dsh-agent-life
