Menu
把飞书妙记（会议/讲座/Coffee Chat 的录音转写）全量拉到本地，存成带 AI 总结的 Markdown 笔记。首次全量、之后自动增量。用户不需要自建飞书应用、不需要申请 API 权限、也不需要管理员审批——只要在弹出的浏览器里登录一次飞书即可，完全没授权过飞书的人也能用。触发词：拉飞书妙记、同步妙记、下载妙记、把妙记存到本地、导出飞书妙记、飞书录音转写、feishu minutes、把我的妙记同步到 Obsidian。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
| name | pull-feishu-minutes |
| description | 把飞书妙记（会议/讲座/Coffee Chat 的录音转写）全量拉到本地，存成带 AI 总结的 Markdown 笔记。首次全量、之后自动增量。用户不需要自建飞书应用、不需要申请 API 权限、也不需要管理员审批——只要在弹出的浏览器里登录一次飞书即可，完全没授权过飞书的人也能用。触发词：拉飞书妙记、同步妙记、下载妙记、把妙记存到本地、导出飞书妙记、飞书录音转写、feishu minutes、把我的妙记同步到 Obsidian。 |
把用户飞书账号下「我的妙记」里的全部录音转写拉到本地，每条存成一篇 Markdown： 顶部是为「一个月后已经忘光的自己」写的总结，底部是完整的原始逐字稿。
先说清楚，避免走弯路：
minutes/v1/minutes/search），按相关度返回少量命中，枚举不全。minutes:minutes.transcript:export 是敏感权限，需要自建应用 + 企业管理员在管理后台单独审批。普通用户往往不是管理员，这一步就卡死了。所以本 skill 走网页登录态 + 妙记内部接口：零建应用、零权限申请、零管理员审批。代价是依赖未公开接口，飞书改版有失效可能（失效时报错会明确提示）。
bash ~/.claude/skills/pull-feishu-minutes/scripts/setup.sh
建 venv、装 playwright、下 chromium 内核。已就绪时会很快跳过。
路径说明：本文以全局安装（
~/.claude/skills/pull-feishu-minutes/）为准。 若装在项目级（.claude/skills/pull-feishu-minutes/），把下文所有~/.claude/skills/pull-feishu-minutes换成该项目里的实际路径即可。 venv 始终建在 skill 目录内，跟着 skill 走。
先问用户存到哪个目录（若用户已说明则直接用；Obsidian 用户通常是 vault 下的某个文件夹）。然后：
~/.claude/skills/pull-feishu-minutes/.venv/bin/python \
~/.claude/skills/pull-feishu-minutes/scripts/sync_minutes.py \
--out "<输出目录>"
--headless：会弹出一个浏览器窗口（标题是 Google Chrome for Testing，不是用户平时的 Chrome），用户要在里面登录飞书。加了 headless 就没界面，用户根本无从登录，只会干等到超时。~/.config/feishu-minutes/browser-profile（用户级共享，换输出目录也不必重登）。之后再跑就该加 --headless 静默运行，不要再打扰用户。.feishu_minutes_state.json 与已有 md 的 minute_token）。--limit 5 先试跑几条。这一步耗时可能超过 1 分钟，放后台跑并定期查看进度，不要干等。 等待登录时更要如此——用户可能正在忙，别把前台卡死。
脚本 stdout 最后一行是 JSON：
{"ok":true,"total":12,"new":[{"token":"...","title":"...","path":"/abs/path.md","paragraphs":73}],"skipped":11}
用它拿到本次新增文件的路径列表，进入第 3 步。
先检查这三种情况，不要闷头往下走：
| 情况 | 含义 | 该怎么做 |
|---|---|---|
ok 为 false | 没登录成功（多半是等待超时） | 让用户重跑并完成登录，不要报告成功 |
有 warning 字段 | 判定为已登录、却一条妙记都没拉到 | 如实转达这条警告。若用户确信账号里有妙记，删掉 ~/.config/feishu-minutes/browser-profile 后重跑重新登录 |
new 为空、skipped > 0 | 正常，没有新妙记 | 直接告诉用户「没有新的」，结束 |
对 new 里的每一个文件：读取它 → 通读全文（长录音要分段读完，不能只看开头）→ 改写文件头部，把 ## 原始逐字稿 及其之后的内容一字不动地保留在文末。
读者是一个月后的用户本人。那时他对这场活动的记忆基本归零，甚至想不起来自己去过。所以这篇总结要同时干两件事：
判断标准：写完之后自问——如果我一个月后只读这段、不看逐字稿，我能不能跟别人复述这场活动？能不能拿其中一条去改进我手上的事？两个都能，才算合格。
妙记的主人（运行这个 skill 的人）通常本人就在场、是其中一个说话人。对他最有价值的往往是「其他人」的 idea 和判断，而不是他自己已经知道的话。 所以：
## 我当时的看法（在迭代中）），并注明这些还在迭代、只作回看、不一定是结论——本人的观点常在快速变化，别当定论记。目标是唤起记忆，所以：
0721、边吃披萨边聊、被拆的团队就坐在台下——这些信息本身没价值，但它们是记忆的钩子，比"讨论了产品增长"有用一百倍。这是全文最重的部分，目标是可复用。
**多 Agent 互相打转的根因是"定位不清"，不是模型不行。** 然后展开。**定价**：他们聊了定价策略。### 小标题分主题；短录音直接用加粗论点句分段即可，不必强行加标题层级。3~6 条，每条都要能落到动作上。"要重视用户心理"是废话；"做落地页前先问三个问题：痛点够不够痛、有没有相似的人已经成功、行动位置有没有降低风险的承诺"才是能用的。可以包含"值得去要一份那个 checklist"这类具体待办。
跟着信息密度走，不要一刀切：
| 录音 | 大致篇幅 |
|---|---|
| 30 分钟、单一主题的分享 | 「认知」3~5 块，不用小标题 |
| 1 小时、多环节的讲座 | 「认知」6~9 块，按主题加 ### 小标题 |
| 2 小时、多人圆桌 | 按活动自身的环节分大节，每节内再分块 |
宁可长而具体，不要短而空洞。 但如果一场活动确实没什么干货（纯产品宣讲、大部分时间在闲聊），就如实写短，不要注水凑篇幅。
---
title: "<重写的、有信息量的标题>"
type: 飞书妙记
场景: <Coffee Chat | 讲座 | 会议 | 内部分享 | 播客 …>
tags:
- 飞书妙记
- <场景>
- <2~4 个主题标签>
date: <保留原值>
duration: <保留原值>
source: <保留原值>
minute_token: <保留原值>
speakers: <保留原值>
imported: <保留原值>
enriched: true
---
# <重写的标题>
> 📅 <日期> ⏱ <时长> 🎙 <N> 位说话人 🏷 <场景> · [在飞书打开](<source>)
>
> 🧑🤝🧑 说话人对应：说话人 X = 我（主人）；说话人 Y = 对方（<一句话背景>）。本篇重点是「对方」的观点；我的看法见文末、且在迭代中。
## 这是哪一场
某某组织的 XX Workshop，线下，约半小时。三个人轮流上台演示自家产品，
统一穿黑衣服；现场发折扣卡和城市限定冰箱贴，最后是自由动手环节。
三位讲者各讲一个视角：
1. **产品同学**——演示用 AI 整理 Gmail 里过去 7 天的发票，导出 Excel
并写进 Notion，再把这套流程一键转成每周自动化任务。
2. **研发同学**——演示多个 AI 在同一频道里协作修一个真实 bug
（"命令行只能展示 10 条、但空间里有 75 人"），最后由 AI 提 PR。
3. **运营同学**——演示官媒运营全流程，从选题推荐一路到发推。
> 一句话记忆点：**他们不是把 AI 做成更强的工具，而是做成组织里的"人"**
> ——有名字、有自我介绍、有自己的账号，入职还走一遍 onboarding。
## 沉淀下来的认知
**多 Agent 互相打转的根因是"定位不清"，不是模型不行。** 市面上很多产品会
出现 AI 之间反复兜圈子、产出重复内容，根子在于每个 agent 不知道自己在这个
任务里是谁、负责哪一段。他们的解法是让 AI 进群时先自我介绍、确立责任边界。
**真正的壁垒是"集成的团队复用"。** 他们自己也承认，多开几个 session 同样能
跑通那些流程。差异在于一个人配好的整套外部工具连接，全团队直接可用——
原话的意思是：**你等于享受了团队里最会用 AI 的那个成员的成果。**
## 我当时的看法（在迭代中，仅作回看）
<主人本人在场时，把他自己的观点/判断单独收在这里，并注明还在迭代、不一定是结论。
若主人全程只是听/问、没有明显自己的主张，这一节可省略。>
## 可借鉴的 idea
- **"享受团队里最会用 AI 的那个人的成果"** 这个表述值得偷：把一个偏技术的
功能翻译成了一句有画面感的收益。
- 多 Agent 产品设计要点：先解决"你是谁、你负责什么"，再谈协作机制。
---
## 原始逐字稿
（原样保留，不要改动）
上面是写法示范，不是填空模板。注意几个细节：场景段里出现了"黑衣服""冰箱贴"这种无用但难忘的锚点；认知段每块用加粗论点句开头、并保留了原话；idea 段每条都能落到动作。
写总结的红线：
改完后把文件重命名成 YYYY-MM-DD <新标题>.md（重命名安全：去重依据是 frontmatter 里的 minute_token，不是文件名）。
告诉用户：本次新增几篇、分别是什么、存在哪；以及跳过了多少条已有的。若结果 JSON 里 untranscribed 非空，说明有妙记没有飞书转写、且未启用 ASR 兜底——把这些条目告诉用户，并提示可以配置 ASR（见下）来补转。
飞书免费版只有 300 分钟 转写额度，超额的妙记会没有逐字稿，或只转了开头一小段就停。本 skill 能把这类妙记的音频抠出来，交给一个语音大模型补转。
默认关闭。 只有当环境变量齐备时才启用（脚本自动探测；缺变量就跳过这些妙记并在结果里列进 untranscribed）。
支持两个后端，FEISHU_ASR_BACKEND 选（默认 auto）：
| 后端 | 说明 |
|---|---|
| volcano（推荐） | 火山引擎 豆包语音大模型 Seed-ASR。中英混杂、专有名词、标点明显更准（实测 PMF/agent/跨境电商/脉脉 这类词 Paraformer 会错、火山基本全对）。需 ffmpeg（把飞书的 m4a 转 mp3）。 |
| paraformer | 阿里云百炼 Paraformer。免转码（直接吃 m4a），但中英混杂词错得多。 |
auto | 有 VOLC_ASR_KEY 走 volcano，否则有 DASHSCOPE_API_KEY 走 paraformer。 |
| 环境变量 | 用途 |
|---|---|
ALIYUN_ACCESS_KEY_ID / ALIYUN_ACCESS_KEY_SECRET | 上传音频到 OSS 中转（两个后端都要） |
FEISHU_ASR_OSS_BUCKET | 用作中转的 OSS bucket 名 |
FEISHU_ASR_OSS_ENDPOINT | OSS endpoint，默认 oss-cn-hangzhou.aliyuncs.com |
VOLC_ASR_KEY | 火山后端：控制台开通「录音文件识别大模型版(极速版)」后拿的 X-Api-Key（单 key 鉴权） |
DASHSCOPE_API_KEY | 百炼后端：一个 key 同时管 Paraformer 语音 + Qwen 文本 |
为什么要 OSS 中转：飞书音频地址是登录态保护的，语音服务够不着；两个后端的录音文件识别都只收「它自己能访问的公网 URL」。所以音频先进用户自己的私有 bucket，只给一个 2 小时过期的签名 URL（不公开），转写完立即删除中转文件。
判断哪条需要补转：不是看有没有逐字稿，而是看转写覆盖了录音时长的多少。免费额度耗尽时飞书常常只转了开头两三句，光看"有没有段落"会误判成"已转写"。脚本按覆盖率 < 50% 判定为残缺 → 触发 ASR，用全量音频重转（transcribed_by: dashscope-paraformer 会写进 frontmatter）。
火山后端还需要 ffmpeg（setup.sh 不装它——请用户自行 brew install ffmpeg / apt install ffmpeg；缺了会在 missing_env 里提示）。
运行：把 env 准备好（通常放在 secrets 文件里，运行前 source 一下），再照第 2 步正常跑。带 --no-asr 可临时禁用。ASR 那条会在 new 里标 "source":"volcano-seed-asr" 或 "dashscope-paraformer"，你照样为它写总结（第 3 步），并在总结顶部注明逐字稿由哪个模型补转、可能有识别错。
成本：都极低，转 1 小时音频约几毛钱、1~2 分钟出结果（火山极速版实测 46 分钟音频 29 秒）。
.feishu_minutes_state.json 里删掉那个 token。--headless。反过来，登录态已存在时就该加 --headless，不必再开窗口。~/.config/feishu-minutes/browser-profile 后重跑重新登录。--limit 3。--out 不用重新登录；但新目录会被当成空目录，从头全量拉一遍。这些都是实测踩出来的，改动 sync_minutes.py 前务必先读代码注释：
space/list 同样返回 {"code":0,"list":[]}，与"已登录但没有妙记"无法区分，会造成静默的假成功。只能靠页面上有没有登录入口来判断。page.reload()。用户正在扫码或输密码时刷新，会把整个登录流程冲掉。wait_for_load_state("networkidle")。妙记页面有长连接，永远到不了 networkidle，超时抛异常被吞掉后表现为"死等登录"。xxx.feishu.cn），API 必须跟随页面当前源，跨域 fetch 会被 CORS 直接拦死。bv-csrf-token 头，且每个域名各有一份不同的值，取错域一律 HTTP 400。parse_transcript 会返回非空段落——只看"有没有段落"必然漏判。用「最后一段的时间戳 / 录音时长」判断。<audio>.currentSrc），它在 internal-api-drive-stream.feishu.cn 上，是带过期的临时地址。下载用 ctx.request（带 cookie），不能在页面里跨域 fetch。