1
领取 API Key（会员专属）
必须最先做——没有 Key，智能体无法运行
这里的智能体都是小密圈会员专属，运行时会调用「小密圈理财知识库」为你取数、分析，必须先用你的专属 API Key 验证会员身份。
领取很简单：打开领取页面 → 登录你的环球账号 → 一键验证会员身份 → 复制保存你的 API Key。
🔑 去领取 API Key →把领取到的 Key 复制保存好。首次使用智能体时会引导你填入 Key 完成鉴权；没有 Key 或 Key 无效，智能体会提示鉴权失败、无法使用。
2
下载智能体
拿到压缩包
回到「圈友投研工作台」首页，找到你想用的智能体卡片，点击卡片上的 「⬇ 下载智能体」 按钮。
浏览器会下载一个 .zip 压缩包，例如 value-investing-analyst_v2.1.zip，先把它保存好。
3
解压并放进「技能目录」
这是最关键的一步，按你的电脑系统选一条路径
「智能体」在 WorkBuddy 里叫 Skill（技能）。它的安装方式很简单：解压后得到的整个文件夹，放进 WorkBuddy 的技能目录，重启后 AI 就会自动识别它。
Mac 电脑
- 双击 zip 解压，得到一个文件夹（如 value-investing-analyst）
- 打开「访达」，按快捷键 ⌘ Command + ⇧ Shift + G
- 粘贴路径：~/.workbuddy/skills/ 后回车
- 把整个文件夹拖进去即可
Windows 电脑
- 右键 zip → 「全部解压缩」，得到一个文件夹
- 打开「文件资源管理器」，在地址栏粘贴路径：%USERPROFILE%\.workbuddy\skills\ 后回车
- 把整个文件夹复制进去即可
文件夹层级不能错——技能目录下，直接就是「技能名」文件夹，里面是 SKILL.md 文件。对照下面检查：
✅ 正确：skills / 价值投资分析师 / SKILL.md
❌ 错误：skills / 价值投资分析师 / 价值投资分析师 / SKILL.md（多套了一层）
❌ 错误：skills / 价值投资分析师 / 价值投资分析师 / SKILL.md（多套了一层）
4
重启 WorkBuddy，直接调用
装完必做，否则不生效
完全退出 WorkBuddy 再重新打开（不是关窗口，是彻底退出程序）——新技能需要重启才会被加载。
重新打开后，无需任何手动配置。直接在对话里说需求，AI 会自动匹配并调用对应的智能体。例如：
帮我用价值投资框架，深度分析一下贵州茅台
→ 自动调用 价值投资分析师，输出八维评分卡 + 估值报告
帮我生成一份半导体行业的深度研究报告
→ 自动调用 行业研究报告，联网取数并生成结构化报告
用缠论思维，帮我复盘一下最近这几年的经历
→ 自动调用 人生缠论走势图，输出带 SVG 走势图的诊断报告
怎么确认装成功了？ 打开 WorkBuddy 左侧栏的「技能 / 智能体」入口，列表里能看到你刚放进去的技能名称，就说明安装成功、可以用了。
❓
常见问题
装不上、没反应？先看这里
🔑 智能体提示「鉴权失败 / 需要 API Key」？
说明你还没领取 API Key，或者 Key 填错了。到领取页面登录环球账号、验证会员身份后领取，首次使用智能体时按引导填入即可。智能体为小密圈会员专属，Key 是验证会员身份的唯一凭证。
⚠️ 投资技能报错、拿不到数据？先链接万得数据库
价值投资分析师、行业研究报告、题材挖掘机、财富管理账户诊断等投资研究类技能，分析时要调用万得（Wind）金融数据库取行情和财务数据。请务必先链接万得数据库，再使用这些技能，否则会报错或拿不到数据。
怎么链接 / 验证？ 打开 WorkBuddy 左侧栏的「连接器」管理页，找到并启用 Wind 万得数据库连接器（没有可在里面搜索安装）。启用后先发一句话验证：
怎么链接 / 验证？ 打开 WorkBuddy 左侧栏的「连接器」管理页，找到并启用 Wind 万得数据库连接器（没有可在里面搜索安装）。启用后先发一句话验证：
查一下贵州茅台的最新股价
→ 能返回真实报价 = 数据库已通，可以正式开工；报错 / 无数据 = 先回去检查连接器
装完了，但对话里好像没反应？
九成是没重启。技能是重启后才会被 WorkBuddy 扫描加载的，请彻底退出后重开。如果确认重启了还是没反应，检查文件夹层级是否正确（见上面「✅正确 / ❌错误」示意图），最常犯的错是多套了一层文件夹。
找不到 .workbuddy 这个文件夹？
它是隐藏文件夹，在访达/资源管理器里默认看不到。不用去找，直接用上面的「前往文件夹 / 地址栏输入路径」方式打开即可。Windows 用户也可以勾选「查看 → 显示 → 隐藏的项目」后就能看到。
Mac 里 ~ 这个波浪号是什么意思？
~ 代表你的用户主目录，也就是「/Users/你的用户名」的简写。所以 ~/.workbuddy/skills/ 实际是「/Users/你的用户名/.workbuddy/skills/」。访达「前往文件夹」里直接输入带 ~ 的路径就能识别。
「创新药估值专家」为什么装法和别人不一样？
它是专家智能体（Expert），不是普通技能，所以目录不同。解压后把文件夹放进 ~/.workbuddy/plugins/marketplaces/my-experts/plugins/（Windows 为 %USERPROFILE%\.workbuddy\plugins\marketplaces\my-experts\plugins\），然后到 WorkBuddy 左侧栏「专家」里启用它。其余 9 个都是标准技能，按本教程第二步操作即可。
有些技能要自己准备 API Key 或数据源？
是的。比如 「尾盘干一票」 首次使用会引导你完成 API Key 鉴权；投资研究类技能（行业研究、题材挖掘机、价值投资等）依赖万得数据库，务必先按上一条 FAQ 链接好再使用。每个技能卡片底部的灰色小字都标注了它的特殊说明，下载前可以瞄一眼。
我装完想删掉 / 不想用了怎么办？
到技能目录里把对应的「技能名」文件夹删掉，重启 WorkBuddy 即可卸载；也可以在 WorkBuddy 的技能管理界面里直接停用/卸载。放心，删技能不影响你的其他数据。