SunQingyuan0/Kabutack

Plugin插件 Native原生 ⭐ 3 BSD-3-Clause UI & Themes界面与主题Prompts & Skills提示词与技能

Kabutack 是一个面向 DSH 的插件,用于在一个界面里统一管理插件、Skill 和 MCP,并支持按“角色”一键动态装载、切换与恢复能力组合。

Project Overview项目介绍

Kabutack is a native role-based capability management plugin built exclusively for DeepSeek Harness (DSH). It unifies the management of three common DSH capability types: plugins, agent skills, and MCP servers, all in a single built-in settings page. To install it, you first need to have a working DSH installation with pnpm set up and a web profile configured, then run dsh plugin --profile web add @galactus/kabutack to pull the latest version from npm. After the installation finishes, you only need to restart your DSH instance to see the plugin in your settings menu.

This plugin is designed for DSH users who frequently switch between different work scenarios like software development, content writing, and academic research. The typical workflow is straightforward: you browse all your installed capabilities in the unified catalog, which sorts each capability type into separate tabs and supports full-text search to quickly find what you need. Next you create a custom role, assign the relevant set of capabilities to that role, and save the configuration. When you want to switch scenarios, just click activate on the role, and the plugin handles all capability changes automatically in the background.

All user role configurations and activation state are stored locally on your machine in the ~/.dsh/kabutack/ directory, so no external cloud services are required for any core functionality. The plugin automatically backs up corrupted data, uses atomic writes to prevent data loss, and logs all key operations to a local audit log for debugging. It blocks uninstallation of official DSH core plugins and itself to prevent accidental breaking changes to your DSH installation. The project is released under the permissive open-source BSD-3-Clause license, with pre-built files included for source installations.

Kabutack 是专为 DeepSeek Harness (DSH) 开发的原生插件,是基于角色概念的能力管理器,可统一管理 DSH 生态下的插件、Skill 与 MCP 三种不同类型的能力。它支持用户将不同能力按使用场景分组打包为「角色」,切换场景时可一键批量完成对应能力的启用、停用、装载与卸载操作,解决了 DSH 原生能力分散、场景切换繁琐的痛点问题。

该工具面向需要在不同工作场景间频繁切换的 DSH 用户,典型使用流程十分简洁:用户首先打开 DSH 设置页进入 Kabutack 面板,在能力目录中浏览所有可用的三类能力,随后点击创建角色,为角色命名并勾选需要装配的能力组合,保存后点击激活即可完成场景切换。切换过程自动处理能力的启停,无需用户手动重启 DSH,不会打断当前正在进行的工作流。

安装该插件需要用户预先安装好 DSH 和 pnpm,使用 web 类型的 profile,可通过官方 dsh 插件命令一键安装,也支持本地克隆后手动安装。所有配置和状态数据都保存在本地 ~/.dsh/kabutack/ 目录下,采用原子写入避免数据损坏,项目采用 BSD-3-Clause 开源协议,禁止卸载官方核心插件保障使用安全。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add @galactus/kabutack

把 SunQingyuan0/Kabutack 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

Kabutack

🎭 基于角色的 DSH 插件 / Skill / MCP 管理器 把能力按“角色”打包,一键切换你的 AI 工作台。

3 秒看懂 Kabutack:

  • 是什么:基于角色的 DSH 插件 / Skill / MCP 管理工具
  • 解决什么:把能力按“角色”组织,切换场景时一键批量启停
  • 怎么用:创建角色 → 装配能力 → 激活角色

Kabutack 是一个面向 DSH 的插件,解决 DSH 能力分散、难以按场景批量切换的问题。它把插件、Skill、MCP 放在同一个界面里管理,并允许你定义多个“角色”,每个角色装配不同的能力组合;切换角色时,DSH 会自动启用/停用/装载/卸载对应能力。


✨ 功能

  • 统一能力目录

    • 在一个页面中浏览 DSH 插件、Skill、MCP
    • 插件 / Skill / MCP 分页展示,支持搜索
    • 查看运行状态、启用状态、调用策略
  • 能力管理

    • 插件:启用、停用、卸载(受管外部插件)
    • Skill:启用、停用、卸载到回收站
    • MCP:添加、编辑、删除、启停
  • 角色化动态装载

    • 自定义角色,为角色装配插件 / Skill / MCP
    • 创建角色时默认勾选 DSH 原始自带插件和全部 Skill
    • 一键切换角色,自动执行差异装载/卸载
    • 失败自动回滚,重复激活幂等
  • 持久化与恢复

    • 角色与激活状态保存到 ~/.dsh/kabutack/roles.json
    • DSH 重启后自动恢复上次激活的角色
    • 原子写入,损坏自动备份
  • 安全与可观测

    • 禁止卸载 DSH 官方插件和 Kabutack 自身
    • 关键操作写入审计日志 ~/.dsh/kabutack/audit.log
    • 所有 API 仅本机回环访问

🚀 快速开始

需要已安装 DSH 和 pnpm,默认 profile 为 web。

# 官方安装(npm 已发布)
dsh plugin --profile web add @galactus/kabutack

# 本地/未发布安装(Windows 示例:E:/coding/Kabutack)
dsh plugin --profile web add /path/to/Kabutack

在仓库目录内可直接 dsh plugin --profile web add .。安装后重启 DSH 即可看到 Kabutack。

npm / bun

cd ~/.dsh/profiles/web
bun add @galactus/kabutack
# 或 npm install @galactus/kabutack

🎮 使用指南

  1. 打开 DSH 设置 → Kabutack
  2. 在 能力目录 中浏览插件 / Skill / MCP
  3. 在 角色 中点击 创建角色
  4. 在弹窗中命名角色、选择能力组合并保存
  5. 点击 激活 即可一键切换到该角色

🧩 为什么选择 Kabutack?

  • 一个界面管三类能力:不再需要在插件设置、Skill 文件、MCP 配置之间来回切换。
  • 角色即场景:开发、写作、研究等场景可以保存为角色,随时一键切换。
  • 无需重启:角色切换通过 DSH 运行时动态装载/卸载,不打断当前工作流。
  • 安全优先:官方插件和自身受保护,危险操作有确认和审计日志。
  • 本地优先:所有数据保存在本地 ~/.dsh/kabutack/,不依赖外部服务。
  • 开箱即用:仓库自带预构建 lib/,clone 后无需编译即可安装。

🤝 贡献

欢迎提交 Issue 和 Pull Request。


📄 License

BSD-3-Clause

← 上一个 Prev dsh-plugin-midscene 下一个 Next dsh-swarmdrop →