交流群
界面、任务与工作区
WorkBuddy 主界面可以理解为三个区域:左侧(侧边栏)管理任务,中间(对话区)下达和追踪任务,右侧(结果区)查看文件、变更、预览和最终产物。

三个区域分别做什么
| 区域 | 主要用途 | 使用时重点检查 |
|---|---|---|
| 侧边栏 | 新建、搜索、切换和管理任务 | 是否进入了正确任务 |
| 对话区 | 描述需求、补充信息、确认计划 | 目标和约束是否完整 |
| 结果区 | 查看产物、全部文件、变更与预览 | 文件名、路径和改动是否符合预期 |
侧边栏的“任务”和“工作空间”的区别,在于你是否设置了“工作空间”目录。
“工作空间”是 WorkBuddy 为了管理任务而设置的目录,每个任务都有一个对应的目录空间,任务可以在目录空间内进行操作。
若未设置,会在默认安装的目录下执行任务,对话保存在“任务”目录下。
为什么要隔离工作目录
工作目录既是效率设置,也是安全边界。把发票、周报、客户材料混在同一个大目录里,会增加误读、误改和信息串用的风险。
推荐按任务建目录空间。
同时,可以对目录空间的权限进行设置,当开启“允许完全访问”(开启完全访问后智能体可读写授权目录外文件,请谨慎使用并优先按任务限定目录。)

三种工作模式
WorkBuddy 提供三种工作模式:
| 模式 | 中文界面 | 能做什么 | 适合场景 |
|---|---|---|---|
| Ask | 问一问 | 问答、理解和查看,不修改文件 | 先了解资料、确认需求 |
| Craft | 做一做 | 可直接操作本地文件、运行代码及系统指令 | 路径清楚、风险较低的任务 |
| Plan | 想一想 | 先生成计划,确认后再执行 | 多步骤、跨系统、重要文件任务 |

选择不同的模型
默认为自动模式,可以指定你想使用的模型,不同模型积分消耗不同。

| 任务特征 | 优先关注 |
|---|---|
| 大量文本与长资料 | 上下文长度,比如 100 万 tokens(1M) |
| 图片与截图 | 需要有视觉理解能力 |
| 高频简单任务 | 优先选择响应速度快、成本较低的模型 |
进阶:权限边界是它的安全带
WorkBuddy 能读你电脑上的文件、能跑命令,所以权限边界不是一个「设置项」,是安全带。新手最常犯的错,是为了方便把整个用户目录授权给它,结果它读到了不该读的、删了不该删的。
最小权限六步:
- 建专用工作目录,例如
D:\WorkBuddyWorkspace\项目A\,别在桌面或文档根目录里直接跑。 - 只把这个目录授权给客户端,读写权限。
- 需要参考别的目录时,加为只读——能看不能改。
- 系统目录、
.ssh、含密钥的配置目录、无关项目目录,一律不授权。 - 凡是写操作,先让它出 diff 预览,你确认后再落地。
- 任何 API Key、令牌、密码都不写进工作目录里的文件;要用就放环境变量,Prompt 里只写
<YOUR_TOKEN>这类占位符。
| 目录 | 授权级别 | 原因 |
|---|---|---|
D:\WorkBuddyWorkspace\项目A\ | 读写(写前预览) | 本次任务的主战场 |
D:\参考资料\模板库\ | 只读 | 要引用模板,不需要改它 |
C:\Users\你\.ssh\ | 不授权 | 含私钥,代理不该碰 |
C:\Users\你\Documents\ | 不授权 | 混着大量私人文件 |
拿不准的时候按一条标准判断:这个目录被误删一个文件,你会不会心疼。 会,就别给它写权限。
来源说明:本章改编自开源项目 AlephAITech/WorkBuddyGuide(MIT License,Copyright © 2026 WorkBuddy Guide Contributors),按 MIT 协议保留原作者署名;本站做了标题改写、排版与链接适配。