Craft Agent v0.10.3 发布解读Claude Fable 5 全量接入、自适应思考解析与 Claude Agent SDK 升级【免费下载链接】craft-agents-oss项目地址: https://gitcode.com/GitHub_Trending/cr/craft-agents-oss本篇文章围绕 Craft Agent 桌面端Electron 应用的 v0.10.3 版本发布说明展开重点解读该版本引入的 Claude Fable 5 模型接入方案、其为适配「自适应思考Adaptive Thinking始终开启」约束而对思考解析器所做的调整以及 Claude Agent SDK 的版本升级内容。读完本文你将理解 Fable 5 在 Craft Agent 模型注册表、AWS Bedrock 推理配置、Pi → Anthropic 认证桥接中的具体落点掌握思考等级Thinking Level与 effort 参数之间的映射机制并了解如何通过源码与测试验证这些行为。版本概览v0.10.3 的发布说明位于 apps/electron/resources/release-notes/0.10.3.md提交号为22c7ae99。该版本整体变化可归纳如下分类内容FeaturesClaude Fable 5 模型正式接入 Claude Agent SDK 路径支持 100 万 token 上下文窗口兼容 Anthropic 直连与 AWS Bedrockus/eu/global 推理配置变体模型描述完成 7 语言本地化ImprovementsClaude Agent SDK 由anthropic-ai/claude-agent-sdk0.3.154 升级至 0.3.170根包及 core、shared 对等依赖同步更新lockfile 已刷新无 API 破坏完整 typecheck 通过Bug Fixes无Breaking Changes无值得一提的是v0.10.3 在模型策略上采取了「并列而非替代」的姿态Opus 4.8 仍是默认模型Fable 5 与它并列提供并且被加入 Pi → Anthropic 认证桥接的偏好列表位于 Opus 之下。Claude Fable 5 的接入细节模型注册表中的正式登记在 packages/shared/src/config/models.ts 的中央模型注册表MODEL_REGISTRY中claude-fable-5以完整元数据登记{ id: claude-fable-5, name: Fable 5, shortName: Fable, description: Next-generation model for complex work, descriptionKey: model.fableDesc, provider: anthropic, contextWindow: 1_000_000, },从源码结构看该注册表是「所有模型定义的单一事实来源」ANTHROPIC_MODELS、MODELS等导出均由MODEL_REGISTRY派生getModelsByProvider(anthropic)。Fable 5 的contextWindow为1_000_000100 万 token与 Opus 4.8、Opus 4.7、Sonnet 5 同级属于长上下文型号。descriptionKey: model.fableDesc表明其描述文本通过 i18n 翻译键解析对应发布说明中「模型描述在所有 7 种语言中本地化」的表述仓库中 packages/shared/src/i18n/locales 目录下确实存在 7 个 locale JSON 文件可与之相互印证。AWS Bedrock 推理配置变体us / eu / globalFable 5 不仅支持 Anthropic API 直连也覆盖了 AWS Bedrock 的三种推理配置命名空间。BEDROCK_TO_BARE反向映射表同样位于 models.ts将 Bedrock 原生 ID 映射回裸 ID// US inference profile IDs (primary) us.anthropic.claude-fable-5: claude-fable-5, // EU inference profile IDs eu.anthropic.claude-fable-5: claude-fable-5, // Global inference profile IDs global.anthropic.claude-fable-5: claude-fable-5, // Base IDs (no region prefix) anthropic.claude-fable-5: claude-fable-5,该映射的意义在于当用户通过 Bedrock 连接模型 ID 形如us.anthropic.claude-fable-5时getModelById()会先做反向映射再在注册表中查找从而正确解析出显示名、上下文窗口等元数据。在 packages/shared/src/config/llm-connections.ts 中同样存在对称的正向映射裸 ID → US 推理配置 ID例如claude-fable-5: us.anthropic.claude-fable-5用于把应用内部模型 ID 翻译成 Bedrock 可用的推理配置。Pi → Anthropic 认证桥接中的位置对于通过 Pi 代理访问 Anthropic 模型的连接PI_PREFERRED_DEFAULTS定义了各 provider 的偏好默认模型顺序llm-connections.ts L606-L619anthropic: [claude-opus-4-8, claude-opus-4-7, claude-fable-5, claude-sonnet-5, claude-sonnet-4-6, claude-haiku-4-5],Fable 5 位列 Opus 4.8、Opus 4.7 之后、Sonnet 5 之前与发布说明中「added to the Pi → Anthropic auth-bridge preferences below Opus」的描述完全一致。该列表用于getDefaultModelsForConnection()在选择默认模型时优先命中现代模型避免 Pi SDK 按字母序返回时把过时模型排到首位。自适应思考解析器为 Fable 5 特化的降级策略背景Mythos 级模型「思考不可关闭」Fable 5 与 Mythos 5 同属 Mythos 级模型它们的核心约束是自适应思考Adaptive Thinking始终开启Messages API 会拒绝thinking: { type: disabled }请求。这意味着对这类模型而言不存在「关闭思考」的选项用户能控制的最低下限是「自适应 low effort」。代码中通过isAdaptiveThinkingAlwaysOnModel()判定packages/shared/src/config/models.tsexport function isAdaptiveThinkingAlwaysOnModel(modelId: string): boolean { return /claude-(fable|mythos)/i.test(modelId); }该正则同时覆盖裸 IDclaude-fable-5、pi/前缀 ID 与 Bedrock 原生 ID 形式。解析器的核心逻辑resolveClaudeThinkingOptions()packages/shared/src/agent/claude-agent.ts是思考配置到 SDK 选项的转换入口其关键分支如下const effort THINKING_TO_EFFORT[thinkingLevel]; const isHaiku model.toLowerCase().includes(haiku); const supportsAdaptiveThinking isClaude !isHaiku; const adaptiveAlwaysOn isAdaptiveThinkingAlwaysOnModel(model); if (minimizeThinking || !isClaude || !effort) { if (adaptiveAlwaysOn) { // Mythos 级模型无法 disabled最低只能降到 adaptive low return { thinking: { type: adaptive as const }, effort: low as const }; } return supportsAdaptiveThinking ? { thinking: { type: disabled as const } } : { maxThinkingTokens: 0 }; } if (supportsAdaptiveThinking) { return { thinking: { type: adaptive as const }, effort }; } return { maxThinkingTokens: getThinkingTokens(thinkingLevel, model) };可归纳为三条行为路径Mythos 级模型Fable 5 / Mythos 5无论思考等级为off、low还是触发了minimizeThinking一律返回adaptive low绝不下发disabled普通 Claude 模型Opus / Sonnet 等非 Haiku走自适应思考 effort 映射off等级下正常返回thinking: { type: disabled }行为与 v0.10.3 之前逐字节一致Haiku 及其他非 Claude 模型回退到 token 预算方案maxThinkingTokens。思考等级体系定义于 packages/shared/src/agent/thinking-levels.tsoff → low → medium → high → xhigh → max六档默认等级为mediumTHINKING_TO_EFFORT将等级映射到 SDK 的effort参数low/medium/high/xhigh/max其中off映射为null。对于不支持xhigh的模型Anthropic SDK 会静默回退到high。测试用例的印证仓库在 packages/shared/src/agent/tests/claude-thinking-config.test.ts 中为 Fable 5 的思考行为建立了专项测试覆盖了发布说明强调的全部关键场景uses adaptive thinking effort for Fable 5 (normal level)thinkingLevel: high→{ thinking: { type: adaptive }, effort: high }never disables thinking on Fable 5 when level is offthinkingLevel: off→{ thinking: { type: adaptive }, effort: low }而非 disablednever disables thinking on Fable 5 when minimizeThinking is setminimizeThinking: true→ 同样落到adaptive lowstill disables thinking on Opus 4.8 when level is off (unchanged for non-Mythos models)对照验证 Opus 4.8 在off等级下依旧返回{ thinking: { type: disabled } }确认「Opus、Sonnet、Haiku 行为逐字节不变」。这套测试既防止了未来改动误伤 Mythos 级模型的特殊约束也锁定了非 Mythos 模型的既有行为不回归。Claude Agent SDK 升级0.3.154 → 0.3.170发布说明指出anthropic-ai/claude-agent-sdk由 0.3.154 升级至 0.3.170涉及根包以及 core、shared 的对等依赖lockfile 同步刷新无 API 破坏typecheck 全量通过。在 Craft Agent 的架构中Claude Agent SDK 是 Claude 系模型的核心运行时载体。根 package.json 中声明了anthropic-ai/claude-agent-sdk: 0.3.197——这反映了仓库演进到当前状态时的版本已高于 v0.10.3 发布时的 0.3.170说明该依赖处于持续升级节奏中。项目 README 亦明确 Claude 后端由 Claude Agent SDK 驱动原生支持自定义 base URL 与 provider 路由。值得留意的是打包层面的细节在 apps/electron/electron-builder.yml 中SDK 自 0.2.113 起采用「薄核心 平台专属二进制」的分发方式打包时必须把anthropic-ai/claude-agent-sdk与anthropic-ai/claude-agent-sdk-binary显式拷贝进app/node_modules因为常规的 optional-dependency 解析在打包后的资源布局中不可用详见 apps/electron/README.md。这意味着 SDK 升级除了改版本号还需保持该打包映射与各平台二进制名称claude/claude.exe的同步。升级与验证要点思考配置验证运行packages/shared下的测试可复现 Fable 5 的思考解析行为重点观察三个断言——Fable 5 在off/minimizeThinking下是否回退为adaptive low以及 Opus 4.8 在off下是否仍返回disabled。模型元数据验证通过getModelById(claude-fable-5)可确认contextWindow 1_000_000传入 Bedrock ID如us.anthropic.claude-fable-5时应能通过反向映射解析出相同的模型定义。连接配置验证新建或回填 Anthropic 系连接时Fable 5 应出现在模型列表中且位于 Opus 之后这是PI_PREFERRED_DEFAULTS排序直接作用的结果。版本兼容性v0.10.3 声明零 Bug Fix、零 Breaking Change属于「新增能力 依赖升级」的平滑版本升级前无需额外迁移步骤。结语Craft Agent v0.10.3 是一次典型的「能力增量 依赖同步」发布Fable 5 的接入不只是往注册表里加一行而是牵动了 Bedrock 推理配置双向映射、Pi 桥接偏好排序、7 语言本地化与思考解析器的特化降级四层改动其中「自适应思考始终开启、禁止 disabled」这一模型侧约束被精确地转化为isAdaptiveThinkingAlwaysOnModel判定与adaptive low兜底策略并用完整的测试用例锁定了行为边界。对于希望深度定制模型接入或思考策略的开发者而言models.ts、claude-agent.ts 与 thinking-levels.ts 三份文件构成了完整的学习主线。【免费下载链接】craft-agents-oss项目地址: https://gitcode.com/GitHub_Trending/cr/craft-agents-oss创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
