# 三库统一数据源建设｜第一阶段开发交付说明

> 整理日期：2026-10-10。  
> 文档用途：第一阶段提供给产品、开发与测试共同确认的业务输入，供底座设计、工作量评估和后续实现使用。  
> 当前状态：产品业务规则已确认，可交研发评审；技术兼容、容量、实际权限映射及留存依据需联合核查，不表示第一阶段联合评审完成或已开发、迁移、上线。  
> 上位方案：[三库现状与统一数据源建设规划](三库现状与统一数据源建设规划_2026-09-28.md)。

## 1. 两份文档的分工与本阶段目标

| 文档 | 负责回答 | 后续维护方式 |
|---|---|---|
| [整体方案规划](三库现状与统一数据源建设规划_2026-09-28.md) | 为什么统一、现状是什么、架构与职责怎样划分、分几阶段建设 | 维护总体边界、路线与阶段完成条件 |
| [本文：第一阶段开发交付说明](三库统一数据源建设_第一阶段开发交付说明.md) | 业务对象、字段与校验、权限与状态影响、业务输入输出、待决事项及验收要求是什么 | 字段和执行细则在本文维护，整体方案通过链接引用 |

第一阶段完成现状盘点与底座设计；第二阶段才建设统一底座，第三阶段接入现有两平台，第四阶段迁移与切换。本文作为第一阶段产物，描述后续实现需要遵循的业务要求，不意味着第一阶段就完成平台改造或生产迁移。

统一范围是素材、提示词、技能的个人及共享资产，以及必要的归属、权限、版本和关联。保留应用操作入口与各自审批，不建设统一审批、全局审批排队、通用规则引擎或新管理后台。新应用不作为首期依赖。

三库遵循整体方案的共性规则；素材、提示词字段见第 4.1—4.3 节，技能专属字段、页面依据与已确认规则见第4.4节，业务规则与入口清单见第6章。不能用两库字段限制代替技能字段限制。

### 1.1 规则状态口径

| 标记 | 含义 | 开发使用方式 |
|---|---|---|
| 已确认规则 | 本方案规定的目标行为 | 纳入设计；涉及实现细节时与研发评审，不自行改动业务含义 |
| 页面现状 | 2026-10-10 查看当前页面得到的事实 | 作为盘点依据；不自动等于新数据源规范，也不证明后端校验已一致 |
| 待产品确认 | 影响业务行为但未确认的选择 | 先评估影响，定稿前明确，不自行填默认答案 |
| 待研发核实 | 需要检查代码、接口、数据库或存量记录的事实 | 由研发提供证据，产品不代答技术事实 |

## 2. 产品侧交付清单

本章仅说明产品经理需要交付的业务材料。以下六项已在本文件及整体方案中完善，可作为产品侧材料交付，无需另做六份文件。“已完善”表示业务材料已形成，不表示功能已经实现或验收测试已经执行。

### 2.1 交付内容与完成状态

| 产品交付物 | 已交付的业务内容 | 完成状态 | 材料位置 |
|---|---|---|---|
| 范围与业务规则说明 | 三库范围、对象关系、职责边界、共享与个人删除原则、历史兼容及迁移业务边界 | 已完善 | 本文第1、3章、第4.5节、第6.4节；整体方案第4—6、11—12章 |
| 字段与校验说明 | 共用信息、三库专属字段、长度、必填、分类标签、资源及历史超限处理规则 | 已完善 | 本文第3—5章、第6.1节 |
| 权限、操作与版本影响矩阵 | 个人／团队／公共／企业操作边界、账号停用、内容与管理信息变化、提审冻结及失效影响 | 已完善 | 本文第4.4.3、4.5、6.2—6.4节 |
| 业务输入输出及异常要求 | 新增、修改、查询、确定引用读取、发布写入和个人删除的业务输入、成功结果及失败含义 | 已完善 | 本文第6.6节；整体方案第8—10章 |
| 受影响入口的业务清单 | 两平台列表、选择器、新增编辑、导入收藏、审批发布、个人删除、任务引用及切换的预期行为 | 已完善 | 本文第6.5节 |
| 验收标准与业务样例 | 三库共性、专属字段、权限、版本、异常、个人删除及迁移检查场景与预期结果 | 已完善 | 本文第4.4.5、4.5节、第7章；整体方案第13章 |

### 2.2 产品交付口径

- 六项材料集中维护在本文；整体方案负责总体架构、共性边界和阶段路线，字段及执行明细不重复维护。
- 产品交付的是业务范围、目标行为、规则和验收标准；入口清单已明确第一阶段业务覆盖，不以具体代码文件或接口定位作为本章的产品完成标准。
- 页面事实、已确认建设规则及需要证据的兼容／容量／留存事项保持区分；剩余核查与联合评审项集中在第8章，不混作本章尚未交付的业务材料。
- 本章材料已具备产品交接条件；后续新增业务选择或变更已确认规则时另行记录确认，不把材料完善等同于整个项目或第一阶段联合评审完成。

## 3. 业务对象与共用数据要求

### 3.1 对象边界

| 对象 | 业务含义 | 已确认边界 |
|---|---|---|
| 素材资产 | 文件及其管理信息 | 素材与提示词的个人、团队、公共视图引用同一资产，不因跨平台读取重复创建 |
| 提示词资产 | 正文及其管理信息 | 普通跨平台读取使用同一资产；明确复制为个人资产时可按既有规则产生独立副本并记录来源 |
| 技能资产 | 个人技能或企业发布快照 | 个人技能与企业快照仍为不同对象，不因统一存储而合并 |
| 正式内容版本 | 一次确定的正式内容 | 已发布内容更新形成新版本；旧任务沿用实际正文、文件或技能包版本 |
| 个人分组及关联 | 用户在某应用中的整理习惯 | 保存于数据源，按用户和所属应用隔离；不是资产分类、共享范围或权限 |
| 应用任务输入记录 | 当次执行实际使用的输入 | 保留在应用任务记录，不作为第二份资产库 |

### 3.2 底座需要承接的共用信息

本表描述业务数据要求，不指定数据库表、技术字段名或存储方式。不是每一项都由用户填写；个人与共享资产所需归属信息也不能机械要求完全相同。

| 中文业务信息 | 用途 | 已有约定或边界 | 仍需补齐 |
|---|---|---|---|
| 资产编号、资产类型 | 跨平台识别同一对象并获取相应内容 | 底座返回资产编号，三库对象关系保持明确 | 编号生成、旧编号映射由研发设计 |
| 创建人、个人归属、归属组织 | 确定资产主体和追溯来源 | 个人归属跟统一账号走；团队与公共范围保留既有边界 | 保留创建与归属语义；无人维护不自动转移，按第6.2节及原授权核查 |
| 来源平台、来源记录 | 追溯新增或复制来源 | 来源平台不默认隔离资产 | 原有来源类型映射、外部灵感副本关系 |
| 分类、用途、标签 | 业务检索与展示筛选 | 不代替真实权限；各库分类词表可不同 | 词表维护、空值、条件组合、标签编辑权限 |
| 可见范围、维护权限、发布结果 | 一致的访问与写入判断 | 能看不等于能改；审批过程仍在业务端 | 第6.2节已确认角色边界；具体组织及角色映射待研发核查 |
| 内容与确定版本 | 获取文本、文件或技能包 | 正式内容不直接覆盖；旧任务不自动换成最新内容 | 变更版本规则见第6.3节，现有历史能力待研发核查 |
| 必要审批来源与结果关联 | 追溯获准写入 | 不复制审批流程、待办或审批中状态 | 业务服务具体提交哪些结果和关联信息 |
| 必要操作记录 | 追溯读写与冲突处理 | 整体方案要求受控读写与操作记录 | 记录范围、查询权限和留存要求 |

页面展示的上传人、创建时间、当前状态、验证状态及使用次数仍由研发核查来源映射。尤其不能将审批中状态、验证状态、资产可用状态混成一个状态，也不能将各应用使用次数直接相加冒充已确认的统一统计口径。

### 3.3 枚举、词表与状态口径

本节定义业务取值及字典边界，不预设数据库编码。已列出的目标取值纳入实现；依赖现有系统的完整字典和状态转换须在第一阶段设计评审中提交，不得在实现时无依据自定。

| 字段 | 取值或字典来源 | 默认值、空值及映射规则 |
|---|---|---|
| 资产类型 | 素材、提示词、技能 | 必填、单值；不因来源平台变化而改变类型 |
| 素材媒体类型 | 图片、视频、音频 | 单文件单值；MIME、扩展名和实际内容识别映射由研发核查，不将全部文件格式写成三种业务类型 |
| 素材／提示词共享范围 | 个人、团队、公共 | 单值；页面“团体”映射为“团队”。新增可选范围按原授权；默认项及组织空值沿用原规则并核查，不能默认扩大为公共 |
| 技能归属范围 | 个人、企业 | 单值；内置技能首期沿用原发布体系，不塞入员工归属枚举 |
| 提示词用途分类 | 通用、商品主图、详情页、买家秀、场景图、海报、视频 | 单选，默认通用；ID引用现有词表 |
| 素材类目 | 通用、医疗器械类、大健康类、宠物类、护具类、美妆类、进口保健品类、个护类、地毯类 | 单选，默认通用；ID引用现有词表 |
| 技能分类 | 引用管理后台技能分类词表 | 单选必填，无预设默认项。旧需求基线为办公协同、开发工具、投资理财、效率工具、内容创作、信息资讯、教育学习、数据分析、网站部署、生活服务、商业运营、知识与学习；研发核对当前完整词表和ID，不将旧基线直接覆盖生产词表 |
| 来源类型 | 引用分库来源字典；技能至少区分创建、文件导入、公开仓库、应用发布 | 完整来源值及旧值映射需研发提供；ZIP／文件夹／单Markdown是导入方式，不与共享范围或资产类型混用 |
| 技能输入类型、输出格式 | 引用现有包规范及应用支持的能力字典 | 多值；当前未取得完整可靠取值，研发核查完整值、未知扩展值保留和缺失值语义；空值不自动判为无限兼容 |
| 需要参考图 | 是、否 | 未勾选为否；是则执行时至少提供1张实际输入图，不用效果图代替 |
| 审批状态 | 保留各应用审批状态字典 | 业务端维护。技能旧基线为未提交、审批中、已撤回、已驳回、待发布、已发布、已下架，当前映射及新增值须核查；不作为统一资产可用状态直接复用 |
| 资产可用／企业发布状态 | 分别表达当前能否使用及是否发布生效 | 业务判定以权限、有效性及当前获准版本为准；物理枚举与合法转换由研发提出映射并评审，不把审批通过等同已发布，不以个人删除代表企业失效 |
| 验证、安装、兼容状态 | 保留原应用分别维护的字典 | 不合并为全局状态；研发提供值、含义及来源，未核实不凭展示文案补齐 |
| 标签、组织、分组、版本号 | 不是固定枚举 | 标签按数量长度校验；组织来自身份系统，分组属于用户与应用；来源版本号为文本，不用固定版本文本代替内容版本ID |

研发交接字典须逐项列出：业务值、技术编码、含义、单选／多选、默认值、空值、旧值映射、未知值处理、维护权限；状态另附合法转换、触发角色和生效条件。既有异常值进入兼容清单，不自动转公共、强行归类或丢弃。

## 4. 三库专属字段与规则

### 4.1 素材库与提示词库字段限制

| 字段 | 2026-10-10 页面观测 | 已确认建设规则 | 目的 |
|---|---|---|---|
| 提示词名称 | 输入框最多 500 字符 | 最多 100 字符 | 便于列表识别，详细解释放入说明 |
| 提示词用途说明 | 输入框最多 2,000 字符 | 最多 500 字符 | 表达适用场景和使用条件 |
| 提示词内容 | 输入框最多 30,000 字符 | 超过 5,000 字符提醒，最多 10,000 字符 | 兼顾复杂指令；5,000 是提醒阈值，不禁止保存，10,000 是建设上限 |
| 素材名称 | 编辑输入框最多 200 字符 | 最多 100 字符 | 保留必要的商品、场景和版本信息 |
| 标签 | 未观察到数量限制，不能据此推断后端无限制 | 最多 10 个，每个最多 20 字符；去除首尾空格和重复标签 | 减少无效和重复标签 |

页面长度属性仅作为前端观测，不代表已核实服务端校验。必填与空白规则见第6.1节；字符计数与大小写去重需研发提出一致实现口径并评审。

### 4.2 提示词库字段盘点

下表记录初次盘点问题；已关闭的产品选择以第6章规则为准，剩余问题由研发映射核查。

| 中文字段 | 页面现状与业务含义 | 建设规则状态 | 需要明确的细则 |
|---|---|---|---|
| 提示词名称 | 新建、编辑与列表识别名称 | 最多 100 字符已确认 | 必填、去首尾空格、允许同名；历史缺失值由研发核查 |
| 用途分类 | 单选；通用、商品主图、详情页、买家秀、场景图、海报、视频；页面默认通用 | 当前词表与默认值为页面现状 | 沿用当前词表、默认通用；维护授权及历史映射由研发按原规则核查 |
| 标签 | 自由文本，多项以逗号分隔 | 第 4.1 节数量、长度和整理规则已确认 | 输入方式、中文逗号处理、维护权限、大小写去重口径 |
| 用途说明 | 说明适用商品或使用场景，页面提示语为“一句话说明” | 最多 500 字符已确认 | 选填；空说明不作为保存阻断 |
| 提示词内容 | 多行正文 | 超过 5,000 提醒、最多 10,000 字符已确认 | 必填且不可纯空白；超限编辑见第6.1节，计数一致性由研发评审 |
| 效果图 | 可选；最多 3 张，JPG／PNG，单张不超过 20MB | 当前页面约束，不自动作为新底座定稿 | 是否沿用数量、格式、大小；更换效果图是否产生内容版本 |
| 是否需要参考图 | 独立勾选项，表达使用时的输入要求 | 页面现状；与效果图区别明确 | 默认值、需要时的最少或最多输入数量、缺图时能否执行；由哪些应用执行校验 |
| 保存位置／共享范围 | 当前查看账号新建可选个人／公共；另有团队资源与团队编辑入口 | 个人、团队、公共资产纳入底座已确认 | 不同角色可选范围、默认位置；不能把高权限账号入口推广给所有员工 |
| 可见组织 | 团队编辑可多选 | 页面现状；底座需承接实际可见范围 | 适用资产范围、空值含义、调整权限及组织失效处理 |
| 我的分组 | 用户个人整理关系 | 第 5 章规则已确认 | 分组名50字符且同用户同应用不重名，具体规则见第6.1节 |
| 来源 | 页面展示如手动创建；灵感有外部来源信息 | 来源追溯方向已确认，具体映射待核实 | 来源类型、原记录关联和复制规则 |
| 验证状态、当前状态、使用次数 | 个人、团队、灵感有不同验证标识及状态／统计展示 | 页面现状，不代表统一口径已确认 | 状态分别由谁维护；验证是否跨应用有效；使用计数事件、范围与去重 |

效果图展示版式或产出效果，不是任务实际执行时必须提供的参考图。“是否需要参考图”也不等于资产内已有参考图；任务输入由应用负责记录，避免把展示图片自动作为执行输入。

### 4.3 素材库字段盘点

下表记录初次盘点问题；已关闭的产品选择以第6章规则为准，剩余问题由研发映射核查。

| 中文字段 | 页面现状与业务含义 | 建设规则状态 | 需要明确的细则 |
|---|---|---|---|
| 素材文件 | 图片、视频、音频；上传支持一次选择多个文件 | 当前页面入口；未实际上传验证约束 | 各类型格式、大小、时长／分辨率及批量数量；异常文件处理 |
| 素材名称 | 编辑输入框，列表与详情识别名称；上传有图片命名建议说明 | 最多 100 字符已确认；逐文件命名建议未验证 | 必填、命名建议采用方式、同名处理、批量命名与修改 |
| 素材类目 | 通用、医疗器械类、大健康类、宠物类、护具类、美妆类、进口保健品类、个护类、地毯类 | 当前词表；各库分类含义分别保留 | 沿用当前词表、默认通用；原词表维护授权与历史映射由研发核查 |
| 说明／备注 | 上传称“统一备注”，编辑称“素材说明”，详情称“备注”；未见长度属性 | 是否同一字段待研发核实，不能因名称不同重复建字段 | 统一素材说明、选填500字符；批量赋值及逐条编辑见第6.1节 |
| 标签 | 列表、详情展示；当前查看的编辑表单未见输入入口 | 第 4.1 节数量、长度和整理规则已确认 | 现有标签来源、谁能编辑、是否增加或复用维护入口 |
| 素材范围 | 当前账号上传可选个人／团体／公共 | 页面现状；对应范围纳入底座已确认 | 角色可选范围、默认值；“团体”与“团队”的命名映射 |
| 所属组织 | 团体上传时单选 | 页面现状 | 归属组织与上传人所属部门的区别、必填条件及组织变化处理 |
| 可见组织 | 团体上传时多选 | 页面现状；不能与所属组织混为一个字段 | 默认值、是否包含所属组织、空值语义及调整权限 |
| 我的分组 | 个人整理关系，不改变类目及权限 | 第 5 章规则已确认 | 分组名50字符且同用户同应用不重名，具体规则见第6.1节 |
| 上传人、所属部门、创建时间、当前状态 | 页面展示管理信息 | 页面现状，需与共用信息映射 | 来源、状态定义与历史数据缺失处理 |
| 文件类型、文件大小、宽高等 | 图片详情展示宽高和大小；音视频专属详情未检查 | 文件信息存在；专属字段未全部核实 | 音视频时长、编码等是否需要展示或查询；系统提取能力由研发核实 |


### 4.4 技能库数据源字段、已确认方案与页面依据

#### 4.4.1 盘点依据与覆盖边界

2026-10-10 用户端以用户提供的 8 张截图为主要依据；管理端通过已打开的聚合后台内 Studio 页面只读查看。以下仅记录字段、提示与可见入口，不复制员工信息、真实技能正文或脚本。页面文字和输入属性不是后端校验或完整流程已验证的证据。

| 页面／证据 | 已观察内容 | 证据范围 |
|---|---|---|
| 用户截图 1：全部技能 | 创建、导入、在线技能库入口；全部／我的／企业／我的提交页签；名称、说明或标签搜索；分类筛选；卡片名称、图标、来源、简介、分类、标签、版本 | 详情、下载、使用是操作入口，不是资产字段；数量为页面即时值，不作为建设基线 |
| 用户截图 2：内置技能详情 | 来源、版本、分类、标签、用途描述、详细说明 | 这是内置技能详情，不能冒充企业技能详情；详细说明与实际注入正文是否相同待核实 |
| 用户截图 3—4：我的技能与个人管理详情 | 名称、图标、简介、分类、标签、版本、流转状态、技能说明；下载、使用、编辑、删除个人技能、提交审批入口；说明技能归当前钉钉账号，审核中的版本不能修改 | 仅见未提交样本的管理入口，不推断所有状态均可编辑或删除；版本说明底部截断，不补写不可见文字 |
| 用户截图 5：我的提交 | 名称、技能标识、提交版本、分类、状态、时间、驳回原因、查看技能入口；全部提交／审核中／已通过或发布计数 | 同名样本有不同历史记录，说明提交记录需与资产区分；未核验提交 ID、时间语义、历史留存全量与所有状态 |
| 用户截图 6—8：创建技能 | 基本信息、七项执行规范、格式依赖资源；执行规范成为 SKILL.md 强制章节；草稿按当前钉钉用户在本机自动保存 | 不修改用户草稿；不能从截图确认 maxlength、逐项必填、后台同步或服务端校验 |
| 用户端导入入口 | 选择来源→校验内容→完成导入；本地技能文件夹、GitHub 地址、ZIP 压缩包三入口；目录含 SKILL.md；ZIP 入口提示也支持单独 Markdown 技能文件 | 未选择文件、未校验、未导入；后两阶段字段及单 Markdown 实际兼容性未核验，不能套用后台 ZIP 约束 |
| 管理端审批列表与审核详情 | 列表技能、提交人、分类、标签、版本、提交时间、状态；详情个人技能标识、版本、状态、提交人、部门、风险级别、说明、风险项、处理记录、文件结构及包内容预览 | 审核模式另有企业分类、至少一个企业标签、检索勾选与逗号分隔新增标签；注明只影响企业副本，不修改个人技能。只打开表单，不点击驳回或审核通过 |
| 管理端企业列表与详情 | 企业名称、创建人、分类、标签、当前版本、累计调用次数、更新时间、状态；详情匿名累计调用／成功／失败／取消、说明、处理记录 | 统计提示按技能与版本聚合，不保存使用人、提示词、附件或结果；这是页面声明，底层实现与删除后留存待核实 |
| 管理端直接发布 | ZIP、本地文件夹、公开 GitHub；企业名称、分类、标签、风险确认 | 名称前端 maxlength=80 且 required；分类 required 且单选；标签页面要求至少一个。ZIP 输入 accept=.zip、单文件；目录选择整个目录，SKILL.md 不区分大小写；GitHub 提示仓库或 /tree/main/skill-dir 地址。未选择文件、未勾风险确认、未校验发布，已取消 |
| 管理端待发布 | 页面列表为空 | 未构造数据，不能确认具体发布表单与名称冲突提示 |

用户端企业详情与导入校验后页面尚缺直接证据。已有截图用于现状映射，建设模型以本文规则为准，缺少证据的约束由研发核实。

#### 4.4.2 已确认的数据源模型与字段（2026-10-10）

技能数据源采用“技能资产＋内容版本＋资源包＋来源关系”四层模型。以下为目标建设模型；不指定物理表、数据库列名或部署方式。当前页面仅用于映射与兼容核查，不直接决定底座字段。

**技能资产：身份、检索与权限。**

| 中文业务字段 | 已确认建设规则 |
|---|---|
| 技能 ID | 系统生成且稳定不变；名称与标识不能代替它 |
| 技能名称 | 个人与企业共用同一字段定义；企业发布默认继承个人来源名称，各对象分别保存值，后续调整不覆盖个人对象 |
| 技能说明 | 检索与列表展示信息，与执行正文分开 |
| 技能标识 | 保留包内技术标识用于解析兼容，不作为跨用户唯一资产编号 |
| 归属范围 | 个人或企业，决定权限边界，不与来源类型混用；首期内置保留原发布方式，不迁成员工资产 |
| 归属主体 ID | 关联统一账号或企业组织，个人资产按授权读取 |
| 分类 ID | 引用技能专属分类词表，不强行与素材或提示词分类合并 |
| 标签关联 | 引用技能标签，用于检索；个人与企业均选填，数量和长度见本节已确认校验 |
| 图标资源引用 | 可选，缺失使用默认图标 |
| 可用状态 | 表达是否允许使用，与应用审批状态分开；状态由获准操作与可用性表达，实际映射由研发提出并评审 |
| 当前内容版本 ID | 指向当前生效的确定内容 |
| 创建人、创建时间、更新时间 | 系统维护，固定时间语义；修改展示信息不冒充内容版本变化 |

**内容版本：保存确定的执行内容。**

| 中文业务字段 | 已确认建设规则 |
|---|---|
| 内容版本 ID | 系统生成，内容确定后不可覆盖 |
| 所属技能 ID | 关联技能资产 |
| 来源版本号 | 保留填写或导入的版本文本；不单独用于判断内容是否相同 |
| SKILL.md 正文 | 完整保存，作为执行正文事实源 |
| 对话引导语 | 可选，属于使用引导，不是用户真实任务输入 |
| 支持的输入类型 | 多值能力声明，供应用判断兼容性，不证明实际运行能力 |
| 输出格式 | 多值能力声明，与正文输出要求分开 |
| 权限声明 | 不自动授予权限，空声明不等于无风险 |
| 外部依赖声明 | 保存依赖名称和要求，不保存凭据值 |
| 包格式／Schema 版本 | 支持解析和兼容 |
| 必要扩展元数据 | 保留尚未统一定义的包信息，避免迁移丢失；包括适用的动态输入表单定义 |
| 内容校验摘要 | 识别内容变化、校验完整性和同号不同包；算法待研发设计 |
| 版本创建人、创建时间 | 系统维护 |

七项执行规范（适用场景、输入要求、输出要求、执行流程、边界与禁止事项、异常处理、使用示例）作为正文标准章节，首期不另存七份独立正文。创建页面可分项编辑，保存时生成统一正文；导入保留原文。若以后需要章节检索或编辑，再增加可重建的解析结果。新建七章必填；旧包缺章节提示但允许导入，不强行改写。

**资源包：保存完整内容和文件关系。**

| 中文业务字段 | 已确认建设规则 |
|---|---|
| 资源 ID | 系统生成 |
| 所属内容版本 ID | 文件绑定确定版本 |
| 包内相对路径 | 保留目录结构与正文引用关系 |
| 存储引用 | 指向底座管理的文件，不使用用户本机绝对路径作为跨平台地址 |
| 文件名称、类型、大小 | 支持展示与校验 |
| 文件校验摘要 | 检查完整性与变化 |

正文、模板、图片、脚本和参考资料共同构成确定内容版本，不能只迁移正文。文件与总包容量、安全阈值和解析优先级待产品确认／研发核实。

**来源关系：连接独立对象与业务记录。**

| 中文业务字段 | 已确认建设规则 |
|---|---|
| 来源类型 | 区分创建、文件导入、公开仓库、应用发布等 |
| 来源应用 ID | 标记来源业务系统，不直接授予共享权限 |
| 原系统记录 ID | 支持迁移、重试与追溯 |
| 必要来源地址 | 可选，不保存敏感本机路径或凭据 |
| 来源技能 ID | 企业对象可关联个人来源对象；直接发布可为空 |
| 来源内容版本 ID | 企业发布关联具体获准内容，不指向个人技能的动态最新版本 |
| 来源业务记录引用 | 指向应用审批或直接发布记录，不复制整套审批流程 |

**字段校验与业务细则：**

| 事项 | 已确认规则 |
|---|---|
| 名称 | 个人与企业统一上限 100 字符，必填，去首尾空格；当前后台 80 字符属于需改造差异 |
| 技能说明 | 必填，上限 500 字符，去首尾空格 |
| 对话引导语 | 选填，上限 500 字符，去首尾空格 |
| 分类 | 技能专属词表，单选必填 |
| 标签 | 个人、企业均选填；最多 10 个，每个 20 字符，去首尾空格与重复项；取消当前企业至少一个的约束 |
| 技能标识 | 技术格式与包兼容要求由研发先核查，格式和长度限制以兼容核查结果为依据 |
| 正文与章节 | 新建七项标准章节均必填且非空；旧包缺章节时提示但允许导入，不补写原文；正文不套提示词长度限制，完整保存且禁止截断 |
| 同名与重复 | 允许同名，以技能 ID 区分；同一用户重复导入相同内容时提示并复用已有个人资产；若已个人删除，则恢复本人个人可见关系并返回可用对象，不改变企业对象或扩大权限；企业重复发布相同内容时提示已有对象，不按名称合并 |
| 审核与更新 | 冻结提审版本，个人可另建新版本，原审批仍指向原内容；企业内容更新重新走原应用审批／发布流程 |
| 企业失效与旧任务 | 企业下架、删除后保留旧任务已保存的内容与结果供查看；禁止以失效技能发起新调用或重跑。执行中失效规则见第6.4节，实际中断能力待研发核查 |
| 内置技能 | 首期保留现有内置发布方式，不迁成员工个人／企业资产 |
| 物理清理 | 首期不因个人删除自动物理清理；员工个人删除边界见 4.5；具体清理条件及期限按制度和引用情况另定 |

**交接依赖而非已定数值：**研发提供单文件／总包容量、包兼容与标识格式核查；留存期限需制度依据。上述结果影响业务规则时再由产品确认。具体版本文本格式及状态映射仍需研发兼容方案，执行中行为见第6.4节，不预设未经兼容核查的技术限制。

#### 4.4.3 已确认的职责与关联规则

| 事项 | 已确认建设规则与边界 |
|---|---|
| 个人发布企业技能 | 创建独立企业对象，默认继承名称及获准内容；企业后续调整不覆盖个人对象，删除个人对象不连带企业快照 |
| 内容修改与旧任务 | 内容修改生成新版本；旧任务继续引用原确定内容，不偷偷换最新包 |
| 展示信息修改 | 名称、说明、分类、标签作为资产信息维护，不因分类或标签修改重建完整资源包。列表和详情展示资产信息；执行加载使用确定版本的SKILL.md及资源；原包导出保留确定版本原文与元数据，不以展示信息覆盖包内值。生成含新元数据的包须建立新内容版本，研发需明确现有字段解析映射 |
| 审批 | 各应用保留独立流程，审批针对确定内容版本及提交时的名称、说明、分类、标签快照；通过后写入发布结果，不统一审批队列。个人后续管理信息修改不自动改写申请；管理员按原授权规范企业信息时留存变更记录 |
| 发布与风险校验 | 审批申请、意见、驳回、撤回、扫描风险明细、人工风险确认留在应用业务，绑定确定内容版本；底座保留必要来源业务引用，不执行技能 |
| 执行与统计 | 任务、结果、失败原因及调用统计留在应用任务与统计系统，不混入技能资产 |
| 我的分组 | 底座独立保存用户、应用、分组与资产关联，不塞入正文；按用户及所属应用隔离 |
| 草稿 | 首期保留应用本机草稿现状，不自动迁入正式资产 |
| 账号与组织展示 | 创建人部门名称等从统一账号和组织获取，避免重复保存易过期值 |
| 下架、删除与撤权 | 新调用、历史查看、重跑及执行中规则见第6.4节；审核／匿名统计留存及物理清理需制度依据 |
| 迁移 | 保留完整内容和来源关系，不按名称合并、不截断正文、不把全部版本改成 1.0.0 |

#### 4.4.4 来源差异与待决事项

| 事项 | 来源差异／当前事实 | 本文采用的口径 |
|---|---|---|
| 企业彻底删除 | 2026-09-28 架构与 V2.1.0 旧需求仍禁止；Studio 项目记忆 2026-10-06 起记录新增删除功能，后续有删除实测；当前审核详情可见永久删除入口 | 不恢复旧禁删条款。目标方案包含删除功能；员工个人删除及旧任务查看／禁止失效重跑已确认；管理员企业删除实际授权范围、审核与匿名统计最小留存、文件清除条件及运行中断能力仍需核查；执行中目标行为见第6.4节。删除行为未验证 |
| 版本能力 | 旧需求写首次统一 v1.0、暂不做更新／历史／回退；截图多数 1.0.0；审批页面样本 1.9.0，企业列表可见 1.1.1、1.5.0 | 保留真实来源版本文本，不重写为固定版本；不能由多个版本号推断完整版本管理。统一底座的不可变内容版本和旧任务引用是建设要求，现有实现待研发核实 |
| 状态文案 | 旧需求规定用户端五类一级状态；截图仍见未提交、已驳回、已撤回、已下架 | 保留页面事实，不擅自认定新建设沿用旧映射或当前文案；建议定义审批、个人可用、企业发布三个不同维度，再由应用展示映射 |
| 包内声明与检测结果 | 审核样本权限声明为空，但页面检测到网络、Shell、脚本风险 | 证明两类信息需区分，不能以空权限声明判为安全；实际扫描能力、风险等级算法与批准策略待研发／产品确认 |
| 用户导入与后台直发格式 | 用户端 ZIP 入口说明也支持单独 Markdown；后台 ZIP 输入仅 accept=.zip | 分入口保留差异；新数据源接收哪种规范化包与转换结果待研发核实，不静默统一为同一上传限制 |

已确认模型、字段校验及职责见 4.4.2—4.4.3。剩余交接依赖：容量与包兼容核查、留存制度依据；标识／版本格式及状态映射由研发核查兼容性，执行中失效按第6.4节实施。调用权限由实际服务校验，不以分类、标签或包内 visibility 声明代替授权；具体授权与拦截策略待核实。

定稿前由研发核实：名称和标识唯一性范围、前后端全部校验、包解析优先级、资源完整性与安全阈值、稳定个人／企业／提交关联、跨设备个人数据存储、同版本不同内容及历史读取、发布写入失败重试、删除后审核与匿名统计真实留存。缺少代码或接口证据的项不在本文标为已实现。

#### 4.4.5 技能专属验收要求

| 场景 | 需要验证的结果 |
|---|---|
| 创建表单与生成包 | 七项规范、简介、引导语、输入输出、权限与依赖映射准确；生成后再解析不丢内容 |
| 含多级资源及扩展元数据的导入包 | 原文、元数据、相对目录与文件完整；缺文件、非法路径、凭据与不兼容能力按确定规则处理 |
| 个人技能提审与企业规范化 | 审核对应确定提交内容；企业名称分类标签变更不覆盖个人对象；个人删除不连带企业快照 |
| 同名个人／企业技能 | 允许同名，以稳定对象和来源定位，不按名称误选；跨用户私有对象不可越权 |
| 标签选填与校验 | 企业无标签仍可按流程发布；填写时最多 10 个、每个 20 字符且去重；不得继续强制至少一个 |
| 新建与旧包章节 | 新建七章非空；旧包缺章节提示但允许导入，原文不被改写 |
| 重复导入／发布 | 同用户相同内容提示并复用个人资产；个人删除后重新导入恢复本人关系，不连带改变企业对象；企业相同内容重复发布提示已有对象 |
| 相同版本号但包内容不同 | 能定位实际使用内容，不能仅凭版本文本判断相同包；具体冲突处理在规则确认后验收 |
| 企业下架、删除或撤权与旧任务 | 按已确认失效规则阻止不允许的新调用；历史展示与重跑分别验证，旧任务不偷偷换最新包 |
| 业务审批通过或管理员直发后底座写入失败 | 不虚报已发布；重试不重复创建企业对象；恢复结果可追溯 |
| 技能匿名统计 | 口径与版本关联一致；不以下载或查看冒充调用；删除后留存按后续确认规则核验 |

### 4.5 三库员工个人删除规则

本规则适用于素材、提示词和技能，是已确认建设规则，不代表现有系统已实现。

- 员工个人删除仅移除个人侧记录或可见关系，不向员工提供完整物理删除入口；未共享资料也不得由员工操作直接触发完整物理清除。
- 已共享或已发布到企业的资料继续保留，个人删除不改变企业共享关系、企业可用状态或企业访问权限。
- 素材和提示词保持原有同一资产共享模型，只移除个人侧关系，不删除企业仍引用的资产；技能保留独立企业对象及其确定内容。
- 不得因个人删除连带清除企业引用的正文、文件、技能包及内容版本。
- 底层物理清理由系统按留存规则处理，不向员工提供直接入口。首期不建设自动物理清理；清理条件、留存期限需制度依据，执行中行为见第6.4节；企业失效后的历史查看及禁止重跑见第4.4.2节；本条不扩大管理员企业删除权限。

交付验收：三库分别验证员工删除后个人侧不再展示、企业侧仍可按原权限访问且内容完整；验证个人删除接口不会执行完整物理清除。企业删除、下架和撤权另按相应规则验收，不能混为个人删除。

## 5. 我的分组与存量字段处理

### 5.1 已确认的分组规则

统一数据源保存分组及资产关联，记录分组所属用户和所属应用。首期不强制跨平台共用分组；其他应用可以忽略分组，继续按资产权限、分类和标签读取同一资产，按需接入分组查询能力。

- 分组属于用户的个人整理关系，不改变资产归属、共享范围或维护权限；其他用户不自动继承该分组。
- 修改或删除分组只改变个人整理关系，不删除资产，不影响已有任务引用。
- 分组不是各应用的必填字段，也不作为统一分类或权限判断依据。

| 中文业务信息 | 用途 | 状态 |
|---|---|---|
| 分组所属用户 | 确定谁的整理关系 | 已确认按用户隔离；具体身份字段由研发设计 |
| 分组所属应用 | 区分不同应用的整理习惯 | 已确认按所属应用隔离；按需跨应用使用 |
| 分组名称 | 用户识别分组 | 名称50字符、同用户同应用不重名；首期不新增产品数量限制 |
| 分组与资产关联 | 记录哪些资产被整理进该分组 | 关联保存已确认；单资产可加入多个分组，按用户和应用隔离 |

### 5.2 历史超限内容

迁移时保留已有超限内容，不截断或丢弃。历史超限资产允许只改其他字段，修改超限字段时该字段适用新限制（见第6.1节）；研发提供名称、说明、正文、标签的实际长度分布及受影响记录数量，供产品复核。若需调整已确认上限，须记录新的确认结果。

必填项、标签等新校验也不能自动当成历史数据删除依据。缺失归属、无效分类、文件不可读等迁移异常按第一阶段确认的业务处理规则执行，不伪造缺失的历史信息。

## 6. 已确认产品执行规则与研发交接

本章定义字段、权限、版本、异常及入口行为要求。现有页面事实用于映射与兼容核查，不作为目标规则的限制。

### 6.1 素材、提示词及共性字段规则

| 事项 | 已确认业务规则 |
|---|---|
| 素材／提示词名称 | 必填、去首尾空格、不可纯空白，最多100字符；允许同名，以资产ID区分 |
| 提示词正文 | 必填且不可纯空白；5,000以上提醒，10,000上限；保留正文内部换行和格式 |
| 提示词用途说明 | 选填，最多500字符 |
| 素材说明 | 统一业务字段“素材说明”，选填、最多500字符；批量统一备注用于本批各素材，逐条修改只影响对应资产；旧字段映射由研发核实 |
| 分类 | 素材类目与提示词用途沿用各自词表并默认“通用”；技能分类单选必填，不预设默认项；不跨库合并词表 |
| 提示词效果图 | 选填，最多3张，JPG／PNG，单张不超过20MB；不自动当作执行输入 |
| 需要参考图 | 勾选后执行时至少提供1张，缺图阻止执行；应用最大数量受实际能力约束；未勾选不强制 |
| 标签处理 | 输入支持中英文逗号；先拆分、去首尾空格、移除空项，再去重和校验上限；去重大小写及字符计数由研发给出一致方案，若影响业务再确认 |
| 分组 | 名称必填、最多50字符、去首尾空格；同用户同应用内不重名；一项资产可加入多个分组；首期不新增产品数量限制，技术容量需明确 |
| 查询 | 不同筛选维度取交集，同维度多选取并集；默认更新时间倒序，同时间稳定排序由研发实现；分页参数由研发设计。合法无结果返回空列表，无权限／查询失败返回明确原因 |
| 验证与统计 | 首期不新增统一验证标准或跨平台统计；保留应用职责与来源，不把某应用验证或次数当全局事实 |
| 历史超限编辑 | 原值完整保留，可只改其他字段；修改超限字段时，该字段须符合新规则；不因未修改历史超限值阻止其他信息维护 |
| 缺失或异常迁移 | 缺归属、无效分类、文件损坏等进入异常清单，不自动删除或转公共；未解决记录不通过该批切换，不伪造信息 |

### 6.2 角色与操作矩阵

沿用原平台已有授权，不因统一数据源接入新增权限或扩大可见范围。原平台角色具体映射由研发核查；映射不清时不自动授予权限。

| 主体／范围 | 查询和使用 | 修改管理信息／内容 | 删除或发布 |
|---|---|---|---|
| 员工本人个人资产 | 本人获准读取和使用，应用另查执行能力 | 按现有授权维护本人资产；提审内容冻结，可另建新版本 | 个人删除只移除个人侧关系，不物理清除；共享／发布走原业务审批 |
| 他人个人资产 | 无明确授权拒绝 | 无明确授权拒绝 | 管理员身份不自动取得代删或编辑权 |
| 团队资产 | 原组织可见范围内使用 | 原获授权维护角色操作，能看不等于能改 | 原获授权角色按原审批和操作规则处理，不扩大权限 |
| 公共／企业资产 | 原可见范围内使用；企业技能沿用全员可见边界 | 原获授权角色维护；内容更新重新走原应用发布流程 | 员工个人删除不影响共享资产；下架及企业删除由原获授权角色操作 |
| 获授权业务服务 | 仅在授权范围内查询 | 校验对象、修订和操作权限后写入 | 写入可追溯发布结果；不相信客户端自行传入的“已通过” |
| 停用账号 | 拒绝该账号后续受控访问 | 拒绝 | 企业共享资料保留，不随账号停用自动删除 |

组织变化不自动扩大授权，由统一身份和原授权规则计算。归属不明或无人维护的共享资产保留，不自动转移所有权；需要业务授权的管理动作进入人工处理。

### 6.3 字段变化与版本影响

| 变化 | 版本及发布规则 |
|---|---|
| 正文、素材文件、技能包、输入要求、执行配置 | 生成新内容版本；已发布内容按原流程获准后才更新生效引用，旧内容不覆盖 |
| 名称、说明、分类、标签、分组 | 管理信息修改，不重建完整资源包，不改变旧任务实际输入 |
| 共享范围、维护权限 | 单独校验授权并更新权限关联，不覆盖正文；对新调用和受控访问生效 |
| 效果图 | 展示资源管理；不作为任务执行输入。变化的资源保持确定引用，不替换已记录任务内容 |
| 内容提审 | 冻结确定提审版本及提交时的管理信息快照；个人新版本或管理信息修改不自动替换原申请；审批结果只能作用于获准版本与企业发布信息 |

### 6.4 失效、留存与迁移边界

- 员工个人删除按第4.5节，企业资料继续保留，不执行完整物理删除。
- 企业下架、删除或撤权后，禁止不获准的新调用和重跑；旧任务已保存内容和结果按任务权限查看，不因此重新授予原资产使用权。
- 执行中发生企业下架、删除或撤权时，停止后续受控读取、新生成及外部操作，保留已完成结果；对已启动的调用或操作尽力取消。无法中断的调用及无法撤销的外部动作须明确反馈，由研发核查覆盖，不承诺全部即时停止。
- 首期不建设自动物理清理；具体清理条件、留存期限及制度依据另行确定。管理员企业删除不等于立即清除被历史引用的底层资源。
- 迁移保留内容、归属、权限、旧编号及版本引用；不按名称自动合并。技能相同内容导入去重按第4.4节，不能将请求重试去重直接等同于所有资产内容去重。
- 切换发现丢失、越权或关键引用损坏，该批不通过；批次、窗口与回退设计由研发提出，再联合评审。

### 6.5 第一阶段受影响入口清单

本清单是产品要求的业务覆盖范围，不证明所有入口当前存在。第一阶段由两端研发逐行标记“现有／需适配／不适用及理由”，补充页面、接口、存储和负责人，作为底座设计与估算输入；第二阶段建设底座，第三阶段按清单改造并联调，第四阶段迁移切换。不得等底座完成才首次盘点。

| 应用与业务入口 | 本期预期行为 | 底座或应用配合 | 实际入口核查 |
|---|---|---|---|
| 设计平台素材列表／详情／任务选择器 | 按身份、范围、分类标签读取同一素材 | 查询、详情与确定文件版本；列表与引用分离 | 待研发定位页面／接口 |
| 设计平台素材上传／编辑／个人删除 | 主动入库、按规则编辑、个人删除不影响企业资料 | 受控写入、版本、个人关系移除 | 待研发核查批量及逐条入口 |
| 设计平台提示词列表／详情／任务选择器 | 读取统一正文及元数据，临时修改记录到任务 | 查询、确定版本和实际任务输入 | 待研发定位页面／接口 |
| 设计平台提示词创建／编辑／个人删除 | 执行长度校验、历史兼容及个人删除规则 | 受控写入、版本、关系移除 | 待研发定位页面／接口 |
| 设计平台灵感收藏／复制 | 保留原来源和个人副本关系，不等同普通读取 | 来源关联、现有重复收藏规则 | 待研发核查来源映射 |
| 设计平台团队／公共审批及发布结果 | 审批保留原系统，获准结果写回底座 | 授权写入、失败重试、修订冲突 | 待研发核查两级共享流程 |
| 两端个人分组、分类标签筛选 | 分组按用户与应用隔离，分类标签不代替权限 | 分组关联、组合条件查询 | 各端按已有能力适配，不强制新建分组页面 |
| Studio技能列表／详情／任务选择 | 个人、企业统一读取各自对象及确定包 | 技能查询、权限、版本与资源包 | 待研发定位加载和缓存入口 |
| Studio技能创建／编辑／导入／在线来源 | 七章及长度规则、兼容旧包、保留来源 | 原包解析、内容版本、资源与去重 | 待研发核查各来源及后续阶段 |
| Studio个人删除／我的提交 | 删除不影响企业；提交关联确定内容 | 个人关系移除；提交与审批保留业务端 | 待研发核查状态及记录关联 |
| Studio审核／待发布／管理员直发 | 不统一审批，企业标签选填；获准写入企业对象 | 来源版本关联、校验授权、失败重试 | 待研发核查发布接口与实际表单 |
| Studio企业管理／下架／删除 | 原授权角色操作，控制新调用及重跑 | 有效性和引用保留；留存待制度依据 | 待研发核查物理清理及运行中控制 |
| 两端新任务／历史查看／重跑 | 记录实际输入，原版本重跑，重新校验执行条件 | 应用任务记录与底座确定版本读取 | 待研发核查历史可还原范围 |
| 两端刷新、旧编号、存量迁移切换 | 重新读取一致结果，单一权威写入 | 缓存刷新、映射、对账和回退 | 第一阶段设计，第四阶段执行 |

研发交接产物需补：入口定位、接口／存储现状、适配工作、不可还原限制、负责人、依赖及工作量；产品核对业务行为。具体代码文件、函数、接口地址、错误码和部署方式不在本清单预设。

### 6.6 输入输出与异常交接

| 场景 | 业务输入 | 必须可理解的输出 |
|---|---|---|
| 新增 | 类型、内容资源、归属与目标范围、分类标签、来源、可信身份及请求标识 | 已保存、资产ID、确定版本及可用状态；校验／权限失败返回原因 |
| 内容修改或发布 | 目标资产、基于版本、新内容、保存／发布意图、获准授权及请求标识 | 新修订ID、当前生效版本及“修订已保存／发布已生效”；冲突不覆盖，返回可访问当前修订信息 |
| 列表查询 | 身份、范围、应用筛选、排序分页 | 获准列表及分页；合法无结果为空，失败不是空列表 |
| 按确定引用读取 | 资产ID、指定或当前获准版本、身份及查看／使用用途 | 素材确定文件引用、提示词完整正文、技能完整包及必要声明；均返回确定版本。无权、失效、版本缺失、服务异常返回不同业务原因，不换最新内容 |
| 发布结果写入 | 获准业务服务、确定修订、业务记录引用及请求标识 | 发布已生效或明确未生效；超时结果待确认，按原请求标识核查／重试，不重复发布 |
| 新任务输入记录 | 实际输入、确定版本、执行配置及来源 | 任务ID、执行记录ID及保存确认；失败或结果未知时不执行 |
| 旧任务重跑 | 旧任务ID、可信身份、重跑请求标识 | 原输入可还原且有权执行时新建本次执行记录；返回旧任务ID、本次执行记录ID、状态及结果引用，不覆盖原输入及执行结果 |
| 个人删除 | 本人身份、目标个人记录 | 个人侧移除结果，企业关联和底层内容保留；不提供物理删除执行结果 |

- 超时或连接中断可能发生在写入完成之后，不能一律等同“未保存”。显示结果待确认，使用同一请求标识核查或安全重试；不可另发全新请求导致重复资产、版本或发布。
- 请求重试去重与内容重复规则是两件事；核查结果只返回有权读取的信息。
- 任务实际输入与本次执行记录必须确认保存后才执行。执行后结果记录失败时，明确报告执行与记录的真实状态，不因记录失败自动再执行外部动作。
- 修订保存成功不等于发布生效；待发布内容不自动替换当前生效版本。
- 历史任务无权限、记录不存在、原输入无法还原与服务异常分别表达；不把当前资产内容补成历史输入。
- 技术请求结构、核查接口、错误码及分页结构由研发设计，不在总方案预设。

## 7. 第一阶段交付的验收依据

### 7.1 底座验收要求

以下从原整体方案第 12.3 节迁入，作为第一阶段需要交付的验证要求，在第二阶段执行；应用任务记录与重跑完整链路在第三阶段验证。

| 产品跟进项 | 核心检查 | 验收证据 |
|---|---|---|
| 三库范围完整 | 素材、提示词、技能都支持本期约定的个人与共享资产能力，不能只用提示词通过代表全库通过 | 三库分别执行的结果记录 |
| 跨平台同一资产 | 同一用户从两个应用身份查询，获得同一资产编号、内容和归属；修改写回同一处 | 两个应用请求上下文的读写记录 |
| 权限与筛选分离 | 列表先满足访问权限再按业务条件筛选；已有引用不套用列表过滤；改查询条件不能读到他人私有资产 | 正向、排除筛选及越权反例 |
| 新增和修改结果可理解 | 保存成功才返回成功；重复请求不重复建资产；旧修订覆盖新内容时明确返回冲突 | 成功、失败、重试和并发修改记录 |
| 版本与历史读取 | 正式内容更新不覆盖原版本；底座支持按确定版本获取文件、正文或技能包 | 新旧版本对比及固定版本读取结果 |
| 业务结果写入 | 有权业务服务能够保存审批后的发布结果；无权写入被拒绝；失败不能伪报已发布 | 发布结果写入及冲突记录 |
| 删除与失效 | 按第一阶段确定的规则处理删除、下架、撤权及已有引用；不把“不展示”当成“已删除” | 相应条件下的响应和资产状态 |
| 接口可交接 | 接口说明使用清楚的业务解释，包含筛选示例、操作结果、错误原因和两端需配合事项 | 接口说明与联调清单 |

### 7.2 共性规则的最小验证集

| 样例 | 需要验证的结果 |
|---|---|
| 本人个人资产、他人个人资产 | 本人按授权读取，他人私有资产不能越权访问 |
| 团队、公共／企业资产 | 相应可见范围正确，能使用不自动获得编辑权 |
| 带有被某应用排除标签的资产 | 列表不展示，但已有引用在实际权限允许时仍可读取 |
| 已发布内容的旧版本与新版本 | 新查询按规则获得当前版本，指定旧版本仍定位原内容 |
| 两个应用同时编辑同一资产 | 无提示覆盖被阻止，冲突原因可交回业务端处理 |
| 请求超时后重试 | 不重复新增资产或重复产生同一发布结果 |
| 业务端审批通过但底座写入失败 | 结果可追溯，业务端能够识别未生效，不错误显示已发布 |

各库使用等价样例验证共性规则，并保留文件读取、提示词正文、技能包完整性等专属检查。样例覆盖个人与共享范围，不要求构造无意义的维度组合；测试数据使用受控样本。

### 7.3 字段规则的边界样例

| 样例 | 预期行为 | 前置条件 |
|---|---|---|
| 新增素材名称或提示词名称为 100／101 字符 | 100 满足长度限制；101 不满足长度限制 | 按后续统一计数口径；其他保存条件均满足 |
| 用途说明为 500／501 字符 | 500 满足长度限制；501 不满足长度限制 | 不据此推断是否必填 |
| 正文为 5,000／5,001／10,000／10,001 字符 | 5,000 不触发长度提醒；5,001 与 10,000 提醒但不因长度阻止保存；10,001 不满足新内容上限 | 按研发评审的一致计数口径；历史超限编辑见第6.1节 |
| 标签为 10／11 个，单标签为 20／21 字符 | 分别检查数量与单项长度上限 | 拆分、去首尾空格、移除空项、去重后校验；大小写及计数按研发一致方案 |
| 标签带首尾空格或出现重复项 | 去除首尾空格与重复项 | 大小写判重与计数由研发提出一致方案，影响业务时联合评审 |
| 设计平台存在个人分组，Studio 未接入分组功能 | Studio 仍可按权限与自身筛选规则读取资产 | Studio 不把设计平台分组作为必填条件 |
| 修改或删除个人分组 | 资产本身、共享权限和已有任务引用保持有效 | 只修改分组及关联，不额外执行资产操作 |
| 迁移历史超限正文 | 原文完整保留，不截断或丢弃 | 允许改其他字段，修改超限字段时适用新规则 |

以上用例用于后续验收。

### 7.4 补齐规则的验收样例（后续执行）

| 场景 | 预期结果 |
|---|---|
| 名称纯空白、同名资产 | 空白不允许；同名可保存且ID不同 |
| 素材说明500／501字符 | 500允许，501拒绝；不覆盖其他批次素材 |
| 提示词效果图3／4张、格式／大小不符 | 3张允许；超数量或约定格式、大小拒绝，提示原因 |
| 要求参考图但任务无图 | 阻止执行并提示补图；展示效果图不自动计入输入 |
| 企业技能无标签 | 仍可按原获准流程发布 |
| 分组同用户同应用重名／跨应用同名 | 前者拒绝，后者允许；同资产可关联多个分组 |
| 多维筛选、同维多选、空结果、服务异常 | 交集／并集正确；合法空列表与失败明确区分 |
| 他人个人资产、停用账号、无权管理员 | 拒绝越权读写；不影响企业共享资料留存 |
| 历史超限正文只改标签／修改正文 | 只改标签允许；修改正文须满足新上限；未改原文完整保留 |
| 三库个人删除 | 个人侧关系移除，企业仍按原权限读取，文件正文包内容完整，无物理清除 |
| 内容更新与管理信息修改 | 内容变化新版本；分类标签不重建包，旧任务原输入不变 |
| 下架／撤权发生在执行中 | 停止后续受控读取和外部操作，保留已完成结果；不可中断能力明确报告 |
| 归属不明、文件损坏、关键引用缺失 | 列入异常清单，不自动删除或转公共；相关记录不通过该批切换 |

| 写入超时但实际已保存 | 展示待确认，原请求标识核查／重试返回同一结果，不重复资产或版本 |
| 修订保存与发布生效 | 两种结果及当前生效版本明确区分，未发布修订不替换当前内容 |
| 输入或执行记录保存失败 | 不启动执行／重跑；结果未知先核查，不盲目重复执行 |
| 历史记录不存在／不可还原／服务异常 | 分别提示，不用最新内容替代历史输入 |
| 重跑成功及结果记录失败 | 新执行记录关联旧任务，原记录不覆盖；记录失败不自动重做外部动作 |

以上仅为验收要求，未执行生产测试。

## 8. 研发现状核查、阶段完成条件与来源

### 8.1 研发需要提供的核查结果

| 核查项 | 开发需要给出的事实 | 产品据此决定什么 |
|---|---|---|
| 数据与文件 | 实际数据库、文件或技能包位置、资产数量、文件规模、归属及分类缺失情况；两库字段长度和标签分布 | 本期迁移范围、分批顺序、业务清理优先级及字段规则兼容 |
| 身份与接口 | 已有账号标识、组织映射、资产接口、权限检查及可复用能力 | 跨平台权限规则是否可直接承接，哪些业务规则需要补齐 |
| 历史任务 | 是否保存实际正文、文件版本、技能包版本及旧引用 | 哪些历史任务可继续使用，哪些存在无法还原的限制 |
| 技能字段与包兼容 | 短字段、正文与资源规模分布；前后端校验；包解析优先级、扩展元数据及资源完整性 | 技能专属阈值、导入兼容与迁移规则，不直接套用两库长度 |
| 技能关联与留存 | 个人、提交、企业对象与确定包内容的真实关联；同号不同包；删除后审核、匿名统计和文件的留存 | 发布关联、历史引用、删除边界及最小留存规则 |
| 工程与上线 | 两平台改造点、测试环境、发布方式、技术依赖和工作量 | 阶段排期、业务配合及切换影响 |

### 8.2 第一阶段完成条件

产品范围和关键业务规则可执行，开发完成必要事实核查，形成可评审的数据模型、接口范围、两端改造和迁移方案；产品与研发对影响范围和验收口径无关键分歧。负责人和排期按真实工作量安排。

产品业务规则可交研发评审；仍需实际入口、权限映射、容量、包兼容、历史可还原性及留存制度依据。第一阶段只有联合设计评审及必要核查完成后才可关闭，不宣称已完成开发或上线。

### 8.3 来源与维护

| 来源 | 使用范围 |
|---|---|
| [整体方案规划](三库现状与统一数据源建设规划_2026-09-28.md) | 已确认架构边界、共性规则、四阶段路线 |
| [素材库与提示词库现状规则（2026-09-28）](../01_先马AI设计平台/02_产品输出/资源管理与权限/素材库提示词库现状规则架构与业务流程_260928.md) | 两库既有对象关系与审批、共享规则；用于现状映射与兼容核查 |
| 设计平台素材页面与提示词页面（2026-10-10 查看） | 字段、输入长度属性、分类选项与展示信息；仅做只读盘点，未验证后端校验 |
| Studio 用户端页面截图（2026-10-10） | 列表、内置详情、个人管理、我的提交与创建字段；截图无法确认的约束保留待核实，不转载真实正文与人员信息 |
| Studio 用户端导入入口与管理端现行页面（2026-10-10 只读查看） | 导入首阶段；审批、企业详情及直接发布字段和可见约束；未执行导入、审批、发布或删除，不代表端到端验证 |
| [Studio 项目记忆](../02_AI%20CLI企业管理/项目记忆.md) | 删除功能及验证证据；审核与统计留存仍待确认 |
| [技能库 V2.1.0 需求](../02_AI%20CLI企业管理/V2.1.0/01_产品需求/技能库V2.1.0-需求说明.md) | 既有字段、来源与对象规则；删除与版本能力差异见4.4.4，现行要求见本文规则 |
| [技能库架构与业务流程](../02_AI%20CLI企业管理/00_项目公共资料/04_架构与流程/XMAI%20Studio-技能库架构与业务流程.md) | 2026-09-28 历史架构背景；现行要求见本文规则 |