# 文档变更分析
### 1. 总体摘要
此次更新核心在于 **Microsoft Foundry 平台的重大升级**(从 Beta 转为正式发布 GA),引入了新的 Azure 托管选项、全平台统一的 1M 上下文窗口支持以及明确的 CCU 计费模式。此外,文档中统一更新了 Node.js 代码示例的模块导入规范。
### 2. 关键变更主题
* **Microsoft Foundry 正式发布 (GA)**:移除了所有功能(如自动缓存、引用、自适应思考等)的“Beta”标记,标志着其在功能完整性上已与 Claude API 和 AWS 平台持平。
* **引入新的托管选项**:在 Foundry 中新增了“Hosted on Azure”(Azure 托管)与“Hosted on Anthropic”两种模式,前者允许推理在 Azure 基础设施上运行,以增强数据驻留合规性。
* **上下文窗口统一**:确认 Microsoft Foundry 现已支持完整的 1M token 上下文窗口,移除了之前仅限 200k 的限制。
* **计费与合规细节明确**:新增了“Claude Consumption Units (CCU)”计费说明($0.01/CCU),并明确了美国数据区域部署的 1.1x 价格倍率。
* **Node.js 代码规范更新**:将核心模块导入从 `fs` 更新为 `node:fs`,符合现代 Node.js 最佳实践。
### 3. 影响等级:**高**
**理由**:对于使用 Microsoft Foundry 的开发者,此次变更不仅仅是文档更新,更是产品功能的实质性扩展(特别是 Azure 托管模式和 1M 上下文支持)。这可能影响架构决策(数据驻留)、成本预估(CCU 计费)以及代码维护(移除旧的限制性配置)。
### 4. 开发者行动项
* **重新评估托管架构**:如果在 Foundry 上部署,需在“Hosted on Azure”(数据保留在 Azure 内)和“Hosted on Anthropic”(功能更全)之间做出选择。
* **移除旧的限制代码**:检查针对 Foundry 的代码,移除任何基于 200k 上下文窗口的变通方案或 Beta 头部信息。
* **更新成本模型**:熟悉 CCU 计费逻辑,若使用 US Data Zone Standard 部署,请注意 1.1x 的定价倍率。
* **遵循 Node.js 最佳实践**:将项目中的 `import fs from 'fs'` 等语句更新为 `import fs from 'node:fs'`,以避免与第三方库命名冲突。
* **审查 Foundry 迁移指南**:参考更新后的 [migration guide](/docs/en/about-claude/models/migration-guide),确保从旧版本或 4.7 平滑升级至 4.8 时考虑 Foundry 的最新特性。
💭 Model Reasoning
1. **Understand the Goal**: The user wants a world-class programmer's analysis of a batch of documentation changes. The response must be in Chinese, in markdown format, concise, and insightful. It needs to cover four specific areas: Overall Summary, Key Themes, Impact Level, and Action Items.
2. **Analyze the Source Material (Diffs)**:
* **Page 1: `about-claude/models/migration-guide.md`**
* *Change*: Removed a note stating Microsoft Foundry has a 200k context window (initial launch limitation). Updated text to say 1M context window applies to Foundry as well (API, Bedrock, GC, Foundry).
* *Significance*: Microsoft Foundry now supports the full 1M context window, removing the previous limitation.
* **Page 2: `about-claude/pricing.md`**
* *Change*: Added a new section "Claude in Microsoft Foundry pricing". Details CCU (Claude Consumption Units) billing ($0.01/CCU). Added "Inference geography" for Foundry (US Data Zone Standard = `inference_geo: "us"`, 1.1x multiplier). Updated text regarding `inference_geo` parameter scope.
* *Significance*: Foundry billing is now clearly defined (CCUs), and data residency pricing (1.1x multiplier) is confirmed for US Data Zone deployments.
* **Page 3 & 4: `build-with-claude/overview.md` & `build-with-claude/text-generation.md`** (Identical diffs)
* *Change*: Updated "Availability" column in feature tables. Changed `<PlatformAvailability ... azureAiBeta />` to `azureAi`.
* *Significance*: Microsoft Foundry is now generally available (GA) / stable, out of beta, for features like Context windows, Adaptive thinking, Citations, Effort, and Extended thinking.
* **Page 5, 6, 9, 10: `vision.md`, `pdf-support.md`, `files.md`, `code-execution-tool.md`**
* *Change*: Changed `import fs from "fs"` or `import fs from "fs/promises"` to `import fs from "node:fs"` or `import fs from "node:fs/promises"`.
* *Significance*: Node.js best practice update. Using explicit protocol (`node:`) for built-in modules avoids conflicts with local modules named `fs`.
* **Page 7: `build-with-claude/prompt-caching.md`**
* *Change*: Removed "(beta)" mentions for Microsoft Foundry in various notes (automatic caching, cache isolation, etc.).
* *Significance*: Prompt caching features for Foundry are now GA (matching the "azureAi" change in other docs).
* **Page 8: `build-with-claude/claude-in-microsoft-foundry.md`**
* *Change*: Massive rewrite.
* "Preview" removed/replaced with general availability context.
* New section "Hosting options": Distinguishes between "Hosted on Azure" vs "Hosted on Anthropic".
* Azure hosting: Inference runs on Azure infra, prompts remain in Azure (metadata/safety flags egress).
* Deployment types: Global Standard, US Data Zone Standard.
* Updated provisioning steps (new portal flow).
* *Significance*: Foundry integration has matured significantly. New hosting option (On Azure) implies data residency compliance benefits. New provisioning flow.
3. **Synthesize the Analysis**:
* **Overall Summary**: The primary focus is the graduation of **Microsoft Foundry** from Beta to General Availability (GA), specifically introducing new Azure-hosted deployment options and full 1M token context window support. Additionally, minor code updates were made to use Node.js explicit imports.
* **Key Themes**:
* **Microsoft Foundry GA**: Removal of "beta" tags across multiple features (caching, context windows, etc.).
* **New Hosting Option**: Introduction of "Hosted on Azure" vs "Hosted on Anthropic" within Foundry.
* **Data Residency & Pricing**: Clarification of US Data Zone pricing (1.1x multiplier) and CCU billing.
* **Context Window Equality**: Foundry now supports the full 1M context window (no longer limited to 200k).
* **Node.js Best Practices**: Updating import statements to use `node:` protocol.
* **Impact Level**: **High** (or Medium-High).
* *Reasoning*: The Foundry changes represent a major platform update (GA status, new hosting model, billing changes). If a developer is using Foundry, they need to know about the new hosting options and the removal of context limits. If they are just using the raw API, the impact is lower, but the Foundry section is substantial.
* **Action Items for Developers**:
* Review Foundry deployment options: Decide between "Hosted on Azure" and "Hosted on Anthropic".
* Update code if using Foundry: Remove any context window limitations (beta headers).
* Check billing: Understand the CCU (Claude Consumption Units) billing model.
* Consider Data Residency: If using Foundry for US data, note the 1.1x pricing multiplier for US Data Zone.
* Code Hygiene: Update Node.js imports to `node:fs`/`node:fs/promises`.
4. **Draft the Response (in Chinese)**:
* *Drafting Summary*: 此次文档更新主要集中在 **Microsoft Foundry 平台的重大升级**(从 Beta 转为 GA),包括新的 Azure 托管选项、1M 上下文窗口支持及 CCU 计费模式,同时更新了 Node.js 代码示例中的最佳实践。
* *Drafting Themes*:
* Microsoft Foundry 正式发布 (GA):移除了 Beta 标签,功能完全可用。
* 新增托管选项:区分“Azure 托管”和“Anthropic 托管”。
* 上下文窗口升级:Foundry 现支持完整 1M token。
* 计费与合规:明确了 CCU 计费单位及美国数据区域的定价倍率。
* Node.js 代码优化:统一使用 `node:` 前缀导入核心模块。
* *Drafting Impact*: **High**。对于使用 Foundry 的开发者,这是功能上的重大扩展和配置流程的变化。
* *Drafting Actions*:
1. 评估 Foundry 托管模式(Azure vs Anthropic)。
2. 移除 Foundry 相关的 200k 上下文限制代码。
3. 熟悉 CCU 计费模式。
4. 更新 Node.js 导入语句(`fs` -> `node:fs`)。
5. **Refine and Polish**: Ensure the tone is professional and "world-class". Make sure the markdown formatting is correct.
* *Self-Correction during drafting*: The Node.js change is minor but good to mention as a best practice update. The Foundry changes are the "meat" of this update. The migration guide change is important because it affects the actual code if someone was working around the 200k limit.
6. **Final Output Generation** (matches the requested structure).