Maple 结构化知识归档

要解决的问题

工程师常把周报、会议纪要、故障复盘等文本直接丢进文件夹，随后只能靠关键词搜索和记忆恢复上下文。文档本身没有主题层级，代码、决策背景、资源文件混在一起，时间久了就变成不可维护的文本堆积。

技能如何工作

maple-structured-storage 将非结构化文档归档为标准化主题目录：先分析文本，归纳 2-8 字主题，再创建主题文件夹并按 description.md、process.md、meta.md、code.md 分层写入，同时复制资源文件。完成后会全量刷新 index.json，并触发反思补问，最多提出 3 个带原文片段的问题，帮助补齐人物、时间、原因、关联系统和决策背景等盲区。检索时优先读取 index.json 的 keyWord 与 description，再按需求打开完整上下文、事实信息或代码文件。

适用边界

适合整理已有 .txt / .md 文档、周报、复盘和技术笔记，不适合作为实时协作知识图谱。它强调不丢失信息、代码完整保留和追加式更新，因此更偏归档与复盘，而非自动分类或自动摘要。首次使用前需确认 source_path 与 storage_path 配置，且索引是全量覆盖生成。