diff --git a/README.md b/README.md
index 589bae680..1f5f58ac6 100644
--- a/README.md
+++ b/README.md
@@ -1,174 +1,396 @@
-# Claude Code Best V5 (CCB)
+
-[](https://github.com/claude-code-best/claude-code/stargazers)
-[](https://github.com/claude-code-best/claude-code/graphs/contributors)
-[](https://github.com/claude-code-best/claude-code/issues)
-[](https://github.com/claude-code-best/claude-code/blob/main/LICENSE)
-[](https://github.com/claude-code-best/claude-code/commits/main)
-[](https://bun.sh/)
-[](https://discord.gg/qZU6zS7Q)
+# CoStrict
-> Which Claude do you like? The open source one is the best.
+**企业级 AI 编程助手 · 终端原生**
-牢 A (Anthropic) 官方 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI 工具的源码反编译/逆向还原项目。目标是将 Claude Code 大部分功能及工程化能力复现 (问就是老佛爷已经付过钱了)。虽然很难绷, 但是它叫做 CCB(踩踩背)... 而且, 我们实现了企业版或者需要登陆 Claude 账号才能使用的特性, 实现技术普惠
+[快速开始](#快速开始) · [架构](#架构总览) · [部署](#私有化部署) · [API 协议](#api-多协议兼容) · [CoStrict 专有模块](#costrict-专有模块)
-[文档在这里, 支持投稿 PR](https://ccb.agent-aura.top/) | [留影文档在这里](./Friends.md) | [Discord 群组](https://discord.gg/qZU6zS7Q)
+
-| 特性 | 说明 | 文档 |
-|------|------|------|
-| **Claude 群控技术** | Pipe IPC 多实例协作：同机 main/sub 自动编排 + LAN 跨机器零配置发现与通讯，`/pipes` 选择面板 + `Shift+↓` 交互 + 消息广播路由 | [Pipe IPC](https://ccb.agent-aura.top/docs/features/pipes-and-lan) / [LAN](https://ccb.agent-aura.top/docs/features/lan-pipes) |
-| **ACP 协议一等一支持** | 支持接入 Zed、Cursor 等 IDE，支持会话恢复、Skills、权限桥接 | [文档](https://ccb.agent-aura.top/docs/features/acp-zed) |
-| **Remote Control 私有部署** | Docker 自托管远程界面, 可以手机上看 CC | [文档](https://ccb.agent-aura.top/docs/features/remote-control-self-hosting) |
-| **Langfuse 监控** | 企业级 Agent 监控, 可以清晰看到每次 agent loop 细节, 可以一键转化为数据集 | [文档](https://ccb.agent-aura.top/docs/features/langfuse-monitoring) |
-| **Web Search** | 内置网页搜索工具, 支持 bing 和 brave 搜索 | [文档](https://ccb.agent-aura.top/docs/features/web-browser-tool) |
-| **Poor Mode** | 穷鬼模式，关闭记忆提取和键入建议,大幅度减少并发请求 | /poor 可以开关 |
-| **自定义模型供应商** | OpenAI/Anthropic/Gemini/Grok 兼容 | [文档](https://ccb.agent-aura.top/docs/features/custom-platform-login) |
-| Voice Mode | Push-to-Talk 语音输入 | [文档](https://ccb.agent-aura.top/docs/features/voice-mode) |
-| Computer Use | 屏幕截图、键鼠控制 | [文档](https://ccb.agent-aura.top/docs/features/computer-use) |
-| Chrome Use | 浏览器自动化、表单填写、数据抓取 | [自托管](https://ccb.agent-aura.top/docs/features/chrome-use-mcp) [原生版](https://ccb.agent-aura.top/docs/features/claude-in-chrome-mcp) |
-| Sentry | 企业级错误追踪 | [文档](https://ccb.agent-aura.top/docs/internals/sentry-setup) |
-| GrowthBook | 企业级特性开关 | [文档](https://ccb.agent-aura.top/docs/internals/growthbook-adapter) |
-| /dream 记忆整理 | 自动整理和优化记忆文件 | [文档](https://ccb.agent-aura.top/docs/features/auto-dream) |
+---
-- 🚀 [想要启动项目](#快速开始源码版)
-- 🐛 [想要调试项目](#vs-code-调试)
-- 📖 [想要学习项目](#teach-me-学习项目)
+## CoStrict 是什么
+CoStrict 是一款免费开源的 AI 辅助编程工具，专为企业级开发场景设计。支持私有化部署，是组织级安全、标准化 AI 开发工作流的最佳选择。
-## ⚡ 快速开始(安装版)
+| 能力 | 说明 |
+|------|------|
+| **CoStrict 企业认证** | OAuth 2.0 + Casdoor SSO，自动 Token 刷新，机器指纹绑定 |
+| **8 种 API 协议** | CoStrict / Anthropic / OpenAI / Gemini / Grok / Bedrock / Vertex / Foundry |
+| **53+ 内置工具** | 文件读写、Shell 执行、Web 搜索、Agent 调度、MCP 扩展——开箱即用 |
+| **16 个结构化 Agent** | 严格需求分析→架构设计→任务规划→编码→验证全链路编排 |
+| **私有化部署** | Remote Control Server (Docker) + Bridge Mode，数据不出内网 |
+| **Feature Flag 体系** | 19+ 默认特性 + 环境变量热开关，按需启用零代码改动 |
+| **安全合规** | 权限模式分级、Policy 策略网关、Worktree 隔离、审计日志 |
+| **全平台** | macOS / Windows / Linux，Computer Use + Chrome Use 双通道 UI 自动化 |
-不用克隆仓库, 从 NPM 下载后, 直接使用
+---
-```sh
-bun i -g claude-code-best
-bun pm -g trust claude-code-best
-ccb # 以 nodejs 打开 claude code
-ccb-bun # 以 bun 形态打开
-CLAUDE_BRIDGE_BASE_URL=https://remote-control.claude-code-best.win/ CLAUDE_BRIDGE_OAUTH_TOKEN=test-my-key ccb --remote-control # 我们有自部署的远程控制
-```
+## 快速开始
-## ⚡ 快速开始(源码版)
-
-### ⚙️ 环境要求
-
-一定要最新版本的 bun 啊, 不然一堆奇奇怪怪的 BUG!!! bun upgrade!!!
-
-- 📦 [Bun](https://bun.sh/) >= 1.3.11
-- ⚙️ 常规的配置 CC 的方式, 各大提供商都有自己的配置方式
-
-### 📥 安装
+### 安装版
```bash
+bun i -g @costrict/xxx
+csc
+```
+
+### 源码版
+
+**环境要求**：[Bun](https://bun.sh/) >= 1.2.0
+
+```bash
+git clone https://github.com/y574444354/csc.git
+cd csc
bun install
+bun run dev # 版本号显示 888 即成功
+bun run build # 生产构建 → dist/cli.js + chunk 文件
```
-### ▶️ 运行
+### 首次登录
-```bash
-# 开发模式, 看到版本号 888 说明就是对了
-bun run dev
+启动后输入 `/login`，CoStrict 提供两种认证入口：
-# 构建
-bun run build
+**1. CoStrict 企业登录（推荐）**
+
+浏览器自动打开 CoStrict OAuth 页面，完成 SSO 登录后自动写入凭证：
+
+```
+/login → 选择 CoStrict → 浏览器 SSO 登录 → 自动完成
```
-构建采用 code splitting 多文件打包（`build.ts`），产物输出到 `dist/` 目录（入口 `dist/cli.js` + 约 450 个 chunk 文件）。
+- 认证服务：`https://zgsm.sangfor.com/oidc-auth`
+- 凭证存储：`~/.claude/csc-auth.json`（0600 权限）
+- 自动刷新：三层 Token 验证 + 预防性刷新 + 401 反应性恢复
-构建出的版本 bun 和 node 都可以启动, 你 publish 到私有源可以直接启动
+**2. 第三方 API 直连**
-如果遇到 bug 请直接提一个 issues, 我们优先解决
+选择 Anthropic Compatible / OpenAI / Gemini 填写 Base URL 和 API Key：
-### 👤 新人配置 /login
-
-首次运行后，在 REPL 中输入 `/login` 命令进入登录配置界面，选择 **Anthropic Compatible** 即可对接第三方 API 兼容服务（无需 Anthropic 官方账号）。
-选择 OpenAI 和 Gemini 对应的栏目都是支持相应协议的
-
-需要填写的字段：
-
-| 📌 字段 | 📝 说明 | 💡 示例 |
+| 字段 | 说明 | 示例 |
|------|------|------|
| Base URL | API 服务地址 | `https://api.example.com/v1` |
| API Key | 认证密钥 | `sk-xxx` |
-| Haiku Model | 快速模型 ID | `claude-haiku-4-5-20251001` |
-| Sonnet Model | 均衡模型 ID | `claude-sonnet-4-6` |
-| Opus Model | 高性能模型 ID | `claude-opus-4-6` |
+| Haiku Model | 快速模型 | `claude-haiku-4-5-20251001` |
+| Sonnet Model | 均衡模型 | `claude-sonnet-4-6` |
+| Opus Model | 高性能模型 | `claude-opus-4-6` |
-- ⌨️ **Tab / Shift+Tab** 切换字段，**Enter** 确认并跳到下一个，最后一个字段按 Enter 保存
+也可直接编辑 `~/.claude/settings.json`：
-
-> ℹ️ 支持所有 Anthropic API 兼容服务（如 OpenRouter、AWS Bedrock 代理等），只要接口兼容 Messages API 即可。
-
-## Feature Flags
-
-所有功能开关通过 `FEATURE_=1` 环境变量启用，例如：
-
-```bash
-FEATURE_BUDDY=1 FEATURE_FORK_SUBAGENT=1 bun run dev
+```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"
+ }
+}
```
-各 Feature 的详细说明见 [`docs/features/`](docs/features/) 目录，欢迎投稿补充。
+---
-## VS Code 调试
+## CoStrict 专有模块
-TUI (REPL) 模式需要真实终端，无法直接通过 VS Code launch 启动调试。使用 **attach 模式**：
+### 企业认证体系 (`src/costrict/provider/`)
-### 步骤
+| 模块 | 职责 |
+|------|------|
+| `auth.ts` | OAuth 2.0 登录流程：浏览器跳转、Token 轮询、凭证保存 |
+| `credentials.ts` | 凭证管理：读写 `csc-auth.json`、机器指纹 SHA256 生成 |
+| `token.ts` | Token 生命周期：JWT 解析、三层验证、自动刷新 |
+| `fetch.ts` | 请求中间件：动态注入 Authorization + 自定义 Headers、预防性/反应性 Token 刷新 |
+| `oauth-params.ts` | OAuth 参数构建：Casdoor provider 标识、插件版本、URI Scheme |
+| `models.ts` | 动态模型列表：从 AI Gateway 拉取可用模型，1 小时缓存 |
+| `modelMapping.ts` | 模型名解析：5 级优先级映射 Anthropic 模型名到 CoStrict 模型 ID |
+| `index.ts` | 查询入口：复用 OpenAI 兼容路径，注入 CoStrict fetch 和 baseURL |
-1. **终端启动 inspect 服务**：
- ```bash
- bun run dev:inspect
- ```
- 会输出类似 `ws://localhost:8888/xxxxxxxx` 的地址。
+**Token 刷新策略**：
-2. **VS Code 附着调试器**：
- - 在 `src/` 文件中打断点
- - F5 → 选择 **"Attach to Bun (TUI debug)"**
-
-
-## Teach Me 学习项目
-
-我们新加了一个 teach-me skills, 通过问答式引导帮你理解这个项目的任何模块。(调整 [sigma skill 而来](https://github.com/sanyuan0704/sanyuan-skills))
-
-```bash
-# 在 REPL 中直接输入
-/teach-me Claude Code 架构
-/teach-me React Ink 终端渲染 --level beginner
-/teach-me Tool 系统 --resume
+```
+请求发起 → 读取凭证 → Token 是否过期？
+ ├─ 否 → 正常请求（注入 Authorization + X-Costrict-* headers）
+ └─ 是 → refresh_token 刷新 → 成功？
+ ├─ 是 → 更新凭证 → 正常请求
+ └─ 否 → 使用旧 Token 尝试 → 401？
+ ├─ 是 → 再次刷新 → 重试请求
+ └─ 否 → 返回原始响应
```
-### 它能做什么
+**模型名解析优先级**：
-- **诊断水平** — 自动评估你对相关概念的掌握程度，跳过已知的、聚焦薄弱的
-- **构建学习路径** — 将主题拆解为 5-15 个原子概念，按依赖排序逐步推进
-- **苏格拉底式提问** — 用选项引导思考，而非直接给答案
-- **错误概念追踪** — 发现并纠正深层误解
-- **断点续学** — `--resume` 从上次进度继续
+1. 传入 model 已是已知 CoStrict 模型 ID（用户 `/model` 明确选择）
+2. `COSTRICT_MODEL` 环境变量（管理员全局覆盖）
+3. `COSTRICT_DEFAULT_{HAIKU|SONNET|OPUS}_MODEL` 环境变量（按族映射）
+4. 缓存模型列表的第一个可用模型
+5. 透传原始模型名（兜底）
-### 学习记录
+### 结构化 Agent (`src/costrict/agents/`)
-学习进度保存在 `.claude/skills/teach-me/` 目录下，支持跨主题学习者档案。
+CoStrict 提供严格分阶段的 Agent 编排，覆盖从需求到交付的全链路：
-## 相关文档及网站
+| Agent | 阶段 | 职责 |
+|-------|------|------|
+| `strictSpec` | 需求 | 需求澄清 → 架构设计 → 任务规划 → 执行（四阶段工作流） |
+| `requirement` | 需求 | 用户需求 → 结构化系统需求文档 |
+| `designAgent` | 设计 | 需求文档 → C4 Model 架构设计 |
+| `taskPlan` | 规划 | 需求 + 设计 → 高层次任务规划 |
+| `strictPlan` | 规划 | 用户需求 → 可执行实施计划 |
+| `subCoding` | 编码 | 高效低成本的代码实现 |
+| `taskCheck` | 验证 | 任务质量检查与改进 |
+| `tddTestDesign` | 测试 | 功能需求 → 测试用例设计 |
+| `tddTestPrepare` | 测试 | 测试环境准备 |
+| `tddRunAndFix` | 测试 | 执行验证 → 自动修复 |
+| `tddTestAndFix` | 测试 | 测试执行与诊断修复 |
+| `codeReviewSecurity` | 安全 | 代码安全审计 |
+| `quickExplore` | 探索 | 快速项目探索与代码理解 |
+| `wikiProjectAnalyze` | 文档 | 项目分类分析 |
+| `wikiCatalogueDesign` | 文档 | 文档结构设计 |
+| `wikiDocumentGenerate` | 文档 | 技术文档生成 |
+| `wikiIndexGeneration` | 文档 | 索引文档生成 |
-- **在线文档（Mintlify）**: [ccb.agent-aura.top](https://ccb.agent-aura.top/) — 文档源码位于 [`docs/`](docs/) 目录，欢迎投稿 PR
-- **DeepWiki**:
+**StrictSpec 全链路编排**：
-## Contributors
+```
+用户需求 → StrictSpec
+ ├─ Stage 1: Requirement → 结构化需求文档
+ ├─ Stage 2: DesignAgent → C4 Model 架构设计
+ ├─ Stage 3: TaskPlan → 任务规划
+ └─ Stage 4: SubCoding → 编码实现
+```
-
- 
-
+### CoStrict 技能 (`src/costrict/skill/`)
-## Star History
+| 技能 | 说明 |
+|------|------|
+| `projectWiki` | 项目文档体系生成（分析→设计→生成→索引） |
+| `tdd` | TDD 全流程（设计→准备→执行→修复） |
+| `builtin` | 内置技能注册与索引 |
-
-
-
-
- 
-
-
+---
-## 许可证
+## API 多协议兼容
-本项目仅供学习研究用途。Claude Code 的所有权利归 [Anthropic](https://www.anthropic.com/) 所有。
+CoStrict 通过流适配器模式将所有 API 协议转为内部统一格式，下游代码零改动。
+
+| 协议 | 启用方式 | 适用场景 |
+|------|---------|---------|
+| **CoStrict** | `/login` 选 CoStrict 或 `CLAUDE_CODE_USE_COSTRICT=1` | 企业 SSO + AI Gateway 动态模型 |
+| **Anthropic** | 默认 | 原生 Messages API |
+| **OpenAI** | `CLAUDE_CODE_USE_OPENAI=1` | Ollama / DeepSeek / vLLM |
+| **Gemini** | `CLAUDE_CODE_USE_GEMINI=1` | Google Gemini API |
+| **xAI Grok** | `CLAUDE_CODE_USE_GROK=1` | xAI Grok API |
+| **AWS Bedrock** | `CLAUDE_CODE_USE_BEDROCK=1` | AWS Bedrock |
+| **Google Vertex** | `CLAUDE_CODE_USE_VERTEX=1` | Vertex AI |
+| **Foundry** | `CLAUDE_CODE_USE_FOUNDRY=1` | Anthropic Foundry |
+
+---
+
+## 架构总览
+
+```
+┌───────────────────────────────────────────────────────────┐
+│ CLI 入口 (cli.tsx) — 12 快速路径 + main.tsx 完整 CLI │
+├───────────────────────────────────────────────────────────┤
+│ REPL 对话循环 │
+│ REPL.tsx → QueryEngine → query() → API Client │
+│ 流式响应 · Tool 调度 · 上下文压缩 · 记忆管理 │
+├───────────────┬───────────────────────────────────────────┤
+│ CoStrict 专有 │ 通用工具层 │
+│ ┌──────────┐ │ ┌─────────────────────────────────────┐ │
+│ │ Provider │ │ │ 53+ 内置工具 │ │
+│ │ OAuth │ │ │ 文件 / Shell / Agent / Web / MCP │ │
+│ │ Token │ │ │ Cron / Worktree / LSP / Skill │ │
+│ │ Fetch │ │ └─────────────────────────────────────┘ │
+│ │ Models │ ├───────────────────────────────────────────┤
+│ │ Mapping │ │ Agent 编排层 │
+│ └──────────┘ │ ┌─────────────────────────────────────┐ │
+│ ┌──────────┐ │ │ CoStrict Agents (16) │ │
+│ │ Agents │ │ │ StrictSpec · TDD · Wiki · Security │ │
+│ │ (16) │ │ └─────────────────────────────────────┘ │
+│ └──────────┘ │ ┌─────────────────────────────────────┐ │
+│ ┌──────────┐ │ │ 通用 Agents │ │
+│ │ Skills │ │ │ AgentTool · Team · Coordinator │ │
+│ │ (3) │ │ │ Fork Subagent · Worktree 隔离 │ │
+│ └──────────┘ │ └─────────────────────────────────────┘ │
+├───────────────┴───────────────────────────────────────────┤
+│ API 兼容层 (8 协议) → 统一流适配器 → 下游代码零改动 │
+├───────────────────────────────────────────────────────────┤
+│ 基础设施 │
+│ Feature Flag · Daemon · Bridge/RCS · Voice Mode │
+│ BG Sessions · Policy 网关 · Sentry · GrowthBook │
+└───────────────────────────────────────────────────────────┘
+```
+
+### CLI 入口快速路径
+
+| 命令 | 说明 | Feature Gate |
+|------|------|-------------|
+| `--version` | 版本输出：`4.0.1 (CoStrict)` | — |
+| `--claude-in-chrome-mcp` | Chrome 浏览器控制 MCP | — |
+| `--computer-use-mcp` | Computer Use MCP | `CHICAGO_MCP` |
+| `rc` / `bridge` / `remote-control` | Bridge 模式 | `BRIDGE_MODE` |
+| `daemon` | 守护进程 | `DAEMON` |
+| `ps` / `logs` / `attach` / `kill` | 后台会话管理 | `BG_SESSIONS` |
+| `new` / `list` / `reply` | Template 任务 | `TEMPLATES` |
+| `environment-runner` | BYOC 环境运行器 | `BYOC_ENVIRONMENT_RUNNER` |
+| `self-hosted-runner` | 自托管运行器 | `SELF_HOSTED_RUNNER` |
+| `--tmux` + `--worktree` | Tmux 工作区隔离 | — |
+| 默认路径 | 完整 REPL CLI | — |
+
+---
+
+## 工具体系
+
+### 内置工具分类
+
+| 分类 | 工具 | 说明 |
+|------|------|------|
+| **文件操作** | `FileReadTool` `FileEditTool` `FileWriteTool` `GlobTool` `GrepTool` | 代码读写与搜索 |
+| **Shell 执行** | `BashTool` `PowerShellTool` `REPLTool` | 命令执行与交互式 REPL |
+| **Agent 协作** | `AgentTool` `TaskCreateTool` `TaskUpdateTool` `TaskListTool` `TaskGetTool` `TaskOutputTool` `TaskStopTool` | 多 Agent 任务调度 |
+| **团队编排** | `TeamCreateTool` `TeamDeleteTool` `SendMessageTool` | Agent Team 编排 |
+| **规划验证** | `EnterPlanModeTool` `ExitPlanModeTool` `VerifyPlanExecutionTool` | 结构化规划与验证 |
+| **Web 网络** | `WebFetchTool` `WebSearchTool` `WebBrowserTool` | 网页获取/搜索/浏览器自动化 |
+| **MCP 扩展** | `MCPTool` `McpAuthTool` `ListMcpResourcesTool` `ReadMcpResourceTool` | Model Context Protocol |
+| **调度定时** | `CronCreateTool` `CronDeleteTool` `CronListTool` | Cron 定时任务 |
+| **工作区** | `EnterWorktreeTool` `ExitWorktreeTool` | Git Worktree 隔离 |
+| **交互辅助** | `AskUserQuestionTool` `TodoWriteTool` `SkillTool` `ToolSearchTool` `DiscoverSkillsTool` `ConfigTool` | 用户交互与配置 |
+| **开发辅助** | `LSPTool` `NotebookEditTool` `BriefTool` | LSP / Notebook / 会话摘要 |
+| **远程触发** | `RemoteTriggerTool` `MonitorTool` | 远程 Agent 触发与监控 |
+| **高级特性** | `SleepTool` `SnipTool` `WorkflowTool` `TungstenTool` | Proactive / 工作流 / 实验性 |
+
+### MCP 扩展
+
+```bash
+csc mcp serve # 启动 MCP 服务器
+csc mcp add # 添加 MCP 服务
+csc mcp list # 列出已配置服务
+```
+
+---
+
+## Feature Flag 体系
+
+所有特性通过 `FEATURE_=1` 环境变量按需启用。
+
+### 默认启用（Dev + Build）
+
+| 优先级 | Feature | 说明 |
+|--------|---------|------|
+| 核心 | `BUDDY` | 宠物伙伴 |
+| 核心 | `TRANSCRIPT_CLASSIFIER` | 会话自动分类 |
+| 核心 | `BRIDGE_MODE` | Bridge / Remote Control |
+| 核心 | `AGENT_TRIGGERS_REMOTE` | 远程 Agent 触发 |
+| 核心 | `CHICAGO_MCP` | Computer Use MCP |
+| 核心 | `VOICE_MODE` | 语音输入 |
+| 监控 | `SHOT_STATS` | 统计面板 |
+| 监控 | `PROMPT_CACHE_BREAK_DETECTION` | 缓存断裂检测 |
+| 监控 | `TOKEN_BUDGET` | Token 预算管理 |
+| P0 | `AGENT_TRIGGERS` | 本地 Agent 触发 |
+| P0 | `ULTRATHINK` | 深度思考 |
+| P0 | `BUILTIN_EXPLORE_PLAN_AGENTS` | 内置探索/规划 Agent |
+| P0 | `LODESTONE` | Lodestone |
+| P1 | `EXTRACT_MEMORIES` | 记忆提取 |
+| P1 | `VERIFICATION_AGENT` | 验证 Agent |
+| P1 | `KAIROS_BRIEF` | Kairos 摘要 |
+| P1 | `AWAY_SUMMARY` | 离线摘要 |
+| P1 | `ULTRAPLAN` | 超级规划 |
+| P2 | `DAEMON` | 守护进程 |
+
+### 按需启用
+
+| Feature | 说明 |
+|---------|------|
+| `BG_SESSIONS` | 后台会话 (ps/logs/attach/kill) |
+| `FORK_SUBAGENT` | Fork 子 Agent 并行执行 |
+| `PROACTIVE` | 主动式 Agent |
+| `KAIROS` | Kairos 全功能 |
+| `COORDINATOR_MODE` | Coordinator 协调模式 |
+| `TEMPLATES` | Template 任务系统 |
+| `SSH_REMOTE` | SSH 远程连接 |
+| `WEB_BROWSER_TOOL` | 浏览器自动化 |
+| `WORKFLOW_SCRIPTS` | 工作流脚本 |
+| `BYOC_ENVIRONMENT_RUNNER` | BYOC 环境运行器 |
+| `SELF_HOSTED_RUNNER` | 自托管运行器 |
+
+```bash
+FEATURE_FORK_SUBAGENT=1 FEATURE_BG_SESSIONS=1 bun run dev
+```
+
+---
+
+## Workspace Packages
+
+| Package | 说明 | 状态 |
+|---------|------|------|
+| `@ant/ink` | Forked Ink 终端 UI 框架 | 完整 |
+| `@ant/computer-use-mcp` | Computer Use MCP Server | 完整 |
+| `@ant/computer-use-input` | 键鼠模拟 (多平台 backend) | 完整 |
+| `@ant/computer-use-swift` | 截图 + 应用管理 (多平台) | 完整 |
+| `@ant/claude-for-chrome-mcp` | Chrome 浏览器控制 | 完整 |
+| `remote-control-server` | 自托管 RCS (Docker + Web UI) | 完整 |
+| `audio-capture-napi` | 原生音频捕获 | 已恢复 |
+| `image-processor-napi` | 图像处理 | 已恢复 |
+| `color-diff-napi` | 颜色差异计算 | 完整 |
+| `modifiers-napi` | 键盘修饰键检测 | Stub |
+| `url-handler-napi` | URL scheme 处理 | Stub |
+
+---
+
+## 测试与质量
+
+| 指标 | 数据 |
+|------|------|
+| 测试数量 | 2430 tests |
+| 测试文件 | 137 files |
+| 断言调用 | 3982 expect() |
+| 框架 | `bun:test` |
+| Lint | Biome |
+| Format | Biome |
+
+```bash
+bun test # 全量测试
+bun test src/utils/__tests__/hash.test.ts # 单文件
+bun test --coverage # 覆盖率
+bun run lint # 静态检查
+bun run health # 健康检查
+```
+
+---
+
+## 开发调试
+
+### 常用脚本
+
+| 命令 | 说明 |
+|------|------|
+| `bun run dev` | 开发模式（MACRO + 全 Feature） |
+| `bun run dev:inspect` | 带 Inspector 的开发模式 |
+| `bun run build` | 生产构建 (code splitting) |
+| `bun run lint:fix` | 自动修复 Lint |
+| `bun run format` | 格式化 |
+| `bun run health` | 健康检查 |
+| `bun run generate:skills` | 生成 Skills 索引 |
+| `bun run rcs` | 启动 RCS |
+| `bun run docs:dev` | 文档站 (Mintlify) |
+
+### VS Code 调试
+
+```bash
+bun run dev:inspect # → ws://localhost:8888/xxx
+# VS Code: F5 → "Attach to Bun (TUI debug)"
+```
+
+---
+
+## Teach Me
+
+内置苏格拉底式问答学习：
+
+```bash
+/teach-me CoStrict 架构
+/teach-me Tool 系统 --level beginner --resume
+```
\ No newline at end of file