WorkBuddy 安装指南
其他客户端路线；先跑一次演示。
步骤按官方说明核对（2026-09-27）；Windows / macOS 完整导入与出图仍待实机验证。
安装和出图请在电脑上完成。
先安装 WorkBuddy
打开 WorkBuddy 官方下载页 ↗，选择电脑对应的版本。
Mac 电脑
官方要求 macOS 12 或以上。在苹果菜单的“关于本机”查看芯片，M 系列选 ARM64，Intel 选 X64。打开下载的 .dmg，将应用拖入 Applications。
官方 Mac 图文步骤 ↗确认：电脑里能打开名为 WorkBuddy 的应用。
遇到问题？
先核对系统与安装包是否对应。这里需要的是 WorkBuddy 桌面应用；若下载到 CodeBuddy 编辑器或 IDE 插件，请回到上面的官方产品页。
Skill 就是给 AI 软件用的工作说明，里面带规则和工具。导入后，用平常说话的方式交代需求即可。先看看模型和费用 →
登录后 回到软件
在 WorkBuddy 点登录，按它打开的官方账号页面完成登录，然后回到 WorkBuddy 窗口。
确认：回到客户端后，可以开始一个任务。
遇到问题？
本站没有登录框，也不会索取软件密码。浏览器显示登录成功而客户端没变化时，回到客户端重试；仍失败请看 登录排查。
导入绘图和拼图 两个包
在浏览器下载列表找到 VoltPeer-WorkBuddy-Starter-v0.12.0.zip，先解压。只需要依次导入这两个文件：
voltpeer-plot-workbuddy-v0.12.0.zip：数据出图及共享绘图规则。voltpeer-assemble-workbuddy-v0.12.0.zip：把现成图拼在一起。
在 WorkBuddy 的技能页选择“添加技能”→“上传技能”，每次选择一个里面的 ZIP。外层“套装”用于下载，不直接导入。
查看官方技能界面与截图 ↗确认：已安装列表中出现这两个技能，且处于启用状态。
遇到问题？
若名字已存在，先核对版本，保留自己的修改。单技能自带所需规则。文件找不到时，按 技能未找到 排查。
准备一个专门的测试文件夹
在电脑新建 VoltPeer-试用 文件夹，在 WorkBuddy 新任务里选择或授权这个文件夹。然后复制下面的话。
你也可以用自己的话说查看请求
请先检查当前 WorkBuddy 能否读取 voltpeer-plot 和 voltpeer-assemble 的 SKILL.md、引用文档及脚本。确认两个技能的相对引用可达，再检查 Python 版本和依赖。缺依赖时在我选择的测试文件夹中创建隔离环境；不要修改全局 Python，不需要管理员权限。请逐项报告检查结果，不要把文件存在说成软件已经识别。
确认：软件说明能读取哪些技能、Python 是否可用、依赖是否齐全。
遇到问题？
环境缺少组件时，先让软件说明需要安装什么。若依赖下载失败，保留已下载文件，见 环境排查；不要反复重装整套技能。
下载示例 开始画图
从样图库或社区来的选择会保留。还没选的话，也可以直接试下面的容量循环例子。
下载后解压，把两个 CSV 和说明文件放进刚才的测试文件夹。发送任务时先确认软件能看到这些文件。
你也可以用自己的话说查看请求
使用 VoltPeer，先核对这个文件夹里 cycling.csv、voltage_profiles.csv 的列和单位。这是虚构演示数据。请按 capacity cycling + selected voltage profiles 画一张图，数据坐标四周保留框线，连续曲线用无点实线，输出 PNG 和可编辑 SVG 到当前文件夹的 brf-output 中，不覆盖原始文件。缺少条件就说明，不猜。完成后给出文件的完整保存位置。
确认：brf-output 中出现 PNG 和 SVG 文件，软件给出保存位置。
遇到问题？
如果任务中断，只重试这一张小示例一次。把最后一条错误交给软件；还不行可 整理问题求助。
打开结果 再换自己的数据
先打开 PNG 看整体，再用 免费 Inkscape ↗ 打开 SVG 调整文字。文件名和路径以软件实际报告为准。
确认：能打开两份文件，并核对横纵轴、单位、图例和数据。
遇到问题？
只收到聊天里的预览而没有文件时，让软件列出 brf-output 中的文件和完整路径；见 找到输出文件。
查看请求
余额或额度不足怎么办？
VoltPeer 是独立开源项目，与 WorkBuddy 无官方隶属或赞助关系。
本页没有制作或替代客户端截图。上面的截图入口来自官方文档；客户端版本可能改变界面位置。