本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-plugin-hub

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @noob-stupid/dsh-plugin-console

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 核心优势
• 一键部署
• 使用方法
• 兼容性策略
• 项目结构

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件装到哪个 DSH profile 才能看到 GUI?

装到 DSH 自带的 web profile。DSH 的其他 profile 不会启动 Web GUI,本插件的客户端 bundle 只在 web profile 加载,装到别的位置只有后台路由没有界面。

面板上为什么有些插件标着"受保护"且开关是灰的?

那是宿主基础设施行(Cordis 加载器、HMR、WebServer、存储、设置链等 70+ 个核心模块)。停用会破坏热加载本身,所以面板禁止开关,这是保护机制不是 bug。

看到"等待授权"弹窗,要不要同意?

只有在配置源 / curl / git 三条确定性通道全部失败时才弹出,明确告诉你"将调用 DeepSeek API 模型,可能产生 API 费用"。可以点"取消",也可以勾选"以后不再提醒",或在市场页底部的 AI 兜底总开关里彻底关掉(关掉后零 API 费用)。

Gitee 源为什么输入关键词搜不到东西?

Gitee 官方搜索 API 已停用,所以 Gitee 源走"仓库直装模式":输入完整仓库路径(支持中文和完整 URL),面板按路径精确查找并安装,不是关键词搜索。

添加了一个自定义 registry 但安装失败,怎么办?

面板会在自定义源安装失败后,自动回退到内置源(npmmirror / npmjs)继续尝试;若都失败再走 curl 和 git 通道。也可以在软件源管理里编辑名称或设为主源;删除按钮被禁,避免误删插件安装依赖的源。

DSH 升级后为什么旧的自定义功能突然消失?

这是因为 DSH 框架文件被覆盖。本插件会检测到版本变化并自动重打"cordis.patch.yml 解析容错补丁"(issue #5),备份旧版本快照到 ~/.dsh/plugin-console/framework-backups/;若重启后仍异常,可手动跑仓库里的 scripts/apply-framework-patch.cjs。

装的技能在 DSH 里找不到?

技能被装到 ~/.dsh/skills/<名称>/,由 @deepseek-ai/dsh-skill-filesystem 插件扫描发现。若当前 profile 没启用该插件,技能会休眠——在 profile 的 cordis.yml 启用 dsh-skill-filesystem 并重启即可。

数据保存在哪里?卸载是否干净?

软件源配置: ~/.dsh/plugin-console-sources.json;框架升级快照: ~/.dsh/plugin-console/framework-backups/;已装技能: ~/.dsh/skills/<名称>/;安装时间标记: /node_modules//.dsh-installed-at。卸载本插件不会删除其他已装插件,但 ~/.dsh/plugin-console/ 目录下的状态文件可手动清理。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+(0.1.0 系列,运行中 web 包版本需匹配 /^0\.1\.0-/)
• Node: 未声明(随 DSH 上游)
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则