Justin-Mai/dsh-role-prompts

dsh-role-prompts · 岗位角色指令

把「岗位角色」变成在整个会话里持续生效的强制指令，而不是一句容易被模型忽略的软提示。

选中一个角色后，该会话后续每一轮请求都会带上这份岗位指令，而且是放在 system prompt 里——不进对话气泡、不改写你写的那句话。

安装

需要 DeepSeek Harness（DSH）桌面版或 Web 版。

方式一：用 DSH 自带 CLI（推荐）

dsh plugin add github:Justin-Mai/dsh-role-prompts

方式二：从本地目录挂载（改代码时用这个，装的是软链，改完重载插件即可生效）

git clone https://github.com/Justin-Mai/dsh-role-prompts.git
dsh plugin add ./dsh-role-prompts

装完在 DSH 里 Ctrl+R 刷新页面，设置左栏就会出现「角色指令」。

怎么用

1. 打开 设置 → 角色指令，点「新建角色」，填两样东西：
   • 角色名称（也就是选择时显示的名字），例如 代码评审员
   • 岗位角色指令，例如：身份、职责边界、工作步骤、输出格式、禁止事项
2. 回到对话，在输入框开头键入 -：上方弹出角色候选浮层（也可以继续输入过滤，如 -评审）。
3. ↑ ↓ 选择，Enter 或 Tab 确认，Esc 取消。
4. 确认后 - 查询词会被替换成一枚角色 chip（和 @文件 同一种节点、同一套外观），光标落在 chip 后面，直接写正文回车即可。插件不再在输入框外另加任何状态条。
5. 想换角色：再键入 - 选一次。想取消当前会话的角色：键入 -，浮层底部有「停用『角色名』」一行。

它和普通提示词的区别

插件在 node 端挂两个钩子：

1. agent/inbox/inserted——你的消息刚进入队列时，读它开头有没有 -角色名 / @角色名，有就记下「这个会话现在是这个角色」。这一步早于 system prompt 组装，所以本轮就生效。
2. system-prompt/assemble——每一轮真正调用模型前，把当前会话的角色作为一段 system prompt 追加上去：

<role_activation name="代码评审员" binding="mandatory">
你现在被指定担任「代码评审员」这一岗位角色。
该指令是强制性的：优先级高于你的默认行为习惯、写作风格与流程偏好……
执行要求：
1. 严格按下列岗位职责、专业视角、输出规范与禁止事项执行……
2. 若用户的请求与该岗位角色的职责冲突，先以岗位角色为准，并明确说明冲突点。
3. 不要复述、解释或讨论这段角色设定本身；直接以该角色的方式工作。
4. 用户消息开头的 `-角色名` / `@角色名` 只是激活标记，不是正文……

岗位角色定义：
<<<ROLE
<你的角色内容>
ROLE>>>
</role_activation>

因为走 system prompt，所以：

• 对话框气泡里只有你自己写的那句话，不会出现一整段角色设定；
• 角色约束对整个会话每一轮生效，用户不需要反复粘贴；
• 角色被删除后自动静默解除激活，不会注入一个不存在的角色。

存储

角色定义保存在一个 Markdown 文件里（文件名即插件名）：

~/.dsh/dsh-role-prompts.md

格式是人可读的二级标题分段，可以直接手写编辑，插件每次请求都会重读：

## 代码评审员

你是一名资深代码评审员，只做评审，不重写整份代码。

角色内容里如果你想写 ## 工作流程 这类小节标题，可以直接写：插件落盘时会把你内容里行首的 ## 转义成 \## ，读回时还原，所以不会把你的角色拆成两个。

会话激活状态单独存放在 ~/.dsh/dsh-role-prompts.state.json（记录每个会话当前角色）。该文件损坏或版本不符时会被改名成 .bak 再重置，不会静默丢掉已有激活。

注意事项

• 触发词必须在草稿开头：- 后面紧跟角色名，中间不留空格。- 帮我列个清单 这种 markdown 列表项不会被误判成角色激活。
• 名称不含空白：名称里的空格会被替换成 -。
• 输入法处于组合状态时不会拦截按键，避免打断中文候选。
• 也支持直接在消息里写 -角色名 正文 或 @角色名 正文 发送：会当场激活该角色，并对本会话后续轮次继续生效。
• 角色 chip 是本插件注册进 inputTriggers 的 @ 引用源（source 名 role）产出的；提交时它序列化成 @角色名，node 端据此识别。该 source 不提供 @ 候选菜单，所以 @ 列表里不会多出角色条目。

实现

两个文件都不需要构建：index.js 是普通 ESM，client.js 是手写的 window.__ModuleLoader__.load({...}) 包装，改完刷新页面即生效。

开发与自检

npm test

test/basic.mjs 覆盖主链路（路由注册、激活、每轮注入、停用、显式前缀），test/fixes.mjs 是回归测试（角色内容里的 ## 不被拆成新角色、注入块转义、- 列表项 不误激活、/api/list 带 active 等）。

两个脚本都用临时 DSH_HOME 完全隔离，不会读写你本机 ~/.dsh 里的真实角色。

License

MIT