Notion Accounting Analysis

Notion 记账数据分析 Skill

适用场景：用户说"分析我的 Notion 记账数据"、"生成财务报告"、"查看收支趋势"时触发。 前置条件：用户提供 Notion Integration Token（secret_xxx 格式）和 data_source_id。

核心能力

1. 全量数据获取 — 自动翻页（处理 Notion API has_more），不漏任何记录
2. relation 字段 100% 解析 — 先收集所有 relation ID，再批量并发查询对应名称，零遗漏
3. 多维分析 — 按年/月/类别/标签/大额 TOP 多角度剖析
4. 智能报告生成 — 自动输出 Markdown 报告到 /workspace/，带优化建议
5. 异常主动提示 — 若 relation ID 无法解析，会列出 ID 并提示如何修复

已知 relation ID → 类别名称（已验证）

💡 若发现新的 relation ID 查不到名称：在 Notion 中打开该记录页面 → 右上角 ... → Add connections → 添加 Integration 即可。

字段识别规范（重要踩坑记录）

支出流水表通常有两个分类字段，优先级：

错误：只用 select，忽略 relation → 类别大量丢失。 正确：relation 用 ID 查表，select 直接用，两者结合覆盖 100% 类别。

执行流程

第 1 步：确认数据源

用户未提供 data_source_id 时，用搜索接口查找：

curl -s -X POST "https://api.notion.com/v1/search" \
  -H "Authorization: Bearer $NOTION_API_TOKEN" \
  -H "Notion-Version: 2025-09-03" \
  -d '{"query": "支出", "page_size": 20}' \
  | jq '.results[] | {id, title: .properties.Name.title[0].plain_text}'

第 2 步：全量获取数据（必须翻页）

// 错误：只查第一页 → 数据不完整
const page = await fetch('/v1/data_sources/{id}/query', {page_size: 100});

// 正确：循环直到 has_more = false
let cursor = null;
do {
  const body = cursor ? {page_size:100, start_cursor:cursor} : {page_size:100};
  const page = await fetch('/v1/data_sources/{id}/query', body);
  results.push(...page.results);
  cursor = page.has_more ? page.next_cursor : null;
} while (cursor);

第 3 步：relation ID 批量解析（必须）

// 第一步：收集所有 relation IDs（不重复）
const allIds = [...new Set(results.flatMap(r =>
  (r.properties['支出类别']?.relation || []).map(rel => rel.id)
))];

// 第二步：并发查询所有 ID（每个只查一次）
const relMap = Object.fromEntries(
  await Promise.all(allIds.map(async id => [id, await resolvePageName(id)]))
);

第 4 步：分析并输出报告

# 可直接使用附带的分析脚本
node analyze.mjs <token> <expense_data_source_id> [income_data_source_id] [year]

常见错误处理

分析报告模板

# {年份} 年度财务分析报告

> 数据来源：Notion 支出流水表 & 收入流水表
> 分析范围：{年}年（{n}笔支出，{n}笔收入）

## 一、收支总览
## 二、月度趋势
## 三、类别分析（relation 100% 解析）
## 四、标签分析
## 五、TOP N 大额支出
## 六、优化建议