CCkitkit v0.2.1

cckitkit v0.2.1

Claude Code 的 Skill 工具箱管理器 —— 从任意 git 仓库拉取带环境依赖的 Skill，自动配置隔离环境，支持 skill 粒度的开关与干净卸载。

本次发布是 v0.1.x 之后的首个功能版本，带来两大能力：Web 管理面板与全局 skill 项目级覆盖。

---

从 Release 产物安装

从 wheel（推荐，最快）：

uv tool install ./cckit-0.2.1-py3-none-any.whl          # 纯命令行
uv tool install './cckit-0.2.1-py3-none-any.whl[web]'  # 带 Web 面板

从源码包（sdist）：

uv tool install ./cckit-0.2.1.tar.gz          # 纯命令行
uv tool install './cckit-0.2.1.tar.gz[web]'  # 带 Web 面板

前置要求：先安装 uv（Windows PowerShell 可 irm https://astral.sh/uv/install.ps1 | iex），uv 会自己拉取所需 Python 版本，无需预装。

Web 管理面板

新增可选的 Web 管理面板，一条命令即可启动：

uv tool install 'cckit[web]'
cckit web    # 打开 http://127.0.0.1:8000

• dashboard 布局：官方 Sidebar（可收起成图标条）+ 右侧内容区
• 作用域管理：全局 / 项目 / 手动「关注」的项目，支持添加、取消关注
• skill 列表：四态开关（installed / enabled / name-only / off），kit 可收起/展开/卸载
• 添加 Kit：填仓库地址或本地路径 → 展示安装计划（依赖 / postinstall / 系统依赖 / 来源+sha）等确认 → 实时日志
• 诊断：勾选 --fix 自动修复明确安全的项，逐项展示结果
• 清单预算：可视化进度条，侧栏收起时自动变成圆环进度条

前端产物随 wheel 打包，uv tool install 'cckit[web]' 后开箱即用，无需源码。后端默认只绑 127.0.0.1，部署时用 cckit web --host 0.0.0.0（详见安全说明）。

全局 skill 项目级覆盖

项目作用域下现在能看到所有全局 skill，并可「按项目单独覆盖」——跟随全局 / 仅名字 / 关闭，不影响全局状态。

• CLI：cckit list --project 明确显示「项目覆盖 已关闭」或「跟随全局 已启用」
• Web：全局 skill 单独折叠一组，覆盖选择器只展示当前全局状态下允许的选项（不复用四态）

修复

• 修复 v0.2.0 sdist（源码包）误打包前端依赖 node_modules 的问题， 因此 v0.2.0 版本号被完全弃用

技术栈

• 后端：Python 3.12+ / FastAPI + uvicorn（[web] 可选依赖，核心仍是 3 个运行时依赖）
• 前端：Vite + React 19 + TypeScript + Tailwind v4 + shadcn/ui