NEO-Reader · 信息图文最终的极简框

语言 / Language：中文 ｜ English

本地优先的 HTML / Markdown 阅读与编辑桌面应用 · Windows · Electron 阅读优先 · 双格式统一 · 本地离线 · 无需账号

一款把 HTML 与 Markdown 双格式文档的「阅读、编辑、演示」收敛成极简三栏的桌面工具——左栏文件、中栏阅读、右栏按需编辑。

🎯 为什么做：痛点与定位

• 痛点：HTML 与 Markdown 常需两套工具、来回切换；阅读与编辑割裂，改个字也要进源码模式；非开发者被 Markdown 语法劝退；在线工具依赖网络与账号，隐私无保障。
• 定位：本地优先、阅读优先、双格式统一、轻量便携。
• 明确不做：云同步、多人协作、插件生态、移动端。

👤 适用人群与场景

人群	场景	诉求
求职 / 学习者	面试问答、笔记、岗位分析（.md）	结构化阅读、快速编辑、演示播放
内容 / 知识工作者	HTML 页面、长文大纲、素材库	原样查看、局部修改
非开发者	用 Word 式直觉编辑 Markdown	免学语法、可视化改样式
轻量演示者	把文档当演示逐段播放	自动分页、播放

🖼️ 界面：三主题

阅读与编辑统一在三栏内，支持 白 / 黑 / 黄 三主题：

白 · White	黑 · Black	黄 · Yellow

✨ 核心功能

• 双格式统一：HTML + Markdown 同栏阅读 / 编辑 / 播放
• MD 可视化编辑：块级点选编辑（段落样式、上移下移、删除插入）、自动排版、约束分页 + 内容拾取断点
• HTML 编辑：预览 + 原位文字编辑，沙箱禁脚本
• 播放演示：MD 按标题 / 序号自动分段分页、自适应时长；HTML 锚点分页 / 滚动

• 搜索（文件名 / 内容）· 导出 PDF · 撤销 / 重做 · 会话记忆 · 外部修改检测
• 中英双语界面 · 快捷键（Ctrl+S / O / N、Ctrl+Z / Y）

📥 安装 / 运行方式

① 安装版 · Installer

• 文件：NEO-Reader Setup 0.1.0.exe
• 用法：双击 → 下一步 → 装到 Program Files，生成快捷方式，可卸载

② 便携版 · Portable

• 文件：NEO-Reader 0.1.0.exe
• 用法：免安装，双击即用；绿色单文件，可放任意目录 / U 盘

③ 终端 / PowerShell 安装

.\install.ps1 -Mode install                                      # 静默安装安装版（NSIS）
.\install.ps1 -Mode portable -Target "D:\Apps\NEO-Reader"      # 复制便携版到指定目录

④ 源码运行 / 打包（本地）

.\run-desktop.ps1        # 运行（需本地安装 electron）
.\package-desktop.bat    # 打包 EXE

📦 打包产物

运行 package-desktop.bat 后，产物在 desktop\dist\：安装版 + 便携版。

📁 项目结构

├─ desktop/        # Electron 壳（main.js / preload.js / package.json）
├─ docs/           # 文档与截图
├─ build/          # 图标
├─ install.ps1     # 终端安装脚本
└─ run-* / package-*  # 启动与打包脚本

🛣️ 路线图

• ✅ MVP：双格式阅读编辑、播放、打包 EXE
• ✅ M1 稳定化：撤销 / 重做、会话记忆、外部修改检测、HTML 沙箱、导出 PDF
• ⏳ M2 完善：多文件标签页、搜索索引、编码写入、模板
• ⏳ M3 发布：无障碍、代码签名、自动更新、Tauri 体积优化

🛠️ 技术栈

Electron · 原生 Web 界面 · electron-builder

📝 许可

MIT

English version: README.en.md