升级内嵌 @anthropic-ai/claude-agent-sdk 至 ≥0.3.154,获得 lean system prompt 的默认上下文削减
- Dominant language
- TypeScript
- Stars
- 2.7k
- Forks
- 395
- Avg merge
- 21h 48m
- Merged PRs (30d)
- 776
Description
## 背景
Claude Code CLI 自 **v2.1.154(2026-05-28)** 起把「lean system prompt(精简系统提示词)」设为默认(适用于除 Haiku / Sonnet / Opus 4.7 及更早之外的模型),大幅削减每个会话的默认系统提示词 token 开销。后续还有配套优化:
- v2.1.208(2026-07-13):修复 `/release-notes` 污染后续请求上下文,并把 session transcript 体积最多压缩 79 倍
- v2.1.212(2026-07-16):多 agent 消息传递中 `SendMessage` 正文不再重复注入 replayed history 与 tool results
嵌入式集成方需要把 `@anthropic-ai/claude-agent-sdk` 升级到 **≥ 0.3.154** 才能获得——SDK 打包自带 CLI 运行时,不升级依赖不会自动生效。
## 现状
- `packages/maker-core/package.json` 与 `packages/maker-cc-manager/package.json` 均把 SDK 精确锁在 **0.2.112**,远早于 0.3.154,node_modules 实际安装的也是 0.2.112。
- maker-core 的调用方式是 SDK preset 默认提示词 + `systemPrompt.append` 追加自有段落(`packages/maker-core/src/agents/claude-code/index.ts` 的六段拼接,注释明确「不会覆盖 CLI 默认 prompt」)。也就是说旧版那份完整的默认系统提示词,目前每个 CC 会话都在被完整加载。
## 预期收益
- 每个 Claude Code 会话的固定 token 开销显著下降(系统提示词本体精简)
- 长会话 transcript 体积、Orca 多 worker 场景的 SendMessage 重复注入问题同步受益
## 风险与注意
- lean prompt 只对较新模型默认开启,Haiku / Sonnet / Opus ≤4.7 不受影响,收益取决于用户所选模型
- 0.2.x → 0.3.x 跨小版本,SDK 行为面可能有 breaking change(如 `settingSources` 语义、CLAUDE.md 加载行为),需按 `docs/dev-rules/maker-core-and-agent-behavior.md` 做完整回归
- `maker-cc-manager`(cc-remote daemon)与 `maker-core` 需同步升级,避免本地与远端 CC 行为不一致
Contributor guide
Research direction
Start with packages/maker-core/package.json and packages/maker-cc-manager/package.json, then inspect the SDK usage in packages/maker-core/src/agents/claude-code/index.ts. Read docs/dev-rules/maker-core-and-agent-behavior.md and run the project’s existing regression checks after upgrading both dependencies. Done means both local and remote Claude Code integrations use the new SDK without behavior regressions.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- tooling
- Issue type
- Refactor
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 55/100