DeepSeek Harness 插件介绍：dsh-agent-identity

前言¶

DeepSeek Harness (DSH) 采用“一切皆插件”的架构。在构建智能体时，如何将 ~/.dsh/DSclaw/ 目录下的人设文件准确地注入到系统提示中，是一个常见需求。dsh-agent-identity 插件提供了治理套件 Phase 1 的解决方案，它不拦截工具，而是专注于将核心文件注入提示词。

这是什么¶

该插件由开发者 xingyingyuzhui 维护，属于模型推理分类。它主要解决的问题是：将 ~/.dsh/DSclaw/<agent>/ 目录下的核心文件读取并塞入当前会话的系统提示中，从而让 Agent 拥有特定的人设或能力配置。

核心功能¶

插件通过文件机制管理 Agent 的身份与行为，具体规则如下：

注入文件：以下文件会被注入到系统提示中：
- SOUL.md
- IDENTITY.md
- AGENTS.md
- TOOLS.md
- BOOTSTRAP.md
BOOTSTRAP.md 的特殊处理：
- 新建 Session 时自动注入。
- 在初次问答（如“你叫什么”、“怎么称呼用户”）完成前即生效。
- 初次问答完成后，由 Agent 删除该文件。
仅存盘文件：以下文件仅存储在磁盘上，不会注入提示词：
- USER.md
- MEMORY.md
- HEARTBEAT.md
运行条件：
- 仅当 session 的当前工作目录（cwd）在 DSclaw 下时，才会触发人设注入。
依赖关系：
- 依赖 dsh-agent-registry 创建的 DSclaw 目录结构。

安装与启用¶

安装该插件需要通过 Web Profile 进行：

dsh plugin --profile web add github:xingyingyuzhui/dsh-agent-identity

安装完成后，请重启 dsh web 服务。

如果进行本地开发调试，可以使用本地路径链接：

dsh plugin --profile web add link:/abs/path/to/dsh-agent-identity

典型用法¶

安装并重启后，插件的默认行为如下：

文件编辑：在设置菜单中找到 “Claw Agent” → “核心” Tab，可以查看和编辑上述七个核心文件。
自动注入：新建 Session 时，系统会自动读取并注入 BOOTSTRAP.md 等文件。

注意事项与适用场景¶

依赖检查：使用前请确保已安装并正确配置了 dsh-agent-registry，否则 DSclaw 目录可能不存在。
文件持久化：卸载本插件后，磁盘上的人设文件（如 SOUL.md）依然保留，只是不再被注入到提示词中。
巡检机制：HEARTBEAT.md 的巡检功能默认关闭（every: 0），不会在空闲时触发。
权限：该插件作为 DSH 的插件运行，需遵守当前 DSH 进程的权限范围。

结尾¶

dsh-agent-identity 是一个轻量级的治理插件，它通过文件系统映射的方式，解决了人设文件与提示词注入的自动化问题。对于需要在 DSH 中管理多 Agent 场景下的身份一致性，该插件提供了基础的 Phase 1 支持。