CellSpec 参考

CellSpec 是创建/更新 Cell 时传入的声明式配置，定义 Cell 的完整行为。

结构分层

CellSpec 使用 struct embedding 分层（cellspec.go）：

CellSpec {
    ID                  // 不可变
    CellCoreSpec        // 核心配置
    CellAdapterSpec     // 外设配置
    CellSchedulingSpec  // 调度配置
    CellPortableSpec    // 可移植配置
}

Go 嵌入保持向后兼容：spec.Timezone 等价 spec.CellCoreSpec.Timezone。

字段可变性

字段带 wesgine:"immutable|mutable|restricted" tag：

Tag含义
immutable创建后不可修改
mutable可随时修改
restricted受限修改

核心配置（CellCoreSpec）

字段说明可变性
Timezone时区immutable
Locale语言区域mutable
Compliance合规类别mutable
Governance治理模式mutable
EnginePaths引擎路径mutable
RedactorRules脱敏规则mutable

外设配置（CellAdapterSpec）

字段说明
ChannelsIM 渠道
Email邮箱账号
MCPsMCP Server
Cron定时任务（种子声明）
HITL人机交互配置
HeadlessBrowser无头浏览器
Playwright用户浏览器自动化
Desktop桌面自动化
STT语音转写
Plugins插件

Provider 配置

字段说明
ProviderStrategy路由策略（四选一）
PrivateProvidersCell 私有 Provider
AllowedModels允许的模型列表
LogicalModelGroups逻辑模型组
DisallowActorProvider禁止 Actor Provider

调度配置（CellSchedulingSpec）

字段说明
Quotas计算/存储/外设配额
CycleDetect循环检测配置
FaultPolicyOverride故障策略覆盖
SkillPolicy技能策略
InboxCap收件箱容量
Roles角色定义

SDK Hooks（json:"-"）

这些字段不序列化，必须在 GetOrCreate 前绑定：

字段说明
QualityGate质量门控回调
EditPatrol编辑巡检回调
HostEnvironment宿主环境信息
AppIdentity应用身份
FileSegmenter文件分段器
EditMatchFallback编辑匹配回退
ToolExecutorHooks工具执行钩子
OnStarted启动回调
PostRunFnRun 后回调
ProviderLiveKeyFn实时密钥获取

存储

CellSpec 没有 Storage 字段：

安全默认