通用录音转写
这是一套不依赖特定 AI Agent 产品的流程。原录音和案件材料始终视为只读；案件材料默认只在本机提取热词。
首次使用
如果用户说“首次配置”“安装”“检查环境”，或者任何必需命令不存在，先读 references/first-use.md，运行无修改的环境检查，再用大白话逐步引导。安装软件、下载模型或配置云服务前分别取得用户同意。
不得要求用户把 API Key 粘贴进聊天。不得把密钥、个人工作空间编号、个人绝对路径或运行时配置写回 Skill 目录。每位用户必须使用自己的密钥，并存入其电脑的安全凭据存储或临时环境变量。
根据实际需要再读取：
- 案件材料无法读取或需要 OCR：读 references/case-materials.md。
- 用户选择本地转写或安装本地模型：读 references/local-funasr.md。
- 用户选择云端、比较服务商或尚未决定服务商：先读 references/cloud-providers.md，只展示与本次录音有关的差异。
- 用户选定阿里云内置自动适配器：再读 references/aliyun-cloud.md。
- 核对模型、依赖、许可证或官方资料：读 references/model-and-tool-links.md。
- 实现适配器、处理任务状态或交付成果：读 references/protocol.md。
每次转写的固定顺序
- 用户提供一个或多个本地录音路径。确认文件存在、可读且属于支持的音视频格式；每段录音建立独立任务。
- 在转写前询问：“这段录音是否有相关案件材料需要参考？”
- 用户说有时，只读取其明确指定的文件或文件夹。提取精简热词：人名、机构、案号、项目/地点、法律术语、简称及其他易听错短语。身份证号、银行卡号、整段案情不得作为热词。
- 第一层只提供两项选择：
- 本地转写：通常无按分钟服务费，录音不离开电脑，但需先装好本地模型。
- 云端转写：录音会上传且可能收费。用户选择后，必须进入第二层服务商选择，不得默认阿里云或沿用上一位用户的选择。 - 云端第二层至少列出：阿里云百炼、腾讯云语音识别、科大讯飞、火山引擎豆包语音、百度智能云。对每项用大白话说明热词、说话人区分、文件限制、最新价格入口和当前接入方式，再由用户选定。没有核实的能力或价格写“需查看官方页面”，不得猜测。
- 调用云端前说明选定服务商、地域、实际上传内容、价格或“价格未知”、保存期限及接入方式，并取得本次录音的明确同意。服务商选择和上传同意是两个独立步骤。
- 不得从本地静默切换到云端，也不得在云端服务商失败后静默改投另一家。选定方式不可用时，说明原因并让用户重新选择。
- 将录音与精简热词交给选定适配器。完整案件材料默认不上传。若厂商没有内置自动适配器，可使用该厂商控制台或符合本 Skill 协议的外接适配器；必须明确告诉用户，不能伪装成已经自动接入。
- 只有真实、非空转写结果才能完成任务。保留未经修改的机器稿；任何校正、姓名确认或总结另存为修订稿或派生成果。
- 用户确认真实说话人前，只使用“说话人1/2”等声音标签。
成果命名与位置
- 机器稿：
<原录音文件名（不含扩展名）>-机器原始稿.<扩展名> - 修订稿：
<原录音文件名（不含扩展名）>-审阅修订版.<扩展名> - 两类成果都保存一份到任务目录，并同步一份到原录音所在文件夹。
- 不得覆盖内容不同的同名文件；遇到冲突立即停止并报告。
- 不得移动、改名、修改或删除原录音和案件材料。
可移植命令
优先使用首次配置后生成的公共命令；尚未安装时，直接从本 Skill 的 scripts/ 运行：
setup_assistant.py：首次检查、列出/记录云服务商选择、安装核心命令、生成无密钥阿里云配置。audio_workflow.py：任务记录、用户选择、成果散列和同目录发布。case_materials.py：本地提取常见案件文件文字。funasr_transcribe.py：一次性加载本地模型、转写并退出。aliyun_transcribe.py：当前内置的阿里云自动适配器；明确确认后调用，无确认参数时必须拒绝上传。
任何失败、空白稿或占位文本都不得标记为完成。
