文匣（WenJia）— 功能介绍

一款基于 Electron + C++ DLL 的 Markdown 笔记与知识库工具。笔记以本地 Markdown 文件存储，经 SVN 版本管理，支持快速捕获、文件夹整理与修订历史回溯。

一款基于 Electron + C++ DLL 的 Markdown 笔记与知识库工具。笔记以本地 Markdown 文件存储，经 SVN 版本管理，支持快速捕获、文件夹整理与修订历史回溯。

一、软件概览

文匣面向需要「离线优先 + 版本可追溯」的个人/团队知识管理场景，采用 Electron + React 前端与 C++ backend.dll（libsvn）后端：

Markdown 原生：正文即 .md 文件，不锁死在私有数据库
SVN 工作副本：本地 file:// 或远程 Trunk，保存即纳入版本库
三栏工作台：文件夹 · 笔记列表 · 编辑/预览
快速捕获：全局快捷键写入 Inbox，不打断当前写作

文匣主工作台

主界面：文库树、笔记列表、Markdown 编辑与预览分屏

二、主要功能

2.1 工作台布局

| 区域 | 说明 | |------|------| | 顶栏 | 文库路径面包屑、保存状态、捕获/搜索/侧栏折叠 | | 左栏 | SVN 文库切换、文件夹树、标签入口 | | 中栏 | 当前文件夹笔记列表、全文搜索 | | 右栏 | 多标签编辑区、Markdown 工具栏、实时预览 | | 底栏 | SVN 修订号、本地/远程文库状态 |

文件夹与标签

2.2 Markdown 编辑与预览

双栏：编辑器 + 预览，滚动联动
工具栏：粗体、斜体、列表、引用、代码、链接等快捷插入
多标签：同时打开多篇笔记，未保存提示（琥珀色磁盘图标）
标题必填，保存前校验

编辑与预览

2.3 文库组织

文件夹树：新建/重命名/删除，子文件夹嵌套
笔记列表：摘要、修改时间、标签、置顶标记
全文搜索（Ctrl+K）：跨整棵文库树搜索标题与正文，展示所在路径
右键菜单：在资源管理器中打开、删除等（依上下文）

说明：标签筛选、快速打开（Ctrl+P）等入口已在 UI 预留，部分能力仍在迭代中；博文宜标注「即将接入」或截图时暂不强调。

2.4 快速捕获

灵感稍纵即逝时，无需切回主窗口：

快捷键：Ctrl+Shift+N（全局，应用外亦可唤起）
独立小窗，默认写入 Inbox 文件夹
支持 Markdown，保存后主窗口列表自动刷新

快速捕获

2.5 SVN 版本管理

文匣的核心差异点：笔记即 SVN 工作副本中的文件。

文库模式：

| 模式 | 适用 | |------|------| | 本地文库 | 单机 file:// 工作副本，Documents/WenJia | | 远程 Trunk | 团队 SVN 服务器 trunk URL |

设置项：

远程 Trunk URL、用户名/密码（可会话级保存）
信任服务器证书、提交前自动 update
手动 SVN 同步 / Update，状态栏显示 r1234

SVN 设置

2.6 笔记历史与恢复

选中笔记后可查看 SVN 修订历史：

修订列表（作者、时间、日志）
点击修订查看与当前版本的差异
一键恢复到指定修订

笔记历史

2.7 菜单与快捷键

| 操作 | 快捷键 | |------|--------| | 新建笔记 | Ctrl+N | | 保存 | Ctrl+S | | 快速捕获 | Ctrl+Shift+N | | 全局搜索 | Ctrl+K | | 折叠侧栏 | Ctrl+B | | 粗体 | Ctrl+B |

菜单栏

三、使用流程示例

示例 1：日常记笔记

启动文匣，在目标文件夹点击「新建笔记」
填写标题，Markdown 编辑
Ctrl+S 保存 → 后端写入 .md 并提交 SVN

示例 2：会议灵感快速入库

开会中按 Ctrl+Shift+N 唤起捕获窗
输入要点，保存
会后回到主窗口，在 Inbox 整理到对应笔记本

示例 3：团队远程文库协作

SVN 设置 → 远程 Trunk，填写服务器 URL 与凭据
启动时 Update 到最新 r
编辑保存后，同事 Update 即可拉取你的笔记变更
误改内容时，用笔记历史对比并恢复旧修订

四、技术特点

Electron + React + TypeScript：现代桌面 UI
C++ backend.dll + Koffi：高性能文件与 SVN 操作（libsvn）
离线优先：本地 Markdown 文件，无网可读写
SVN 而非 Git：贴合企业现有 SVN 基础设施
无边框窗口：自定义标题栏与菜单栏

五、下载

| 版本 | 说明 | 下载链接 | |------|------|----------| | 绿色版 | 解压即用 | 待补充 | | 安装版 | 一键安装 | 待补充 |

六、系统要求

操作系统：Windows 10 及以上（64 位）
运行环境：已内置 Electron 运行时
可选：可访问的 SVN 服务器（远程文库模式）

七、结语

文匣适合个人知识库、产品/研发笔记、以及已使用 SVN 的团队文档协作。若在使用中有功能建议，欢迎反馈。