kabutack

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