跳到主内容

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 install and pip install both 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 as dsh web composes 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

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则