workbuddy处理tb级文件时性能瓶颈的四大优化方案：一、启用本地缓存分层与ssd加速；二、配置外部分布式文件系统挂载点；三、启用只读共享卷与元数据代理模式；四、调整文件句柄与异步io线程池参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy处理大规模本地文件集（如TB级项目归档、多源日志仓库或媒体资产库）时遭遇响应延迟、任务挂起或磁盘I/O瓶颈，则可能是由于WorkBuddy默认依赖单机本地文件系统，未适配高吞吐、高并发的存储访问模式。以下是针对大数据量存储场景的优化配置方案：
一、启用本地缓存分层与SSD加速策略
该方法通过构建内存+SSD+HDD三级缓存结构，将高频访问的元数据、索引文件及最近操作文件热区优先落盘至高速存储介质，显著降低大目录遍历与批量读取延迟。
1、关闭WorkBuddy并确认所有进程已退出。
2、定位本地工作空间目录：Windows用户进入%APPDATA%TencentWorkBuddyWorkspace；macOS用户进入~/Library/Application Support/WorkBuddy/Workspace/。
3、在该目录下新建名为.cache_layer的子文件夹，并将其符号链接至一块已挂载的NVMe SSD根路径（Windows需使用mklink /D，macOS使用ln -s）。
4、启动WorkBuddy后，进入「设置」→「高级存储」→「缓存路径重定向」，将“索引缓存”与“临时解压区”两项路径均指向.cache_layer目录。
5、勾选「启用元数据预加载」与「跳过NTFS/AFPS权限扫描」（仅限可信内网环境）。
二、配置外部分布式文件系统挂载点
该方法允许WorkBuddy将指定任务路径直接映射至CephFS、GlusterFS或腾讯云COSFS等分布式存储后端，实现跨节点统一命名空间访问，规避单机磁盘容量与IOPS限制。
1、确保目标分布式文件系统已部署就绪并可通过FUSE协议挂载（如CephFS需ceph-fuse，COSFS需cosfs工具）。
2、在宿主机执行挂载命令：Linux示例为sudo cosfs my-bucket /mnt/cosfs -ourl=https://cos.ap-shanghai.myqcloud.com -odbglevel=info；Windows需使用RaiDrive或WebDAV网关方式挂载为网络驱动器。
3、启动WorkBuddy，在主界面点击左上角「文件」→「添加工作区」→「自定义挂载路径」，输入已挂载的/mnt/cosfs或Z:等路径。
4、在弹出的权限确认窗口中，勾选「允许读取全部子目录」与「启用异步文件状态轮询」，点击授权。
5、后续所有对该路径下的操作（如批量分析、OCR提取、迁移规划）均由WorkBuddy直连分布式存储接口执行，不再经过本地磁盘中转。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、启用只读共享卷与元数据代理模式
该方法适用于多实例WorkBuddy协同场景（如团队共用NAS），通过分离元数据服务与数据块访问，避免多客户端同时扫描同一目录引发的锁竞争与重复索引开销。
1、在NAS或分布式存储管理后台启用SMB 3.1.1或NFSv4.2协议，并创建专用只读共享卷（例如\nasworkbuddy-readonly）。
2、在每台运行WorkBuddy的终端上，以只读方式挂载该共享卷（Windows使用net use R: \nasworkbuddy-readonly /readonly；macOS使用mount_smbfs -N //guest@nas/workbuddy-readonly /Volumes/readonly）。
3、进入WorkBuddy「设置」→「AI模型管理」→「文件系统代理」，开启「元数据缓存代理」开关。
4、点击「新建代理规则」，将挂载路径R:或/Volumes/readonly设为目标路径，选择「启用轻量目录树快照」与「禁用实时inode监控」。
5、保存后，WorkBuddy将首次全量扫描生成本地元数据快照（.wbmeta文件），后续仅按需拉取变更项，大幅减少对共享存储的探测请求频次。
四、调整文件句柄与异步IO线程池参数
该方法通过扩大系统级资源配额与优化WorkBuddy内部调度队列，支撑单次处理数万级小文件或百GB级单文件的连续流式读写需求。
1、Windows用户以管理员身份运行PowerShell，执行：Set-ItemProperty -Path "HKLM:SYSTEMCurrentControlSetControlSession ManagerMemory Management" -Name "LargeSystemCache" -Value 1；随后执行cmd /c "fsutil behavior set disablelastaccess 1"。
2、macOS用户在终端执行：sudo sysctl -w kern.maxfiles=65536；sudo sysctl -w kern.maxfilesperproc=65536；并编辑/etc/launchd.conf添加setenv ULIMIT_NFILES 65536。
3、定位WorkBuddy安装目录下的config.json文件（Windows在安装路径 esourcesppconfig.json；macOS在WorkBuddy.app/Contents/Resources/app/config.json）。
4、在"storage"对象内新增字段："max_open_files": 32768,"io_thread_pool_size": 16,"enable_mmap_read": true。
5、保存文件后重启WorkBuddy，新参数将在初始化阶段加载生效。
