文档 / 编辑 / HTML、Mermaid、PDF 与图像查看器

Orca 内置了大多数仓库中常见格式的查看器。

HTML¶

使用 在 Orca 浏览器中打开 或 在侧边打开预览 打开本地、SSH 或配对运行时中的 .html 文件。Orca 会在沙箱浏览器标签页中本地渲染文档，并通过工作区的文件连接读取该文件及其相对资源，因此远程设计文档可以保持清晰，而不会暴露你的桌面文件系统。

预览在读取额外文件夹之前会请求确认，并且仅授予你为该标签页批准的文件夹。外部 HTTP(S) 链接需要确认，并会在普通 Orca 浏览器标签页中打开；文档预览内禁用下载。使用 预览选项 可从磁盘重新加载、打开源文件，或复制其完整路径或工作区相对路径。

在配对运行时中，HTML 文件必须位于 worktree 内。非常旧的配对服务器可能在没有二进制资源的情况下渲染文档；如果远程图像无法加载，请更新服务器。

Mermaid¶

Mermaid 图表会在 Markdown 预览中内联渲染。独立的 .mmd 文件会在专用查看器中打开，支持平移/缩放。

PDF¶

支持滚动、缩放和文本选择。适用于已检入仓库的设计文档。当你从 PDF 标签页切换走再返回时（包括在同一会话中关闭后重新打开），滚动位置会恢复——页码加上页内偏移，因此你会回到上次离开的位置。位置仅在当前会话中有效，Orca 重启后会清除。

图像¶

.png、.jpg、.svg、.webp、.gif。图像差异模式会并排比较同一文件的两个版本。

CSV / TSV¶

.csv 和 .tsv 文件会在表格查看器中打开，支持可排序列和快速搜索。适用于 fixtures、导出文件以及任何已检入仓库的表格数据。如果需要直接编辑单元格，请使用工具栏切换回原始文本视图。

Jupyter 笔记本¶

.ipynb 文件会在笔记本查看器中打开，包含渲染后的 Markdown、带语法高亮的代码单元格以及已保存的输出。编辑单元格会写回磁盘上的 .ipynb，同时保留 nbformat，因此差异保持干净。

笔记本编辑器标记为 beta。单元格执行和更丰富的输出渲染仍在完善中 — 如果你的仓库中的某个笔记本无法顺利加载，请提交 issue。