用途:为 Palantir 应用选择并封装合适的 SDK 边界。应用特定的 Ontology 访问使用生成的 OSDK,更广泛的平台操作使用 Platform SDK;封装传输层关注点,但不隐藏生成的实体契约、OAuth 授权、请求标识或 Action 校验。
主要能力:提供 SDK 选型决策记录、固定依赖版本、类型化客户端边界、认证提供方、分页与重试策略、生成契约用法、测试、遥测与脱敏规则以及升级流程。认证方面要求注入经批准的令牌提供方或 OAuth 客户端,禁止把长期令牌当作普通配置;日志可记录授权/主体标识与请求 ID,但不得记录 bearer 令牌、客户端密钥、对象值或受保护载荷。
使用方式:先确认应用任务、语言、所需 Ontology 实体或 Platform API 操作、写入行为与负责人;选定 Developer Console 应用或官方 Platform SDK 包并固定版本;阅读 references/official-docs.md、生成的应用文档与迁移指南;定义请求截止时间、分页上限、可重试状态、幂等性、遥测与密钥存储。实现一个客户端边界统一负责令牌获取、截止时间、请求关联、重试分类与遥测;实现确定性分页与属性选择,返回续页状态而非静默加载全部页面;保持生成的对象、Action 与 Function 定义对调用方可见,并在批准执行前校验 Action。
适用场景:需要以类型化、可审计方式访问 Palantir Ontology 或平台 API 的应用开发,尤其是涉及认证边界、分页、重试、幂等写入与 SDK 升级契约管理的场景。
限制:资料未提供具体安装命令、代码示例、价格或平台支持细节。工具使用需遵守审批边界:应用与平台负责人批准 API 面,安全负责人批准令牌处理,数据负责人批准返回属性与回写;共享客户端抽象不授权新端点。遇到包装器接受任意端点路径、助手加载全部页面、写入被自动重试或生成定义变更时,需按错误处理规则替换为类型化操作、有界分页、幂等或对账,并将生成定义变更视为契约迁移同步更新测试与调用点。