观墨 GuanMo:给重度文档阅读者装一个会 AI 的 Markdown 工作台

观墨 GuanMo：给重度文档阅读者装一个会 AI 的 Markdown 工作台

你有没有这种时刻：手头是一份 10 万字的技术资料、厚厚的 API 手册，或者一摞读书笔记，想在里面快速定位某个概念、回答某个问题，但市面上大多数 Markdown 编辑器只为「写」服务——等到真要读、要查、要理解的时候，就卡壳了。

观墨（GuanMo）想解决的就是这件事：它是一个专为「阅读 + 理解」Markdown 文档设计的桌面工作台，把 AI 能力织进阅读流程，让 10 万字长文档也能丝滑翻阅，让你不离开文档就能提问、检索、改写。

一句话定位

官方原话：「一个轻量、流畅、高效的 Markdown 工作空间，让文档更易阅读、更易理解、更易创作。」

翻译成人话：它不是另一个 Typora，也不是第二个 VSCode。它是给「以读为主、以写为辅」的人准备的：技术书作者、API 重度使用者、笔记狂魔、研究员。阅读体验放在第一位，AI 能力围绕阅读展开，基础的写和编辑也保留。

四大主打体验

1. 长文档丝滑阅读

针对超长 Markdown 做优化，10 万字也照样流畅。技术文档、API 手册、读书笔记这种"巨无霸"，在观墨里就是普通的文件。

2. 沉浸式全屏专注模式

按 F11 或点右上角进入全屏，标题栏、侧边栏全部收起。鼠标移到顶部唤起隐藏式控制条，可以快速切换视图和文件。读东西的时候，世界清静了。

3. AI 即选即问

阅读时随时框选一段话，右键就能让 AI 解读。它不只是「读选区」，还能读上下文、改写、知识库检索、联网搜索。一个浮窗搞定所有"对这段话我想干点啥"的需求。

4. 预览内原地编辑

看到一段话想改一下，不用切回源码模式。按住 Alt + 左键 点预览里的任意 Markdown 块，直接进源码编辑——改完自动回到预览。丝滑。

主题与界面

观墨自带五种主题：暖色、浅色、深色、Paper、GitHub Light，三种基础主题长这样：

🌞 暖色	☀️ 浅色	🌙 深色

编辑器是 CodeMirror 6，支持多标签页、搜索替换、自动保存、会话恢复，标签页状态还能持久化——重启电脑回来还是上次的状态。

架构速览

观墨是标准的 Tauri 2 桌面应用，Rust 后端 + React 前端，分四层协作：

层	干什么	关键技术
① 前端层	编辑器、预览、视图切换	React 18 · TypeScript 5 · CodeMirror 6 · Vite 6
② Tauri 桥	Rust 串起文件、加密、系统调用	Tauri 2 · Rust · Windows DPAPI · SQL 插件
③ 本地服务	AI Agent / RAG / 长期记忆	Agent 编排 · RAG 管道 · SQLite · 向量检索
④ 外部对接	LLM、联网、知识源	OpenAI 兼容 · Ollama 本地模型 · 联网搜索

安全亮点：所有 API Key 由 Windows DPAPI 加密保存到本机，仓库里不内置任何 Key，开箱即用——你接的是哪个模型，由你自己在设置里填。

安装与快速上手

观墨已上架 Microsoft Store 和 GitHub Releases（Windows 一键安装包 .exe / .msi）；网页版（功能受限）可在线体验。如果你想自己编译，源码完全开放：

# 1. 装前置依赖#    Node.js ≥ 18、Rust stable、Tauri 2 CLI 依赖（Windows 还需 WebView2 + VS Build Tools）# 2. 克隆 + 装前端依赖git clone https://github.com/we-used-to-be/Guanmo-open.gitcd Guanmo-opennpm ci# 3. 创建本地配置（只放密钥"标识名"，不放真实 Key）cp .env.example .env# 4. Tauri 开发模式（推荐：直接在 WebView 里跑）npm run tauri dev# 首次会编译 Rust 后端，5-15 分钟，后续热重载秒级# 5.（可选）打包成安装包npm run tauri build# 产物在 src-tauri/target/release/bundle/

.env 里只有像 VITE_GUANMO_AI_API_KEY_SECRET=guanmo.ai.api-key 这样的标识名——真实 API Key 在软件「设置」里填写，由 DPAPI 加密保存。.env 永远不会泄露你的 Key。

常用命令速查

观墨把常用动作都封进了 npm 脚本：

命令	干嘛
`npm run tauri dev`	Tauri 开发模式（推荐）
`npm run dev`	只起 Vite，纯前端调试
`npm run build`	类型检查 + Vite 打包
`npm run tauri build`	完整打包（产出 .exe / .msi）
`npm run test:agent-parser`	Agent 解析器测试
`npm run test:markdown-math`	Markdown 公式测试
`npm run check:paths`	资源路径检查
`npm ci`	按 lockfile 严格安装依赖

适合谁用

长文档阅读者：技术手册、API 文档、读书笔记。10 万字照样流畅，AI 框选即问。
AI 折腾党：接 OpenAI 兼容接口 / Ollama，知识库、长期记忆、联网搜索自己摆。
数据敏感用户：API Key 用 DPAPI 加密存本机，不上传文档，离线也能跑本地模型。

安全与隐私重点

不上传文档：AI 功能由用户自行配置模型接口，不内置密钥，不要求上传本地文档。
本地加密：API Key 由 Windows DPAPI 加密存储，.env 仅含"标识名"。
离线可用：接 Ollama 这类本地模型，断网照样用。
明文拒绝：仓库里没任何真实 API Key，PR 检查时也会被拦下。

详见仓库里的 PRIVACY.md^[1]。

项目地址

🪟 Windows 安装包（NSIS / WiX）：https://github.com/we-used-to-be/Guanmo-open/releases/latest
🛒 Microsoft Store：https://apps.microsoft.com/detail/9N2C2C3ZS467
🌐 网页版（功能受限）：https://we-used-to-be.github.io/Guanmo-page/
💻 源码 + Issues：https://github.com/we-used-to-be/Guanmo-open
📚 使用说明书：https://github.com/we-used-to-be/Guanmo-open/blob/main/docs/USER_GUIDE.md
🤖 AI 路由指南：https://github.com/we-used-to-be/Guanmo-open/blob/main/docs/AI_ROUTING_GUIDE.md
📄 许可证：MIT（源代码），第三方组件见 THIRD_PARTY_NOTICES.md

如果你一直在找一款「能读、能查、能聊」的 Markdown 桌面工具，观墨值得一试。