dsh-plugin-kmanager

DeepSeek Harness 的插件管理器:一个可视化网格界面,在浏览器里管理官方插件与自制插件——查看、启用/禁用、拖拽排序、从 GitHub / ZIP / 本地文件夹安装、卸载。

个人用插件,公开供大伙试用。 功能与交互尽量贴近日常使用习惯,但未经大规模环境验证。使用前请阅读文末免责声明。

界面

功能

• 双页签:系统(harness 内置官方插件)与 自制(手动安装的插件)分开管理。
• 俄罗斯方块式网格布局:每个插件一个方块,方块颜色按分类区分(核心/界面/宿主/网关/模型/会话/执行/任务/交互/未分类)。
• 启用/禁用:点击任意方块切换运行状态;禁用方块变灰,底部保留一条分类色。
• 拖拽排序:拖住方块到目标位置,按鼠标位置实时插入;排序结果会持久化,重启后保持。
• 右上角排序:支持「按颜色」(按分类)与「按名称」两种临时排序。
• 安装插件,支持三种来源:
  • GitHub 项目地址(git clone,如 https://github.com/user/repo)
  • 本地文件夹路径(复制整个文件夹)
  • 本地 ZIP 路径(自动解压),也支持直接把 .zip 文件拖进页面
• 卸载:在「自制」页签下把方块拖入页面底部的垃圾桶即可。
• 操作反馈:安装/卸载均有进度条,ZIP 上传显示真实百分比。

安装方式

前置要求

• 一个可用的 DeepSeek Harness 环境(桌面端或 CLI)。
• Node.js、git、pnpm(后续构建需要用)。

一、作为源码开发的插件接入

# 1. 克隆本仓库到 harness 源码同级目录
#    例如 harness 在 D:/deepseek-harness,则将本仓库放在 D:/mypackages/dsh-plugin-kmanager
git clone https://github.com/Kitup666/dsh-plugin-kmanager-installer.git

# 2. 安装依赖并构建(本仓库打包了 dist)：
pnpm install
pnpm build:win        # Windows;Linux/macOS 用 pnpm build

# 3. 在 harness 的全局 patch 层 $DSH_HOME/cordis.patch.yml 挂载插件
- insert:
    - id: dsh-plugin-kmanager
      name: '@deepseek-ai/dsh-plugin-kmanager'
      config:
        repoRoot: 'D:\deepseek-harness'
        disabled: 'true'

# 4. 把构建产物/链接放进 harness 的共享依赖层
#    $DSH_HOME/profiles/node_modules/@deepseek-ai/dsh-plugin-kmanager
#    指向本仓库目录(Windows 下用 junction)

二、通过插件管理器自举安装

如果你已经有一个能用的 harness 插件环境,也可以直接用插件管理器自己装自己:

1. 打开插件管理器页面:浏览器访问 http://127.0.0.1:<端口>/kmanager。
2. 切到「自制」页签,点击空白块。
3. 选择「GitHub 项目地址」,填入 https://github.com/Kitup666/dsh-plugin-kmanager-installer,点添加。
4. 安装后它会自动挂载到共享依赖层,重启 harness 后出现在「自制」列表里。

无论是源码接入还是自举安装,安装第三方插件都意味着在你机器上执行该项目的代码,请确认其来源可信。

用法

1. 启动 harness 后,打开 http://127.0.0.1:<端口>/kmanager(端口号以 harness web 输出为准)。
2. 系统页签:查看/启停官方插件,拖拽调整顺序。
3. 自制页签:管理自己安装的插件;点击空白块安装新插件,拖动方块到垃圾桶卸载。
4. 插件的顺序、启停状态与分类会持久化到 $DSH_HOME/kmanager.layout.json。

已知限制:卸载/禁用与官方内置插件(hmm、include 等)相关的入口不可操作,避免破坏 harness 基础能力。

API

页面通过 /api/kmanager 的 JSON 接口驱动服务,其中最常用:

方法	路径	说明
GET	/api/kmanager/list	官方/自制插件列表与持久化布局
POST	/api/kmanager/set-enabled	启用/禁用单个插件
POST	/api/kmanager/add	gitUrl / zipPath / folderPath 三选一安装
POST	/api/kmanager/add-zip	上传 ZIP(JSON 字节数组,≤100MB)
POST	/api/kmanager/set-layout	持久化拖拽排序结果
POST	/api/kmanager/remove	卸载(仅自制插件)
POST	/api/kmanager/set-category	手动设置自制插件分类

响应统一为 { ok: true, data } 或 { ok: false, code, message }。

开发

pnpm typecheck    # 类型检查
pnpm test         # smoke 测试(layout 往返、坏文件降级等)
pnpm build:win    # 构建到 lib/

源码位于 dsh-plugin-kmanager/ 子目录,插件本体 src/ 下 page.ts(页面 UI)、service.ts(安装/卸载/挂载)、http.ts(路由)。

WPF 安装器(仓库附带工具)

仓库根目录还附带一个免依赖的 WPF 小工具(manager.vbs / manager.ps1 / ui.xaml),用于把插件安装到本地 harness,或卸载:

• 双击 manager.vbs 打开图形界面(跟随系统深浅色),选择 harness 源码目录后点「安装/卸载管理器」。
• 命令行:powershell -NoProfile -ExecutionPolicy Bypass -File manager.ps1 -Action install -Source D:\DeepseekH\deepseek-harness-master

免责声明

• 本插件为个人开源项目,按原样(AS IS)提供给社区试用,不提供任何形式的保证——包括但不限于适销性、特定用途适用性、不侵权与稳定性。
• 使用本插件安装、启用、禁用或卸载任何插件,操作均在你自己的机器上执行来源项目的代码。请仔细确认愿接受的第三方插件的来源与内容,并在操作前备份重要配置($DSH_HOME 下的 cordis.patch.yml、kmanager.layout.json 等)。
• 插件可能修改 harness 的配置、依赖与运行状态;异常操作可能导致 harness 无法正常启动。如遇问题,可删除 $DSH_HOME/kmanager.layout.json 或手动编辑 cordis.patch.yml 回滚。
• 本项目与任何 AI 厂商、框架组织无关联,不承担因使用本插件引发的数据丢失、故障或其他连带损失。

License

MIT