在 Obsidian 中安装 LitOrbit
按下面 4 步操作即可。免费功能无需激活码，装好就能用。
点击后选择你的 库根目录（包含 .obsidian 的文件夹）并允许编辑。文件只在你的浏览器和本机之间处理，不会上传。
准备工作
- ✅ 已安装桌面版 Obsidian 1.5.0 或更高（还没有？免费下载）
- ✅ 至少有一个笔记库（Vault）。没有的话：Obsidian 启动页 → “创建新库”
- ✅ 记住库所在的文件夹位置（Obsidian 左下角库名 → “在访达中显示”可直接打开）
下载并解压插件
前往 下载页 获取 litorbit-obsidian-x.y.z.zip。双击 ZIP 文件即可自动解压，得到一个名为 litorbit 的文件夹。
litorbit 文件夹，里面有 main.js、manifest.json、styles.css、wasm、fonts。放进插件目录
把整个 litorbit 文件夹复制到你库里的 .obsidian/plugins/ 下。.obsidian 是隐藏文件夹：
plugins 文件夹，请手动新建一个。最终的目录结构必须是这样：
你的库/
└─ .obsidian/
└─ plugins/
└─ litorbit/
├─ main.js
├─ manifest.json
├─ styles.css
├─ wasm/
└─ fonts/目标路径（macOS）：
~/你的库/.obsidian/plugins/litorbit
喜欢命令行？一条命令搞定
先把库路径放进环境变量 VAULT，再执行（假设 ZIP 已解压在“下载”文件夹）：
mkdir -p "$VAULT/.obsidian/plugins" && cp -R ~/Downloads/litorbit "$VAULT/.obsidian/plugins/"
在 Obsidian 中启用
- 打开 Obsidian（已在运行的话请 重启 或在下一步点刷新）。
- 左下角 设置（齿轮）→ 第三方插件。
- 如果看到“安全模式”提示，点击 “启用第三方插件 / 关闭安全模式” 并确认。
- 在“已安装插件”列表点击右上角的 刷新 图标，找到 LitOrbit 引力学术，打开右侧开关。
- 左下角出现
LitOrbit Free标识，左侧工具栏多出 3 个新图标，就说明安装成功 🎉
激活 Pro / VIP（可选）
购买后激活码会发到你的邮箱，也可在官网 个人中心 查看。
- Obsidian → 设置 → LitOrbit 引力学术。
- 在“激活码”框粘贴形如
LITORBIT-PRO-9F8A-3B21-C4E2的码，点击 激活。 - 成功后右上角会升起 ✦ 金色星体，Pro 功能（多层星系展开、Nature / IEEE / 中科院模板）永久解锁，并支持离线认证。
三分钟上手
在笔记里键入 @ 加关键词（如 @graph neural network），弹出 OpenAlex 真实文献，带 🛡 Verified DOI 标记，回车即插入引用并写入 refs.bib。
左侧工具栏点击轨道图标（或命令面板 → “LitOrbit：打开引力星系图”），输入种子论文即可展开引文星系。
命令面板 → “打开引文样式与参考文献面板”，顶部下拉选择 IEEE / Nature / GB/T 7714 等，阅读视图里的引用瞬间重排。
命令面板 → “新建 Typst 论文”，选择模板，右侧即写即出；预览里双击文字可跳回源码对应位置。
常见问题
检查目录层级是否正确：必须是 <库>/.obsidian/plugins/litorbit/main.js，而不是多套了一层（如 litorbit/litorbit/main.js）。放好后在“第三方插件”页点右上角的刷新按钮，或重启 Obsidian。
打开开发者工具（Windows/Linux：Ctrl+Shift+I，macOS：⌘⌥I）查看控制台报错。最常见的原因是只复制了 main.js，漏掉了 wasm/ 和 fonts/ 文件夹——Typst 预览需要它们。
首次需要加载约 28 MB 的本地 WebAssembly 排版引擎，之后会常驻内存，增量排版只要几毫秒。完全离线，不会上传你的稿件。
内置字体只含拉丁文与数学字体。在插件设置 → “中文字体包”点击下载（约 8 MB，只需一次），或把 .ttf/.otf 字体放进库内 LitOrbit/fonts/ 文件夹，重启 Obsidian。
一个激活码最多绑定 3 台个人设备。到官网「个人中心」点“重置设备”后，在新电脑上重新激活。
确认插件设置里的“服务器地址”正确且能访问；激活成功后插件支持本地离线认证，之后断网也能用 Pro 功能（订阅用户需每 30 天联网一次）。
目前不能。插件依赖桌面版 Obsidian（macOS / Windows / Linux）。笔记库本身可以通过 Obsidian Sync 或网盘同步到手机阅读。
在 Obsidian → 设置 → 第三方插件中停用并卸载，或直接删除 <库>/.obsidian/plugins/litorbit 文件夹。你的笔记和 refs.bib 不会被删除。
仍有问题？到个人中心查看激活码状态，或邮件联系我们。