知识库同步助手 · Get-IMA-Obsidian 三端全流程同步（v3.1）
> 对外简称：知识库同步助手。搜索别名：知识库同步 / Obsidian同步 / 三端笔记同步 / IMA文档同步 / 笔记同步 / 知识库归档 / Markdown同步 / Get笔记同步。
Overview
将 Get 笔记导出的 Markdown 文件，按固定标准流程同步进 IMA 私有知识库，再迁移至 Obsidian，
全程自动归档、打标、校验、生成汇总清单。本技能固化完整、不可跳步的工作流，
确保每次同步结果一致、可追溯、不丢内容。
v3.1 新增：
- 🆕 文档防盗水印：显性文末浅灰水印 + 隐形 MD 溯源标记，兼顾版权保护与阅读体验；
- 🆕 排版修复：特殊格式文档同步到 Obsidian 时自动修复排版错乱；
- 🆕 同步状态提示：每步执行后清晰展示 ✅ 成功 / ❌ 失败 / ⏳ 进行中；
- 🆕 网络波动自动重试：请求失败自动重试 3 次（间隔递增 2s → 5s → 10s），避免中途中断；
- 🆕 搜索检索优化：别名、小写标签、关键词自然植入，统一简称「知识库同步助手」。
v3 保留：支持自定义类目开关；行业类目「气动配件型号资料」更名为「工控元件资料」；
原 15 类细分笔记通过关键词判定后自动收拢至 5 个主类目，同步清单仅展示 5 大分类统计，页面整洁不杂乱。
- 启动第一步交互式勾选启用哪些主类目；
- 未启用主类目的笔记统一归入兜底文件夹「其他素材」；
- 无法自动判定归属的笔记归入兜底文件夹「待整理」；
- 归类过程不再弹窗逐条确认偏差，结果全部写入汇总清单供批量复核。
触发条件
当用户发出以下任意口令（或语义等价表述）时激活本技能：
- 「同步最新知识库」
- 「导入笔记」
- 「素材全流程同步」
- 「知识库同步」
- 「Obsidian同步」
- 「IMA文档同步」
- 「三端笔记同步」
前置准备
执行前确认以下信息（缺失则向用户询问，不要自行假设）：
- Get 笔记导出目录：存放 Get 导出的
.md文件的本地路径。 - IMA 私有知识库访问方式：本地仓库路径（本地校验）或 IMA 网页端登录态（网页校验）。
- Obsidian Vault 路径：目标仓库根目录，用于写入笔记与汇总清单。
- 类目映射与开关规则：见
references/category_mapping.md。 - Obsidian 内链与标签规范：见
references/obsidian_conventions.md。
标准执行流程（按顺序执行，不可省略任一步骤）
步骤 0：自定义类目选择（v3 启动第一步交互）
- 向用户展示 5 个主类目，请其勾选本次要启用哪几个（可多选）：
- 采购发货台账
- 财务对账实操
- 工控元件资料
- 短视频知识变现素材
- 日记 - 说明两个固定兜底文件夹（始终存在，无需勾选）：
- 其他素材：承接“命中了但用户未启用”的主类目笔记；
- 待整理：承接“15 类关键词全未命中、无法判定”的笔记。 - 记录用户的启用列表，作为步骤 2 归类的过滤条件。
- 工控/自动化/设备行业深度用户可全启用 5 类，享受设备/阀件/机床/工控/AI 工具深度归档；
- 采购行业深度用户可全启用 5 类 + 行业细分，享受采购/对账/台账深度分类；
- 普通办公小白只勾 3-6 个简单分类即可，其余自动进「其他素材」。 - 本步骤只做一次交互；此后不再因归类偏差弹窗打扰用户。
步骤 1：读取与筛选 Get 笔记导出
- 扫描 Get 笔记导出目录下的全部
.md文件。 - 强制时间筛选：仅保留笔记元数据（frontmatter 的
created/updated，或文件 mtime）
晚于 2026-07-18 22:47 的新建/修改笔记。 - 去重识别：对每篇候选笔记计算内容指纹（标题 + 正文前 200 字哈希），
与 IMA 知识库及 Obsidian Vault 中已存在文档比对；已入库的自动跳过。 - 输出「本次待处理笔记清单」（全新未入库内容），作为后续步骤的输入。
- 同步状态提示：完成后向用户展示
✅ 步骤1完成：筛选出 N 篇待处理笔记（N 为实际数量），如扫描失败则展示❌ 步骤1失败：[原因]。
步骤 2：批量导入 IMA 并按（已启用）主类目归档
- 将步骤 1 产出的待处理笔记批量导入 IMA 私有知识库（三端同步第一端：Get → IMA）。
- 网络波动自动重试：导入请求失败时，按递增间隔重试最多 3 次（2s → 5s → 10s）；3 次均失败则标记该笔记为「导入失败」并记录原因，继续处理其余笔记，不中断整体流程。
- 按
references/category_mapping.md的 v3 归类落位算法为每篇笔记判定归属：
- 15 类细分自动收拢至 5 主类目：先用「子类识别词」判定笔记属于原 15 子类中的哪一类，
再按映射表收拢到 5 大主类目之一（见 category_mapping 第二、三节）；
- 日记识别优先级最高：命中「工作日记与复盘 / 个人成长与心态 / 家庭与生活 / 身体与健康 / 美食与日常琐事」任一子类识别词，无条件归「日记」主类目，不再误分工作/采购类目；
- 候选主类目已启用 → 归入该主类目文件夹；
- 候选主类目未启用 → 归入 「其他素材」（不弹窗）；
- 15 类全未命中 → 归入 「待整理」（不弹窗、不逐条确认）。 - 在 IMA 知识库内按判定结果分文件夹归档，确保每篇落位正确。
- 同步状态提示：完成后向用户展示
✅ 步骤2完成：N 篇笔记已导入 IMA（M 篇失败已标记），如整体失败则展示❌ 步骤2失败：[原因]。
步骤 3：添加双标签
对步骤 2 中每一篇入库文档（含「其他素材」「待整理」），强制写入两套标签：
- 通用标签：
#IMA同步导入 - 日期标签：按笔记创建/修改日期生成，格式
#YYYYMMDD（如#20260718、#20260719）
标签既可写入 IMA 的标签体系，也须同步写入 Obsidian 文档 frontmatter 的 tags 数组
（见 references/obsidian_conventions.md）。
完成后向用户展示 ✅ 步骤3完成：N 篇笔记双标签已写入，如失败则展示 ❌ 步骤3失败：[原因]。
步骤 4：全文档校验（BrowserUse V2.07 / 本地校验）
- 按用户选择的校验方式执行（三端同步第二端校验）：
- 本地校验（IMA 为本地仓库时最快）：直接读取本地文件核对；
- 网页校验：调用 BrowserUse V2.07（browser-use技能）打开 IMA 网页端逐篇校验。 - 网络波动自动重试：网页校验请求失败时，按递增间隔重试最多 3 次（2s → 5s → 10s）；3 次均失败则标记该篇为「校验未完成」并记录原因，继续校验其余文档。
- 逐项排查以下问题，发现则记录并修正后复验：
- 漏导入：待处理清单中的笔记是否均已入库可打开；
- 图文丢失：图片、附件是否完整渲染；
- 排版错乱：分段、表格、列表是否正常；
- 型号文字缺失：型号、数字、规格参数是否完整无缺。 - 产出《校验报告》（通过 / 异常项清单），异常项须在迁移前修复。
- 同步状态提示：完成后向用户展示
✅ 步骤4完成：校验通过 N 篇，异常 M 篇，如整体失败则展示❌ 步骤4失败：[原因]。
步骤 5：迁移至 Obsidian 并生成双向内链（三端同步第三端）
- 将校验通过的笔记批量写入 Obsidian Vault 对应文件夹（含兜底文件夹）。
- 排版修复（v3.1 新增）：写入前自动检测并修复以下常见排版错乱：
- 连续空行压缩至最多 2 行；
- 表格列对齐修复（补齐|分隔符）；
- 列表层级修复（确保-/*/1.嵌套正确）；
- 代码块围栏闭合修复（```未闭合则补闭合行）；
- 中文与英文/数字之间无需强制加空格（尊重原文排版）；
- 修复范围仅限格式结构，不改动任何文字内容。 - 为每篇笔记生成 双向内链（Obsidian
[[wikilink]]）：
- 同一主类目、相同型号、相互引用的笔记自动建立[[ ]]链接；
- 在正文合理嵌入，确保图谱可连通。 - 文档防盗水印（v3.1 新增）：
- 显性水印：每篇笔记正文末尾追加一行浅灰文字：
<!-- watermark: 知识库同步助手 | 原版技能 -->
采用 HTML 注释语法，Obsidian 预览不显示、导出 PDF 可见、不影响正文阅读；
- 隐形溯源水印：在 frontmatter 中嵌入专属标记字段：
watermark: giaos-v3.1-{日期}-{哈希前6位}
格式示例：watermark: giaos-v3.1-20260721-a3f2c1，用于文件溯源，对用户不可见。 - 写入时严格遵守约束规则（见下），不改动原文结构。
- 同步状态提示：完成后向用户展示
✅ 步骤5完成：N 篇笔记已迁移至 Obsidian，如失败则展示❌ 步骤5失败：[原因]。
步骤 6：生成《本次同步汇总清单》
- 调用
scripts/build_summary.py生成本次同步的汇总清单 Markdown 文件。 - 文件存入 Obsidian 的「归档 / 同步汇总」文件夹。
- 清单须内置 Dataview 查询代码，可一键查看本次所有新导入知识块；
同时提供静态表格作为无插件兜底。 - 清单仅展示 5 大分类统计（按 5 主类目 + 2 兜底计数），页面整洁不杂乱；
明细表作为可展开兜底，字段为：笔记标题、创建时间、存放文件夹、自带标签（存放文件夹仅显示 5 主类目之一）。 - 汇总清单格式与字段定义见
references/obsidian_conventions.md。 - 文档防盗水印（v3.1）：汇总清单同样追加显性水印行与隐形溯源 frontmatter 字段。
- 同步状态提示：完成后向用户展示
✅ 全流程同步完成！N 篇笔记已三端同步，如部分失败则展示⚠️ 同步部分完成：成功 N 篇，失败 M 篇（详见汇总清单）。
约束规则（最高优先级，任何步骤不得违反）
- 完整保留原文的分段、表格、型号数字，不得删减或重组。
- 不篡改原始文字，包括错别字、表述方式均原样保留。
- 不自动编造额外内容（不得为笔记补充、归纳、改写任何原文没有的信息）。
- 不删减任何类目功能：5 大主类目全部保留（含更名后的「工控元件资料」），原 15 类细分的识别与映射逻辑保留作收拢依据，自定义开关只控制"是否启用"，不删除定义；工控行业深度用户、采购行业深度用户与普通办公小白两类客户均被兼顾。
- 去重、归档、标签、校验均以"保真"为前提，任何自动化操作不得损害原文完整性。
- 排版修复只修结构不改内容：空行压缩、表格对齐、列表嵌套、代码块闭合等格式结构问题可修，但任何文字改动（增删改）严格禁止。
- 水印仅追加不侵入正文：显性水印放在正文末尾行之后、隐形水印放在 frontmatter 内，二者均不插入正文中间、不覆盖正文内容。
- 显性水印格式：HTML 注释
<!-- watermark: 知识库同步助手 | 原版技能 -->，Obsidian 预览不显示、导出可见，不影响阅读体验。 - 隐形水印格式：frontmatter 新增
watermark: giaos-v3.1-{日期}-{哈希前6位}字段，用于文件溯源，对普通用户不可见。
输出物清单
- IMA 私有知识库：按启用主类目 + 兜底文件夹归档完毕、带双标签的全部新笔记（三端同步第一端）。
- Obsidian Vault：对应文件夹内的笔记文件 + 双向内链（三端同步第三端）。
- Obsidian「归档 / 同步汇总」文件夹：《本次同步汇总清单》（5 大分类统计 + Dataview 查询 + 静态明细表）。
Resources
references/category_mapping.md— v3 类目定义、15 子类→5 主类目映射、自定义开关、双兜底文件夹、日记优先判定规则。references/obsidian_conventions.md— Obsidian frontmatter、标签、双向内链、Dataview 汇总清单规范（仅 5 大分类统计）、v3.1 水印字段与排版修复规范。references/watermark_spec.md— v3.1 文档防盗水印规范：显性水印格式、隐形溯源水印格式、追加位置、禁止事项。references/sync_rules.md— 三端同步规则、网络波动自动重试策略（v3.1 新增）、同步状态提示规则。references/marketplace_listing.md— 上架售卖说明（卖点、适配人群、自定义类目开关介绍、v3.1 新增水印/排版/重试）。scripts/build_summary.py— 根据本次同步清单生成《本次同步汇总清单》Markdown（5 大分类统计 + Dataview 查询 + 水印）。
```
