Skip to content

docs: 同步当前功能、权限与开发指引 - #432

Merged
Qiyuanqiii merged 5 commits into
mainfrom
Qiyuanqiii/docs-current-state
Oct 22, 2026
Merged

Qiyuanqiii merged 5 commits into
mainfrom
Qiyuanqiii/docs-current-state

Conversation

@Qiyuanqiii

@Qiyuanqiii Qiyuanqiii commented Oct 21, 2026 •

Copy link
Copy Markdown
Member

当前使用指引仍把已上线的能力写成待实现,部分版本和授权说明也落后于代码。本 PR 同步当前说明,保留历史 ADR 和验收记录的原始结论,并补齐阻塞本分支 CI 的工具链与浏览器启动修复。

  • 同步 React 19、Ask / Auto / Full 的实际授权行为,移除未经测量的 120fps 和物理折射宣传。
  • 更新长测试 start/wait、受授权 worker、模型读取技能、原生目录及 URL/Git 导入说明;重复技能版本表改为引用统一目录和源码清单。
  • 将当前 schema 指向生成元数据,修正 Analyzer 已接入产品的说明、Web 组件路径和认证步骤;补齐英文资源文档入口。
  • 标明首版发布记录的历史日期,并提供当前预览包入口。fix: verify startup and download docs and resolve CI failures #430 正在处理的启动命令、下载与平台发行说明不重复修改。

验证:go test ./internal/releasegate ./internal/producte2e、git diff --check 均通过;修改文档中的 265 个本地链接目标存在。浏览器实拍并查看了下方 README 渲染前后图。文档中的全部产品能力未逐项重新验收;追加代码修复的 CI 结果见下文。

覆盖范围:扫描仓库 434 份 Markdown 的本地链接;全文阅读 README 中英文版、CONTRIBUTING、发布记录、schema/项目测试、Web/Analyzer README,以及项目准备、沙箱、内置技能、扩展、代码智能、调度诊断、Computer Use、检查点说明。usage、architecture、technical-reference 中英文、HTTP API、v2 README 为针对性阅读;其余历史文件未做逐行审阅。本地 output/ 历史证据链接未作为当前产品功能缺陷处理。

真实截图为 GitHub Markdown API 渲染实际 README“核心特性”原文后,在 Chromium 1120×850 视口捕获的文档页面;修改前来自 0e59333,修改后来自本次提交,不代表产品界面有视觉变更。

修改前 修改后
修改前 修改后

CI 修复与验证

  • Go 固定版本更新到 1.26.10,同步构建说明,修复漏洞扫描报告的 GO-2026-6809;复用 fix: verify startup and download docs and resolve CI failures #430 的 db8fdfb8,包括浏览器取消后的清理验证。
  • 修正 macOS 浏览器的 3 分钟启动预算被内部 30 秒和握手 5 秒提前截断的问题。握手使用剩余启动期限,取消可立即中断等待,错误保留底层原因;Windows 启动预算仍为 30 秒,其他有界 CDP 会话仍为 5 秒。
  • 页面测试在 Run 不可用时及时失败,继续检查真实截图与进程清理。
  • DMG 创建只对明确的 Resource busy 最多尝试 3 次,间隔 2/4 秒,清除本次私有目录中的不完整镜像。其他错误、超时和持续繁忙仍失败;保留挂载、文件哈希/权限和签名校验。参考 create-dmg 的对应处理。

本地验证:浏览器运行时测试与 vet、releasegate/producte2e、E2E 类型检查通过;漏洞扫描无可达问题。新增期限回归在旧 30 秒实现失败,慢握手回归在旧 5 秒实现失败,修复后均通过,取消与短期限也已验证。DMG 重试、永久错误、重试耗尽和超时检查通过。

本机 Edge 的一次布局测试在退出时遇到目录占用,原样复测通过;取消测试通过。远端 Windows 标准用户 Edge 验证与桌面检查均通过。DMG 完整测试与实际构建由原生 macOS runner 验证。

最新提交 fc0935d6fc03ca7abccbd148ce52d26c2bc154f8 的 CI 和 Desktop release 均成功:27 项通过、2 项按预览流程跳过,0 失败、0 等待。包括 Intel/ARM macOS 真实浏览器页面检查和 ZIP/DMG 构建,以及 Windows 桌面、真实 Edge 和可重复构建检查。

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.

2 participants