人设锚定 harmless0819-dev/dsh-persona-anchor

dsh-persona-anchor

把「人设」文本钉进 system prompt，且不吃 AGENTS.md 的指令预算。

- 插件类型：DSH host plugin（web profile），无客户端半边
- 依赖：仅 node 内置模块
- 状态：自用插件，已在本机跑通

为什么需要它

人设原本写在全局 ~/.dsh/AGENTS.md 里，由 @deepseek-ai/dsh-agent-instructions 注入。
那个插件给「全局 + 项目 AGENTS.md」总共 65536 字节（maxBytes），渲染规则是按最宽泛 → 最具体排序，先整份丢掉最宽泛的，放不下才截断最具体那份。

人设恰好在最宽泛那份里 ⇒ 项目文件一长大，人设就是第一个被牺牲的，而且不报错（只在注入块顶部留一行 Workspace instruction budget …）。

源码核对（dsh-agent-instructions/lib/index.js）：Config 只有 maxBytes / maxSourceBytes / 候选名之类，没有任何 pin / alwaysInclude / priority 能保住某个文件。

⇒ 结论：在 AGENTS.md 这条通道里没有「永不掉」的配置，必须换通道。

为什么不用 personaPrefix（最直觉，但会静默失效）

dsh-system-prompt 的 assemble() 里有这一句：

const sectionByName = this.layers.merge(scope, (layer) => layer.sections)

而 section() 的文档写着「A scoped section shadows a global section with the same name」。
本机默认 agent preset 是 standard，它自己就注册了 deployment:persona-prefix ⇒ 往跑着的会话上写 personaPrefix，会被那个 scoped section 整个盖掉，且不报错。

这正是本插件存在的理由：换一个没人会注册的 section 名。

做法

注册一个独有名字的 prompt section（默认 deployment:persona-anchor），内容从磁盘文件读。

- 名字独有 ⇒ 不可能被 preset shadow
- 通道是 systemPrompt.section() ⇒ 完全不经过 65536 预算

排序借用 getSectionOrder('DEPLOYMENT_PERSONA_PREFIX')（= 0），即「部署人设」该在的位置。

安装

dsh plugin --profile web add github:harmless0819-dev/dsh-persona-anchor

配置

- id: dsh-persona-anchor
name: dsh-persona-anchor
config:
file: 'C:/Users//.dsh/persona.md' # 必填，绝对路径 onError: log # log（默认）| throw

| 键 | 默认 | 说明 |
| file | 必填 | 人设文件绝对路径 |
| section | deployment:persona-anchor | section 名；改成别的独特名也行 |
| maxBytes | 524288 (512 KiB) | 单次读取上限，防手滑指到大文件 |
| onError | 'log' | 读文件失败时：log 只告警 / throw 硬失败 |
| order | 部署人设位 | section 排序 |
| reloadMs | 0 | >0 时定时重读 |
| route | true | 是否注册状态路由 |

验证它真的生效

改完 persona.md 后，新开一个会话，问它「你的名字/设定是什么」。
若人设没进来，插件会注册一个状态路由报告 state.error，可从那里看到失败原因（文件不存在 / 太大 / 空文件）。

注意

- inject 只列了 systemPrompt。webServer 是可选依赖，代码里用 ctx.inject([...]) 延迟注册 —— 写进顶层 inject 会让 headless profile（没有 webServer）整个加载失败。
- 读文件失败默认不抛，只在日志和状态里报告，避免一个人设文件打不开就把整个 profile 搞挂。

License

MIT