Frontend Pilot — AI skill for Claude Code

Frontend Pilot

Frontend Pilot 是基于 React、Fastify、SQLite 和 Claude Agent SDK 的 AI 研发工作台，包含 GitLab Merge Request 审查、助手对话、GitLab/Jira 工作台、代码巡检和 Claude CLI 会话。

`prod` 是对外分享源码的专用分支，采用 MIT 许可证。此分支不包含公司部署流水线、私有镜像或内网连接配置，也不自动发布包、镜像或部署服务。GitHub 作为代码托管平台；当前业务集成仍面向 GitLab 和 Jira Server / Data Center。

本地运行

使用 Node.js 24（见 `.nvmrc`）。`node-pty` 可能需要 Python 3、make 和 C++ 编译器；macOS 可通过 Xcode Command Line Tools 提供编译工具，Linux 可安装发行版的构建工具包。交互式 CLI 另需安装 [Claude Code](https://code.claude.com/docs/en/setup)，或用 `CLAUDE_CLI_PATH` 指定已安装的程序。

nvm install
nvm use
npm ci
cp .env.example .env

编辑 `.env`，至少设置以下值。密码和令牌应分别使用独立的随机值，不能使用示例字符串：

FRONTEND_PILOT_LOGIN_USERNAME=your-user
FRONTEND_PILOT_LOGIN_PASSWORD=your-private-password
FRONTEND_PILOT_ADMIN_PASSWORD=your-separate-admin-password
REVIEW_SERVICE_TOKEN=your-random-service-token
AUTH_SESSION_SECRET=your-separate-random-session-secret

然后启动开发服务：

./dev.sh start
# 查看启动输出中的实际端口，默认页面 http://localhost:5173
./dev.sh stop

开发脚本支持 macOS/Linux，使用 `MR_REVIEW_WEB_PORT` 固定前端端口。普通账号使用上面的用户名；管理员账号固定为 `pilot-admin`，使用管理员密码。

`.env.example` 默认 `REVIEW_DRY_RUN=true`，可先检查登录和页面流程。执行真实审查前配置自己的 GitLab 地址、bot Token、模型 API Key 和模型名称，再设为 `false`：

GITLAB_BASE_URL=https://your-gitlab.example.com
GITLAB_API_BASE_URL=https://your-gitlab.example.com/api/v4
GITLAB_TOKEN=your-private-gitlab-token
ANTHROPIC_BASE_URL=https://api.anthropic.com
ANTHROPIC_API_KEY=your-private-api-key
ANTHROPIC_MODEL=your-supported-model
REVIEW_DRY_RUN=false

模型配置在首次启动时从环境初始化到 SQLite，之后由管理员在模型配置页维护。GitLab bot 连接由管理员维护，供后台审查使用；个人 GitLab 连接通过 OAuth 按产品用户隔离，需自行注册 OAuth 应用并设置 `GITLAB_OAUTH_CLIENT_ID`、`GITLAB_OAUTH_CLIENT_SECRET` 和匹配页面地址的回调 URI。

Jira 为可选集成，配置 `JIRA_BASE_URL`、`JIRA_API_BASE_URL`、`JIRA_PROJECT_KEY` 和服务端或个人凭据后启用。当前实现面向 Server / Data Center REST API v2；未宣称 Jira Cloud 兼容。自定义字段由 Jira 元数据发现，不预设某个公司的字段 ID。

构建和容器示例

本地构建后运行（先确保上述 `.env` 已配置）：

npm run build
WEB_ORIGIN=http://localhost:8080 npm start

打开 http://localhost:8