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 已安装并至少运行过一次
• 默认 profile：web（可通过参数指定）

一键安装（推荐）

方式一：从本地仓库安装

# Windows PowerShell
powershell -ExecutionPolicy Bypass -File install.ps1

# macOS / Linux / Git Bash
./install.sh

指定 profile：

powershell -ExecutionPolicy Bypass -File install.ps1 -Profile my-profile

./install.sh my-profile

安装完成后重启 DSH，在设置页即可看到 Kabutack。

方式二：远程一行命令（仓库发布到 GitHub 后）

powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/SunQingyuan0/Kabutack/main/bootstrap.ps1 | iex"

bash -c "$(curl -fsSL https://raw.githubusercontent.com/SunQingyuan0/Kabutack/main/bootstrap.sh)"

手动安装（可选）

如果你熟悉 DSH profile 结构，也可以手动完成：

1. 将 lib/、package.json 与 cordis.patch.yml 复制到 ~/.dsh/kabutack
2. 在 ~/.dsh/profiles/<profile>/node_modules/@dsh-external/ 下创建指向该目录的 junction/symlink
3. 在 profile 的 package.json 中：
   • dependencies 添加 "@dsh-external/kabutack": "link:<path>"
   • dsh.profile.bundles 添加 "@dsh-external/kabutack"
4. 重启 DSH

---

🎮 使用指南

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

---

🧩 为什么选择 Kabutack？

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

---

🛠 开发

本项目按 DSH 官方开发文档 的插件规范组织；本仓库内也维护了一份本地开发指南：docs/development.md。

# 推荐使用 pnpm（与 DSH 官方一致）；npm 同样可用
pnpm install

# 类型检查（自动使用 DSH checkout 的 tsc，检查 Host + Client）
pnpm run typecheck

# 构建 host + client
pnpm run build:all

# 单元测试
pnpm test

# 提交前检查
pnpm run check

# 完整本地门禁（check + 全量构建）
pnpm run check:all

说明：build-host.mjs / build-client.mjs / typecheck.mjs（或对应的 .sh 版本）会优先使用本地 node_modules/.bin/tsc，缺失时自动探测 DSH_CHECKOUT 或常见路径（如 ~/dsh-harness）。不需要先 npm install 也能在已有 DSH 开发环境中完成构建。

在 DSH 注入器环境中：

dev_build_plugin E:/coding/Kabutack
dev_inject_plugin E:/coding/Kabutack
dev_reload_package kabutack

---

📁 项目结构

Kabutack/
├── src/
│   ├── index.ts          # Host 插件入口（name/inject/apply/Config）
│   ├── types.ts          # 共享领域类型
│   ├── api.ts            # HTTP API（/kabutack/api）
│   ├── catalog.ts        # 插件/Skill/MCP 统一快照
│   ├── roles.ts          # 角色持久化
│   ├── apply.ts          # 角色激活/回滚引擎
│   ├── loader-ops.ts     # DSH Loader 操作
│   ├── mcp-ops.ts        # MCP 管理
│   ├── skills-ops.ts     # Skill 管理
│   ├── audit.ts          # 审计日志
│   └── client/           # 设置页 UI（settings.section）
├── lib/                  # 预构建产物（安装时直接使用，仓库内保留以便一键安装）
├── cordis.patch.yml      # DSH bundle 装配入口
├── scripts/
│   ├── build-host.mjs    # Host 构建（Node 跨平台，优先本地 tsc，回退 DSH checkout）
│   ├── build.sh          # Host 构建（Bash 备用版本）
│   ├── build-client.mjs  # Client 构建（DSH checkout tsc + ModuleLoader 外壳）
│   ├── typecheck.mjs     # 类型检查（DSH checkout tsc，跨平台）
│   └── typecheck.sh      # 类型检查（Bash 版本）
├── test/                 # 单元测试
├── docs/                 # 产品/设计/开发文档
├── tsconfig.json         # TypeScript solution root（引用 Host/Client aggregate）
├── tsconfig.base.json    # Host 侧共享编译选项
├── tsconfig.base.client.json # Client 侧浏览器编译选项
├── tsconfig.host.json    # Host aggregate
├── tsconfig.client.json  # Client aggregate
├── install.ps1           # Windows 一键安装
├── install.sh            # Unix 一键安装
├── bootstrap.ps1         # 远程安装引导（PowerShell）
├── bootstrap.sh          # 远程安装引导（Bash）
├── LICENSE               # BSD-3-Clause
└── package.json          # DSH bundle 插件元数据

---

📚 文档

• 开发指南（本地）
• 项目简报
• 产品需求
• 架构设计
• 数据模型
• API 规格
• 实施任务
• DSH 扩展点参考
• 测试与验收
• 开放问题

---

🤝 贡献

欢迎提交 Issue 和 Pull Request。

开发前请先阅读 docs/ 下的设计文档，并确保：

• pnpm run check 通过（typecheck + test）
• 涉及构建或 UI 时运行 pnpm run build:all

---

📄 License

BSD-3-Clause