Skip to content

CCkitkit v0.3.1

Choose a tag to compare

@0Ra1n416 0Ra1n416 released this 08 Sep 14:59
· 8 commits to main since this release

cckit v0.3.1

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

v0.3.1 是一个小版本:为 Web 管理面板新增子路径部署能力,并修复 v0.3.0 的两个问题(kit-builder 未随包分发、安装弹窗残留状态)。


从 Release 产物安装

从 wheel(推荐,最快):

uv tool install ./cckit-0.3.1-py3-none-any.whl            # 纯命令行
uv tool install './cckit-0.3.1-py3-none-any.whl[web]'    # 带 Web 面板
uv tool install './cckit-0.3.1-py3-none-any.whl[alt]'    # 带非标准仓库导入(--alt)
uv tool install './cckit-0.3.1-py3-none-any.whl[web,alt]' # 面板 + 非标准仓库导入

从源码包(sdist):

uv tool install ./cckit-0.3.1.tar.gz            # 纯命令行
uv tool install './cckit-0.3.1.tar.gz[web]'    # 带 Web 面板
uv tool install './cckit-0.3.1.tar.gz[alt]'    # 带非标准仓库导入

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

--alt 需要额外的 claude-agent-sdk([alt] extra);未装该 extra 时 --alt 会提示安装命令并以明确错误结束,不影响其余命令。

新能力:Web 面板子路径部署(--base)

此前 Web 面板的前后端都把 /api/*、/assets/* 硬编码为绝对路径,用 <iframe> 嵌入宿主 dashboard 时,面板的请求会撞上 dashboard 自身的 /api,无法挂到子路径。

现在 cckit web 支持 --base 根路径前缀:

cckit web --host 0.0.0.0 --base /cckit
  • 后端把整站(/cckit/api/*、/cckit/assets/*)运行时挂到该前缀下,反向代理只需把 /cckit/* 原样转发;
  • 宿主页 <iframe src="http://<server>:<port>/cckit/"> 即可,不再与宿主 /api 冲突;
  • --base 是运行时配置:后端把 window.__CCKIT_BASE__ 注入 index.html、前端资源用相对路径(Vite base: "./"),无需重新构建前端;不传 --base 时行为与之前完全一致。

修复

  • kit-builder 未随包分发:修复 uv tool install 'cckit[web,alt]' 后,Web 面板勾选「允许导入非标准仓库」检测不到 skills/kit-builder、无法给出「安装」选项的问题。现在 skills/kit-builder 始终随 wheel 打包到 cckit/skills/kit-builder。
  • 安装弹窗残留状态:修复安装成功后关闭弹窗,再次点击「添加 Kit」仍显示上一次「安装成功」的问题;现在每次打开弹窗都会重置到初始表单。