工作空间与上下文：@引用、截图、文件怎么喂给 AI
讲解 WorkBuddy 的四种补充上下文方式——选工作空间、@引用、粘贴截图、上传文件，以及任务描述的四要素。
客户最广、也最冤的一次抱怨是："我跟它说得很清楚了，它做出来的东西跟我说的不是一个东西。"
我去看了一遍对话记录。他说的是"根据去年的年报做个总结"。年报在桌面一个叫"2025终"的文件夹里，旁边还有"2024终""2023终""临时""备份"四个文件夹。他没说哪个文件夹，也没拖文件进来，默认目录下什么都没有——AI 只能凭空写。
结果准不准，很大程度取决于你喂给 WorkBuddy 的上下文够不够。
1. 先选工作空间：目录选错，后面全白干 #
点输入框左下角的选择工作空间，指定当前任务要使用的目录。选完之后，WorkBuddy 会基于这个目录读取和处理文件；你也可以直接开始任务，它会在默认目录中生成结果。
实战中我的规矩：
- 一个客户一个目录：
D:\交付\客户名\年份\项目，目录名只用字母、数字、下划线。 - 旧资料先归档再喂：别让它在一个塞了二十个版本的目录里猜。
- 别拿桌面当工作空间：桌面文件又多又杂，还容易被系统清理掉。
2. 引用上下文（@）：把素材"点名"给它 #
在任务描述里用 @ 引用文件、文档、规则等信息，让 WorkBuddy 精准定位素材，而不是在整台机器的文件里瞎找。
适合这么用：
@2025年度总结.docx 按这份的格式重写@这份报价表的第三列 帮我算同比- 引用规则类说明，让它按你们公司的模板出稿
一句话记住：能 @ 的就不要只写文件名。
3. 粘贴截图：最省事的一种喂法 #
用 Ctrl / Cmd + V 直接把剪贴板里的图片粘进输入框，适合"按这个图改""这段文字什么意思""这个报错你帮我看看"这类需求。
现场最常见的是这两类：
- 客户发来的表截图，格式乱、有合并单元格，直接粘进去让它重排。
- 系统报错窗截图，粘进去比打字描述准确十倍。
4. 上传文件：拖进去就行 #
点上传按钮，或者直接把文件拖到输入框区域。支持 PDF、Word、TXT、Markdown、RTF、Excel、CSV、TSV、PPT、常见图片（JPG/PNG/GIF/BMP）、ZIP/RAR 压缩包以及各类编程语言代码文件。
隐私边界要先讲清楚：所有文件处理默认在本地完成，原始数据不上传云端；服务端只处理数据片段，用后即弃，不保存也不用于模型训练；WorkBuddy 只能访问你主动勾选授权的文件夹，系统敏感目录自动拦截，高危操作需二次确认。所以涉及财务数据、客户名单的任务，选授权目录比全盘开放稳妥。
5. 任务描述的四要素 #
上下文补齐之后，还得把话说完整。官方建议优先补充这四样：
| 要素 | 要写清楚什么 | 反例 |
|---|---|---|
| 目标 | 要生成什么，或要处理什么文件 | "帮我整理一下" |
| 输入 | 需要分析的数据、参考的文档 | 什么都不提 |
| 输出格式 | Word / Excel / PPT / 其他 | "给我一份表" |
| 约束 | 风格、字数、截止时间 | 不提 |
同一份需求，补上四要素的区别是：前者给你一份"看着像"的东西，后者给你一份能直接发出去的东西。
提示词模板：不用自己憋 #
创建任务页按场景（日常办公、代码开发、设计创意）提供了一组提示词模板。把鼠标悬停在模板上（或用键盘聚焦模板按钮），输入框会即时显示该模板的灰色预览文案——输入框已有文字时，预览接在已有内容末尾，黑色原文保持不变；切换模板预览随之更新，移开鼠标、失去焦点或切换场景后预览自动清除。
灰字只是预览，不进草稿、不进撤销记录、也不会被发送；确认合适再点模板，内容才真正填进输入框。
推荐喂料顺序 #
- 选工作空间 → 2.
@引用关键文件 → 3. 缺的部分截图/上传补齐 → 4. 按四要素写完整描述 → 5. 发送，然后到结果区验收。
喂足了还是不对？三个自查 #
三种情况最常见，按顺序查一遍基本都能定位：
| 现象 | 先查什么 |
|---|---|
| 它引用了不存在的数据 | 工作空间选错，默认目录里根本没有那份文件 |
| 它只读了封面没读到正文 | PDF 是扫描件，缺文本层，先另存一份文字版 |
| 同一句话每结果都不一样 | 描述里没有"输出格式"和"约束"，它按自己理解来 |
第三种尤其值得记住：没有约束就没有一致性。你要求了 Word、要求了三页、要求了按公司模板，它就必须这么给；你什么都没要求，它每次换个样，你还会以为是它不稳定。
上下文的边界感 #
有两类内容不建议往里喂：一是客户身份证号、银行卡这类个人信息，二是还没定稿、后期可能推翻的草稿。前者没必要，后者喂进去它当真，等改稿时你还得提醒它"别用那份旧的"。
官方的说明是：所有文件处理默认在本地完成，原始数据不上传云端，服务端只处理数据片段，用后即弃。机制上是安全的，但"能存"不等于"该存"。
18 年运维踩过的坑 #
- 内网机器上喂外网素材：有些客户的机器只能上内网，素材在共享盘上。先把文件拷到本地工作空间再喂，别指望它跨网段读。
- U 盘里直接选工作空间：拔出 U 盘，任务就断了一半。用完立刻拷回本地目录。
- 压缩包喂不进去就先拆：大文件先压缩或拆分，反复失败再查网络。
- 老机器内存小：同时喂十几个大文件，Win7 那批机器会卡死。宁可分三次喂。
- 系统敏感目录自动拦截，遇到"访问被拒绝"先看是不是勾错了目录，而不是去关权限。
小结 #
"选对空间 + 给足上下文 + 讲清四要素"，是 WorkBuddy 出好活的三件套。下一篇讲怎么验收结果。
本文为 workbuddy.eycit.com 种子教程。