前言¶

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 时刷新页面即可。

典型用法¶

1. 按上一节命令为 desktop profile 安装插件，必要时重启 dsh web。
2. 打开 DSH Web，进入 设置 → 全局人设。
3. 在编辑器中修改 Markdown 内容并保存；内容写入 $DSH_HOME/AGENTS.md（缺省 ~/.dsh/AGENTS.md）。
4. 新开会话或在新会话的下一次请求中验证 Agent 是否按新的人设响应；勿指望正在进行的会话中途切换人设。
5. 若保存时出现冲突提示，先「重新读取」再编辑，以同步 expectedVersion。

适用场景与注意¶

适合谁：需要在 DSH 里长期维护一份用户级 Agent 说明（风格、约束、常用上下文），且希望与图形化设置同一入口的开发者。

权限与安全：插件以当前 dsh 进程权限运行，安装前请自行查看 源码 与 MIT 许可证。读写接口虽限制为回环，仍等同于本机用户可改全局人设文件。

开发方式：README 注明本项目代码与文档部分由 AI 开发（主要在 Harness 内编码 Agent 生成与修改），人类作者负责需求、审阅与发布；AI 生成代码未经独立形式化验证，重要环境请自行审查后再部署。问题可通过 Issues 反馈。

结尾¶

dsh-global-persona 把用户级 AGENTS.md 收进 设置 → 全局人设，与 DSH 的指令注入链路一致，并带版本指纹与回环-only API，降低误覆盖与局域网暴露面。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。