前言¶
在 DeepSeek Harness(DSH)里跑 Claw Agent 时,常见做法是把 SOUL、AGENTS 等人设写在仓库或零散文档里,每开新会话再手动粘贴,或依赖 Agent 自己「记得」去读文件。人设一旦变长,既难统一维护,也容易和实际注入进模型的内容不一致。
下面介绍社区插件 dsh-claw-identity(仓库 README 中 npm 包名为 dsh-agent-identity)。它属于治理套件 Phase 1:从 ~/.dsh/DSclaw/<agent>/ 读取核心 Markdown,在符合条件的会话里写入系统提示,且不拦截工具调用。卸载插件后文件仍留在磁盘,只是不再自动注入。
这是什么¶
- 定位:Claw identity files for DeepSeek Harness——把 SOUL / AGENTS 等人设打进提示词。
- 维护者:xingyingyuzhui。
- 分类:模型推理(SkillHub 目录归类)。
- 许可证:MIT(
package.json版本 0.1.8,Node.js >= 20)。
依赖 dsh-agent-registry 创建的 Claw 目录结构;本插件只负责「核心人设」层的提示词注入,不负责创建 Agent 工作区本身。
核心功能¶
文件与注入规则¶
README 约定的机制如下。
| 文件 | 本插件行为 |
|---|---|
SOUL.md / IDENTITY.md / AGENTS.md / TOOLS.md |
每轮对话打进系统提示 |
BOOTSTRAP.md |
新建 Agent 时存在;初次问答(如名称、如何称呼用户)未完成前一并注入,完成后由 Agent 删除 |
USER.md / MEMORY.md / 日记 |
不由本层注入;由 dsh-agent-memory 在开场注入(有长度上限) |
HEARTBEAT.md |
仅存盘;可在「核心」Tab 编辑。巡检默认关闭(every: 0),本层不会在空闲时 tick |
生效范围¶
- 仅当 当前 session 的工作目录(cwd)位于
DSclaw树下时,才注入上述核心人设。 - DSH Web:设置 → Claw Agent → 核心 Tab 可读写这七个相关文件(含只存盘项)。
USER.md、MEMORY.md、HEARTBEAT.md在本插件层不会塞进提示词;记忆与心跳由对应插件或配置承担。
安装与启用¶
官方安装命令(来自 GitHub README):
dsh plugin --profile web add github:xingyingyuzhui/dsh-agent-identity
安装完成后重启 dsh web,新配置才会加载。
本地开发时可链接本地目录(路径改为你本机绝对路径):
dsh plugin --profile web add link:/abs/path/to/dsh-agent-identity
卸载:
dsh plugin --profile web remove dsh-agent-identity
典型用法¶
- 通过
dsh-agent-registry准备好~/.dsh/DSclaw/<agent>/及其中的人设文件。 - 按上文命令安装 dsh-agent-identity,重启 Web 端。
- 在 设置 → Claw Agent → 核心 中编辑
SOUL.md、IDENTITY.md、AGENTS.md、TOOLS.md等;新建 Agent 时保留BOOTSTRAP.md,完成首轮身份问答后按流程删除。 - 在 cwd 位于该 Agent 的 DSclaw 工作区下 的会话中对话,观察系统提示是否已包含核心人设内容。
- 若需要用户画像与长期记忆进开场上下文,需另行安装并配置
dsh-agent-memory(与本插件分工不同,勿重复期望本插件注入USER.md/MEMORY.md)。
README 未提供额外 CLI 示例;行为以 Cordis patch(cordis.patch.yml)与 host.js 在运行时的挂钩为准。
适用场景与注意¶
适合:已在 DSH Web 使用 Claw Agent、希望 SOUL / AGENTS 等文件版本化、且每轮稳定进入系统提示的开发者;与 registry、memory 插件组合搭建 Phase 1 人设治理。
注意:
- 插件以当前 dsh 进程权限 运行,安装前请自行查看 GitHub 源码与 MIT 许可证,确认符合你的安全与合规要求。
- SkillHub 目录页与 GitHub 仓库名称可能写作
dsh-claw-identity,安装与卸载命令以 README 中的dsh-agent-identity包名为准。 - 社区插件目录(SkillHub)为独立站点,与 DeepSeek / 幻方无官方从属关系;DSH 生态遵循「一切皆插件」,本件仅为其中一环。
结尾¶
dsh-claw-identity 解决的是 Claw 核心人设「写在哪、何时进模型」的问题:文件落在 DSclaw 目录,会话 cwd 匹配时自动进系统提示,Web 端可直接改核心 Tab。进一步的记忆与心跳需配合 dsh-agent-memory 等插件。