versun/claude-code
1
0
Fork 0
mirror of https://github.com/claude-code-best/claude-code.git synced 2026-06-18 06:15:51 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
95fece4b512a40f71c2ebb0ad1d8fd2e957d4bbb
claude-code/docs/internals/internal-restrictions-code-audit.md
unraid 95fece4b51 feat: 整合功能恢复与技能学习闭环(含 ECC v2.1 parity + Opus 4.7 接入 + prompt 工程优化) 
主要变更:
- Skill Learning 闭环系统 (9/9 AC)
- Opus 4.7 模型层接入 + adaptive thinking
- Prompt 工程优化 (64 审计测试)
- Agent Teams 简化门控 (默认启用)
- Windows Terminal 后端修复 (EncodedCommand/WT_SESSION)
- TF-IDF 技能搜索精准化 (字段加权/CJK 优化)
- Autonomy 系统 (/autonomy 命令)
- ACP 协议完整实现
- mock.module 泄漏修复 (CI 全绿)
- 152+ lint/type 修复
2026-04-22 16:07:42 +08:00

433 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 内部限制与可解锁能力代码审计
更新时间：2026-04-15
## 目的
这份文档只基于源码做判断，回答三个问题：
1. 哪些能力是真正的 `ant-only`
2. 哪些能力其实已经对 `Claude.ai` 订阅用户可用
3. 哪些能力看起来有入口，但实际上还缺实现，不能靠开开关直接解锁
这份文档不再把“依赖 Anthropic first-party / Claude.ai / OAuth”直接等同于“内部功能”。
对当前仓库，更准确的分类是：
- `ant-only`
- `subscriber-available`
- `subscriber-remote`
- `available-in-build`
- `stub/incomplete`
## 执行摘要
### 已经基本可用
下面这些从当前源码看，不该再归类为“内部功能”：
- `assistant`
- `brief`
- `proactive`
- `voice`
- `chrome` / Claude in Chrome
原因：
- 它们不是 `USER_TYPE==='ant'` 才能注册
- 其中多条路径已经在默认 build 中编入
- 它们的主要门槛是 `Claude.ai` 订阅、OAuth、环境依赖，而不是内部员工身份
### 可用，但依赖远端专有基础设施
下面这些不是 stub，也不是纯 ant-only，但它们的执行面依赖远端服务：
- `ultraplan`
- `ultrareview`
- `remote-env`
- `settings sync`
- `team memory sync`
- `mcp channels`
它们应归类为：
- `subscriber-remote`
- 或 `first-party-only`
### 源码完整，且已纳入默认 build
下面这些能力从代码主体看是完整的，而且现在已经补进默认 build：
- `DIRECT_CONNECT`
- `UDS_INBOX`
- `BRIDGE_MODE`
这类能力应归类为：
- `available-in-build`
### 不能靠开关直接解锁
下面这些当前不是 gate 问题，而是实现本身缺失或明确是 stub：
- `REPLTool`
- `TungstenTool`
- `useMoreRight`
这类应归类为：
- `stub/incomplete`
## 重点功能矩阵
| 功能 | 当前状态 | 面向人群 | 当前阻断点 | 结论 |
| --- | --- | --- | --- | --- |
| `assistant` | 代码完整，默认 build 已编入 | 订阅用户 / 1P 用户 | 依赖 `KAIROS` 和 runtime gate | `subscriber-available` |
| `brief` | 代码完整，默认 build 已编入 | 订阅用户 / 1P 用户 | 依赖 entitlement / runtime config | `subscriber-available` |
| `proactive` | 代码完整，状态机完整 | 订阅用户 / 1P 用户 | 依赖 `PROACTIVE` 或 `KAIROS` 路径 | `subscriber-available` |
| `voice` | 代码完整 | `Claude.ai` 订阅用户 | 需要 OAuth、麦克风、音频依赖 | `subscriber-available` |
| `chrome` | 代码完整 | `Claude.ai` 订阅用户 | 需要订阅、扩展、非 WSL 等环境条件 | `subscriber-available` |
| `ultraplan` | 代码完整 | 订阅用户 / 1P 用户 | 依赖远端环境、策略、远端 session API | `subscriber-remote` |
| `ultrareview` | 代码完整 | 订阅用户 / 1P 用户 | 依赖远端 code review 环境与配额接口 | `subscriber-remote` |
| `DIRECT_CONNECT` | 代码完整 | 本地用户 | 默认 build 已启用；仍需显式使用 server/open 路径 | `available-in-build` |
| `UDS_INBOX` | 代码完整 | 本地用户 | 默认 build 已启用；仍需通过 peers/pipes/send 等入口使用 | `available-in-build` |
| `BRIDGE_MODE` | 代码完整 | 订阅用户 / self-hosted 用户 | 默认 build 已启用；官方路径仍有 entitlement / OAuth 条件 | `available-in-build` |
| `REPLTool` | Tool 外壳存在 | ant-native 运行时 | 当前 `call()` 明确返回不可用 | `stub/incomplete` |
| `TungstenTool` | 空壳 stub | 无 | 缺真实实现 | `stub/incomplete` |
| `useMoreRight` | external stub | 无 | real hook 缺失 | `stub/incomplete` |
## 分类规则
### `ant-only`
满足以下任一条件即可归入：
- 命令或工具只在 `USER_TYPE==='ant'` 时注册
- 外部构建在 parse / runtime 阶段直接拒绝
- 源码注释或逻辑明确说明只为内部用户设计
典型对象：
- `INTERNAL_ONLY_COMMANDS`
- `/files`
- `/tag`
- `/version`
- `/bridge-kick`
- agent `remote` isolation
- ant-only bundled skills
### `subscriber-available`
满足以下条件：
- 不要求 `USER_TYPE==='ant'`
- 对 `Claude.ai` 订阅用户是正经产品面
- 不需要额外补一个缺失运行时才能工作
典型对象：
- `assistant`
- `brief`
- `proactive`
- `voice`
- `chrome`
### `subscriber-remote`
满足以下条件：
- 面向订阅用户或 first-party OAuth 用户
- 本地入口完整
- 但真正执行依赖远端环境、远端 session API、策略或配额系统
典型对象：
- `ultraplan`
- `ultrareview`
- `remote-env`
### `available-in-build`
满足以下条件：
- 源码主体完整
- 默认 build 已经编入
- 运行时可能仍有订阅、OAuth、配置或显式命令入口要求
典型对象：
- `DIRECT_CONNECT`
- `UDS_INBOX`
- `BRIDGE_MODE`
### `stub/incomplete`
满足以下条件：
- 当前仓库里的实现明确是 stub
- 或关键执行引擎缺失
- 去掉 gate 之后仍然不会真正工作
典型对象：
- `REPLTool`
- `TungstenTool`
- `useMoreRight`
## 重点功能说明
### `assistant`
`assistant` 当前应视为“已经基本可用”，而不是“待恢复”。
原因：
- 默认 build 包含 `KAIROS`
- 命令 gate 只检查 `feature('KAIROS')` 和 `tengu_kairos_assistant`
- 本地 GrowthBook 默认值里 `tengu_kairos_assistant` 为 `true`
结论：
- `assistant` 是 `subscriber-available`
### `brief`
`brief` 当前也应视为“已经基本可用”。
原因：
- 默认 build 包含 `KAIROS_BRIEF`
- 命令逻辑完整
- `BriefTool` 逻辑完整
- 本地 GrowthBook 默认值中：
- `tengu_kairos_brief = true`
- `tengu_kairos_brief_config.enable_slash_command = true`
结论：
- `brief` 是 `subscriber-available`
### `proactive`
`proactive` 也是当前基本可用，而不是未恢复。
原因：
- 命令逻辑完整
- `src/proactive/index.ts` 有完整状态机
- `SleepTool` 已经挂接 proactive 状态
- 即使 `PROACTIVE` build flag 没默认开，只要 `KAIROS` 路径存在，命令仍可用
结论：
- `proactive` 是 `subscriber-available`
### `ultraplan`
`ultraplan` 不是 stub，也不是 ant-only。
原因：
- 默认 build 已编入 `ULTRAPLAN`
- 命令真实存在
- prompt 里还能自动触发 `/ultraplan`
但它不是纯本地能力，因为它依赖：
- `teleportToRemote()`
- 远端 eligibility
- 远端环境
- 组织策略
- Claude Code on the web session
结论：
- `ultraplan` 是 `subscriber-remote`
### `REPLTool`
`REPLTool` 不应被归到“可解锁，只差开关”。
原因：
- `call()` 里直接写明当前 build 不可用
- 注释明确说 REPL execution engine 由 ant-native runtime 提供
结论：
- `REPLTool` 是 `stub/incomplete`
### `DIRECT_CONNECT`
`DIRECT_CONNECT` 的 server/open/headless/client 链路是完整的。
当前状态：
- dev 默认开启
- 默认 build 也已启用
结论：
- `DIRECT_CONNECT` 是 `available-in-build`
- 现在不再是 build 阻断项
### `UDS_INBOX`
`UDS_INBOX` 的命令、hooks、tools 都在。
当前状态：
- dev 默认开启
- 默认 build 也已启用
结论：
- `UDS_INBOX` 是 `available-in-build`
### `BRIDGE_MODE`
`BRIDGE_MODE` 的主流程不是 stub。
当前状态：
- 默认 build 已启用
- 官方路径需要订阅/OAuth/entitlement
- self-hosted 路径能绕过一部分官方 gate
结论：
- `BRIDGE_MODE` 是 `available-in-build`
- 如果目标是先验证能力，自托管路径比官方 bridge 更现实
## 真正的 ant-only 范围
下面这些仍然应当稳稳归入 `ant-only`：
- `INTERNAL_ONLY_COMMANDS`
- `/files`
- `/tag`
- `/version`
- `/bridge-kick`
- ant-only 工具注入：
- `ConfigTool`
- `TungstenTool`
- `REPLTool`
- `SuggestBackgroundPRTool`
- agent `remote` isolation
- ant-only bundled skills：
- `verify`
- `remember`
- `stuck`
- `skillify`
这些不是订阅用户能力。
## 对逆向恢复的优先级建议
### 第一优先级
- `REPLTool`
- `TungstenTool`
- `useMoreRight`
原因：
- 这三项才是真正的实现缺口
- build 侧阻断已经不再是当前最主要问题
### 第二优先级
- 梳理 `assistant / brief / proactive / DIRECT_CONNECT / UDS_INBOX / BRIDGE_MODE` 的实际交付面
- 确认哪些该进入默认发布、哪些仍保留实验属性
原因：
- 这些能力很多已经能跑
- 更需要的是收敛发布策略和文档口径
## 附录：关键代码证据
### 订阅用户判定
- `src/utils/auth.ts:100`
- `src/utils/auth.ts:1560`
- `src/utils/auth.ts:1576`
- `src/utils/auth.ts:1679`
- `src/utils/auth.ts:1690`
### `assistant / brief / proactive`
- `src/commands/assistant/gate.ts:11`
- `src/commands/brief.ts:44`
- `src/commands/proactive.ts:14`
- `src/proactive/index.ts:37`
- `packages/builtin-tools/src/tools/BriefTool/BriefTool.ts:126`
- `packages/builtin-tools/src/tools/SleepTool/SleepTool.ts:22`
- `src/services/analytics/growthbook.ts:455`
- `src/services/analytics/growthbook.ts:469`
- `build.ts:28`
- `build.ts:40`
### `ultraplan`
- `src/commands/ultraplan.tsx:377`
- `src/commands/ultraplan.tsx:396`
- `src/commands/ultraplan.tsx:536`
- `src/utils/processUserInput/processUserInput.ts:470`
- `src/utils/teleport.tsx:818`
- `src/utils/background/remote/preconditions.ts:45`
- `build.ts:30`
### `DIRECT_CONNECT`
- `src/main.tsx:4728`
- `src/main.tsx:4846`
- `src/server/createDirectConnectSession.ts:26`
- `src/server/connectHeadless.ts:21`
- `src/server/sessionManager.ts:21`
- `src/server/backends/dangerousBackend.ts:14`
- `scripts/dev.ts:58`
### `UDS_INBOX`
- `src/commands.ts:122`
- `src/hooks/usePipeIpc.ts:458`
- `src/tools.ts:145`
- `packages/builtin-tools/src/tools/SendMessageTool/SendMessageTool.ts:520`
- `scripts/dev.ts:46`
- `build.ts:39`
### `BRIDGE_MODE`
- `src/commands/bridge/index.ts:6`
- `src/bridge/bridgeMain.ts:2002`
- `src/bridge/bridgeEnabled.ts:29`
- `src/bridge/bridgeEnabled.ts:32`
- `src/bridge/bridgeEnabled.ts:57`
- `src/bridge/bridgeEnabled.ts:82`
- `scripts/dev.ts:27`
### `REPLTool`
- `packages/builtin-tools/src/tools/REPLTool/REPLTool.ts:78`
- `packages/builtin-tools/src/tools/REPLTool/REPLTool.ts:84`
### `stub / incomplete`
- `src/moreright/useMoreRight.tsx:1`
- `packages/builtin-tools/src/tools/TungstenTool/TungstenTool.ts:1`
- `packages/builtin-tools/src/tools/WebBrowserTool/WebBrowserPanel.ts:1`
### `ant-only`
- `src/commands.ts:267`
- `src/commands.ts:400`
- `src/commands/version.ts:17`
- `src/commands/files/index.ts:7`
- `src/commands/tag/index.ts:7`
- `src/commands/bridge-kick.ts:195`
- `src/tools.ts:235`
- `src/tools.ts:253`
- `packages/builtin-tools/src/tools/AgentTool/loadAgentsDir.ts:607`
- `packages/builtin-tools/src/tools/AgentTool/AgentTool.tsx:669`
Reference in New Issue View Git Blame Copy Permalink