dsh-role-manager

Role Manager

DeepSeek Harness (dsh) plugin: manage named roles, each with a preset system prompt. The active role is injected into the system prompt (replacing it before the conversation starts, appending afterwards). Ships a host service plus a Web client UI.

Target profile

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add github:awol2005ex3/dsh-role-manager#cf17d7248d1be6d552a46a619fa3d6ca866439de

Compatibility and provenance

Role Manager is published as dsh-role-manager and currently resolves to version 1.0.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility: *
Runtime surfaces: web
Release source: github
Registry updated: 8/28/2026

Versions

1.0.0stable

8/28/2026

README

dsh-role-manager

DeepSeek Harness（dsh）角色管理插件。为每个"角色"预设一份初始系统提示词，在 Web 界面中切换当前角色，从而让模型以不同的身份 / 设定开始对话。

截图

功能

定义多个角色，每个角色包含：名称、描述（可选）、系统提示词（支持多行）。
在侧边栏（或浮动按钮）打开角色面板：新建、编辑、删除、切换当前角色。
切换角色时按规则注入系统提示词：
- 对话尚未开始（第一条用户消息之前）→ 替换整个系统提示词。
- 对话已进行 → 追加一段带标题的分节提示词。
角色与当前选中状态持久化在 ~/.dsh/roles.yaml（YAML，多行提示词靠块标量保留）。

安装

# 进入插件目录后，用 dsh 自带的插件管理将其链接进目标 profile
npx @deepseek-ai/dsh plugin --profile web add .

安装后重启 host（修改源码后同样需要重启 host 才能生效）。

构建

npm install
npm run build   # tsc 编译 lib/，再由 scripts/wrap-client.mjs 打包浏览器 bundle

配置（cordis.patch.yml 可覆盖）

字段	默认	说明
`storagePath`	`~/.dsh/roles.yaml`	角色存储文件路径
`defaultRole`	无	首次启动时默认激活的角色 id（可选）
`sectionOrder`	`1`	追加模式下分节在系统提示词中的排序
`replaceBeforeStart`	`true`	对话未开始时是否替换（而非追加）系统提示词

使用

打开 dsh Web 界面，左侧侧边栏底部会出现「🎭 角色」入口（若未检测到侧边栏插槽，则回退为左下角浮动按钮）。
点击打开面板 → 「新建角色」填写名称与提示词 → 「保存」。
「应用选中角色」将把该角色设为当前活动角色，并按上述规则注入系统提示词。
「清空角色」取消当前角色（不再注入额外提示词）。

架构

宿主端（src/index.ts）：注册一个实时 systemPrompt 分节，并通过 connection.rpc.handle('/rpc', ...) 暴露 role-manager/* 端点（list / get / create / update / delete / switch）。对话是否"已开始"由 agent/request 事件判定，据此决定注入是 complete（替换）还是追加分节。
存储（src/store.ts）：RoleStore 读写 ~/.dsh/roles.yaml，无依赖、纯同步，保证注入顺序可预测。
浏览器端（src/client.ts）：自包含 bundle（无外部 import），通过 ctx.connection.rpc.call('/rpc', 'role-manager/<endpoint>', { args }) 调用宿主，渲染角色面板，并把启动器挂入侧边栏 [data-slot="sidebar.footer.action"]。

已知约束

Web 端的 RPC 连接与侧边栏挂载需在真实浏览器中验证（开发环境无法运行浏览器）。若侧边栏插槽不可见，启动器会自动回退为浮动按钮，功能不受影响。
浏览器 bundle 采用独立 tsc + scripts/wrap-client.mjs 闭包工厂构建，不依赖 harness 的 React / tsdown 流水线，因此无法注册 React 形式的 slot 组件，侧边栏挂载通过稳定的 [data-slot] DOM 锚点实现。

License

Apache License 2.0

README

dsh-role-manager

DeepSeek Harness（dsh）角色管理插件。为每个"角色"预设一份初始系统提示词，在 Web 界面中切换当前角色，从而让模型以不同的身份 / 设定开始对话。

截图

功能

定义多个角色，每个角色包含：名称、描述（可选）、系统提示词（支持多行）。
在侧边栏（或浮动按钮）打开角色面板：新建、编辑、删除、切换当前角色。
切换角色时按规则注入系统提示词：
- 对话尚未开始（第一条用户消息之前）→ 替换整个系统提示词。
- 对话已进行 → 追加一段带标题的分节提示词。
角色与当前选中状态持久化在 ~/.dsh/roles.yaml（YAML，多行提示词靠块标量保留）。

安装

# 进入插件目录后，用 dsh 自带的插件管理将其链接进目标 profile
npx @deepseek-ai/dsh plugin --profile web add .

安装后重启 host（修改源码后同样需要重启 host 才能生效）。

构建

npm install
npm run build   # tsc 编译 lib/，再由 scripts/wrap-client.mjs 打包浏览器 bundle

配置（cordis.patch.yml 可覆盖）

字段	默认	说明
`storagePath`	`~/.dsh/roles.yaml`	角色存储文件路径
`defaultRole`	无	首次启动时默认激活的角色 id（可选）
`sectionOrder`	`1`	追加模式下分节在系统提示词中的排序
`replaceBeforeStart`	`true`	对话未开始时是否替换（而非追加）系统提示词

使用

打开 dsh Web 界面，左侧侧边栏底部会出现「🎭 角色」入口（若未检测到侧边栏插槽，则回退为左下角浮动按钮）。
点击打开面板 → 「新建角色」填写名称与提示词 → 「保存」。
「应用选中角色」将把该角色设为当前活动角色，并按上述规则注入系统提示词。
「清空角色」取消当前角色（不再注入额外提示词）。

架构

宿主端（src/index.ts）：注册一个实时 systemPrompt 分节，并通过 connection.rpc.handle('/rpc', ...) 暴露 role-manager/* 端点（list / get / create / update / delete / switch）。对话是否"已开始"由 agent/request 事件判定，据此决定注入是 complete（替换）还是追加分节。
存储（src/store.ts）：RoleStore 读写 ~/.dsh/roles.yaml，无依赖、纯同步，保证注入顺序可预测。
浏览器端（src/client.ts）：自包含 bundle（无外部 import），通过 ctx.connection.rpc.call('/rpc', 'role-manager/<endpoint>', { args }) 调用宿主，渲染角色面板，并把启动器挂入侧边栏 [data-slot="sidebar.footer.action"]。

已知约束

Web 端的 RPC 连接与侧边栏挂载需在真实浏览器中验证（开发环境无法运行浏览器）。若侧边栏插槽不可见，启动器会自动回退为浮动按钮，功能不受影响。
浏览器 bundle 采用独立 tsc + scripts/wrap-client.mjs 闭包工厂构建，不依赖 harness 的 React / tsdown 流水线，因此无法注册 React 形式的 slot 组件，侧边栏挂载通过稳定的 [data-slot] DOM 锚点实现。

License

Apache License 2.0