rightclick-creator【macOS Only】右键神器。 当用户提到以下任一意图时，必须立即使用此 Skill： 「安装右键工具」「批量安装右键」「右键工具集」「macOS右键菜单」 「帮我装右键」「装右键工具」「添加右键菜单」「Finder右键」 「右键整理Word」「右键转PDF」「右键生成信息图」「右键转Markdown」 「右键功能」「右键快捷操作」「右键批量处理」 本 Skill 帮助 macOS 用户批量安装 Finder 右键快捷工具， 一次安装多个功能，安装后在任意文件上右键即可一键处理。 负向触发：非 macOS 系统、Windows 右键、Linux 右键菜单，不使用此 Skill。
Independent GitHub snapshot · Automated classification · Original documentation governs
CRITICAL：遇到以下任一情况，立即按对应动作执行，不要询问用户额外信息：
scripts/install.py --tools <工具名>scripts/install.py --allscripts/install.py --uninstall <工具名>scripts/install.py --listIMPORTANT：本 Skill 仅支持 macOS。Windows/Linux 用户不使用此 Skill。
IMPORTANT：需要 API Key 的工具（生成信息图、MD整理），安装前必须先配置。若已配置则跳过询问，若未配置则通过对话引导用户输入。不得跳过配置直接安装。
把你常用的文件处理功能，一键批量装到 macOS Finder 的右键菜单里。
安装后，在 Finder 中选中文件 → 右键 → 快速操作 → 选择功能，文件立即被处理，无需打开任何应用。
当前可用工具（9个）：
| # | 分类 | 工具名 | 支持文件 | 功能简述 |
|---|---|---|---|---|
| 1 | 格式整理 | word整理 | .docx/.doc | 清洗修订痕迹、字体混乱、Markdown符号 |
| 2 | 文档转换 | Word表格横排 | .docx | 表格页面改为横向 |
| 3 | 格式整理 | Excel格式整理 | .xlsx/.xls | 统一格式、列宽、字体 |
| 4 | 文档转换 | docx2pdf | .docx/.doc | Word 转 PDF（LibreOffice） |
| 5 | 文档转换 | MD转Word | .md/.txt | Markdown 转 Word |
| 6 | 信息生成 | 生成信息图 | .docx/.md | 生成信息图（HTML+PDF） |
| 7 | 文档转换 | PDF转MD | PDF 智能转 Markdown | |
| 8 | 格式整理 | MD整理 | .md | Markdown 格式整理 |
| 9 | 信息查询 | 查询天眼查 | 文本（选中文字） | 选中文字跳转天眼查搜索 |
以下工具需要 API Key 才能使用：
| 工具名 | 需要 API Key | 支持的供应商 |
|---|---|---|
| 生成信息图 | DeepSeek 或 通义千问 | DeepSeek (platform.deepseek.com)、通义千问 (dashscope.aliyun.com) |
| MD整理 | DeepSeek 或 通义千问 | DeepSeek (platform.deepseek.com)、通义千问 (dashscope.aliyun.com) |
不在运行时弹窗。 所有 API Key 配置都在安装阶段通过 AI 与用户的对话完成：
configure.py 写入配置，确认保存成功运行时未配置 → 静默跳过，不弹窗、不报错。用户后续可通过再次触发 Skill 补充配置。
| 用户说 | 你该做什么 |
|---|---|
| 「帮我安装右键工具」「批量安装」 | 展示上方表格，让用户选择 |
| 「安装 word整理 和 docx2pdf」 | python3 scripts/install.py --tools word整理 docx2pdf |
| 「全部安装」「都装上」 | python3 scripts/install.py --all |
| 「卸载 word整理」 | python3 scripts/install.py --uninstall word整理 |
| 「有哪些右键工具」 | python3 scripts/install.py --list |
| 「右键菜单没出现」「安装失败」 | 执行故障排查步骤 |
Step 1：展示工具列表并询问选择
用户触发 Skill 时，展示工具表格，同时标注哪些需要 API Key：
📋 可用右键工具（9个）
┌───┬──────────┬──────────────┬─────────────────┬──────────┐
│ # │ 分类 │ 工具名 │ 功能简述 │ 需要Key? │
├───┼──────────┼──────────────┼─────────────────┼──────────┤
│ 1 │ 格式整理 │ word整理 │ 清洗修订痕迹等 │ - │
│ 2 │ 文档转换 │ Word表格横排 │ 表格页面横向 │ - │
│ 3 │ 格式整理 │ Excel格式整理│ 统一格式列宽 │ - │
│ 4 │ 文档转换 │ docx2pdf │ Word转PDF │ - │
│ 5 │ 文档转换 │ MD转Word │ Markdown转Word │ - │
│ 6 │ 信息生成 │ 生成信息图 │ 文本转信息图 │ ✅ │
│ 7 │ 文档转换 │ PDF转MD │ PDF转Markdown │ - │
│ 8 │ 格式整理 │ MD整理 │ Markdown格式整理│ ✅ │
│ 9 │ 信息查询 │ 查询天眼查 │ 选中文字跳转搜索│ - │
└───┴──────────┴──────────────┴─────────────────┴──────────┘
💡 需要 API Key 的工具（#6、#8）会在安装时引导你配置
你想安装哪些？可以按编号、名称、分类或说「全部安装」。
Step 2：用户选择工具
支持多种选择方式：
1、3、5 / 全部安装word整理、docx2pdf文档转换类的除了生成信息图都装Step 3：API Key 配置对话（仅未配置时执行）
如果用户选择了需要 API Key 的工具，先检查是否已配置。未配置才询问，已配置则跳过：
# 检查配置状态
python3 <skill_dir>/scripts/configure.py --status
未配置时，通过对话引导：
你选择了「生成信息图」和「MD整理」，这两个工具需要 API Key。
生成信息图支持：DeepSeek、通义千问（可配一个或两个）
MD整理支持：DeepSeek、通义千问（可配一个或两个）
请问：
1. 你使用哪个供应商？（DeepSeek / 通义千问 / 两个都要）
2. 对应的 API Key 是什么？
用户回答后，调用 configure.py 写入并验证：
# 配置生成信息图 - DeepSeek
python3 <skill_dir>/scripts/configure.py infographic --set-key deepseek_api_key=sk-xxx
# 配置生成信息图 - 通义千问
python3 <skill_dir>/scripts/configure.py infographic --set-key qwen_api_key=sk-yyy
# 配置 MD整理
python3 <skill_dir>/scripts/configure.py md-clean --set-key api_key=sk-yyy
# 或配置 DeepSeek
python3 <skill_dir>/scripts/configure.py md-clean --set-key deepseek_api_key=sk-xxx
# 验证配置已生效
python3 <skill_dir>/scripts/configure.py --status
Step 4：执行安装
python3 <skill_dir>/scripts/install.py --tools 工具1 工具2 ...
install.py 自动完成：
~/.rightclick-creator/tools/cp -R 复制种子 workflow → ~/Library/Services/plistlib 修改 COMMAND_STRING 和 Info.plistStep 5：告知验证方法
安装完成！请验证：
1. 等待 Finder 重启（约 3-5 秒）
2. 选中对应类型文件 → 右键 → 快速操作
3. 检查菜单中是否出现已安装的工具
~/.rightclick-creator/tools/ 目录下有对应子目录和脚本~/Library/Services/ 下有 .workflow 文件# 方法1：手动刷新
/System/Library/CoreServices/pbs -flush
killall Finder
# 方法2：重新安装
python3 <skill_dir>/scripts/install.py --tools <工具名>
# 查看日志
cat ~/.rightclick-creator/logs/*.log
常见原因：
pandoc 未找到：brew install pandocpython-docx 未安装：pip3 install python-docx lxmlLibreOffice 未找到：brew install --cask libreoffice（docx2pdf 需要）xattr -d com.apple.quarantine /path/to/文件.docx
# 卸载单个工具
python3 <skill_dir>/scripts/install.py --uninstall 工具名
# 手动删除
rm -rf ~/Library/Services/工具名.workflow
/System/Library/CoreServices/pbs -flush
killall Finder
用户输入：「帮我安装 word整理 和 docx2pdf」
你的执行流程：
python3 ~/.workbuddy/skills/右键神器/scripts/install.py \
--tools word整理 docx2pdf
用户输入：「帮我安装 word整理 和 MD整理」
你的执行流程：
python3 ~/.workbuddy/skills/右键神器/scripts/configure.py --status
「MD整理 需要 API Key，你使用哪个供应商？（DeepSeek / 通义千问）」
python3 ~/.workbuddy/skills/右键神器/scripts/configure.py md-clean \
--set-key api_key=sk-xxx
python3 ~/.workbuddy/skills/右键神器/scripts/configure.py --status
python3 ~/.workbuddy/skills/右键神器/scripts/install.py \
--tools word整理 MD整理
**禁止做的：**不要从零创建 workflow；不要用 sed 修改 plist；不要跳过 pbs 刷新；不要跳过 API Key 配置直接安装 AI 工具。
右键神器/
├── SKILL.md ← 本文件
├── README.md ← 项目说明
├── scripts/
│ ├── install.py ← 多工具安装器（核心）
│ ├── extract_catalog.py ← 一次性：从现有 workflow 提取 catalog
│ └── tools/ ← 工具专属 Python 脚本
│ ├── docx_format_cleaner/
│ ├── word_table_landscape/
│ ├── excel_format/
│ ├── md2docx_plain/
│ ├── infographic/
│ ├── pdf2md/
│ ├── md_cleaner/
│ └── tianyancha/
└── references/
└── tools_catalog.json ← 工具配置目录
如需添加新的右键工具：
~/Library/Services/ 创建并验证 workflow（通过 Automator GUI）python3 scripts/extract_catalog.py 提取脚本tools_catalog.json 中的 id、category、description、dependencies、path_mappingsscripts/tools/{新工具}/