基线日期：2026-09-14

本离线手册按最新已提交实现与当前 WebUI 投影代码核对，而不是按旧版文档中的假设命令推演。CLI 基线为 0.7.3。

事实源边界

本页列出维护者可用于复核的仓库相对路径。普通开发者无需阅读这些内部源码才能完成 Agent 开发；当网站或 CLI 升级时，文档维护者应从这些实现入口重新核对命令、字段、状态和截图。

主题	当前实现位置	本手册据此确认
CLI 0.7.3	`services/oasn-supply-service/src/main/resources/developer-cli/oasn-sa-dev.py`（最新已提交开发基线）	命令树、来源选择、connect/resume、Portal、WebUI ports、凭据库与错误码
开发者首页	`frontend/openagent-official-website/apps/web/app/pages/developer/index.vue`	My OpenAgents 与 Create 入口
Agent 详情	`frontend/openagent-official-website/apps/web/app/pages/developer/agents/[agentId]/index.vue`	Agent/版本列表、Online/Offline 操作入口
版本工作台	`frontend/openagent-official-website/apps/web/app/pages/developer/agents/[agentId]/versions/[versionId].vue`	Program、Agent Card、Pricing、Save Draft、Publish、Build With Local Agent
Agent Card 编辑	`frontend/openagent-official-website/apps/web/app/pages/developer/agents/[agentId]/versions/[versionId].vue`	头像、名称、描述、单一 category 与 MOM 的版本工作台编辑和校验
Models / Resources	`DeveloperModelModal.vue`、`DeveloperResourceModal.vue`	模型能力和 CPU/Memory 计算规格界面
Pricing	`DeveloperDirectCostModal.vue`、版本工作台与 Publish pricing gateway	`cost_plus`、整数 Gross margin 与以 Credit 为单位的 Minimum Starting Balance
本地 Agent 引导	`DeveloperLocalAgentModal.vue`	复制完整可信提示的交互
可信固定 Skill 提示	`services/oasn-website-bff-service/src/main/java/com/oasn/website/developer/DeveloperSandboxService.java`	官网主流程的固定 Skill URL、Agent ID/Version ID 绑定和 `operation=build`
Workspace 生命周期	`DeveloperWorkspaceService.java`、`DeveloperWorkspaceMapper.java`	创建、active、终态、连接资料与过期语义
结构化 Invocation	`services/oasn-execute-service/.../ExecuteService.java`	`oasn.invocation.v1`、`input.user_prompt`、`input.attachments` 与敏感字段边界
WebUI block 解析	`openagent_developer_wrapper/openclaw/final-reply-adapter/workspace-output.mjs`	精确 fence、四字段 JSON、端口代理改写、URL 与敏感状态拒绝
最终结果投影	`FinalReplyProjectionValidator.java`、`InvocationResultV2Projector.java`	`url` 到 `structuredContent.views[].uri`、严格 boolean 与失败语义
发布任务	`DeveloperPublishJobService.java`、`DeveloperPublishJobMapper.java`	Job/Publication 状态以及发布后默认 Offline
公开页与客户端安装	`frontend/openagent-official-website/apps/web/app/pages/agents/[agent_id]/index.vue`、`services/oasn-website-bff-service/src/main/java/com/oasn/website/developer/DeveloperPortalRouteBuilder.java`	`user_agent_url=/agents/<publicSlug>`，以及 Use in ChatGPT、Claude、WorkBuddy 入口；公开 URL 不使用内部 Agent ID 猜测

随实现一起核对的测试

页面能力同时参考相邻的 *.test.ts，发布与 Workspace 行为参考服务端相邻测试。测试是防回归证据，但若测试夹具与生产代码冲突，以当前生产路径的可观察行为和服务契约为准。

frontend/openagent-official-website/apps/web/app/pages/developer/**/*.test.ts
frontend/openagent-official-website/apps/web/app/components/developer/*.test.ts
services/oasn-supply-service/src/test/** 中 Developer Workspace、Sandbox、Publish Job 相关测试

截图来源与隐私

本手册截图由当前官网前端在本地 E2E 脱敏夹具下生成，用于说明控件位置和状态转换；不包含真实账户、Token、SSH key 或生产数据。界面文字或布局变更后应重新生成截图，不能用旧截图证明新功能存在。

图片	说明
`06-agent-card.png`	Agent Card 字段
`07-pricing.png`	Pricing 字段
`09-publish-confirm.png`	发布确认
`10-publish-progress.png`	发布任务进度
`11-offline-go-online.png`	发布后 Offline 状态与 Go Online 操作

已明确排除的旧假设

CLI 0.7.3 已有 portal、workspace sources/connect/resume 和 version webui-ports get/set/refresh；旧版“全部不存在”的说法已排除。
官网版本表单仍没有 WebUI 端口字段；端口通过 CLI 管理，不能用 Resources 截图冒充。
当前没有通用 sync 或 workspace close/delete/publish 子命令，不能据新命令存在而扩大授权。
当前 Build With Local Agent 主流程返回固定 Skill URL 和绑定上下文的完整提示，不要求开发者手抄 Agent ID。
发布成功不会自动 Online；发布后默认 Offline，必须显式 Go Online。
底层存在字段或内部接口，不代表网站/CLI 已向开发者开放。

文档维护检查

从 CLI 的 argparse 命令树重新生成支持/不支持矩阵。
从版本工作台核对所有可见字段、必填校验与按钮。
从 Workspace 和 Publish 服务核对状态、完成门与失败语义。
用脱敏 E2E 夹具重新截取必要页面。
生成 assets/content.js 后，用 file:// 打开 index.html，逐页点击、搜索并检查图片。

可追溯原则

每个命令、状态和按钮都应能回到当前实现；无法在公开界面或 CLI 中证实的能力，明确写为限制，而不是补写一个“看起来合理”的步骤。