# Feishu Outline

飞书风格的 Obsidian 浮动目录。入口固定在每个文档区域的左上角，展开后显示文档名和分级标题，点击跳转，滚动时高亮当前章节。标题通过 Obsidian 的 Markdown 渲染器显示，支持 LaTeX 公式、加粗和行内代码。

## 使用

- 点击左上角三横线展开，点击双左箭头收起。
- 鼠标移至收起的入口会显示“展开目录”。
- 点击目录项跳至对应标题；同名标题按源文件行位置区分。
- 展开时可用上下方向键选择目录项，Enter 跳转，Escape 收起。
- 命令面板中的 `Feishu Outline: 展开／收起目录` 可自行绑定快捷键。

目录优先使用正文左侧留白；留白不足时，正文右移并重新换行，收起后恢复。目录最多占文档窗格宽度的 38%，不覆盖正文。每个文档窗格各自维护展开状态；编辑、实时预览和阅读模式共用目录数据。支持桌面端。

## 安装与撤回

将 `main.js`、`styles.css` 和 `manifest.json` 放入知识库的 `.obsidian/plugins/feishu-outline/`，然后在第三方插件中启用 **Feishu Outline**。

禁用插件即移除目录、布局调整和事件监听，不会修改笔记文件。与原生大纲及 Outline Math 可同时使用。

标题位置使用 Obsidian 缓存，标题文字从正文原文读取，避免其他插件处理缓存时丢失公式下标。数字开头的标题按普通目录文字显示，不会被误排成列表。

## 开发与验证

无需构建或运行时依赖。`npm test` 运行标题层级、源位置、重复标题、当前章节与刷新标识的测试；`npm run check` 检查语法。

在 Obsidian 中验证收起、悬停提示、展开、公式、跳转、滚动高亮、切换模式和标签页，以及禁用后的清理。用完整文档窗格检查正常和较窄宽度下目录与正文互不遮挡，收起后恢复原布局。视觉和布局以飞书实际界面为参考；本地对照证据保存在不纳入 Git 的 `verification/` 中。

这是独立开发的 Obsidian 插件，并非飞书官方产品。