Skip to content

docs: 同步 API 隐私投影与稳定性边界 - #79

Merged
yi-ge merged 1 commit into
mainfrom
codex/api-stability-20261022
Oct 23, 2026
Merged

yi-ge merged 1 commit into
mainfrom
codex/api-stability-20261022

Conversation

@yi-ge

@yi-ge yi-ge commented Oct 22, 2026

Copy link
Copy Markdown
Member

变更说明

结合最新固定源码 a101a40c14cc9d478c7f9a23d8a125ac2404509b,复核35个已公开HTTP操作及相关事件和恢复边界。

  • 中英文指南同步历史、快照和话题的敏感工具结果占位、正文引用移除与失败状态保留规则。
  • 增加响应扩展、未知状态、描述版本、能力探测和重试边界说明;补充 query:retrying/query:warning 的可选请求关联规则。
  • Agent Service OpenAPI描述修订为1.1.1,完善历史工具结果字段;更新公开清单来源基线,修正AgentSummary Schema来源路径。
  • 加强读取器透传脱敏/可选字段的测试及真实历史路由隐私回归,不从占位自动获取正文或发起执行。
  • 本批继续维持35操作。RunMeta五态与runtime-state HTTP四态、转交404的实际差异保持准确说明。

内部文档gitlink:34178859da7a70cfab0b4726b85d9a37f22608a7。源码与公开规范的版本、权限、返回视图分别核对,没有推断客户端首次生效版本。

测试方式

  • 当前固定源码:既有4文件34项 + 真实历史路由夹具6项,共40项通过。
  • 独立Node示例:41项通过。
  • pnpm api:check、pnpm typecheck、双语 pnpm build、pnpm api:check -- --build 通过。
  • AJV Draft7:68个Schema编译及44个JSON媒体示例通过。
  • Redocly CLI2.63.0:三规范0错误,保留既有47条条件Schema和3条license告警。
  • 55个固定提交/来源路径组合检查通过;完整diff检查通过。

验证记录:api/stability-verification-2026-10-22.md。

验证边界

本批为契约与文档一致性复核,没有进行服务SLA压测、真实商业模型或发行安装包验收。源码夹具中的本机profile与运行时发现为替身,鉴权、路由、临时SessionStore为实际代码。此前生产和搜索验收记录保留原有基线,本PR尚未合并或发布。

@vercel

vercel Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Oct 22, 2026 4:02pm UTC

Request Review

@yi-ge
yi-ge merged commit 6667165 into main Oct 23, 2026
6 checks passed
@yi-ge
yi-ge deleted the codex/api-stability-20261022 branch October 23, 2026 09:04

This branch was successfully deployed

1 active deployment
Preview — 0ab3a6b1 Deployed Oct 22, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant