资料库(模板与表格)
- 产品规格.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 给出。
关联:
- 产品规格.md §3.2.1(知识文档)、§3.2.2(规范库)、§3.2.3(资料库)
- 规范库.md(条文真源;可与资料库条目「依据」关联)
- 检查方案.md(实践机读包;原件可来自本库检查表类型)
- 合规实践检查表转机读包.md
- 智能体调用知识文档的方式.md(对话检索;资料库以「可套用文件」为主,不是 Wiki)
- 工作区能力包.md(办公文档读写、脚本产出附件)
- 技能组成规范.md(技能包内
references/仅服务该技能) - ../sdk/platform-plugin/README.md(平台插件只读共用资源)
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 | 领域标签 | 与规范库对齐(如 hr、labor),便于插件订阅 |
| 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} | ||
| 成员 API | GET/POST /workspaces/{id}/assets;GET/PATCH …/{assetId};GET/PUT …/file;`POST …/publish | revoke | reopen;导入/导出 POST …/assets/import、GET …/assets/export`(zip) |
| 插件只读 | GET /platform-plugins/assets、…/{id}、…/{id}/file(launch_token) | ||
| 对话 | 注入匹配模板 元数据(不嵌入二进制) | ||
| 配额 | 计入工作区存储配额(§4.5,后续强化) | ||
| 压缩包 | manifest.json(kind=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-25 | Phase 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 | 办公样式:成员上传/发布演示·文档·表格样式;对话选用时复制为新附件 |