Skip to content

Commit c8e5a3d

Browse files
JL-RogerJL-Roger
committed
add feature completeness section to README (en/cn)
1 parent 8681fbc commit c8e5a3d

2 files changed

Lines changed: 152 additions & 8 deletions

File tree

‎README.md‎

Lines changed: 76 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -158,14 +158,86 @@ claude-code/
158158

159159
---
160160

161+
## Feature Completeness
162+
163+
### Core Tools — All Working ✅
164+
165+
| Tool | Description |
166+
|------|-------------|
167+
| BashTool | Shell command execution |
168+
| FileReadTool | File reading (images, PDFs, notebooks) |
169+
| FileWriteTool | File creation / overwrite |
170+
| FileEditTool | Partial file modification |
171+
| GlobTool | File pattern matching |
172+
| GrepTool | ripgrep-based content search |
173+
| WebFetchTool | Fetch URL content |
174+
| WebSearchTool | Web search |
175+
| AgentTool | Sub-agent spawning |
176+
| SkillTool | Skill execution |
177+
| NotebookEditTool | Jupyter notebook editing |
178+
| AskUserQuestionTool | Interactive prompts |
179+
| MCPTool | MCP server tool invocation |
180+
| ListMcpResourcesTool / ReadMcpResourceTool | MCP resource access |
181+
182+
### Conditionally Enabled Tools
183+
184+
| Tool | Condition | Status |
185+
|------|-----------|--------|
186+
| LSPTool | Set `ENABLE_LSP_TOOL=true` | Works |
187+
| PowerShellTool | Windows environment | Works |
188+
| EnterWorktreeTool / ExitWorktreeTool | Config enabled | Works |
189+
| TaskCreateTool / TaskGetTool / TaskUpdateTool / TaskListTool | Config enabled | Works |
190+
| TeamCreateTool / TeamDeleteTool | Agent Swarms config | Works |
191+
| ToolSearchTool | Config enabled | Works |
192+
193+
### Disabled Internal Features (80+ feature flags off)
194+
195+
These Anthropic-internal experimental features are disabled via `feature()` flags and do not affect core CLI usage:
196+
197+
| Feature | Impact |
198+
|---------|--------|
199+
| Voice Mode (`VOICE_MODE`) | Voice input unavailable |
200+
| Proactive Mode (`PROACTIVE`) | SleepTool, proactive alerts unavailable |
201+
| Agent Swarms (`TEAMMEM`, `BG_SESSIONS`) | Multi-agent coordination unavailable |
202+
| Cron Scheduling (`AGENT_TRIGGERS`) | Scheduled triggers unavailable |
203+
| Computer Use (`CHICAGO_MCP`) | Desktop automation unavailable — requires Anthropic internal native modules |
204+
| Claude in Chrome (`CHICAGO_MCP`) | Browser integration unavailable |
205+
| KAIROS (`KAIROS`) | Anthropic internal assistant mode unavailable |
206+
| Transcript Classifier (`TRANSCRIPT_CLASSIFIER`) | Auto permission classification unavailable |
207+
208+
### Stub Tools (auto-filtered, zero runtime impact)
209+
210+
| Tool | Reason |
211+
|------|--------|
212+
| REPLTool | Gated behind `USER_TYPE=ant` |
213+
| SuggestBackgroundPRTool | Gated behind `USER_TYPE=ant` |
214+
| VerifyPlanExecutionTool | Gated behind `CLAUDE_CODE_VERIFY_PLAN` |
215+
| WorkflowTool | Gated behind `feature('WORKFLOW_SCRIPTS')` |
216+
| TungstenTool | Gated behind `USER_TYPE=ant` |
217+
218+
### Missing Internal Packages (no runtime impact)
219+
220+
All `@ant/*` package references are behind `feature()` guards and tree-shaken at build time:
221+
222+
| Package | Purpose | Impact |
223+
|---------|---------|--------|
224+
| `@ant/claude-for-chrome-mcp` | Chrome browser MCP | None — dead code |
225+
| `@ant/computer-use-mcp` | Computer Use MCP | None — dead code |
226+
| `@ant/computer-use-input` | Mouse/keyboard control | None — dead code |
227+
| `@ant/computer-use-swift` | macOS native screenshots | None — dead code |
228+
| `@anthropic-ai/claude-agent-sdk` | SDK type reference | None — `import type` only |
229+
230+
**Summary: All core CLI functionality (file ops, commands, search, API calls, MCP) works. Missing features are Anthropic-internal experiments not available in the official release either.**
231+
232+
---
233+
161234
## Known Limitations
162235

163236
1. **TUI requires a real terminal** — silent exit in pipes or non-TTY environments
164237
2. **API key required** — `ANTHROPIC_API_KEY` must be set for actual queries
165-
3. **Some tools are stubs** — REPLTool, WorkflowTool, etc. have empty implementations
166-
4. **macOS Keychain** — falls back to plaintext file on Linux
167-
5. **Sandbox on WSL2** — requires `apt install bubblewrap socat` for sandbox features
168-
6. **Commander.js patch** — multi-character short flags (`-d2e`) need a manual patch to `node_modules` after each `bun install`
238+
3. **macOS Keychain** — falls back to plaintext file on Linux
239+
4. **Sandbox on WSL2** — requires `apt install bubblewrap socat` for sandbox features
240+
5. **Commander.js patch** — multi-character short flags (`-d2e`) need a manual patch to `node_modules` after each `bun install`
169241

170242
---
171243

‎README_CN.md‎

Lines changed: 76 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -158,14 +158,86 @@ claude-code/
158158

159159
---
160160

161+
## 功能完备性
162+
163+
### 核心工具 — 全部正常 ✅
164+
165+
| 工具 | 用途 |
166+
|------|------|
167+
| BashTool | 命令行执行 |
168+
| FileReadTool | 文件读取（图片、PDF、Notebook） |
169+
| FileWriteTool | 文件创建/覆盖 |
170+
| FileEditTool | 文件局部修改 |
171+
| GlobTool | 文件模式匹配 |
172+
| GrepTool | ripgrep 内容搜索 |
173+
| WebFetchTool | URL 内容抓取 |
174+
| WebSearchTool | 网页搜索 |
175+
| AgentTool | 子 Agent 调用 |
176+
| SkillTool | Skill 执行 |
177+
| NotebookEditTool | Jupyter Notebook 编辑 |
178+
| AskUserQuestionTool | 交互式提问 |
179+
| MCPTool | MCP 服务器工具调用 |
180+
| ListMcpResourcesTool / ReadMcpResourceTool | MCP 资源访问 |
181+
182+
### 有条件启用的工具
183+
184+
| 工具 | 启用条件 | 状态 |
185+
|------|----------|------|
186+
| LSPTool | 设置 `ENABLE_LSP_TOOL=true` | ✅ 可用 |
187+
| PowerShellTool | Windows 环境 | ✅ 可用 |
188+
| EnterWorktreeTool / ExitWorktreeTool | 配置开启 | ✅ 可用 |
189+
| TaskCreateTool 等 4 个 | 配置开启 | ✅ 可用 |
190+
| TeamCreateTool / TeamDeleteTool | Agent Swarms 配置 | ✅ 可用 |
191+
| ToolSearchTool | 配置开启 | ✅ 可用 |
192+
193+
### 关闭的内部功能（80+ 个 feature flag）
194+
195+
以下 Anthropic 内部实验性功能通过 `feature()` 标志关闭，不影响核心 CLI 使用：
196+
197+
| 功能 | 影响 |
198+
|------|------|
199+
| Voice Mode（`VOICE_MODE`） | 语音输入不可用 |
200+
| Proactive Mode（`PROACTIVE`） | SleepTool、主动提醒不可用 |
201+
| Agent Swarms（`TEAMMEM`、`BG_SESSIONS`） | 多 Agent 协调不可用 |
202+
| Cron 调度（`AGENT_TRIGGERS`） | 定时触发器不可用 |
203+
| Computer Use（`CHICAGO_MCP`） | 桌面自动化不可用 — 需要 Anthropic 内部原生模块 |
204+
| Claude in Chrome（`CHICAGO_MCP`） | 浏览器集成不可用 |
205+
| KAIROS（`KAIROS`） | Anthropic 内部助手模式不可用 |
206+
| Transcript Classifier（`TRANSCRIPT_CLASSIFIER`） | 自动权限分类不可用 |
207+
208+
### Stub 工具（自动过滤，零运行时影响）
209+
210+
| 工具 | 原因 |
211+
|------|------|
212+
| REPLTool | `USER_TYPE=ant` 条件不满足 |
213+
| SuggestBackgroundPRTool | `USER_TYPE=ant` 条件不满足 |
214+
| VerifyPlanExecutionTool | `CLAUDE_CODE_VERIFY_PLAN` 未设置 |
215+
| WorkflowTool | `feature('WORKFLOW_SCRIPTS')` 返回 false |
216+
| TungstenTool | `USER_TYPE=ant` 条件不满足 |
217+
218+
### 缺失的内部包（无运行时影响）
219+
220+
所有 `@ant/*` 包引用都在 `feature()` 守卫的 dead code 分支内，编译时被完全剔除：
221+
222+
| 包 | 用途 | 影响 |
223+
|------|------|------|
224+
| `@ant/claude-for-chrome-mcp` | Chrome 浏览器 MCP | 无 — dead code |
225+
| `@ant/computer-use-mcp` | Computer Use MCP | 无 — dead code |
226+
| `@ant/computer-use-input` | 鼠标/键盘控制 | 无 — dead code |
227+
| `@ant/computer-use-swift` | macOS 原生截图 | 无 — dead code |
228+
| `@anthropic-ai/claude-agent-sdk` | SDK 类型引用 | 无 — 仅 `import type` |
229+
230+
**总结：所有核心 CLI 功能（文件操作、命令执行、搜索、API 调用、MCP 集成）均可正常使用。缺失的功能均为 Anthropic 内部实验性功能，在官方公开版本中同样不存在。**
231+
232+
---
233+
161234
## 已知限制
162235

163236
1. **TUI 需要真实终端** — 管道或非 TTY 环境下静默退出
164237
2. **需要 API key** — 实际对话必须设置 `ANTHROPIC_API_KEY`
165-
3. **部分工具是 stub** — REPLTool、WorkflowTool 等为空实现
166-
4. **macOS Keychain** — Linux 上回退到明文文件存储
167-
5. **WSL2 沙箱** — 需要 `apt install bubblewrap socat` 才能使用沙箱功能
168-
6. **Commander.js 补丁** — 多字符短标志（`-d2e`）每次 `bun install` 后需手动修补 `node_modules`
238+
3. **macOS Keychain** — Linux 上回退到明文文件存储
239+
4. **WSL2 沙箱** — 需要 `apt install bubblewrap socat` 才能使用沙箱功能
240+
5. **Commander.js 补丁** — 多字符短标志（`-d2e`）每次 `bun install` 后需手动修补 `node_modules`
169241

170242
---
171243

0 commit comments

Comments
 (0)