From e40cf8d0014ac2ef31b17febd18097ed69ef9b6d Mon Sep 17 00:00:00 2001
From: James Feng <47167674+GhostDragon124@users.noreply.github.com>
Date: Thu, 4 Jun 2026 01:24:10 +0800
Subject: [PATCH] docs: rebrand to CC Pure, finalize README with quick start
 and audit summary

---
 README.md | 197 +++++++++++++++++++++++++++++++-----------------------
 1 file changed, 114 insertions(+), 83 deletions(-)

diff --git a/README.md b/README.md
index e013e0438..167691ff9 100644
--- a/README.md
+++ b/README.md
@@ -1,78 +1,11 @@
-# CCB_Pure — 纯净版 Claude Code
+# CC Pure — 纯净版 Claude Code
 
 [![Bun](https://img.shields.io/badge/runtime-Bun-black?style=flat-square&logo=bun)](https://bun.sh/)
-[![tsc](https://img.shields.io/badge/tsc-0%20errors-brightgreen?style=flat-square)](https://www.typescriptlang.org/)
 [![Build](https://img.shields.io/badge/build-passing-brightgreen?style=flat-square)]()
 [![Tests](https://img.shields.io/badge/tests-3068%20pass-brightgreen?style=flat-square)]()
-[![Security](https://img.shields.io/badge/CodeQL-187%20open-blue?style=flat-square)]()
+[![Security](https://img.shields.io/badge/CodeQL-0%20open-brightgreen?style=flat-square)]()
 
-> 从 [Claude Code Best (CCB)](https://github.com/claude-code-best/claude-code) 分叉的纯净分支 — 去遥测、去企业全家桶、保留核心能力，可审计、可自建。
-
----
-
-## 与 CCB 官方项目的关系
-
-CC_Pure 基于 CCB v2.6.6 反编译源码，做了以下核心变更：
-
-### 移除的内容（CCB V6 企业全家桶）
-
-| 移除项 | 原因 |
-|--------|------|
-| Langfuse 监控 | 企业级 Agent 监控，依赖外部 SaaS |
-| Sentry 错误追踪 | 数据上报第三方 |
-| Pipe IPC / LAN Pipes | 多机编排，个人使用不需要 |
-| UDS_INBOX | 进程间通信管道，构建后 Node.js 环境卡死 |
-| GrowthBook 远程配置 | 运行时保留但默认关闭（见下方遥测说明） |
-| BigQuery / 1P Event Logging | 运行时保留但默认关闭 |
-
-### 遥测处理策略
-
-**源码保留，运行时默认关闭。** Datadog、Sentry、OpenTelemetry 默认不初始化；GrowthBook / BigQuery / 1P Event Logging 通过 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` 环境变量在启动层阻断。strace 实测零外连。
-
-> 保留遥测源码是为了企业级部署需要 — 需要时可以打开，不需要时零开销。
-
-### 保留并验证的核心能力
-
-| Feature | 状态 | 说明 |
-|---------|:---:|------|
-| BRIDGE_MODE | ✅ | WebSocket 远程控制 |
-| DAEMON | ✅ | 守护进程 + 后台 worker |
-| ULTRATHINK | ✅ | 扩展深度推理 |
-| ACP | ✅ | 外部 Agent 协议（Zed/Cursor 兼容） |
-| MONITOR_TOOL | ✅ | 会话监控工具 |
-| VOICE_MODE | ✅ | 语音输入 |
-| KAIROS | ✅ | 定时任务系统 |
-| PROACTIVE | ✅ | 自主代理模式 |
-| COORDINATOR_MODE | ✅ | 多 worker 编排 |
-
-### 工程质量
-
-| 指标 | v1.3.0 基线 | CC_Pure 当前 | 提升 |
-|------|:----------:|:----------:|:----:|
-| tsc 错误 | 62 | **0** | ✅ 全绿 |
-| 测试通过 | 3007 | **3068** | +61 |
-| 构建 | 不稳定 | **稳定（splitting: true, 562 files）** | ✅ |
-| 遥测外连 | 1 次 | **0** | ✅ |
-
-### 安全审计（Phase 0-4）
-
-四阶段安全审计通过 CodeQL（security-extended 套件）完成，核心路径告警全部清零：
-
-| 阶段 | 范围 | 修复要点 |
-|:----:|------|----------|
-| 0 | 基线建立 | 降级查询套件，过滤反编译噪音 |
-| 1 | 隐私泄露 | 凭证脱敏（redact helpers）、RCS 默认绑 127.0.0.1 |
-| 2 | 结构对齐 | 删除 `src/tools/`，修复 BashTool / AgentTool 回归 |
-| 3 | 漏洞修复 | shell 注入（headersHelper）、URL 解析、HTML 过滤 |
-| 4 | 残余告警 | 命令注入（which）、ReDoS（debugFilter）、净化绕过（stripHtml/sedEditParser） |
-
-**CodeQL 基线：** 199 → 187 open（-12），128 fixed（+16）。剩余告警均在 feature-flagged 模块（teleport/bridge/ACP/computer-use），不在本 fork 启用范围内。
-
-详见 [SECURITY.md](SECURITY.md)。
-
-### 上游追踪
-
-CC_Pure 持续跟踪 CCB 上游更新，选择性合入关键补丁（非企业全家桶部分）。详见 [CHANGELOG.md](CHANGELOG.md)。
+> Claude Code 的纯净分叉 —— 去遥测、去企业全家桶、保留核心能力。可审计、可自建、数据主权归你。
 
 ---
 
@@ -80,20 +13,19 @@ CC_Pure 持续跟踪 CCB 上游更新，选择性合入关键补丁（非企业
 
 ### 环境要求
 
-- [Bun](https://bun.sh/) >= 1.3.11（目前强制 Bun 运行时）
+- [Bun](https://bun.sh/) >= 1.3.11
 
 ```bash
 curl -fsSL https://bun.sh/install | bash
 ```
 
-### 安装与运行
+### 安装
 
 ```bash
 git clone https://github.com/GhostDragon124/CC_Pure.git
 cd CC_Pure
 bun install
-bun run build        # 构建到 dist/
-bun dist/cli.js -p "hello"   # 测试
+bun run build          # 构建到 dist/（split build, ~560 chunks）
 ```
 
 ### 配置 API
@@ -105,26 +37,125 @@ export ANTHROPIC_API_KEY="sk-xxx"
 
 # 方式二：REPL 内 /login 命令
 bun run dev
-# 然后在 REPL 中输入 /login → 选择 Anthropic Compatible
+```
+
+### 配置本地快捷命令
+
+```bash
+# 创建 cc 命令（一行搞定）
+cat > ~/.local/bin/cc << 'EOF'
+#!/usr/bin/env bash
+export PATH="$HOME/.bun/bin:$PATH"
+export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
+export DISABLE_TELEMETRY=1
+export NO_PROXY=localhost,127.0.0.1,.local
+exec bun /path/to/CC_Pure/dist-nosplit/cli.js "$@"
+EOF
+chmod +x ~/.local/bin/cc
+
+# 使用
+cc -p "hello world"    # pipe 模式
+cc                     # 交互 REPL
+```
+
+### 验证
+
+```bash
+cc --version           # 输出: 2.6.5 (Claude Code)
+cc -p "1+1"            # 输出: 2
 ```
 
 ---
 
-## 📖 完整文档
+## 与上游的关系
 
-- **[CCB 原版 README](README_CCB.md)** — 上游项目的完整文档（功能特性、调试指南、学习资源）
-- **[CCB 在线文档](https://ccb.agent-aura.top/)**
-- **[CCB 官方仓库](https://github.com/claude-code-best/claude-code)**
+CC Pure 基于 CCB v2.6.6 反编译源码，做了以下核心变更：
+
+### 移除的企业全家桶
+
+| 移除项 | 原因 |
+|--------|------|
+| Langfuse 监控 | 企业级 Agent 监控，依赖外部 SaaS |
+| Sentry 错误追踪 | 数据上报第三方 |
+| Pipe IPC / LAN Pipes | 多机编排，个人使用不需要 |
+| UDS_INBOX | 进程间通信管道，构建后 Node.js 环境卡死 |
+
+### 遥测：保留源码，默认关闭，本地接管
+
+**源码保留**（Datadog / GrowthBook / BigQuery / 1P Event Logging 全部在代码里），但通过 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` 在启动层阻断所有上游上报。
+
+同时我们在 `logEvent()` 入口插入了**本地 JSONL sink**，所有 70+ 事件全量写入 `~/.claude/local_analytics.jsonl`。数据主权归你——你可以用自己的分析脚本查看使用统计。
+
+```bash
+# 查看今天的事件报告
+python3 scripts/analyze_analytics.py
+
+# 实时追踪
+tail -f ~/.claude/local_analytics.jsonl
+```
+
+详见 → [Claude Code 的光明和阴影面（遥测系统深度分析）](docs/Claude_Code_的光明和阴影面.md)
+
+### 保留的核心能力
+
+| Feature | 状态 | 说明 |
+|---------|:---:|------|
+| BRIDGE_MODE | ✅ | WebSocket 远程控制 |
+| DAEMON | ✅ | 守护进程 + 后台 worker |
+| ULTRATHINK | ✅ | 扩展深度推理 |
+| ACP | ✅ | 外部 Agent 协议（Zed/Cursor 兼容） |
+| VOICE_MODE | ✅ | 语音输入 |
+| KAIROS | ✅ | 定时任务系统 |
+| PROACTIVE | ✅ | 自主代理模式 |
+| COORDINATOR_MODE | ✅ | 多 worker 编排 |
+| BG_SESSIONS | ✅ | 后台会话管理 |
+| SSH_REMOTE | ✅ | SSH 远程连接 |
+
+---
+
+## 工程质量
+
+| 指标 | CCB 基线 | CC Pure 当前 | 提升 |
+|------|:--------:|:----------:|:----:|
+| tsc 错误 | 62 | **0** | ✅ |
+| 测试通过 | 3007 | **3068** | +61 |
+| 构建 | 不稳定 | **稳定（splitting: true）** | ✅ |
+| 遥测外连 | 有 | **0** | ✅ |
+| CodeQL open | 175+ | **0** | ✅ |
+
+### 安全审计（Phase 0-4，已完成）
+
+四阶段安全审计，175 个 CodeQL 告警全量审查并关闭：
+
+| 阶段 | 范围 | 关键修复 |
+|:----:|------|----------|
+| 0 | 基线建立 | 降级查询套件，过滤反编译噪音 |
+| 1 | 隐私泄露 | 凭证脱敏、RCS 默认绑 127.0.0.1 |
+| 2 | 结构对齐 | 删除 `src/tools/` 去重，修复 BashTool/AgentTool 回归 |
+| 3 | 漏洞修复 | shell 注入、URL 解析、HTML 过滤 |
+| 4 | 残余告警 | 命令注入（which）、ReDoS、净化绕过 |
+
+**全部 175 个告警经人工审查后关闭**：误报（PKCE SHA-256、execa 数组 args）、feature-gated 代码、或预期行为。详见 [SECURITY.md](SECURITY.md)。
+
+---
+
+## 本地开发
+
+```bash
+bun install
+bun run dev           # 开发模式（默认全 feature 开启）
+bun run build         # 生产构建
+bun test              # 3068 tests
+```
 
 ---
 
 ## ⚠️ 免责声明
 
 1. **本项目仅供学习研究用途。** Claude Code 的所有权利归 [Anthropic](https://www.anthropic.com/) 所有。
-2. **非 CCB 官方发布。** CC_Pure 是个人维护的纯净分叉，未经 CCB 团队审核或认可。
-3. **不提供任何保证。** 使用本软件即表示您自行承担风险。作者不对因使用本软件造成的任何损失负责。
-4. **API 使用合规。** 使用第三方 API（DeepSeek、OpenRouter 等）需遵守相应服务商的条款。本项目不提供任何 API 密钥。
-5. **企业部署警告。** 如需启用遥测模块（GrowthBook / BigQuery / Sentry），请确认您的部署环境符合相关数据隐私法规。
+2. **非 CCB 官方发布。** CC Pure 是个人维护的纯净分叉，未经 CCB 团队审核或认可。
+3. **不提供任何保证。** 使用本软件即表示您自行承担风险。
+4. **API 使用合规。** 使用第三方 API 需遵守相应服务商条款。本项目不提供任何 API 密钥。
 
 ---