OpenWeb

面向 Agent 的网站访问方式。通过 API 桥接 Agent CLI 与 Web GUI。

加载规范

• 不要读取该目录下的所有文件。
• 从 SKILL.md 入手，每次仅沿一条路径推进。

使用已有站点

1. 查找站点

openweb sites                        # 列出所有可用站点

若该站点尚无对应包，切勿声明“不支持”，应转至 add-site/guide.md。

2. 检查就绪状态

openweb                        # 传输层、认证方式、操作列表

• Requires browser: yes — 需要时自动启动浏览器；无需手动配置
• Requires login: yes — 用户需通过其浏览器会话完成登录

3. 阅读站点说明文档

若工作区中存在站点文档，请优先查阅：

• 源码仓库：先阅读 src/sites//SKILL.md（了解工作流与意图映射），再阅读 src/sites//DOC.md（了解内部实现）。
• 已发布/运行时包：仅 DOC.md、规格说明（specs）、清单（manifest）、示例（examples）及适配器（adapters）被保证包含在内。各站点专属的 SKILL.md 和 PROGRESS.md 属于源码树文档，不会被发布至 $OPENWEB_HOME/sites// 目录下。

若仅有已发布的包可用，则依赖 openweb 、openweb 、示例及 DOC.md 进行操作。

4. 检查操作详情

openweb                    # 参数定义、响应结构、权限等级
openweb   --example        # 来自 fixtures 的真实参数示例

执行前请确认该操作的权限等级：

5. 执行操作

openweb   '{"key":"value"}'    # stdout 输出 JSON，stderr 输出 JSON 格式错误信息

自动溢出（Auto-spill）：响应体超过 4096 字节时，将写入临时文件。

openweb exec '{...}' 等价于上述命令 — 当第三个参数为 JSON 时，可省略 exec。

6. 执行失败处理

stderr 中的错误信息包含 failureClass 字段：

若上表未覆盖当前问题，请查阅 references/troubleshooting.md。

7. 站点缺失或功能覆盖不足

站点不存在，或缺少所需操作？请阅读 add-site/guide.md。

添加 / 扩展 / 升级站点

请阅读 add-site/guide.md

修复问题

请阅读 references/troubleshooting.md

文件映射

所有路径均相对于 skills/openweb/。

add-site/（工作流 — 按顺序加载）

references/（查阅用 — 可独立加载）

knowledge/（模式库 — 在关键决策点加载）