Skill v1.0.0

currentLLM-judged scan90/100

linearl/reasonix_skill_repo/onenote-to-obsidian

──Details

PublishedOctober 3, 2026 at 09:02 PM

Content Hashsha256:33a61ae1fd747407...

Git SHA

──Files

Files (1 file, 11.5 KB)

SKILL.md11.5 KBactive

SKILL.md · 151 lines · 11.5 KB

version: "1.0.0" name: onenote-to-obsidian description: 把 OneNote 分区文件（.one）解析为 Markdown 并导入 Obsidian。当用户需要从 OneNote 导出笔记、把 .one 转 md、OneNote 同步失败需要本地恢复、或导入 OneNote 分区到 vault 时使用。不依赖 OneNote 同步/云端，直接解析本地 .one 文件（经 OneNote COM API）。

OneNote .one 文件 → Obsidian Markdown 导入

把 OneNote 分区文件（.one，本地导出或缓存副本）解析为 Markdown，按季度/分区组织导入 Obsidian vault。不依赖 OneNote 同步状态——适合同步失败、分区被服务器删除、importer 漏导等场景的本地恢复。

核心原理

用 OneNote 桌面版 COM API（OneNote.Application，PowerShell 调用）打开本地 .one 文件：
OpenHierarchy(path, '', [ref]hier, 0) —— 第 4 参数必须 0（cftLocal），其他值报 0x80042018
GetHierarchy(hier, 1, [ref]xml) —— scope 必须 1（hsChildren），3 会返回 0 页面，2 报 0x80042014
逐页 GetPageContent(pageId, [ref]xml, 1) —— 第 3 参数必须 1（piBinaryData）才有 `<one:Data>` base64 图片；0（piBasic）只有 <one:Image> 空壳（图片在 .one 文件块里但拿不到）。2026-08-12 实战确认：所有"页面有 Image 但 0 Data"的谜团都是这个参数用错——8-7 管线成功提取 1527 张图就是用了 -PageInfo 1
PowerShell 逐页导出为 XML 文件 + index.tsv，Python 解析 XML → Markdown（剥 span 富文本、checkbox 还原、嵌套缩进）

前置条件（本机已具备）

OneNote 桌面版（C:\Program Files\Microsoft Office\root\Office16\ONENOTE.EXE）
PowerShell 5.1+（Windows 自带）
Python 3（标准库即可）

常见故障：导出 .one 不完整（页面缺失）

现象：导出的 .one 文件页面数远少于客户端显示的页面数（如 759MB 文件只有 11 页；同步报错的分区导出后缺大量周报）。

根因（实战确认）：未同步（0xE0000063/0xE000006A）的页面在迁移/导出流程中被跳过——剪贴分区时同步失败的页面不会迁移成功，导出 .one 时这些页面连页面条目都不会写入文件（不只是内容缺失）。客户端能看到（缓存）≠ 文件里有。

解决：

先修复同步：OneNote 中右键分区 → 立即同步，等报错消失（或把内容剪贴到同步健康的新分区，待新分区完全同步）
重新导出 .one 后再解析——同步修复后重新导出的文件才是完整的（实战：19-20.one 28 页 → 重新导出 169 页；21~23Q1.one 1 页 → 305 页）
判断导出是否完整：GetHierarchy 页面数 ≈ 客户端显示的页面数；或抽查报错列表中的页面名是否出现在页面列表里

教训：文件大小与内容完整性无关（759MB 空壳 vs 72MB 完整）；"客户端能看到"不能证明导出文件完整。

常见故障：在线分区图片未下载（页面有 Image 但 Data 全空 / 页面索引缺失）

现象：分区能打开、页面名能列出，但逐页 GetPageContent(..., 1) 的 XML 里 <one:Image> 没有 <one:Data>（或页面数远少于客户端——areAllPagesAvailable="false"）。8-12 实测：OneDrive 在线笔记本（https://d.docs.live.net/...）的分区按需下载，从未在本地打开过的分区只有元数据，图片内容在云端。

根因：在线笔记本分区未在本地缓存，图片数据未下载。

解决（有效路径，按优先级）：

OneNote UI：文件 → 选项 → 同步 → 同步所有文件和图像，勾选"下载全部文件和图像" → 确定；再手动打开目标分区/页面（触发下载），等图片正常显示、同步图标消失
COM 直读（已下载后）：按 Section ID GetHierarchy + GetPageContent(..., 1) 直接读取在线分区，无需导出 .one（实测：用户勾选设置+手动打开后，COM 直读全部拿到 Data）
导出 .one 兜底：文件 → 导出 → 分区 → OneNote 格式

无效方式（实测）：SyncHierarchy(分区ID)（单参版本调用成功但 3 分钟无下载）、NavigateTo(分区ID)（UI 跳转但 3 分钟无下载）——COM API 无法强制下载云端内容。

注意：导出/读取只包含已加载过的页面内容——没打开过的页面图片仍会缺（实测 TI开发.one 137MB：打开过的页面有图，未打开页面 Image=0）。打开页面后如果图片本身是坏链（其他设备编辑未完整同步，页面里 1 好 1 坏两张图），则该图无法找回——源数据损坏，非流程问题。

常见故障：大 .one 打开后 GetHierarchy 返回 0 页/部分页（异步加载）

现象：OpenHierarchy 成功，但立即 GetHierarchy 页面数 = 0 或远少于实际（如 687MB 文件 0 页、305 页只出 30 页），XML 里 areAllPagesAvailable="false"。

根因：OneNote 打开大 .one 后页面索引异步加载，立即查询拿到的是未完成状态。

解决：轮询等待——循环 GetHierarchy + Start-Sleep -Seconds 3~5，直到 XML 中不再出现 areAllPagesAvailable="false"（30~60 秒），再取页面列表。

常见故障：COM 报"库没有注册"（0x8002801D）

现象：New-Object -ComObject OneNote.Application 成功，但任何方法调用报 -2147319779 库没有注册；或 pywin32 报 AttributeError: OneNote.Application.OpenHierarchy。

原因：OneNote 的类型库注册损坏/缺失（Office 安装残留）——GetIDsOfNames 内部按 LoadRegTypeLib 找类型库失败。

修复（需要管理员 PowerShell 运行一次）：

powershell

# 15.0 类型库（真实版本 1.1，资源 3）
$base = 'HKLM:\SOFTWARE\Classes\TypeLib\{0EA692EE-BB50-4E3C-AEF0-356D91732725}\1.1'
New-Item -Path $base -Force | Out-Null
Set-ItemProperty -Path $base -Name '(default)' -Value 'Microsoft OneNote 15.0 Type Library'
New-Item -Path ($base + '\0\Win64') -Force | Out-Null
Set-ItemProperty -Path ($base + '\0\Win64') -Name '(default)' -Value 'C:\Program Files\Microsoft Office\Root\Office16\ONENOTE.EXE\3'
New-Item -Path ($base + '\0\Win32') -Force | Out-Null
Set-ItemProperty -Path ($base + '\0\Win32') -Name '(default)' -Value 'C:\Program Files\Microsoft Office\Root\Office16\ONENOTE.EXE\3'
# 12.0 类型库（兼容接口，资源 2）
$base = 'HKLM:\SOFTWARE\Classes\TypeLib\{F2A7EE29-8BF6-4A6D-83F1-098E366C709C}\1.0'
New-Item -Path $base -Force | Out-Null
Set-ItemProperty -Path $base -Name '(default)' -Value 'Microsoft OneNote 12.0 Type Library'
New-Item -Path ($base + '\0\Win64') -Force | Out-Null
Set-ItemProperty -Path ($base + '\0\Win64') -Name '(default)' -Value 'C:\Program Files\Microsoft Office\Root\Office16\ONENOTE.EXE\2'
New-Item -Path ($base + '\0\Win32') -Force | Out-Null
Set-ItemProperty -Path ($base + '\0\Win32') -Name '(default)' -Value 'C:\Program Files\Microsoft Office\Root\Office16\ONENOTE.EXE\2'
New-Item -Path ($base + '\Flags') -Force | Out-Null
Set-ItemProperty -Path ($base + '\Flags') -Name '(default)' -Value '0'
New-Item -Path ($base + '\HelpDir') -Force | Out-Null

执行后杀 OneNote 进程（taskkill /IM ONENOTE.EXE /F）再重试。

验证：PowerShell New-Object -ComObject OneNote.Application 后能调 OpenHierarchy（报参数错误也算通——比"库没有注册"好）。

执行流程

Step 1 确认输入

.one 文件路径（用户提供或从 %LOCALAPPDATA%\Microsoft\OneNote 缓存找）
文件头是 GUID（非 \x00\x01）即为新版 OneStore 格式，COM 可读
在线笔记本分区：先按上文"在线分区图片未下载"处理（勾选下载全部文件和图像 → 打开页面 → COM 直读或导出 .one），否则读到的文件缺图

Step 2 导出（PowerShell）

bash

powershell -ExecutionPolicy Bypass -File "<技能目录>/scripts/onenote_export.ps1" -OnePath "<文件.one>" -OutDir "<导出目录>" -PageInfo 1

要图片必须 `-PageInfo 1`（含 <one:Data> base64；默认 0 只有 Image 空壳，8-12 踩坑确认）
产出：<OutDir>/pages/NNNN.xml + <OutDir>/index.tsv（序号、页面ID、页面名）
303 页约 5-10 分钟（PageInfo 1 慢约 2 倍）；进度每 25 页打印一次
注意：脚本文件必须是 UTF-8 with BOM（PowerShell 5.1 无 BOM 按 GBK 解码，中文路径会乱码报 0x80042006）；脚本内不要用 `$pid` 变量（PowerShell 保留变量）
如果 OneNote 实例还开着旧文件，先 taskkill /IM ONENOTE.EXE /F（单实例会锁文件，报 0x80042006）
大文件打开后先轮询等待 areAllPagesAvailable="false" 消失（见上文异步加载），再取页面列表

Step 3 转 Markdown（Python）