ARTICLE · 1269962
别再把AI当聊天框,给你的数字助手,搭一个真正的家
WORKBUDDY × macOS
个人工作台搭建与上下文工程全景指南
全流程实操 / 7 个模块 / 建议收藏后按章节落地
大多数人对 AI 工具的使用，都停在「找一个神级提示词」这一步。
提示词能解决一次问答，但它解决不了项目管理、多文件协作和长时程自动化。真正拉开效率差距的，不是你把提示词写得多漂亮，而是你有没有给 AI 搭一个稳定的家。
行业里正在发生的转变，是从提示词工程走向上下文工程：把智能体从对话窗口，改造成挂载在本地系统上的「数字员工底盘」。
下面这份指南面向 macOS 与 WorkBuddy，整合了三方实践：腾讯云 WorkBuddy 团队的工程经验、Anthropic 关于上下文工程的方法论、以及 GitHub 开源社区的落地做法。从目录重建、记忆配置、安全底线，一路讲到自动化驾驶舱。
目 录
01战略与原理：为什么要做上下文工程
02架构规划：7 类文件夹分区与 9 条底线
03实战部署：安装、权限与只读诊断
04资产沉淀：3 张高频任务卡模板
05闭环与自动化：驾驶舱与定时任务
06故障诊断：7 类高频问题对照
07总结：让工具适应你的工作流
01
这不是聊天软件是数字员工底盘
很多用户第一次打开 WorkBuddy，会下意识把它当成另一个 AI 聊天工具。这个认知偏差代价很大：它会把一个能动手干活的工作台，用成一个更贵的问答框。
它的底层设计逻辑是「任务 + 技能 + 工具」。两者的差别，几乎体现在每一个环节：
传统聊天机器人
一问一答，答完即止。无法读写你的本地文件系统，每次对话都要重新交代背景。它的能力上限，是你这一次提问写得多好。
WORKBUDDY 工作台
拥有自主规划、决策与工具调用能力。读得懂指令，能遍历工作区、读取 Markdown 背景文件、调用终端与脚本、操作本地文件，最终交付可验收的成果。
所以，搭工作台本质上是把自己的方法论、写作风格和决策逻辑资产化：固化成可复用的任务卡与上下文环境。搭一次，往后每天都在复用。
为什么上下文会「衰减」
大模型基于 Transformer 架构，自注意力机制要计算上下文中所有 Token 之间的两两映射，复杂度是 O(n²)。对话越长、载入的文件越多，窗口里的 Token 就膨胀得越快。
而模型准确提取信息、维持长链条推理的能力，会随着上下文变长而平滑下降。工程界给这个现象起了个名字：上下文衰减（Context Rot）。
换句话说，上下文不是取之不尽的物理空间，而是一种边际效益递减的稀缺资源。
上下文工程的目标，就是在有限的注意力预算里，构建一个「信号最强、体积最小」的信息环境，让模型始终盯住最关键的目标。
上下文生态的五大支柱
一个成熟的工作台，上下文生态由五块拼成。缺一块，Agent 就会在某个环节掉链子。
01系统提示词
定义 Agent 的长期身份、权限边界与思维框架。
实践 保持在「金发姑娘区」：既不过度硬编码逻辑，也不给过于模糊的抽象指导。
02持久记忆
存储个人背景、目标用户、表达风格与工作规则。
实践 在 01-我的资料 下建 5 份结构化 Markdown，随任务动态挂载。
03即时检索
运行时按需加载外部文件与接口数据，而不是一次全塞进去。
实践 保持轻量引用（绝对路径），由 WorkBuddy 执行时按需拉取。
04工具矩阵
赋予 Agent 读写文件、执行终端命令、协同软件的能力。
实践 工具定义自包含、强语义、低重叠，输入输出契约清晰。
05结构化输出
规定结果的交付形式：JSON、Markdown 还是表格。
实践 强制约束格式，下游脚本才好消费，驾驶舱才好展示。
长任务不崩的三个机制
碰上耗时很长、跨越几十次工具调用的任务，Token 总量几乎必然顶破窗口。要在工作流里预置这三个机制，而不是等它崩了再补救。
信息压缩 Compaction
接近上限时对历史做高保真总结：保留架构决策、未解决的错误与关键变量，清掉冗余的工具返回数据，带着浓缩摘要开新窗口。
结构化笔记 Note-taking
让 Agent 在上下文之外单独维护 NOTES.md 或 TODO.md。即使上下文被重置，重读这份笔记就能瞬间恢复全局进度。
子智能体 Sub-agent
主 Agent 只做高层规划，把吃 Token 的分支任务丢给子 Agent。子 Agent 只回传 1000 至 2000 Token 的浓缩结论，实现关注点分离。
02
先收拾房间再谈效率
搭工作台的第一步不是配提示词，而是建目录。把「路径不一致」「文件找不到」这类基础故障一次性消掉，等于给 Agent 一个稳定、可预测的地板。
根目录：只认一个地址
macOS 是 Unix 层次结构，路径区分大小写。为避免终端转义失败，路径里不要出现空格或中文特殊符号。强烈建议把工作台统一放在家目录下：
绝对路径
~/WorkSpace/Users/your_username/WorkSpace
别把工作区随手丢在「桌面」或「下载」里，也别一会儿用 ~/Documents/WorkSpace、一会儿用 ~/WorkSpace。路径混乱是 Agent 报 File Not Found 或 Permission Denied 的头号原因。
7 类文件夹的物理隔离
目标是让「原始素材」「背景资料」「处理过程」「交付产物」四件事彻底分开。一级目录严格划分为 7 类：
00-收件箱
待处理的微信文件、会议录音、客户资料、截图等原始素材。
01-我的资料
供 AI 长期读取的背景文件（我是谁、表达风格等）与常用任务卡。
02-进行中项目
按项目建子文件夹，例如公众号运营、课程研发、产品需求。
03-内容生产
选题库、文章草稿、短视频脚本、发布记录等创作材料。
04-日常办公
会议纪要、每日清单、周报、表格分析等运营文件。
05-交付成果
只存放已完成、可直接对外发送或调用的最终版。
06-归档
已结项项目整体移入，供复盘与历史案例检索。
5 份核心背景文件
在 01-我的资料 下建 5 份 Markdown，这就是你的长期记忆库。方括号里的内容按自己情况填。
①我是谁.md
# 个人背景与专业定位- 姓名/称呼：[你的名字]- 职业与岗位：[高级产品经理 / 内容创作者]- 核心专业领域：[擅长的事项与技术栈]- 当前核心关注点：[AI 智能化改造]- 个人偏好与禁忌：[讨厌冗长套话；喜欢结构化表格； 不希望 AI 代替做最终决策]- 希望 AI 重点协助的事项：[会议纪要提炼、提纲设计]
②我的目标用户.md
# 目标用户与受众画像- 核心受众群体：[职场新人、团队管理者、开发者]- 受众最头疼的痛点：[信息过载、工作琐碎、 缺少系统方法论]- 受众期望获得的结果：[开箱即用的模板、 清晰的操作步骤、降本增效]- 受众能听懂的表达方式：[大白话、通俗比喻]- 受众排斥的内容形式：[满篇专业黑话、 没有落地步骤的纯理论]
③我的表达风格.md
# 语言风格与输出规范- 整体基调：简体中文；直白口语化；专业但不端着。- 句式习惯：多用短句与清单；少讲抽象概念， 多给具体步骤；正文不使用破折号。- 事实规则：严禁编造经历、数据与案例； 不确定的信息标记为「待确认」。- 格式规则：标准 Markdown Heading； 列表用嵌套 -；重点内容加粗。- 参考范文：[粘贴 2 至 3 篇满意的文章， 供 AI 学习语气]
④我现在要做什么.md
# 当前阶段目标与项目状态（更新于 YYYY-MM-DD）- 本月最高优先目标：[完成工作台搭建并上线周报]- 本周必须完成事项： 1. [事项 A] 2. [事项 B]- 正在推进的项目：[项目名称 1]、[项目名称 2]- 暂不处理的事项：低优先级清单， 防止 AI 把不急的事列入今日重点- 需要我本人决策的事项：[需人工确认的节点]
⑤通用工作规则.md
这份最要紧，写的就是下面这 9 条底线。
9 条执行底线，一条都别省
这 9 条原样写进通用工作规则.md。它的作用不是限制能力，而是让 AI 的自主性变得可预测。
01复杂任务先出计划
超过 2 个步骤或涉及多文件操作，先输出步骤计划，等用户回复「确认执行」再动文件。
02缺失信息明确标注
信息或背景不足时直接列出缺失项，严禁凭空猜测、脑补数据。
03改文件前先报清单
预先列出本次将新建、修改或移动的具体文件路径。
04原始资料禁止覆盖
处理收件箱原始文件时保持原文件不动，结果另存到 04 或 05 目录。
05五大高风险动作必须确认
发布、付款、删除、覆盖文件、对外发送，一律请求二次确认，绝不越权。
06后台静默优先
调用终端或脚本时优先无界面静默运行，不得无故切到前台抢焦点。
07不抢用户输入焦点
不动鼠标、不占键盘，不在你正在打字的窗口里强行插入字符。
08无法后台就停手
遇到权限弹窗、卡顿或必须交互的情况，立即停止并汇报卡点，不要在前台硬折腾。
09收尾汇报四要素
做了什么；存在哪里（绝对路径）；怎么验收；还遗留什么。
AI 可以帮你高效执行但不能替你承担最终责任
发布、花钱、删文件、发消息，一律保留人工确认
03
装好、授权先做一次只读体检
安装与隐私权限
01下载安装
从官方渠道下载 macOS 版（Apple Silicon 与 Intel 都支持），拖进 /Applications 完成安装。
02打开系统设置
系统设置 → 隐私与安全性。
03授予完全磁盘访问权限
在「完全磁盘访问权限」中勾选 WorkBuddy。否则读取工作区以外的文件或执行终端命令时，会频繁触发 Operation not permitted。
04按需授予辅助功能
需要跨应用协同时，在「辅助功能」中同步勾选授权。
只读诊断：别急着让它干活
登录后先绑定工作区：主界面选择「工作空间 / 选择文件夹」，导航到 ~/WorkSpace 并确认。然后发一条纯只读的诊断指令，验证它的读取能力。
诊断指令
请查看当前工作空间的文件结构，仅做读取，不要新建、修改、移动或删除任何文件。请告诉我：1. 当前工作区的完整 macOS 绝对路径是什么？2. 你看到了几个一级子文件夹？3. 01-我的资料 目录下有哪些文件（列出文件名）？4. 如果有任何内容无法读取或找不到，请明确说明。
然后逐项核对：
□绝对路径准确指向 /Users/your_username/WorkSpace
□准确识别出 7 个一级子文件夹
□完整列出 01-我的资料 中的 5 个 .md 文件
三项全对，才允许进入复杂任务。
系统总指令：六要素解耦模型
在「自定义指令」里，用六要素把提示词拆开写。别写成一大段散文，模型读不出结构，你也改不动。
SYSTEM PROMPT
# 角色 Persona你是一名专业、可靠的个人 AI 工作台数字助手，熟练掌握 macOS 文件管理与工作流自动化。# 任务 Task协助用户管理日常工作流：读取收件箱素材、整理今日清单、跟踪项目进展、撰写内容提纲。# 背景 Context你挂载在 ~/WorkSpace 下。每次执行任务前必须优先读取 01-我的资料 下的 5 份背景资料，确保输出契合用户的真实需求。# 输入数据 Input用户输入的指令、引用的任务卡，以及各子文件夹中的实际文件内容。# 输出格式 Format- 默认采用规范 Markdown 输出。- 分析与计划必须结构化，多用表格与编号列表。- 文件交付时必须给出 macOS 绝对路径。# 质量与约束 Constraints- 严格遵守 通用工作规则.md 中的 9 条底线。- 涉及文件改动时，遵从「先计划，后执行」。- 严禁编造数据或虚构履历；信息不足时标注 「待确认」。
04
把重复劳动封成三张卡
高频场景的执行逻辑不该每次重打一遍。把它们资产化，存到 01-我的资料/常用任务卡/ 下。以后只需一句「引用任务卡①」。
①今日工作清单
# 任务卡：生成今日工作清单## 1. 触发要求当用户说「生成今日清单」时引用本卡。## 2. 读取上下文- 读取 01-我的资料/我现在要做什么.md- 读取 00-收件箱/ 目录下的全新原始文件## 3. 处理逻辑1. 梳理收件箱新增文件与聊天记录，提取待办。2. 对比阶段目标，筛出今天最重要的 3 件事。3. 按「已延期 → 今日截止 → 时间序」排序。4. 每项标注：任务名称、截止时间、下一步行动、 风险与待确认事项。## 4. 输出与交付- 先输出拟定清单，等用户确认。- 确认后保存至 04-日常办公/每日计划/ YYYY-MM-DD-今日工作清单.md
②内容创作
# 任务卡：公众号与深度内容创作## 1. 触发要求当用户提供选题并要求「撰写文章」时引用本卡。## 2. 读取上下文- 我是谁.md- 我的目标用户.md- 我的表达风格.md（严格遵循文风与禁忌）## 3. 执行步骤1. 第一步（严禁跳过）：基于素材与用户痛点， 输出选题分析、文章立意、核心金句、章节提纲。2. 第二步：等待用户审核修改提纲。3. 第三步：确认后再写完整正文。 保持口语化与短句节奏。## 4. 输出与交付- 保存至 03-内容生产/文章草稿/ YYYYMMDD-[文章标题].md
③项目推进
# 任务卡：项目进度跟踪与风险排查## 1. 触发要求当用户说「跟踪 [项目名] 进展」时引用本卡。## 2. 读取上下文- 02-进行中项目/[项目名]/ 下所有文档- 01-我的资料/我现在要做什么.md## 3. 评估维度- 当前进度：已完成里程碑与完成百分比。- 堵点与风险：阻塞事项、超期任务、 等待他人反馈超 3 天的事项。- 下一步动作：本周必须完成的最小动作。- 需人工决策：必须由用户把关的临界节点。## 4. 输出交付- 更新保存至 02-进行中项目/[项目名]/ 项目进度周报.md
05
驾驶舱闭环与自动化
三个机制，缺一个都会焦虑
一个真正能落地的驾驶舱，必须围绕三个机制形成闭环。看这张流向图：
00-收件箱
INBOX
↓
WORKBUDDY 处理
↓
个人工作驾驶舱
今日重点 Top 3 / 风险雷达 / 周报复盘
↓
归档与产出
05-交付成果 / 06-归档
今日重点
拒绝在几十条待办里翻找。打开首页，30 秒内必须看清今天最重要的 3 件事。
风险雷达
自动巡检过期未完成、24 小时内临期、阻塞项目、等待他人反馈超 3 天的边缘事项，按红黄绿三级预警。
周报复盘
任务状态变动自动留日志。每周五下午一键汇总新增、已完成与未完成事项，生成标准化周报草稿。
别停在空架子
目录建完就结束，是最常见的半途而废。真正的工作台，必须立刻跑通第一条真实任务。
第一步 放入真实文件
往 00-收件箱 丢 2 到 3 个真实待处理文件，比如会议录音转写、客户需求截图。
第二步 下达处理指令
见下方指令模板。
第三步 去 Finder 验收
打开对应目录，确认文件真的躺在那里。这步通过，工作台才算从「能聊天」跨到「能交付」。
首次运行
请读取 00-收件箱 中的现有文件，先不要修改或移动原文件。1. 列出每个文件的名称与内容类型。2. 用一句话总结其核心内容。3. 提取今天最需要处理的 3 件事。4. 生成 Markdown 格式的今日工作清单，先输出执行 计划，等我回复「确认执行」后，保存至 04-日常办公/每日计划/YYYY-MM-DD-今日工作清单.md
自动化：先一次，再每天
配置金律：先用「仅一次」跑通测试，再开启「每天定时」运行。
一次就能验证指令是否写对，避免每天早上收到一堆错东西。
以「每日工作清单自动生成」为例：
任务名称
每日个人工作台整理
工作空间
/Users/your_username/WorkSpace
运行频率
先设「仅一次」（当前时间 5 分钟后）；测试无误后改为「每个工作日 08:30」
自动化指令
读取 01-我的资料/我现在要做什么.md 以及00-收件箱/ 中的所有文件。1. 梳理今日最关键的 3 件事，列出优先级、 下一步动作与风险。2. 保持收件箱原始文件不动。3. 生成 Markdown 文件，保存至 04-日常办公/每日计划/当天日期-今日工作清单.md4. 缺失信息明确标记为「待确认」，绝不编造。
macOS 休眠时会挂起后台定时任务。要保证按时触发：确保电源已连接，并在系统设置 → 电池 → 选项中开启「当显示器关闭时防止自动休眠」，或用 caffeinate 命令保活。
同时确保 WorkBuddy 处于后台常驻登录状态。
06
出问题时按顺序排查
排查原则只有一条：一次只改一个变量。改三个地方再试，你永远不知道是哪个生效了。
01查 macOS 路径与权限
02查 Agent 是否读到长期记忆
03查安全规则与执行计划
04查自动化与系统状态
找不到文件 / Operation not permitted
绝对路径写错（混淆了 ~ 与全路径），或 macOS 隐私权限限制。
检查隐私与安全性 → 完全磁盘访问权限，勾选 WorkBuddy；终端运行 pwd 确认绝对路径，统一写成 /Users/username/WorkSpace/；检查路径里是否混进了中文空格或特殊字符。
每次对话都像新人，记不住风格
任务指令中没有明确的背景文件读取要求。
在系统总指令或任务卡开头加强制规则：「执行任务前必须先读取 01-我的资料 下的 5 份背景 Markdown」。
生成的文件找不到位置
提示词未规定保存目录与命名规范。
在任务卡中约定输出格式，要求末尾必须打印绝对路径，例如「保存路径：/Users/your_username/WorkSpace/04-日常办公/xxx.md」。
AI 乱改文件，内容被覆盖
通用工作规则未生效，缺少「先出计划」的硬约束。
在通用工作规则.md 顶部追加：任何修改、移动或创建文件的任务，必须先输出步骤计划，等用户回复「确认执行」后再动。
分类混乱，文件放错文件夹
没做小样本测试就直接批量移动。
渐进式测试：先要求「仅提供分类建议，不实际移动文件」，连续 3 次无误后再授予移动权限。
定时自动化没按时跑
Mac 进入深度休眠，或后台进程被系统清理。
确认开机联网；用 caffeinate -s 防止休眠；到自动化日志面板看是否有权限报错。
命令行脚本卡死
脚本里含交互式输入提示，比如 read -p 或 sudo 密码。
下达终端指令时不包含需要交互输入的命令；涉及超级用户权限的操作，改由你本人在终端手动执行。
07
让工具适应你的工作流
搭这套东西，本质上是做一次个人生产力系统的升级。把散乱的文件收进 7 类物理分区，把偏好沉淀成 5 份记忆，把高频任务封成任务卡，再配上 9 条底线和上下文机制。
做完这些，你手里才真正有了一个安全、高效、听得懂话的数字员工。
最好的工作台不是一天搭出来的它随着你的工作习惯一起生长
所以别追求一次配到完美。先跑通一条真实任务，再慢慢加东西。保持背景资料与阶段目标的定期更新，让它推着你走的同时，长成你不可替代的那个搭档。
今天就能做的四件事
01在 ~/WorkSpace 下建 7 个文件夹
02写好 5 份背景 Markdown，重点是风格与规则
03跑一次只读诊断，三项全对再继续
04往收件箱丢两个真文件，跑通第一条任务
WORKBUDDY × macOS
方法论来自实践，落地靠你的目录结构
