dsh-web-plugins 使用指南
为 webdsh 浏览器版 DSH 提供插件管理:注册 /plugin 命令并在「设置 → 插件」下增加「添加插件」「已安装」标签页——浏览器没终端,dsh plugin add 用不了。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
webdsh (dsh-web-plugins)
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add github:futrime/webdsh#path:packages/dsh-web-plugins
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- ⚡ Nothing to run. No server, no install, no local Node — the harness boots in the page.
- 🖥️ Real Node, real Python.
npm installandpip installboth work, and the terminal and the agent share one container. - 🧩 Real plugins. Install from npm, a tarball, GitHub, or a path — from the browser.
- 📦 Real dsh. The published
@deepseek-ai/*packages, unmodified: 114 of 129 rows compose exactly asdsh webcomposes them. - 🔒 Yours. Files, sessions and keys live in your browser's storage. Nothing is uploaded.
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
安装 / 启用 / 卸载后要立即生效吗?
不需要任何额外步骤,但页面要刷新一次。插件组合在启动时固定,「Add a plugin」和「Installed」标签页每次变更都会提示「Reload to apply — composition is fixed at boot」,点页面上的「Reload now」按钮或手动刷新即可。
启用按钮是灰的、点不动怎么办?
该包没有声明 cordis 组合层(cordis.patch.yml),属于纯依赖——src/client.tsx 的 Enable 按钮在这种情形下被永久 disabled,并显示 tooltip "This package adds no rows to the composition.",因为它没法给组合增加任何行。
可以从本地 .tgz 文件安装吗?
可以。Settings → 插件 → Add a plugin 标签页里有「From file…」按钮,accept=".tgz,.tar.gz,application/gzip,application/x-gzip";文件会先被 stage 到宿主虚拟文件系统,再走 install。
这个「Installed」标签页和「Plugin list」有什么关系?
「Installed」只列出你用本插件安装的插件。构建时随 webdsh 一同发布的插件是构建期 composition 层,不在「Installed」里出现,也没法在那里关掉,它们在「Plugin configuration」和「Plugin list」里。
/plugin 命令和设置页里的两个标签页是同一个东西吗?
是的。src/index.ts 注册 /plugin 命令,src/client.tsx 注册两个标签页——同一插件的两个面:命令行面给聊天 composer 用,UI 面给设置页用。
这个插件只能在浏览器里用吗?
是。packages/dsh-web-plugins/package.json 的 dsh.client.platform="web",platform 不匹配的 profile 不会加载 host 端也不会加载 client 端。
安装时报 "The plugin manager is not ready yet." 怎么办?
这是宿主还没把 PluginManager 注入到 setPluginManager() 时段报的,通常出现于启动早期。如果持续存在,说明你运行的 webdsh 构建没有装插件管理器,请检查 host 是否正常。
— 源: plugin_wiki.faq_json
兼容性
- DSH: 0.1.0-rc.7
- Node: >=22
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则