KAPE — 知识自动沉淀引擎 v0.1.7

安全说明

本 skill 需要以下工具权限：

• exec：调用 getnote CLI 获取笔记数据（只读操作）
• feishu_wiki、feishu_doc：写入飞书文档
• sessions_list、sessions_history：读取对话记录

不会执行任何本地文件写入之外的 shell 命令，所有外部 API 调用均为只读请求。

重要：禁止直接调用 https://openapi.biji.com/... HTTPS API（会返回 10004 未授权），必须使用 getnote CLI。

凭证配置

Get笔记 API 凭证存储在 openclaw.json 中：

{
  "skills": {
    "entries": {
      "getnote": {
        "apiKey": "<从配置文件读取，勿硬编码>",
        "env": {
          "GETNOTE_CLIENT_ID": "<从配置文件读取>"
        }
      }
    }
  }
}

飞书机器人需已加入知识库成员，否则 feishu_wiki(spaces) 返回空。

共享文件夹配置

飞书文档统一存放在共享文件夹「牛管家日志」，确保张公子有删除权限。

核心工作流

每天自动生成日志简报，三端同步归档。

第零步：Get笔记 授权检查与自动刷新

> ⚠️ 重要：Get笔记 CLI 维护独立于 openclaw.json 的登录状态，电脑重启后可能被重置（显示 Not authenticated）。本步骤自动检测并修复，无需用户手动操作。

操作流程：

1. 先执行 getnote auth status 检查当前认证状态
2. 若返回 Not authenticated：
• 从 ~/.openclaw/openclaw.json 读取 skills.entries.getnote.apiKey 和 skills.entries.getnote.env.GETNOTE_CLIENT_ID
• 执行 getnote auth login --api-key "" --client-id ""（API Key 直接传给 CLI，不记录到任何日志）
• 等待 Logged in successfully. 确认
3. 若已认证（Authenticated）：直接继续，不做任何操作

注意：API Key 从配置文件读取后直接作为命令行参数传给 getnote auth login，不写入任何日志文件或工作记忆，防止隐私泄露。

第一步：确定日期范围

• 目标日期：昨天
• 获取方式：

1. 使用 date 命令获取当前日期：date +%Y-%m-%d
2. 用 date 命令计算昨天的日期：date -v-1d +%Y-%m-%d
3. 用 date 命令验证星期：date -jf "%Y-%m-%d" "<目标日期>" +%A
• 输出要求：在生成简报前，先输出 目标日期：YYYY-MM-DD（周X），并用 date 命令确认
• 日期格式：YYYY-MM-DD（用于字符串前缀匹配）

第二步：获取数据（并行）

Get笔记读取

> ⚠️ 重要：Get笔记 API 必须通过 getnote CLI 调用，禁止直接调用 https://openapi.biji.com/...（会返回 10004 未授权）。

读取步骤：

1. 设置 CLI 路径（必须使用完整路径，因为 cron isolated session 的 PATH 不含 npm 全局 bin）：

```bash

GETNOTE_CLI="/Users/openclawer/.npm-global/lib/node_modules/@getnote/cli/bin/getnote"

```

1. 检查认证状态：

```bash

${GETNOTE_CLI} auth status

```

• 若返回 Not authenticated：从 ~/.openclaw/openclaw.json 读取 skills.entries.getnote.apiKey 和 skills.entries.getnote.env.GETNOTE_CLIENT_ID，然后执行 getnote auth login --api-key "" --client-id ""
• 若返回 Authenticated：直接继续

1. 读取笔记（使用 CLI，不要直接调 HTTPS API）：

```bash

# 读取最新笔记（自动分页），输出为 table 格式

${GETNOTE_CLI} notes --since-id 0 --limit 50

# 读取指定知识库的笔记

${GETNOTE_CLI} kb eYzMmvnm --limit 20

# 搜索笔记

${GETNOTE_CLI} search "<关键词>" --limit 10

```

1. 过滤目标日期：CLI 输出为 table 格式，用 grep 过滤 created 列包含目标日期的行：

```bash

${GETNOTE_CLI} notes --since-id 0 --limit 200 2>/dev/null | \

grep "^2026-05-13" | head -20

```

1. 获取单条笔记详情：

```bash

${GETNOTE_CLI} note --field content # 获取正文

${GETNOTE_CLI} note --field title # 获取标题

```

> ⚠️ API Key 凭证来源：从 ~/.openclaw/openclaw.json 的 skills.entries.getnote.apiKey 读取（不要硬编码）。API Key 从配置文件读取后直接作为命令行参数传给 CLI，不记录到任何日志。

Get笔记数据读取方式（必须使用 CLI）

> ⚠️ 重要：Get笔记 API 必须通过 getnote CLI 调用，不支持直接 HTTPS API 调用（直接调 https://openapi.biji.com/... 会返回 10004 未授权）。

读取方式 A（推荐）：用 CLI 的 --since-id 0 --all 拿到全部笔记，自动分页：

GETNOTE_CLI="${HOME}/.npm-global/lib/node_modules/@getnote/cli/bin/getnote"
${GETNOTE_CLI} notes --since-id 0 --all 2>/dev/null | grep -v "^ID\|^--\|^$" | awk -F'|' '{print $1,$2,$3,$4}' | while read id title type created; do
  # 过滤目标日期 created_at ~ target_date
done

读取方式 B（直接 API，备用）：如果 CLI 因 PATH 问题不可用，用 Python 读配置文件后通过 getnote CLI 保存：

# 不要直接调 openapi.biji.com（会10004未授权）
# 必须通过 getnote CLI
GETNOTE_CLI="${HOME}/.npm-global/lib/node_modules/@getnote/cli/bin/getnote"
${GETNOTE_CLI} notes --since-id 0 --limit 20  # 分页读取，每页20条，用 next_cursor 翻页

修复 getnote: command not found：如果执行报错 command not found，改用完整路径：

GETNOTE_CLI="/Users/openclawer/.npm-global/lib/node_modules/@getnote/cli/bin/getnote"

> ⚠️ PATH 问题说明：cron isolated session 的 PATH 不包含 ~/.npm-global/bin，使用 getnote 命令会报 command not found。必须使用完整路径或确保 PATH 包含 npm 全局 bin 目录。

对话记录获取

1. 用 sessions_list 获取所有 session（设置足够的 activeMinutes 覆盖目标日期）
2. 判断 session 在目标日期有活动的条件：updatedAt >= 目标日期开始时间 AND updatedAt < 今日开始时间
3. 用 sessions_history 读取符合条件的 session 内容（includeTools=false）
4. 解析用户消息（role: user）作为对话记录

词汇存档（若有）

• 容错读取：用 exec + cat 读取 workspace/vocabulary/{target_date}.md，若文件不存在或读取失败则跳过，不阻断流程
• 统计当日新增单词数量（如有）

> ⚠️ 路径处理规范：所有从 memory_search 或 sessions_list 等工具返回的路径，返回格式可能为 Markdown 链接（如 2026-04-05.md 包装，保留 text 部分作为文件路径）。

第三步：深度分析与整理

> ⚠️ 内容过滤规则（v0.1.6 新增，必须执行）

> 整理前需剔除【科技新闻日报】自动生成的内容，避免日志简报被机器人生成内容稀释：

> - 排除文件：memory/YYYY-MM-DD-tech-news.md（科技新闻日报生成的本地新闻文件）

> - 排除文档：飞书文档标题含「科技新闻日报」或「科技新闻热榜」的文档及其内容

> - 排除笔记：Get笔记标签或来源为「科技新闻日报」相关条目

> - 仅保留张公子个人学习、播客、录音、网页剪藏、手动笔记等主动获取内容

用户行为分析：

• 从 Get笔记的 tags、title、source 推断用户关注领域
• 从录音笔记数量和总时长推断学习深度
• 从内容关键词判断核心主题

张公子画像维度（供参考）：

生成日志简报结构（见 references/briefing-template.md）

> ⚠️ 强制完整输出规则（v0.1.7 新增）：无论输入数据多少，哪怕只有1条笔记，也必须生成完整模板的所有区块（主题关联图、数据概览、核心主题、每条笔记的详细分析、张公子关注什么、可以改进什么、明日关注、关键词、今日洞察）。简报不是摘要，是完整的结构化记录。当某日数据较少时，每个主题下的「分析/联想」部分可以简短，但不得省略整个区块。

生成主题关联图（v0.1.5 新增）：

根据当日笔记和对话记录，自动提取3-5个核心主题，标注主题间的关联关系，帮助快速定位知识节点。

关联类型标签：

• → 因果关系（A导致B）
• ⟶ 支撑关系（A证实/支持B）
• ⇄ 竞争关系（A与B竞争）
• ↙ 衍生关系（A衍生出B）

生成规则：

• 主题数量：3-5个为宜（太少则关联单薄，太多则失去焦点）
• 关系数量：每对主题间最多1条关系，优先标注最强关联
• 每条笔记/录音可归属1-2个主题
• 飞书文档中使用列表格式替代 ASCII 图形

第四步：写入本地文件

必须先确保目录存在：

mkdir -p /Users/openclawer/.openclaw/workspace/日志管理

文件路径：/Users/openclawer/.openclaw/workspace/日志管理/{target_date}-日志简报.md

第五步：三端同步归档

① Get笔记（必须写入完整简报全文，不得简写）：

POST https://openapi.biji.com/open/api/v1/resource/note/save
Headers:
  Authorization: {从配置文件读取}
  X-Client-ID: {从配置文件读取}
Body:
  title: "日志简报 {target_date} | {姓名}"
  content: 【必须写入完整简报全文】，包含所有章节、分析、统计数据，不得写入摘要或简短版本
  note_type: "plain_text"
  tags: ["AI整理", "日志简报"]

> ⚠️ 重要：Get笔记的 content 字段必须包含日志简报的完整正文（与写入本地文件和飞书文档的内容完全一致），不得以"详见链接"为由缩减内容。

② 飞书知识库（必须同步，否则简报缺失）：

> ⚠️ 节点层级结构（v0.1.10 修复）：

> - 个人知识库（space_id: 7621391289904516315）

> - 日志简报 节点（node_token: SERDwHBAniUqqBkx5vNctvgKn6f，obj_token: 对应文件夹下的日志简报）

> - 每日日志简报文档（创建在此节点下）

>

> 执行顺序：

> 1. 用 lark-cli wiki +node-create --space-id 7621391289904516315 --parent-node-token SERDwHBAniUqqBkx5vNctvgKn6f --title "日志简报 {target_date} | 张公子" 创建 wiki 节点

> 2. 获取返回的 obj_token（新文档的 doc token）

> 3. 用 lark-cli docs +update --api-version v2 --doc --command overwrite --doc-format xml --content @<本地简报xml路径> 写入内容

> 4. 用 lark-cli wiki +move --node-token <新节点token> --target-parent-token SERDwHBAniUqqBkx5vNctvgKn6f --source-space-id 7621391289904516315 --target-space-id 7621391289904516315 确保节点在正确位置（如创建到了错误位置）

> 5. 记录知识库 URL 到反馈消息

> ⚠️ 注意：飞书知识库操作需要机器人已加入知识库成员。如果 feishu_wiki(spaces) 返回空，说明权限不足。

③ 飞书文档（主归档通道）：

1. 先获取 tenant_access_token：

```bash

curl -X POST 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal' \

-H 'Content-Type: application/json' \

-d '{"app_id":"cli_a94b4a1e43781cc7","app_secret":"{从 openclaw.json 读取 appSecret}"}'

```

1. 用 exec + curl 在共享文件夹中创建文档（需指定 folder_token）：

```bash

curl -X POST 'https://open.feishu.cn/open-apis/docx/v1/documents' \

-H 'Authorization: Bearer {tenant_access_token}' \

-H 'Content-Type: application/json' \

-d '{"title":"日志简报 {target_date} | 张公子","folder_token":"FQfXfYBGGllxxydJ1SgcJZWqnpf"}'

```

1. 用 feishu_doc(action=write, doc_token=..., content=...) 写入简报内容
2. 赋予张公子 full_access 权限（确保可删除）：

```bash

curl -X POST 'https://open.feishu.cn/open-apis/drive/v1/permissions/{doc_token}/members?type=docx' \

-H 'Authorization: Bearer {tenant_access_token}' \

-H 'Content-Type: application/json' \

-d '{"member_type":"openid","member_id":"ou_d8ace8a146610ca26bc07d8e68a5620f","perm":"full_access"}'

```

1. 将文档 URL 记录到反馈消息中

> ⚠️ 注意：飞书知识库操作需要机器人已加入知识库成员。如果 feishu_wiki(spaces) 返回空，说明权限不足。

第六步：用户反馈

向用户发送完成通知，包含：

• 下载 Get笔记 数量（分类统计：录音/播客/纯文本等）
• 参考对话记录数量
• 简报核心发现摘要（1-3句话）
• 各端存储结果链接

错误处理原则

1. 任何一步失败不影响其他步骤：三端归档是独立的，写入本地文件是最基本的保障
2. 明确告知用户失败原因：如果某个平台失败，需要在反馈中说明
3. 不要静默失败：如果关键步骤（如获取数据）失败，必须通知用户