三库现状与统一数据源建设规划
文档日期:2026-10-10
文档拆分:2026-10-10;字段与执行细则统一维护在第一阶段开发交付说明。
文档性质:现状整合与目标架构规划,供产品、研发和业务评审使用。
状态:核心业务边界已逐项确认,已据此收敛方案;真实接口、存储、权限映射和迁移可行性尚待研发核实。
范围:素材库、提示词库、技能库,以及 AI 设计平台、XMAI Studio 和其他应用的接入。
阅读说明:先看第一部分现状,再看第二部分建设规划。图中使用中文业务名称;架构图表示职责关系,不代表已经确定物理部署方式。
| 文档 | 内容定位 |
|---|---|
| 本文:整体方案规划 | 当前现状、建设目标、总体架构、职责边界、共性原则、四阶段路线与阶段完成条件 |
| 第一阶段开发交付说明 | 业务对象、字段与校验、具体业务待决事项、研发核查清单、业务输入输出和验收要求;产品业务规则已确认,可交研发评审;核查与联合评审未完成 |
字段长度、数量、必填、默认值等明细只在第一阶段文件维护,本文不重复保存。2026-10-10 已授权按两份Markdown分别同步HTML,阅读版不代替事实源。
第一部分:当前现状
1. 当前平台与三库的关系
目前共用一套账号体系;技能库的数据源在 XMAI Studio,素材库与提示词库的数据源在 AI 设计平台。三库已有业务能力,统一数据源及跨平台受控读写仍是本次建设目标。
查看图的文字定义
flowchart TB
U[公司统一账号体系]
U --> A[AI 设计平台]
U --> B[XMAI Studio]
subgraph DESIGN[AI 设计平台现有范围]
A --> M[素材库]
A --> P[提示词库]
M --> MD[素材文件与资产记录]
P --> PD[提示词正文与资产记录]
end
subgraph STUDIO[XMAI Studio 现有范围]
B --> S[技能库]
S --> SD[个人技能与企业发布快照]
end
O[其他业务应用] -.-> N[跨平台调用能力与接入范围待核实]
N -.-> M
N -.-> P
N -.-> S
| 事项 | 当前事实 | 证据及边界 |
|---|---|---|
| 账号体系 | 两个平台共用一套账号 | 组织、角色和授权同步的实现细节仍需核实 |
| 素材库、提示词库 | 已上线 | 依据来源一;生产系统覆盖范围需核实 |
| 技能库 | 相关能力已上线,公开 GitHub 搜索安装及员工端状态同步已完成生产验证 | 依据来源二;具体版本和生产证据待补档 |
| 素材、提示词的权限及审计 | 已有正式业务规则 | 具体服务端实现及上线覆盖范围未逐项核实 |
| 审批系统 | 设计平台与 Studio 当前分别处理审批 | 保留各平台审批,不合并审批系统 |
| 跨平台接入 | 原素材、提示词规则已提出外部平台只读调用 | 不能据此认定跨平台服务已经可用;本次目标进一步扩展到受控读写 |
| 统一三库数据源 | 本次拟建设 | 不属于当前已上线能力 |
2. 三库既有业务流程
以下流程为既有业务基线。目标方案的新增资产通过新增窗口主动保存,不新增自动采集或自动入库;外部灵感同步、快捷入库等历史记录仅用于现状映射。
2.1 素材与提示词:同一资产逐级共享
查看图的文字定义
flowchart LR
A[个人创建或上传] --> B[个人可用]
B --> C[提交团队审批]
C -->|撤回或驳回后修改| B
C -->|通过并设置可见组织| D[团队可用]
D --> E[申请公共发布]
E -->|撤回或驳回| D
E -->|系统管理员通过| F[公共可用]
F --> G[全公司可见]
D -.-> H[个人、团队、公共视图引用同一资产]
F -.-> H
团队和公共审批不复制内容;公共申请期间,团队资源继续可用。公共发布后保留个人和团队来源记录。当前已确认的审批规则允许有相应角色、审批事项和组织范围的人审批本人提交的资源;多人并发审批仅首个成功事务生效。
| 资产类型 | 进入方式 | 专属规则 |
|---|---|---|
| 素材 | 主动上传;工作台本地图片按选择入库;生成结果或历史结果入库 | 图片、视频、音频;固定一级类目;个人分组不改变共享权限;图片自动命名规则已确认,服务上线范围待核实 |
| 提示词 | 个人新建;外部灵感收藏为个人副本 | 纯文本;按用途分类;不以历史工具或模型字段限制使用;公共内容与外部未验证内容保持独立标识 |
| 外部灵感 | 外部来源同步进入灵感广场 | 原文与个人收藏副本分离,副本保留来源关系;同一用户重复收藏同一来源不重复创建副本 |
2.2 技能:个人对象与企业发布快照分离
查看图的文字定义
flowchart TB
A[员工导入或在线安装] --> V[来源、内容、兼容与安全校验]
V --> B[个人技能可用]
B --> C[提交审批]
C -->|撤回或驳回| B
C -->|通过| D[待发布]
D --> E[生成独立企业发布快照]
E --> F[企业技能发布并默认全员可见]
G[管理员直接导入] --> H[校验通过]
H --> E
I[产品与开发建设内置技能] --> J[受控资源包与发布质量检查]
J --> K[直接开发发布至运行环境]
F --> L[下架]
L -->|当前规则:恢复同一快照| F
| 规则 | 当前口径 |
|---|---|
| 个人与企业关系 | 两个独立对象;删除个人副本不影响企业发布快照 |
| 企业可见性 | 默认全员可见,当前没有部门、岗位或人员级配置界面 |
| 审批与调用 | 个人技能审批中、被驳回或待发布时,本人仍可使用 |
| 删除 | 2026-09-28 旧资料禁企业彻底删除;Studio 后续项目记忆已确认新增删除功能,不能把旧禁删作为现行规则。员工个人删除遵循本文第11章规则,企业清理与留存见交付说明 |
| 企业版本 | 2026-09-28 旧资料记载固定初始版本、无完整更新/历史/回退;2026-10-10 页面可见不同版本文本,不足以证明完整版本能力。最新差异和建设要求见交付说明第4.4节 |
| 系统内置技能 | 直接开发发布,可有受控资源包版本;不等于员工端已有企业技能版本管理 |
| 使用统计 | 真实任务开始执行才计调用;同一任务重试不重复增加主调用 |
| 下架与撤权 | 阻止新调用;执行中失效按交付说明第6.4节停止后续受控步骤,已启动操作的中断能力由研发核查,保留已完成结果 |
3. 两套现状的关键差异与建设缺口
| 对比项 | 素材库、提示词库 | 技能库 | 对统一建设的影响 |
|---|---|---|---|
| 共享模型 | 同一资产的个人、团队、公共视图 | 个人资产与独立企业快照 | 保留对象关系,不能因统一而强行合并 |
| 审批路径 | 团队审批、公共审批 | 员工审批发布、管理员直发、系统内置发布 | 审批继续由各业务平台处理,本次不统一 |
| 权限范围 | 个人、组织可见、全公司 | 个人与默认全员可见的企业技能 | 共用权限计算,但不擅自改变现有共享政策 |
| 分类方式 | 素材类目、提示词用途 | 技能分类与标签 | 统一维护方式,保留不同分类词表 |
| 使用结果 | 文件引用、文本回填 | 技能装载与任务执行 | 共用访问入口,返回内容及校验要求不同 |
| 版本基础 | 汇总资料未证明已有完整内容版本能力 | 已有发布快照,暂无企业技能版本更新 | 版本管理是本次增量建设内容 |
本次需要补齐的是三库统一数据、受控读写接口、按条件查询,以及已有任务的内容稳定性。审批整合、通用业务规则引擎和统一运营后台不作为本次建设前提。当前没有足够数据量化重复维护成本与接入工时,后续应实测基线。
第二部分:统一数据源建设方案规划
4. 三库共用一套底层规则
素材、提示词、技能统一遵循个人与共享归属、受控读写、业务筛选、内容版本和历史引用规则。业务应用按自身能力接入相应资产类型;数据可读取不代表应用自动具备全部技能运行或文件处理能力。
| 共性规则 | 素材库 | 提示词库 | 技能库 |
|---|---|---|---|
| 保存与归属 | 主动保存文件,记录个人或共享归属 | 主动保存正文,记录个人或共享归属 | 主动保存技能包,记录个人或共享归属 |
| 跨平台访问 | 同一素材按权限获取 | 同一提示词按权限获取 | 同一技能按权限获取 |
| 业务筛选 | 用户、类目、标签等 | 用户、用途、标签等 | 用户、分类、标签等 |
| 已有引用 | 不受列表筛选变化影响 | 不受列表筛选变化影响 | 不受列表筛选变化影响 |
| 已发布内容修改 | 保存新的文件版本 | 保存新的正文版本 | 保存新的技能包版本 |
| 旧任务重跑 | 沿用当时关联的文件版本 | 沿用当时使用的实际正文 | 沿用当时关联的技能包版本 |
| 业务审批 | 留在业务端 | 留在业务端 | 留在业务端 |
例如,在一个应用保存个人资产后,另一个有相应入口的应用按“当前用户的个人资产”及业务条件查询,就能找到同一条内容,无需再次导入。
查看图的文字定义
flowchart LR
A[业务应用新增窗口] -->|用户主动保存| D[统一数据源中的个人资产]
D -->|当前用户与业务筛选条件| B[Studio 列表和选择器]
D -->|当前用户与业务筛选条件| C[设计平台列表和选择器]
B -->|有修改权限时写回| D
C -->|有修改权限时写回| D
| 用户已确认的边界 | 方案含义 |
|---|---|
| 新应用要复用已有积累 | 新应用接入统一接口,不再独立收集和维护同一份资产 |
| 个人资产也需要统一 | 范围包括个人、团队、公共/企业资产;个人归属跟账号走 |
| 账号共用一套 | 复用已有身份;同一个人跨平台仍是同一个资产主体 |
| 业务平台可以增删改查 | 操作入口保留在应用,内容写入统一数据源 |
| 展示规则由业务制定 | 应用决定用户、分类、用途、标签等筛选条件 |
| 都通过新增窗口保存 | 不建设聊天内容、任务结果的自动入库 |
| 审批当前分开,本次不统一 | 现有审批继续在各业务端处理,不增加全局审批排队或统一路由 |
| 分类标签变化不影响已有引用 | 列表不展示不等于禁止已有任务继续使用 |
| 已发布内容不能直接覆盖 | 正式内容修改形成新版本,发布流程沿用相应业务端 |
| 三库旧任务重跑沿用当时内容或版本 | 任务保存使用时的内容,普通更新不替换历史任务输入 |
这里的统一数据源是支持业务在线读写的资产数据底座,不是用于汇总分析报表的数据仓库。它保存资产和必要管理信息,但不负责决定业务审批流程。
5. 收敛后的总体架构
查看图的文字定义
flowchart TB
U[现有统一账号体系]
subgraph APP[业务应用:各自保留业务规则与审批]
A[AI 设计平台]
B[XMAI Studio]
C[其他应用]
T[各应用任务记录:保存实际正文、文件或技能包版本]
end
A <--> S
B <--> S
C <--> S
U --> S
subgraph BASE[统一资产数据底座]
S[统一资产接口:认证、读写、发布结果写入]
S <--> R[统一数据管理:权限、条件查询、版本、引用、操作记录]
R <--> M[素材服务]
R <--> P[提示词服务]
R <--> K[技能服务]
M <--> D[统一资产与内容存储]
P <--> D
K <--> D
D --> E[变更通知与对账]
end
E -.->|刷新列表与当前状态| A
E -.-> B
E -.-> C
subgraph NOTE[三库共同原则]
N[展示筛选不影响已有引用;旧任务保留原内容或版本]
end
S -->|返回本次使用内容| T
| 层级 | 职责 | 不承担的工作 |
|---|---|---|
| 业务应用 | 新增窗口、展示筛选、业务审批、任务执行;记录本次使用的资产内容 | 不独立维护同一资产的第二份正式数据 |
| 统一资产接口 | 校验身份与资产权限,按条件查询,受控写入,防止覆盖冲突,记录操作 | 不决定业务审批人、审批路线或应用业务范围 |
| 统一数据存储 | 保存个人及共享资产、归属、分类标签、内容版本、共享范围和必要关联信息 | 不执行审批流转,不承担任务编排和模型调用 |
| 应用任务记录 | 保存实际使用的提示词正文、素材文件版本、技能包版本及来源 | 不成为第二份资产库,不随原资产更新自动改写 |
数据库和文件存储可以分别承载文本与文件;统一指资产有唯一权威归属和写入入口,不要求全部放到一张表或一台服务器。图中的接口可由一个服务实现,本次不要求建设复杂规则中心或拆分微服务。
总体架构中的变更通知用于刷新列表和当前资产状态,不自动改写旧任务输入。各业务端继续处理审批,底座仅校验并保存获准的发布结果;通知的具体实现可复用现有能力,不要求新建消息平台。
6. 哪些信息放在统一数据源
| 信息 | 是否集中 | 说明 |
|---|---|---|
| 个人、团队、公共/企业资产内容 | 是 | 包括提示词正文、素材文件、技能资源包 |
| 资产编号、创建人、归属组织、来源平台 | 是 | 跨平台识别和权限判断;来源平台只用于追溯,不默认隔离 |
| 分类、用途、标签 | 是 | 提供查询依据;三库原有分类含义分别保留 |
| 我的分组与资产关联 | 是 | 按用户和所属应用隔离;其他应用按需接入,不强制跨平台共用,不作为资产权限依据 |
| 可见范围、维护权限、发布结果 | 是 | 让所有应用对同一资产获得一致的访问与写入判断 |
| 正式内容版本 | 是 | 三库已发布内容不直接覆盖,保留历史版本引用 |
| 审批流程、待办、审批中状态 | 保留在业务系统 | 本次不迁移、合并或新增中央审批流程 |
| 必要的审批来源与结果关联 | 按接入需要保存 | 能追溯授权变更来自哪次业务处理即可,不复制整套审批系统 |
| 应用展示筛选配置 | 保留在业务应用 | 业务端负责配置,查询时传入对应条件 |
| 任务实际使用的正文、文件或技能包版本及参数 | 保留在应用任务记录 | 供历史任务查看与重跑使用,不重新入资产库 |
素材、提示词仍保留同一资产的多视图关系;个人技能与企业技能仍是独立对象。统一存储不强行合并它们。
7. 列表筛选与已有引用分开处理
核心规则:列表展示取“用户有权访问的资产”与“应用筛选条件”的交集;已有任务使用资产不重新经过列表筛选。
查看图的文字定义
flowchart TD
A[业务应用请求资产] --> B[统一接口校验真实身份和资产权限]
B --> C{请求目的}
C -->|列表或选择器| D[应用传入用户、分类、用途、标签条件]
D --> E[返回权限与筛选条件均满足的资产]
C -->|读取已有引用| F[按资产编号及版本获取]
F --> G[不套用列表筛选,仍检查实际访问权限]
C -->|旧任务重跑| H[按任务权限使用已保存内容或版本]
H --> I[不因分类标签或普通更新而换成最新内容]
以下用提示词说明筛选行为,素材与技能遵循相同规则;标签名称不代表已存在的正式分类:
| 资产及应用 | 示例条件 | 展示结果 |
|---|---|---|
| 一条本人创建、带“Studio 专用”标签的提示词 | 资产本身仍属于当前用户 | 来源是设计平台也不影响归属 |
| Studio 查询 | 当前用户的全部个人提示词 | 能展示该提示词 |
| 设计平台查询 | 当前用户的个人提示词,排除“Studio 专用”标签 | 列表和选择器不展示 |
| 设计平台旧任务已使用该提示词 | 使用任务中保存的当时正文 | 不受上述排除条件影响 |
“Studio 专用”在此仅为展示标签,不是禁止其他应用读取的权限。添加标签不会自动改变应用行为,需要相应应用配置筛选规则。用户身份和可访问范围由服务端核实,不能通过修改查询条件读取他人的个人资产。
对于新建任务,列表筛选结果决定用户能从选择器找到什么;对于历史任务,保存的输入决定重跑使用什么。两个入口不能共用一段会把历史引用过滤掉的列表逻辑。
8. 三库通用的新增与跨平台读取时序
以下时序图按流程阶段拆分,素材、提示词、技能共用同一数据源逻辑,并非分别对应三个库。
8.1 新增资产:校验并保存到统一数据源
8.2 跨平台查询:按权限返回资产列表
查看图的文字定义
sequenceDiagram
actor U as 用户
participant A as 应用A
participant S as 统一资产接口
participant D as 统一数据源
participant B as 应用B
U->>A: 主动保存素材、提示词或技能
A->>S: 资产类型、内容资源、归属及目标范围、分类标签、来源、可信身份和请求标识
S->>S: 校验身份、目标范围、写入权限、内容及重复请求/重复内容规则
alt 校验或权限不通过
S-->>A: 返回失败原因,不保存资产
A-->>U: 提示需修正内容或无操作权限
else 命中该类资产的已确认重复规则
S-->>A: 返回重复提示及有权访问的已有对象引用
A-->>U: 按该类资产规则处理,不无提示重复创建
else 校验通过
S->>D: 保存个人资产、确定内容版本及资源关系
alt 写入成功
D-->>S: 资产ID、内容版本ID及可用状态
S-->>A: 返回已保存、资产ID、内容版本ID及可用状态
A-->>U: 显示保存成功
else 明确写入失败
D-->>S: 返回失败原因
S-->>A: 返回未保存及原因
A-->>U: 提示失败,不另存第二份正式数据
else 请求超时或结果未知
S-->>A: 返回结果待确认,不认定未保存
A->>S: 使用原请求标识核查结果或安全重试
S-->>A: 返回已保存引用、明确失败或仍待确认
A-->>U: 展示真实结果,不重复新增
end
end
U->>B: 打开资产列表
B->>S: 可信身份、调用应用、资产范围、筛选及分页条件
S->>S: 校验身份和可访问范围
alt 查询获准且服务可用
S->>D: 按权限、业务筛选及分页查询
D-->>S: 有权访问的资产列表及分页信息
S-->>B: 返回列表、资产ID及必要版本信息
B-->>U: 展示结果,允许合法空列表
else 无权限或服务不可用
S-->>B: 返回明确失败原因
B-->>U: 提示失败,不伪装为正常空列表
end
用户选择列表项后,还需按确定引用读取实际内容;列表信息不是执行内容:
8.3 选择资产后读取:取得确定版本的实际内容
查看图的文字定义
sequenceDiagram
actor U as 用户
participant B as 应用B
participant S as 统一资产接口
participant D as 统一数据源
U->>B: 选择资产并请求查看或使用
B->>S: 资产ID、指定版本或当前获准版本、请求用途、可信身份
S->>S: 校验访问权限、用途与资产有效性
alt 获准且版本存在
S->>D: 读取确定正文、文件或技能包及必要元数据
D-->>S: 资产ID、确定内容版本ID及内容资源
S-->>B: 返回确定内容及受控资源引用
B-->>U: 展示内容或进入应用执行准备
else 无权限、资产失效或版本缺失
S-->>B: 返回具体阻止原因,不替换最新版本
B-->>U: 提示无法读取或使用
else 服务异常
S-->>B: 返回读取失败,不返回伪空内容
B-->>U: 提示重试,不伪装为资产不存在
end
| 资产类型 | 按确定引用读取的业务输出 |
|---|---|
| 素材 | 资产ID、确定文件版本、受控文件引用及必要文件信息 |
| 提示词 | 资产ID、内容版本ID、完整正文及必要使用说明 |
| 技能 | 资产ID、内容版本ID、完整技能包引用及权限/依赖声明;声明不自动授予权限 |
同一条已存在的资产在另一平台使用时不再重新建库。明确的“复制为个人资产”仍可按现有规则创建独立副本并记录来源,不与普通跨平台读取混淆。
9. 三库通用的内容修改与旧任务重跑
以下时序图按流程阶段拆分,素材、提示词、技能共用同一数据源逻辑,并非分别对应三个库。
9.1 首次执行:保存实际输入与确定内容后执行
9.2 内容更新:生成新版本,保留原任务引用
9.3 旧任务重跑:沿用原输入,新增执行记录
查看图的文字定义
sequenceDiagram
actor U as 用户
participant B as 应用B
participant S as 统一资产接口
participant D as 统一数据源
participant T as 应用任务记录
Note over U,T: 首次使用:保存实际输入与确定内容
U->>B: 选择资产并提交实际任务输入
B->>S: 资产ID、所选版本及可信身份
S->>S: 校验访问权限、资产有效性和所选版本
alt 有权使用且内容可取得
S->>D: 读取获准的确定内容及资源
D-->>S: 内容、资产ID及内容版本ID
S-->>B: 返回确定内容和资源引用
B->>T: 保存实际任务输入、确定内容版本、执行配置及来源
alt 输入记录保存成功
T-->>B: 返回任务ID、执行记录ID及已保存确认
B->>B: 检查执行权限与依赖
alt 执行条件满足
B->>B: 使用已记录的实际输入执行
B->>T: 按执行记录ID保存状态、结果或失败原因
T-->>B: 返回结果记录状态
B-->>U: 返回任务ID、执行记录ID、执行状态及结果引用
else 权限或依赖不满足
B->>T: 记录未执行及阻止原因
B-->>U: 返回未执行及具体原因
end
else 输入记录失败或保存结果未知
T-->>B: 返回失败或待核查状态
B-->>U: 提示输入未确认保存,不启动执行
end
else 无权使用、资产失效或内容不可取得
S-->>B: 返回阻止原因
B-->>U: 提示失败,不执行任务
end
Note over U,D: 内容更新:生成新版本,不覆盖原内容
U->>B: 提交内容修改
B->>B: 按原应用规则完成必要审批或发布授权
B->>S: 目标资产ID、基于版本、新内容、保存或发布意图、可信授权和请求标识
S->>S: 校验写入权限、内容及版本冲突
alt 获准且无冲突
S->>D: 保存新内容版本,按获准操作更新生效引用
D-->>S: 新内容版本ID、当前生效版本ID及保存/发布结果
S-->>B: 返回修订已保存或发布已生效、新版本及当前生效版本
B-->>U: 分别显示保存修订或发布生效,不混作同一成功
else 校验、权限失败或版本冲突
S-->>B: 返回原因;冲突提供可访问的当前修订信息
B-->>U: 提示修正或重新加载,不覆盖旧版本
else 明确写入失败
S-->>B: 返回未保存/未发布及原因
B-->>U: 提示失败,保留原生效版本
else 超时或结果未知
S-->>B: 返回结果待确认
B->>S: 使用原请求标识核查或安全重试
S-->>B: 返回真实保存/发布结果或仍待确认
B-->>U: 不提前显示成功或失败,不重复产生版本
end
Note over U,T: 旧任务重跑:沿用原输入,重新检查执行条件
U->>B: 提交旧任务ID及重跑请求
B->>T: 按可信身份与任务权限读取原输入及确定版本
alt 任务有权读取且历史输入可还原
T-->>B: 返回原输入、原正文或确定资源版本及必要执行配置
B->>S: 校验原资产及版本当前访问与使用条件
S-->>B: 返回获准原版本资源或明确阻止原因
B->>B: 检查依赖及执行条件
alt 原内容获准且执行条件满足
B->>T: 创建本次执行记录,关联旧任务、原输入及重跑请求标识
alt 执行记录已保存
T-->>B: 返回本次执行记录ID及保存确认
B->>B: 使用原输入与原版本重跑
B->>T: 保存本次状态、结果或失败原因,不覆盖原记录
T-->>B: 返回结果记录状态
B-->>U: 返回旧任务ID、本次执行记录ID、状态及结果引用
else 执行记录失败或结果未知
T-->>B: 返回失败或待核查状态
B-->>U: 不启动重跑,提示记录未确认保存
end
else 无权限、企业资产失效、内容缺失或依赖不满足
B-->>U: 返回阻止原因,不替换最新内容
end
else 任务无权读取、记录不存在或原输入无法还原
T-->>B: 返回具体原因
B-->>U: 不启动重跑,不用当前资产冒充历史输入
else 历史记录服务异常
T-->>B: 返回读取失败
B-->>U: 提示重试,不误报记录不存在
end
Note over B,T: 已保存历史内容的查看与重新执行分开判断
| 操作 | 处理原则 | 负责位置 |
|---|---|---|
| 修改个人未发布内容 | 有权限即可保存,校验编辑期间是否被他人修改 | 业务端编辑,统一接口写入 |
| 修改已发布内容 | 形成修订版本,按原业务流程完成发布,现行版本不被直接覆盖 | 审批在业务端,内容与发布结果在统一数据源 |
| 创建新任务 | 获取当前获准内容,并保存本次实际使用的输入 | 应用任务记录 |
| 修改标签或应用筛选配置 | 改变后续列表结果,不改旧任务的内容或版本 | 标签在数据源,筛选配置在应用 |
| 重新运行旧任务 | 默认沿用原内容或版本及已记录的任务输入 | 应用运行层 |
| 两个平台同时改同一内容 | 第一笔成功后,另一笔按旧修订提交时返回冲突,不无提示覆盖 | 统一资产接口 |
三库统一采用“记录本次实际输入,重跑默认沿用”的规则,保存形式随内容类型变化:
| 类型 | 任务应保存什么 | 需要避免的问题 |
|---|---|---|
| 提示词 | 实际使用正文;用户在工作台修改过的文字也计入任务输入 | 只存资产编号,重跑时误取最新正文 |
| 素材 | 资产编号、不可被覆盖的文件版本或受控快照引用 | 只存会被替换的文件地址,导致旧任务素材变化 |
| 技能 | 资产编号、确定的技能包版本及必要执行配置 | 重跑时悄悄装载新技能包 |
这些任务记录不是新增入库资产。实际文件保留、技能运行环境与外部依赖由研发核实;固定内容或版本不代表权限永远有效,也不保证 AI 输出或外部系统状态完全相同。
列表过滤不影响旧引用,不等于删除、撤权或下架也必须无条件放行。后者继续遵守相应资产和任务的实际权限;企业失效后的历史查看及禁止重跑、执行中受控操作停止规则见第一阶段交付说明第6章;物理清理仍需制度依据。
10. 审批留在业务端,底座只处理有效写入
查看图的文字定义
flowchart LR
A[应用 A 自身审批流程] -->|提交获准的发布结果| S[统一资产接口]
B[应用 B 自身审批流程] -->|提交获准的发布结果| S
S --> C[校验调用身份、操作权限及目标内容修订]
C -->|通过| D[写入新内容版本或共享范围]
C -->|失败或冲突| E[返回原业务端处理]
| 边界 | 本次处理 |
|---|---|
| 审批规则由谁制定 | 各业务方沿用自身规则 |
| 审批在哪处理 | 现有业务系统,不新增统一审批服务 |
| 是否要求同类资产都送到某个指定平台审批 | 不作为本次要求,不新增跨平台审批路由 |
| A、B 能否各有自己的审批单 | 由各业务系统管理,本次不新增“全局只能一张有效审批单”的限制 |
| 不同审批结果同时写同一资产 | 校验内容及相关共享信息的修订状态;冲突返回业务端,不自动合并或覆盖 |
| 资产服务是否相信任意“已通过”字段 | 不相信;仅允许获准的业务服务以可追溯身份提交相应操作,并检查其授权范围 |
| 审批通过但写入失败 | 业务端保留真实处理状态并重试或处理冲突,不能显示资产已发布成功 |
| 其他应用需要显示审批进度 | 如需建设,属于业务间接入,不是统一数据源首期前提 |
具体接入校验方式由研发结合现有身份和授权机制确定。这里需要的是可靠的写入授权与冲突保护,不是重新建设审批流程。
11. 删除与同步的最小边界
| 事项 | 当前处理口径 |
|---|---|
| 仅某个应用不展示 | 修改应用筛选条件,资产仍存在,已有引用不受影响 |
| 员工删除个人资料(三库通用) | 只移除个人侧记录或可见关系,不提供完整物理删除入口;首期不因个人删除自动物理清理 |
| 删除已共享/发布资料的个人侧记录 | 素材、提示词保留企业共享关系;技能保留独立企业快照,企业引用的正文、文件与技能包不被连带清除 |
| 已共享、已引用或正在使用的资产 | 个人删除、企业失效及历史查看按交付说明第4.5、6.4节处理;实际实现与留存期限由研发及制度依据核查 |
| 应用刷新 | 最低要求是重新查询时取得统一服务的最新有效数据;缓存刷新方式由研发确定 |
| 撤权与账号停用 | 由可信权限状态控制后续受控访问,不能靠列表标签代替 |
| 统一服务暂不可用 | 写入明确失败,不私自回到旧平台另存一份正式数据;可用性与恢复机制需技术设计 |
本次不把实时消息平台、复杂通知订阅或完整回收站作为先行建设条件。已有任务输入的留存与资产文件的物理删除也不能混为一个动作。员工个人删除及验收规则见第一阶段开发交付说明第 4.5 节;物理清理条件与期限仍需制度及引用依据。
12. 分阶段建设、产品工作与迁移
优先建设统一数据底座,再对接现有设计平台与 Studio;新应用接入作为后续扩展,不纳入本次四阶段交付。第一阶段业务与字段明细在独立交付文件维护;待决事项不自动变成已确认规则。
当前已知:两个项目使用不同数据库,由同一开发团队中的不同人员负责。产品负责范围、业务规则和验收结果;开发负责真实存储、现有接口、技术方案、实现与迁移核查。数据库和文件存放位置等技术事实不要求产品代答。
12.1 四个阶段及交付边界
查看图的文字定义
flowchart LR
A[第一阶段:现状盘点与底座设计] -->|范围、规则及设计评审通过| B[第二阶段:统一数据底座建设]
B -->|三库接口与关键规则独立验证通过| C[第三阶段:现有两平台对接联调]
C -->|真实业务链路联调通过| D[第四阶段:存量迁移与正式切换]
| 阶段 | 核心目标 | 产品负责 | 开发与测试负责 | 阶段交付结果 |
|---|---|---|---|---|
| 第一阶段:现状盘点与底座设计 | 明确统一什么、业务怎样使用、现有实现如何承接 | 范围、业务对象、权限矩阵、规则、验收场景与待决事项 | 两项目技术盘点、接口复用判断、数据模型与迁移设计、工作量评估 | 需求与验收口径、技术设计、两端改造清单经联合评审 |
| 第二阶段:统一数据底座建设 | 底座具备三库统一存储与受控读写能力 | 核对接口表达的业务行为,准备样例,验收共性规则和异常结果 | 实现存储、接口、鉴权、条件查询、版本与冲突保护;提供独立验证证据 | 三库底座及接口说明可交付,独立测试通过 |
| 第三阶段:现有平台对接与联调 | 设计平台和 Studio 的资产入口接入统一服务 | 验收真实页面与任务行为,确认原审批和筛选逻辑得到保留 | 分别改造两端读写、发布结果写入和任务记录,完成联调 | 使用测试或受控样本跑通两平台完整业务链路 |
| 第四阶段:存量迁移与正式切换 | 真实数据归入统一底座,两平台正式使用 | 确认迁移批次的业务影响,组织抽验,确认切换后业务可用 | 备份、数据迁移、增量核对、读写切换、监控与回退验证 | 已切换资产只有一个权威写入入口,内容、权限和引用核对通过 |
底座设计必须以两平台实际业务契约为输入,但第二阶段不要求完成全部前端接入。阶段可提前准备、部分并行推进,不能把独立接口测试通过当作两平台已经联调或上线。迁移准备从第一阶段开始,正式生产切换放在第四阶段。
12.2 第一阶段:现状盘点与底座设计
目标是让业务范围、对象关系和关键规则可执行,供研发完成设计与估算。产品交付范围说明、字段与校验、权限及状态影响、验收依据;研发交付真实存储与接口盘点、数据模型、两端改造和迁移设计。
第一阶段须同时形成受影响业务入口清单,供底座设计和估算使用,不等底座完成才盘点。具体字段要求、研发核查与第一阶段交付清单见第一阶段开发交付说明,不在整体方案重复维护。
第一阶段完成条件: 产品范围和关键业务规则可执行,开发已完成必要事实核查,形成可评审的数据模型、接口范围、两端改造和迁移方案。产品与研发对影响范围和验收口径无关键分歧,人员与排期由团队据实际工作量安排。
12.3 第二阶段:统一数据底座建设
实现第一阶段确定的三库受控读写、权限与条件查询、正式内容版本、冲突保护、获准发布结果写入及必要关联。产品按第一阶段交付的验收要求检查业务行为;具体检查表和最小验证集见第一阶段开发交付说明第 7 章。无需等新页面做完,可通过测试工具和可读的请求结果验证底座。
第二阶段完成条件: 三库统一接口及必要数据能力可交付,关键规则有可复核证据,阻断性问题已处理;接口身份、返回结果和异常语义能供两端开发使用。此时只表示底座独立验证通过,不表示两平台已接入、存量已迁移或生产已上线。
第二阶段保证确定内容或版本可获取,第三阶段验证任务实际输入记录与旧任务重跑完整链路。旧任务中用户临时修改过的提示词正文也必须由应用保留,不能只保存资产编号。
12.4 第三阶段:设计平台与 Studio 对接联调
| 工作 | 产品关注 | 开发与测试执行 |
|---|---|---|
| 资产入口改接 | 原有用户操作意图不变,新增窗口仍由用户主动保存 | 两端列表、选择器、新增、编辑等入口调用统一接口 |
| 业务筛选接入 | 各应用可以展示不同结果,但不改变底层资产身份和实际权限 | 按第一阶段定义的条件查询,不在客户端自行扩大权限 |
| 原审批结果接入 | 审批继续在各业务端;成功与失败状态准确 | 将获准结果写入统一服务,处理冲突、失败及重试 |
| 任务引用与重跑 | 三库旧任务默认沿用实际使用内容或版本,标签过滤不破坏旧引用 | 接入任务输入记录,分别验证素材、提示词、技能 |
| 两端一致性 | 一端修改后,另一端重新读取能取得一致数据 | 验证刷新、缓存、旧编号兼容及跨端并发行为 |
同一团队中的两端负责人可以按统一接口并行开发,通过共同样例联调;正式切换仍按批次安排。第三阶段使用测试或受控样本确认真实业务链路,不能仅凭接口返回成功判定用户流程完成。
第三阶段完成条件: 两个平台约定范围内的实际入口和任务链路联调通过,原业务审批可继续运行,关键异常已验证,具备存量迁移和正式切换条件。
12.5 第四阶段:存量迁移与正式切换
查看图的文字定义
flowchart LR
A[确定迁移批次并备份] --> B[迁移及核对资产]
B --> C[补齐期间增量]
C --> D[控制该批旧入口写入]
D --> E[最终对账与切换检查]
E -->|通过| F[切换统一读写入口]
E -->|不通过| G[保持原入口并处理差异]
F --> H[两平台业务抽验与观察]
| 必须保留或核对 | 判定原则 |
|---|---|
| 个人归属、组织和共享范围 | 不能丢失创建人、扩大权限或把个人资产变成公共资产 |
| 资产编号与历史引用 | 保留旧编号映射,原任务能找到对应资产及可验证版本 |
| 三库对象关系 | 素材、提示词多视图不重复建资产;个人技能和企业快照不误合并 |
| 内容、文件和版本 | 数量、内容及文件可读性核对;没有历史版本证据时不伪造 |
| 分类、标签及个人关联 | 保留必要分类、标签、收藏和分组关系;差异按第一阶段规则处理 |
| 原审批关系 | 审批记录保留在业务系统,必要关联可追溯,不借迁移合并审批系统 |
| 迁移期间新增和修改 | 正式切换前纳入最终核对,每批仅保留一个权威写入入口 |
| 历史信息缺失 | 记录无法还原的具体范围,不能把当前内容冒充过去使用内容 |
产品确认业务抽验样例和可接受的切换影响,开发执行数据备份、迁移、对账和回退,测试记录结果。发现资产丢失、权限扩大或关键历史引用损坏时,该批不得通过切换验收。
切换后若需回退,先控制新写入并核对新入口产生的增量,再恢复明确的权威写入位置,不能直接打开旧库形成两边独立写入。切换后的观察期、恢复目标、具体批次和时间由产品与开发结合真实规模确定,不在本方案中虚构时长。
第四阶段完成条件: 两平台正式使用统一数据源,已迁移范围的内容、归属、权限和引用核对通过,旧独立写入链路已停用,恢复方案经过验证,业务抽验及运行观察达到事先约定的标准。
12.6 本次阶段规划的控制原则
- 三库共性规则一起确定,建设和迁移可以分批,不能因分批而形成三套相互冲突的规则。
- 本次围绕统一数据源与现有两平台接入交付,不增加统一审批、全局审批排队、通用业务规则引擎或新的统一管理后台。
- 新应用扩展保留标准接口能力即可,不作为本次上线依赖或独立交付阶段。
- 只统一三库相关资产数据与必要关联,不将任务、对话、积分等全部业务数据一并迁入底座。
- 范围内新增需求或规则变化先评估对数据、接口和两端改造的影响,再决定是否纳入本期,不在开发过程中无记录地扩大范围。
13. 用具体场景验收
| 场景 | 预期结果 |
|---|---|
| 在设计平台新增个人提示词,Studio 查询全部本人提示词 | 看到同一资产,无需再次入库 |
| 在 Studio 查询另一位员工的个人资产 | 无授权时拒绝,不因修改查询条件越权 |
| Studio 展示某标签,设计平台排除该标签 | 两平台列表不同,底层内容仍只有一份 |
| 三库修改分类标签后打开已关联任务 | 原关联不失效,任务保留原内容或版本 |
| 三库内容普通更新后创建新任务 | 使用最新获准内容并记录本次实际输入 |
| 三库内容普通更新后重跑旧任务 | 提示词用原正文、素材用原文件版本、技能用原技能包版本,不自动切换最新内容 |
| 未点击新增窗口保存 | 不因输入、浏览或生成而自动创建资产 |
| 两个平台同时修改同一资产 | 不发生无提示覆盖;冲突交还业务端处理 |
| 业务审批完成后写入发布结果 | 只有获准写入才生效,失败不伪报发布成功 |
| 迁移存量资产 | 内容、归属、可见范围、旧引用与原记录核对一致 |
价值首先看跨平台重复录入是否减少、新应用接入工时是否降低、因旧任务输入变化导致的返工是否减少。当前缺少量化基线,不能填写预计节省比例或承诺上线日期。
14. 研发核查事项
| 待核实项 | 目的 |
|---|---|
| 现有存储、接口与文件读取方式 | 确定怎么集中数据、复用哪些已有实现 |
| 共享账号的组织与权限映射 | 让用户跨平台得到一致资产权限,避免把管理员权限直接合并 |
| 业务服务写入授权与冲突返回 | 保护数据一致性,不额外建设审批系统 |
| 任务是否已有输入正文或版本记录 | 确定旧任务重跑所需的最小改造及历史数据限制 |
| 删除、下架、引用及文件保留 | 补齐与现有生产规则一致的边界,避免损坏引用 |
| 迁移窗口、数据对账、备份与回退 | 保证切换可验证、可恢复 |
| 负责人、首批场景与排期 | 在实际工作量核实后安排,不由本方案虚构 |
事实来源
| 来源 | 使用范围 |
|---|---|
| 素材库、提示词库现状规则架构与业务流程(2026-09-28) (Markdown来源) | 两库既有对象关系、共享流程及上线证据边界 |
| XMAI Studio 技能库架构与业务流程(2026-09-28) (Markdown来源) | 个人与企业技能对象、现有发布和使用规则 |
现状资料用于兼容核查,目标行为以本规划及第一阶段开发交付说明为准。本文件仍为方案规划,未验证生产数据库或接口,不表示已经开发、迁移或上线。