前言¶
DeepSeek Harness（DSH）里，用户级 AGENTS.md 会通过 @deepseek-ai/dsh-agent-instructions 在每次请求时注入系统提示，相当于跨会话的「全局人设」。若只能手改 ~/.dsh/AGENTS.md，路径不直观，也容易和 Web 里其它配置脱节。社区插件 dsh-global-persona（维护者 hunbujiu）在 设置 → 全局人设 提供查看与编辑界面，把改动落回同一文件。本文按仓库 README 说明定位、安装与行为边界；DSH 生态以「一切皆插件」为方向，SkillHub 目录页 为社区收录，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-global-persona 是 DSH 的客户端类插件：在 Web 设置的 settings.section 注册「全局人设」小节，读写用户级 AGENTS.md（路径为 $DSH_HOME/AGENTS.md，缺省为 ~/.dsh/AGENTS.md）。分类为客户端；仓库在 GitHub 上当前约 1 star。许可证为 MIT（见 package.json）。
它改的是哪个文件、何时生效¶
README 写明：@deepseek-ai/dsh-agent-instructions 会在每次请求时把上述 user-global 文件注入系统提示。保存后：
- 新会话的下一次请求会带上新内容；
- 已在运行的会话保持启动时的基线，不会中途更换人设。
核心功能¶
设置页¶
浏览器侧 client.js 向设置注册「全局人设」，提供查看与编辑界面；宿主侧 index.js 解析文件路径，并注册仅供本机访问的 HTTP 读写接口。文案由 locale/*.json 提供中英文；通过 cordis.patch.yml 将插件编入 profile。
HTTP 接口（仅回环）¶
GET /api/dsh-global-persona/document → { ok, value: { path, exists, content, version, bytes, updatedAt } }
POST /api/dsh-global-persona/document ← { content, expectedVersion? }
→ { ok, value } | { ok: false, error, conflict? }
要点（均来自 README）：
- 只接受回环请求（
127.0.0.1/::1/localhost），不把全局人设暴露给局域网。 expectedVersion为mtimeMs:size指纹；带上可做乐观并发校验，文件在别处被改过则返回conflict: true，界面提示先「重新读取」，避免多窗口互相覆盖。- 写入采用「临时文件 + rename」，避免半截内容落盘。
- 单次写入上限 1 MiB。
安装与启用¶
从 GitHub 安装（官方命令）：
dsh plugin add github:hunbujiu/dsh-global-persona --profile desktop
本地开发时可用 link: 指向工作副本（README 示例路径为 Windows，请换成你本机目录）：
dsh plugin add link:D:/20761/Documents/dshwork/dsh-global-persona --profile desktop
改完代码后：宿主半侧（如 index.js）需重启 dsh web；仅改 client.js 时刷新页面即可。
典型用法¶
- 按上一节命令为
desktopprofile 安装插件，必要时重启dsh web。 - 打开 DSH Web，进入 设置 → 全局人设。
- 在编辑器中修改 Markdown 内容并保存；内容写入
$DSH_HOME/AGENTS.md（缺省~/.dsh/AGENTS.md）。 - 新开会话或在新会话的下一次请求中验证 Agent 是否按新的人设响应；勿指望正在进行的会话中途切换人设。
- 若保存时出现冲突提示，先「重新读取」再编辑，以同步
expectedVersion。
适用场景与注意¶
适合谁：需要在 DSH 里长期维护一份用户级 Agent 说明（风格、约束、常用上下文），且希望与图形化设置同一入口的开发者。
权限与安全：插件以当前 dsh 进程权限运行，安装前请自行查看 源码 与 MIT 许可证。读写接口虽限制为回环，仍等同于本机用户可改全局人设文件。
开发方式：README 注明本项目代码与文档部分由 AI 开发（主要在 Harness 内编码 Agent 生成与修改），人类作者负责需求、审阅与发布；AI 生成代码未经独立形式化验证，重要环境请自行审查后再部署。问题可通过 Issues 反馈。
结尾¶
dsh-global-persona 把用户级 AGENTS.md 收进 设置 → 全局人设，与 DSH 的指令注入链路一致，并带版本指纹与回环-only API，降低误覆盖与局域网暴露面。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
