Notion记账财务分析

Notion记账财务数据分析技能，自动读取支出收入流水表，全量翻页获取数据，100%解析relation类别字段，按年月类别标签多维分析并生成Markdown财务报告。

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（前8位）	对应类别
2e1bd123...817c	房租
2e1bd123...80e8	旅游娱乐
2e1bd123...8081	房贷
2e1bd123...815a	餐饮
2e1bd123...8004	总记账
2e1bd123...806f	医疗
2e1bd123...8059	购物
2e1bd123...80d4	所得税
2e1bd123...817f	交通
2e1bd123...81dd	人情往来
2e1bd123...8084	专项
2e1bd123...810d	运动
2e1bd123...8054	公司额外
2e1bd123...81de	日用

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

---

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

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

字段	类型	处理方式
支出类别	relation	通过 API 查询名称，必须
标签	select	直接存储名称，可用

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

---

执行流程

第 1 步：确认数据源

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

bash

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 步：全量获取数据（必须翻页）

javascript

// 错误：只查第一页 → 数据不完整
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 批量解析（必须）

javascript

// 第一步：收集所有 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 步：分析并输出报告

bash

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

---

常见错误处理

现象	原因	解决方案
类别全是"未分类"	只用了 select，relation 全部丢失	改用 relation ID 查表
总支出比预期少	只查了第一页（100条），还有后续页	循环翻页直到 has_more=false
relation ID 查不到名称	记录不在 integration 可见范围内	Notion 页面 → Add connections
金额对不上	select 和 relation 重复计算了同一笔	select 和 relation 只取一个字段

---

分析报告模板

markdown

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

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

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