填写模板part-02-knowledge-base/templates/kb_metadata_schema.md

知识库 frontmatter + metadata 字段表

文件路径:/Users/apple/Documents/4.0 Sanyuan/2.4 环境公益"新"力量/course/part-02-knowledge-base/templates/kb_metadata_schema.md

用途:把散乱资料整理成 LLM-wiki 条目。frontmatter 放在 Markdown 最前面,metadata 是知识库平台可用于筛选和引用的字段。两者字段尽量保持一致。

1. 标准条目结构

---
doc_title: 2024 清河巡护项目结项报告
doc_type: 结项报告
project_name: 清河巡护项目
year: 2024
module: M1 文书
topic_tags:
  - 河流保护
  - 志愿者管理
funder: XX 基金会
privacy_level: L2
audience_scope: 内部同事可问
retrieval_hint: 事实查找
source_owner: 项目部
last_reviewed_at: 2026-06-10
source_path: 云盘/项目档案/2024清河
canonical_questions:
  - 2024 清河项目开展了多少次巡护?
  - 2024 清河项目有哪些主要成效?
summary: 记录 2024 年清河巡护项目的活动、产出、成效和反思。
---

# 正文标题

## 背景

## 关键事实

## 可引用材料

## 注意事项

2. 推荐字段

字段是否必填示例用途
doc_title必填2024 清河巡护项目结项报告让 AI 能引用来源
doc_type必填结项报告 / 资助指南 / 案例复盘 / 沟通模板区分资料类型
project_name条件必填清河巡护项目项目类资料必须填
year条件必填2024支持按年份检索
module必填M1 文书 / M2 案例 / M3 传播对齐课程主场景
topic_tags必填河流保护、社区动员、志愿者支持语义检索和筛选
funder可选XX 基金会文书和资助类资料推荐填
privacy_level必填L1 / L2 / L3 / L4决定是否能进入组织层知识库
audience_scope必填内部同事可问 / 公开用户可问 / 仅维护人可看控制回答边界
retrieval_hint必填事实查找 / 案例匹配 / 条款引用 / 综合判断帮助后续设计测试题和检索策略
canonical_questions必填这份资料应该能回答的 2–5 个问题用于命中率测试
summary必填1–2 句话概括资料价值帮助模型快速判断相关性
source_path推荐云盘/项目档案/2024清河方便人工回查原件
source_owner推荐项目部 / 传播部后续维护时找负责人
last_reviewed_at推荐2026-06-10确认资料是否过期

3. 三类资料的最小 frontmatter

M1 项目文书链

---
doc_title:
doc_type:
project_name:
year:
funder:
module: M1 文书
topic_tags:
privacy_level:
audience_scope:
retrieval_hint: 事实查找
canonical_questions:
summary:
---

M2 案例与知识沉淀

---
doc_title:
doc_type: 案例复盘 / 服务故事 / 方法总结
project_name:
year:
module: M2 案例
topic_tags:
privacy_level:
audience_scope:
retrieval_hint: 案例匹配
canonical_questions:
summary:
---

M3 传播与运营

---
doc_title:
doc_type: 公众号稿 / 活动复盘 / 社群 FAQ / 品牌话术
year:
module: M3 传播
topic_tags:
privacy_level:
audience_scope:
retrieval_hint: 条款引用 / 综合判断
canonical_questions:
summary:
---

4. 清洗质量自检

检查项通过标准
frontmatter 是否完整至少有标题、类型、密级、标签、检索提示、可回答问题
标签是否太泛不只写“项目”“资料”,而是写“河流保护”“社区动员”等可检索词
年份是否缺失涉及项目、活动、报告的资料尽量填年份
文档类型是否稳定同类文档使用同一个词,如统一写“结项报告”
合规档位是否明确没有档位的资料不得进入 Agent平台
正文是否可引用保留事实、数据、来源和限制,不只留下泛泛摘要