readMD

Languages: 简体中文 | 繁體中文 | English | 日本語

ReadMD (Pure Rust Edition)

100% 纯 Rust 原生全平台 Markdown 阅读器与编辑器

长文档语义分页 · 显示层非破坏纠错 · Office/PDF/网页转 MD · 离线 OCR · LaTeX 学术增强 · MCP 接入 · 零 Python 依赖

官网地址：https://rust.readmd.asia ｜ 赞助支持（爱发电）：https://ifdian.net/a/natsummerance

[!IMPORTANT] 100% Pure Rust 原生架构版 (rust-ReadMD)：本项目由全新纯 Rust 内核（readmd-kernel）独立驱动，彻底移除了所有历史 Python 运行时与虚拟环境依赖。体积仅约 11.8MB，冷启动毫秒级秒开，常驻内存下降 80%+。支持 Windows (WebView2 + Win32)、macOS (WKWebView + Cocoa) 与 Linux (WebKitGTK + XDG) 全平台原生运行，零外部依赖，安全纯粹。

30 秒判断它适不适合你

你的情况	ReadMD 的做法
文件超过 8,000 行或 500KB	自动启用语义分页；目录和 Ctrl+F 跨页联动
表格缺分隔线或公式未闭合	渲染前在内存修正；原文件仍保持不变
手里有 DOCX / PPTX / XLSX / PDF / HTML	一键转入 Markdown，减少手工搬运
需要提取扫描件文字	调用系统原生 OCR，支持离线工作流
写论文或技术文档	BibTeX 引用卡片、定理/证明盒子与 LaTeX 导出
想要桌面伴读或角色互动	CC0 Arch-Chan Live2D 与 73 款微呼吸精灵图，全端台词同步
需要高保真修复 PDF 文本	内置矢量 PDF 编辑器，零污染质检与一键回滚
想接入 AI 编程助手	提供 VS Code 扩展和 FastMCP stdio Server (21 项工具)
多语言团队跨国协作	46 国语言 100% 字典对齐 (1563 词条)，零英文照搬，母语级体验

直接下载

Windows 安装包 · Windows 便携版 · macOS Apple Silicon · macOS Intel · Linux AppImage · Linux ARM64 · UOS / 麒麟 Deb · 麒麟 V10 ARM64 · SHA-256

三步开始

1. 按系统下载安装包，或选择免安装便携版。
2. 打开一个真实的大文件；先检查目录、搜索和表格渲染。
3. 需要修改时再编辑保存；自动修复不会在你不知情时改写源文件。

AI 助手引用入口

• 简明产品索引：版本、平台、隐私边界和关键事实。
• 完整引用语料：长文档分页、非破坏修正、转换范围和常见问题的直接答案。

为什么值得 Star

ReadMD 解决的是长期资料库里的实际问题：大文件能继续读，导入稿不用重排，敏感内容可以留在本机，原文始终保留最终决定权。如果你在 Windows、macOS、Linux 或信创环境之间切换，它提供一致的工作流。

如果它帮你省下一次整理时间，请 点 Star，让更多写作者找到这个项目。

候选下载矩阵 (Preview Release Assets)

本矩阵只列当前候选的交付目标，不等同于正式支持承诺。Windows 7 仅提供单独的遗留运行时构建，不与 Windows 10/11 安装包混装；HarmonyOS/OpenHarmony 及未完成实机验收的架构不属于 V0.0.1 支持范围。

操作系统 / 平台	架构 / 格式	直接下载链接 (GitHub Release)	说明
Windows	x64 (安装版)	⬇️ ReadMDSetup-v0.0.1.exe	动画安装向导，自动关联 .md 文件为默认打开方式
Windows	x64 (绿色便携版)	⬇️ ReadMD-portable-v0.0.1.exe	单文件绿色版，免安装解压即用
macOS	Apple Silicon (M系列)	⬇️ ReadMD-macos-arm64-v0.0.1.zip	M1 / M2 / M3 / M4 原生构建（含 Vision 离线 OCR）
macOS	Intel x86_64	⬇️ ReadMD-macos-x64-v0.0.1.zip	Intel 芯片 Mac 原生构建（含 Vision 离线 OCR）
Linux	x86_64 (AppImage)	⬇️ ReadMD-linux-x86_64-v0.0.1.AppImage	通用 Linux 免安装 AppImage，赋予执行权限后直接运行
Linux	ARM64 (AppImage)	⬇️ ReadMD-linux-aarch64-v0.0.1.AppImage	飞腾 / 鲲鹏等 ARM64 设备免安装运行
国产信创系统	统信 UOS / 银河麒麟 / Deepin / Ubuntu	⬇️ readmd_0.0.1_amd64.deb	Deb 原生安装包；需以对应系统的实机验收记录为准
️ 麒麟 V10 / 飞腾	ARM64 (aarch64)	⬇️ readmd_0.0.1_arm64.deb	飞腾 D2000/E2000 原生构建，内置 UKUI/X11 与软件渲染安全回退
VSCode 插件	通用 VSIX 扩展包	⬇️ readmd-vscode-0.0.1.vsix	VSCode 离线安装包，支持双向同步预览与格式自愈
MCP Server	FastMCP stdio 独立包	⬇️ readmd-mcp-server-0.0.1.zip	独立 FastMCP 服务端，供 Claude Desktop / Cursor 一键接入
SHA-256 校验	完整性清单	⬇️ SHA256SUMS.txt	全量资产 SHA-256 哈希校验清单

---

多系统与信创国产适配

1. Linux 与国产操作系统适配（统信 UOS / 银河麒麟 / 深度）

• 直接安装使用：下载 readmd_0.0.1_amd64.deb 双击安装，或直接运行 ReadMD-linux-x86_64-v0.0.1.AppImage。银河麒麟 V10 + 飞腾 ARM64 设备使用 readmd_0.0.1_arm64.deb。
• 飞腾安全回退：自动识别 Phytium D2000/E2000/FT 系列；WebKitGTK 启动时优先选择 UKUI/X11、禁用 DMABUF 合成并回退 llvmpipe，避免旧 GPU 驱动白屏或崩溃。
• 系统与环境识别：100% 纯原生 Rust 内核（native_system）自动识别系统发行版，自适应配置 Wayland / X11 显示后端。
• 桌面与深色模式：自动侦测 DDE（统信/Deepin）、UKUI（银河麒麟）与 GNOME/KDE 的外观主题，实时同步深色/浅色配色。
• 桌面集成与关联：内置 FreeDesktop 桌面入口与 MIME 类型声明，支持双击 .md 默认打开。
• 支持边界：本版本不宣称 openEuler、玲珑或其他未列出的发行版具备完整原生支持。

2. Windows & macOS 平台特性

• Windows：内置 WinRT 原生 OCR、WebView2 硬件加速渲染、系统托盘常驻与智能单实例通信。
• macOS：原生 Apple Vision 离线文字识别、WebKit 视窗引擎、跟随系统外观与 Touch Bar 快捷操作。

---

桌面伴读宠物系统 (Live2D & 73 款微呼吸精灵图)

• CC0 Arch-Chan Live2D：高精 Live2D 骨骼动画，随阅读进度与时段动态互动，支持平滑拖动、鼠标穿透和高灵敏点击命中。
• 73 款 Petdex 精灵图自适应与活态微呼吸：内置几何自动推断算法，零延迟智能适配高密序列帧与单立绘小图，彻底杜绝撕裂错位；脚底锚点正弦微呼吸浮动赋予生动生命感。
• 伴读伴侣生活状态引擎：等级、体力、心情、亲密度成长系统，支持摸摸头、喂食、玩耍、休息、唤醒等互动。
• 全端气泡联动：桌面悬浮窗、应用内桌宠小部件、设置面板舞台三端实时同步对话台词，Electron 托盘右键菜单无缝下发。
• 高定苹果风原生滑块 (/apple-design)：采用 Apple HIG 4px 极简精致轨道与 18px 实体物理质感悬浮圆钮，Active 触觉光晕与等宽数字药丸读数。

---

原生高保真矢量 PDF 编辑器

• 结构与微观审计：自动审计 PDF 几何尺寸、DPI、旋转、系统文件锁，并对指定区域进行底色与噪点采样。
• 零污染差分质检 (Zero-Contamination Gate)：沙箱模拟编辑并自动生成对比图与热力图，未通过复核绝不写入原文件。
• 安全无损落盘与一键回滚：落盘前强制生成 .bak 物理备份，解锁 Windows 只读属性；支持一键回滚恢复初始状态。

---

VSCode 扩展与 MCP Server 生态

1. VSCode 插件安装与使用

• 界面安装：下载 readmd-vscode-0.0.1.vsix -> 在 VSCode 扩展面板选择 ... -> 从 VSIX 安装...。
• 命令行安装：

code --install-extension readmd-vscode-0.0.1.vsix

• 核心功能：打开 Markdown 文件点击右上角书本图标开启同步预览；右键菜单支持一键自动修复语法错误与转换为 LaTeX 源码。

2. MCP (Model Context Protocol) Server 配置

直接下载解压 readmd-mcp-server-0.0.1.zip，在 Claude Desktop、Cursor、Antigravity 与 Cline 中配置（请将 args 中的路径替换为本机解压的绝对路径）：

Windows:

{
  "mcpServers": {
    "readmd": {
      "command": "python",
      "args": ["C:\\path\\to\\readmd\\packages\\mcp-server\\readmd_mcp_server.py"],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "readmd": {
      "command": "python3",
      "args": ["/path/to/readmd/packages/mcp-server/readmd_mcp_server.py"],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

注意：必须使用脚本的完整绝对路径，不能使用相对路径；Windows 路径中的反斜杠必须写为 \\ 或改用正斜杠 /。推荐配置 PYTHONIOENCODING=utf-8 以确保跨平台编码一致。

---

LaTeX PRO 学术增强与 BibTeX 引用

1. BibTeX 自动扫描与引用卡片：

• 自动扫描同目录下 .bib 参考文献文件；
• 文中书写 [@vaswani2017attention] 或 @author2024 自动渲染为引用徽章；
• 悬停徽章展示论文标题、作者、年份、DOI 链接并支持一键复制 BibTeX；文末自动汇总生成参考文献表。

1. 学术 Callout 盒子：

• ::: theorem [定理名称] / ::: lemma [引理名称] / ::: definition [概念定义]
• ::: proof 证明块自动添加文末 Q.E.D. ■ 符号。

---

Editor Studio PRO 沉浸编辑

• Zen Mode 禅模式：按 F11 或点击编辑栏「 禅模式」全屏专注写作，按 Esc 退出。
• 10×10 可视化表格设计器：鼠标自由滑选行列生成工整 Markdown 表格。
• 智能表格粘贴：复制 Excel、WPS、Numbers 或网页表格，在编辑器中直接粘贴为 Markdown 表格。
• 实时文档统计：实时显示中文字数、西文词数与预计阅读时间。

---

全球 46 语种 i18n 全量母语化

ReadMD 提供 46 个 locale；每次发布均校验键、占位符与方向一致性。候选版的语义翻译质量和原生平台可用性以对应验收证据为准，不以静态字典数量替代实测。

分区	覆盖语言	详细语言列表
东亚 (6语)	中文/日/韩/蒙	简体中文 (zh-CN)、繁体中文·香港 (zh-HK)、繁体中文·台湾 (zh-TW)、日本語 (ja)、한국어 (ko)、Монгол хэл (mn)
欧洲主流 (19语)	西欧/中欧/东欧/北欧	English (en)、Français (fr)、Deutsch (de)、Español (es)、Português (pt)、Русский (ru)、Italiano (it)、Nederlands (nl)、Türkçe (tr)、Ελληνικά (el)、Magyar (hu)、Українська (uk)、Hrvatski (hr)、Slovenščina (sl)、Română (ro)、Dansk (da)、Norsk (no)、Svenska (sv)、Suomi (fi)
中东与南亚 (7语)	阿/希/维/藏/印/孟/尼	العربية (ar, RTL)、עברית (he, RTL)、ئۇيغۇرچە (ug, RTL)、བོད་སྐད། (bo)、हिन्दी (hi)、বাংলা (bn)、नेपाली (ne)
东南亚 (8语)	泰/越/印尼/马/缅/老/高棉/菲	ภาษาไทย (th)、Tiếng Việt (vi)、Bahasa Indonesia (id)、Bahasa Melayu (ms)、မြန်မာဘာသာ (my)、ພາສາລາວ (lo)、ភាសាខ្មែរ (km)、Tagalog (tl)
特色与区域 (6语)	爱/马耳他/格陵兰/世界/非	Gaeilge (ga)、Malti (mt)、Kalaallisut (kl)、Esperanto (eo)、Ikinyarwanda (rw)、Kikongo (kg)

详细规范与词条清单：docs/i18n-language-reference.md

---

核心功能与使用指南

• 自动修正：表格缺线对齐补全、加粗与公式未闭合自动闭合、#标题 补空格，修正详情在「 修复」面板中清晰展示。
• 万物转 MD：支持 Word、PowerPoint、Excel、PDF、HTML、LaTeX 等批量或拖拽转换，转换后自动在新标签页打开。
• 扫描 OCR：Windows (WinRT) 与 macOS (Vision) 本地离线识别，剪贴板截图一键提取文字。
• 网页转 MD：Trafilatura 智能抽取正文，动态单页应用自动通过无头 WebView 渲染提取。
• 局域网共享：点击工具栏「」生成二维码与随机密钥，手机扫码在同 Wi-Fi 下阅读与编辑。

---

️ 常用快捷键

快捷键	功能操作	快捷键	功能操作
Ctrl+O	打开 Markdown 文件	Ctrl+E	进入/退出编辑模式
Ctrl+S	保存当前文档（首存自动备份）	Ctrl+P	打开导出面板 (PDF/Word/HTML)
Ctrl+F	全文搜索 (Enter 下一个 / Esc 退出)	Ctrl+Shift+F	展开/收起目录大纲侧栏
Ctrl+Shift+A	呼出 AI 助手面板	Ctrl+U	打开网页转 MD 弹窗
Ctrl+D	切换主题 (浅色/暗色/复古)	F11 / Esc	进入 / 退出 Zen 禅模式

---

架构与源码构建

readmd/
├─ rust/readmd-kernel/ # 100% 纯原生 Rust 高性能内核（HTTP 服务 + 自动修正 + 格式转换 + 矢量 PDF + 伴读桌宠）
│ └─ src/ # 原生平台适配 / OCR / 转换 / AI / 插件引擎
├─ ReadMD.exe # 原生高性能单文件可执行文件 (100% Pure Rust)
├─ packages/ # 多端生态分包
│ ├─ vscode-extension/ # VSCode 官方扩展
│ ├─ mcp-server/ # FastMCP (stdio) 服务端
│ ├─ harmonyos-app/ # HarmonyOS/OpenHarmony 实验性源码预览（未支持）
│ └─ linglong/ # 统信 UOS 玲珑容器打包配置
├─ scripts/ # 构建与打包脚本 (windows / linux / unix)
├─ assets/ # 前端渲染、主题 token 与 46 语种 i18n 资源
├─ docs/ # 架构规范、语言对照清单与开发文档
└─ tests/ # 自动化测试套件 (Rust 1,784 项单元测试 + 前端验收全通过)

本地构建与运行：

• 使用 Cargo 编译：cargo build --release -p readmd-kernel，构建产物位于 rust/target/release/readmd.exe（根目录 ReadMD.exe 即为此纯原生二进制）。
• Windows：运行 scripts\run.bat 直接启动原生内核；或直接双击 ReadMD.exe。
• Linux：运行 cargo build --release -p readmd-kernel 后运行 bash scripts/linux/build_linux.sh 打包 AppImage 与 Deb 安装包。
• macOS：运行 cargo build --release -p readmd-kernel 构建原生二进制。
• HarmonyOS/OpenHarmony：本版本不支持，目录仅保留实验性源码预览。

---

更新日志 (v0.0.1-preview.1)

• 46 语种全量母语化与机翻清洗：深入审核 42 个非中英文语言字典，消除波兰语混淆、西部之塔、农作物裁剪等全部系统性翻译错误，实现 100% 完整覆盖。
• Linux 与信创国产系统适配：原生 Rust native_system 模块；正式支持只覆盖矩阵中有实机证据的 Ubuntu、Debian、UOS、银河麒麟和 Deepin 架构。
• 离线来源与 Skills：上游原文、许可证和适配元数据随包提供，AI 指令统一从 Skills 加载。
• LaTeX PRO 学术论文套件：零配置 .bib 参考文献浮动卡片、学术 Callout 盒子与 LaTeX 导出。
• Editor Studio PRO 体验重塑：Zen 禅模式全屏专注、10×10 表格设计器、Excel 智能转换。
• VSCode 插件与 MCP Server 生态完善：升级至 v0.0.1，提供多端 AI 写作协作流。

---

常见问题

• Q: 为什么双击打开速度极快？
• A: 安装版为 onedir 目录部署，启动无需临时解压；关闭后常驻系统托盘，二次打开通过轻量本地通信在 0.3s 内瞬间唤醒。
• Q: 打开未签名安装包被系统拦截怎么办？
• A: Windows 在 SmartScreen 提示点击「更多信息 → 仍要运行」；macOS 首次打开在 Finder 中右键 ReadMD.app 选择「打开」。请核对 SHA256SUMS.txt 校验码。
• Q: 文档格式自动修正常见错误会改写我的原始文件吗？
• A: 绝不会。自动修正仅发生在内存渲染阶段，原 .md 源码保持 100% 完好无损。

---

ReadMD · 纯本地优先，在已验收平台上自由阅读写作。