这份手册面向第一次接手 OpenAgent 的开发者，覆盖从官网创建草稿、在隔离 Workspace 中编写 Program、通过 WebChat 验证，到发布并上线的完整闭环。按“快速开始”顺序操作，不需要预先了解平台内部服务。
在官网版本工作台点击 Build With Local Agent，复制完整可信提示词并原样交给本地 AI。提示词已经绑定当前 Agent 和版本，本地 AI 会按平台 Skill 使用受校验的 CLI 建立开发 Workspace。
active 的隔离开发 Workspace，项目目录固定为 /oasn。登录官网进入 Developer，点击 Create。当前实现会同时创建 Agent 和它的第一个 draft 版本，并进入版本工作台。
在版本工作台点击 Build With Local Agent，复制完整可信提示词。不要改 Skill URL、操作类型或其中绑定的 ID。
本地 AI 通过 CLI 完成浏览器登录、来源选择、Workspace 创建、公钥绑定和真实 SSH 探测。只有 status=active 且 connect 返回 ssh_binding_status=bound、ssh_verified=true 后，才使用返回的 SSH/SCP 信息。
回到版本工作台配置 Agent Card、MOM、模型能力、Resources 中的 CPU/Memory 和 cost-plus 定价，然后保存草稿。
先在 WebChat 完成开发测试，再发布。发布成功后的默认状态是 Offline；点击 Go Online 后，从发布结果的公开 Agent 链接（或公开 Agents 列表的准确名称搜索结果）打开详情，通过 Use in ChatGPT/Claude/WorkBuddy 安装，并从实际客户端完成一次正式调用。
| 标识 | 代表什么 | 何时需要 | 可靠来源 |
|---|---|---|---|
agent_id | Agent 的长期身份 | 查看 Agent 详情、可信提示词绑定上下文 | 官网 Agent 详情；Build With Local Agent 生成的完整提示词 |
agent_version_id | 某个具体 draft/版本 | 创建开发 Workspace、绑定本次构建 | 版本工作台 URL；可信提示词 |
workspace_id | 一次隔离开发环境 | 创建超时后续查状态、定位当前 Workspace | CLI 创建结果或 WORKSPACE_TIMEOUT 错误 |
主路径中的可信提示词已经携带 Agent 与版本上下文，本地 AI 不应再次要求你手工输入这两个 ID。创建 Workspace 超时后，使用错误中返回的 workspace_id 查询原 Workspace，不要重复创建。
| 界面 | 负责 | 不负责 |
|---|---|---|
| 官网版本工作台 | 创建/编辑版本、模型、CPU/Memory、Agent Card、定价、发布、上线/下线 | 不直接编辑远程文件 |
| CLI 0.7.3 | 受校验安装、诊断/登录、来源选择、Workspace 创建/连接/续签、WebUI 端口和公开 Portal 操作 | 没有通用 sync 或 workspace close/delete/publish；写操作仍需明确授权 |
| 开发 Workspace | 在 /oasn 实现 Program，并通过 WebChat 做开发测试 | 不替代官网的版本发布和上线动作 |
ssh 与 ssh-keygen 的本机环境。Windows 安装脚本和生成的 oasn-sa-dev.cmd 默认使用 Python Launcher py；先确认 py --version 可运行。只有 python.exe 而没有 py 时，不要继续使用该 shim，应通过 python <CLI 安装路径> ... 显式运行，并在安装记录中保存该路径。