Install
openclaw skills install @haoyiyong985/image-knowledge-converter图片截图转知识库工具(OCR + AI)。触发词:第一次使用、配置图片工具、处理新图片
openclaw skills install @haoyiyong985/image-knowledge-converter配置向导触发词:
当用户说 第一次使用 / 第一次使用图片处理工具 / 配置图片工具 时,AI 启动对话式配置向导。
处理图片触发词:
当用户说 处理新图片 / 截图转文档 / 整理截图 时(这三个触发词等价,均执行相同的处理流程),执行:
自动检测工作目录(优先从以下路径检测):
--work-dir <路径>WORK_DIR# 方式1:显式指定工作目录(推荐)
python auto_process_all_v9_4.py --work-dir "D:\WorkBuddy-Projects\图片知识库"
# 方式2:在工作目录中直接运行
cd "D:\WorkBuddy-Projects\图片知识库"
python auto_process_all_v9_4.py
# 方式3:使用环境变量
set WORK_DIR=D:\WorkBuddy-Projects\图片知识库
python auto_process_all_v9_4.py
安全原则:API 密钥不通过对话传递,用户直接在本地模板文件中填写。
当用户说"第一次使用"时,AI 先询问用户想把工具安装到哪个文件夹:
🤖 我来帮你完成配置!首先需要确定工作文件夹位置。
这个文件夹将用来存放:
• 你的待处理图片
• 生成的文档
• 配置文件
请告诉我你想使用的文件夹路径,例如:
D:\图片知识库
或桌面上的任意位置
(直接回车将使用默认位置)
关键:工作文件夹由用户指定,不是写死的路径。
AI 在用户指定的工作文件夹下创建配置模板:
{工作文件夹}\config\api_keys_template.txt
AI 告诉用户:
✅ 配置模板已创建!
📝 请打开文件并填写配置:
{工作文件夹}\config\api_keys_template.txt
【填写说明】
1️⃣ OCR 模式(必选一项,删除前面的 # 启用):
# OCR_MODE: cloud ← 云端方案(腾讯+百度)
# OCR_MODE: local ← 本地方案(Tesseract)
# OCR_MODE: hybrid ← 兜底方案(云端+本地)
2️⃣ 填写 API 密钥(根据上一步选择填写):
- 腾讯云 SecretId/SecretKey
- 百度云 API Key/Secret Key
- 或启用 use_tesseract: true
3️⃣ LLM 配置(如需 AI 智能分析):
# 注意:混元(Hunyuan)使用与腾讯云OCR相同的密钥,无需单独配置
# 如需使用其他LLM,请参考代码中的配置项
llm_enabled: true
llm_provider: hunyuan
4️⃣ IMA 同步(如需自动同步到 IMA,必须改为 true):
# 启用:将下方 false 改为 true,并填写 client_id 和 api_key
# 获取方法:IMA 设置 → API → 创建新的 API Key
ima_enabled: true ← 必须改为 true 才能启用
ima_api_key: 你的API密钥
ima_client_id: 你的ClientID
5️⃣ 填写完成后保存文件,然后对我说「配置已填写完毕」
用户说「配置已填写完毕后」,AI 自动:
# 运行配置处理器(自动检测工作目录)
python wizard_processor.py
# 或显式指定工作目录
python wizard_processor.py --work-dir "D:\WorkBuddy-Projects\图片知识库"
config/api_keys.yaml✅ 配置完成!
📁 请把图片放入:
{工作文件夹}\待处理图片
然后对我说「处理新图片」
第一次使用图片处理工具待处理图片\首次配置(启动向导):
第一次使用第一次使用图片处理工具配置图片工具首次配置开始处理(运行脚本):
处理新图片截图转文档整理截图{工作文件夹}\ ← 所有文件都在用户指定的工作目录下
├── auto_process_all_v9_4.py ← 主处理脚本(V9.5 支持 --work-dir)
├── wizard_processor.py ← 配置处理器
├── setup_wizard.py ← 交互式配置向导(可选)
├── config\
│ ├── api_keys_template.txt ← 用户在此填写(本地)
│ └── api_keys.yaml ← 自动生成
├── 待处理图片\
├── 已处理图片\
├── 处理结果\
│ ├── *.md ← 生成的 Markdown 文档
│ ├── *.docx ← 生成的 Word 文档
│ ├── process.log ← 运行日志
│ └── 处理报告.json ← 处理统计报告
└── progress\ ← 分批处理状态(自动创建)
v1.2.7 (2026-05-20)
x-tc-action 到 CanonicalHeaders 和 SignedHeadersapplication/json; charset=utf-8 与腾讯云官方一致tencentcloud-sdk-python-v3,只需 requests 库v1.2.6 (2026-05-20)
tencentcloud-sdk-python-v3requests 库v1.2.5 (2026-05-20)
ima_enabled= 的情况)v1.2.4 (2026-05-20)
auto_process_all_v9_4.py 支持 --work-dir 命令行参数指定工作目录v1.2.3 (2026-05-20)
wizard_processor.py 的 get_work_folder() 不再硬编码默认路径,改为动态检测脚本目录SKILL.md 移除所有硬编码示例路径,改为 {工作文件夹} 占位符v1.2.2 (2026-05-20)
v1.2.1 (2026-05-20)
v1.2.0 (2026-05-10)
v1.1.0 (2026-04-27)