# local-notes **Repository Path**: simonkingws/local-notes ## Basic Information - **Project Name**: local-notes - **Description**: 复刻 macOS 备忘录的本地桌面笔记应用 —— Python + Tkinter 编写,零第三方依赖,无需联网,数据只存在你自己的电脑上。 - **Primary Language**: Python - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-30 - **Last Updated**: 2026-11-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
复刻 macOS 笔记的本地桌面笔记应用 —— Python + Tkinter,零第三方依赖,默认不联网。
经典三栏布局:左侧文件夹与笔记列表,右侧富文本编辑器
## 主要功能 **写作与排版** - 富文本编辑:加粗 / 斜体 / 下划线 / 删除线、两级标题、文字与下划线颜色,样式随笔记保存并精确还原 - 四种列表(项目符号 / 有序 / 三角 / 待办勾选框)、引用块、行内代码、分割线,标记与正文采用同一套缩进标尺 - 列表按钮是**开关**:光标行 / 选区已是同一种列表时再点一次即清除,否则统一转成该类型(多行可批量互转);有序列表在回车、删除、复制后自动重编号,右键四个列表按钮还能互转 / 重新编号 / 清除 - 第一行恒为标题;`Ctrl+D` / `Ctrl+Y` 整行复制与删除(连同格式与勾选状态) - **左侧行号**:一格 = 正文当前字号的行高,从上到下等距排开(空行和正文末尾以下的空白也有号);行号是刻度尺,不跟内容走,插代码块 / 加标题都不会让某一段挤紧。点行号跳到该行;右键行号可隐藏,恢复入口在 `⋯` 菜单 - **自动换行开关**:工具栏 `↵`(`⋯` 左边)**默认关闭** —— 一行到底,超宽长行用正文底沿的细横条 / `Shift` + 滚轮横向看;点一下切软换行,**按字符**折(一行占满才折,不会在空格处把整段推到下一行;同一段话复制两遍也接着往下排),窗口拉宽或字号放大时折行位置实时重算,**不往笔记里插换行符**;再点一下回不换行。全局视图开关,状态随设置保存,重启沿用 - **`Ctrl+F` 本篇内查找**:浮出查找框,输入即高亮全部命中并显示「第 3 / 12 个」,`Enter` / `Shift+Enter` 上下条、`Esc` 关闭;与左栏的全文搜索互不干扰 - **`Ctrl+H` 查找替换**:同一张浮条展开第二行,可逐处替换或全部替换(`Enter` 替换当前并跳下一条、`Ctrl+Enter` 全部替换);不区分大小写、保留原有文字样式,一次操作一次 `Ctrl+Z` 撤销,只读与未解锁的加密笔记自动拦截 - **涂鸦标注**:`⋯` 菜单 →「涂鸦标注…」或 `Ctrl+Shift+D`,整个窗口罩上薄雾并锁定界面(顶栏 / 侧栏 / 列表 / 正文一起盖住,不能输入、不能切笔记);纯图标工具条(**按住可拖到任意位置**)可画自由曲线 / 直线 / 箭头 / 矩形 / 椭圆 / 编号标记,配 4 色与 3 档粗细,支持逐笔撤销与清空;`Esc` 或 ✕ 退出后**所有涂鸦立即消失**,正文、光标、选区、滚动位置原样恢复。笔迹画在独立窗口里,不进笔记内容、不进撤销栈、不进备份 - markdown 快捷输入:段首敲 `# `、`## `、`- `、`1. `、`> `、`-[] `、`-> `、三个反引号或 `---` 即就地成文,结果只留样式 **效率输入** - **@ 关联笔记**:`@` + 空格浮出候选面板(紧贴文字也认,如「开会@ 」;邮箱里的 `@` 后面不跟空格,不会误触)。面板自带搜索框,弹出即聚焦,输入标题 / 文件夹名实时过滤,空格分词表示「都要命中」;候选**列出全部笔记**,一屏 8 行,滚轮 / 点轨道 / 拖右侧细滚动条都能翻,弹框不会跟着变高;`↑↓` 选择、`Enter` 插入蓝色 `@标题`,单击跳转到目标笔记;存的是 id,改名 / 挪文件夹都不断链 - **超链接**:`[文字](网址)` + 空格直接变蓝,指针悬停浮出小窗可改文字与地址;裸网址同样可点 - **时间函数**:`date()` / `datetime()` + 空格取当前时间 - **公式计算**:`$5+6=` + 空格 → `5+6= 11`,支持括号、`^`、`%`、`sin/cos/tan`,算完即删触发符 - **任务提醒**:正文里插入闹钟图标,到点右下角浮出置顶卡片(日期用日历、时间用时分选择框);左栏「加密笔记」下面的 **任务提醒** 分类里有一篇自动生成的「任务提醒列表」,逐条列出**时间 / 任务 / 是否已完成(时间已过即算)/ 是否已确认(点过弹窗才算)**,行末 `@笔记名` 点一下跳回原笔记;正文是带加粗表头的**五列表格**,各列按制表位像素级对齐(任务名长短、中英混排都不挤歪),过长的任务名截断成 `…` **代码块** - 内置代码块,顶部语言条随时切换:纯文本 / JSON / XML / HTML / Java / Python / Bash / SQL,等宽字体 + 轻量语法高亮 - 一键复制、一键格式化:JSON / HTML / XML 结构化重排,SQL 按关键词断行(每个字段各占一行),Java / Python / Bash 重排缩进 - 格式化前统一中文标点(仅 JSON / SQL),字符串与注释内部原样保留 **整理与检索** - 左栏两组:**智能分类**(全部 / 星标 / 加密 按条件筛的视图,加一张自动汇总的「任务提醒」)+ **文件夹**(可建多级,最多 5 层);四格智能分类都不可改名 / 删除 / 移动。文件夹里第一格是 **系统**,专放内置说明,不可改名 / 删除 / 移动,清空数据后依然在 - 多级文件夹:缩进 + 行首箭头收起 / 展开,父级计数与视图包含整棵子树;支持全部展开 / 全部收起、拖拽移动、右键「移动笔记到…」目标树 - 全文搜索即时过滤(SQLite FTS5,环境不支持时回退 LIKE),命中词在正文里标黄 - 「跳到所属文件夹」:在聚合视图或父视图里右键笔记,一步回到它真正所在的位置 - 列表内**拖拽排序**:上下拖,落点有主题色细线提示;顺序落库,之后改内容不会跳位 - 新建笔记排到列表第一个(置顶笔记之后):排序优先级是「置顶 → 手动顺序 → 星标 → 最近修改」 - 列表每条笔记左缘一道**辨识色条**(8 色,挑用得最少的分配,颜色随笔记走、不随排序变;超过 8 条必然重复,但相邻两条保证不同色) - 星标、置顶 **多标签页** - 点列表里的笔记开成一枚标签,重复点击切回已有的那枚;`Ctrl+Tab` 切换、`Ctrl+W` 关闭、标签上右键可关闭单枚 / 其它 / 所有 / 左侧 / 右侧(只关标签不删笔记),**标签条空白处右键**同样能「关闭所有标签」(外加新建一篇),标签随设置持久化 - 可在「全局设置 → 标签页」里整个关掉(默认开着):标签条当场消失、标签快捷键一并停用,正文编辑不受影响 **笔记加密** - 任意笔记可设加密口令:正文在数据库里只留密文,搜索用明文列一并清空 - PBKDF2-HMAC-SHA256(20 万次迭代 + 随机盐)派生密钥,再以 SHA-256 作 PRF 的 CTR 加密 + HMAC 认证,先验签再解密,全部只用标准库 - 切走即重新封上;口令只留在内存、退出即忘,不落盘,也无法「找回原口令」 - **每篇笔记一份独立恢复码**:设完 / 改完口令自动展示一次,抄下才能启用;忘口令可用它取回内容并当场重设新口令,正文密文一个字节不动,旧版程序读新密文照常按口令解开 - 恢复码只属于这一篇、程序绝不保存,别和数据库放同目录;改口令会换码,老笔记解锁后可单独补建;备份带恢复槽但不带码 - 「复制恢复码」给的是整条凭证 `[笔记名称]-[凭证编号]-[恢复码]`(三段各自包在方括号 `[ ]` 里、用连字符连接,笔记名称里带下划线或空格也不会串段,便于在密码管理器里对号);恢复时整条粘进输入框即可,程序自动取出末尾那段码,单独粘一段纯码也照常认 - 忘口令的入口在**未解锁提示条**(「忘记口令?用恢复码 →」)、口令框底部和右键菜单三处;编辑 / 切走笔记不会让恢复槽失效 **数据与备份** - 本地 SQLite 单文件存储,旧版 JSON 数据首次启动自动迁移 - 单篇导出 `.txt` / `.md` / `.pdf`;整库备份默认导出 `.json.gz`(真 gzip,解压后是**编码容器**、看不到笔记正文,导入自动解码),口令可留空、也可填了做真加密;导入支持覆盖或合并(按正文指纹去重),旧版明文 / 旧版 `.json.gz` 备份照旧能导;内置说明笔记不进备份,导入时按当前版本重建 - 保存失败时另存 `data/pending_*.json` 兜底快照,下次启动提示可恢复 - 单实例运行,避免两个窗口同时改写同一个库 **外观与细节** - 左栏两列可拖宽(双击分隔条恢复默认);工具栏共 15 枚,可折叠、可自定义显示哪几枚按钮(含自动换行开关) - 6 套内置主题(森林绿 / 云母白 / 石墨灰 / 羊皮纸 / 午夜蓝 / 晴空蓝),全局设置里是**六枚圆形色卡**:圈内按各主题自己的配色着色、下方写名称,点一下就换,不用下拉框;**首次打开默认森林绿**;两套深色刻意分家:石墨灰=中性炭灰 + 琥珀金,午夜蓝=藏蓝 + 靛蓝;晴空蓝=浅天蓝顶栏与侧栏 + 白稿纸 + 亮蓝强调;**森林绿整窗跟随 WorkBuddy 当前外观**(底色、字色、主题色一起走),其余固定不变。悬停 / 选中 / 浮层的状态色按语义推导,换主题不撞色 - 圆角自绘 UI、长标题悬停跑马灯、顶栏即窗口标题栏 - 高 DPI:声明系统 DPI 感知 + 全局像素缩放,125% / 150% / 200% 下按物理像素渲染;图标按缩放档预渲染,运行时零缩放 - 多显示器:右键菜单 / 悬停气泡 / @ 候选层 / 对话框都按**所在那块屏**的工作区摆位,副屏(坐标为负)上弹出也不会跑到主屏去,贴边时自动内收、不压任务栏 - 手动「检查更新」:读 GitHub Releases 比对版本,后台下载支持断点续传,替换只覆盖程序文件(`data/` 一个字节不动) ## 快速开始 无需安装任何依赖,电脑上有 Python 3 即可运行: ```bash python scripts/notes_app.py ``` 启动后会在项目根目录的 `data/` 下自动创建 `notes_data.db` 数据库文件。 运行测试(`python -m unittest discover -s tests`)与打包 exe(`target/build.bat`)见 [开发与打包](docs/开发与打包.md)。 > 项目图标即仓库中的 [`icon/app_icon.png`](icon/app_icon.png),同时作为应用窗口 / 任务栏图标(由 `scripts/notes_app.py` 启动时加载)。各尺寸的成品在 [`icon/px/`](icon/px) 下,由 `target/gen_icons.py` 生成 —— 见 [开发与打包](docs/开发与打包.md#图标)。 ## 文档 详细用法、数据说明与开发指引都在 [`docs/`](docs/README.md) 下: | 文档 | 内容 | | --- | --- | | [使用指南](docs/使用指南.md) | 界面与操作、文件夹整理、编辑排版、代码块、加密、提醒、搜索 | | [快捷键](docs/快捷键.md) | 全部快捷键、markdown 快捷输入一览 | | [数据与备份](docs/数据与备份.md) | 存储位置、导出 / 导入、保存兜底、检查更新与网络访问 | | [开发与打包](docs/开发与打包.md) | 目录结构、分层依赖、测试、打包 exe、PDF 导出原理 | ## 技术栈 - **语言**:Python 3 | **GUI**:Tkinter | **数据**:SQLite3(FTS5 + trigram,回退 LIKE)——全部标准库 - **分层**:`store`(数据)→ `theme`(配色)/ `dpi`(缩放)→ `widgets`(控件)→ `app_ui` / `app_actions`(界面 / 动作)→ `notes_app`(入口) - **测试**:标准库 unittest,`python -m unittest discover -s tests` ## 许可证 本项目基于 [Apache License 2.0](LICENSE) 开源。