以下按**统一入口、阅读模块、创作模块、共享基础设施**四大板块组织，每一部分都标注了合并后的增强点。 --- ### 一、统一入口与模式管理 - **启动首页** 展示三个主入口卡片：📖 打开 CHM 文件、✍️ 新建/打开创作项目、⏳ 最近记录（文件+项目）。 - **模式切换** 在阅读模式和创作模式之间无缝切换，支持同一窗口内从阅读器直接跳转到“编辑当前文档源文件”（若存在关联的 Markdown 项目）。 - **多标签页工作区** 阅读标签（.chm）与创作标签（项目）可共存于同一个标签栏，支持拆分视图（左编辑右预览）。 - **全局导航** 统一的侧边栏或顶部导航，在不同模式下显示对应的功能面板（阅读时显示目录/索引/书签，创作时显示文件树/大纲/编译面板）。 --- ### 二、CHM 阅读模块（基于 libchm + NAPI） - **文件打开与解析** 拖拽、菜单、命令行、文件关联打开 .chm；NAPI 负责快速解析、校验、提取元数据。 - **目录与索引导航** 树形目录（hhc）、字母索引（hhk）、页面内锚点跳转、浏览历史（前进/后退）、路径面包屑。 - **内容渲染** 沙盒化渲染 HTML/CSS/JS/多媒体，解决编码乱码（自动检测 GBK/UTF-8，可手动切换）。 - **阅读辅助** 页面缩放（25%-500%）、宽度控制（适合宽度/全宽）、滚动同步（目录自动高亮当前位置）。 - **全文搜索** 高速全文索引与检索（利用 libchm 内置索引或 NAPI 自建），结果高亮、上下文摘要、页面内查找（Ctrl+F）。 - **书签与标注** 书签增删改、文件夹分组；文本高亮、笔记注释，数据持久化并关联文件路径，支持导入/导出。 - **外观个性化** 浅色/深色/护眼主题，自定义字体、字号、行距，侧边栏位置与宽度可调。 - **打印与导出** 打印当前页，导出为 PDF、纯文本、HTML（单页或全书）。 - **会话恢复** 启动时恢复上次打开的文件、标签页、阅读位置、侧边栏状态。 > **合并增强点** > > - 阅读器内可直接将当前 CHM 文件**反编译为 Markdown 项目**（提取 HTML 并转换为 MD，保留目录结构），导入创作模块继续编辑。 > - 右键菜单新增「在创作器中打开同名项目」，快速从阅读跳转至编辑。 --- ### 三、CHM 创作模块（Markdown → CHM） - **Markdown 编辑器** 集成 Monaco Editor，提供语法高亮、自动补全、多光标、分屏编辑/预览、实时渲染。 - **项目与文档管理** 项目树：无限层级文件夹，每个节点绑定 .md 文件；支持拖拽排序、新建/重命名/删除，自动同步 .hhc 目录结构。 - **元数据编辑** 项目级设置：标题、作者、语言、编码（默认 UTF-8）、默认页面、窗口样式、导航控件配置。 - **资源管理** 导入图片、附件等静态资源，自动处理相对路径引用，编译时一同打包。 - **主题与模板** 内置多套 CHM CSS 主题，支持实时预览切换；可编辑自定义 CSS，编译时注入。 - **一键编译与预览** 执行：Markdown → HTML（markdown-it + 插件）→ 生成 .hhp/.hhc/.hhk 项目文件 → 调用平台编译器（Win: hhc.exe，Mac/Linux: chmcmd）→ 输出 .chm。 编译完成后**自动使用内置阅读器打开**，无需切换软件。 - **编译选项** 编码选择、压缩级别、是否生成全文搜索索引、是否包含源码 Markdown 作为附件。 - **编译进度与日志** 实时进度条，输出详细编译日志，错误高亮定位（如缺失资源、语法警告）。 - **项目管理** 新建项目、打开已有项目（目录或 .chmproj 文件）、最近项目列表、项目另存为模板。 > **合并增强点** > > - 编译过程中若出错，可直接点击日志跳转到对应源文件位置。 > - 创作时可按需调用**阅读器的 NAPI 解析能力**，快速预览编译产物内部的某个 HTML 页面效果，而无需完整编译。 > - 支持从阅读器「发送回」当前页面 URL / 内容片段到创作器的笔记面板，辅助资料整理。 --- ### 四、统一基础设施与共享功能 - **外观与主题系统** 全局浅色/深色/自定义主题，shadcn/ui 组件库统一风格，设置跨模块同步（阅读器背景与编辑器配色联动）。 - **全局快捷键** 阅读与创作模式共用一套可自定义快捷键方案，避免冲突。 - **文件关联与系统集成** 注册为系统默认 .chm 查看器；支持 .chmproj 项目文件关联，双击直接打开创作项目。 - **自动更新** 利用 electron-updater 全平台静默更新，同时更新阅读与创作组件。 - **崩溃报告与诊断** 统一捕捉主进程、渲染进程、NAPI 异常，附带当前模式（阅读/创作）信息上报。 - **多语言 (i18n)** 至少中英文，所有界面文案统一管理。 - **命令行接口** `app --read ` 直接进入阅读模式；`app --project ` 进入创作模式；`app --compile ` 直接编译并预览。 - **性能与内存优化** 按模式动态加载模块（阅读时不加载 Monaco Editor；创作时不加载 libchm NAPI），保持轻量。 --- 这份清单完整覆盖了「CHM 工具箱」应有的所有能力，既保持了各模块的深度，又利用合并架构打造出 **“写文档 → 即时预览成品 CHM → 精细阅读与标注 → 反向编辑”** 的闭环体验，在同类软件中具备明显差异化优势。