dsh-workflow-plugins

DSH 的能力是全局的：装了什么插件，所有会话都一样。这个插件把选择权下放到单个会话—— 勾选即生效，取消即卸载，插件带来的工具、提示词和技能只在那个 agent 里存在。

_{深浅色自动跟随，因为没有一个写死的颜色}

🚀 安装

一行命令（把 web 换成你要装进的那个 profile 名）：

dsh plugin --profile web add git+https://github.com/kkaporn/dsh-workflow-plugins.git

装完重启一次应用——插件要重新加载才生效（之后改配置不用重启）。

https://github.com/kkaporn/dsh-workflow-plugins

⚙️ 配置

候选清单由包自带的 cordis.patch.yml 声明，装完就能用：

# cordis.patch.yml（随包分发）
- insert:
    - id: session-plugin-picker
      name: 'session-plugin-picker'
      config:
        candidates: ["dshmarket"]

想换成你自己的候选，就在你自己的 cordis.patch.yml 里按 id 覆盖它—— 注意是整个 config 被替换，不是合并，所以要把完整的 candidates 都写出来：

# <DSH_HOME>/profiles/<profile>/cordis.patch.yml
- id: session-plugin-picker
  config:
    candidates: ["dshmarket", "mattpocock-skills-dsh-zh"]

💡 一个包只有"不在 dsh.profile.bundles 里"时才值得放进 candidates： bundle 本来就会挂进每个会话，勾它等于什么都没做。

✨ 特点

🧠 两条刻意划下的边界

🔍 状态存在哪

🧪 检查

node lib/index.test.mjs               # 纯逻辑 23 项，不用真环境
node verify/client-contract.mjs       # 浏览器端契约 17 项（替身 React）

$env:DSH_NM = "<DSH 安装目录>\node_modules"
node verify/host-mount.mjs            # 真 Cordis 14 项：挂载 / 重挂 / 清理

$env:DSH_THEME = "<DSH 安装目录>\node_modules\@deepseek-ai\dsh-client-ui-theme\lib\client.js"
node verify/.preview.mjs              # 生成上面的预览图

环境变量故意没有默认值：猜一个路径只会在某一台机器上凑巧能用，然后表现成"挂载坏了"。

⚠️ 已知限制

• 已经全局挂载过的插件，再按会话挂一次没有意义——这个选择器是给"还不是全局能力"的东西用的。
• 挂一个会话预设里已经声明过的包可能失败；失败会按包名报在 failed 里，会话本身不受影响。
• 往单个 agent 作用域里挂任意第三方插件，这件事超出 DSH 的保证范围。白名单是让这个风险的边界明确且可控的东西。
• 一个自身不是单例的包，会在每个挂它的会话里多出一个实例。在 apply 里注册服务、定时器或 HTTP 路由的包不适合当候选——cordis.patch.yml 的注释里写明了为什么默认候选只有一个。
• /state 是本地 web 服务器上的普通 GET，没有按请求鉴权，所以任何能访问端口的页面都能读到哪些会话有选择。真正会改东西的 POST 需要 JSON 内容类型，跨站页面要发它就得过预检，而这个服务器不会放行。要收紧就是把端点按来源校验。

📁 文件

lib/index.js                    宿主端：状态文件、两个 HTTP 端点、挂载 / 卸载
lib/client.js                   浏览器端：输入框旁那个控件和它的面板
cordis.patch.yml                包自己声明怎么被挂进 profile
lib/index.test.mjs              纯逻辑自检
verify/client-contract.mjs      订阅 / 渲染契约（替身 React）
verify/host-mount.mjs           真 Cordis：挂载、重挂、清理
verify/.preview.mjs             用真主题变量渲染预览图

if ((mounted.get(agent.id) ?? []).length > 0) return;   // 只数个数，从不问死活

📄 License

MIT © the authors