# Open C Code (OCC)

> 安全、开源的编码智能体 —— 能力完全对齐 Claude Code。

**[English](./README.md)** · 简体中文

---

## 这是什么

**Open C Code（OCC）** 是一个开源的编码智能体。能力与 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 对齐（当前跟踪 `2.1.286`：OCC-143 追齐轮（2026-10-02）落地了字节级验证的 2.1.286 子集（88 个 changelog 条目逐条 triage + v285↔v286 linux-x64 ELF 全量二进制对比，官方 v286 md5 `7a1a1bf1…`，仅 strings/dd 取证、绝不执行官方二进制）——重点：**整套 v286 密钥脱敏引擎重写**逐字节移植进 `src/utils/secretRedaction/`（changelog #17–21：Bearer/Basic 前置于键名时的凭证泄露、percent-encoded token 仅部分打码、键名含零宽/不可见字符、URL 密码含标点/引号/`]`/`&`/第二个 `@` 或越过 `/` 进入 `[::1]` 方括号主机、transcript JSONL 解析→深度脱敏→重序列化保持合法 JSON——api-request 行整行丢弃、不可判定行以 line-withheld 占位），并接线到 feedback 提示词构建、`/feedback` 提交与会话共享 transcript 上传；24 个新字节级测试 + 全套件 git-stash A/B 零回归；轮中官方发布 2.1.287，按轮次范围纪律记入下一轮；完整台账在 `docs/upstream-version-gap-occ143-2026-10.md`；OCC-102 追齐轮（2026-10-01）落地了字节级验证的 2.1.285 子集（136 个 changelog 条目逐条 triage + v284↔v285 linux-x64 ELF 全量二进制对比，官方 v285 md5 `95fadb74…`，仅 strings/dd 取证、绝不执行官方二进制）——重点：**#85 后台 shell 期限回收子系统**（30 分钟默认 / 2 小时上限、先通知后 kill、`<note>` 用量指引）、#54 max-turns 退出提交恢复，以及安全移植集——sandbox 受信层级授权收敛（项目/本地设置不能再重开被拒的文件读路径或扩大网络白名单）、`allowedProviders` 管理式设置（完整解析+执行架构）、fork 子代理权限模式继承 + ExitPlanMode fork 拒绝、OS 拒读管理式设置 warn+start、`ANTHROPIC_AUTH_TOKEN` 组织策略、git URL 具名拒绝 + worktree/teleport SSH fail-fast、MCP CLI 输出净化——外加 git/mcp/plugin 批量移植（plugin CLI 第 9–13 项 PORTED-core + STAGED-wiring），完整台账在 `docs/upstream-version-gap-occ102-2026-10.md`；OCC-101 追齐轮（2026-09-30）落地了字节级验证的 2.1.284 子集（16 个二进制条目逐条 triage + v283↔v284 linux-x64 ELF 全量二进制对比，官方 v284 md5 `16a758eb…`）——重点：**Sonnet 5.5 发布**（`claude-sonnet-5-5` 目录注册，0→24 ELF 命中 + `SONNET_ID` 翻转；目录/别名/`[1m]` 变体/成本/effort/上下文/Vertex 全套对齐，`default_effort:"medium"`、`max_tokens` `{default:128000}`、知识截止 "June 2026"、`SKILL_MODEL_VARS` 逐字节一致，约 18 个文件），以及安全移植集——Foundry 资源名校验守卫、rules 文件 symlink 逃逸 → 外部导入审批链、elicitation hook `{"decision":"block"}` 生效、`/help` 的 `/keybindings to customize` 门控默认值对齐官方 `true`（插桩项 3/5 如实 STAGED），完整台账在 `docs/upstream-version-gap-occ101-2026-09.md`，679 文件全量套件 6977 pass + 真实 REPL tmux e2e；OCC-138 追齐轮（2026-09-27）落地了 2.1.283 的可移植子集（P1a sandbox 逐字段 fail-closed 策略机制、`claude-ai` 保留命名空间回退、拼写错误 keybinding 修饰符校验、`x-claude-code-prompt-id` 网关提示头、OTEL `tool.output` span 事件，合并 OCC-98 轮的管理式模型治理键与完整 prompt-id 逐消息解析器，台账见 `docs/upstream-version-gap-occ138.md`/`-occ98-2026-09.md`）；OCC-97 追齐轮（2026-09-26）落地了 2.1.282 的 P1 设置信任安全集群（A–E，含中间模式 `:*` 规则修复、策略源严格解析、telemetry 环境变量块名单、frontmatter 授权门控、macOS kernel path/symlink 门），台账见 `docs/upstream-version-gap-occ97-2026-09.md`；OCC-96 落地 2.1.281 的 39 个字节级验证移植（含 9 项安全移植，S1 dangerous-rm 命令替换目标守卫），OCC-134 落地 2.1.280 子集；2.1.276 已完全对齐（经 OCC-90 + OCC-130）；2.1.271–2.1.275 部分对齐（各轮台账见对应 `docs/upstream-version-gap-occ*.md`）；2.1.270→2.1.272 增量中仍未落地：`/config` 全屏鼠标支持（PORTABLE-LARGE）与 spinner 状态文案阶梯（STAGED），另有先于 2.1.270 已存在的 sandbox 按命令 `allowed_domains` 缺口；此前对齐至 2.1.270 经 OCC-122/OCC-123/OCC-84/OCC-124/OCC-85/OCC-125 落地）。代码全开放、可审计、无暗门，数据由你掌控。

如果你担心闭源 CLI 可能植入后门、担心代码与凭据被上传到不可审计的服务，OCC 就是为你准备的：全部源码开放、无混淆，构建产物可由源码复现，API 凭据只发往你自己配置的端点。

## 定位

- 🔓 **开源可审计** —— 全部源码开放，无混淆，可逐行审查。
- 🛡️ **安全透明** —— 无遥测黑盒、无隐藏上报；行为由你监督。
- 🎯 **能力对齐** —— REPL、工具系统、权限模型、MCP、子代理、斜杠命令……与 Claude Code 一致。
- 🔧 **数据自主** —— API Key / Bedrock / Vertex / Azure 凭据留在本机，请求只发往你指定的端点。

## 现状

- 跟踪 Claude Code **`2.1.286`**（2.1.286 对齐——OCC-143 追齐轮落地整套 v286 密钥脱敏引擎重写（#17–21：Bearer/Basic 前置键名、percent-encoded token、不可见字符键名、URL 密码标点/方括号主机、JSONL 安全 transcript 脱敏）+ feedback/会话共享接线，88 条目 triage + v285↔v286 ELF 全量对比，24 个新测试 + stash A/B 零回归，台账见 `docs/upstream-version-gap-occ143-2026-10.md`；2.1.285 部分对齐——OCC-102 追齐轮落地 #85 后台 shell 期限回收 + #54 max-turns 退出提交 + 安全移植集（sandbox 受信层级授权收敛、`allowedProviders` 管理式设置、fork 权限继承、OS 拒读管理式设置 warn+start、git URL 具名拒绝 + SSH fail-fast、MCP CLI 输出净化）+ git/mcp/plugin 批量移植，136 条目 triage + v284↔v285 ELF 全量对比，台账见 `docs/upstream-version-gap-occ102-2026-10.md`；2.1.284 部分对齐——OCC-101 追齐轮落地 Sonnet 5.5 发布 + 安全移植集：Foundry 资源名校验守卫、rules symlink 逃逸审批链、elicitation hook block 生效、`/keybindings to customize` 门控默认 `true`，计划标的 3/5 如实 STAGED，台账见 `docs/upstream-version-gap-occ101-2026-09.md`；2.1.283 部分对齐——OCC-138 轮落地 sandbox 逐字段 fail-closed 策略机制 + `claude-ai` 保留命名空间回退等五集群，合并 OCC-98 管理式模型治理，台账见 `-occ138.md`/`-occ98-2026-09.md`；2.1.282 部分对齐——OCC-97 轮落地 P1 设置信任安全集群 A–E，台账见 `-occ97-2026-09.md`；2.1.281 部分对齐——OCC-96 轮落地 39 个字节级验证移植（含 9 项安全），台账见 `-occ96.md`；2.1.280 部分对齐——OCC-134 轮落地 26 个字节级验证的移植，含 Opus 5.5 发布注册、symlink 落点写权限子系统等五项安全修复，台账见 `-occ134.md`；2.1.276 完全对齐（经 OCC-90 + OCC-130）；2.1.271–2.1.275 部分对齐（OCC-127/OCC-129/OCC-130 等轮，见对应台账）；2.1.270→2.1.272 增量中仍未落地：`/config` 全屏鼠标支持（PORTABLE-LARGE）与 spinner 状态文案阶梯（STAGED），另有先于 2.1.270 已存在的 sandbox 按命令 `allowed_domains` 缺口；此前对齐至 2.1.270 经 OCC-122/OCC-123/OCC-84/OCC-124/OCC-85/OCC-125 落地）。
- 代码库有约 1300 个不阻塞的 `tsc` 类型错误（大量松散的 `unknown`/`never`/`{}` 类型），**不影响 Bun 运行时执行**。门槛是 Biome lint，不是 `tsc`。
- 所有内部 feature flag（`feature(...)`）已被 polyfill 为 `false` —— 内部功能（COORDINATOR_MODE、KAIROS、PROACTIVE 等）全部关闭。
- 已发布到 npm：[`@cnwenf/occ`](https://www.npmjs.com/package/@cnwenf/occ)。

## 安装

```bash
npm i -g @cnwenf/occ
occ
```

需要有效的 Anthropic API Key（或 Bedrock / Vertex / Azure Foundry 凭据）。

## 快速开始

```bash
# 交互式 REPL
occ

# 管道模式（-p）
echo "say hello" | occ -p
```

## 能力

### 核心系统
- **REPL** —— Ink 终端渲染，完整交互界面。
- **API 层** —— Anthropic Direct、AWS Bedrock、Google Vertex、Azure Foundry（API Key + OAuth / 凭据刷新）。
- **查询循环** —— 流式对话、工具调用循环、自动压缩、token 追踪（`query.ts`）。
- **会话引擎** —— 对话状态、归因、文件历史快照（`QueryEngine.ts`）。
- **上下文** —— git status、CLAUDE.md 层级、memory 文件。
- **权限系统** —— plan / auto / manual 模式，YOLO 分类器、路径校验、规则匹配。
- **Hook** —— pre/post tool use，通过 `settings.json` 配置。
- **会话恢复**（`/resume`）、**诊断**（`/doctor`）、**自动压缩**。

### 工具 —— 始终可用
Bash、FileRead、FileEdit、FileWrite、NotebookEdit、Agent（子代理派生：fork / async / background / remote）、WebFetch、WebSearch、AskUserQuestion、SendMessage、Skill、EnterPlanMode、ExitPlanMode、TodoWrite（v1）、Brief、TaskOutput、TaskStop、ListMcpResources、ReadMcpResource、SyntheticOutput。

### 工具 —— 条件启用
Glob、Grep（默认启用）；TaskCreate/Get/Update/List（Todo v2）、EnterWorktree/ExitWorktree、TeamCreate/Delete（agent swarms）、ToolSearch、PowerShell（Windows）、LSP（`ENABLE_LSP_TOOL`）。

### 关闭 / Stub
- Feature flag 关闭（所有 `feature()` 返回 false）：Sleep、Cron、RemoteTrigger、Monitor、WebBrowser、Workflow、PushNotification 等。
- ANT-only stub：Tungsten、REPL、SuggestBackgroundPR。
- 移除 / 简化：Computer Use（`@ant/*`）、多数 `*-napi` 包（audio/image/url/modifiers —— 仅 `color-diff-napi` 完整实现）、Analytics / GrowthBook / Sentry（空实现）、Magic Docs / Voice Mode / LSP server、Plugins / Marketplace、MCP OAuth（简化）。

### 斜杠命令
已实现数十个：`/add-dir`、`/agents`、`/branch`、`/clear`、`/compact`、`/config`、`/context`、`/cost`、`/doctor`、`/effort`、`/export`、`/fast`、`/goal`、`/help`、`/init`、`/login`、`/mcp`、`/memory`、`/model`、`/permissions`、`/resume`、`/review`、`/status`、`/todo` 等。

### MCP
通过 Model Context Protocol 接入外部工具（`--mcp-config`、`.mcp.json`）。OAuth 流程已简化。

## 从源码构建

需要 [Bun](https://bun.sh/) >= 1.3.11。

```bash
bun install
bun run dev          # 从源码运行；版本号显示 2.1.286（dev polyfill；build 用 pkg.version 覆盖）即正常
bun run build        # 产物：dist/cli.js（~26MB，5300+ 模块，单文件 bundle）
bun test             # 测试套件
bun run lint         # Biome lint（禁用格式化以避免大 diff）
```

更详细的架构、入口/启动、工具系统、UI 层、模块状态说明见 [CLAUDE.md](./CLAUDE.md)。

## 项目结构

```
src/entrypoints/cli.tsx   # 真正的入口（运行时 polyfill、宏）
src/main.tsx              # Commander CLI 定义
src/query.ts              # 主 API 查询循环
src/QueryEngine.ts        # 会话编排
src/screens/REPL.tsx      # 交互式 REPL 屏幕
src/services/api/         # API 客户端（Anthropic / Bedrock / Vertex / Azure）
src/tools/<Name>/         # 每个工具一个目录
src/ink/                  # 自研 Ink 框架
packages/                 # workspace stub（@ant/*、*-napi）
```

## 许可证

MIT 许可证 — 详见 [LICENSE](./LICENSE)。