workbuddy大文件处理需启用流式解析、调优块读取参数、使用流式指令及绑定外部python脚本。具体包括：一、禁用全文缓存，启用按行分块的流式文本解析器；二、依文件类型调整二进制块大小并启用块级哈希缓存；三、在自然语言指令中加入“逐行”“不加载全文”等关键词触发流式执行；四、通过stdin管道调用本地python脚本实现低内存定制解析。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy处理超50MB文本日志、百万行CSV或嵌入式PDF元数据时遭遇响应延迟、界面冻结或“内存不足”报错，则很可能是AI引擎在默认模式下尝试将整个文件载入内存解析。以下是针对大文件读取逻辑的流式处理与内存优化操作路径：
一、启用WorkBuddy内置流式解析器并禁用全量加载
WorkBuddy v3.2.7起集成轻量级流式文本处理器，可绕过Electron主进程内存缓冲，直接通过Node.js原生Stream API逐块解码，避免主线程阻塞。该机制对UTF-8编码日志、TSV、纯文本配置类文件生效。
1、打开WorkBuddy主界面，点击右上角「首选项」→「高级执行引擎」。
2、在「文件解析策略」区域，取消勾选“启用全文缓存预加载”选项。
3、勾选“强制启用流式文本解析器”，并在下方下拉菜单中选择“按行边界分块（推荐）”。
4、点击「保存并重启AI执行环境」，系统将自动卸载旧解析模块并加载stream-based handler。
二、为大体积二进制文件配置自定义块读取参数
当处理ZIP压缩包、加密PDF或视频缩略图提取任务时，WorkBuddy默认采用64KB固定块大小读取。若目标文件含大量小对象（如数千个SVG图标），需调小块尺寸以提升随机访问效率；若为连续音频帧或模型权重文件，则应增大块尺寸减少I/O次数。
1、进入「首选项」→「文件处理」→「二进制流控设置」。
2、将“默认读取块大小（字节）”数值由65536修改为8192（适用于高密度小文件集合）或262144（适用于单一大文件连续读取）。
3、勾选“启用块级哈希缓存”，防止同一文件多次读取时重复解压或解密。
4、点击「应用参数」后，在下方面板中点击「验证块读取性能」，系统将模拟读取当前暂存盘中一个100MB样本文件并返回吞吐量报告。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、通过自然语言指令显式声明流式处理意图
WorkBuddy的语义解析器能识别特定动词短语，自动切换至低内存占用执行路径。当指令中包含“逐行”“分批”“不加载全文”等关键词时，AI将跳过DOM式全文本构建，直接绑定生成器函数进行迭代处理。
1、在主输入框中输入：“逐行扫描D:\logs\app_2026*.log，提取含‘Timeout’的记录，不加载全文，实时输出到新文件”。
2、等待AI生成执行计划，确认步骤中出现“stream.readline()”“yield line”等标识符。
3、点击「执行」，观察右下角状态栏是否显示“流式处理中｜已处理 12,487 行｜内存占用 ≤ 42MB”。
4、如需中断，点击暂停按钮，系统将自动保存当前偏移位置，支持后续从断点续读。
四、绑定Python外部流式脚本实现定制化解析
对于需正则多轮提取、字段动态映射或跨格式关联（如从JSONL日志中提取ID再查CSV用户表）等复杂场景，WorkBuddy支持调用本地Python脚本，并强制以标准输入流（stdin）方式传递数据，完全规避内存驻留。
1、编写Python脚本stream_processor.py，开头包含#!/usr/bin/env python3，主体使用for line in sys.stdin:循环处理。
2、在WorkBuddy中输入指令：“运行脚本D:\scripts\stream_processor.py，将D:\data\events.jsonl的内容以流方式传入，结果保存至D:\output\enriched.csv”。
3、确保脚本所在目录已加入系统PATH，且Python版本为3.9+（WorkBuddy v3.2.x仅兼容此范围）。
4、执行时，WorkBuddy将启动子进程并建立管道连接，原始文件内容以chunk形式持续写入stdin，脚本输出实时重定向至目标路径。
