前言¶
给常驻 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
