- Language
- TypeScript
- License
- Apache-2.0
- Branch
- dev
deepseek-harnessdshdsh-pluginweb-ui
Community plugin market card in DSH settings page: search and category filtering to browse contributor plugins, with one-click install and uninstall support after the plugin manager is installed.
$ dsh plugin --profile web add github:zhu1090093659/dsh-web-ui/packages/dsh-community-pluginsRun the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial
DSH 网页版设置页里的「社区插件」一级分区：用搜索框、分类胶囊与双列卡片网格展示社区贡献者维护的插件，每张卡片都能复制安装命令；装上插件管理器后还能在本机浏览器里直接安装与卸载条目。
scripts/community-index 编译进客户端 bundle。刚接触 DSH、希望在网页版设置页里直接浏览社区贡献的插件、对比分类、按需复制安装命令的用户。如果同时装了「插件管理器」插件，可以在不离开浏览器的情况下完成安装与卸载。本插件本身只索引不打包代码，适合用来发现与试用第三方贡献。
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| DSH | 未声明 | 本包 package.json 未声明 dsh engines；运行时通过 @deepseek-ai/* SDK 隐式锁定，依赖设置页暴露 settings.section 槽位（由 @deepseek-ai/dsh-client-ui-settings 提供） |
| Node | ^22.19 || >=24 | 据 packages/AGENTS.md:9；本包 package.json 未声明 engines |
| React | ^18.2.0 | peerDependencies 声明 |
| 平台 | 跨平台 | 浏览器半区为主，宿主 dsh web 跨平台运行即可 |
| 原生模块 | 无 | 全部走 cordis bundle + Web DOM API，无 native binding |
dsh plugin --profile web add github:zhu1090093659/dsh-web-ui/packages/dsh-community-plugins
| 配置 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| enabled | 布尔 | 卡片自己的启用开关，决定是否在设置页展开社区插件索引列表；关闭后只在该分区折叠成「已关闭」提示，不影响其他设置 | true |
Q: 这个插件是干什么用的？
A: 在 DSH 网页版设置页新增一个「社区插件」一级分区，用搜索框+分类胶囊+双列卡片网格的形式展示社区贡献者维护的插件，每张卡片带仓库跳转与一键复制安装命令按钮。
Q: 为什么要装「插件管理器」才能在界面里安装？
A: 界面内安装/卸载依赖插件管理器插件（@linxin666/dsh-client-ui-plugin-manager）暴露的 pluginManager 服务和本机（loopback）浏览器权限。远程浏览器只能看到只读索引与复制命令按钮。
Q: 已安装列表和「插件管理」标签页会同步吗？
A: 同步。本插件订阅 pluginManager.onChange，在卡片上点安装/卸载后立即刷新已安装快照；同一时间只允许一个变更操作，进行中其他卡片按钮会禁用。
Q: 点完「安装」为什么还没生效？
A: 卡片上会显示「已安装 · 重启后生效」徽标；必须重启 dsh web，被装插件的开关与配置才会出现在设置页的插件配置区。
Q: 怎么区分「npm 已发布」和「仓库安装」？
A: 看卡片上的徽标：写了 npm 字段的条目会显示「Published on npm / npm 已发布」，否则显示「Install from repo / 仓库安装」。
Q: 这个插件本身需要配置吗？
A: 默认无需配置。分区自带的「启用社区插件索引」开关是唯一的可配项（默认 true），关闭后只在该分区折叠索引列表，不影响其他设置。
Q: 可以贡献新的社区插件条目吗？
A: 可以。条目由维护者审核登记到 community.json，再由 scripts/community-index 重新生成 src/client/generated/community.ts 打进客户端 bundle。
Q: 装了社区插件卡后远程访问 DSH web 会有什么不同？
A: 远程浏览器自动降级为只读索引，每张卡片仍保留复制安装命令按钮；顶部多一行提示说明远程浏览器为什么不能界面内安装。
入门 — 安装一条命令即生效，默认配置即可使用；想新增社区条目只需维护 community.json 并跑 scripts/community-index 重新生成。
@deepseek-ai/dsh-client-ui-settings 存在时，卡片才会出现在 DSH 设置页；缺失时分区会随依赖一起静默卸载（README.md:42 / README.zh.md:42）。@linxin666/dsh-client-ui-plugin-manager）与本机浏览器；远程浏览器只能得到只读的复制命令索引（README.md:43-44）。dsh web 后才生效；卡片上的「已安装」徽标已注明（README.md:44-45）。scripts/community-index 才会出现在设置页（README.md:45 / src/client/generated/community.ts:1-7）。