release: 0.6.0-alpha.1

.codegraph/.gitignore

@@ -1,16 +1,5 @@
-# CodeGraph data files
-# These are local to each machine and should not be committed
-
-# Database
-*.db
-*.db-wal
-*.db-shm
-
-# Cache
-cache/
-
-# Logs
-*.log
-
-# Hook markers
-.dirty
+# CodeGraph data files — local to each machine, not for committing.
+# Ignore everything in .codegraph/ except this file itself, so transient
+# files (the database, daemon.pid, sockets, logs) never show up in git.
+*
+!.gitignore

AGENTS.md

@@ -70,14 +70,19 @@ npm --prefix apps/desktop run prepare:pragent    # 对齐嵌入式 pr-agent 运
 发版从 `dev` 汇入 `master` 后，在 `master` 打 `v*` tag 触发 [release.yml](.github/workflows/release.yml)（出 Windows / macOS 安装包 + GitHub Release）。**打 tag 前必须在同一批改动里完成三步前置，且随发版改动一并经 `dev` → `master`**——漏任一步 CI 不报错（仅 `::warning::`）但会产出错误的 Release：
 
 1. **版本号** —— 把 [apps/desktop/package.json](apps/desktop/package.json) 的 `version` 改成目标版本（去 `v` 前缀，预发布带后缀，如 `0.5.0-alpha.1`）。electron-builder 的 `artifactName: code-meeseeks-${version}-...` 直接取此值——不改则安装包文件名缺 `-alpha.N`、与 tag 不符。改完跑一次 `npm install` 同步 lockfile。
-2. **CHANGELOG** —— 把 [CHANGELOG.md](CHANGELOG.md) 的 `## [Unreleased]` 改名为 `## [<版本>] - <YYYY-MM-DD>`，在其上另起一个空的 `## [Unreleased]`，并在文件底部补 `[<版本>]: …/compare/…` 链接引用（仿现有行）。release.yml 按 `## [<版本>]` 字面抽段注入 Release 正文的「版本变更」区——缺这段则正文回退、无任何变更说明。
+2. **CHANGELOG** —— 把 [CHANGELOG.md](CHANGELOG.md) 的 `## [Unreleased]` 改名为 `## [<版本>] - <YYYY-MM-DD>`，在其上另起一个空的 `## [Unreleased]`，并在文件底部补 `[<版本>]: …/compare/…` 链接引用（仿现有行）。release.yml 按 `## [<版本>]` 字面抽段注入 Release 正文的「版本变更」区——缺这段则正文回退、无任何变更说明。**若本次是正式版（无 `-` 后缀）、且其内容来自此前的 alpha/预发布**：把被它取代的那些预发布版本段连同底部对应的 `[<x>-alpha.N]:` 链接引用一并**删除**（内容已并入正式版段，不再保留空壳 stub）；尚无对应正式版的预发布段保留。
 3. **校对** —— 确认 `## [<版本>]` 段已覆盖自上版本以来合入 `dev` 的全部要点（Added / Changed / Fixed）。
 
 tag 名与 package.json 版本必须一致（`v<版本>`）。预发布 tag（名含 `-`，如 `-alpha.N`）由 release.yml 自动标 prerelease 且不抢占 Latest。
 
+**CHANGELOG 撰写风格**（面向用户、求简）：① 版本引言 `>` 区的「本版重点」要点用**无序列表**排版，不堆成长句；② Added 按**功能场景**分类、用缩进的二级列表表达，每个小点一句话点到即止；③ 重构类任务**前后端合并**为一条总结、不展开实现细节；④ Fixed **不写「怎么修的」机制**，每条一句话只述修复的现象/影响；⑤ 通篇不写 IPC 通道名、函数名、文件路径、字段名等实现细节，优先突出新增特性与改良。外部贡献者的 PR 习惯性致谢（仿 `(#65，感谢 @user)`）。
+
 ## 约定
 
 - **TypeScript strict**；React 19 + electron-vite + Monaco。优先复用现有工具/类型，匹配周边代码风格与注释密度。
+- **包内异常用英语**：`packages/*`（内部库）里 `throw` 的错误信息一律用**英语**、**不做 i18n**（英语为默认/兜底语言，面向开发者排障）。**面向用户展示**的状态文案（如 Agent 的 terminationReason）才走 i18n 资源——二者区分清楚，别把用户文案塞进异常、也别给技术异常做翻译。
+- **后台日志用英语**：`logger.*` / `console.*` 的日志信息一律用**英语**（开发者排障向、不面向用户、不做 i18n）。结构化字段值（路径 / id 等）原样；仅信息文本用英语。
+- **面向用户的错误走错误码**：会跨 IPC 展示给用户的后端错误，统一封装 `AppError`（`code` + 可序列化 `meta`）、以错误码（`E`+两字母领域+四位数字，如 `EAG0001`）承载，本地化由**前端**按码做（i18n `errors.<CODE>`）；后端不拼面向用户的本地化字符串。技术异常 / 日志仍英语（与上两条不冲突——边界是「是否跨 IPC 展示给用户」）。规范见 [docs/arch/12-error-codes.md](docs/arch/12-error-codes.md)。
 - **IPC**：main 用 `ipcMain.handle(channel, ...)`，renderer/preload 用泛型 `invoke<K>(channel, req)`，全部由 `packages/shared/src/ipc.ts` 的 `IpcChannels` 类型映射约束。新增通道先在那里加类型。
 - **分支策略**：`master` 为发布分支，**禁止直接提交/修改**；所有特性与修复从 `dev` 拉分支开发，汇入 `dev` 验证后再合并到 `master`，发版在 `master` 打 `v*` tag 触发 release。
 - **提交信息**：约定式提交、**中文**，带 scope，例：`feat(desktop): …` / `fix(review): …` / `docs(readme): …` / `build(mac): …`。结尾带 `Co-Authored-By` trailer。