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/<you>/.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