OpenAgent
OpenAgent

创建与连接

连接本地 Agent

Build With Local Agent 是官网与本地 AI 之间的可信交接点。它把当前版本上下文放进一段可审计提示词，让本地 AI 按平台 Skill 执行，而不是让开发者手工拼接 API、ID 或远程连接参数。

当前实现使用固定 Skill URL

https://oasn-ow.haimawan.com/s/oasn-sa-developer-workspace/SKILL.md。官网把这个地址与当前 agent_id、agent_version_id、operation=build 组合成可信提示词。按钮本身不会为每次点击创建动态短链接。

从官网复制可信提示词

  1. 确认当前 draft

    在版本工作台先核对 Agent 名称、版本号和 draft 状态。不要从历史聊天或另一个浏览器标签复用旧提示词。

  2. 点击 Build With Local Agent

    弹窗中的内容应同时包含固定 Skill URL、构建操作和当前 Agent/Version ID。若内容缺失，关闭弹窗并从正确版本重新打开。

  3. 复制全部内容

    从第一行到最后一行完整复制。不要只复制 Skill URL，也不要把 ID 替换为名称、版本标签或从其他页面找来的值。

  4. 原样发送给本地 AI

    本地 AI 应把这段提示词视为本次构建授权的上下文，先读取 Skill 再行动。提示词已经绑定 ID，因此不应再次要求你输入 Agent ID 或 Version ID。
版本工作台的 Build With Local Agent 可信提示词弹窗
可信交接内容。 使用官网当前版本生成的整段提示词；截图中的 Agent 与版本 ID 已脱敏。

本地 AI 接下来应该做什么

  1. 读取固定 URL 对应的静态开发 Skill，并只进入其中的 build 流程。
  2. 在确实需要建立 Workspace 时，使用 Skill 内绑定的 CLI URL 与 SHA-256 执行受限 bootstrap。
  3. 校验 HTTPS、下载大小、响应头 SHA-256 与文件正文 SHA-256，再运行 CLI 自带的 install --expected-sha256。
  4. 运行 doctor 和 workspace sources --version-id <agent_version_id>，把已有 Workspace、可恢复版本和 fresh 选项展示给你选择，不能自行接受推荐来源。
  5. 复用你确认的已有 Workspace，或使用 --source-version-id/--fresh 创建 Workspace，并等待 status=active；创建本身不读取、生成或上传 SSH key。
  6. 对 active Workspace 执行 workspace connect --workspace-id <workspace_id>。只有返回 ssh_binding_status=bound 且 ssh_verified=true 后，才使用该次 connect 返回的完整 SSH/SCP 信息操作 /oasn。

安装前只有 Skill 的受限 bootstrap 可以运行 Python helper

不要让本地 AI 改用 curl、wget、原始平台 HTTP 或自行编写的登录脚本。若当前 AI 没有本地终端/Python 能力，才通过浏览器人工下载 Skill 指定的固定文件，并保持相同摘要校验。

你需要分别确认的动作

动作何时确认确认后允许的范围
安装 CLISkill 已给出固定 URL/摘要且校验全部通过安装已校验的 CLI 0.7.3 或更新版本到当前用户目录
创建 SSH 密钥doctor/ssh-key ensure 确认没有现有公钥创建一对专用密钥；拒绝覆盖任何已有文件
选择来源workspace sources 已列出当前真实选项仅复用或创建你明确选择的来源；推荐值不是自动授权
连接 WorkspaceBuild With Local Agent 已授权本次构建，且 Workspace 为 active可用现有匹配私钥绑定并探测本次 Workspace；若需创建新 key 仍须另行确认
同步文件已展示临时副本差异并完成敏感信息扫描先上传到本轮 /oasn/.oasn-staging/<run-id>/，校验后应用到明确目标

“把这份提示词交给本地 AI”不等于授权它覆盖原始本地文件、连接任意主机、上传整个目录或扩大到其他 Agent/版本。每个有外部影响的动作仍应保持最小范围。

发现上下文异常时

应该做

  • 回到预期版本，重新打开弹窗并完整复制。
  • 让本地 AI 复述即将使用的 Version ID 与操作类型。
  • Workspace 超时时保存返回的 Workspace ID，并查询同一个环境；active 后仍执行 connect。

不要做

  • 根据 Agent 名称或版本号猜平台 ID。
  • 把提示词中的 build 改成发布或其他操作。
  • 把另一个 Agent 的 SSH/SCP 命令拼到本次上下文。

兼容命令不是推荐入口

CLI 仍保留 oasn-sa-dev skill-link create --version-id <id> 作为兼容能力，但当前官网主流程已经直接提供固定 Skill URL 与绑定 ID 的可信提示词。新开发流程不要先运行兼容命令，也不要把旧文档中的“每次生成 24 小时短链接”当作当前按钮行为。

继续：安装并使用开发 CLI。

搜索文档

推荐搜索