OpenCodePanel

CodeWhale Custom — 前端开发定制层

基于 CodeWhale 的深度定制配置，专注 Web 前端开发 场景。

设计原则

- 零侵入：所有定制放在 CodeWhale 的扩展目录中，不修改核心代码
- 持续更新：CodeWhale 本体通过 cargo install 升级，定制层不受影响
- 符号链接：一键部署，修改即生效，无需每次复制
- 一键启停：make start / make stop 管理所有服务

目录结构

安装 CodeWhale
⚠️ 二选一：不要同时用 npm 和 Cargo 安装，两个版本会装到不同目录，PATH 靠前的覆盖靠后的。
如果装混了，运行 which -a codewhale 查看，用 npm uninstall -g codewhale 或 cargo uninstall codewhale-cli 清理多余版本。

方案 A：npm（推荐，大部分系统适用）
要求：GLIBC ≥ 2.39（Ubuntu 24.04+、macOS、Arch 等）。npm 包只是一个下载器，拉取 GitHub Releases 上的预编译二进制。

方案 B：Cargo（源码编译，兼容老系统）

适用于 Ubuntu 20.04 / Debian 10 / CentOS 7 等 GLIBC 较旧的系统。
⚠️ 两个 crate 都必须安装，缺一不可：

CLI 本身不包含 AI 逻辑，serve / run / exec 等命令内部都通过 codewhale-tui 执行。

验证

快速开始

1. 部署定制层

这会创建符号链接：
- skills/* → ~/.codewhale/skills/
- mcp/mcp.json → ~/.codewhale/mcp.json
- memory/*.md → ~/.codewhale/memory.d/*

2. 安装 Web Workbench 依赖

3. 一键启动

自动完成：
1. 后台启动 codewhale serve --http（端口 7878）
2. 后台启动 Vite dev server（端口 3000）
3. Ctrl+C 自动清理所有进程

也可以独立启停：

自定义配置：

Web 工作台

浏览器打开 http://localhost:3000（局域网内其他设备用 http://:3000）。

首次使用在 Settings 页面配置：
- API URL: http://localhost:7878
- Auth Token: dev-token（与启动命令一致）
- 点击 Test Connection 验证连通性

功能

技术栈

React 18 · TypeScript 5 · Vite 6 · Tailwind CSS 3 · React Router 6 · Zustand 5

在 TUI 中使用 Skill

所有命令

自定义 Skill 格式

每个 Skill 是一个 Markdown 文件，使用 frontmatter 声明元数据：

参考已有 Skill 文件了解完整格式。

添加新 Skill

1. 在 skills/ 下创建 xxx.md
2. 写 frontmatter + body
3. make install（或手动 ln -sf $PWD/skills/xxx.md ~/.codewhale/skills/）
4. 在 CodeWhale 中用 $xxx 调用

更新

卸载

许可

MIT