打开 LingSpark，首页只有一个开关。
把它打开就配置完了。灵光会自动找到你电脑上装过的 Agent（Claude Code、Codex、Cursor、WorkBuddy），把检查接进去。不用选文件夹、不用填 API Key、不用登录任何账号。
如果开关是灰的，说明没找到这四个 Agent 中的任何一个。装好并至少用过一次后，再打开灵光。
LingSpark · 灵光使用指南
Agent 每写完一篇中文文档，灵光先替你检查一遍：前后数字对不上、引用了不存在的章节、空话套话、指代不明……发现了就让 Agent 当场改掉，改不了的标出来留给你拍板。
Claude CodeCodexCursorWorkBuddy
01下载安装
点页面顶部的「下载 Mac 版」，会直接下载最新的安装包 lingspark-…-mac-arm64.dmg（约 25MB）。双击打开，把 LingSpark 拖进「应用程序」。
目前支持 Apple 芯片（M 系列）的 Mac。
02第一次打开被拦住
预览版还没有苹果开发者签名。从网上、聊天软件下载的安装包，第一次打开时 macOS 会提示「Apple 无法验证"LingSpark"是否包含恶意软件」。
- 在提示里点「完成」。不要点「移到废纸篓」。
- 打开「系统设置 → 隐私与安全性」，往下拉到「安全性」。
- 看到「已阻止 LingSpark」，点旁边的「仍要打开」，输入开机密码。
macOS 15 起，「右键 → 打开」已经不能跳过这一步，只能走系统设置。这个步骤只需要做一次。
03打开开关
04重开你的 Agent
Agent 只在启动时读取配置，所以刚接入的 Agent 要完全退出（⌘Q）再打开一次才会生效。
右下角的灯告诉你进度：
- 红灯：还有 Agent 没生效。鼠标移上去，能看到每一个还差什么。
- 绿灯：都在工作了。重开后在 Agent 里随便发一条消息，对应的灯就会变绿。
用 Codex 的还要多做一步：在 Codex 里输入
/hooks，把 LingSpark 的两个挂钩标为「信任」。没信任之前，Codex 会不声不响地跳过它们，灯会一直是红的。05照常让 Agent 写文档
不需要改任何习惯。Agent 写出的每一篇 Markdown 文档，灵光都会在两个时间点检查：
| 什么时候 | 查什么 | 发现问题会怎样 |
|---|---|---|
| 刚写完一篇 | 数字前后对不上、引用了不存在的章节或表格、日期矛盾等，有明确对错的问题 | 当场把问题告诉 Agent，让它改 |
| 这一轮快结束时 | 空话套话、指代不明、结论没依据、几篇文档之间说法矛盾等，需要读懂意思的问题 | 请 Agent 按灵光给的标准自己审一遍：有把握的直接改，拿不准的标成「待确认」并问你 |
Agent 那边看到的是这样一段话，之后它会自己去改：
Agent 收到的检查结果lingspark 在 会员拉新方案.md 中发现 1 个问题，请修改后再继续：
1. 第 5 行 [D101] 「本季度日活目标」在第 3 行是 50万，这里是 80万。建议：确认哪个取值是对的，然后统一全文。
如果你认为某条是误报，向用户说明理由，不要自行添加 lingspark-disable 注释。
Agent 随后的回复（示例）文档里本季度日活目标前后写了 50 万和 80 万两个数，我不确定哪个是对的，已把两处都改成「待确认」。请告诉我正确的目标值，我再统一补上。
灵光自己不调用任何模型，也不上传你的文档：需要读懂意思的检查，是由正在写文档的那个 Agent 在自己的对话里完成的。
06看灵光拦下了什么
首页中间是统计：上面一行是今天，下面一行是累计。
点「拦下 N 处问题」就能看到具体拦下了哪些说法。点今天那行只看今天的，点累计那行看全部。
中间的光球开着时会慢慢变换形态；灵光正在检查文档时，它会停在「搜索」的样子。
每一条记录包括：
- 问题类型，以及是「写入时拦下」还是「结束时自审」发现的
- 原文那一句，出问题的片段标红
- 为什么拦、哪个文件、哪个 Agent
- 状态：已处理或仍在文中
点开一条能看到修改建议，还可以直接打开那个文件。「仍在文中」的，通常是 Agent 拿不准、留给你判断的，值得看一眼。
07设置
点右上角的滑杆图标进入设置。每个 Agent 有单独的开关：不想让某个 Agent 被检查，关掉它就行，其他的不受影响。
首页的总开关关掉，等于把灵光从所有 Agent 里断开。
08常见问题
灵光会检查哪些文件？
Agent 写出来的 Markdown 文档（.md），不管写在哪个文件夹。不检查你们的对话回复，也不检查 Agent 自己的记忆和指令文件（比如 CLAUDE.md、AGENTS.md、各 Agent 的配置目录）。Agent 用终端命令写的文件也会被检查。
我的文档会被上传吗？
不会。确定性的检查在你电脑上完成；需要读懂意思的检查，由你正在用的 Agent 在它自己的对话里完成，不经过灵光的任何服务器（灵光也没有服务器）。拦截记录只存在这台电脑上，最多保留最近 500 条。
觉得灵光误报了怎么办？
Agent 会向你说明理由，你判断就好，不用照改。灵光要求 Agent 不要自己给文档加豁免注释，免得把真问题也一起放过。同一个问题在一次对话里被拦了三次还没改，之后这次对话就不再拦它。
右下角一直是红灯？
- 对应的 Agent 还没完全退出重开（⌘Q 后再打开），或者重开后还没发过消息。
- Codex：还没在 Codex 里用
/hooks信任 LingSpark 的挂钩。 - 鼠标移到灯上，能看到具体是哪个 Agent、还差哪一步。
会拖慢 Agent 吗？
大多数时候感觉不到：Agent 没写文档时，灵光几乎立刻放行。写了文档时，确定性的检查很快；结束时的自审会让 Agent 多花一点时间，把自己写的东西对照标准读一遍。
怎么卸载？
先在灵光首页把开关关掉（这会把检查从所有 Agent 的配置里移除），再把 LingSpark 从「应用程序」移到废纸篓。