dsh-plugin-manager

A plugin management system for DeepSeek Harness — manage plugins, MCP servers and skills through a Web GUI and agent tools. DeepSeek Harness 插件管理系统 —— 通过 Web 界面和 Agent 工具管理插件、MCP 服务器和技能。

✨ Features / 功能特性

🧩 Management UI (Web GUI) / 管理界面

Sidebar entry opens a full-screen Management System with three pages. 侧边栏入口打开全屏管理系统，包含三个页面。

🤖 Agent Tools / Agent 工具

The plugin also registers model-facing tools so the agent can manage the same resources from a conversation. 插件同时注册模型可见的工具，让 Agent 能在对话中管理同样的资源。

📦 Installation / 安装

# from npm registry (after publishing)
dsh plugin --profile web add dsh-plugin-manager

# or from a local checkout
dsh plugin --profile web add /path/to/dsh-plugin-manager

# or from GitHub
dsh plugin --profile web add github:YOUR_USERNAME/dsh-plugin-manager

Then restart the profile: 然后重启 profile：

dsh web   # restart the web profile

The 🧩 管理系统 entry appears at the bottom of the sidebar. 侧边栏底部会出现 🧩 管理系统 入口。

🔧 How it works / 工作原理

Browser (Client, pure DOM)                Host (Node)
┌─────────────────────┐                  ┌──────────────────────────┐
│ Sidebar 🧩 entry     │                  │ pluginManager service      │
│ Full-screen overlay  │── fetch ────────▶│  · list / setEnabled /     │
│  · Plugins page      │  JSON-RPC        │    install / uninstall     │
│  · MCP page          │  /plugin-manager │  · skillList / skillRemove │
│  · Skills page       │  /api/*          │  · mcpList / mcpAdd / …    │
│  · uploads (multipart)│── POST ────────▶│  · archive extract +       │
└─────────────────────┘                  │    frontmatter validation  │
                                          └──────────────────────────┘

Key design points / 关键设计

• Host service (ctx.pluginManager): reads the live Cordis Loader, mutates entries in memory (immediate effect) and persists changes to the profile cordis.patch.yml (survives restarts). It deliberately never serializes the composed loader tree back into cordis.yml.
• 宿主服务：读取实时 Cordis Loader，内存中修改 entry（立即生效）并持久化到 profile 的 cordis.patch.yml（重启保留）。刻意不把组合树写回 cordis.yml。
• HTTP API gateway: JSON-RPC-style endpoints under /plugin-manager/api/*, registered on the profile webserver (loopback only).
• HTTP API 网关：/plugin-manager/api/* 下的 JSON-RPC 端点，注册在 profile webserver（仅回环）。
• Client half: built with tsdown into the DSH window.ModuleLoader.load bundle format; the UI is pure DOM (no React in the overlay) to avoid shell render-boundary issues.
• 客户端：tsdown 构建为 DSH 的 ModuleLoader.load bundle 格式；UI 用纯 DOM（overlay 不经过 React）避免渲染边界问题。
• MCPB import: .dxt/.mcpb bundles are validated with the official @anthropic-ai/mcpb schema; server.mcp_config maps directly to the dsh-mcp-client config.
• MCPB 导入：用官方 @anthropic-ai/mcpb schema 校验；server.mcp_config 直接映射为 dsh-mcp-client 配置。
• Skill upload: archives extract into ~/.dsh/skills/ (the official user skill root; the filesystem provider watches it — no restart needed). Frontmatter is validated (name + description required) and rejected uploads are rolled back.
• 技能上传：解压到 ~/.dsh/skills/（官方用户技能根目录；文件系统提供者自动监听，无需重启）。校验 frontmatter（必须含 name + description），失败的自动回滚。

🛡️ Security / 安全

• Loopback-only API (same exposure as the DSH web GUI itself).
• API 仅回环（与 DSH Web GUI 本身同等的暴露面）。
• Zip-slip protection on archive extraction (validates all entry paths before writing).
• 解压时 zip-slip 防护（写入前校验所有条目路径）。
• Skill removal restricted to kebab-case names under ~/.dsh/skills/ (path-traversal safe).
• 技能删除仅限 ~/.dsh/skills/ 下的 kebab-case 名称（防路径穿越）。
• Upload size caps (50 MiB archives, 1 MiB JSON bodies) and multipart field limits.
• 上传大小限制（50 MiB 压缩包、1 MiB JSON）和 multipart 字段上限。

🧪 Tests / 测试

npm install
node scripts/smoke.mjs                # service layer
node scripts/smoke-api.mjs            # HTTP API gateway
node scripts/smoke-upload.mjs         # archive upload + extraction
node scripts/smoke-mcp-import.mjs     # MCP JSON / MCPB import
node scripts/smoke-skill-validate.mjs # skill frontmatter validation
node scripts/smoke-skill-remove.mjs   # skill removal security
node scripts/smoke-client-modules.mjs # client bundle discovery

🏗️ Development / 开发

npm install
node scripts/build-client.mjs   # rebuild lib/client.js after client/ changes

Recommended workflow: develop against a throwaway profile (dsh --profile dev --port 3081) before deploying to your main profile. 推荐工作流：先在临时 profile（dsh --profile dev --port 3081）开发验证，再部署到主 profile。

📄 License / 许可证

MIT