Funasr-Punctuation-Restore
功能：使用 FunASR ct-punc 模型一键恢复标点（支持文本/文件/目录）。目录模式会在同级创建结构完全一致的 _punctuated 镜像目录（原目录不变）。支持 GPU 加速 + 自动清理显存。
触发时机（Triggers）
- 用户提供一段没有标点或标点不全的文本，要求“加标点”“恢复标点”“整理标点”。
- 用户提供 .txt 文件路径或整个文件夹，要求批量处理。
- 常用于 ASR（语音转文字）后的后处理场景。
- 支持直接粘贴文本、单个文件、或整个目录。
支持的模型（推荐顺序）
- punc_ct-transformer_cn-en-common-vocab471067-large → 基于 Transformer 的中英文混合文本标点恢复模型，适合 ASR 结果自动加标点。
参数提取指南
当决定调用此技能时，请从用户上下文中提取以下参数：
--text "<文本内容>"（如果用户直接提供了文本）--file "<文件路径>"（如果用户提供了单个 .txt 文件路径）--dir "<目录路径>"（如果用户提供了文件夹路径，会批量处理）
执行步骤
-
解析输入：识别用户是提供了文本、单个文件，还是整个目录。
-
默认目标：若未指定输出路径，默认在输入同级创建
[原文件名]_punctuated.txt或_punctuated目录（原文件/目录保持不变）。 -
调用命令：使用以下兼容性命令启动脚本（优先 python3，失败则 python）。脚本会自动创建虚拟环境、检测 GPU 并安装对应版本。
(python3 scripts/punctuation_restore.py (--text "<文本内容>" | --file "<文件路径>" | --dir "<目录路径>")) || (python scripts/punctuation_restore.py (--text "<文本内容>" | --file "<文件路径>" | --dir "<目录路径>"))