dsh-user-plugins
一个 DSH 插件（host + 浏览器双面），在 Web GUI 的 设置 → 插件 里增加一个
「我安装的插件」 标签页，列出你通过 dsh plugin --profile <name> add 装进各
profile 的插件：安装源（spec）、磁盘版本、贡献类型（插件包 / 前端 / 库）、以及该插件
在当前加载器里的实时状态。
中文 | English
安装：
dsh plugin --profile web add github:inxups/dsh-user-plugins
装完重启 dsh 让插件进入组合。若从源码运行，把 dsh 换成 pnpm dsh。
它和自带的「Plugin list」有什么区别
DSH 自带 ui-settings-plugin-inventory（设置 → 插件 → Plugin list）展示的是加载器
里所有条目：官方包和第三方包混在一起，且没有安装源、没有版本、不区分是哪个 profile。
两者互补：
| Plugin list（自带） | 我安装的插件（本插件） |
|---|
| 数据源 | 加载器条目（运行时） | profile 的 package.json 依赖 + bundle 列表（磁盘） |
| 范围 | 全部组成的插件，含官方包 | 只列你装进 profile 的包，@deepseek-ai/* 一律不显示 |
| 安装源 spec | 无 | 有（github: / link: / 版本范围） |
| 版本 | 无 | 有（读包的 manifest） |
| 归属 profile | 无 | 有，并标出当前运行中的那个 |
自带包在界面上不做开关、不折叠，直接过滤掉 —— 想看它们用隔壁的 Plugin list。
结构
dsh-user-plugins/
├── package.json # 声明 dsh.bundle（host 行）与 dsh.client（浏览器半边）
├── cordis.patch.yml # bundle 层：把 host 行插入 profile 的插件名单
├── lib/index.js # host 半边：扫描 profile 目录 + /dsh-user-plugins/api/list
├── lib/client.js # 浏览器半边（构建产物，随包分发）
├── src/client/ # 浏览器半边源码（React + TSX）
│ ├── index.ts # Cordis 注册：locale 命名空间 + 标签页
│ ├── UserPluginsTab.tsx # 面板本体 + selectUserPlugins 纯函数
│ └── locales.ts # zh / en 字典
├── scripts/build.mjs # 用 esbuild 产出 lib/client.js
└── tests/ # host、client、集成三层 node:test 用例
host 半边零运行时依赖（只用 node:fs / node:path）。浏览器半边只用平台模块
（react + @deepseek-ai/dsh-client-ui-primitives），不引入任何第三方 UI 库。
多语言
文案全部走本插件自己的 locale 命名空间 settings.userPlugins，提供中文与英文两套
字典，没有硬编码prose。切换 GUI 语言时标签标题和面板内容都会实时跟随：
ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'dsh-user-plugins: dictionaries')
const t = ctx.locale.bind(NS)
ctx.slots.register({
name: 'settings.plugins.tab',
id: 'user-installed',
label: () => t('tab'), // thunk：每次读取都重新求值 → 跟随当前语言
locale: NS, // 把框架合成的 t 座位放到组件 props 上
}, UserPluginsTab)
两个机制各自负责一半：
- 标签标题：
label 传 thunk 而非字符串 —— slot 层记录的是 SlotLabel = string | (() => string)，
每次读取都重新调用，所以不需要重注册就能跟随语言切换。
- 面板内容：注册时声明
locale: NS，框架把 t 注入组件 props；渲染器已把每个
outlet 订阅到 locale revision，因此切换语言会整片重渲染。
字典维护约定（locales.ts）：
zh 是键的唯一来源，写成 satisfies Record<string, string>。en 写成 satisfies Record<UserPluginsLocaleKey, string> —— 在带类型检查的消费方那里，
漏译会编译失败。- 本包的发布产物由 esbuild 直出、不经过类型检查，所以
tests/client.test.mjs 在运行时
再兜一层：断言 en 的键集与 zh 完全一致、无空翻译、且每个 {placeholder} 与中文源一致
（占位符漏写会渲染出原始 {count}）。
- 英文缺失时的兜底链由 locale 服务提供（en 是链尾）。
界面
标签页的控件全部来自平台自带的 UI 原子，因此和 GUI 其余部分共用同一套设计 token，
换主题、切深浅色都会自动跟随：
| 元素 | 来自 |
|---|
| 刷新按钮 | Button（variant="outline"、size="sm"）+ IconRefreshOutline16 |
| 搜索框 | Input + IconSearchOutline16 |
| 版本 / 类型标签 | Tag（neutral / info / outline / quiet 调色板） |
| 实时状态圆点 | StateDot（done / ongoing / error / idle，ongoing 自带跑马灯动画） |
刷新时按钮图标旋转并禁用按钮，标签文字保持不变（避免宽度跳动）；失败时保留上次结果并在
上方提示，不会把面板清空。
安装
dsh plugin --profile web add /绝对路径/dsh-user-plugins
dsh plugin 会在 profile 目录里转发给 pnpm，并把本包追加进 dsh.profile.bundles
（因为它声明了 dsh.bundle）。之后重启 dsh 让新插件进入组合。
若从源码运行，把上面的 dsh 换成 pnpm dsh。
为什么提交构建产物
lib/client.js 是构建产物，且刻意入库。
dsh plugin add <git-url> 时 pnpm 是克隆仓库，本包没有 prepare 脚本，消费者机器上不会
构建任何东西；而 package.json 的 main / exports 指向 lib/。不提交产物，装下来的就是个
用不了的包。
「改为安装时构建」可行但有实打实的代价，以下是针对 pnpm 11 的实测结论：
- pnpm 默认阻止 git 依赖执行构建脚本（
ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED）。
allowBuilds 白名单要求 包名@git URL#commit SHA 的完整形式，只写包名会被拒绝。于是
每个消费者都得手改自己 profile 的 pnpm-workspace.yaml，而且每推一个新 commit 就失效一次。
提交产物绕开了这一切。它唯一的风险是「产物与源码脱节」，由 CI 兜住：CI 重新构建，若 lib/
有差异就失败。本地跑同一条检查：
npm run verify:build
开发
npm install # 只装 esbuild（精确锁版本）
# 改完浏览器半边后重新构建
npm run build
# 三层测试（27 个用例：host 13 / client 12 / 端到端 2）
npm test
# 重建并检查产物是否与源码脱节（CI 跑的就是这条）
npm run verify:build
没有本地安装时，构建也会从 DSH 检出里找 esbuild —— 设 DSH_SOURCE 指向检出根目录，或
DSH_ESBUILD 指向具体的 esbuild 路径。
lib/client.js 必须按包名注册（window.__ModuleLoader__.load({ id: '<包名>' })），
否则客户端会报 loaded without registering。scripts/build.mjs 从 package.json
读取 name 作为 id，所以改包名不需要改构建脚本。
数据与接口
GET /dsh-user-plugins/api/list 返回只读快照：
{
"home": "/Users/you/.dsh",
"profiles": [{
"name": "web",
"dir": "/Users/you/.dsh/profiles/web",
"bundles": ["@deepseek-ai/dsh-base", "dsh-memory-evolve", "..."],
"active": true, // 与加载器条目匹配最多的 profile
"plugins": [{
"name": "dsh-memory-evolve",
"spec": "github:csyangwen/dsh-memory-evolve",
"shipped": false, // 是否官方 @deepseek-ai/* 包
"source": "profile", // profile 依赖 | installation（由 dsh 安装提供）
"version": "0.1.0",
"kind": "bundle", // bundle | client | plain
"client": true, // 是否带浏览器半边
"bundleEnabled": true, // 是否在 profile 的 bundle 列表里
"entryId": "dsh-memory-evolve",
"phase": "active", // pending|loading|active|failed|unloading|null
"enabled": true
}]
}]
}
只读：不提供任何启用/禁用/安装/卸载能力，与自带清单一致。接口仍然返回完整快照
（含自带包与 shipped 标志），过滤只发生在前端 —— 这样数据层保持诚实，界面规则
由 selectUserPlugins() 一处决定，并有单测覆盖。
已知限制
version / description 只对 profile 自己 node_modules 里的包可读；由 dsh 安装
提供的 @deepseek-ai/* 包不落 profile，因此这些字段为 null（source 标为
installation）。这是刻意的：官方包不是「你安装的」。- 当前运行中的 profile 靠「与加载器条目匹配数最多」推断，不是从启动参数读取。
- 数据按请求实时读取，没有变更订阅；面板上的「刷新」按钮重新拉取。
- 插件自身的
description（package.json 里那句）不在字典内 —— 它是包元数据，
由各插件作者自己决定语言，所以英文界面下也可能显示中文描述。
- 目前只有 zh / en 两套字典；跟随 GUI 已注册的语言，新增语言需要再加一份字典。
许可
MIT
