HybridInference Cloud Agent
English
简体中文
快速上手
完整的本地环境
运行
端口与多套环境并行
沙箱网络
通过本地代理构建
冒烟测试测了什么
在轮次进行中试试各种交互
开发者指南
准备本地仓库
找到改动该落在哪里
守住依赖边界
选择要跑的检查
在本地跑 CI
修改 API
打包与文档
代码结构
先看部署边界
跟着一个控制平面请求走
API schema 按领域划分
跟着一次主机执行走
共用的操作性能剖析
跟着一次浏览器操作走
加功能时别把结构弄乱
贡献指南
一句话流程
提交评审前的检查
持续集成
契约
翻译文档
改了英文页面之后
中文文风
中文里的坑
中文术语
概念
原生会话的上下文记忆
上下文状态
共享边界上的原生会话身份
其他原生 CLI
这次发布解决了什么，还剩什么
上线验收前的检查
Agent 准入策略
权限与请求检查
出错时的表现
基础设施凭据
验证网关契约
上线步骤
Agent 只保存最少的身份信息
令牌与会话
数据库身份边界
升级现有部署
回滚和恢复时的限制
本服务依赖的网关契约
这些文档是什么，不是什么
来源 commit
这些文档没有覆盖的内容
这里唯一属于我们自己的文档
怎样检查
安全
报告漏洞
受理范围
部署时不能想当然的地方
面向所有者的 Web 应用
侧边栏和对话列表
创建仓库
新手引导
对话列表 API
对话视图
轮次导航条
阅读位置
任务和子代理
工作区面板的键盘操作
在浏览器里检查
工具审批
记忆、头像和首页建议
记忆
头像和首页建议
工作区文件
其他小功能
运维
Cloud Agent 沙箱运维手册
Admin Settings
沙箱归档存储
数据库浏览器
pgAdmin
一个任务会做什么
临时工作区
自动生成任务标题
改写草稿提示词
对话状态和运行历史
agent 的原生提问
谁能对哪个仓库运行任务
沙箱清单、资源用量与操作
所有者的 Usage 页面
查看任务记录下来的事件
团队
MCP 服务器
监听器与连接
授权与路由
端到端测试覆盖
Connector 的配置
部署与回滚
运行时边界
--strict-mcp-config
挡住的是什么
任务真正跑起来之前
0. 沙箱网络需要主机防火墙规则、一个 DNS 解析器和两个中继
1. 只有已注册的沙箱主机才会运行任务
2. 凭据
自行部署运行
主机配置参考
在 runner 主机上配置 Kata
Guest 内的进程追踪与成员隔离
Guest 的网络
已有的 runc 沙箱组与激活时的检查
调度与运行时证明
需要多少 runner
清理成员进程
Fork 的兼容性与轮次顺序
执行槽位
移除服务器
沙箱设置
沙箱归档
可恢复检查点
恢复被移除主机上的沙箱
环境安装快照
启动失败与队列顺序
沙箱组唯一的空闲计时（以及几个独立的安全看门狗）
attempt 租约丢失
安全看门狗
Resume、Fork 与发布
滚动部署顺序
主机和控制平面何时就绪
回滚的兼容性
冷启动与部署失败
保留旧迁移链的数据库
重建 Agent 数据库
执行不向后兼容的迁移
主机上的保留 Docker 存储
沙箱存储用了多少？
这个读数测的是什么
证实存储拓扑
刷新或关闭这个指标
测量的局限
任务在哪台机器上跑
在另一台机器上运行 runner
在远端机器上授权隧道
回程：控制平面如何访问这台主机的 sandbox manager
这个拓扑里，三件看起来是细节、其实很要紧的事
沙箱网络
放行什么，拒绝什么
MCP 的前提条件，以及已接受的推理授权风险
主机上的防火墙表
地址池重叠
选择解析器
保护更多的地址
被拒绝时怎么排查
升级到单一网络时的一次性清理
运行时验证
SSH 服务器
可复用的云环境
团队环境
升级说明
启动本次发布之前
近期迁移
新增迁移时
环境变量清单
设置与初始化配置
Sandbox Manager 的新旧名称兼容
唯一的硬性规定
开通状态
本地开发工具
控制平面（
cloud_agent
）
本地和 CI 的权限回归测试
数据库
用 pgAdmin 管理数据库
网关契约
本服务自己的 secret
沙箱删除前的归档
控制平面读取的行为开关
代码托管
MCP
在管理页面上设置的沙箱参数
可选：计算资源管理
仓库环境
主机 agent（
cloud_agent_host
）
这套主机服务自己的身份
调度
Sandbox Manager、运行时与上报
物理服务器和执行环境
沙箱隔离（由主机 agent 读取，沙箱沿用）
Kata 运行时资格验证的代次
完整本地环境的数据库恢复
Claude 推理请求的重试策略
Agent CLI 的版本固定（构建镜像时）
Web（
apps/frontend/
）
构建时决定：镜像变体
运行时决定：部署的身份信息
在 HybridInference 那一侧设置，不在这里
基础设施（不是环境变量）
新增变量时
计算资源与全局沙箱位置
哪些东西必须放在稳定的基础设施上
支持的初始部署方式
优先选用的 CloudLab 节点类型
沙箱存储路径
准备一份受信任的部署配置
自动安装
手动安装和基于文件的安装
三条隧道和 sandbox manager 路由
自己登记主机密钥的 CloudLab 节点
启用旧式的、基于文件的 profile
日常操作流程
恢复与释放的边界
租期结束前把沙箱迁出去
CloudLab 节点自动替换
对生产流量开放之前的验收
发布
生成器检查什么，又故意不检查什么
生成发布
光能构建还不够，还得能启动
控制平面集成验收
镜像仓库的目录布局不属于这份契约
和设计文档不一样的地方
部署 recipe
按设计规定的顺序部署两台机器
下游部署仍要自己负责的事
部署失败检查与队列监控
两次激活期间一直保持排空
停掉正在服务的 runner 之前
主机运行时的资格验证
网络核实与启动阶段的工作
队列为空时的等待，以及 CI 的证据
旧进程对新 schema
部署之后的检测
恢复的边界
快照发布失败
备份与恢复
初始的运维策略
一套恢复集里要有什么
采集一套彼此对应的恢复集
恢复，并在重新开放前验证
恢复到上一个产物发布
主机运行时设置
主机执行限制
Runner 租约失效
租约时长与重试
凭确切的证据下结论
上报和确认失败
保留对话什么时候还能继续
可以安全释放的情况：子进程从没接下这个轮次
Staging 端到端冒烟测试
跑通一次能证明什么
0. 开始之前
1. 配置
2. 启动控制平面
3. 登录：走一遍完整的身份流程
4. 注册主机
5. 跑通一个完整的任务
6. 那些过一阵才会出问题的地方
7. 收尾清理
记录
HybridInference Cloud Agent
索引
索引