WorkBuddy AI支持五种附件上传方式：一、工作台回形针图标上传常用格式文件；二、本地目录映射实现批量快速访问；三、手机直传接口保障原始信息；四、技能包模板结构化预置附件；五、CLI命令行批量注入并生成可引用ID。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy AI执行任务时需要附带本地文件（如合同、报表、图片等），但发现无法直接拖入对话框或提示“不支持该格式”，则问题通常出在上传路径未启用、权限未授权或文件类型超出默认白名单范围。以下是多种可行的附件上传处理方式：
一、通过工作台内置附件栏上传
该方式适用于单次任务中插入1–5个常用格式附件，系统自动识别并绑定至当前AI指令上下文，无需手动指定路径。
1、在WorkBuddy主工作台界面，确保已进入具体任务或聊天会话窗口。
2、点击输入框左侧的回形针图标（?），触发附件选择器。
3、在弹出的系统文件选择窗口中，勾选目标文件，支持格式包括PDF、DOCX、XLSX、PNG、JPG、TXT及CSV。
4、确认选择后，文件名以绿色标签形式显示在输入框下方，右侧同步出现「已就绪」状态标识。
5、输入自然语言指令（例如：“请分析附件中的销售数据并生成摘要”），点击发送，AI将自动加载并解析该附件。
二、启用本地目录映射上传通道
该方式适用于需高频、批量上传特定文件夹内文档的场景，通过预设可信路径实现一键访问，规避每次手动选取的重复操作。
1、打开WorkBuddy客户端，进入【设置】→【文件接入】→【本地目录授权】。
2、点击【添加可信路径】，浏览并选定您常用的文档存放夹，例如C:\Work\Reports\或~/Documents/Contracts/。
3、勾选“允许AI读取此路径下所有子文件夹”及“启用快速拖拽上传”两项开关。
4、点击【保存配置】，系统将校验路径有效性并生成内部索引，完成后状态栏显示“目录映射已激活”。
5、返回任意对话窗口，在输入框中直接输入“从Reports目录上传上月汇总表.xlsx”，AI将自动定位并载入该文件。
三、使用远程设备直传接口上传
该方式适用于手机拍摄的发票、手写签批页等临时性文件，通过局域网直连绕过云端中转，保障原始分辨率与EXIF信息完整保留。
1、在电脑端WorkBuddy中开启【网络传输】服务：进入【设置】→【网络传输】，启用服务并设定监听端口为8081。
2、确认电脑IPv4地址（如192.168.1.105），并在【目标目录】中指定接收文件夹，例如D:\WorkBuddy\Attachments\。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
3、在手机WorkBuddy应用中，进入【传输】→【电脑直传】，填写完整地址http://192.168.1.105:8081/attach。
4、从手机相册多选待传文件，点击【上传至电脑】，系统自动生成带时间戳的唯一文件名（如IMG_20260325_103244.pdf）。
5、上传完成后，该文件将实时出现在D:\WorkBuddy\Attachments\目录中，并自动被AI任务引擎索引为可调用附件。
四、通过技能包预置附件模板上传
该方式适用于固定流程类任务（如报销、合同审核），将高频附件结构封装为可复用模板，避免每次重复上传相同类型文件。
1、进入【我的技能】→【新建技能】，选择“附件驱动型”模板类型。
2、在「预置附件」区域点击【添加模板字段】，依次定义字段名（如“发票扫描件”）、接受格式（JPG/PNG）、最大数量（1）、是否必填（是）。
3、保存技能后，在工作台点击该技能图标，界面将自动渲染带上传控件的表单。
4、用户点击对应字段旁的「上传」按钮，仅能选择符合预设格式的文件，系统实时校验大小与分辨率阈值。
5、提交表单后，所有附件以结构化元数据形式注入AI推理上下文，确保“发票代码”“开票日期”等字段被精准定位提取。
五、调用命令行接口批量注入附件
该方式适用于IT管理员或自动化脚本集成场景，通过标准CLI指令将文件注入WorkBuddy本地缓存区，供后续AI任务调用，全程无GUI交互。
1、确保WorkBuddy后台服务正在运行，在终端中执行workbuddy-cli status，确认返回“active”。
2、使用upload命令注入单个文件：workbuddy-cli upload --path "/home/user/invoice.pdf" --tag "expense_voucher" --ttl 86400。
3、执行批量注入：workbuddy-cli upload-batch --dir "/data/reports/q1/" --filter "*.xlsx" --tag "q1_financials"。
4、注入成功后，系统返回唯一hash ID（如wbx-7f3a9c21），该ID可在自然语言指令中直接引用，例如：“基于wbx-7f3a9c21生成财务对比图表”。
5、所有通过CLI注入的文件默认存储于WorkBuddy私有缓存区，路径不可见、不可外部访问，仅AI执行环境具备读取权限。
