Claude Artifact · rendered reconstruction
四类 Pack 的设计
内核不变,扩展全部走包。每类包挂在不同的层、解决不同的问题、由不同的人交付。总图给挂载位置,分图给内部结构。
原文重建版
本页依据认证会话中约 6,100px 的完整渲染稿逐屏转录,共覆盖九个重叠视口。原始 HTML/CSS 因跨域 iframe 无法导出;正文、六章结构、全部图表与验收框均已恢复。正文保留 2026-08-14 的候选设计口径;T79 后续仍把四类 Pack 视为待 Owner 升格的候选架构。
目录
00
总图:四类包挂在哪
运行时是一条固定的栈,四类包分别挂在栈的四个位置。装包不改栈。
总图 · 固定运行时与可变扩展包
运行时 · 不随企业变化
扩展包 · 随企业与场景变化
Domain 先行,其余三类可并行:Connector 映射到已声明类型,Interaction 渲染已声明动作,Capability 投影已声明动作与函数。验收判据:装包后运行时代码零改动。
四包对照
| Pack | 解决的问题 | 交付人 | 换企业工作量 | 变更频率 |
|---|---|---|---|---|
| Domain | 企业有哪些经营对象与动作 | 实施顾问 + 业务方 | 约两成,有行业包时更低 | 低 |
| Connector | 对象从哪来、写回到哪去 | 数据工程 + 实施 | 约六到八成 | 中 |
| Interaction | 不同角色看什么、在哪确认 | 产品 + 前端 | 约一成 | 高 |
| Capability | AI 能调什么、按什么方法论判断 | 业务专家 + 算法 | 约半成 | 中 |
工作量分布解释了为什么 Connector 是护城河:概念可以复制,某套源系统的字段级映射资产无法直接复制。
01
Domain Pack
声明这家企业的经营世界里有什么。
纯声明,不含代码。装入即注册为可用类型,内核不变。
场景与问题
| 场景 | 问题 |
|---|---|
| 上线交付域 | 项目、里程碑、验收节点是新对象,立项与变更是新动作,应通过声明增加而不是改代码 |
| 第二家企业是制造业 | 对象变为工单、产线、物料,动作变为派工与报废,内核不应因此改变 |
| 同企业新增人力域 | 声明岗位、候选人、敏感字段档位与招聘流程动作 |
| 同一行业第二家客户 | 安装同一行业包,只调整差异部分 |
Domain Pack 结构
包内七类声明
- 对象:身份锚、生命周期、层级、档位
- 关系:基数、建立白名单、级联
- 动作:触发、参数、校验、确认序列
- 函数:签名、输入输出、方法论绑定
- 政策:角色 × 对象 × 动作、字段与行范围
- 接口实现:本域对象实现的能力
- 证据与指标:关口证据与结果指标
校验与注册后产物
装载校验:闭集一致性、依赖解析、版本与生效时间。
- 可用类型清单:供能力清单编译与注册表物化
- 动作与函数目录:供运行时装配、卡片渲染、工具投影
- 权限规则集:供权限判定点编译投影
- 接口能力表:供跨域工作流按能力而非类型编写
包只负责声明,注册器负责校验与装配。同名类型冲突、依赖缺失、接口未实现均在装入时失败,不进入运行时。
设计要点
| 设计要点 | 规则 |
|---|---|
| 依赖显式声明 | 交付域包依赖销售域订单对象。装包顺序由依赖图决定,缺依赖直接失败 |
| 版本与生效时间 | 声明变更带版本;已生效动作实例按创建时版本解释,不受后续变更影响 |
| 行业包与企业扩展分离 | 通用对象与动作进入行业包,企业特例进入扩展层,避免单一客户污染通用包 |
| 不含代码 | 需要写代码的部分属于 Connector 或 Capability,不应混入 Domain |
02
Connector Pack
把源系统投影为对象,把写回做成动作。
第二家企业的主要工作量,也是唯一无法直接复制的资产。
场景与问题
| 场景 | 问题 |
|---|---|
| 接入现有 CRM | 客户与商机字段映射、增量同步、码值翻译 |
| 接入财务系统 | 成本与付款按需拉取,应收应付写回对齐 |
| 接入自研系统 | 报价合同采购双向流:数据下发触发审批,审批结果写回 |
| 第二家企业更换 ERP | 只替换 Connector,业务对象定义与卡片不动 |
| 无接口的老系统 | 界面自动化或人工任务,对上收口为同一动作契约 |
两段协议
| 映射契约维度 | 内容 |
|---|---|
| 业务侧 | 对象、属性、关系、动作 |
| 技术侧 | 系统、对象、字段、接口 |
| 变换 | 类型、码表、单位、脱敏 |
| 身份 | 业务主键、源本地键 |
| 权属 | 每个属性的权威与冲突规则 |
| 写回 | 动作、幂等键、补偿 |
| 治理 | 置信度、确认人、版本 |
出向 · 动作适配器
动作 → 外部调用 → 回执解析;携带幂等键,失败进入补偿。
入向 · 变更捕获
增量拉取或事件订阅;投影为已观测事件。
健康检查
主键唯一、新鲜度、行数守恒;差异进入异常队列,不静默修复。
自动化只到技术事实为止。业务对象是否成立、主键以谁为准、能否写回、谁能看,四项必须由人拍板。
设计要点
| 设计要点 | 规则 |
|---|---|
| 源系统包与客户扩展分层 | 主流系统通用形状进入源系统包,企业特例进入客户扩展;复用率决定第二家成本 |
| 多源同实体按列拼装 | 不同源提供不同属性子集,通过统一主键连接;一个属性只能来自一个源;行级合并与实体解析在入包前完成 |
| 映射是可执行契约 | 同一输入必须得到同一投影,可版本、比对、回放;不能只存在于对话记录 |
| 结构化与非结构化分轨 | 表和接口走确定性轨道;文档、邮件、工单走概率抽取轨道,必须带来源片段和置信度,不得直接写成对象真相 |
反模式:把一张宽表整体挂成一个对象。含订单号、客户名、商品编码的宽表至少包含三个实体;若整体挂接,源系统改一列,所有卡片与判断会同时破碎。
03
Interaction Pack
同一个对象,向不同角色呈现不同切面。
卡片是视图,不是类型。新增交互只增加本包,不修改对象与动作。
场景与问题
| 场景 | 问题 |
|---|---|
| 销售与销管看同一商机 | 首屏侧重点与可发起动作不同 |
| 归属确认的两个切面 | 终端逐笔确认,业务系统批量核对,同一动作两种呈现 |
| 新增交付健康面板 | 只增加视图,不触碰项目对象定义 |
| 待办产生规则 | 定义什么条件下该动作进入谁的待办流 |
Interaction Pack 结构
包内声明
- 动作卡:绑定动作、布局与组件
- 对象页镜头:角色 × 四段内容
- 列表:默认列、筛选、排序
- 待办规则:何时进入谁的待办
- 槽位:允许出现的位置
卡片的两半
数据工具:查询、取事实、计算判断。
渲染资源:在沙箱内只负责呈现。
四个槽位:待办流条目、对象页内嵌、对话流内嵌、独立窗口。同一张卡片可有四种展示模式。
| 安全边界 | 说明 |
|---|---|
| 沙箱隔离 | 不直连数据库 |
| 组件白名单 | 只允许已审核组件 |
| 工具权限清单 | 卡片只能调用声明过的工具 |
| 版本与回滚 | 生成来源留痕,可回退 |
数据工具与渲染资源分离:数据可被其他卡片与对话复用,界面变更不影响取数逻辑。
卡片只读本体、只调用声明过的工具,不定义对象也不改变状态。模型生成的卡片必须经过审核后发布。
04
Capability Pack
让 AI 按企业的方法论工作,且只能在授权范围内。
对外,使外部 Agent 成为本体客户端;对内,把业务方法论变成可执行、可评测的能力。
场景与问题
| 场景 | 问题 |
|---|---|
| 按方法论跑诊断 | 赢单九问、项目健康判据需要成为可执行、可版本的判断 |
| 长任务执行 | 周期性诊断与材料生产需要取上下文、调动作、写回结果 |
| 外部工具接入 | 编码与对话类 Agent 访问企业对象,但不能获得数据库凭证 |
| 证明有效性 | 判断规则是否提升结果,需要评测而非主观判断 |
Capability Pack 结构
方法论分公司级与个人级,公司级优先;个人上传方法论不影响他人。
Agent 能力边界由投影决定,不由提示词约束。产出永远是回执,经营状态仍通过动作与确认改变。
企业侧必须自建的四件安全能力
来源验证与签名、密钥作用域隔离、组织级白名单与配置覆盖、生命周期审计事件。文稿判断:现有开放打包标准不提供这四项。
05
落到当前进度
| Pack | 当前状态 | 已有 | 缺口 |
|---|---|---|---|
| Domain | 形态未成 | 对象与动作契约文本、注册表实现 | 类型清单仍在内核内;缺装包机制与依赖解析 |
| Connector | 分散 | 各源系统同步任务与部分映射 | 统一映射契约、技术对象目录、两段协议、动作适配器 |
| Interaction | 原型 | 对话内渲染与交互写回原型 | 卡片契约、槽位声明、待办规则、审核与版本 |
| Capability | 部分 | 方法论文本、长任务执行 | 工具投影、上下文规格、评测集、回执契约 |
推进顺序
- 类型清单从内核移入 Domain Pack
其余三包都挂在类型上。类型不脱离内核,装包机制无从谈起。
- 建立映射契约与技术对象目录
换企业成本的大头。先有契约,才能谈自动提案。
- 动作适配器与两段协议
双向数据流可对账的前提。
- 卡片契约与工具投影
依赖前三项,但可与第三项并行。
第一步成本最低且当前类型数量只有七个,越晚做越贵。