القائمة
本地中文 ASR 工具。接收本地 audio/video 文件路径，使用 SenseVoice-Small（funasr 包）输出中文逐字稿 markdown 到 ~/Downloads/asr-output/。Use when 用户已经有本地媒体文件并要转文字，或被 media-fetch 串联触发。支持普通话/粤语/英日韩。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | asr |
| description | 本地中文 ASR 工具。接收本地 audio/video 文件路径，使用 SenseVoice-Small（funasr 包）输出中文逐字稿 markdown 到 ~/Downloads/asr-output/。Use when 用户已经有本地媒体文件并要转文字，或被 media-fetch 串联触发。支持普通话/粤语/英日韩。 |
把任意本地 audio/video 文件转成中文逐字稿 markdown。
skills/asr/
├── SKILL.md # 本文件
├── scripts/transcribe.py # 主流程：ffmpeg 抽音 + SenseVoice 转写 + markdown 渲染
└── README.md # 一次性安装说明
media-fetch 完成后自动衔接（拿到 MEDIA_PATH=... 后调本 skill）brew install ffmpeg # 抽音必需
# funasr/torch 须装进 *运行脚本的那个* 解释器；bare python3 常是缺依赖的 Xcode 3.9.6
/opt/homebrew/bin/python3 -m pip install --break-system-packages funasr torch torchaudio pyyaml
依赖装在 Homebrew Python
/opt/homebrew/bin/python3(3.14)。transcribe.py启动时若当前解释器缺 funasr/torch 会自动重入装了依赖的解释器（见skills/_shared/interp），故文档里的python3 transcribe.py ...开箱即用；自动找不到时设INVEST_WIKI_PY=/path/to/python3覆盖。
首次运行脚本会自动从 ModelScope 下载 SenseVoiceSmall（~893MB）到 ~/.cache/modelscope/，后续完全离线。
python3 skills/asr/scripts/transcribe.py <FILE> [--target DIR] [--language zh|auto|en|yue|ja|ko]
参数：
<FILE>：本地 audio/video 路径，ffmpeg 能解的格式都行（mp3/mp4/wav/m4a/mov/...）--target：输出目录，默认 ~/Downloads/asr-output/（不入 wiki）；想直接入 wiki 时传 raw/articles/_inbox/ 等仓库内路径--language：语言代码（默认 zh；粤语用 yue；混合内容用 auto）成功时最后一行输出：
TRANSCRIPT_PATH=/absolute/path/to/2026-05-12_<basename>.md
进度提示走 stderr 不污染契约。
遵循 invest-wiki raw/articles/ frontmatter 规范（详见 CLAUDE.md 的「WebSearch 归档」段）：
---
source: file:///absolute/path/to/source.mp4
fetched: 2026-05-12
title: 视频文件名（不含扩展名）
publisher: (本地媒体)
published: null
stocks: []
topics: []
verified: unverified # ASR 产物本质是机器转写，不等同 verified 原文
asr_engine: funasr / SenseVoiceSmall
conflicts: []
---
# <title>
## 逐字稿
<整段连贯文本，含标点和数字规整>
关键标签：verified: unverified 必须保留——ASR 是机器转写，不能等同 verified 原文。后续 ingest 流程消化时人工校对再标 partial 或 true。
如果用户给的是 URL 而非本地文件，先触发 media-fetch 拿到 MEDIA_PATH，再调本 skill：
用户：转文字 https://v.douyin.com/xxx/
↓
触发 media-fetch → MEDIA_PATH=~/Downloads/media-fetch/2026-05-12_douyin_yyy.mp4
↓
触发 asr 传入该路径 → TRANSCRIPT_PATH=~/Downloads/asr-output/2026-05-12_douyin_yyy.md
| 现象 | 可能原因 | 处理 |
|---|---|---|
ERROR: 缺少依赖：['funasr', 'torch'] | 依赖没装进可被自动发现的解释器 | 装到 homebrew python：/opt/homebrew/bin/python3 -m pip install --break-system-packages funasr torch torchaudio pyyaml；或设 INVEST_WIKI_PY=/path/to/python3 |
ffmpeg: command not found | 未安装 | brew install ffmpeg |
| 模型下载卡住 | ModelScope 拥堵 / 网络问题 | 等待重试；持续失败时手动从 ModelScope iic/SenseVoiceSmall 下载 model.pt 到 ~/.cache/modelscope/hub/models/iic/SenseVoiceSmall/（脚本会自动识别该本地路径并跳过下载） |
| 输出大量乱码 / 重复 | 视频音频质量太差 / 强 BGM | 用 ffmpeg 预处理增强音频；或接受小段失真 |
| 内存爆涨 / OOM | 极长音频（> 1h）+ VAD 未生效 | 检查 transcribe.py 中 vad_model="fsmn-vad" 是否启用；必要时手动 chunk 切片再分别转写 |
value-invest / stock-deep-dive 等下游 skill定时数据采集任务集合。把外部数据（车企销量、宏观指标、资金面、央行会议等）定期塞进 raw/ 并回写 wiki/ 静态数据章节。Use when user wants to ingest periodic data (monthly auto sales, weekly margin balance, CPI release, FOMC decision), run a scheduled-ingest job, set up a data refresh routine, or asks "我每月怎么更新汽车销量". Distinct from periodic-review (which is analysis layer reading these data).
行业 ETF 动量轮动计算器。按"6 月动量 + 200 日趋势过滤"算 A 股行业/主题 ETF 当前动量状态，并出**去相关 top-K 选择 + 波动率目标敞口建议**(回测验证的风控层)，生成快照。Use when 用户问"现在行业动量怎么样 / 哪些板块强 / 跑一下 ETF 动量 / 刷新动量状态 / 行业轮动信号"。策略框架见 wiki/strategies/行业ETF动量轮动.md。
定期投资复盘工具。检查关注个股价格与估值区间变化、宏观数据与央行/美联储政策更新、人民币汇率、全球大事件，跟踪 8 个宏观边际变量的 regime 信号灯（macro/宏观边际变量追踪.md）与港股流动性三层信号灯（macro/港股流动性追踪.md），提示需要更新的 wiki 页面，输出至 wiki/journal/。
个股产品/经营深度分析工具。聚焦公司**业务本身**——卖什么、卖给谁、卖得怎样、产品矩阵在变化什么、竞品在做什么、用户怎么看。Use when the user wants to dig into a stock's business (rather than valuation), mentions deep-dive on a holding, asks about a company's products / competitive landscape / management strategy, or after a major business event (product launch, policy shock, M&A) on a focus-list name. 不做财务/估值（那是 value-invest 的边界）。
本地媒体下载工具，按 URL 自动分流。Douyin 走 Playwright + headless Chromium 抓无水印 mp4；Apple Podcasts 走 iTunes Search API 抓 mp3/m4a 直链。落到 ~/Downloads/media-fetch/。Use when 用户提供抖音链接 / Apple Podcasts 链接说"下载"/"保存"/"准备转字"，或作为 asr skill 的前置步骤。
把一个抖音博主蒸馏成可复用的"人设 skill"——给定博主主页 URL，自动跑通【扫码登录→旁路枚举全部作品→识别会员/付费视频→选样下载→批量转写→读稿蒸馏成 skill→独立校验】整条流水线，产出 skills/<persona>/（SKILL.md + references 三件套）。Use when 用户给一个抖音用户主页链接（www.douyin.com/user/...）说"把这个博主蒸馏成 skill / 提取他的人设 / 根据主页链接做成 skill / 学一下这个博主的风格 / 把这个号做成解读层"，或想批量提取某博主作品文字稿再提炼方法论与声纹。这是**生成器/工程流程层**：产出的人设 skill（如 macro-ellie / stock-kuaidao / invest-tusi）才是解读层。下载单条视频走 media-fetch，转写走 asr，本 skill 负责"主页级枚举 + 选样 + 蒸馏 + 校验"的编排。