全局人设 hunbujiu/dsh-global-persona

dsh-global-persona

给 DeepSeek Harness 加一个「全局人设」设置页：在 设置 → 全局人设 里直接查看和修改用户级的 AGENTS.md（$DSH_HOME/AGENTS.md，缺省 ~/.dsh/AGENTS.md）。

作者：hunbujiu · 仓库：<https://github.com/hunbujiu/dsh-global-persona>

开发方式：本项目的代码与文档部分由 AI 开发，详见文末「开发方式」。

它改的是哪个文件

@deepseek-ai/dsh-agent-instructions 会在每次请求时把这个 user-global 文件注入到系统提示里，所以保存之后：

- 新会话的下一次请求立刻带上新内容；
- 已经在跑的会话保持它启动时的基线（不会中途换人设）。

组成

| 文件 | 作用 |
| index.js | 宿主半侧：解析文件路径，注册回环-only 的 HTTP 读写接口 |
| client.js | 浏览器半侧：向 settings.section 注册「全局人设」小节，渲染查看 / 编辑界面 |
| cordis.patch.yml | bundle patch：把插件插进 profile |
| locale/*.json | 中英文案 |

接口

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? }

- 只接受回环请求（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: 指向工作副本：

dsh plugin add link:D:/20761/Documents/dshwork/dsh-global-persona --profile desktop

改完代码后重启 dsh web 即可生效（宿主半侧改动需要重启；只改 client.js 时刷新页面即可）。

开发方式

本项目的代码与文档部分由 AI 开发。

- 主要由 AI 编程助手（DeepSeek Harness 内的编码 Agent）生成与修改，包括插件宿主半侧、浏览器半侧、bundle patch 与本文档。
- 人类作者负责提出需求、审阅结果与最终发布决策。
- AI 生成的代码未经独立的形式化验证；重要场景请自行审查后再部署。
- 若发现问题，欢迎提 issue 或 PR：<https://github.com/hunbujiu/dsh-global-persona/issues>