安装与初始设置
WorkBuddy 能读写本地文件并连接外部服务，安装完成只是第一步。真正重要的是选对工作空间、控制权限、准备副本，并用一个低风险任务验证完整链路。
下载与安装#
从 WorkBuddy 官方网站或官方文档提供的入口下载安装包。Windows 与 macOS 的系统提示、安装位置和安全授权不同，应分别参考：
不要从不明网盘或第三方打包站下载，避免版本滞后或安装包被修改。
第一次启动前准备#
建立一个专门的试验目录：
WorkBuddy-Sandbox/
├── input/ 原始材料的副本
├── output/ 交付物
└── notes/ 任务说明与验收记录
把 3—5 个不敏感文件复制到 input/。不要直接选择桌面、整个文档目录、公司共享盘或生产资料根目录。
权限怎么给#
WorkBuddy 可能根据任务请求文件访问、辅助功能、通知或外部连接权限。遵循三条原则：
- 权限必须对应当前功能；
- 首次授权后立刻用小任务验证；
- 不再使用的能力及时在系统设置中撤销。
macOS 的系统权限通常需要在“隐私与安全性”中管理；Windows 的安全软件或企业策略可能阻止执行。若提示与官方指南不一致，优先保留完整截图和版本信息。
选择工作空间#
工作空间决定默认可见和可操作的文件范围。好的工作空间应该：
- 只包含当前项目；
- 原始资料与输出目录分开；
- 有清楚的命名和版本；
- 能够备份或回退；
- 不混入无关敏感文件。
如果任务跨多个目录，先把必要材料复制到同一工作空间，而不是直接扩大到整块磁盘。
完成第一个低风险验证#
请只读取 input 目录中的文件：
1. 列出文件名、格式和大致主题；
2. 在 output 目录生成 inventory.md；
3. 不修改或删除原文件；
4. 完成后列出你创建的文件。
人工检查：
input/是否完全未变；output/inventory.md是否存在；- 文件内容是否与原材料一致；
- 是否有任务范围之外的新文件。
右侧栏与任务状态#
官方的右侧栏说明用于理解任务、文件或工具状态。不要只读最终回答，也要观察执行过程中的文件操作、待确认动作和错误提示。
推荐的初始设置#
| 设置 | 推荐 |
|---|---|
| 默认工作空间 | 专用项目目录 |
| 原始文件 | 只处理副本 |
| 输出位置 | 固定 output/ |
| 通知 | 开启任务完成与失败提醒 |
| 自动化 | 暂不开启，先手动跑通 |
| 外部连接 | 按需逐个添加 |
| 记忆 | 只保存稳定偏好，不写秘密 |
安装问题的最小信息#
请求帮助时至少提供：
- WorkBuddy 版本；
- 操作系统与版本；
- 下载来源；
- 卡在哪个安装或授权步骤；
- 完整错误文本或脱敏截图；
- 是否受公司设备管理策略控制。
完成标准#
- 从官方渠道安装；
- 使用隔离工作空间；
- 能完成“读输入、写输出、不改原件”的任务；
- 知道在哪里查看执行状态；
- 能撤销已授权权限；
- 没有连接不必要的外部账户。