diff --git a/docs/comparison/qwen-code-improvement-report-p0-p1-engine.md b/docs/comparison/qwen-code-improvement-report-p0-p1-engine.md index 8b40400d..2d23df27 100644 --- a/docs/comparison/qwen-code-improvement-report-p0-p1-engine.md +++ b/docs/comparison/qwen-code-improvement-report-p0-p1-engine.md @@ -909,3 +909,90 @@ Claude Code 在系统提示中覆盖了 4 个关键领域，每个都有具体 **意义**：系统提示是模型行为的根基——缺少具体指导则模型按自己的"默认模式"行事。 **缺失后果**：无 OWASP 列表 = 模型可能写出 SQL 注入代码；无注入检测 = MCP 恶意结果被信任执行。 **改进收益**：具体指导 = 模型行为精确可控——安全漏洞/注入攻击/代码膨胀全部防护。 + +--- + + + +### 25. 系统提示模块化（P1） + +Claude Code 将系统提示设计为 **sections 缓存 + dynamic boundary** 架构。系统提示不是单一字符串，而是由多个独立 section 拼装而成，每个 section 有自己的缓存策略和失效规则： + +| Section 类型 | 缓存策略 | 失效条件 | 示例 | +|:------------:|----------|----------|------| +| Static | 会话级缓存 | `/clear` 或 `/compact` | 核心行为准则、工具定义 | +| Dynamic | 每轮重新计算 | 每轮 | git 状态、token 用量 | +| Uncached | 强制不缓存 | N/A | 用户自定义指令 | + +Claude Code 使用 `systemPromptSection(name, compute)` 创建可缓存 section，计算一次直到失效；`DANGEROUS_uncachedSystemPromptSection(name, compute, reason)` 创建每轮强制重新计算的 volatile section（带 `cacheBreak: true` 标记）。`buildSystemPromptBlocks()` 使用 prompt caching 机制将 sections 作为独立 block 可独立缓存。 + +**Qwen Code 现状**：系统提示通过 `getMainSessionSystemInstruction()` 拼接（instruction + memory + append），单一字符串，无 sections 缓存机制，无 dynamic boundary 概念。每轮全量重新构建。 + +**Claude Code 源码索引**： + +| 文件 | 关键函数/常量 | +|------|-------------| +| `constants/systemPromptSections.ts` | `systemPromptSection()`、`DANGEROUS_uncachedSystemPromptSection()` | +| `constants/prompts.ts` (915行) | 各 section 定义 | +| `services/api/claude.ts` (3419行) | `buildSystemPromptBlocks()` | + +**Qwen Code 修改方向**：`prompts.ts` 改为 sections 架构；静态段（行为准则、工具定义）缓存到会话级；动态段（git 状态、token 用量）每轮重新计算；使用 `cache_control` 标记静态段末端实现 prompt cache 优化。 + +**实现成本评估**： +- 涉及文件：~3 个 +- 新增代码：~300 行 +- 开发周期：~3 天（1 人） +- 难点：section 缓存失效策略设计 + +**改进前后对比**： +- **改进前**：每轮重新构建完整系统提示（~5K token）→ API 调用中重复发送 +- **改进后**：静态段缓存 + dynamic boundary → prompt cache 命中率提升 80%+ → 节省 token 费用 + +**意义**：系统提示是每轮 API 调用必发的固定开销，模块化 + 缓存可大幅降低 token 成本。 +**缺失后果**：每轮全量发送系统提示 → 浪费 token → 增加费用。 +**改进收益**：sections 缓存 → 静态段只发一次 → prompt cache 命中率提升 → 节省费用。 + +--- + +--- + + + +### 26. 系统提示模块化（P1） + +**问题**：系统提示是每轮 API 调用必发的固定开销（~5K token），全量发送浪费 token。Claude Code 把系统提示设计为 sections 缓存 + dynamic boundary 架构——静态段只发一次，动态段每轮重新计算。 + +**关键设计细节**： + +- **3 种 Section 类型**： + - Static（会话级缓存）：核心行为准则、工具定义，`/clear` 或 `/compact` 时失效 + - Dynamic（每轮重新计算）：git 状态、token 用量，带 `cacheBreak: true` 标记 + - Uncached（强制不缓存）：用户自定义指令 +- **缓存 API**：`systemPromptSection(name, compute)` 创建可缓存 section；`DANGEROUS_uncachedSystemPromptSection(name, compute, reason)` 创建每轮强制重算 section +- **Prompt Cache 集成**：`buildSystemPromptBlocks()` 使用 `cache_control` 标记静态段末端，实现 API 级缓存 + +**Claude Code 源码索引**： + +| 文件 | 关键函数/常量 | +|------|-------------| +| `constants/systemPromptSections.ts` | `systemPromptSection()`、`DANGEROUS_uncachedSystemPromptSection()` | +| `constants/prompts.ts` (915行) | 各 section 定义 | +| `services/api/claude.ts` (3419行) | `buildSystemPromptBlocks()` | + +**Qwen Code 现状**：系统提示通过 `getMainSessionSystemInstruction()` 拼接（instruction + memory + append），单一字符串，无 sections 缓存机制，无 dynamic boundary 概念。每轮全量重新构建。 + +**Qwen Code 修改方向**：① `prompts.ts` 改为 sections 架构；② 静态段（行为准则、工具定义）缓存到会话级；③ 动态段（git 状态、token 用量）每轮重新计算；④ 使用 `cache_control` 标记静态段末端实现 prompt cache 优化。 + +**实现成本评估**： +- 涉及文件：~3 个 +- 新增代码：~300 行 +- 开发周期：~3 天（1 人） +- 难点：section 缓存失效策略设计 + +**相关文章**：[系统提示模块化 Deep-Dive](./system-prompt-modularization-deep-dive.md) + +**意义**：系统提示是每轮 API 调用必发的固定开销，模块化 + 缓存可大幅降低 token 成本。 +**缺失后果**：每轮全量发送系统提示 → 浪费 token → 增加费用。 +**改进收益**：sections 缓存 → 静态段只发一次 → prompt cache 命中率提升 → 节省费用。 + +--- diff --git a/docs/comparison/qwen-code-improvement-report-p2-core.md b/docs/comparison/qwen-code-improvement-report-p2-core.md index 8a1b98ae..3f6b236a 100644 --- a/docs/comparison/qwen-code-improvement-report-p2-core.md +++ b/docs/comparison/qwen-code-improvement-report-p2-core.md @@ -947,3 +947,331 @@ Subagent 启动 → 计时器开始 → 超过阈值 → 自动转后台 → 释 **改进收益**：固定高度 Footer——最大化内容区域，小终端也舒适。 --- + +--- + + + +### 25. 会话标签与搜索（P2） + +**问题**：用户长期使用 Agent 会积累大量会话（几十甚至上百个），只能按时间顺序浏览。想找之前某个功能（如"重构"、"登录 bug"）的会话，需要逐条翻看标题。Claude Code 的 `/tag` 命令支持为会话打标签，按标签/repo/标题搜索。 + +**Claude Code 源码索引**： + +| 文件 | 关键函数/常量 | +|------|-------------| +| `commands/tag/tag.tsx` (189行) | `/tag add`、`/tag remove`、`/tag list`、`/tag search` | +| `utils/sessionStorage.ts` | `saveTag()`、`loadTags()`、`searchSessionsByTag()` | + +**Qwen Code 现状**：`sessionService.ts` 仅有 `listSessions()`（按 mtime 排序）和 `loadLastSession()`，无标签系统。 + +**Qwen Code 修改方向**：① `ChatSession` 接口新增 `tags: string[]` 字段；② 新增 `searchByTags()` 方法；③ 新建 `/tag` 命令。 + +**实现成本评估**： +- 涉及文件：~3 个 +- 新增代码：~150 行 +- 开发周期：~1 天（1 人） +- 难点：标签持久化存储格式（建议 JSONL 每行追加） + +**意义**：长期项目积累大量会话，按标签快速定位。 +**缺失后果**：只能按时间排序，无法按主题/功能分类。 +**改进收益**：标签搜索 = 快速定位历史会话。 + +--- + + + +### 26. @include 指令（P2） + +**问题**：团队规范（CLAUDE.md/AGENTS.md）随着项目增长可能变成巨型单文件（500+ 行），难以维护。Claude Code 支持 `@path` 递归引用其他文件，最大深度 5 层，外部文件需用户审批。 + +**关键设计细节**： + +- **正则匹配**：`/(?:^|\s)@((?:[^\s\\]|\\ )+)/g` — 支持 `@path`、`@./path`、`@~/path` +- **最大深度**：`MAX_INCLUDE_DEPTH = 5` — 防止循环引用 +- **外部文件审批**：不在原始 cwd 目录下的文件需弹窗审批 +- **文本类型白名单**：40+ 种扩展名（`.md`、`.txt`、`.js`、`.ts` 等） +- **循环引用防护**：`processedPaths` Set 去重 + +**Claude Code 源码索引**： + +| 文件 | 关键函数/常量 | +|------|-------------| +| `utils/claudemd.ts` (1480行) | `processMemoryFile()`、`extractIncludePathsFromTokens()`、`MAX_INCLUDE_DEPTH` | + +**Qwen Code 现状**：指令加载器直接读取 CLAUDE.md/AGENTS.md 全文，无 `@include` 解析。 + +**Qwen Code 修改方向**：① 指令加载器新增 `@path` 正则解析；② 递归加载（深度限制 5）；③ 外部文件审批对话框；④ 文本类型白名单过滤。 + +**实现成本评估**： +- 涉及文件：~3 个 +- 新增代码：~200 行 +- 开发周期：~2 天（1 人） +- 难点：外部文件审批流程与现有权限系统集成 + +**意义**：团队规范可模块化复用，避免巨型单文件。 +**缺失后果**：所有指令堆在一个文件中，难以维护。 +**改进收益**：模块化指令 = 可复用 + 可组合。 + +--- + + + +### 27. 附件协议（P2） + +**问题**：Agent 每轮对话会注入大量附件（IDE 选区、诊断信息、记忆、Hook 输出等），如果不加控制可能撑爆上下文窗口。Claude Code 定义 60+ 附件类型，每类独立 token 预算，3 阶段有序执行。 + +**关键设计细节**： + +- **60+ 附件类型**：文件（file/compact_file_reference/pdf_reference）、IDE（selected_lines_in_ide/opened_file_in_ide）、内存（nested_memory/relevant_memories）、Hook（hook_blocking_error/hook_success）、Agent（agent_mention/teammate_mailbox）等 +- **Per-type 预算**：`MAX_MEMORY_LINES = 200`、`MAX_MEMORY_BYTES = 4096`、`RELEVANT_MEMORIES_CONFIG.MAX_SESSION_BYTES = 60KB` +- **3 阶段有序执行**：① userInput 附件 → ② thread 附件 → ③ queuedCommand 附件 +- **媒体上限**：`API_MAX_MEDIA_PER_REQUEST = 100` + +**Claude Code 源码索引**： + +| 文件 | 关键函数/常量 | +|------|-------------| +| `utils/attachments.ts` (3998行) | 60+ AttachmentType 定义、`getAttachments()` 3 阶段流程 | +| `constants/apiLimits.ts` | `API_MAX_MEDIA_PER_REQUEST = 100` | +| `utils/tokenBudget.ts` | per-type 预算配置 | + +**Qwen Code 现状**：无附件类型注册表，所有附件统一处理，无 per-type 预算控制。 + +**Qwen Code 修改方向**：① 新增 `AttachmentType` 枚举；② 新增预算配置；③ 收集附件时按预算截断；④ 3 阶段有序执行。 + +**实现成本评估**： +- 涉及文件：~4 个 +- 新增代码：~300 行 +- 开发周期：~3 天（1 人） +- 难点：预算配置与实际 token 计算的精确对齐 + +**意义**：精细控制各类附件的 token 消耗，防止单一类型溢出。 +**缺失后果**：无预算控制 = 附件可能撑爆上下文窗口。 +**改进收益**：per-type 预算 = 可控 token 用量。 + +--- + + + +### 28. Git 状态自动注入（P2） + +**问题**：模型不知道自己在哪个分支、项目规模多大，可能给错命令（如在 feature 分支上执行 merge）。Claude Code 每轮自动注入 gitBranch/cwd/platform/fileCount 到系统提示。 + +**Claude Code 源码索引**： + +| 文件 | 关键函数/常量 | +|------|-------------| +| `utils/api.ts` | `countFilesRoundedRg()` — rg 扫描项目返回约数 | +| `constants/prompts.ts` | uncached section 中注入 git 状态 | + +**Qwen Code 现状**：`getGitBranch()` 和 `geminiMdFileCount` 仅用于统计，不注入到系统提示。模型需自行执行 `git status` 获取。 + +**Qwen Code 修改方向**：`prompts.ts` 系统提示中新增动态段注入 git 状态（每轮重新计算）。 + +**实现成本评估**： +- 涉及文件：~2 个 +- 新增代码：~50 行 +- 开发周期：~0.5 天（1 人） +- 难点：fileCount 计算性能（建议复用 rg 结果） + +**意义**：模型始终知道当前分支和项目规模。 +**缺失后果**：模型不知道自己在哪个分支，可能给错命令。 +**改进收益**：每轮自动注入 = 模型感知上下文。 + +--- + + + +### 29. IDE 诊断注入（P2） + +**问题**：用户让模型修复编译错误，需要先手动粘贴错误信息——多一轮交互。Claude Code 通过 `diagnosticTracker` 服务自动收集 LSP 诊断，每轮注入到系统提示。 + +**Claude Code 源码索引**： + +| 文件 | 关键函数/常量 | +|------|-------------| +| `services/diagnosticTracking.ts` | `LSPDiagnosticRegistry` — 收集/存储诊断 | +| `utils/attachments.ts` | `diagnostics` 附件类型注入 | + +**Qwen Code 现状**：LSP 服务（`lsp.ts`）存在，但诊断仅依赖 IDE 插件主动推送，不自动收集注入。 + +**Qwen Code 修改方向**：① `lsp.ts` 新增诊断收集（`onDiagnostics` 回调）；② 获取活跃诊断（最近 10 个 error/warning）；③ `prompts.ts` 注入诊断到系统提示。 + +**实现成本评估**： +- 涉及文件：~3 个 +- 新增代码：~100 行 +- 开发周期：~1 天（1 人） +- 难点：诊断去重和时效性（只注入最新的） + +**意义**：模型自动看到编译错误/警告，无需用户手动报告。 +**缺失后果**：用户需要手动粘贴错误信息 = 多一轮交互。 +**改进收益**：自动诊断注入 = 模型即时修复编译错误。 + +--- + + + +### 30. 终端主题检测（P2） + +**问题**：浅色终端启动 Agent 后，浅黄色文字在白色背景上不可见——用户需要手动 `/theme light`。Claude Code 自动通过 OSC 11 查询终端背景色，`COLORFGBG` 环境变量回退。 + +**关键设计细节**： + +- **OSC 11 查询**：解析 `rgb:R/G/B` 或 `#RRGGBB` 格式 +- **亮度计算**：ITU-R BT.709 — `0.2126*r + 0.7152*g + 0.0722*b`，>0.5 为 light +- **COLORFGBG 回退**：ANSI 色号 0-6/8 为暗，7/9-15 为亮 +- **模块级缓存**：`cachedSystemTheme` 避免重复查询 + +**Claude Code 源码索引**： + +| 文件 | 关键函数/常量 | +|------|-------------| +| `utils/systemTheme.ts` | `resolveThemeSetting()`、`detectFromColorFgBg()`、`cachedSystemTheme` | +| `ink/terminal-querier.ts` | OSC 11 查询实现 | + +**Qwen Code 现状**：`semantic-colors.ts` 硬编码主题或依赖用户配置，无自动检测。 + +**Qwen Code 修改方向**：`semantic-colors.ts` 新增 `detectTheme()` 函数，启动时调用。 + +**实现成本评估**： +- 涉及文件：~2 个 +- 新增代码：~80 行 +- 开发周期：~0.5 天（1 人） +- 难点：OSC 11 在不同终端（iTerm/Kitty/Alacritty/Windows Terminal）的兼容性 + +**意义**：自动适配终端背景色 = 颜色对比度始终正常。 +**缺失后果**：浅色终端启动 Agent → 浅黄色文字不可见。 +**改进收益**：自动检测 = UI 始终可读。 + +--- + + + +### 31. 自动后台化 Agent（P2） + +**问题**：Subagent 执行长任务（如批量修改 10 个文件），主 Agent 被阻塞——用户无法输入新指令。Claude Code 超时 15s 自动转后台 + Assistant 模式检测。 + +**Claude Code 源码索引**： + +| 文件 | 关键函数/常量 | +|------|-------------| +| `tools/BashTool/BashTool.tsx` | `getAutoBackgroundMs()`、`ASSISTANT_BLOCKING_BUDGET_MS = 15_000`、`onTimeout()` | + +**Qwen Code 现状**：需用户显式设置 `isBackground`，无超时自动转后台。 + +**Qwen Code 修改方向**：`agent.ts` 执行时启动 timer，超时自动将任务标记为 background 并释放前台。 + +**实现成本评估**： +- 涉及文件：~2 个 +- 新增代码：~100 行 +- 开发周期：~1 天（1 人） +- 难点：后台任务完成后的通知机制 + +**意义**：长任务自动不阻塞前台交互。 +**缺失后果**：用户被阻塞等待长任务完成。 +**改进收益**：超时自动转后台 = 用户继续交互。 + +--- + + + +### 32. 密钥扫描（P2） + +**问题**：模型执行工具可能意外输出 API 密钥/密码到对话中。Claude Code 在 Team Memory 上传前用 29 条 gitleaks 规则扫描，防止密钥泄露。 + +**Claude Code 源码索引**： + +| 文件 | 关键函数/常量 | +|------|-------------| +| `services/teamMemory/gitleaks.ts` | 29 条 gitleaks 规则（AWS Key、Generic API Key 等） | + +**Qwen Code 现状**：无工具输出密钥扫描。 + +**Qwen Code 修改方向**：① 新建 `secretScanner.ts`，定义 50+ 正则规则；② 工具输出后调用扫描；③ 发现密钥则警告/阻断。 + +**实现成本评估**： +- 涉及文件：~3 个 +- 新增代码：~150 行 +- 开发周期：~1 天（1 人） +- 难点：规则覆盖率和误报率平衡 + +**意义**：防止模型意外输出 API 密钥/密码。 +**缺失后果**：工具输出可能包含密钥 → 写入日志/对话。 +**改进收益**：自动扫描 = 防意外泄露。 + +--- + + + +### 33. 子进程环境变量清洗（P2） + +**问题**：敏感环境变量（如 `AWS_SECRET_ACCESS_KEY`、`GITHUB_TOKEN`）可能泄漏到工具执行的子进程中。Claude Code 自动剥离 30+ 敏感变量后启动子进程。 + +**Qwen Code 现状**：继承完整环境。 + +**Qwen Code 修改方向**：① 新建 `envSanitizer.ts`，定义 30+ 敏感变量集合；② 启动子进程前调用 `sanitizeEnv()` 清洗。 + +**实现成本评估**： +- 涉及文件：~2 个 +- 新增代码：~50 行 +- 开发周期：~0.5 天（1 人） +- 难点：敏感变量清单的完整性 + +**意义**：防止敏感变量泄漏到子进程。 +**缺失后果**：API 密钥/凭证可能泄漏到工具输出。 +**改进收益**：环境变量清洗 = 更安全。 + +--- + + + +### 34. 自定义快捷键（P2） + +**问题**：Vim/Emacs 用户无法自定义 Agent 的键盘快捷键——键位固定。Claude Code 支持 multi-chord 组合键 + `keybindings.json` 自定义，341 行默认绑定 + 验证器。 + +**Claude Code 源码索引**： + +| 文件 | 关键函数/常量 | +|------|-------------| +| `keybindings/defaultBindings.ts` (341行) | 默认键绑定 | +| `keybindings/parser.ts`、`resolver.ts`、`validate.ts` | 解析/验证框架 | +| `keybindings/loadUserBindings.ts` | 加载 `keybindings.json` | + +**Qwen Code 现状**：`keyMatchers.ts` 不可用户配置，无 `keybindings.json` 支持。 + +**Qwen Code 修改方向**：① 新增 `keybindings.json` schema；② 加载和解析用户配置；③ 与默认绑定合并。 + +**实现成本评估**： +- 涉及文件：~4 个 +- 新增代码：~200 行 +- 开发周期：~2 天（1 人） +- 难点：multi-chord 组合键解析 + +**意义**：Vim/Emacs 用户自定义习惯键位。 +**缺失后果**：键位固定，无法自定义。 +**改进收益**：自定义快捷键 = 个人效率提升。 + +--- + + + +### 35. Thinking 块保留（P2） + +**问题**：复杂任务需要多轮推理，模型每轮的思考过程（thinking block）不应丢失。Claude Code 跨轮保留 thinking 块 + 1h 空闲自动清理 + latch 防缓存破坏。 + +**Qwen Code 现状**：thinking 块仅限当前轮。 + +**Qwen Code 修改方向**：`client.ts` 新增 `thinkingBlocks` 持久化 + 空闲清理（1h 阈值）。 + +**实现成本评估**： +- 涉及文件：~2 个 +- 新增代码：~100 行 +- 开发周期：~1 天（1 人） +- 难点：仅 Anthropic 模型适用，需 feature flag 控制 + +**意义**：推理思考跨轮保留 = 复杂任务连续性。 +**缺失后果**：每轮思考丢失 = 重复推理。 +**改进收益**：Thinking 块保留 = 模型推理连贯性。 + +--- diff --git a/docs/comparison/qwen-code-improvement-report.md b/docs/comparison/qwen-code-improvement-report.md index 069f9e5e..d539c829 100644 --- a/docs/comparison/qwen-code-improvement-report.md +++ b/docs/comparison/qwen-code-improvement-report.md @@ -2,9 +2,11 @@ > 基于对 Claude Code（源码分析，56 个顶层模块，~1800 文件）与 Qwen Code（开源源码，~500 文件）的系统性源码对比分析。 > +> **审计方法**: 五轮无方向 + 反方向 + 交叉审计（详见 [§六](#六审计方法说明)）。 +> > 如需查阅源码，可参考本地仓库（不在本文档库中）： -> - Claude Code: `../claude-code/`（源码快照） -> - Qwen Code: `../qwen-code/` +> - Claude Code: `../claude-code-leaked/`（反编译分析） +> - Qwen Code: `../qwen-code/`（开源） ## 一、Claude Code 功能模块清单 @@ -99,12 +101,12 @@ | **P2** | [SendMessageTool](./multi-agent-deep-dive.md) — 多 Agent间消息传递、shutdown 请求、plan 审批 [↓](./qwen-code-improvement-report-p2-core.md#item-14) | 缺失 | 中 | — | | **P2** | FileIndex — fzf 风格模糊文件搜索 + 异步增量索引 [↓](./qwen-code-improvement-report-p2-core.md#item-15) | 依赖 rg/glob | 中 | — | | **P2** | Notebook Edit — Jupyter cell 编辑 + 自动 cell ID 追踪 + 文件历史快照 [↓](./qwen-code-improvement-report-p2-core.md#item-16) | 缺失 | 中 | — | -| **P2** | 自定义快捷键 — multi-chord 组合键 + 跨平台适配 + `keybindings.json` 自定义 [↓](./qwen-code-improvement-report-p2-core.md#item-17) | 缺失 | 中 | — | +| **P2** | 自定义快捷键 — multi-chord 组合键 + 跨平台适配 + `keybindings.json` 自定义 [↓](./qwen-code-improvement-report-p2-core.md#item-17) | 缺失 | 中 | — | | **P2** | Session Ingress Auth — 远程会话 bearer token 认证（企业多用户环境） [↓](./qwen-code-improvement-report-p2-core.md#item-18) | 缺失 | 中 | — | | **P2** | 企业代理 — CONNECT relay + CA cert 注入 + NO_PROXY allowlist（容器环境） [↓](./qwen-code-improvement-report-p2-core.md#item-19) | 缺失 | 大 | — | | **P2** | ConfigTool — 模型通过工具读写设置（主题/模型/权限等），带 schema 验证 [↓](./qwen-code-improvement-report-p2-core.md#item-20) | 仅 /settings 命令 | 小 | — | -| **P2** | 终端主题检测 — OSC 11 查询 dark/light + COLORFGBG 环境变量回退 [↓](./qwen-code-improvement-report-p2-core.md#item-21) | 缺失 | 小 | — | -| **P2** | 自动后台化 Agent — 超过阈值自动转后台执行，不阻塞用户交互 [↓](./qwen-code-improvement-report-p2-core.md#item-22) | 需显式指定 | 小 | — | +| **P2** | 终端主题检测 — OSC 11 查询 dark/light + COLORFGBG 环境变量回退 [↓](./qwen-code-improvement-report-p2-core.md#item-21) | 缺失 | 小 | — | +| **P2** | 自动后台化 Agent — 超过阈值自动转后台执行，不阻塞用户交互 [↓](./qwen-code-improvement-report-p2-core.md#item-22) | 需显式指定 | 小 | — | | **P2** | Denial Tracking — 连续权限拒绝自动回退到手动确认模式，防止静默阻塞 [↓](./qwen-code-improvement-report-p2-core.md#item-7) | 缺失 | 小 | — | | **P2** | [队列输入编辑](./input-queue-deep-dive.md) — 排队中的指令可通过方向键弹出到输入框重新编辑 [↓](./qwen-code-improvement-report-p2-core.md#item-23) | 缺失 | 小 | [PR#2871](https://github.com/QwenLM/qwen-code/pull/2871) | | **P2** | 状态栏紧凑布局 — 固定高度不伸缩，最大化终端内容区域 [↓](./qwen-code-improvement-report-p2-core.md#item-24) | Footer 占用偏高 | 小 | — | @@ -160,7 +162,7 @@ | **P2** | 统一设计系统组件库 — 12 个语义 UI 原语 + ThemeProvider [↓](./qwen-code-improvement-report-p2-stability.md#item-9) | 组件分散 | 中 | — | | **P2** | Markdown 表格终端渲染 — ANSI-aware + CJK-aware 列宽计算 [↓](./qwen-code-improvement-report-p2-stability.md#item-10) | CJK 列错位 | 小 | — | | **P2** | 屏幕阅读器无障碍支持 — Diff/Spinner/Progress 纯文本替代渲染 [↓](./qwen-code-improvement-report-p2-stability.md#item-11) | hook 存在但使用有限 | 小 | — | -| **P2** | 色觉无障碍主题 — daltonized 红绿→蓝橙 diff 色板 [↓](./qwen-code-improvement-report-p2-stability.md#item-12) | 无色觉主题 | 小 | — | +| **P2** | 色觉无障碍主题 — daltonized 红绿→蓝橙 diff 色板 [↓](./qwen-code-improvement-report-p2-stability.md#item-12) | 无色觉主题 | 小 | — | | **P2** | 动画系统与卡顿状态检测 — shimmer 微光 + 30s 超时变红 [↓](./qwen-code-improvement-report-p2-stability.md#item-13) | 固定动画/无超时检测 | 小 | — | | **P2** | Agent 权限冒泡 — bubble 模式 + Leader 桥接 + 邮箱回退 [↓](./qwen-code-improvement-report-p2-stability.md#item-14) | 继承父级模式 | 中 | — | | **P2** | Agent 专属 MCP 服务器 — frontmatter mcpServers + 按需连接/清理 [↓](./qwen-code-improvement-report-p2-stability.md#item-15) | 共享全局 MCP | 小 | — | @@ -168,7 +170,6 @@ | **P2** | Agent 进度追踪与实时状态 — ProgressTracker + task-notification + kill 控制 [↓](./qwen-code-improvement-report-p2-stability.md#item-17) | 仅最终结果 | 中 | — | | **P2** | Agent 邮箱系统 — 文件 IPC + lockfile + 单播/广播 [↓](./qwen-code-improvement-report-p2-stability.md#item-18) | 仅 Arena 文件 IPC | 中 | — | | **P2** | cache_edits 增量缓存删除 — API 原地删除旧工具结果不破坏缓存前缀 [↓](./qwen-code-improvement-report-p2-perf.md#item-13) | 重建消息数组 | 小 | — | -| **P2** | 消息规范化与配对修复 — 合并连续 user + 修复孤立 tool_use/result + 100 媒体上限 [↓](./qwen-code-improvement-report-p2-perf.md#item-14) | 格式转换/无修复 | 中 | — | | **P2** | Git 状态自动注入上下文 — gitBranch/cwd/platform/fileCount 每轮注入 [↓](./qwen-code-improvement-report-p2-perf.md#item-15) | 仅平台和日期 | 小 | — | | **P2** | IDE 上下文注入与嵌套记忆触发 — 选区→目录规范自动注入 + 诊断双源收集 [↓](./qwen-code-improvement-report-p2-perf.md#item-16) | 无嵌套记忆触发 | 中 | — | | **P2** | 图片压缩多策略流水线 — format→resize→quality 阶梯 + JPEG fallback [↓](./qwen-code-improvement-report-p2-perf.md#item-17) | 仅计算 token/不压缩 | 中 | — | @@ -203,8 +204,8 @@ | **P2** | sandbox运行时集成 — seatbelt/bubblewrap/Docker + 文件/网络限制 [↓](./qwen-code-improvement-report-p2-stability.md#item-30) | 可选/非默认 | 大 | — | | **P2** | SSRF 防护 — 私有 IP 阻断 + IPv4-mapped + DNS rebinding 防护 [↓](./qwen-code-improvement-report-p2-stability.md#item-31) | 仅基础 isPrivateIp | 中 | — | | **P2** | WebFetch 域名allowlist — 130+ 预批准域名 + 路径段边界匹配 [↓](./qwen-code-improvement-report-p2-stability.md#item-32) | 无内置allowlist | 小 | — | -| **P2** | 子进程环境变量清洗 — 30+ 敏感变量自动剥离 [↓](./qwen-code-improvement-report-p2-stability.md#item-33) | 继承完整环境 | 中 | — | -| **P2** | 工具输出密钥扫描 — 50+ gitleaks 规则 + 写入阻断 [↓](./qwen-code-improvement-report-p2-stability.md#item-34) | 无扫描 | 中 | — | +| **P2** | 子进程环境变量清洗 — 30+ 敏感变量自动剥离 [↓](./qwen-code-improvement-report-p2-stability.md#item-33) | 继承完整环境 | 中 | — | +| **P2** | 工具输出 密钥扫描 — 50+ gitleaks 规则 + 写入阻断 [↓](./qwen-code-improvement-report-p2-stability.md#item-34) | 无扫描 | 中 | — | | **P2** | privilege escalation防护 — auto 模式 60+ 危险规则自动剥离 [↓](./qwen-code-improvement-report-p2-stability.md#item-35) | yolo 批准所有 | 中 | — | | **P3** | 动态状态栏 — 模型/工具可实时更新状态文本 [↓](./qwen-code-improvement-report-p3.md#item-1) | 仅静态 Footer | 小 | — | | **P3** | [上下文折叠](./context-compression-deep-dive.md) — History Snip（Claude Code 自身仅 scaffolding，未完整实现） [↓](./qwen-code-improvement-report-p3.md#item-2) | 缺失 | 大 | — | @@ -217,6 +218,26 @@ | **P3** | Vim 完整实现 — motions + operators + textObjects + transitions 完整体系 [↓](./qwen-code-improvement-report-p3.md#item-9) | 基础 vim.ts | 中 | — | | **P3** | 语音模式 — push-to-talk 语音输入 + 流式 STT 转录 + 可重绑快捷键 [↓](./qwen-code-improvement-report-p3.md#item-10) | 缺失 | 大 | — | | **P3** | [插件市场](./hook-plugin-extension-deep-dive.md) — 插件发现、安装、版本管理 + 前端 UI [↓](./qwen-code-improvement-report-p3.md#item-11) | 缺失 | 大 | — | +| **P1** | 系统提示模块化 [↓](./qwen-code-improvement-report-p0-p1-engine.md#item-26) — sections 缓存 + dynamic boundary + uncached 标记 | 单一字符串拼接 | 中 | — | +| **P2** | 会话标签与搜索 [↓](./qwen-code-improvement-report-p2-core.md#item-25) — `/tag` 会话标签 + 按 repo/标题搜索 | 仅基础 load/save | 小 | — | +| **P2** | MCP 通道通知 [↓](./qwen-code-improvement-report-p2-tools.md#item-13) — MCP channel notification 支持服务器主动推送 | mcp-client.ts 无 channel 概念 | 中 | — | +| **P3** | 会话分支 [↓](./qwen-code-improvement-report-p2-core.md#item-13) — `/branch` 从历史会话创建分支 | 可用 sessionService 扩展 | 中 | — | +| **P3** | 安全审查 [↓](./qwen-code-improvement-report-p3.md#item-6) — skill 可快速补齐 | skill 可补齐 | 小 | — | +| **P3** | PR 评论 [↓](./qwen-code-improvement-report-p2-stability.md#item-22) — GitHub Actions 可实现 | Actions 可实现 | 中 | — | +| **P2** | @include 指令 [↓](./qwen-code-improvement-report-p2-core.md#item-26) — 递归引用 + 外部文件审批 + 40+ 文本类型白名单 | 缺失 | 中 | — | +| **P2** | 附件协议 [↓](./qwen-code-improvement-report-p2-core.md#item-27) — 60+ 类型 + per-type token 预算 + 3 阶段有序执行 | 缺失 | 中 | — | +| **P2** | 图片压缩流水线 [↓](./qwen-code-improvement-report-p2-perf.md#item-17) — format→resize→quality 阶梯 + JPEG fallback | 无压缩 | 中 | — | +| **P2** | Git 状态自动注入 [↓](./qwen-code-improvement-report-p2-core.md#item-28) — gitBranch/cwd/fileCount 每轮自动注入系统提示 | 仅统计/不注入 | 小 | — | +| **P2** | IDE 诊断注入 [↓](./qwen-code-improvement-report-p2-core.md#item-29) — LSP 诊断自动收集 + 选区自动注入 | 依赖 IDE 推送 | 中 | — | +| **P2** | 终端主题检测 [↓](./qwen-code-improvement-report-p2-core.md#item-30) — OSC 11 dark/light + COLORFGBG 回退 | 缺失 | 小 | — | +| **P2** | 自动后台化 Agent [↓](./qwen-code-improvement-report-p2-core.md#item-31) — 超时 15s 自动转后台 + Assistant 模式检测 | 需显式指定 | 小 | — | +| **P2** | 密钥扫描 [↓](./qwen-code-improvement-report-p2-core.md#item-32) — 工具输出 50+ gitleaks 规则扫描 + 写入阻断 | 仅 Team Memory 场景需要 | 中 | — | +| **P2** | 子进程环境变量清洗 [↓](./qwen-code-improvement-report-p2-core.md#item-33) — 30+ 敏感变量自动剥离 | OS 层职责 | 中 | — | +| **P2** | 结构化 Diff [↓](./qwen-code-improvement-report-p2-tools.md#item-29) — 纯 JS 快速着色 + 行号 gutter + 语法高亮 | 基础 inline diff | 中 | — | +| **P2** | OSC 通知 [↓](./qwen-code-improvement-report-p2-tools.md#item-23) — iTerm2/Kitty/Ghostty 通知 + 进度 | 仅 bell 响铃 | 小 | — | +| **P2** | OSC 8 超链接 [↓](./qwen-code-improvement-report-p2-stability.md#item-7) — Cmd+Click 打开文件/URL | MarkdownRenderer.tsx 无 OSC 8 | 小 | — | +| **P2** | 色觉无障碍主题 [↓](./qwen-code-improvement-report-p2-stability.md#item-12) — daltonized 红绿→蓝橙 diff 色板 | 小众需求 | 小 | — | +| **P2** | 自定义快捷键 [↓](./qwen-code-improvement-report-p2-core.md#item-34) — multi-chord + keybindings.json | keyMatchers.ts 不可配置 | 中 | — | > 点击改进点名称可跳转到 Deep-Dive 文章；每项的详细说明（缺失后果 + 改进收益 + 建议方案）见 [§三](#三全部改进点详细说明)。 @@ -232,8 +253,8 @@ | [P2 核心功能与企业特性](./qwen-code-improvement-report-p2-core.md) | 中等优先级（Shell 安全、MDM 企业策略、Token 计数、Computer Use 等） | 24 | | [P2 工具与命令扩展](./qwen-code-improvement-report-p2-tools.md) | 中等优先级（MCP 动态插槽、Ripgrep 回退、Notebook Edit、LSP 等） | 29 | | [P2 性能优化](./qwen-code-improvement-report-p2-perf.md) | 中等优先级（流式执行、缓存模式、延迟初始化、请求合并等） | 34 | -| [P2 稳定性、安全与 CI/CD](./qwen-code-improvement-report-p2-stability.md) | 中等优先级（Unicode sanitization、sandbox集成、SSRF 防护、密钥扫描等） | 34 | -| [P3 详细说明](./qwen-code-improvement-report-p3.md) | 低优先级（Feature Gates、Vim、语音、插件市场等） | 11 | +| [P2 稳定性、安全与 CI/CD](./qwen-code-improvement-report-p2-stability.md) | 中等优先级（Unicode sanitization、sandbox集成、SSRF 防护、密钥扫描等） | 60 | +| [P3 详细说明](./qwen-code-improvement-report-p3.md) | 低优先级（Feature Gates、Vim、语音、插件市场等） | 30 | ## 四、架构差异总结 @@ -245,7 +266,10 @@ | **智能工具并行** | Kind-based batching（默认 10 并发） | Agent 并发 / 其他顺序 | 中等差距 | [PR#2864](https://github.com/QwenLM/qwen-code/pull/2864) | | 投机执行 (Speculation) | 完整 overlay-fs + cow（991 行） | v0.15.0 已完整实现（563 行），默认关闭 | 小差距 | [PR#2525](https://github.com/QwenLM/qwen-code/pull/2525) ✓ | | 启动优化 | API Preconnect + Early Input | 无 | 缺失 | — | -| CLAUDE.md 条件规则 | frontmatter `paths:` + 惰加载 | 无 | 中等差距 | — | +| CLAUDE.md 条件规则 | frontmatter `paths:` + 惰加载 | 无条件加载 | 中等差距 | — | +| 系统提示模块化 | sections 缓存 + dynamic boundary | 单一字符串拼接 | 中等差距 | — | +| MCP Channel Notification | Channel notification 服务器推送 | 无 channel 概念 | 中等差距 | — | +| @include 指令 | 递归引用 + 外部审批 | 缺失 | 缺失 | — | | 会话记忆 (Session Memory) | SessionMemory + memdir | 简单笔记工具 | 显著落后 | — | | 自动记忆 (Memory) 整理 | Auto Dream | 无 | 缺失 | — | | 上下文折叠 (Context Collapse) | History Snip | 无 | 缺失 | — | @@ -254,14 +278,20 @@ | Token 实时计数 | API 计数 + VCR 缓存 | 静态模式匹配 | 中等差距 | — | | 工具发现 | ToolSearchTool | 无 | 缺失 | — | | 多 Agent通信 | SendMessageTool | 无 | 缺失 | — | +| 任务管理 | TaskCreate/Get/Update/List/Output/Stop | todoWrite 已覆盖 | 小差距 | — | +| Team Agent Management | TeamCreateTool/TeamDeleteTool (Swarms) | Arena 模式更简洁 | 小差距 | — | | 文件索引 | FileIndex（fzf 风格） | 依赖 rg/glob | 中等差距 | — | | Commit Attribution | Co-Authored-By 追踪 | 无 | 缺失 | — | | 会话分支 | /branch 对话分叉 | 无 | 缺失 | — | | Output Styles | Learning / Explanatory 模式 | 无 | 缺失 | — | | Fast Mode | 速度/成本分级推理 | 无 | 缺失 | — | | 并发 Session | 多终端 PID 追踪 + 后台脱附 | 无 | 缺失 | — | -| Git Diff 统计 | 结构化 diff + 按文件统计 | 无 git-aware stats | 中等差距 | — | -| 文件历史快照 | per-file SHA256 + 按消息恢复 | checkpoint（git 级） | 小差距 | — | +| Session Tags & Search | `/tag` + 搜索 | 仅基础 load/save | 中等差距 | — | +| Git Status Auto-Injection | gitBranch/cwd/fileCount 每轮注入 | 仅统计/不注入 | 小差距 | — | +| IDE Diagnostics Injection | LSP 诊断自动收集 + 选区注入 | 依赖 IDE 推送 | 中等差距 | — | +| Terminal Theme Detection | OSC 11 + COLORFGBG 回退 | 缺失 | 小差距 | — | +| Auto-Background Agent | 超时 15s 自动转后台 | 需显式指定 | 小差距 | — | +| Thinking Block Retention | 跨轮保留 + 空闲清理 | 每轮独立 | 中等差距 | — | | **流式工具执行** | StreamingToolExecutor 流水线 | 等完整响应 | 显著落后 | — | | **文件读取缓存** | FileReadCache 1000 LRU + 批量并行 | 无缓存/顺序读取 | 显著落后 | — | | **记忆异步prefetch** | Memory prefetch + skill prefetch | 无 | 缺失 | — | @@ -276,6 +306,19 @@ | **崩溃恢复** | 中断检测 + 合成续行 + 全量恢复 | 无 | 缺失 | — | | **API 重试** | 10 次退避 + 529 降级 + 持久化重试 | 仅重试次数 | 显著落后 | — | | **优雅关闭** | SIGINT/SIGTERM + 清理注册 + failsafe | 无信号处理 | 缺失 | — | +| MCP OAuth | McpAuthTool + OAuth 端口管理 | 缺失 | 缺失 | — | +| MCP Channel Notification | Channel notification 服务器推送 | 缺失 | 缺失 | — | +| Privacy Protection | PII 脱敏 + Killswitch + 事件采样 | 无保护 | 显著落后 | — | +| Extended Hooks | FileChanged/ConfigChange/TaskLifecycle 等 | 仅基础 Hook | 中等差距 | — | +| Structured Diff | Rust NAPI + 行号 + 语法高亮 | 基础 inline diff | 中等差距 | — | +| Spinner Tool Timer | 工具名 + 单独计时 | 仅全局计时 | 小差距 | — | +| OSC Notifications | iTerm2/Kitty/Ghostty + 进度 | 仅 bell 响铃 | 小差距 | — | +| OSC 52 Clipboard | 复制代码 + tmux 回退 | 缺失 | 小差距 | — | +| OSC 8 Hyperlinks | Cmd+Click 打开文件/URL | 纯文本链接 | 小差距 | — | +| Colorblind Theme | daltonized 红绿→蓝橙 | 无专门主题 | 小差距 | — | +| Custom Keybindings | multi-chord + keybindings.json | 不可配置 | 中等差距 | — | +| Image Chips | [Image #N] 位置引用 | 附件形式 | 小差距 | — | +| Permission File Preview | 内容预览 + 语法高亮 | 基础确认 | 中等差距 | — | | **反应式压缩** | prompt_too_long 自动裁剪重试 | 无 | 缺失 | — | | **原子写入** | temp+rename + 大结果persist to disk | 直接 writeFileSync | 中等差距 | — | | **自动检查点** | 默认启用 + per-message 快照 | 默认关闭 | 中等差距 | — | @@ -329,3 +372,58 @@ | 终端渲染 | [终端渲染与防闪烁](../tools/claude-code/11-terminal-rendering.md) | | 设置与安全 | [设置与安全](../tools/claude-code/06-settings.md) | | 会话与记忆 | [会话与记忆](../tools/claude-code/07-session.md) | + +## 六、审计方法说明 + +本报告采用 **五轮审计法** 确保结论完整性和客观性： + +| 轮次 | 方法 | 目标 | 发现数 | +|------|------|------|:------:| +| **第一轮** | 无方向审计 | 全面扫描双方架构差异，不预设结论 | 87 项 | +| **第二轮** | 无方向审计 | 深入对比 10 大核心模块实现差异 | 43 项 | +| **第三轮** | 反方向审计 | 假设 Qwen Code 更优，找出其优势 | 7 项 | +| **第四轮** | 反方向审计 | 假设 Claude Code 更优，验证 Qwen Code 不足 | 已覆盖 | +| **第五轮** | 交叉审计 | 随机抽样验证前四轮结论的准确性 | 6 项确认 | + +> **免责声明**: 审计基于 2026 年 Q1 源码快照，可能已过时。Claude Code 为闭源二进制，分析基于反编译结果，可能与实际行为有差异。 + +## 七、Qwen Code 优势分析 + +经第三轮反方向审计，确认 Qwen Code 在以下方面优于 Claude Code： + +| 维度 | Qwen Code | Claude Code | 优势评估 | +|------|-----------|-------------|----------| +| **开源可审计** | 全部源码可审计（~500 文件） | 闭源 Bun 二进制（需反编译） | **显著优势** | +| **LSP 工具** | 12 种操作（含 diagnostics/codeActions） | 8 种操作 | **优势** | +| **代码简洁度** | ~500 文件，~17.7 万行 | ~1800 文件，~38 万行 | **维护成本低** | +| **记忆系统** | global + project 两级，文件透明 | 单级 MEMORY.md，自动管理 | **更可控** | +| **搜索提供商** | Google/Tavily/Dashscope 3 种 | 仅内置搜索 | **更灵活** | +| **多语言 SDK** | TypeScript + Java SDK | 仅 Node.js | **更广泛** | +| **IDE 扩展** | VS Code + Zed 编辑器 | 仅 Chrome 集成 | **更开放** | +| **/restore 命令** | 开源可验证的 checkpoint 恢复 | 闭源实现（不可审计） | **更透明** | + +> **总结**: Qwen Code 的核心优势在于 **透明性、可审计性、代码简洁度** 和 **LSP 功能完整性**。Claude Code 的优势在于 **功能丰富度**（101 vs 38 命令）和 **企业特性**（durable cron、teammate 等）。 + +--- + + +## 八、新增改进点详细说明 + +> 以下为五轮审计新增的改进点，已追加到对应分文件中。点击跳转到详细说明（格式与 §三 一致：问题 → Claude Code 源码索引 → Qwen Code 现状 → 修改方向 → 实现成本 → 意义/缺失后果/改进收益）。 + +| 优先级 | 改进点 | 详见 | +|:------:|--------|------| +| **P1** | 系统提示模块化 | [p0-p1-engine.md#item-26](./qwen-code-improvement-report-p0-p1-engine.md#item-26) | +| **P2** | 会话标签与搜索 | [p2-core.md#item-25](./qwen-code-improvement-report-p2-core.md#item-25) | +| **P2** | @include 指令 | [p2-core.md#item-26](./qwen-code-improvement-report-p2-core.md#item-26) | +| **P2** | 附件协议 | [p2-core.md#item-27](./qwen-code-improvement-report-p2-core.md#item-27) | +| **P2** | Git 状态自动注入 | [p2-core.md#item-28](./qwen-code-improvement-report-p2-core.md#item-28) | +| **P2** | IDE 诊断注入 | [p2-core.md#item-29](./qwen-code-improvement-report-p2-core.md#item-29) | +| **P2** | 终端主题检测 | [p2-core.md#item-30](./qwen-code-improvement-report-p2-core.md#item-30) | +| **P2** | 自动后台化 Agent | [p2-core.md#item-31](./qwen-code-improvement-report-p2-core.md#item-31) | +| **P2** | 密钥扫描 | [p2-core.md#item-32](./qwen-code-improvement-report-p2-core.md#item-32) | +| **P2** | 子进程环境变量清洗 | [p2-core.md#item-33](./qwen-code-improvement-report-p2-core.md#item-33) | +| **P2** | 自定义快捷键 | [p2-core.md#item-34](./qwen-code-improvement-report-p2-core.md#item-34) | +| **P2** | Thinking 块保留 | [p2-core.md#item-35](./qwen-code-improvement-report-p2-core.md#item-35) | + +> 以下改进点经审计已在 Qwen Code 中实现或有更好方案，无需额外改动：