docs: 更新 README，新增 Run.ps1/TODO.md，删除 V6.md

- README.md: 大幅重写，更详细版本历史和配置示例 - Run.ps1: 新增 Windows 启动脚本 - TODO.md: 新增包完成清单 - V6.md: 删除（架构重构规划已不适用） Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-06-15 12:55:51 +00:00 · 2026-04-04 21:59:46 +08:00
parent 0e541af24b
commit 32804623e0
5 changed files with 131 additions and 1349 deletions
--- a/README.md
+++ b/README.md
@@ -16,28 +16,48 @@

 [Discord 群组](https://discord.gg/qZU6zS7Q)

- [x] V4 — 测试补全、[Buddy](https://ccb.agent-aura.top/docs/features/buddy)、[Auto Mode](https://ccb.agent-aura.top/docs/safety/auto-mode)、环境变量 Feature 开关
- [x] V5 — [Sentry](https://ccb.agent-aura.top/docs/internals/sentry-setup) / [GrowthBook](https://ccb.agent-aura.top/docs/internals/growthbook-adapter) 企业监控、[自定义 Login](https://ccb.agent-aura.top/docs/features/custom-platform-login)、[OpenAI 兼容](https://ccb.agent-aura.top/docs/plans/openai-compatibility)、[Web Search](https://ccb.agent-aura.top/docs/features/web-browser-tool)、[Computer Use](https://ccb.agent-aura.top/docs/features/computer-use) / [Chrome Use](https://ccb.agent-aura.top/docs/features/claude-in-chrome-mcp)、[Voice Mode](https://ccb.agent-aura.top/docs/features/voice-mode)、[Bridge Mode](https://ccb.agent-aura.top/docs/features/bridge-mode)、[/dream 记忆整理](https://ccb.agent-aura.top/docs/features/auto-dream)
- [ ] V6 — 大规模重构石山代码，全面模块分包（全新分支，main 封存为历史版本）
+赞助商占位符

+- [x] v1 会完成跑通及基本的类型检查通过;
+- [x] V2 会完整实现工程化配套设施;
+  - [ ] Biome 格式化可能不会先实施, 避免代码冲突
+  - [x] 构建流水线完成, 产物 Node/Bun 都可以运行
+- [x] V3 会写大量文档, 完善文档站点
+- [x] V4 会完成大量的测试文件, 以提高稳定性
+  - [x] Buddy 小宠物回来啦 [文档](https://ccb.agent-aura.top/docs/features/buddy)
+  - [x] Auto Mode 回归 [文档](https://ccb.agent-aura.top/docs/safety/auto-mode)
+  - [x] 所有 Feature 现在可以通过环境变量配置, 而不是垃圾的 bun --feature
+- [x] V5 支持企业级的监控上报功能, 补全缺失的工具, 解除限制
+  - [x] 移除牢 A 的反蒸馏代码!!!
+  - [x] 补全 web search 能力(用的 Bing 搜索)!!! [文档](https://ccb.agent-aura.top/docs/features/web-browser-tool)
+  - [x] 支持 Debug [文档](https://ccb.agent-aura.top/docs/features/debug-mode)
+  - [x] 关闭自动更新;
+  - [x] 添加自定义 sentry 错误上报支持 [文档](https://ccb.agent-aura.top/docs/internals/sentry-setup)
+  - [x] 添加自定义 GrowthBook 支持 (GB 也是开源的, 现在你可以配置一个自定义的遥控平台) [文档](https://ccb.agent-aura.top/docs/internals/growthbook-adapter)
+  - [x] 自定义 login 模式, 大家可以用这个配置 Claude 的模型! [文档](https://ccb.agent-aura.top/docs/features/custom-platform-login)
+  - [x] Remote Control / Bridge Mode 支持 [文档](https://ccb.agent-aura.top/docs/features/bridge-mode)
+  - [x] 修复搜索工具的 rg 缺失问题(需要重新 bun i)
+  - [x] OpenAI 接口兼容! /login 然后配置 OpenAI 平台即可! [文档](https://ccb.agent-aura.top/docs/plans/openai-compatibility)
+  - [x] Any Use
+    - [x] 由于 Chrome Use 和 Computer Use 原本都是未完全验证的能力, 还是比较建议大家用社区里面的 MCP 支持
+    - [x] Chrome use 支持 (浏览器插件要订阅权限 ) 感谢 @amDosion [文档](https://ccb.agent-aura.top/docs/features/claude-in-chrome-mcp)
+    - [x] 普通用户可以使用 [chrome-devtools-mcp](https://github.com/ChromeDevTools/chrome-devtools-mcp/) 替代, 比较不那么折腾
+    - [x] Computer use 支持 感谢 @amDosion [文档](https://ccb.agent-aura.top/docs/features/computer-use)
+    - [x] Mac 上可以用这个项目 [computer-use-mcp](https://github.com/domdomegg/computer-use-mcp)
+        - 注意这个库的命名方式与官方冲突了, 需要改为 `claude mcp add --scope user --transport stdio computer-use-mcp -- npx -y computer-use-mcp`
+  - [x] /voice 支持 @amDosion [文档](https://ccb.agent-aura.top/docs/features/voice-mode)
+  - [x] /dream 记忆整理命令（手动 + 自动后台触发） [文档](https://ccb.agent-aura.top/docs/features/auto-dream)
+- [ ] V6 大规模重构石山代码, 全面模块分包
+  - [ ] V6 将会为全新分支, 届时 main 分支将会封存为历史版本

-## 快速开始(安装版)
+> 我不知道这个项目还会存在多久, Star + Fork + git clone + .zip 包最稳健; 说白了就是扛旗项目, 看看能走多远
+>
+> 这个项目更新很快, 后台有 Opus 持续优化, 几乎几个小时就有新变化;
+>
+> Claude 已经烧了 1000$ 以上, 没钱了, 换成 GLM 继续玩; @zai-org GLM 5.1 非常可以;
+>

-不用克隆仓库, 从 NPM 下载后, 直接使用
-
-```sh
-bun  i -g claude-code-best
-bun pm -g trust claude-code-best
-ccb # 直接打开 claude code
-```
-
-国内对 github 网络较差的, 需要先设置这个环境变量
-
-```bash
-DEFAULT_RELEASE_BASE=https://ghproxy.net/https://github.com/microsoft/ripgrep-prebuilt/releases/download/v15.0.1
-```
-
-## 快速开始(源码版)
+## 快速开始

 ### 环境要求

@@ -89,7 +109,22 @@ bun run build
 | Opus Model | 高性能模型 ID | `claude-opus-4-6` |

 - **Tab / Shift+Tab** 切换字段，**Enter** 确认并跳到下一个，最后一个字段按 Enter 保存
+- 模型字段会自动读取当前环境变量预填
+- 配置保存到 `~/.claude/settings.json` 的 `env` 字段，保存后立即生效

+也可以直接编辑 `~/.claude/settings.json`：
+
+```json
+{
+  "env": {
+    "ANTHROPIC_BASE_URL": "https://api.example.com/v1",
+    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6"
+  }
+}
+```

 > 支持所有 Anthropic API 兼容服务（如 OpenRouter、AWS Bedrock 代理等），只要接口兼容 Messages API 即可。

--- a/Run.ps1
+++ b/Run.ps1
@@ -0,0 +1,2 @@
+bun install
+bun run dev --dangerously-skip-permissions
--- a/TODO.md
+++ b/TODO.md
@@ -0,0 +1,26 @@
+# TODO
+
+尽可能实现下面的包, 使得与主包的关系完全吻合
+
+## Packages
+
+- [x] `url-handler-napi` — URL 处理 NAPI 模块 (签名修正，保持 null fallback)
+- [x] `modifiers-napi` — 修饰键检测 NAPI 模块 (Bun FFI + Carbon)
+- [x] `audio-capture-napi` — 音频捕获 NAPI 模块 (SoX/arecord)
+- [x] `color-diff-napi` — 颜色差异计算 NAPI 模块 (纯 TS 实现)
+- [x] `image-processor-napi` — 图像处理 NAPI 模块 (sharp + osascript 剪贴板)
+
+- [x] `@ant/computer-use-swift` — Computer Use Swift 原生模块 (macOS JXA/screencapture 实现)
+- [x] `@ant/computer-use-mcp` — Computer Use MCP 服务 (类型安全 stub + sentinel apps + targetImageSize)
+- [x] `@ant/computer-use-input` — Computer Use 输入模块 (macOS AppleScript/JXA 实现)
+<!-- - [ ] `@ant/claude-for-chrome-mcp` — Chrome MCP 扩展 -->
+
+## 工程化能力
+
+- [x] 代码格式化与校验
+- [x] 冗余代码检查
+- [x] git hook 的配置
+- [x] 代码健康度检查
+- [x] Biome lint 规则调优（适配反编译代码，关闭格式化避免大规模 diff）
+- [x] 单元测试基础设施搭建 (test runner 配置)
+- [x] CI/CD 流水线 (GitHub Actions)
--- a/V6.md
+++ b/V6.md
--- a/docs/pr-120-merge-plan.md
+++ b/docs/pr-120-merge-plan.md
@@ -0,0 +1,49 @@
+# PR #120 分批合入方案
+
+> 分支: `pr-sobird-120` → `main`
+> 总计: 558 files / +102,830 / -101,373
+
+## 执行进度
+
+### B1: 552 文件格式化 — 拆分为 6 个子批次
+
+#### B1-1: ink + buddy + cli + context + screens + tasks + services + keybindings (43 files) ✓
+- [x] 合入: src/ink/ (17), src/buddy/ (2), src/cli/ (2), src/context/ (9), src/screens/ (3), src/tasks/ (4), src/services/ (3), src/keybindings/ (2), src/state/ (1)
+- [x] 验证 `bun run build` 通过 ✓ (475 files)
+
+#### B1-2: commands (79 files) ✓
+- [x] 合入: src/commands/ (79 files)
+- [x] 验证 `bun run build` 通过 ✓
+
+#### B1-3: components/messages + permissions + mcp + sandbox + shell (104 files) ✓
+- [x] 合入: src/components/messages/ (39), src/components/permissions/ (39), src/components/mcp/ (11), src/components/sandbox/ (5), src/components/shell/ (4)
+- [x] 验证 `bun run build` 通过 ✓
+
+#### B1-4: components/PromptInput,FeedbackSurvey,tasks,agents,skills,design-system,wizard (73 files) ✓
+- [x] 合入: src/components/PromptInput/ (13), src/components/FeedbackSurvey/ (6), src/components/tasks/ (12), src/components/agents/ (17), src/components/skills/ (1), src/components/design-system/ (14), src/components/wizard/ (3)
+- [x] 验证 `bun run build` 通过 ✓
+
+#### B1-5: components 其余 + hooks + tools (232 files) ✓
+- [x] 合入: src/components/ 其余目录 (~169), src/hooks/ (28), src/tools/ (35)
+- [x] 验证 `bun run build` 通过 ✓
+
+#### B1-6: 根目录 + utils + 其他零散文件 (21 files) ✓
+- [x] 合入: src/main.tsx, src/dialogLaunchers.tsx, src/replLauncher.tsx, src/interactiveHelpers.tsx, src/entrypoints/, src/moreright/, src/utils/ (15)
+- [x] 验证 `bun run build` 通过 ✓
+
+### B2: 45 文件 USER_TYPE 替换 (commit `fc200fd`)
+- [ ] cherry-pick USER_TYPE 提交
+- [ ] 检查替换是否完整无遗漏
+- [ ] 验证 `bun run build` 通过
+
+### B3: 文档变更 (README / Run.ps1 / TODO.md / V6.md)
+- [ ] 合入 README.md, Run.ps1, TODO.md
+- [ ] 删除 V6.md
+- [ ] 验证无破坏
+
+### B4: 构建配置变更 — 跳过
+
+### 最终验证
+- [ ] `bun run build` 完整构建
+- [ ] `bun test` 测试通过
+- [ ] git log 确认提交历史清晰