若pdf文字提取或结构化解析失败，需依次启用pdf解析技能、配置ocr参数、注入ocr组件：一、在技能中心启用“pdf结构化解析_v3.1”并重启；二、在ai组件管理中设双语识别、开启预处理、选高精度模式并验证；三、用cli安装并校验ocr组件，启用接管选项后确认沙箱进程运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已在WorkBuddy中安装基础客户端，但无法对PDF执行文字提取或结构化解析，则可能是PDF解析技能未启用或OCR识别组件未正确配置。以下是完成导入与配置的具体步骤：
一、通过技能中心启用PDF解析技能包
该方式适用于首次配置或技能被禁用后的恢复操作，系统将自动关联OCR核心模块并校验运行环境依赖。
1、启动WorkBuddy桌面客户端，确保已登录企业微信或腾讯账号。
2、点击主界面左下角「技能中心」图标，进入技能管理页面。
3、在搜索框中输入关键词PDF解析，从结果列表中找到官方认证技能“PDF结构化解析_v3.1”。
4、点击该技能右侧的「启用」按钮，等待状态变为“已激活”，此时页面底部提示“OCR引擎已就绪”。
5、关闭技能中心，重启WorkBuddy以使组件加载生效。
二、手动配置OCR识别组件参数
该方式用于调整识别精度、语言适配及性能偏好，适用于处理繁体中文、混合排版或低质量扫描件等特殊场景。
1、进入WorkBuddy主界面，点击右上角头像 → 「设置」→ 「AI组件管理」。
2、在「OCR识别引擎」区域，点击「配置」按钮，打开参数面板。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
3、将「默认识别语言」下拉菜单设为简体中文+繁体中文（双语模式）。
4、勾选「启用图像预处理」，并在子选项中开启「自动去阴影」「锐化增强」「倾斜校正」三项。
5、在「性能模式」中选择高精度优先，避免因速度优化导致手写体或小字号文字漏识。
6、点击「保存并验证」，系统将调用测试图像进行组件自检，状态栏显示“OCR组件验证通过”即完成配置。
三、通过命令行注入OCR组件至沙箱环境
该方式面向IT管理员或技术用户，绕过GUI层直接注册OCR动态链接库，确保批量任务与后台服务可稳定调用识别能力。
1、确认WorkBuddy CLI工具已安装，终端执行workbuddy --list-components，检查输出是否包含“ocr_engine_v4”。
2、若未列出，执行指令：workbuddy component install ocr --source rapidocr-win64（Windows）或workbuddy component install ocr --source tesseract-macos（macOS）。
3、安装完成后，运行workbuddy component verify ocr，等待返回“SHA256校验一致，签名有效”。
4、在设置中切换至「高级模式」，勾选「允许CLI组件接管OCR请求」。
5、重启WorkBuddy服务进程，使用任务管理器确认“wb-ocr-sandbox.exe”或“wb-ocr-daemon”进程处于运行状态。
