A
dsh-living
alexisvon/dsh-living
A living agent runtime for DeepSeek Harness: clock, memory, persona, and WorldGem modules
インストール
dsh plugin --profile web add github:alexisvon/dsh-livingREADME
dsh-living
English | 中文
一个按设定活着的 agent 运行时:有自己的作息、记忆和人格,通过 WorldGem 接入真实世界。
状态:v0.3.13。核心、协议与三颗真实宝石(B站 / 微信 / 小佩喂食器)已实现;宝石从 npm 下载到 living 自己的目录,不占用 DSH 插件列表。
它是什么
- 时钟 —— 10–60min 网格 + 热冷时域 + 自己排的日程 + 每天一次夜睡(默认 03:30,可配)
- 记忆 —— 分层 + 三种外观(热区注入 / 温区检索 / 冷区只剩线索);遗忘是降维,不是删除
- 人格 ——
charter(只读)+self(每晚重写,git 版本化)+journal - 世界 —— WorldGem:一颗宝石交出能力(MCP)、事件(ingest / outbox)和一份教模型怎么用它的说明(skill)
安装
从 DSH 插件市场安装 dsh-living(唯一需要装成插件的包):
dsh plugin --profile <profile> add dsh-living
宝石不在市场里逐个安装。装好 living 后,打开 Living → 宝石 → 添加宝石,从内置宝石库选择 B站 / 微信 / 小佩喂食器;living 会从 npm 下载到自己的目录:
$DSH_HOME/living/
data/ # life.db、宝石配置/凭据/媒体
workspace/ # agent 的工作目录
gems/ # 宝石代码(可随时重下)
安装或卸载宝石后重启宿主生效。卸载宝石只删除代码与 media 缓存,保留配置、凭据和 life.db 里的记忆。
数据与备份
记忆库是 $DSH_HOME/living/data/life.db(默认 ~/.dsh/living/data/life.db),包含事件、三层记忆、人格、日记、日报与外发记录。旧版的 charter.md / self.md / journal/ 会在启动时迁入 data/legacy/ 并一次性导入。
Living → 配置 → 数据与备份 提供:
- 备份记忆:生成一致快照(
VACUUM INTO),通过浏览器的保存位置选择器导出.db;文件是明文 SQLite,含人设与记忆,请妥善保存。 - 导入记忆:选择
.db上传并校验(SQLite 头、integrity_check、schema 版本、必需表)。校验通过后暂存,重启宿主时先把当前库备份到data/backups/pre-import-*,再替换。只做覆盖恢复,不合并。 - 更高 schema 的库会被大声拒绝,不会静默打开。
卸载 dsh-living 插件时 DSH 只移除插件代码;data/ 与 workspace/ 不会自动删除。
它不是什么
- 不是通用助手,不接管你日常的 coding 会话
- 不替你做决定;公网发声强制过限制层
- 不与第二个记忆插件共存——记忆只有一个所有者
仓库结构
packages/
core/ → npm: dsh-living 运行时
protocol/ → npm: dsh-living-protocol 宝石协议(清单 / 端点 / 失败码)
gem-example/ → npm: dsh-gem-example 参考宝石
gem-bili/ → npm: dsh-gem-bili B站宝石(能力 + 私信 + 历史私信 + 公开互动)
gem-wechat/ → npm: dsh-gem-wechat 微信宝石(独立 iLink bot,文本/图片/文件私聊)
gem-petkit/ → npm: dsh-gem-petkit 小佩喂食器(D4H 状态/出粮/记录/看图)
docs/ 架构与立项
scripts/ selfcheck / 回测等维护脚本
spikes/ 上线前验证脚本
一个仓库,多个包。协议独立成包是必须的(宝石作者要依赖它),但不必独立成仓库。
文档
- 架构 —— 它是什么:时钟、记忆、WorldGem、观测面、失败降级
- 决策记录 —— 为什么不是别的:47 条决策、被否掉的方案、翻案条件。接手前先读这份
- 工作协定 —— 谁写、谁评审、红线、交接贴什么
- 立项 —— 目标、非目标、分期与验收、风险
快速了解三个设计原则
- 自动唤醒按网格配额:10–60min 网格、30/60s 抽一次;抽中才叫模型,running 期间的点作废
- 窄口靠结构:工具面由 preset 决定,不靠提示词嘱咐
- 账本不许模型写:观测事实由代码与解析器产出,它自己的日记单独一区
许可证
MIT