前言¶

DSH 的扩展模型是“一切皆插件”，社区目录里的插件很多，但分类、术语和指标不一定好读。dsh-plain-plugin-menu 是 4mForAI 发布的一个 DSH 社区插件，目标是把社区插件按中文大白话重新分类，并放进 DSH Web UI 左侧栏底部，供用户搜索、比较、安装、卸载和管理当前 profile 的插件依赖。

它不是 DeepSeek 或幻方官方应用商店，也不替换 DSH 官方侧边栏。它通过 DSH 的 sidebar.footer.action 注册一个“插件菜单”入口，让用户在 Web 端直接处理社区插件目录。

定位¶

• 名称：dsh-plain-plugin-menu
• 维护者：4mForAI
• 许可证：MIT
• 插件线索给出的分类：客户端
• 入口位置：DSH Web UI 左侧栏底部
• 工作方式：注册到 DSH 的 sidebar.footer.action，不替换官方侧边栏

它适合解决什么问题¶

如果你已经在用 DSH Web，但面对社区插件时经常遇到这些问题，这个插件会比较直接：

• 插件名称和英文介绍不好理解；
• 不知道某个插件属于哪一类；
• 想看 GitHub Star、最近维护时间、License 等公开指标；
• 想按名称、功能、作者、仓库或 topics 搜索；
• 想直接安装或卸载某个插件；
• 想查看当前 profile 里哪些插件正在运行、哪些要重启后才加载。

核心能力¶

下面是它已核实的主要能力：

• 用大白话重新分类社区插件，并把入口放到 Web UI 左侧栏底部。
• 在线读取 awesome-dsh-plugin 的可安装清单；当前离线快照含 824 条。
• 展示 GitHub Star、最近维护时间（pushed_at）、License、归档状态、Fork 和 Issue 数据。
• 按名称、功能、作者、仓库和 topics 搜索。
• 按 Star、最近维护、最近收录或名称排序。
• 调用当前 DSH 启动器的 dsh plugin --profile web add/remove 进行安装和卸载。
• 读取当前 profile 的真实依赖，并区分“正在运行”“重启后加载”和“普通依赖”。
• 网络失败时退回随包发布的目录和 GitHub 指标快照。
• 跟随 DSH 当前语言提供中英文。

安装与启用¶

先确认 Node.js 版本满足要求：Node.js 22.19+ 或 24+。

接着使用 DSH CLI 安装插件并启动 Web：

npx -y @deepseek-ai/dsh plugin --profile web add dsh-plain-plugin-menu
npx -y @deepseek-ai/dsh web

安装成功后，左侧栏底部会出现“插件菜单”。插件集合的变化需要重启 DSH 才能进入下一次 Web 启动清单；菜单会明确显示该状态。

配置¶

需要改变配置时，在 profile 自己的 cordis.patch.yml 中按同一 id 覆盖整行配置。DSH patch 会替换整个 config，不会深度合并，所以请重述全部字段。

可选环境变量 GITHUB_TOKEN 用于提高 GitHub API 额度。插件只把它放在对 GitHub 的 Authorization 请求头中，不会送到浏览器。

安全边界与限制¶

使用前需要明确它的运行边界：

• 安装插件是在 DSH 进程外调用 pnpm；第三方安装脚本和插件代码都不受 agent 沙箱保护。
• 安装和卸载会调用当前 DSH 启动器的 dsh plugin --profile web add/remove。
• 只安装社区可安装清单中、且能转换为普通 npm 包名或受限 github:owner/repo[#path:/subdir] 的来源。
• 不允许直接安装已归档仓库。
• Star、最近维护时间和 License 只是公开信号，不是安全审计或质量保证。
• DSH 官方目前仍是 developer preview，明确提示会有破坏兼容性的变化；DSH 升级后需要重新执行集成测试。

因此，在安装社区插件前，仍应自行检查源码、作者、发布历史和安装脚本。生产环境中，不要只依赖这个菜单里展示的公开指标做安全判断。

适用场景¶

比较适合以下情况：

• 想在 DSH Web 里用中文快速浏览社区插件；
• 想比较插件的 Star、最近维护、License、Fork 和 Issue 等公开信号；
• 想管理当前 web profile 的插件安装、卸载和依赖状态；
• 网络不稳定时，需要回退到随包发布的目录和 GitHub 指标快照。

不太适合以下情况：

• 希望把 Star、License 或最近维护时间当作安全审计结果；
• 希望自动安装不可信脚本而不检查源码；
• 希望这个目录被描述为 DeepSeek 或幻方官方应用商店。

链接¶

• GitHub 仓库：https://github.com/4mForAI/dsh-plain-plugin-menu
• 插件线索给出的目录页：https://www.skillhub.cn/plugins/4mForAI/dsh-plain-plugin-menu