OpenAgent 开发者手册（离线版）
实现基线：2026-09-14（最新已提交 release-0825 实现）
CLI 基线：oasn-sa-dev 0.7.3
语言：简体中文 / English

如何阅读
========

1. 保留整个目录结构，不要只复制 index.html。
2. 双击 index.html，用 Edge、Chrome 或其他现代浏览器打开。
3. 顶部“语言 / Language”可切换完整中文或英文正文，并保留当前章节。
4. 左侧目录可切换章节；顶部可搜索当前语言的命令、步骤和错误码。
5. “打印全部 / Print all”会把当前语言的所有章节展开为适合打印/另存 PDF 的版式。

如果看到空白或“正文数据包不存在”
==============================

请确认下列文件仍在原来的相对位置：

  index.html
  assets/content.js
  assets/app.js
  assets/styles.css
  assets/screenshots/*.png

重新解压完整目录后再打开。不要从目录中单独拖走 index.html。

本包包含
========

- 19 个开发章节：创建、CLI、Workspace、Program、同步、模型/集成、测试、发布、上线与排错。
- 每个章节都有中文和英文正文；两种语言使用相同路由并保持章节一一对应。
- 11 张由当前官网前端和脱敏 E2E 数据生成的界面截图。
- examples/minimal-summary-agent：可跟做的最小摘要 Agent 示例。
- content/*.html 与 content/en/*.html：可维护的中英文章节源文件。
- README.en.txt 与示例目录中的 *.en.md：英文离线说明和英文跟做材料。
- tools/build-docs.mjs 与 tools/validate-docs.mjs：确定性构建和离线校验脚本。

离线边界
========

正文、样式、脚本、截图和示例都可离线阅读。真正登录官网、获取实时 Skill/CLI、创建 Workspace、打开 WebChat、发布和上线时仍然需要网络。CLI 文件和 SHA-256 不固化进本包；请始终使用官网 Build With Local Agent 生成的可信提示词中当次绑定的下载信息。

维护者重新生成
==============

在本目录中使用 Node.js 运行：

  node tools/build-docs.mjs
  node tools/validate-docs.mjs

生成后务必用 file:// 方式打开 index.html，分别切换中文和 English，逐页检查目录、搜索、截图、当前章节保持和打印预览。
