>

📖 使用指南

从下载到干成第一件事，四步搞定

← 返回首页
1

准备一个 AI 网关账号

灵枢需要一个 AI 网关的 API Key 才能对话和调度模型。推荐奇比特 AI —— 1 分钟注册，注册即送免费额度，主流模型一键开通。

  1. 打开 qibitai.ai，用手机号或邮箱注册
  2. 登录后进入控制台
  3. 左侧菜单找到 「API 密钥」 → 「创建 API Key」
  4. 复制生成的密钥（以 sk- 开头）

💡 也支持火山引擎等其他兼容网关，在应用「设置」里可以切换。
图片/视频/音频处理是本地能力，不消耗你的 API 额度。

⚠️ 密钥只在创建时完整显示一次。请先粘贴到安全的地方；如果丢失，删除后重新创建一个即可。

2

下载并安装灵枢

macOS：按芯片选择版本（左上角 →「关于本机」看「芯片」一项）

  1. 下载 .dmg 安装包（Apple 芯片版约 239 MB / Intel 版约 245 MB）
  2. 双击打开，把 LingShu.app 拖进「应用程序」文件夹
  3. 在「应用程序」里双击启动（已签名并公证，正常情况下不会出现安全警告）

🧭 想要逐步引导（含"卡住了怎么办"）？看 《安装引导》 —— 那里会自动匹配你的平台，一步一步带你装好。

Windows（Windows 10 / 11 · 64 位）：

  1. 下载 .exe 安装包
  2. 双击运行，按安装向导提示完成安装
  3. 从开始菜单启动灵枢
↓ 打开下载页
3

首次启动 & 填入 API Key

  1. 打开灵枢，点击界面右上角 ⚙️ 设置
  2. 在 「API 配置」 中粘贴刚才复制的 Key
  3. 网关保持默认的 「💎 奇比特 AI」，保存

✅ 保存后灵枢会自动检测可用模型。模型类型与可用性会自动核对：对话用对话模型、生图用生图模型，不可用的会被自动跳过，不需要你逐个试。

4

授权（只为用桌面操控和浏览器）

如果你想让灵枢操作桌面应用或浏览器，需要给它系统权限。不需要这些能力可以跳过这一步。

🔒 终端执行有命令白名单和高危拦截，删除操作走系统回收站（可恢复），每一步操作都有审计记录。

5

开始用：直接说你要什么

不用学命令，像交代同事一样说就行。比如：

💡 想让成果更好，把要求说具体一点：要什么格式、放哪里、大概多少页、风格偏好。

?

常见问题

❓ 提示"无法验证开发者"

正常情况下不该出现 —— 灵枢已用开发者证书签名并通过 Apple 公证。如果确实遇到了，说明系统没能联网完成校验：先确认网络正常，然后到「系统设置 → 隐私与安全性」拉到底部点 「仍要打开」，再双击一次应用即可。

❓ 模型列表是空的 / 提示模型不可用

通常是 API Key 无效、额度用尽，或该网关暂时不可用。先在网关控制台确认 Key 有效且有余量，再在设置里点一次「检测模型」。

❓ 点击计算机操控没反应

多半是系统权限未授予。到「设置」里点「打开自动化权限设置」，在系统设置中开启辅助功能和屏幕录制后重启灵枢。

❓ 文档生成 / 图片视频处理 报错

这类功能需要你电脑上有 Python 3（macOS 版不自带 Python 运行时，用的是系统里那个）。自查方法：回到灵枢的「AI 助手」页，点 「🔍 检测环境」 按钮。如果缺 Python，在「终端」里执行 xcode-select --install 安装即可（Apple 官方组件，免费）。

❓ 生成文件跑到哪里去了？

默认保存在 LingShu 工作区，也可以在指令里直接说"放到桌面"。生成后会在对话里给出文件路径，点一下就能打开所在位置。

❓ 支持 Windows 吗？

支持。macOS（Apple Silicon + Intel）与 Windows 10/11 64 位都可免费使用，核心功能一致。少数专业工具（视频剪辑、图片批处理、图片文字识别）目前以 macOS 为先，Windows 版会在后续版本补齐。

❓ 怎么更新？

应用内置自动更新，新版本发布后启动时会提示。