WorkBuddy实战：AI任务栏、连接器与自动化任务配置指南

1. 先把整套东西的骨架想清楚我大概是去年下半年把 WorkBuddy 装进日常主力机的。最初动机特别朴素——我想要一个按一下快捷键就能弹出来、还能顺手读到我桌面上一堆草稿的输入框。用了两周之后我发现真正拖慢效率的从来不是“问它什么”而是“它拿不到我的上下文”“我得手动把东西搬过去”“每次都要重新开一个窗口”。于是 AI 任务栏、Skills 技能市场、连接器、自动化任务、资料库这几块我就一块一块拆开啃了下来中间踩的坑不少索性整理成一篇能照着做的记录。这篇东西适合三类人第一类是刚装上 WorkBuddy、只把它当聊天框用的新手看完至少能把快捷键、模型通道、数据目录这几件事配明白第二类是想把团队里的重复劳动交出去的开发者或运维重点看连接器、自动化任务和通讯端接入三章第三类是被“AI 助手”这个词忽悠过好几次、想知道这东西到底能落到什么程度的人我建议先看第 1 章和第 10 章判断一下值不值得投入时间。1.1 它到底在解决什么问题很多人对这类工具的期待是“更聪明的搜索框”用两天就放弃了原因是每次交互的成本太高切窗口、复制、粘贴、等结果、再复制回去。一段本来三分钟能写完的邮件来回搬运反而花了五分钟。WorkBuddy 这类桌面端助手真正的价值不在模型本身而在于把“调用 AI”这个动作的摩擦压到接近零——快捷键弹出、当前窗口内容自动带上、结果一键回填。我自己的体感是交互摩擦每降一档使用频率会翻好几倍。从“打开网页、登录、粘贴”到“按一下快捷键”看起来只是省了几秒但心理门槛完全不一样前者你会攒着问题一起问后者你会随口就问。而 AI 这东西的价值恰恰在“高频小问题”上攒着问反而问不出好东西。所以我在配置这套东西的时候判断标准一直是一条这个设置能不能让我少一次窗口切换。凡是需要我离开当前工作现场的操作优先级一律往后排。1.2 六个组件是怎么串起来的标题里提到的这几个模块其实不是并列关系而是一条完整的调用链。我按自己的理解重新排一下你对着这个顺序去配会比东一榔头西一棒子顺很多AI 任务栏是入口层负责“什么时候被唤醒、带着什么上下文被唤醒”。Skills 技能市场是能力层把“总结一份会议记录”“把这段 JSON 转成表格”这类固定套路封装成可复用单元避免每次重新写提示词。连接器是数据层解决“助手够不够得着你的文件、日历、笔记、数据库”。资料库是记忆层把长期要用的文档做索引支持语义检索避免每次都靠人肉贴材料。自动化任务是调度层把“每天九点汇总待办”“每周五生成周报草稿”这类动作交给定时器。通讯端接入是分发层让助手出现在团队群聊里别人不用装客户端也能用。我一开始只配了入口层和能力层用着还行但总觉得“聪明归聪明跟我没关系”。直到把连接器和资料库接上它才开始能说出“你上周那份方案里提到的三个风险点”——那一刻才算真正用起来。后面加自动化任务和通讯端接入本质是把“我要主动去问”变成“它主动来找我”这一步跨过去之后工具才真正嵌入工作流。1.3 三种部署思路先想清楚再动手在装之前有个绕不开的选择模型跑在哪儿。这事没有标准答案但有三条常见路线我把自己的对比整理成表你按实际情况挑。方案适用场景优点代价全本地模型材料不能出内网、断网也要能用数据不出机器响应快显存要求高长文本和复杂推理明显吃力全云端模型个人使用、内容敏感度低能力上限高装机零门槛依赖网络按量计费长文档成本不低混合双通道绝大多数实际场景简单任务走本地、复杂任务走云端需要花时间划清分流规则我最后落在混合模式上分流规则很简单涉及格式整理、摘要提取、翻译、改写这类“短输入短输出”的活全部丢给本地小模型涉及长文档理解、多步推理、写代码这种才走云端。这么切的原因是本地模型在短任务上的延迟优势非常明显基本是按下快捷键就出字而云端往返加上排队体感差一截。这里有个容易被忽略的成本细节云端按 token 计费而你每天真正烧 token 的往往不是那些“大问题”而是几十次“帮我把这句话改通顺”。我统计过自己一周的调用短任务占了总次数的八成以上但只占成本的不到两成。反过来如果全部走云端那八成次数带来的等待时间会把你劝退。所以分流不是为了省钱主要是为了省注意力。2. Windows 与 Mac 的安装差异别在第一步就翻车安装这件事本来不值得单开一章但我在不同机器上装过七八次遇到的问题五花八门尤其是 Mac 那边的芯片架构和系统权限新用户第一次装基本都要卡一下。这一章把两边分开讲你对着自己那台看就行。2.1 Windows安装包格式和几个必查项Windows 侧一般会提供两种安装包.exe的引导安装和.msi的静默安装。个人机器直接下.exe就行一路下一步。如果你要给团队批量部署.msi更合适可以用命令行带参数静默安装msiexec /i WorkBuddy-x64.msi /qn INSTALLDIRD:\Apps\WorkBuddy ALLUSERS1几个我踩过的坑第一别装在系统盘默认路径。这东西的模型缓存、资料库索引、日志加起来用一个月轻松吃掉十几 G。默认路径在C:\Users\用户名\AppData\Local\ProgramsC 盘紧张的话会很痛苦。装的时候手动改到数据盘后面省心。第二安装完先别急着登录检查一下运行库。部分版本依赖 WebView2 运行时如果系统里是老版本或者干脆没装主界面会白屏。表现是托盘有图标、点开一片空白。这种情况去系统里查一下已安装程序把运行时更新到最新即可。第三杀毒软件可能拦本地模型加载。这不是误报本地推理会加载.gguf之类的模型文件某些安全软件对“程序加载大体积二进制文件”比较敏感。遇到加载失败先看安全软件的拦截记录把 WorkBuddy 的安装目录和数据目录都加进白名单。第四快捷键冲突。默认的呼出键在部分笔记本上会和输入法切换、截图工具打架。第一次启动如果按了没反应先去设置里换成CtrlShiftSpace这类组合别怀疑是软件没装好。2.2 Mac芯片架构和那三道权限门Mac 这边第一个岔路口是芯片。Apple SiliconM 系列务必下 arm64 版本Intel 机器下 x64。装错了不是不能跑但会走转译层本地推理速度直接打对折还容易发热。判断方法很简单左上角苹果图标 → 关于本机看“芯片”那一行写的是 Apple 还是 Intel。.dmg拖进应用程序文件夹之后第一次打开大概率会遇到“无法验证开发者”的提示。这是正常的去系统设置的隐私与安全性里找到被拦下的那条记录点“仍要打开”即可不需要其它操作。真正需要耐心的是权限。WorkBuddy 想用得顺手至少需要三样辅助功能权限——用于读取当前窗口选中文本、模拟按键回填结果。不给的话任务栏能弹出来但“选中即问”用不了。屏幕录制权限——用于截屏理解比如让它看一张图表。不给也能用只是截图相关技能会失败。完全磁盘访问权限——如果你打算把资料库指向整个文稿目录。只索引特定文件夹的话这一条可以不给用“文件与文件夹”里的精细授权更稳妥。我给的建议是先只给辅助功能用一周确认自己真的会用到截图和全盘索引再补后两个。权限这东西给出去容易收回来要重新走一遍流程没必要一上来全开。2.3 首次启动的六项必做配置不管哪个平台第一次启动后的十分钟决定了后面几个月顺不顺。我固定会做这六件事改数据目录。设置 → 存储把模型缓存、索引、日志三项都指到非系统盘。改完重启一次确认新目录下真的生成了文件。配模型双通道。本地模型选一个参数量在你显存能扛住的云端填好接口地址和密钥。密钥别写在配置文件里明文用系统钥匙串存。设定分流规则。在模型设置里加一条规则输入 token 小于 800 且不含附件时走本地否则走云端。改呼出快捷键。选一个不和你常用软件冲突的组合。关掉开机自启的托盘常驻如果你不打算长期挂着。这东西常驻内存大概占 300–500MB老机器上能省则省。建一个空资料库先不索引任何东西。等第 8 章配好清洗规则再往里灌能省掉一次重建索引的时间。提示所有配置改完之后去设置里找一下“导出配置”功能存一份 JSON 到网盘。换机器的时候导入能省掉大半小时。注意导出的配置里可能包含连接器凭据别随手发给别人。2.4 目录结构出问题时第一个要看的地方很多人一出问题就到处问其实日志和配置都在固定位置自己看两眼比问十句管用。平台配置日志模型缓存Windows%APPDATA%\WorkBuddy\config%APPDATA%\WorkBuddy\logs自定义默认在%LOCALAPPDATA%\WorkBuddy\modelsmacOS~/Library/Application Support/WorkBuddy/config同目录下logs默认~/Library/Caches/WorkBuddy/models日志默认按天切分保留七天。排查问题时重点看main.log里的[connector]和[skill]前缀行百分之八十的失败原因都在这两类里。3. AI 任务栏把入口压缩到一次快捷键这是整个工具里我使用频率最高的部分也是最多人配完之后“感觉没什么用”的部分。差别往往不在软件而在你怎么用它。3.1 交互模型它不是聊天窗口刚上手的人容易把任务栏当成一个悬浮的聊天框输入一句话等回答看完关掉。这么用效率提升有限因为你还是在“聊天”。我摸索出来的用法是把它当成一个带上下文的命令输入行核心是三个动作带上下文呼出呼出时自动抓取当前窗口的选中文本作为隐式输入。短指令直出输入不是完整句子而是“翻译”“精简一半”“转成表格”这种动词短语。结果回填生成完按一下回填键直接替换掉原选中内容不用复制粘贴。这三个动作串起来一次改写就是“选中 → 快捷键 → 敲三个字 → 回车 → 回填”全程手不离键盘两三秒。这才是我装它的意义。有个细节值得说上下文抓取有长度上限默认好像是 4000 字符。超出部分会被截断而且是从尾部截断意味着长文档的前半段会丢。如果你经常处理长文去设置里把上限调高或者干脆用“附加文件”的方式喂进去。3.2 快捷键与场景化配置除了全局快捷键任务栏还支持“场景配置”也就是不同的前台应用自动切换不同的默认技能。这个功能我用得很多配置逻辑大概是这样scenes: - match: app: Code # 代码编辑器 default_skill: code-explain model: cloud-large - match: app: Mail # 邮件客户端 default_skill: email-polish model: local-small - match: app: Notes default_skill: note-summarize model: local-small配好之后在编辑器里呼出默认就是“解释这段代码”在邮件客户端里呼出默认就是“润色这封邮件”少一次选择动作。别小看这一下选择本身是有成本的尤其是在你已经想好要干什么的时候还要在一堆技能里挑很容易就烦了。我的建议是先配三个最高频的场景用两周看看命中率再加。一上来配十几个最后你自己都记不住哪个应用对应哪个技能。3.3 一条指令写得好不好差别真的很大我观察过身边同事用类似工具的方式发现效果差异主要来自指令写法。举几个我常用的对照弱指令强指令差别在哪帮我改一下保持原意把这段压到 120 字以内去掉形容词给了目标和约束总结这个用三个要点总结每点不超过 30 字保留数字给了格式和长度翻译成英文翻译成英文商务书面语保留专有名词原文给了语域和例外规则规律很简单告诉它“输出长什么样”比告诉它“做什么”更重要。模型不缺理解力缺的是对你期望的形态的感知。我现在写任务栏指令基本是条件反射——先说输出格式再说约束最后才是内容要求。还有个小技巧任务栏支持指令模板可以把你常用的指令存成快捷词。比如把上面那条改写指令存成#压以后输入#压加回车模板自动展开。这个功能藏得比较深在设置的“快捷指令”里值得花十分钟配一批。4. Skills 技能市场从装别人的到自己写Skills 这个概念听起来玄说白了就是“预配置好的提示词 工具调用 输入输出约定”打包成一个可复用的单元。市场里现成的很多但真正好用的往往是你自己按工作流写的。4.1 市场里的三类技能先分清再装我把市场里的技能大致分成三类装之前先归类能省掉很多无用安装纯提示词型只做文本变换比如润色、翻译、改写语气、提取要点。这类最安全不碰你的文件装了就能用。带工具调用型会读文件、写文件、查数据库、调接口。这类要重点看它申请了什么权限尤其是写权限。带外部服务型需要绑定第三方账号比如日程、笔记、代码托管。这类最少装因为一旦服务方接口变了技能就废了而且凭据管理麻烦。我的原则是纯提示词型随便装带工具调用的挑着装带外部服务的能不装就不装。装之前看一眼详情页的“所需权限”那一栏如果只是“总结一段文字”却申请了文件写入权限直接跳过。4.2 安装、版本与依赖管理技能安装这块有两个坑值得提前讲。第一个是版本漂移。市场里的技能会更新而更新有时候会改输入参数。你昨天还跑得好好的自动化任务今天报“缺少参数 tone”八成就是技能升级了。我的做法是给生产用的技能锁版本在技能设置里关掉自动更新需要的时候手动升升之前先在一个测试任务上跑一遍。第二个是依赖冲突。有些技能依赖特定的连接器或者资料库存在。你装了一个“基于团队知识库回答”的技能但资料库是空的跑起来就一直返回“未找到相关内容”看起来像坏了其实是前置条件没满足。详情页往下拉一般有“依赖”一节装之前扫一眼。技能多了之后管理会乱我给自己的规矩是同时启用的技能不超过十二个按“每天用”“每周用”“备用”分三组备用组默认禁用。启动时加载的技能越少任务栏弹出越快这个体感差异在机械硬盘的机器上尤其明显。4.3 手写一个技能从二十行 YAML 开始写技能比想象中简单。我最常用的那个“周报草稿”技能核心就二十来行。贴出来给你做个参考name: weekly-draft version: 1.2.0 display_name: 周报草稿生成 description: 根据零散记录生成结构化周报草稿 trigger: type: manual alias: #周报 inputs: - key: raw_notes label: 本周记录 type: text required: true - key: tone label: 语气 type: enum options: [简洁, 正式, 汇报] default: 简洁 tools: - doc.search # 允许检索资料库 - file.read # 允许读取指定文件 prompt: | 你是一名工程师正在写周报。请基于以下素材生成草稿。 要求 1. 分本周完成进行中风险与阻塞下周计划四段 2. 每段不超过四条每条一句话不超过 40 字 3. 语气{{tone}} 4. 不要编造素材里没有的内容信息不足处写待补充 5. 涉及数字的地方原样保留 素材 {{raw_notes}} output: type: markdown save_to: ~/WorkBuddy/outputs/weekly-{{date}}.md preview: true几个写作要点都是我改了好几版才定下来的prompt里必须有“不要编造”这条。不写的话素材里没提的东西它会自己补补得还挺像那么回事但你不能拿去用。output.save_to用日期变量。这样每次跑都生成新文件不会互相覆盖。第一次写的时候我忘了加结果一周的草稿全被最后一天覆盖了。preview: true一定要开。生成完先给你看一眼再落盘改起来方便。关掉的话就是直接写文件出问题只能去翻历史。枚举类型的输入别给太多选项。三个正好超过五个用户每次都要想一下反而不如直接写在提示词里。技能写完之后可以导出成.zip分享给同事导入方不需要任何配置只要把依赖的连接器接上就能跑。我们组里现在有五个共享技能都是这类小东西加起来省的时间不算多但省的是那种“又要从头想一遍格式”的心力。5. 连接器让助手真的够得着你的东西这是我认为投入产出比最高的一章也是最容易被跳过的一章。很多人配完任务栏就停下来了觉得“它不知道我的情况”问题就出在这儿。5.1 连接器解决的是“够得着”不是“更聪明”打个比方模型是一个能力很强的实习生但它被关在一间没有窗户的房间里。你隔着门跟它说话它只能回答通用问题你把门打开让它能翻你的资料柜它才能说“你上个月那份方案里提过同样的风险”。连接器就是那扇门。它把外部数据源暴露成统一接口让技能在运行时可以按需取用。常见的几类文件系统指定若干目录支持读取写入需要单独授权。本地数据库只读连接支持查询不支持 DDL。日历与待办读取日程用于时间相关的自动化。笔记与文档库按标签或目录抓取。代码仓库只读拉取用于代码解释类技能。我自己的配置是三个工作文档目录只读、笔记库只读、日历只读。一个写权限都没开。原因很简单我只在“确认无误、可以落盘”的场景才需要写而这种场景我宁愿手动复制过去。开着写权限万一哪个技能逻辑有问题改错了文件都不知道什么时候改的。5.2 三个连接器的具体配置文件系统连接器配置最直观{ type: filesystem, name: 工作文档, root: D:/Work/Docs, permissions: [read], include: [**/*.md, **/*.txt, **/*.docx, **/*.pdf], exclude: [**/node_modules/**, **/.git/**, **/~$*], max_file_size_mb: 20 }exclude那几行别省。我一开始没写索引把某个项目里的依赖目录全扫进去了几万个文件索引跑了四十分钟检索结果里全是无关的库文件。加上排除规则之后同样的目录三分钟跑完。数据库连接器要注意的是账号权限。专门建一个只读账号只授权需要的库和表别图省事用 root。连接串里的密码不要写死在配置里用连接器的“凭据引用”功能指向系统钥匙串里的条目。日历连接器最简单授权一次就行。它的价值主要在第 7 章的自动化任务里——比如每天早上把今天的会议整理成一份准备清单。5.3 只读与写入的边界我给自己定的三条规矩能不写就不写。除了明确知道自己在干什么的场景一律只读。写权限的调试成本远高于它省下的时间。写操作必须有预览。任何会落盘的技能preview一律设为true。多按一次回车的事能避免九成的误操作。写入路径必须是白名单目录。不要把写权限开到整个磁盘指定一个outputs目录所有产出都往那儿扔定期清理。注意连接器的凭据一旦泄露等于把对应数据源的读取权限交出去了。定期在设置里检查“已授权的连接器”把三个月没用过的删掉这是个好习惯。6. 企业通讯端接入把助手放进群里标题里提到的那两个即时通讯平台为了不写成一堆品牌名下面统一叫“企业通讯端”和“个人通讯端”。这块的读者主要是想把助手分享给团队的人配置比前面几章麻烦但收益也最直接——同事不用装客户端在群里 一下就能用。6.1 接入前先想清楚三件事第一用谁的机器人身份。企业通讯端接入需要一个应用凭证通常由管理员在后台创建拿到一组类似“应用标识 密钥 回调地址”的东西。这意味着你得先找管理员开通权限个人账号是建不了企业级应用的。如果只是想小范围试试用个人通讯端的机器人接口更轻量但能力受限比如不能主动推送、不能在群里被 。第二回调地址从哪来。平台需要能主动把消息推给你所以你得有一个外部可达的地址。开发阶段常见的做法是先在一台有独立域名的测试机上部署一个轻量服务把平台的消息转发到本地。注意这个地址要走 HTTPS且平台侧通常要求配置 IP 白名单白名单里填你服务器的出口地址。第三消息量级和响应时延。群里人多的时候一轮对话可能触发十几条消息。如果每次都走云端大模型响应会排队体验很差。我的做法是加一层前置判断命中常见指令查文档、查日程、看状态走本地或缓存只有真正的开放问题才走云端。6.2 一步步配通整个流程我走过三遍步骤大同小异在平台后台创建应用勾选“机器人”能力记录下应用标识和密钥。配置回调地址填你部署好的 HTTPS 入口token 随便设一个足够长的随机串两边保持一致。配置权限范围只勾选“接收消息”“发送消息”“读取群成员基础信息”这三项别多勾。权限越大审核越慢出问题的面也越大。在 WorkBuddy 侧新建通讯端连接填入上面三样选择“启用”。在测试群里把机器人拉进去 它说一句话看后台日志有没有收到回调。验证签名。这一步最容易失败平台推过来的消息带签名WorkBuddy 侧需要按同样规则算一遍比对。对不上就会一直返回 403日志里能看到。第二步和第六步是失败高发区。回调地址最常见的问题是“平台侧能访问但你本地看不到日志”这种情况八成是请求没打到你部署的服务上检查一下域名解析和端口映射。签名对不上的话先确认编码格式有的是 URL 编码有的是原始串和拼接顺序这两点各平台规则不一样照着文档对一遍字符。6.3 权限收敛和一些必须守住的线通讯端接入这块我的态度比较保守几条线不动只接内部群不接外部群。外部群成员不可控你没法保证进去的东西适合给所有人看。默认不带上下文。群聊里 它时默认只处理本次消息内容不自动带上资料库检索结果。要查资料得显式用指令比如助手 查一下 XX 方案。这样能避免它把不该说的内容顺手贴到群里。敏感目录不进资料库。涉及个人信息、合同、财务明细的目录一律排除在索引之外。技术上做隔离比靠自觉可靠。留痕。开启会话审计日志保留至少 30 天。这不是为了查谁是为了出问题时能回溯是哪条指令导致的。还有一点经验别一上来就全公司推广。先拉一个五到八人的小群跑两周把高频问题和错误回复收集起来改技能提示词改到命中率能接受再往外放。我们第一版放出去的时候因为没限制上下文长度有人在群里发了一篇长文机器人回了整整二十条消息把群刷屏了场面很尴尬。后来加了“单次回复不超过 300 字”和“长内容转私聊”两条规则才好。7. 自动化任务从“我去问”到“它来找我”前面几章配完你还是得主动去呼出它。自动化任务这一步跨过去工具才算真正嵌进工作流——你不再需要记得“该问它了”它按时出现。7.1 三种触发方式各有各的适用面定时触发标准的 cron 表达式适合日报、周报、定期归档、定期检查。事件触发监听文件变化、连接器数据更新、通讯端收到特定指令。适合“文档一改就重新索引”“任务一建就生成拆解”。手动触发就是快捷键或者指令适合低频但重要的动作。我配的自动化任务不多一共五个但都是每天真会跑到的早上八点半汇总今日日程和待办、十点检查昨天没写完的草稿、周五下午四点生成周报初稿、每晚十一点备份资料库索引、每周一清理一次输出目录。数量控制在十个以内多了自己也记不住哪个在跑。7.2 一个可以直接抄的配置下面这个是我用了三个月的“每日晨间简报”稳定跑到现在没出过问题name: morning-brief schedule: 30 8 * * 1-5 # 工作日八点半 enabled: true timezone: Asia/Shanghai steps: - id: calendar skill: calendar-today params: range: today max_items: 10 - id: todos skill: todo-pending params: include_overdue: true - id: notes skill: doc.search params: query: 本周重点 top_k: 3 min_score: 0.35 - id: compose skill: brief-compose params: sections: [日程, 待办, 提醒] max_length: 400 output_channel: personal-im on_error: continue_with_warning几个参数值得解释schedule里的1-5是周一到周五周末不打扰。别小看这个我第一版写的是* * *结果周六早上八点半手机响了一下之后再也没睡好过。min_score: 0.35是检索相似度阈值。设太低会搜出一堆不相干的东西塞进简报设太高会经常搜不到。0.35 是我在两百多篇文档上试出来的平衡点你可以从 0.3 开始调。max_length: 400是硬约束。不设的话模型会越写越长早上根本没耐心看。on_error: continue_with_warning很关键意思是某一步失败就跳过继续跑后面的最后在末尾标一句“日程获取失败”。如果设成abort日历服务抽风一次你整个简报就收不到了。7.3 失败重试、日志和幂等自动化任务最容易出的问题不是逻辑写错而是“偶尔失败一次你根本没发现”。我的处理方式有三条加失败通知。任何自动化任务失败都往个人通讯端发一条消息哪怕只有一句“晨间简报生成失败原因日历接口超时”。不通知的话你会连续三天觉得“今天怎么没收到”然后才发现早就挂了。日志按任务分文件。默认日志是全局混在一起的任务一多就没法看。在任务配置里开log_per_task: true每个任务一个文件排查的时候直接打开对应那个。写操作必须幂等。如果你的任务会生成文件文件名一定要带日期或唯一标识。我吃过一次亏一个每周归档任务文件名固定是archive.md某次因为网络问题重试了三次最后那次把前两次的结果覆盖了前一周的数据丢了。现在所有输出文件名都带{{date}}-{{task_id}}。8. 资料库让它记住你自己那一亩三分地资料库是整个体系里最“重”的部分配好了价值极高配不好就是个噪音源。我用废过两个库第三个才算跑顺。8.1 索引之前先清洗这一步不能省第一次建库的时候我把整个工作目录直接丢进去了四千多个文件索引跑了一个多小时检索出来的东西乱七八糟——重复的旧版本、半成品草稿、导出的临时文件全在里面。后来我花了一个下午做清洗规则大概是这样只保留最终版本。文件名里带v1、v2、旧、备份、副本的全部排除。去掉过程文件。临时导出、截图、会议录音转文字的中间稿不进库。统一格式。把散落的.doc批量转成.docx扫描版 PDF 先做一次文字识别。识别不了的纯图片 PDF单独放一个目录不参与索引。补元数据。在文档开头加三行主题、时间、相关项目。这三行对检索效果的提升非常明显因为切片之后语义变得更聚焦。清洗这一步花了我大概四个小时但换来的是检索命中率肉眼可见的提升。值得。8.2 切片和检索参数怎么调资料库的核心是“切多大”和“取几条”。默认参数不一定适合你我给一组起步值参数建议值说明切片长度400–600 字符太短丢上下文太长稀释语义切片重叠60–80 字符防止一句话被切断在边界检索条数 top_k5–8太多会把噪声塞进提示词相似度阈值0.30–0.40低于阈值的结果直接丢弃重排开启多召回一些再重排效果好于直接截断我的配置是切片 512、重叠 64、初召回 20 条、重排后取 6 条、阈值 0.32。这个组合在两万多篇文档上跑下来回答“某份方案里提到的风险点是什么”这类问题基本能一次命中。提示切片长度和你的文档类型强相关。技术文档、合同这类结构化强的切片可以短一些散文、会议纪要这类上下文依赖强的切片要长。别指望一组参数打天下按目录分别建库反而更好。8.3 长期维护索引会腐烂资料库不是建完就完事的。文档在增删改索引会慢慢和实际内容脱节表现是“明明有这个文件但搜不到”或者“搜出来的内容是旧版本”。我现在的维护节奏是增量索引每天自动跑一次放在夜里只处理变更文件。全量重建每月一次放在周末顺便清理孤立切片。每季度做一次抽样检查随机挑十个问题看检索结果对不对不对就调参数。增量索引有个坑文件重命名有时候识别不出来会被当成“删除 新增”导致旧切片还在。解决办法是开启“按内容哈希去重”虽然会多花一点时间但能避免重复内容污染检索结果。另外提一句存储。向量索引占的空间比想象中大两万篇中等长度文档索引文件大概在 1.5–2GB 之间。放在固态盘上检索明显更快机械盘上第一次查询会有几秒的延迟。如果机器上有多块盘把索引目录指到固态那块。9. 常见问题速查下面这些是我和同事实际遇到过的问题按出现频率排。现象最可能的原因处理方式快捷键按了没反应被输入法或截图工具占用换组合键避开系统级热键主界面白屏缺少 WebView2 运行时更新运行时到最新版本本地模型加载失败安全软件拦截大文件加载安装目录和数据目录加白名单技能报“缺少参数”技能自动升级改了入参锁定版本或按新文档改配置资料库搜不到明显存在的文件该目录被排除规则命中检查exclude里的通配符检索结果全是旧版本索引未做内容去重开启按哈希去重重建索引通讯端返回 403回调签名校验不通过核对编码格式与拼接顺序通讯端收不到消息回调地址不可达或 IP 未加白检查域名解析与白名单自动化任务时好时坏依赖服务偶发超时设on_error为继续执行并加告警输出文件互相覆盖文件名未带唯一标识文件名加日期和任务 ID任务栏弹出卡顿启用技能过多加载慢精简到十二个以内分组禁用云端调用费用突增长文档走了云端通道调整分流规则的 token 阈值几个表格里写不下的补充说明一下“主界面白屏”这个问题排查顺序是先看运行时再看显卡驱动最后看是否被安全软件拦了网络请求。三步走完基本能定位别一上来就重装。“技能报缺少参数”别急着改自己的配置。先去市场看该技能的更新日志八成是版本变更导致的。如果确实需要旧行为在技能设置里回滚到上一个版本同时关掉自动更新。“自动化任务时好时坏”这类问题最难查因为失败不连续。我的做法是给每个任务加一个“执行摘要”记录每一步的耗时和返回码跑一周之后看统计哪个步骤耗时波动大就是它。10. 一些不太适合写进文档的经验折腾这套东西大半年有几个体会是文档里不会写、但我觉得比配置本身更重要的。第一别一上来就追求“全自动”。我最初的想法是所有重复劳动都交出去结果配了十几个自动化任务每天要花时间看哪些跑失败了反而更累。后来砍到五个全是那种“不做会烦、做了就省心”的才稳定下来。判断标准很简单这个任务如果失败了我会不会立刻发现会就值得自动化不会就先别做不然它坏了你都不知道。第二提示词的质量决定一切模型只是上限。同一件事我写的技能提示词改过五版每一版的输出质量都有明显差别。改的方向无非三个说清楚输出格式、给出反例、加一句“信息不足时说明而不是编造”。这三条加上去基本能从“看着还行”变成“直接能用”。第三权限和便利永远在拉扯我倾向于先紧后松。一开始只给最小权限用着觉得某处确实卡住了再单独放开那一项。反过来做先全开再收紧几乎不可能因为一旦习惯了便利你会找各种理由不去收。第四留一条“手动通道”。不管自动化配得多顺我都保留最原始的方式快捷键呼出、手动输入、手动复制结果。工具挂了、接口变了、网络不通的时候这条通道永远能用。这不是保守是给自己留个不慌的底。最后分享一个小技巧我给自己的资料库建了一个特殊目录叫“复盘”里面只放一类文件——每次工具出问题后写的简短记录三五行写清楚现象、原因、怎么解决的。半年下来攒了四十多条现在遇到新问题先去这个目录搜一下命中率意外地高。工具越用越顺手靠的往往不是配置多精妙而是这些一点点攒下来的、只属于你自己的经验。