docs: add commit message guidelines to CLAUDE.md
Add 'Commit 信息规范' section to Development Rules requiring: - Conventional commits format in title - Detailed per-file/per-feature change descriptions in body - Root cause explanation for bug fixes - Architectural decision rationale when applicable Also remove v0.11.0 changelog that was mistakenly added to CLAUDE.md (changelogs belong in commit messages and GitHub Releases, not here).
This commit is contained in:
7418 committed
1 parent
9c13f043d0
commit
8ee8085930
1 file changed
+7
-114
@@ -40,6 +40,13 @@ CodePilot — Claude Code 的桌面 GUI 客户端，基于 Electron + Next.js。
|
||||
- 涉及 Claude Code SDK 需确认 SDK 实际支持的功能和调用方式
|
||||
- 对不确定的技术点先做 POC 验证，不要直接在主代码中试错
|
||||
|
||||
**Commit 信息规范：**
|
||||
- 每次 commit 必须在 message body 中写清楚每个改动的具体内容和原因
|
||||
- 标题行使用 conventional commits 格式（feat/fix/refactor/chore 等）
|
||||
- body 中按文件或功能分组，说明：改了什么、为什么改、影响范围
|
||||
- 如果是修复 bug，说明根因是什么，不只是描述现象
|
||||
- 如果涉及架构决策（如选择方案 A 而非方案 B），简要说明理由
|
||||
|
||||
## Release Notes 规范
|
||||
|
||||
每次发布 GitHub Release 时，必须包含以下内容：
|
||||
@@ -91,117 +98,3 @@ CodePilot — Claude Code 的桌面 GUI 客户端，基于 Electron + Next.js。
|
||||
- 构建前清理 `rm -rf release/ .next/` 可避免旧产物污染
|
||||
- 构建 Windows 包后需要 `npm rebuild better-sqlite3` 恢复本地开发环境
|
||||
- macOS 交叉编译 Windows 需要 Wine（Apple Silicon 上可能不可用），可用 zip 替代 NSIS
|
||||
|
||||
## v0.11.0 Changelog
|
||||
|
||||
### 核心修复：SDK settingSources 配置
|
||||
|
||||
**问题**：CodePilot 通过 SDK 调用 Claude Code 时未设置 `settingSources`，导致 SDK 运行在隔离模式，不加载用户的 `~/.claude/settings.json` 和项目级 `.claude/settings.json`。这造成工具权限、超时配置、CLAUDE.md 项目记忆等全部缺失，是 WebFetch 超时、工具行为与 CLI 不一致等问题的根因。
|
||||
|
||||
**修复**：在 `queryOptions` 中添加 `settingSources: ['project', 'local']`（有 Provider 时）或 `['user', 'project', 'local']`（无 Provider 时）。有 Provider 时跳过 `user` 是因为 `~/.claude/settings.json` 中的 `env` 字段（如 `ANTHROPIC_BASE_URL`）会覆盖 CodePilot Provider 的配置。
|
||||
|
||||
**文件**：`src/lib/claude-client.ts`
|
||||
|
||||
### 核心修复：CLAUDECODE 嵌套会话检测
|
||||
|
||||
**问题**：当用户从 Claude Code CLI 内启动 CodePilot（开发模式或日常同时使用），子进程继承 `CLAUDECODE` 环境变量，SDK 检测到后拒绝启动，报错 "Claude Code cannot be launched inside another Claude Code session"。这是大量用户报告 "exited with code 1" 的重要原因之一。
|
||||
|
||||
**修复**：在构建 SDK env 时 `delete sdkEnv.CLAUDECODE`。
|
||||
|
||||
**文件**：`src/lib/claude-client.ts`
|
||||
|
||||
### 移除手动 MCP 配置读取
|
||||
|
||||
**原因**：之前 SDK 在隔离模式下不加载设置文件，所以 CodePilot 手动读取 `~/.claude.json` 和 `~/.claude/settings.json` 中的 `mcpServers`。现在 SDK 通过 `settingSources` 自动加载，手动读取会导致 MCP 服务器重复注册。
|
||||
|
||||
**修复**：移除手动读取逻辑，只传递 CodePilot UI 中显式配置的 MCP 服务器。
|
||||
|
||||
**文件**：`src/lib/claude-client.ts`
|
||||
|
||||
### 移除硬编码超时环境变量
|
||||
|
||||
**原因**：之前为解决工具超时问题，硬编码了 `API_TIMEOUT_MS=600000` 和 `CLAUDE_CODE_STREAM_CLOSE_TIMEOUT=600`。现在 SDK 从用户设置中正确加载这些配置，硬编码不再需要。
|
||||
|
||||
**文件**：`src/lib/claude-client.ts`
|
||||
|
||||
### 改善错误信息展示
|
||||
|
||||
**问题**：Claude Code 进程报错时只显示原始 error.message，用户无法判断原因。
|
||||
|
||||
**修复**：根据错误类型（ENOENT、exit code 1、ECONNREFUSED、401/403/429 等）提供具体的错误描述和排查建议，包含 Provider 名称。
|
||||
|
||||
**文件**：`src/lib/claude-client.ts`
|
||||
|
||||
### 切换项目时自动刷新右侧文件树
|
||||
|
||||
**问题**：用户在左侧切换到不同项目的聊天时，右侧 FileTree 没有自动刷新。
|
||||
|
||||
**修复**：在 `ChatSessionPage` 的 `loadSession` 中，`setWorkingDirectory` 后 dispatch `refresh-file-tree` 事件。
|
||||
|
||||
**文件**：`src/app/chat/[id]/page.tsx`
|
||||
|
||||
### 工具完成后实时刷新文件树
|
||||
|
||||
**问题**：AI 写入新文件后，文件树要等整个对话结束才刷新，且可能因缓存不显示新文件。
|
||||
|
||||
**修复**：在 `onToolResult` 回调中 dispatch `refresh-file-tree` 事件；fetch 请求添加 `_t=Date.now()` 防止缓存。
|
||||
|
||||
**文件**：`src/components/chat/ChatView.tsx`、`src/components/project/FileTree.tsx`
|
||||
|
||||
### 同项目新建聊天不再弹出目录选择
|
||||
|
||||
**问题**：在某个项目的聊天页面点新建，即使当前已有 workingDirectory，仍弹出 FolderPicker。
|
||||
|
||||
**修复**：`handleNewChat` 优先使用当前 `workingDirectory`（从 `usePanel` 获取），其次 localStorage，最后才弹 FolderPicker。
|
||||
|
||||
**文件**：`src/components/layout/ChatListPanel.tsx`
|
||||
|
||||
### 记住上次选择的模型
|
||||
|
||||
**问题**：每次新建聊天模型都重置为 sonnet。
|
||||
|
||||
**修复**：模型切换时保存到 `localStorage('codepilot:last-model')`；ChatView 初始化时从 localStorage 读取；新建 session 时传入 last-model。
|
||||
|
||||
**文件**：`src/components/chat/MessageInput.tsx`、`src/components/chat/ChatView.tsx`、`src/components/layout/ChatListPanel.tsx`
|
||||
|
||||
### 左侧项目文件夹默认收起
|
||||
|
||||
**问题**：左侧 ChatListPanel 的项目文件夹默认全部展开，项目多时很乱。
|
||||
|
||||
**修复**：首次使用时（通过 `codepilot:collapsed-initialized` 标记），自动折叠除最近活跃项目外的所有项目组。右侧 FileTree 的 `defaultExpanded` 改为空 Set。
|
||||
|
||||
**文件**：`src/components/layout/ChatListPanel.tsx`、`src/components/project/FileTree.tsx`
|
||||
|
||||
### 修复右侧文件树图标对齐
|
||||
|
||||
**问题**：文件名和图标无法垂直对齐。
|
||||
|
||||
**修复**：文件行的 spacer 从 `size-4` 改为 `size-5 shrink-0`，匹配文件夹 chevron 按钮的实际尺寸（size-4 icon + p-0.5 padding = 20px）。
|
||||
|
||||
**文件**：`src/components/ai-elements/file-tree.tsx`
|
||||
|
||||
### 动态模型列表 + Provider 切换通知
|
||||
|
||||
**问题**：模型列表写死为 sonnet/opus/haiku 三个选项，切换 Provider 后模型名称不更新。
|
||||
|
||||
**修复**：新增 `/api/providers/models` 端点，根据当前激活 Provider 返回对应模型列表；MessageInput 动态加载模型列表；ProviderManager 激活 Provider 后 dispatch `provider-changed` 事件触发刷新。
|
||||
|
||||
**文件**：`src/app/api/providers/models/route.ts`（新增）、`src/components/chat/MessageInput.tsx`、`src/components/settings/ProviderManager.tsx`
|
||||
|
||||
### 修复上下文按钮和文件类型匹配
|
||||
|
||||
**问题**：右侧文件树的 "+" 按钮在某些状态下不起作用；扩展名格式的文件类型（如 `.ts`）无法正确匹配。
|
||||
|
||||
**修复**：在 PromptInput 的文件类型匹配逻辑中添加对 `.` 开头扩展名模式的处理。
|
||||
|
||||
**文件**：`src/components/ai-elements/prompt-input.tsx`
|
||||
|
||||
### 工具超时时间调整
|
||||
|
||||
**修复**：默认 toolTimeout 从 120s 调整为 300s。
|
||||
|
||||
**文件**：`src/app/api/chat/route.ts`
|
||||
|
||||
### 待实现功能
|
||||
|
||||
- **Plan Mode 自动切换执行**：SDK 的 `Query` 接口支持 `setPermissionMode()`，可在 plan 完成后切换到 code mode 开始执行。需要新增前端→后端的通信通道（类似现有的 permission API），保存 `conversation` 引用，在 UI 上添加"开始执行"按钮。
|
||||
Reference in new issue
Block a user