feat: optimize startup and add Windows installer

This commit is contained in:
shen committed 2026-09-17 14:56:48 +08:00
1 parent 4113236128
commit a097ce8f4b
36 files changed
+2661 -935

No files matched your search

+13 -11
View File
@@ -31,22 +31,21 @@ MDHelper 是一个本地 Markdown / 代码文档阅读器,适合阅读项目
打包版可以同样接收路径参数:
```powershell
.\dist\MDHelper.exe D:\CODE\SomeProject
.\dist\MDHelper\MDHelper.exe D:\CODE\SomeProject
```
MDHelper 支持同时运行多个程序窗口。不同窗口可以打开不同文件夹,标签页、搜索、设置和自动刷新状态互不影响。
## 3. 主界面
界面主要分为三部分:
界面主要分为两部分:
| 区域 | 功能 |
|---|---|
| 左侧文档栏 | 打开文件夹、刷新、搜索、文件树、文件类型过滤结果。 |
| 左侧导航栏 | 在“目录”和“大纲”间切换;目录包含搜索与文件树,大纲显示当前文档标题。 |
| 中间标签页 | 阅读、编辑、预览、媒体页面和欢迎页。 |
| 文档内容右侧 | 网页内文档大纲,随正文滚动高亮当前章节。 |
默认阅读模式会把文档大纲和阅读进度放在网页内部,减少 Qt 控件同步,让滚动更接近浏览器网页。右侧旧 Qt 目录栏默认关闭;只有在设置中关闭网页内大纲并启用外部目录栏时才显示。
阅读页只显示正文,不在网页内部生成大纲或进度条。左侧大纲不会随正文滚动高亮;只有用户点击标题时才执行跳转,避免长文档滚动时持续计算当前位置。
## 4. 阅读 Markdown
@@ -60,9 +59,7 @@ Markdown 支持:
- 本地图片、GIF、音频和视频。
- 本地链接跳转和外部链接打开。
阅读页内的文档大纲位于正文右侧,点击章节可跳转。窄窗口下大纲会自动折叠或隐藏。
右下角阅读进度条会跟随主题改变颜色。进度条只在网页内部更新,Python 端只低频保存滚动位置。
切换左侧的 `大纲` 页签并点击章节即可跳转。滚动位置仍会低频保存,用于重新打开文档时恢复阅读位置。
## 5. 纸张宽度与每行字数
@@ -115,12 +112,15 @@ Markdown 支持:
- 行号和当前行高亮。
- 查找、替换、区分大小写、全词匹配。
- 插入标题、加粗、斜体、代码块、表格、链接、图片、提示块、Mermaid、公式。
- 点击“转换latex公式到md”,可将全文中的 `\\[` 和 `\\]` 一键转换为 `$$`,并支持回退撤销。
- 打开文件夹后,可通过“文件 → 新建文件”或左侧目录树右键菜单直接创建 `.md` 文件。新文件会在目标目录中自动生成并进入文件名编辑状态,无需打开浏览窗口。
- 左侧目录树支持多选文件;右键单个文件可重命名,右键选择“删除”并确认后可批量移入系统回收站。右键非根文件夹还可在确认后删除该文件夹及其内容。
- `Ctrl+S` 保存。
- 另存为。
- 自动保存草稿和恢复草稿。
- 保存前检测磁盘文件是否被外部程序修改,避免覆盖外部编辑。
编辑预览中的网页内大纲可点击定位源码标题。预览刷新使用防抖机制,避免每次按键都重新渲染。
编辑时左侧大纲可点击定位源码标题。预览刷新使用防抖机制,避免每次按键都重新渲染。
## 9. 样式管理
@@ -186,7 +186,9 @@ MDHelper 读取文档时不会独占文件,外部程序仍可修改文件。
- DOCX
- MHTML
DOCX 导出可选择 `pandoc` 或 `python-docx` 相关实现。导出的 HTML 默认不包含网页内阅读进度条,避免把阅读状态写进文档。
PDF 导出前会显示设置窗口,可分别设置上、下、左、右页边距。导出文件固定使用白色纸张背景,自动移除阅读页大纲和进度条,并在正文前生成带真实页码的目录;正文从目录后的新页面开始。
DOCX 导出可选择 `pandoc` 或 `python-docx` 相关实现。正式安装版已包含 Pandoc,无需用户另行下载或配置 PATH。导出的 HTML 与阅读页一样不包含阅读进度控件。
## 13. 配置与迁移
@@ -226,6 +228,6 @@ MDHelper 会保存:
打包版:
```powershell
.\dist\MDHelper.exe --check --project-root .
.\dist\MDHelper\MDHelper.exe --check --project-root .
```
Reference in new issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.