6.7 KiB
description, kind
| description | kind |
|---|---|
| preset 挂载的可组装人设行，让单个 agent 拥有自己的系统提示词人设，供配置或排查它的用户与维护者阅读。 | package-reference |
@deepseek-ai/dsh-persona
English | 中文
概述
dsh-persona 让单个 agent（智能体）拥有自己的人设：preset 挂载这一可组装的行来注册 deployment:persona 系统提示词段落，为该会话遮蔽部署级人设。它还可以把人设变成该会话的完整系统提示词、抑制所有其他段落，并可为该会话关闭动态 runtime-context 快照。请把它挂在 preset 组装内部——全局挂载会与提示词注册表自身的人设注册相撞并明确报错。没有这一行，preset 能改变 agent 的工具，却永远改不了它的身份。
目录
使用本包
在 preset 组装内部挂载本行，让该 preset 的会话拥有自己的人设。本行需要 agent scope：在 scope 之外挂载会与提示词注册表自身的 deployment:persona 注册相撞并明确报错——部署级人设已经有归属，而本行存在的意义正是为某一个 agent 遮蔽它。
配置
- name: '@deepseek-ai/dsh-persona'
config:
text: You are a terse systems engineer who answers in short commands.
| 字段 | 默认值 | 含义 |
|---|---|---|
text |
必填 | 作为 deployment:persona 段落渲染的人设文本 |
complete |
false |
组装后将此人设恢复为唯一的系统提示词段落 |
includeRuntimeContext |
true |
是否为此 agent 作用域包含动态 runtime-context 快照；false 会抑制所有上下文贡献，但不禁用拥有它们的服务 |
生成的配置目录是每个受支持字段及其 JSDoc 的穷尽式真源。
人设行为
人设 text 是模板：完整的 {{…}} 组在提示词渲染时（而非组装时）严格解析为已注册的提示词变量。空文本同样占据该槽位——它会把部署级人设整个遮蔽掉，然后在渲染时消失。启用 complete: true 时，组装仍会解析上下文、工具、变量与协作式监听器，但提示词注册表会把这确切人设恢复为唯一段落；身份、工具引导或监听器都无法追加提示词文本。启用 includeRuntimeContext: false 时，此作用域的上下文提供方不会被求值，组装监听器添加的上下文也会被丢弃。
何时使用
当 preset 必须改变 agent 的身份、而不只是工具时，使用本行。部署级人设本身配置在 dsh-system-prompt 行上，不在这里；本行只用于为某一个 agent 遮蔽或替换它。
理解实现
实现细节——点击展开
本行如何注册
apply 在挂载上下文的 scope 内通过 ctx.systemPrompt.section({ name: PERSONA_SECTION, order: PERSONA_ORDER, text, complete? }) 注册一个提示词段落，因此该段落落在 order 0——紧随 harness 身份开场白之后——且只对加入该 preset 的 agent 生效。PERSONA_SECTION 与 PERSONA_ORDER 从 dsh-system-prompt 导入而非重述，因此 preset 人设总是遮蔽部署人设，而不是落在它旁边。includeRuntimeContext: false 会调用 ctx.systemPrompt.suppressRuntimeContext()。
本行为何仅限 scope 内使用
dsh-system-prompt 以自身配置持有全局人设并无条件注册 deployment:persona，因此一个进程只有一份。本行在 agent scope 之外与该项注册相撞，这是刻意的：本行的存在是因为 preset 无法自行挂载提示词注册表。
源码地图
| 文件 | 职责 |
|---|---|
src/index.ts |
插件入口：Config schema、人设段落注册、runtime-context 抑制 |
src/invariant.ts |
不变式伴生插件（无运行时不变式；身份、完整提示词执行与资源释放归提示词注册表） |
进一步探索
当包级约定不够用时阅读以下页面；它们从 preset 组装逐步进入本行所供给的提示词注册表。
- agent-presets 包——本行挂载进的 preset 组装。
- 系统提示词子系统——段落、组装，以及本行所遮蔽的人设槽位。
- 生成的配置目录——每个受支持配置字段及其源声明。
模型体验
人设段落
模型看到什么
位于 order 0 的 deployment:persona 段落，紧随 harness 身份开场白之后，携带本行配置的 text，其中的提示词变量已解析。对于其 preset 挂载了本行的 agent，它会替换部署所配置的任何人设。在完整模式下，模型只会看到这个渲染后的段落作为系统提示词。Runtime context 默认保持启用；禁用后，新建 agent 不会收到来自沙箱策略、批准策略、委派或其他 system-prompt 上下文提供方的 runtime-context 快照。
Token 影响
对给定 preset 而言是固定的：该 agent 的每次请求都携带人设自身的 token，其他 agent 一个都不带。空文本不贡献任何 token。完整模式会移除该 agent 的其他所有系统提示词 token。
KV Cache 影响
在一个 agent 的整个生命周期内保持前缀稳定——本行只挂载一次，发生在 agent 发布之前、因而也在它的首个请求之前，且在 agent 运行期间文本不再改变。两个使用不同 preset 的 agent 从该段落起建立各自不同的前缀，谁都无法让对方失去缓存复用。
已知限制与延期工作
这些限制说明本行何时不合适。它们是当前包约束，不是任务积压。
- 不支持全局挂载——提示词注册表拥有未加 scope 的人设槽位，因此本行只能从带 scope 的组装中使用。要改变部署级人设，应在
system-prompt行自身的配置中修改。 - runtime-context 抑制是全有或全无——
includeRuntimeContext: false会关闭该作用域的所有上下文贡献，包括沙箱策略、批准策略与委派；没有按提供方过滤的选项。
开发备注
维护者的工作上下文——点击展开
无。