Obsidian Office Preview 插件

这是一款致力于让 Obsidian 实现全真无缝、纯脱机式 Microsoft Office 重度文件预览的强大视图插件。

✨ 核心特性与支持的格式

本插件采用了“前端解析 + 底层桥接”双引擎架构机制，以实现目前 Obsidian 平台最极客、最万能的 Office 查阅方案。

1. 极速前端直出引擎 ⚡️

对于现代及泛用格式，插件会直接在 Electron 前端完成渲染，瞬间打开，无需依赖任何外部程序软件：

• Word 文档： .docx（极速渲染、深度保留排版及文字样式）
• 电子表格： .xlsx , .xls , .csv , .tsv , .ods
  • 特别优化：支持表格的横向滚动。对于具有多工作表 (Sheet) 的 Excel 文件，底部会自动生成并排的高亮标签 (Tab)，点击即可即时切换不同工作表的数据。

2. 底层 COM 桥接引擎 ♨️

对于排版极其复杂的演示文稿以及不支持公开解析的老旧二进制文档，插件采取了后台自动化调用操作系统原生软件的"降维"策略。它会在后台通过 PowerShell 静默唤醒您电脑上的 Office 将其无损转录为高质量 PDF 并在 Obsidian 直接挂载：

• 旧式字处理： .doc
• PowerPoint： .ppt , .pptx

🛠 系统要求与注意事项

• 基本预览：所有经过前台引擎直出的格式（如 docx / xlsx）支持所有操作系统，开箱即用。
• 高阶转码阅览：对于依赖 COM 引擎的 .doc / .ppt / .pptx 文件，由于需要借助系统底层实力，仅限 Windows，且您的计算机必须已经安装本地版 Microsoft Office（至少包含 Word 和 PowerPoint）。
• 关于速度：当您第一次在 Obsidian 侧边栏点击 PPT(X) 文件时，因涉及原生软件转码为 PDF 输出的庞大作业流程，可能会有 1~5 秒的短暂 Loading 提示，请耐心等待，这是获取完美高保真排版阅览付出的唯一代价。
• 关于 WPS：目前针对旧版的专门转码并未测试对于专属格式 .wps 的支持。如您仅有 WPS 且没有 MS Office，后台脚本可能会因为获取不到 Word.Application 类而抛出错误。

📦 安装说明

1. 寻找您 Obsidian Vault 内的隐藏配置夹：进入您的知识库文件夹 /.obsidian/plugins/ 目录。（如果没有 plugins 文件夹请手动创建）
2. 在该目录下新建子文件夹：obsidian-office-preview
3. 将本项目经编译后的三个核心发布产物放入该目录：
   • main.js (核心逻辑)
   • manifest.json (插件清单)
   • styles.css (排版样式卡)
4. 打开 Obsidian 桌面端，进入 "设置 (Settings)" -> "第三方插件 (Community plugins)"。
5. 停用 "安全模式 (Safe mode)"。
6. 在列表中找到 Office Preview 并点亮开关即可。

🛡️ 安全承诺

该插件从始至终坚持绝对的数据只读原则。不管是您的大型试算表，还是需要交给底层驱动转换的幻灯片，全过程绝对不会触发任何修改、破坏原文件以及上传云端的操作，您的隐私将获得 100% 捍卫。且生成的任何临时中间文件均暂存在系统级沙盒（临时文件夹）中，用完自动清理无残留。