用途：在本地与 Palantir Foundry 之间建立可复现的开发循环，让纯业务逻辑在本地快速迭代，同时把 Foundry 的预览、检查与构建视为独立证据。本地 mock 只能验证应用逻辑，无法证明 Foundry 的权限、血缘、事务或全量数据行为。
主要能力：Foundry Code Repositories 支持沙箱分支、自动检查、单元测试、预览、拉取请求与完整构建；预览可使用样本或子集数据，完整构建在平台数据上运行并提交管道输出；VS Code 扩展可从本地工作区执行预览、调试、同步并发起 Foundry 构建。
使用方式：先确认代码仓库或 Developer Console 应用、语言、分支、数据敏感度与目标环境，安装受支持的 Palantir VS Code 扩展或使用平台内工作区，阅读 references/official-docs.md 与仓库生成的平台内文档，准备不含生产数据的轻量单元夹具与沙箱分支。将纯转换或应用逻辑与 Foundry 适配器、生成的 SDK 代码分离，用合成夹具编写确定性单元测试并在任何平台请求前运行；同步沙箱分支、运行 Foundry 检查、在保护数据规则下预览代表性输入；需要时用 Foundry 调试器查看 Python 转换行为，但仅作诊断；推送确切分支，运行完整 Foundry 构建或有界 OSDK 冒烟测试，检查结果并提交经审查的拉取请求。
限制与边界：本地迭代不授权访问生产数据、回写、完整构建或合并；代表性受保护输入需数据所有者批准，合并或生产构建需仓库所有者批准。认证使用经批准的 Palantir VS Code 或 Developer Console 登录，OAuth 设置与测试凭据须存放在经批准的本地密钥存储中，不得将令牌或生产对象数据放入夹具、日志或仓库文件。若本地测试通过但 Foundry 检查失败，应对比依赖与构建环境；预览通过但完整构建失败，需检查全量数据边界、资源与输入事务，预览不能作为生产证明；生成的 OSDK mock 漂移时，应从 Developer Console 重新生成并针对固定包更新契约测试；调试器输出与已提交数据不一致时，以实际输出事务为准。
适用场景：重构转换逻辑并用合成单元测试覆盖行级归一化，再经 Foundry 预览与分支构建验证数据集集成；为应用单元测试 mock 生成的 OSDK 客户端，再运行有界非生产冒烟测试验证 OAuth 限制、对象选择与分页。
验证要点：单元夹具不含受保护生产数据；沙箱分支与本地工作区同步在同一确切提交；Foundry 检查与相关完整构建或冒烟测试通过；记录预览局限与环境差异；拉取请求获得所需的独立审查。任何实时操作前应重新核对带日期的契约，未解决或已变更的供应商行为应视为停止条件。