Claude Artifact · rendered reconstruction

四类 Pack 的设计

内核不变,扩展全部走包。每类包挂在不同的层、解决不同的问题、由不同的人交付。总图给挂载位置,分图给内部结构。

日期 2026-08-14 主题 扩展体系设计 配套 系统落位 · 扩展模式与交互终局 原始 Artifact 1242e81c…

原文重建版

本页依据认证会话中约 6,100px 的完整渲染稿逐屏转录,共覆盖九个重叠视口。原始 HTML/CSS 因跨域 iframe 无法导出;正文、六章结构、全部图表与验收框均已恢复。正文保留 2026-08-14 的候选设计口径;T79 后续仍把四类 Pack 视为待 Owner 升格的候选架构。

目录

  1. 00 · 总图:四类包挂在哪
  2. 01 · Domain Pack
  3. 02 · Connector Pack
  4. 03 · Interaction Pack
  5. 04 · Capability Pack
  6. 05 · 落到当前进度

00

总图:四类包挂在哪

运行时是一条固定的栈,四类包分别挂在栈的四个位置。装包不改栈。

总图 · 固定运行时与可变扩展包

运行时 · 不随企业变化

终端与 AgentNavi 待办流、对象页、动作卡;EnlightAI 工具调用
能力清单按身份编译,带版本
Ontology 内核元模型七件:对象、关系、动作、函数、政策、卡片契约、上下文绑定;注册表、解释器、校验器、权限判定;不含业务名词
动作与函数运行时确认流转、校验、幂等、补偿、事件账
Adapter 防腐层出向调用、入向捕获、回执解析
权威系统CRM、审批平台、财务、人事采购、自研系统、RevenueOS

扩展包 · 随企业与场景变化

Interaction Pack动作卡、对象页镜头、列表;待办规则、槽位声明挂载:终端与能力清单
Domain Pack对象、关系、动作、函数;政策、接口实现、证据指标;纯声明,无代码挂载:Ontology 内核
Capability Pack工具投影、方法论、评测、回执契约挂载:动作与函数运行时
Connector Pack连接发现、技术对象目录、映射契约、动作适配器、变更捕获、健康检查挂载:Adapter 防腐层;换企业的主要工作量

Domain 先行,其余三类可并行:Connector 映射到已声明类型,Interaction 渲染已声明动作,Capability 投影已声明动作与函数。验收判据:装包后运行时代码零改动。

四包对照

Pack解决的问题交付人换企业工作量变更频率
Domain企业有哪些经营对象与动作实施顾问 + 业务方约两成,有行业包时更低低
Connector对象从哪来、写回到哪去数据工程 + 实施约六到八成中
Interaction不同角色看什么、在哪确认产品 + 前端约一成高
CapabilityAI 能调什么、按什么方法论判断业务专家 + 算法约半成中

工作量分布解释了为什么 Connector 是护城河:概念可以复制,某套源系统的字段级映射资产无法直接复制。

01

Domain Pack

声明这家企业的经营世界里有什么。
纯声明,不含代码。装入即注册为可用类型,内核不变。

场景与问题

场景问题
上线交付域项目、里程碑、验收节点是新对象,立项与变更是新动作,应通过声明增加而不是改代码
第二家企业是制造业对象变为工单、产线、物料,动作变为派工与报废,内核不应因此改变
同企业新增人力域声明岗位、候选人、敏感字段档位与招聘流程动作
同一行业第二家客户安装同一行业包,只调整差异部分

Domain Pack 结构

包内七类声明

  • 对象:身份锚、生命周期、层级、档位
  • 关系:基数、建立白名单、级联
  • 动作:触发、参数、校验、确认序列
  • 函数:签名、输入输出、方法论绑定
  • 政策:角色 × 对象 × 动作、字段与行范围
  • 接口实现:本域对象实现的能力
  • 证据与指标:关口证据与结果指标

校验与注册后产物

装载校验:闭集一致性、依赖解析、版本与生效时间。

  • 可用类型清单:供能力清单编译与注册表物化
  • 动作与函数目录:供运行时装配、卡片渲染、工具投影
  • 权限规则集:供权限判定点编译投影
  • 接口能力表:供跨域工作流按能力而非类型编写

包只负责声明,注册器负责校验与装配。同名类型冲突、依赖缺失、接口未实现均在装入时失败,不进入运行时。

设计要点

设计要点规则
依赖显式声明交付域包依赖销售域订单对象。装包顺序由依赖图决定,缺依赖直接失败
版本与生效时间声明变更带版本;已生效动作实例按创建时版本解释,不受后续变更影响
行业包与企业扩展分离通用对象与动作进入行业包,企业特例进入扩展层,避免单一客户污染通用包
不含代码需要写代码的部分属于 Connector 或 Capability,不应混入 Domain
验收装入新 Domain Pack 后,内核与运行时代码 diff 为空;卸载后系统回到装包前状态。

02

Connector Pack

把源系统投影为对象,把写回做成动作。
第二家企业的主要工作量,也是唯一无法直接复制的资产。

场景与问题

场景问题
接入现有 CRM客户与商机字段映射、增量同步、码值翻译
接入财务系统成本与付款按需拉取,应收应付写回对齐
接入自研系统报价合同采购双向流:数据下发触发审批,审批结果写回
第二家企业更换 ERP只替换 Connector,业务对象定义与卡片不动
无接口的老系统界面自动化或人工任务,对上收口为同一动作契约

两段协议

第一段 · 自动登记连接发现:表、接口、字段、刷新、写接口 → 技术对象目录,状态为“已发现”。自动化只触及技术事实。
L0 · 字典已经确认的映射,永不重猜。
L1 · 确定性主外键、稳定单号、码表。
L2 · 结构统计值域重叠、基数、分布,只生成候选。
L3 · 模型提案仅处理灰色长尾,必须携带置信度与理由。
第二段 · 提案绑定映射提案 → 人审灰色区:对象负责人定口径主键,数据工程定连接类型 → 映射契约“已确认”。
映射契约维度内容
业务侧对象、属性、关系、动作
技术侧系统、对象、字段、接口
变换类型、码表、单位、脱敏
身份业务主键、源本地键
权属每个属性的权威与冲突规则
写回动作、幂等键、补偿
治理置信度、确认人、版本

出向 · 动作适配器

动作 → 外部调用 → 回执解析;携带幂等键,失败进入补偿。

入向 · 变更捕获

增量拉取或事件订阅;投影为已观测事件。

健康检查

主键唯一、新鲜度、行数守恒;差异进入异常队列,不静默修复。

自动化只到技术事实为止。业务对象是否成立、主键以谁为准、能否写回、谁能看,四项必须由人拍板。

设计要点

设计要点规则
源系统包与客户扩展分层主流系统通用形状进入源系统包,企业特例进入客户扩展;复用率决定第二家成本
多源同实体按列拼装不同源提供不同属性子集,通过统一主键连接;一个属性只能来自一个源;行级合并与实体解析在入包前完成
映射是可执行契约同一输入必须得到同一投影,可版本、比对、回放;不能只存在于对话记录
结构化与非结构化分轨表和接口走确定性轨道;文档、邮件、工单走概率抽取轨道,必须带来源片段和置信度,不得直接写成对象真相

反模式:把一张宽表整体挂成一个对象。含订单号、客户名、商品编码的宽表至少包含三个实体;若整体挂接,源系统改一列,所有卡片与判断会同时破碎。

验收更换源系统时,对象定义与卡片不动,只更换 Connector。若必须修改业务对象才能接上源系统,说明映射方向反了。

03

Interaction Pack

同一个对象,向不同角色呈现不同切面。
卡片是视图,不是类型。新增交互只增加本包,不修改对象与动作。

场景与问题

场景问题
销售与销管看同一商机首屏侧重点与可发起动作不同
归属确认的两个切面终端逐笔确认,业务系统批量核对,同一动作两种呈现
新增交付健康面板只增加视图,不触碰项目对象定义
待办产生规则定义什么条件下该动作进入谁的待办流

Interaction Pack 结构

包内声明

  • 动作卡:绑定动作、布局与组件
  • 对象页镜头:角色 × 四段内容
  • 列表:默认列、筛选、排序
  • 待办规则:何时进入谁的待办
  • 槽位:允许出现的位置

卡片的两半

数据工具:查询、取事实、计算判断。

渲染资源:在沙箱内只负责呈现。

四个槽位:待办流条目、对象页内嵌、对话流内嵌、独立窗口。同一张卡片可有四种展示模式。

安全边界说明
沙箱隔离不直连数据库
组件白名单只允许已审核组件
工具权限清单卡片只能调用声明过的工具
版本与回滚生成来源留痕,可回退

数据工具与渲染资源分离:数据可被其他卡片与对话复用,界面变更不影响取数逻辑。

卡片只读本体、只调用声明过的工具,不定义对象也不改变状态。模型生成的卡片必须经过审核后发布。

验收新增或修改卡片不触及对象与动作定义;同一动作在不同槽位复用同一份数据工具。

04

Capability Pack

让 AI 按企业的方法论工作,且只能在授权范围内。
对外,使外部 Agent 成为本体客户端;对内,把业务方法论变成可执行、可评测的能力。

场景与问题

场景问题
按方法论跑诊断赢单九问、项目健康判据需要成为可执行、可版本的判断
长任务执行周期性诊断与材料生产需要取上下文、调动作、写回结果
外部工具接入编码与对话类 Agent 访问企业对象,但不能获得数据库凭证
证明有效性判断规则是否提升结果,需要评测而非主观判断

Capability Pack 结构

包内声明工具投影、上下文规格、方法论(判据、阈值、提示词)、评测集与回执契约。
按身份投影工具清单按调用者权限裁剪;上下文编译后注入;不可用能力不出现在清单;与终端同源,无越权路径。
消费者EnlightAI Agentic Workflow、Navi 对话层、外部编码与对话 Agent;全部经过工具投影,不直连数据库。
回流产出回执与证据,不直接改状态;判断进入对象页依据;调用记录进入执行轨迹;评测结果进入版本对比。

方法论分公司级与个人级,公司级优先;个人上传方法论不影响他人。

Agent 能力边界由投影决定,不由提示词约束。产出永远是回执,经营状态仍通过动作与确认改变。

企业侧必须自建的四件安全能力

来源验证与签名、密钥作用域隔离、组织级白名单与配置覆盖、生命周期审计事件。文稿判断:现有开放打包标准不提供这四项。

验收外部 Agent 接入不新增权限旁路;同一能力在终端与 Agent 侧的可用范围一致。

05

落到当前进度

Pack当前状态已有缺口
Domain形态未成对象与动作契约文本、注册表实现类型清单仍在内核内;缺装包机制与依赖解析
Connector分散各源系统同步任务与部分映射统一映射契约、技术对象目录、两段协议、动作适配器
Interaction原型对话内渲染与交互写回原型卡片契约、槽位声明、待办规则、审核与版本
Capability部分方法论文本、长任务执行工具投影、上下文规格、评测集、回执契约

推进顺序

  1. 类型清单从内核移入 Domain Pack

    其余三包都挂在类型上。类型不脱离内核,装包机制无从谈起。

  2. 建立映射契约与技术对象目录

    换企业成本的大头。先有契约,才能谈自动提案。

  3. 动作适配器与两段协议

    双向数据流可对账的前提。

  4. 卡片契约与工具投影

    依赖前三项,但可与第三项并行。

第一步成本最低且当前类型数量只有七个,越晚做越贵。

整体验收选择一个对象和一条动作链,在两套不同源系统上复用同一份 Domain 与 Interaction 声明,只更换 Connector。做得到,四包体系成立;做不到,说明层次划分仍有问题。