🔧 执行指令

配置向导触发词： 当用户说 第一次使用 / 第一次使用图片处理工具 / 配置图片工具 时，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

📋 对话式配置向导（5步）

安全原则：API 密钥不通过对话传递，用户直接在本地模板文件中填写。

第1步：AI 询问工作文件夹位置

当用户说"第一次使用"时，AI 先询问用户想把工具安装到哪个文件夹：

🤖 我来帮你完成配置！首先需要确定工作文件夹位置。

这个文件夹将用来存放：
• 你的待处理图片
• 生成的文档
• 配置文件

请告诉我你想使用的文件夹路径，例如：
  D:\图片知识库
  或桌面上的任意位置

（直接回车将使用默认位置）

关键：工作文件夹由用户指定，不是写死的路径。

第2步：AI 创建配置模板

AI 在用户指定的工作文件夹下创建配置模板：

{工作文件夹}\config\api_keys_template.txt

第3步：AI 引导用户填写

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️⃣  填写完成后保存文件，然后对我说「配置已填写完毕」

第4步：AI 处理配置

用户说「配置已填写完毕后」，AI 自动：

# 运行配置处理器（自动检测工作目录）
python wizard_processor.py

# 或显式指定工作目录
python wizard_processor.py --work-dir "D:\WorkBuddy-Projects\图片知识库"

wizard_processor.py 读取模板
生成 config/api_keys.yaml
验证配置并显示摘要

第5步：放入图片并处理

✅ 配置完成！

📁 请把图片放入：
   {工作文件夹}\待处理图片

然后对我说「处理新图片」

🚀 快速上手

首次使用

说 第一次使用图片处理工具
AI 创建配置模板
用户直接编辑模板文件（密钥不在对话框中）
用户说「配置已填写完毕」
AI 处理配置并验证
放入图片，说「处理新图片」

日常使用

把图片放入 待处理图片\
说「处理新图片」

触发词

首次配置（启动向导）：

第一次使用
第一次使用图片处理工具
配置图片工具
首次配置

开始处理（运行脚本）：

处理新图片
截图转文档
整理截图

目录结构

{工作文件夹}\           ← 所有文件都在用户指定的工作目录下
├── 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)

✅ 混元签名修复：修复 TC3-HMAC-SHA256 签名算法，添加 x-tc-action 到 CanonicalHeaders 和 SignedHeaders
✅ Content-Type 修复：改为 application/json; charset=utf-8 与腾讯云官方一致
✅ SDK 依赖移除：无需安装 tencentcloud-sdk-python-v3，只需 requests 库

v1.2.6 (2026-05-20)

✅ SDK 依赖移除：改用腾讯云 REST API 调用混元 LLM，无需安装 tencentcloud-sdk-python-v3
✅ 混元调用优化：使用 TC3-HMAC-SHA256 签名认证，与其他 LLM（硅基流动/Kimi/Doubao）一样只需 requests 库
✅ LLM 说明优化：SKILL.md 明确说明混元使用与腾讯云OCR相同的密钥，无需单独配置
✅ 配置文件修复：重新生成 api_keys.yaml 确保嵌套结构正确

v1.2.5 (2026-05-20)

✅ IMA 解析修复：wizard_processor.py 现在同时支持注释和无注释格式的 ima_enabled
✅ 模板解析修复：优先用冒号分隔（支持 base64 值中含 = 的情况）
✅ IMA 模板优化：api_keys_template.txt 中 IMA 配置说明更清晰，明确标注"必须改为 true"
✅ SKILL.md 更新：配置向导第3步中 IMA 配置说明更详细

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 移除所有硬编码示例路径，改为 {工作文件夹} 占位符
✅ 流程优化：配置向导明确要求 AI 先询问用户指定工作文件夹位置

v1.2.2 (2026-05-20)

✅ 安全升级：API 密钥完全不在对话中传输，用户直接编辑本地模板文件
✅ 流程优化：从 6 步优化为 5 步（新增第1步：AI 询问用户指定工作文件夹）
✅ IMA 修复：修复了 IMA 配置无法加载的问题（添加 client_id 支持）
✅ OCR 新增 C 兜底选项

v1.2.1 (2026-05-20)

✅ 安全升级：API 密钥统一写入模板文件后由系统处理
✅ OCR 新增兜底方案：A（云端）、B（本地）、C（A+B 兜底）
✅ 自动验证配置

v1.2.0 (2026-05-10)

✅ 重构为对话式配置向导

v1.1.0 (2026-04-27)

✅ 初始版本

Image Knowledge Converter

安装到 Tokeny（自动）

SKILL.md