🛠 Jnpz · 技能配置（Skills & MCP）—— DeepSeek Harness 插件

一个 DeepSeek Harness (DSH) 的 Web 插件：

在设置页新增「技能配置」分类 —— MCP 服务器管理（JSON 粘贴、后台自动转换、热加载）+ 技能（Skill）管理（zip/.skill 上传智能解析、创建、编辑、启停）。

🏷️ DSH plugin · DeepSeek Harness 插件 · MCP 管理器 · MCP server manager · Skill manager · 技能管理 · AI Agent 工具 · Model Context Protocol · no-restart hot reload · 热加载

---

✨ 这是什么？

Jnpz（技能配置） 是 DeepSeek Harness Web 界面的一个纯插件（不修改 DSH 源码）。它把 MCP（Model Context Protocol）服务器和技能（Skill）的日常管理搬进了设置页：

• 在 设置 → 左侧导航「Agent 预设」下方新增 「技能配置」 分类；
• MCP 管理：粘贴 JSON 即可添加 MCP 服务器（支持 mcpServers 标准格式、单个对象、stdio/local/streamable-http/sse、command 数组写法、timeout），后台自动转换并立即连接——无需重启 DSH，即加即用；
• 技能管理：上传 zip / .skill / .md 自动识别 SKILL.md 的 YAML 元数据并回填表单，或手动创建；支持改名、编辑指令、启停、删除，写入 ~/.dsh/skills 后 DSH 自动发现、即时生效。

适合所有用 DSH + MCP 工具（IDA Pro、JADX、Yakit、x64dbg、Kali、AnythingLLM……）和自定义技能做 AI Agent 工作流的开发者。

📸 界面预览

技能配置主页（MCP 管理 + 技能管理）

上方「生效说明」卡片可折叠；MCP 列表每行有彩色图标、连接状态（✓ 已连接 / Ø 已禁用）、编辑 ✏️、启停开关、删除 🗑。

添加 MCP 服务器（JSON 粘贴，后台自动转换）

支持标准 { "mcpServers": {...} } 格式与单个服务器对象；示例覆盖 yakit（stdio）、x64dbg（local + command 数组 + timeout）、kali-mcp（HTTP url）。

创建技能（上传智能解析 + 表单）

拖拽/点击上传 zip 或 .skill（根目录含 SKILL.md），自动识别 YAML 中的技能名称与描述并回填「技能名称 / 描述 / 指令」三个必填项。

🎯 功能特性

模块	能力
MCP 管理	✅ 粘贴 JSON 一键添加（批量 mcpServers 或单个对象）
✅ 后台自动转换：stdio / local / streamable-http / sse，command 支持字符串或数组，timeout 自动映射
✅ 热加载：添加/删除/启停即时生效，无需重启
✅ 实时连接状态（✓/Ø/⏳），断开自动重试
✅ 行内编辑 ✏️（JSON 预填）、删除 🗑（自定义确认弹窗）
✅ 读取 cordis.patch.yml 中的 MCP 并支持运行时启停
技能管理	✅ 上传 zip / .skill / .md 自动解析 SKILL.md（YAML frontmatter）
✅ 手动创建：技能名称 / 描述 / 指令（Markdown）
✅ 编辑：改名（自动规范化）、改描述、改指令
✅ 启停开关（disable-model-invocation / user-invocable）
✅ 删除（自定义确认弹窗）
✅ 写入 ~/.dsh/skills//SKILL.md，DSH 自动发现
体验	✅ 深色/浅色主题自适应
✅ 中英双语界面
✅ 「生效说明」可折叠提示卡
✅ 全部操作走插件自有 HTTP 接口，纯插件实现、可完全卸载

🚀 快速开始

环境要求：DeepSeek Harness（DSH）Web profile（~/.dsh/profiles/web）、Node.js、pnpm。

### 技能配置主页（MCP 管理 + 技能管理）

![技能配置界面](https://raw.githubusercontent.com/pazz11/Jnpz/69419286e0435e94e301d29f4d771f0ea63a4695/assets/screenshots/skills-config.png)

> 上方「生效说明」卡片可折叠；MCP 列表每行有彩色图标、连接状态（✓ 已连接 / Ø 已禁用）、编辑 ✏️、启停开关、删除 🗑。

## 🧩 使用说明

### MCP 配置：支持三种 JSON 写法

```jsonc
// ① 标准 mcpServers 批量格式（推荐）
{
  "mcpServers": {
    "yakit": { "command": "yak", "args": ["bridge", "--proc", "4"], "env": {} },
    "kali-mcp": { "url": "http://10.0.0.104:5000/mcp", "headers": {} }
  }
}

// ② 单个服务器对象（自动识别 stdio / HTTP）
{ "serverName": "jadx", "command": "uv", "args": ["run", "jadx_mcp_server.py"] }
{ "type": "sse", "serverName": "remote", "url": "http://host/mcp" }

// ③ local 类型 + command 数组 + timeout（x64dbg 等客户端格式）
{ "x64dbg": { "type": "local", "command": ["node", "D:\\server\\index.js"], "timeout": 30000 } }

• type 支持 stdio / local / streamable-http / sse（transport 键同理）；
• command 支持字符串或数组（数组首元素为可执行文件，其余自动并入参数）；
• timeout 自动映射为工具调用超时；
• 确认后后台自动转换为 dsh-mcp-client 实例，立即连接、状态实时可见。

技能（Skill）

• 上传智能解析：zip / .skill / .md，根目录（或一级子目录）含 SKILL.md，自动读取 YAML frontmatter 的 name / description 并回填表单；
• 手动创建：技能名称（自动规范化为小写连字符，如 codemap）、描述、指令（Markdown）；
• 编辑：行内 ✏️ 打开编辑弹窗，可改名 / 改描述 / 改指令；
• 启停：关闭后写入 disable-model-invocation: true + user-invocable: false，DSH 不再调用该技能；再次打开即恢复。

MCP 配置：支持三种 JSON 写法

// ① 标准 mcpServers 批量格式（推荐）
{
  "mcpServers": {
    "yakit": { "command": "yak", "args": ["bridge", "--proc", "4"], "env": {} },
    "kali-mcp": { "url": "http://10.0.0.104:5000/mcp", "headers": {} }
  }
}

// ② 单个服务器对象（自动识别 stdio / HTTP）
{ "serverName": "jadx", "command": "uv", "args": ["run", "jadx_mcp_server.py"] }
{ "type": "sse", "serverName": "remote", "url": "http://host/mcp" }

// ③ local 类型 + command 数组 + timeout（x64dbg 等客户端格式）
{ "x64dbg": { "type": "local", "command": ["node", "D:\\server\\index.js"], "timeout": 30000 } }

• type 支持 stdio / local / streamable-http / sse（transport 键同理）；
• command 支持字符串或数组（数组首元素为可执行文件，其余自动并入参数）；
• timeout 自动映射为工具调用超时；
• 确认后后台自动转换为 dsh-mcp-client 实例，立即连接、状态实时可见。