菜单
逸尘自用的统一音视频转写入口，在 StepFun Step ASR 与火山引擎豆包 ASR 之间按输出需求、安全边界和可用状态路由。用于本地音频或视频的纯文本转写、时间戳、SRT 字幕、口播粗剪，以及转写前体检；用户明确指定服务商时不得静默切换。Use when a local audio or video file needs transcription and the correct ASR backend is unclear, or when the user explicitly invokes $yichen-asr.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/mcncarl/yichen-skills --skill yichen-asr命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
统一编排关键词驱动的公共网页、AI 最新动态、垂直领域和社交平台搜索，返回标准化候选；支持有界 X Research、显式站点 Map，以及本次搜索所得候选的轻量核验。不用于读取或下载用户直接给出的已知 URL，此类任务使用 yichen-content-archive。
微信本地数字资产库：Mac 4.x 全量/增量解析，以及实验性的 Windows 已解密离线快照查询。Windows 快照必须走 snapshot 子命令，不触发 Mac 增量刷新。Mac 模式用于本机微信聊天记录、联系人、群聊、朋友圈、收藏夹、语音/附件索引的密钥提取、全量解密、增量刷新、指定联系人/群聊导出、关系复盘、客户跟进和内容沉淀。触发词：微信解析、微信全量、微信增量、聊天记录、导出聊天、朋友圈解析、收藏夹解析、客户跟进、yichen-wechat-local-vault。
实验性 Windows 微信明文数据库快照本机只读查询与导出工具。用于验证用户已授权、已解密并脱离运行中客户端的静止快照，列出会话，按快照级匿名会话 ID 查询/搜索聊天和导出 Markdown。明确不读取 Weixin.exe 进程、不提取或保存密钥、不解密数据库、不发现源路径、不控制微信界面、不联网。触发词：Windows 微信明文快照、微信只读分析、查询微信快照、导出微信聊天、yichen-wechat-windows-reader。
基于 SOC 职业分类
正在显示 SKILL.md
| name | yichen-asr |
| description | 逸尘自用的统一音视频转写入口，在 StepFun Step ASR 与火山引擎豆包 ASR 之间按输出需求、安全边界和可用状态路由。用于本地音频或视频的纯文本转写、时间戳、SRT 字幕、口播粗剪，以及转写前体检；用户明确指定服务商时不得静默切换。Use when a local audio or video file needs transcription and the correct ASR backend is unclear, or when the user explicitly invokes $yichen-asr. |
这是一个统一路由层，不是第三套 ASR 引擎。Step ASR 与豆包 ASR 继续作为底层执行器，由本 Skill 负责选择、体检、失败收敛和交接。
| 需求 | 默认后端 | 原因 |
|---|---|---|
| 只要全文、摘要或内容分析 | Step ASR | 30 秒切片，失败片段可缩成 10/5 秒重试 |
| 需要较细时间戳、SRT 字幕 | 豆包 ASR | 返回结构化 utterances 和时间信息 |
| 需要口播停顿、填充词分析或自动粗剪 | 豆包 ASR | 现有脚本包含 SRT 与 ffmpeg 粗剪链 |
| 用户明确说“只用 Step” | Step ASR | 不得跨服务商补齐 |
| 用户明确说“只用豆包/火山” | 豆包 ASR | 不得跨服务商补齐 |
自动路由只允许在“尚未向任何服务商提交任务”时切换。如果某个请求已经上传、提交或留下 request ID，必须恢复或报告该任务，不得再向另一家提交同一媒体，以免重复计费。
用离线路由器确认选择：
python3 ~/.agents/skills/yichen-asr/scripts/route_asr.py \
--provider auto --text-only
需要字幕时：
python3 ~/.agents/skills/yichen-asr/scripts/route_asr.py \
--provider auto --need-timestamps --need-srt
先运行只读体检；它只报告密钥是否存在，不显示密钥内容，也不会调用付费接口：
python3 ~/.agents/skills/yichen-asr/scripts/asr_doctor.py
体检中的 token_present 仅表示本机配置了调用凭证，不代表账户有余额。ASR Token 无权读取火山引擎财务余额；余额和欠费状态必须登录费用中心核验。
执行器：
python3 "$YICHEN_STEP_ASR_SCRIPT" \
--input "/absolute/path/input.mp4" \
--output-dir "/absolute/path/output" \
--title "标题" \
--resume
公开版不内置 Step ASR 执行器。通过 YICHEN_STEP_ASR_SCRIPT 指向你已安装并审计过的兼容脚本；也可把它安装为同级 step-asr/scripts/step_asr_transcribe.py。执行时完整遵守该执行器的 SKILL.md。不得删除失败标记，也不得用豆包结果静默填补 Step 失败片段。
执行器：
python3 ~/.agents/skills/yichen-volc-asr/scripts/transcribe.py \
"/absolute/path/input.mp4" \
--transcribe-only
需要 SRT 与口播粗剪时，去掉 --transcribe-only；只生成分析和命令、不执行剪辑时加 --no-execute。
执行时完整遵守 ~/.agents/skills/yichen-volc-asr/SKILL.md。发现同媒体的 .asr_pending.json 时，优先恢复原任务；除非用户明确授权，不得使用 --force-new。
豆包调用不需要每次网页登录。公开版不包含 App ID、Token 或钥匙串名称：试用与付费 App ID 分别通过 VOLC_ASR_TRIAL_APP_ID、VOLC_ASR_PAID_APP_ID 提供，Token 分别通过 VOLC_ASR_TRIAL_TOKEN、VOLC_ASR_PAID_TOKEN 提供。脚本直接把本地媒体提交到极速版接口；视频先由 ffmpeg 在内存中提取音轨。
财务余额只能在火山引擎控制台登录后查看：
--resume 恢复。向上层研究流程至少交接：
{
"provider": "step|doubao",
"mode": "text|timestamps|srt|rough_cut",
"input": "/absolute/path/input",
"outputs": [],
"request_id": null,
"billing_status": "unknown|verified_ok|verified_insufficient",
"errors": []
}
本 Skill 是 $yichen-web-research 的转写子路由。研究总入口负责决定何时需要转写；本 Skill 只负责已有本地音视频的 ASR，不负责搜索、下载或归档。