docs: 补齐 Run 转交、会话历史与附件媒体 API

[yi-ge]

变更说明

按本批实施范围，补齐 Run 转交契约、会话历史与消息、附件与媒体的公开接入文档：

• 修正中英文 RunMeta 五态及只读转交字段；按实际 HTTP 行为保留 runtime-state 四态，并明确已转交 Run 返回 404，不能推断成功、失败或记录不存在。
• 新增六个历史/消息/话题 GET 和五个附件/媒体操作的中英文指南、参数、分页、权限与错误说明。
• Agent Service OpenAPI 描述版本升至 1.1.0，扩至 27 操作；全站公开清单为 10 组双语页面、35 操作。模型代理与 Workflow 规范保留原来源基线。
• 提供无依赖 history/attachment Node.js 示例；对话客户端支持上传收据引用、冻结摘要与保守转交处理，三个静态下载副本逐字一致。
• 更新导航、认证/代理提示、稳定下载链接、离线检查器及本批验证记录。既有生产、部署和搜索验收记录保持各自历史含义。

固定源码：desirecore/desirecore@7fe016c76ab98e0643ab4f2710c3733f757ef4fb；内部文档 gitlink：b17e6a7a2d3dc4d969ea422ee37825ae39eb6177。

核查中发现的关键差异

共享 RunRuntimeState Schema 已接受 handed_off，但实际路由仍使用四值过滤。本批更正前次仅凭 Schema 得出的推断，文档与规范以真实 HTTP 行为为准，没有修改服务运行行为。客户端不把转交观察当终态，也不自动追踪目标 Run。

测试方式

• pnpm api:check：10 组双语页、35 操作、66 个 JSON 代码块、3 份规范，通过。
• pnpm typecheck、中英 pnpm build、pnpm api:check -- --build 通过。
• 独立示例 3 文件 41 项通过：对话 16、附件 12、历史 13。
• 固定源码定向验证 7 文件 55 项通过：既有 Run/附件/媒体/投影 47，历史/Run 实际路由夹具 5，客户端实际 Query 准入与上传下载链路 3。
• Redocly CLI 2.63.0：三规范零错误；保留既有 47 条条件 Schema 与 3 条 license 告警。AJV Draft 7：68 个 Schema 编译、44 个 JSON 媒体示例通过。
• 本机生产构建浏览器：新增中英文页面 375px 无整页水平溢出；1440px 下历史/OpenAPI 页面正常，语言链接正确；下载链接 HTTP 200，规范操作数 27/3/5。
• 三个 subAgent 并行实现并独立交叉审阅；已修正附件嵌套字段说明、历史停止记录的 nextOffset 及稳定下载链接。

完整验证与限制：api/history-attachments-verification.md。

验证边界

模型管线、部分客户端集成的握手/Run 快照及续问回调使用替身；未验证商业模型处理附件、真实会话转交、桌面发行安装包或用户业务副作用。本 PR 尚未合并，不代表已完成生产部署或 Algolia 收录；合并后由现有流水线自动部署。

[vercel]

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

Project	Deployment	Actions	Updated
docs	Ready	Preview	Oct 15, 2026 2:27pm UTC