Show Worker
Octo 架构与接口体验台
一个只负责展示和试用的 Worker 页面：查看 Octo / Ogin 状态，理解 UserDO 与 OctoDO 的边界，并直接体验部分管理类与应用类接口。
当前页面
show.o3o3o.com
loading
实时状态
等待检测
未刷新
接口分层
完整目录按职责分组展示；每组固定高度，内部滚动。
U
UserDO 管理入口面向管理员或登录用户。负责判断权限，再把可信内部调用转给 OctoDO。
- WS
/ws/userdo连接某个用户的 UserDO，接收管理指令。 - POST
/api/userdo/octoHTTP 管理代理，转发到 UserDO 再内部调用 OctoDO。 - CMD
ping检查 WS 指令链路。 - CMD
app.get读取完整 app JSON 或某个嵌套字段。 - CMD
app.set像 JS 赋值一样替换 app 或设置 app.name / app.data.kv。 - CMD
app.delete删除 app JSON 内某个嵌套字段。 - CMD
app.upsert兼容旧管理流，合并更新 app。 - CMD
app.key.set设置或轮换某个 app 的 apikey。 - CMD
app.config.save保存 app prompt / tools / model。 - CMD
app.list列出当前 OctoDO 已安装 app。 - CMD
octo.call受 UserDO 权限控制的通用 OctoDO 调用。
M
OctoDO 管理类高权限接口。OctoDO 默认相信来自 UserDO 的内部管理调用。
- POST
/api/octo/set_meta写入 OctoDO 元信息。 - POST
/api/octo/install_apps批量安装内置 app 模板。 - POST
/api/octo/upsert_app创建或合并更新 app。 - POST
/api/octo/install_app从远程 install_url 安装 app。 - POST
/api/octo/list_app列出 app；管理侧可看完整对象。 - POST
/api/octo/app_json_get读取 raw app JSON。 - POST
/api/octo/app_json_put整体替换 raw app JSON，并同步 key 映射。 - POST
/api/octo/delete_app删除 app 及相关配置。 - POST
/api/octo/enable_app启用 app。 - POST
/api/octo/disable_app禁用 app。 - POST
/api/octo/sort_app更新 app 排序。 - POST
/api/octo/appkey_set为 app 设置或轮换唯一 key。 - POST
/api/octo/appkey_create兼容旧接口，创建/轮换 key。 - POST
/api/octo/appkey_list列出 source key。 - POST
/api/octo/appkey_delete删除 app key 和全局映射。 - ALIAS
/api/app/apikey_*apikey 管理别名：set/create/list/delete。 - ALIAS
/api/octo/app/apikey_*octo 命名空间下的 apikey 管理别名。 - POST
/api/octo/app_config_get读取 app prompt / tools / model。 - POST
/api/octo/app_config_save保存 app prompt / tools / model。 - POST
/api/octo/base_model_get读取 Octo 基础模型配置。 - POST
/api/octo/base_model_save保存 Octo 基础模型配置。 - POST
/api/octo/set_model保存某个 model_id 的 prompt/tools。 - POST
/api/octo/reset_model清空某个 model_id 的上下文。 - POST
/api/octo/system_config_get读取 system model prompt/tools。 - POST
/api/octo/system_config_save保存 system model prompt/tools。 - GET
/api/octo/system_contents查看 system model 最近上下文。 - ANY
/api/octo/memory/*记忆系统管理与查看。
A
OctoDO 应用类外部 app 调用。需要 app key 或 session，只能做运行时动作。
- POST
/api/octo/notifyapp 通知 system model，进入任务队列。 - POST
/api/octo/app_data_get读取某个 app 的用户数据。 - POST
/api/octo/app_data_set写入某个 app 的用户数据。 - POST
/api/octo/app_data_delete删除 app 数据或某个 key。 - POST
/api/octo/user_chat用户消息入口，先进入 userChat Agent。 - GET
/api/octo/user_chat_history读取用户对话历史。 - POST
/api/octo/session_create基于 app key 创建短期 session。 - POST
/api/octo/session_revoke撤销 session。 - POST
/api/octo/session_validate校验 session。 - POST
/api/app/chatapp 通用聊天入口。 - POST
/api/app/notifyapp 通知别名。 - POST
/api/app/email兼容 app 运行入口。 - POST
/api/app/run兼容 app 执行入口。 - POST
/api/octo/app/chatocto 命名空间下的 app chat。 - POST
/api/octo/app/notifyocto 命名空间下的 app notify。 - POST
/v1/chat/completionsOpenAI 兼容入口，内部 app model 调用。 - WS
/ws/octoOctoDO 实时连接，推送 notify、app_list、chat 等事件。 - GET
/api/desktop/init桌面初始化，换取 Octo WS token。 - GET
/desktop*桌面相关页面或资产入口。
P
Platform 接口Worker 层入口。负责 Octo 实例生命周期、public forwarding 和 app key 映射。
- POST
/api/platform/octo/create创建或初始化某个用户的 OctoDO。 - GET
/api/platform/octo/list列出平台内 OctoDO 元信息。 - POST
/api/platform/octo/delete删除 OctoDO 元信息和 key 映射。 - ANY
/api/*?octo=<id>带 octo 参数的公开转发，只允许应用类安全路由。 - ANY
/api/octo/* + Bearer appKey无 octo 参数时通过全局 key 映射定位 OctoDO。 - ANY
/api/app/* + Bearer appKey应用接口别名，通过 key 映射转发到 OctoDO。 - WS
/ws/octo?token=wst_*一次性 WS token 连接 OctoDO。 - WS
/ws/octo?octoId=&key=admin key 或 session token 连接 OctoDO。 - KV
OctoDOID:<key>全局 key 到 OctoDO 的映射。 - KV
OctoMeta:<octoId>Octo 实例元信息。 - DO
OCTO_DOWorker 到 Durable Object 的绑定。
调用链路
用户对话不一定进 system model，先由 userChat Agent 判断。
用户消息进入
/api/octo/user_chat，先交给 userChat Agent。→
userChat Agent能直接答就直接推送；需要调用 app 时发送高优先级任务。
→
Octo System Model从通知队列取任务，调度已安装 app，再把结果回调给 userChat。
实时状态
由 Show Worker 代为检测基础服务是否可达。
UserDO WS 指令台
管理类体验。需要 userId 和临时 god key；页面不会保存。
WS
连接与指令管理指令会真的改目标用户的 OctoDO。测试
app.set 前建议使用一个 demo appid。LOG
WS 实时日志Octo 应用类 HTTP Demo
应用类体验。需要 Octo ID 和 app key/session。
API
请求构造器应用类接口只应该做运行时能力：通知、数据、聊天、session。不要把管理类接口暴露给外部 app。
OUT
响应