全部文档

资料库(模板与表格)

- 产品规格.md §3.2.1(知识文档)、§3.2.2(规范库)、§3.2.3(资料库)

来源 docs/core-mechanisms/资料库.md

状态:Phase 1 已落地(2026-07-25):元数据 + 文件存储、成员 CRUD/发布、插件只读、协作简介 + 全屏管理页(/workspace/assets,状态/类型/搜索筛选)、对话元数据注入。

真值:用户可见能力见 docs/产品规格.md §3.2.3;本文供设计与实现对照。

表述:界面与帮助文案用用户表达(「资料库」「模板与表格」);表名、API、路径等实现术语仅在本文 §7 给出。

关联


1. 目标

  • 工作区 内提供团队共用的 表格、表单模板、合同样例、检查表空白版、自己做好的演示/文档/表格样式 等可下载/可套用文件(用户说法:资料库,副题可用「模板与表格」)。
  • 成员下载套用智能体按名称/标签取模板并填表产出附件平台插件(人力资源、合规等)读取当前生效模板。
  • 规范库(依据什么)和 知识文档(怎么解释)分治,避免把 Excel/Word 当 Wiki 或法规真源硬塞。

1.1 非目标(首期)

  • 不替代 聊天附件(会话内临时上传仍走 uploads)。
  • 不替代 技能包 references/(仅绑定某一技能的长模板仍放技能内)。
  • 不替代 应用模板 / 智能体市场模板(界面与助手配置模板是另一类产品对象)。
  • 不做全站公有「模板市场」(可二期;首期工作区隔离)。

2. 与相邻能力的分工

| | 知识文档 | 规范库 | 检查方案 | 资料库 | |--|-------------|-----------|-------------|-----------| | 典型内容 | Markdown 说明、FAQ | 法规、制度、理论 | 机读检查包 | xlsx / docx / pdf / csv 等模板与样表 | | 主要用法 | 对话检索答疑 | 答疑依据 + 展示「要求」 | 问卷选用 → 生成检查项 | 下载、套用、填表生成新文件 | | 版本门控 | 弱 | 强(效力/人审) | 强(须依据规范后发布) | 建议有「当前生效版」;复杂模板可草稿→发布 | | 是否当条文真源 | 否 | 是 | 否(依据规范) | 否(可 依据 某条规范) |

可选关联:资料库条目可填写 依据规范(规范 ID + 版本),便于审计「这张入职表依据哪份制度」。专家检查表转换后的机读包进 检查方案,不在本库存机读包真源。

浏览:后续可按领域/用途等 索引树 筛选(与规范库同类约定:树为浏览索引,非知识物理目录);首期扁平标签 + 列表即可。详见规范库 §4.7

规范库(条文怎么说)
    ↑ 依据
检查方案(怎么查 · 机读包)
    ↑ 可选来源
资料库(专家表原件 / 空白表 / 填报模板)
知识文档(怎么用、流程说明)
技能 references(仅某技能私用)

3. 产品决策(已确认,2026-07-25)

#主题结论
1用户可见名称资料库(副题「模板与表格」)
2隔离边界按工作区;禁止跨工作区读
3存放位置平台工作区能力,不挂在某一插件私有目录
4与规范库分治;资料库可引用规范,不反过来把二进制塞进规范正文为主存储
4b与检查方案(2026-08-07)分治;检查表原件在本库,机读包在检查方案,在本库存机读包真源
5与知识文档分治;禁止把表格当 Markdown 知识硬塞进知识目录作为主存放
6权限成员可读/下载已生效条目,并可看到自己的草稿;办公样式由上传者自己发布/废止;合同/检查表等仍由 owner/admin 发布;导入/导出仅管理员
7插件读取经平台只读 API(launch_token 或工作区鉴权),按领域标签筛选
8智能体使用可按标题/标签检索元数据;取文件后经办公/脚本能力填表,产出 新附件(不覆盖资料库真源)
9领域标签与规范库对齐(如 hrlabor),便于插件订阅
10出厂默认插件可带默认模板包;工作区资料库当前生效版可覆盖

4. 用户可见能力(规划)

4.1 资料条目

  • 标题、说明(短摘要)
  • 文件(至少一版当前文件;历史版本可保留)
  • 类型:演示样式 / 文档样式 / 表格样式 / 表格模板 / 表单模板 / 合同样例 / 检查表空白版 / 其它
  • 领域标签
  • 状态:草稿 / 已发布(生效)/ 已废止(首期可简化为「生效 / 废止」)
  • 版本号
  • 可选依据:关联规范库条目与版本
  • 来源:手工上传 / 从技能或插件导入(可选)

4.2 成员与管理员

  • 成员:浏览已发布条目、下载、在对话中请助手「按某某模板生成」;可上传自己的办公样式并发布,同事即可在「制作演示文稿 / 写一份文档 / 做一份表格」中选用。
  • 管理员:上传、更新为新版本、废止;合同样例与检查表等仍由管理员发布;废止后成员与插件不再作为默认套用源。

4.3 智能体与插件

  • 智能体:检索资料库元数据 → 取得文件 → 填表/改写 → save_upload 类能力交付;禁止把资料库当前版当面会话草稿随意覆盖写回(写回须显式管理操作)。
  • 插件:只读列表/下载当前生效版;开局或检查流程「选用模板」时记录 资料 ID + 版本

5. 端到端示意

flowchart LR
  A[管理员上传入职登记表.xlsx] --> B[资料库已发布 v1]
  B --> C[成员下载套用]
  B --> D[智能体填表 → 新附件]
  B --> E[HR 插件开局选用]
  F[规范库·某制度 v3] -.->|依据| B

6. 与现有对象的边界(勿混名)

已有对象用途勿当作资料库
聊天 uploads会话附件非团队资产目录
技能 references/单技能长模板非全工作区共用柜
workspace_app_templates应用界面/包模板不是 Excel 业务表
agent_templates智能体市场模板不是填报表
规范库正文/附件法规与制度真源空白业务表应进资料库

7. 实现对照

概念实现
元数据workspace_assets
文件{RuntimeDir}/workspaces/{id}/assets/{assetId}/draft.{ext}v{N}.{ext}
成员 APIGET/POST /workspaces/{id}/assetsGET/PATCH …/{assetId}GET/PUT …/file;`POST …/publishrevokereopen导入/导出 POST …/assets/importGET …/assets/export`(zip)
插件只读GET /platform-plugins/assets…/{id}…/{id}/filelaunch_token
对话注入匹配模板 元数据(不嵌入二进制)
配额计入工作区存储配额(§4.5,后续强化)
压缩包manifest.jsonkind=mindlink.workspace_assets)+ items/{dir}/item.json + 资料文件(包 internal/assetsbundle)。增量导入(默认):按 标题+文件名(否则仅标题)匹配;文件哈希相同则跳过;匹配到草稿则更新;已发布/已废止不覆盖。可选按标题/文号弱关联规范。

现状:Phase 1 + 压缩包导入/导出(管理页「导入 / 导出」)已落地;待做:配额硬门控、从技能/插件导入、智能体自动填表工具链;合规实践检查表可作为原材料,转换结果进 检查方案(见 检查方案.md合规实践检查表转机读包.md)。


8. 验收要点

  • [x] 工作区协作出现 资料库 入口;与知识文档、规范库、检查方案并列;「管理资料库」进入全屏页(返回 + 标题 + 工作区名;左列表 / 右元数据与下载)。
  • [x] 管理员可上传 xlsx/docx 等并发布;成员可下载当前生效版;成员可上传并发布自己的办公样式。
  • [x] 对话可按名称/标签看到模板元数据(填表产出附件依赖办公能力,不覆盖真源)。
  • [x] 插件可按标签只读拉取文件。
  • [x] 可选关联规范库「依据」;废止后不再作为默认套用源。

9. 修订记录

日期说明
2026-07-25初稿:资料库定位、与知识/规范/技能模板分工、插件与智能体用法
2026-07-25Phase 1 落地:API / UI / 插件只读 / 对话元数据注入
2026-07-25全屏管理页 /workspace/assets;按状态、类型、关键词筛选(非规范库索引树)
2026-07-25补充:后续可按领域/用途索引树浏览(对齐规范库 §4.7)
2026-08-06实践检查表作合规机读包原材料;详稿见 合规实践检查表转机读包.md
2026-08-07转换结果目标更正为 检查方案(方案 B);见 检查方案.md
2026-08-05压缩包导入/导出(仿知识文档;管理员;导入为草稿)
2026-08-15办公样式:成员上传/发布演示·文档·表格样式;对话选用时复制为新附件