📦 bruce-doc-converter-skill — bruce-doc-转换器-技能

Bruce Doc Converter 面向代理的文档转换器 CLI。 何时使用 当用户要求以下操作时使用此技能： 转换 .docx、.xlsx、.pptx、.pdf 或 .md 文件。 阅读、总结、检查或分析 Office/PDF 文档。 将 Markdown 导出为 Word。 处理代理无法直接读取内容的上传文档文件。 安装 首先检查 bdc 是否已经可用： 命令 -v bdc # macOS / Linux 其中 bdc # Windows 如果未安装，请尝试以下方法，直到成功： # 1. pipx（首选 - 隔离，bdc 位于 PATH） pipx install bruce-doc-converter # 2. uv（如果可用 - 快速，隔离，bdc 位于 PATH） uv tool install bruce-doc-converter # 3. pip --user（最通用，bdc 位于 PATH） pip install --user bruce-doc-converter # 或：python3 -m pip install --user bruce-doc-converter # 4. venv 回退（适用于所有地方，但 bdc 不在 PATH） python3 -m venv .venv .venv/bin/pip install bruce-doc-converter # Windows：.venv\Scripts\pip install bruce-doc-converter venv 注释：如果使用 venv 回退，请将下面的每个 bdc 命令替换为 .venv/bin/bdc（macOS/Linux）或 .venv\Scripts\bdc（Windows）。 Windows 注释：如果 python3 不被识别，请使用 python 代替。 命令 运行：bdc convert "" 批量转换：bdc batch "" 对于 Markdown 到 Word，请在第一次使用之前显式初始化 Node.js 依赖项： bdc setup-node CLI 默认将 JSON 打印到 stdout。进度日志可能出现在 stderr。 输出处理 将 stdout 解析为 JSON。 成功时：success 为 true，output_path 指向生成的文件。 Office/PDF 输入包括 markdown_content 以进行直接分析。 .md 输入生成 .docx 文件，可能省略 markdown_content。 失败时：success 为 false。使用 error_code、retryable、可选的 next_command、error 和可选的 suggestion 来决定下一步。 不要预先检查 Python 依赖项。先运行命令，然后对 JSON 失败做出反应。 如果 Markdown 到 Word 返回 DEPENDENCY_INSTALL_REQUIRED，请在 next_command 存在时运行，否则运行 bdc setup-node，然后重试。 bdc setup-node 是幂等的，可能返回 already_installed：true 和 install_action： "skipped"。 安装故障排除 错误 原因 解决方法 SOCKS 支持 / 代理连接错误 all_proxy 或 http_proxy 环境变量设置 运行 unset all_proxy http_proxy https_proxy（macOS/Linux）或 set all_proxy=（Windows CMD），然后重试 命令未找到：pipx pipx 未安装 尝试使用 uv tool install 或 pip install --user 代替 externally-managed-environment Python 3.11+ 系统 Python 禁止全局 pip 使用 pipx、uv tool install 或 venv 回退 权限 denied 无写入权限到安装位置 添加 --user 标志，或使用 venv 回退 bdc：命令未找到 after venv install venv bin 不在 PATH 使用全路径：.venv/bin/bdc（macOS/Linux）或 .venv\Scripts\bdc（Windows） 支持格式 输入 输出 .docx Markdown .xlsx Markdown .pptx Markdown .pdf Markdown .md Word .docx