getnote-obsidian-sync

name: getnote-obsidian-sync description: Use when the user wants to sync Get笔记 notes to a local Obsidian vault folder. Triggers on "同步Get笔记", "同步笔记到Obsidian", "把Get笔记同步到本地", "sync getnote to obsidian", or any request to download/export Get笔记 notes as local markdown files.

Get笔记 → Obsidian 同步

将 Get笔记 中的笔记同步为 Obsidian 兼容的 .md 文件，支持增量同步。

凭证

从环境变量读取（用户已在 .zshrc 中配置）：

• $GETNOTE_API_KEY（格式 gk_live_xxx）
• $GETNOTE_CLIENT_ID（格式 cli_xxx）

如果环境变量缺失，引导用户前往 https://www.biji.com/openapi 获取并添加到 .zshrc。

API 调用

Base URL: https://openapi.biji.com

请求头：

• Authorization: $GETNOTE_API_KEY
• X-Client-ID: $GETNOTE_CLIENT_ID

列表接口

GET /open/api/v1/resource/note/list?since_id={cursor}

返回 data.notes[]、data.has_more、data.next_cursor，每页 20 条。从 since_id=0 开始翻页。

详情接口

GET /open/api/v1/resource/note/detail?id={note_id}

默认不调用 detail 接口，因为 API 有每日 1000 次读取限制，列表接口已包含 title/content/tags 等核心字段。

仅在用户明确要求时调用 detail：

• link → data.web_page.content、data.web_page.url
• 音频类（audio、meeting、local_audio、internal_record、class_audio、recorder_audio、recorder_flash_audio）→ data.audio.original（转写全文）

录音全文补充

对已同步的个人录音和会议录音，可按需调用 detail 接口补充转写全文：

1. 扫描 个人录音/ 和 会议录音/ 下的 .md 文件
2. 检查文件中是否已包含 ## 转写原文 段落，已有则跳过
3. 从 frontmatter 取 getnote_id，调用 detail 接口获取 data.audio.original
4. 追加 ## 转写原文 段落到文件末尾
5. 每次调用间隔 1 秒，注意每日 1000 次配额（当前约 137 条录音，单次全量补充即可）

同步流程

1. 读取凭证 — 从环境变量 $GETNOTE_API_KEY 和 $GETNOTE_CLIENT_ID 读取
2. 确定输出目录 — 优先使用环境变量 $GETNOTE_SYNC_DIR；若未设置，则要求用户传入目标文件夹路径，不使用默认值
3. 构建已同步 ID 集合 — 递归扫描输出目录下所有 .md 文件，从 frontmatter 中提取 getnote_id，构建 set。文件可能已被用户移动到子文件夹，所以必须递归扫描
4. 遍历笔记列表 — since_id=0 起始，逐页获取（API 按时间倒序返回）
5. 增量检查 — API 返回的 note.id 在已同步集合中则跳过。若某页 20 条全部已存在，说明更早的笔记也已同步，立即停止翻页（省 API 配额）
6. 写入 .md 文件 — 文件名格式 {YYYY-MM-DD}_{title}.md，格式见下。新笔记默认写入 收藏/ 子目录（用户后续手动分类）
7. 文件名清理 — 移除 /\:*?"<>| 及控制字符，多余空格合并，标题截断 80 字符，重名追加 note_id
8. 翻页 — has_more=true 则用 next_cursor 继续
9. 打印统计 — 新增 N 条，跳过 M 条

注意：每次 API 调用间隔至少 1 秒。遇到错误码 42900（限流）sleep 10 秒重试一次。遇到 10201（非会员）提示用户开通。

.md 文件格式

Frontmatter

---
id: "123456789"              # 必须用引号包裹，避免大整数精度丢失
title: "笔记标题"
note_type: plain_text
tags:
  - 标签1
  - 标签2
source_url: "https://..."        # link 类型才有
created_at: "2025-01-15 10:30:00"
updated_at: "2025-01-15 11:00:00"
synced_at: "2026-03-15 22:00:00"
---

Body（按 note_type）

标签从 note.tags[].tag 取值。title 中的双引号需转义。

实现方式

用 Bash 工具执行 curl 调用 API，用 Write 工具写入 .md 文件。不要生成独立脚本，直接在对话中逐步执行。

对于大量笔记（>50 条），可以用 Bash 工具批量执行 curl + Python 提取数据，然后用 Write 逐个写入文件。

⚠️ 大整数精度：笔记 ID 是 64 位整数，超过 JavaScript 的 Number.MAX_SAFE_INTEGER（2^53）。禁止使用 jq 处理 ID 字段（jq 用浮点数表示数字会丢失精度）。必须用 Python 的 json.loads（Python int 无精度限制）或从原始 JSON 字符串中用正则提取 ID。

整理流程

用户可请求对已同步的笔记进行整理归类。整理分两步：

第一步：按 note_type 分文件夹

从 frontmatter 的 note_type 字段读取类型，移入对应子目录：

第二步：链接收藏按主题细分

对 链接收藏/ 下的文件，基于 frontmatter 的 tags 和 title 进行关键词模糊匹配（大小写不敏感），归入主题子目录：

匹配规则：按上表顺序逐一检查，命中第一个即归类。忽略自动标签 AI链接笔记 和 录音笔记。

注意事项

• 跳过 _ 开头的元数据文件（如 _cursor.json、_stats.md）
• 用 Python 批量处理，不逐个调用 Write 工具
• 整理前先统计各分类数量，确认后再执行移动

错误处理