Funasr-Punctuation-Restore

功能：使用 FunASR ct-punc 模型一键恢复标点（支持文本/文件/目录）。目录模式会在同级创建结构完全一致的 _punctuated 镜像目录（原目录不变）。支持 GPU 加速 + 自动清理显存。

触发时机（Triggers）

• 用户提供一段没有标点或标点不全的文本，要求“加标点”“恢复标点”“整理标点”。
• 用户提供 .txt 文件路径或整个文件夹，要求批量处理。
• 常用于 ASR（语音转文字）后的后处理场景。
• 支持直接粘贴文本、单个文件、或整个目录。

支持的模型（推荐顺序）

1. punc_ct-transformer_cn-en-common-vocab471067-large → 基于 Transformer 的中英文混合文本标点恢复模型，适合 ASR 结果自动加标点。

参数提取指南

当决定调用此技能时，请从用户上下文中提取以下参数：

1. --text "<文本内容>" （如果用户直接提供了文本）
2. --file "<文件路径>" （如果用户提供了单个 .txt 文件路径）
3. --dir "<目录路径>" （如果用户提供了文件夹路径，会批量处理）

执行步骤

1. 解析输入：识别用户是提供了文本、单个文件，还是整个目录。
2. 默认目标：若未指定输出路径，默认在输入同级创建 [原文件名]_punctuated.txt 或 _punctuated 目录（原文件/目录保持不变）。
3. 调用命令：使用以下兼容性命令启动脚本（优先 python3，失败则 python）。脚本会自动创建虚拟环境、检测 GPU 并安装对应版本。

```bash

(python3 scripts/punctuation_restore.py (--text "<文本内容>" | --file "<文件路径>" | --dir "<目录路径>")) || (python scripts/punctuation_restore.py (--text "<文本内容>" | --file "<文件路径>" | --dir "<目录路径>"))