本地构建需要 Windows 和 .NET 10 SDK;克隆时必须带 --recurse-submodules,否则要先执行 git submodule update --init --recursive;插件需手动放入 plugins/ 目录才会被识别。
PaperTodo
snownico0722活跃维护一款极简的 Windows 桌面便签工具,用 WPF 原生实现,把几张安静不打扰的纸贴在桌面上,支持待办清单和 Markdown 编辑。
A minimalist Windows desktop sticky note tool. It puts a few quiet, usable, and unobtrusive sheets of paper on your desktop. Native WPF, with support for to-dos and Markdown.——极简 Windows 桌面便签工具。让桌面上有几张安静、可用、不会打扰人的纸。WPF 原生,支持待办与 Markdown。
git clone --recurse-submodules https://github.com/snownico0722/PaperTodo.git
cd PaperTodo
dotnet build -c ReleaseREADME 未说明具体硬件要求;平台为 Windows x64,基于 .NET 10 与 WPF 原生构建,主打低内存与低 CPU 占用。
原生 WPF 的极简 Windows 桌面便签,把待办和 Markdown 笔记变成常驻桌面的纸片
一款极简的 Windows 桌面便签工具,用 WPF 原生实现,把几张安静不打扰的纸贴在桌面上,支持待办清单和 Markdown 编辑。
核心能力
- 待办纸支持拖拽排序、滑动多选和多行粘贴智能拆分
- 笔记纸支持三档实时 Markdown 渲染与本地图片粘贴拖入
- 纸片可折叠成贴边胶囊,悬停展开可交互预览卡片
- 插件系统可把纸片切换成时钟、番茄钟等桌面微应用
- 用 --mcp 启动本地 MCP 服务供外部 AI 读写待办与笔记
容易踩的坑
- v3.40PaperTodo v3.40最新正式版2026-10-20 · 2026-10-20 15:48 UTC
纸片与胶囊
- 快捷关闭纸片:展开的纸片支持 Ctrl+W 或标题栏中键关闭。
- 「主胶囊缩短」选项:高级设置新增该选项(默认关闭),开启后主胶囊仅显示展开/收起箭头并缩窄宽度。
- 开启“再次点击收回”后,关联待办的纸片也可通过再次点击关联的图标再次点击隐藏。
- 关闭普通胶囊、贴边胶囊或主胶囊后,仍保留各队列已调好的高度,仅在恢复默认设置时重置。
- 从胶囊展开纸片时先激活窗口;若展开途中切到其他程序,动画结束不再抢回焦点,原最大化纸片会在下次激活时恢复。
待办与笔记
- 浏览态拖入文字:浏览状态的笔记支持直接拖入普通文字,并支持撤销。
- 大列表显隐提速:全部显示/隐藏时不再重建整个待办列表,保留当前输入框焦点、选区和撤销记录,减少长列表卡顿。
- 外部打开笔记时,若所选后缀无关联应用,自动回退使用记事本打开。
- 粘贴待办超条数/字数上限,或笔记输入达上限时的自动截断会弹出上限提示。
- 修复笔记右键“粘贴”无法插入图片内容的问题。
- 修复复制粘贴透明图片出现黑底、或全透明图片变不透明的问题。
系统与数据安全
- 数据保存可靠性增强:优化保存逻辑,降低强制关机情况下丢失文件的风险;降低备份更新频率并在更新前校验可用性。
- 多屏开机位置保护:开机副屏未就绪时先短暂等待再开放操作,避免纸片和胶囊被提前拉回主屏覆盖原坐标。
- 开机自启动状态与 Windows「启动应用」实时同步。
- 修改 PowerShell 版本或窗口显示偏好时,不再中断运行中的常驻脚本;仅在明确关闭常驻模式时结束进程。
- 优化退出速度:正常退出时并行停止运行中的脚本并清理临时文件,减少退出等待。
bug修复和优化
- 修复关闭“展开时保留边缘胶囊”后,纸片展开位置和大小无法记住的问题。
- 修复跨显示器、跨不同缩放比例(DPI)屏幕恢复纸片时,位置错误或尺寸偏差的问题。
- 优化当管理员权限的全屏程序在前台时,纸片和胶囊可能无法退到其后方避让的问题。
- 修复开启“已完成自动置底”后,长列表中勾选待办可能导致滚动条跳到底部或重置其他输入框光标的问题。
- 优化编辑纸片标题时,Ctrl+Z / Ctrl+Y 会撤销恢复标题内容,而不是正文。
- 修复切换“标准 / 柔和 / 隐藏”缩放把手设置后,角落点阵未立即刷新的问题。
下载:
- 完整版(含 .NET 运行库):PaperTodo-v3.40-win-x64-self-contained.exe
- 精简版(需自行安装 .NET 运行库):PaperTodo-v3.40-win-x64-no-runtime.exe
- Windows 7 SP1 x64 Best Effort(含 .NET 运行库):PaperTodo-v3.40-win7BestEffort-win-x64-self-contained.exe
- v4.0.0-beta1PaperTodo v4.0.0-beta1pre-release2026-09-15 · 2026-09-15 22:29 UTC
查看更新说明
这是一个测试版,可能存在很多问题、bug。 This is a beta version; it may contain many issues and bugs.
边缘预览与胶囊
- 边缘实时预览:鼠标悬停在边缘胶囊即可浏览和操作内容,无需打开完整纸片即可即时浏览内容。
- 待办实时预览:实时显示简化待办列表,支持直接浏览、勾选完成或撤销,点击卡片背景可直接呼出完整纸片;关联或快启操作使用更稳定的独立点击区域。
- 笔记实时预览:支持 6000 字符,且同步笔记 Markdown 完整渲染。
- 流畅接续与意图预测:内置可调节的鼠标移动意图预测,在胶囊间连续浏览时减少误切换; 可开启“浏览时优先向下展开”,开启后向下切换时,只要目标卡片仍能完整显示,就优先向下展开,而不是补位。
- 重复点击胶囊优化:展开纸片仍明显可见时,再次点击对应边缘胶囊会将其收回;如果纸片被其他窗口明显遮挡,则优先带回前台而不是在看不见的位置折叠。
- 边缘胶囊收缩优化:截短的标题现在可在悬停时滑动展开到完整长度,移开后自动收回,并支持完全隐藏或不限长度显示。。
- 待办与笔记胶囊的图标和标题对齐。
- 隐藏关闭按钮不留空位。
- 主胶囊精简,仅显示数字。
插件系统与桌面微应用
- 便签微应用容器:笔记纸可按需切换为独立的桌面微应用(如专注番茄钟、拟物时钟、复盘池或系统监控面板);设置中新增独立「插件」管理中心,数据安全隔离保存在
plugins/data/目录下(10 MB / 20 MB 限制)。- Web / Native 双模运行时架构:
- Web 插件:基于 WebView2,使用前端标准栈(HTML/CSS/JS)编写,无需编译开箱即用。
- Native 插件:基于 .NET 10 + WPF 原生开发,支持完全自绘的高性能桌面交互。
- 全方位宿主开放能力:
- 专属胶囊与悬停 Mini 视图:插件可自定义折叠胶囊形态(支持图标、文本、动态进度条/环或纯 WPF 自绘图形),并可为边缘悬停提供专属的轻量迷你卡片;
- 待办深度联动:插件可向待办项注册右侧操作图标与右键菜单项;
- 顶栏与按键:插件可在纸片顶栏添加操作按钮与状态标签,支持注册专属全局快捷键,并可声明独占接管
Esc键与正文右键菜单; - 纸片菜单与轻量弹窗:插件可添加纸片右键文字入口,读取有权限的笔记图片,并从按钮或菜单点击处打开失焦自动关闭的小界面;
- 国际化支持:插件清单支持多语言本地化配置,随系统语言自动适配。
- 安全性:不设人为安全沙箱,非官方插件仅建议安装可信来源;
- 示例:
- 示例插件:Codex CLI Bridge:可从待办操作或纸片顶栏,将当前待办或整张纸片连同相关上下文直接发送到本机 Codex CLI,并支持自定义默认提示词。
- 原生时钟、专注番茄钟、复盘记录池、Web 时钟等,适配窄窗口、胶囊与 Mini 视图。
- 仓库
plugin-samples/中含有完整示例源码。 - 仓库
plugins/中的插件可直接使用。
- Web / Native 双模运行时架构:
待办与 Markdown
- 全文搜索:
Ctrl+F查找全部待办与笔记,显示当前纸片及全局匹配计数。支持Enter/Shift+Enter或点击翻找命中项(跨纸片高亮并自动展开对应胶囊),搜索栏支持拖拽移动。 - Markdown 所见即所得编辑:新增完全渲染,达到真正MD完全渲染体验,任务框可勾选,支持块渲染,编辑时也可以完全渲染,不会跳变,体验优于大部分Md编辑软件。
- Markdown 解析与显示一致性重构:笔记的标题、引用、列表、代码块、链接、简单 HTML、转义与图片代码区判断统一 Markdown 语义,减少复杂嵌套时样式、点击和列表编辑不一致。
- 待办多选与批量操作:沿左侧滑动连续选中多条,批量勾选 / 恢复、复制、右键删除或整组拖入垃圾箱。方向键可跨项连续编辑,长按不连跳。
- 待办提醒:支持自定义时长、预设间隔、当天傍晚、次日早晨等,到期弹出定位高亮并发送托盘通知和提示音。
- 纸片上限从 100 提至 200 张。
Ctrl+Shift+C可将多选待办复制为保留完成状态的 Markdown 任务列表,或将笔记选区复制为纯文本。- Markdown 支持粗斜体(
***文本***/___文本___)、粗体 / 斜体 / 删除线 / 链接组合及反斜杠转义。
重要 bug 修复和优化
- 数据保存与输入保护:增强极端情况下的保存可靠性,降低备份更新频率并在更新前校验可用性。
- 全屏避让:修复开启「全屏时避让置顶窗口」后,部分管理员权限全屏程序处于前台时仍被纸片遮挡的问题。
- 启动与退出提速:并行和队列优化启动退出,速度提升50%。
外观、设置与交互
- 自定义纸片背景:在
PaperTodo.exe旁放入papertodo.png、papertodo.jpg或papertodo.jpeg,可自定义纸片背景。- 视觉设置可选原图或叠加纸片配色;“拉伸”为独立开关,位置可选居中 / 左下 / 正下 / 右下。
- 解码最长边为 4096 像素。
- 设置重构:左侧导航,并优化显示;按当前工作区适配小屏、高缩放与跨 DPI 切屏;开关和快捷键录制局部刷新,减少闪动;边缘浏览相关设置已移出实验室,归入常规设置。
- 当前纸片快捷关闭:当前展开纸片支持
Ctrl+W,支持鼠标中键点击标题栏关闭。
实验室功能
- 本地 MCP:以
--mcp启动标准服务,外部 AI 可按授权读取、新建、追加和管理笔记 / 待办;设置可一键复制配置和 AI Skill 提示词。 - 外部窗口绑定:可将便签顶栏的「窗口绑定」按钮拖到任意第三方软件窗口,使便签自动贴靠并平滑跟随目标窗口移动、最小化与恢复。
- 边缘磁吸胶囊:普通浮动胶囊拖近屏幕或外部窗口边缘时可自动吸附停靠,鼠标移入滑出、移开自动收回。
- 新增全局快捷键:
- 锁定全部纸片
- 切换全部纸片或当前纸片透明度
- 切换全部胶囊透明度
- 将纸片 / 胶囊置底
- 失焦自动化:支持纸片失焦后自动半透明、隐藏标题图标/标题栏,或自动收起为胶囊。
- 静置半透明:支持让普通/贴边胶囊在静置时自动半透明,并分别调整透明度。
- 贴边 / 主胶囊可取消强制置顶。
其他 bug 修复和优化
- 待办批量粘贴超出数量 / 文本限制,或笔记达到输入保护范围时会给出明确提示,避免静默丢弃或无反馈拒绝。
- 优化胶囊展开后的焦点稳定性:从胶囊打开纸片后会更可靠地取得前台焦点,避免纸片已展开但按键仍作用在原窗口的问题。
- 修复快捷键页“恢复本页默认”时未恢复“小键盘数字键区分”选项状态的问题。
- 修复设置下拉菜单未完整跟随主题配色的问题。
- 修复开启“记住展开位置”时,纸片与边缘胶囊位于不同屏幕,收起后再次展开会被拉回胶囊所在屏幕的问题;新记忆的位置支持不同缩放比例的屏幕。
- 修复边缘胶囊拖拽至副屏后点击展开可能误回到原显示器的问题。
- 长笔记输入仅更新受影响的 Markdown 范围;跨行代码围栏增删改时追踪实际范围,避免重复全文解析或漏更新。改善高刷新率、混合 DPI 多屏下的胶囊动画、切屏和窗口跟随。
- 不含 .NET 运行时的 Windows 单文件包开启独立压缩从 33 MiB 缩至 17 MiB。
Edge Preview & Capsules
- Live edge previews: Hover over an edge capsule to browse and interact with content without opening the full paper.
- Todo live preview: Shows a simplified todo list with direct check / uncheck actions. Click the card background to open the full paper; linked-paper and quick-launch actions use stable dedicated click targets.
- Note live preview: Supports up to 6000 characters and follows the note's Markdown rendering.
- **Smoother handoff and intent predi
- 边缘实时预览:鼠标悬停在边缘胶囊即可浏览和操作内容,无需打开完整纸片即可即时浏览内容。
- v3.31PaperTodo v3.312026-08-30 · 2026-08-30 17:28 UTC
查看更新说明
bug修复和优化
- 修复快捷键页恢复默认设置:点击“恢复本页默认”后,“区分小键盘数字键”会正确恢复为默认关闭,主键盘数字与小键盘数字继续混合响应。
- 修复 Markdown 标题内行内样式字形:标题中的斜体、删除线和下划线会保留标题原有的粗体与自定义粗体字形,不再只保留标题字号。
- 高级设置视觉区分:开启高级设置后,高级选项会以轻微染色背景与边框分组显示,更容易与常用设置区分。
- 修复含图笔记静置时的持续刷新问题:修复含图片的笔记在前台静置时反复触发图片刷新,导致 CPU / GPU 占用持续偏高的问题。
- 含图笔记缩放性能优化:调整纸片大小时复用已显示的图片内容,并减少缩放过程中的重复刷新与处理,降低含图笔记连续缩放时的额外开销。
- 修复自定义字体增强加粗的 Markdown 正文适配:启用增强加粗后,笔记中的 Markdown 标题、粗体和
<b>/<strong>会正确使用自定义粗体字形。 - 修复开启“已完成待办自动置底”后,通过底部 +、Enter 或多行粘贴新增待办时,已完成事项可能不再保持置底的问题。
- 修复部分输入法状态下录制全局快捷键时,按键可能被错误识别、导致快捷键无法正常保存或触发的问题。
Bug fixes and improvements
- Reset shortcut settings correctly: “Restore defaults for this page” now turns off “Distinguish numpad digits” as expected, so the number row and numpad continue to trigger the same shortcuts.
- Preserve heading typography in Markdown: Italic, strikethrough, and underlined text inside headings now retain the heading's bold weight and custom bold font, rather than only its font size.
- Clearer advanced settings: Advanced options now use subtly tinted backgrounds and grouped borders to make them easier to distinguish from common settings.
- Fix repeated refreshes in notes with images: Notes containing images no longer repeatedly refresh while idle in the foreground, avoiding sustained high CPU and GPU usage.
- Faster resizing for notes with images: Reuse displayed image content and reduce repeated refreshes and processing while resizing a paper.
- Custom bold fonts in Markdown: With enhanced bold enabled, Markdown headings, bold text, and
<b>/<strong>elements correctly use the custom bold font. - Fixed completed items losing their position at the bottom when new todos were added using the bottom + button, Enter, or multi-line paste with “Move completed items to bottom” enabled.
- Fixed key recording with some input methods incorrectly recognizing keys and preventing global shortcuts from being saved or triggered.
Downloads / 下载
- Full version, runtime included / 完整版,含 .NET 运行库: PaperTodo-v3.31-win-x64-self-contained.exe
- Windows 7 SP1 x64, best effort, runtime included / 尽力兼容版,含 .NET 运行库: PaperTodo-v3.31-win7BestEffort-win-x64-self-contained.exe
- Smaller download, .NET Desktop Runtime required / 精简版,需自行安装 .NET 桌面运行库: PaperTodo-v3.31-win-x64-no-runtime.exe
- v3.3PaperTodo v3.32026-08-23 · 2026-08-23 12:43 UTC
查看更新说明
待办与快启
- 文件/文件夹快启:待办项支持直接拖入本地文件或文件夹作为快启路径,可直接打开、打开所在位置或解除关联,路径失效时会有明显提示;快启路径与纸片关联互斥。
- 关联任意纸片:待办关联由仅支持笔记扩展为支持关联任意纸片(待办纸或笔记纸),无缝兼容已有笔记关联数据。
- 已完成自动置底:待办新增“已完成自动置底”选项,勾选完成后自动移到已完成区域末尾,取消完成时移回未完成区域末尾(开启自动清除时暂不触发)。
笔记与 Markdown
- Markdown 裸链接识别:正文中的纯文本
http:///https://网址可直接点击打开;行内代码和代码块中的示例网址保持纯文本,句末标点、括号与成对强调标记不会混入实际网址。 - 含图笔记渲染性能优化:修复含图片笔记在前台静止时,视口细微变化可能触发连续重绘导致 GPU 占用偏高的问题。
- 大图导入内存优化:导入和压缩大图时直接按目标尺寸解码,不再提前完整解压原始像素,显著降低瞬时内存峰值。
胶囊与视觉
- 贴边胶囊间距调节:视觉设置中新增贴边胶囊间距选项(0 / 4 / 8 DIP),默认保持为 4 DIP。
- 阴影层次优化:重新调整了展开纸片、普通胶囊、拖出的贴边胶囊以及主/贴边胶囊的阴影层次,使不同形态更易区分。
设置与系统体验
- 多语言界面选择:设置中新增语言切换选项(跟随系统、简体中文、English、日本語、한국어),保存后重启生效,修复语言切换无效。
- 小键盘数字键选项:全局快捷键支持设置是否区分主键盘数字键与小键盘数字键(默认混合响应)。
bug修复
- 提升旧版 Windows 系统的启动兼容性,避免部分特殊环境下启动异常。
- 修复通过全局快捷键、托盘“显示全部”或显隐切换唤醒纸片时,开启“记住展开位置”的纸片可能未回到上次展开位置的问题
- 优化多纸片批量恢复,减少重复重排并同步刷新关联状态。
- 修复调整 Windows 显示缩放、DPI 或跨不同显示器后,笔记图片未能及时重新排版并按新 DPI 重新解码的问题。
- 减少笔记预览与 Markdown 渲染模式下的重复刷新。
- 修复笔记编辑状态下首次打开纸片右键菜单时可能闪现后立即关闭的问题。
- 关闭胶囊或贴边胶囊模式时保留“显示主胶囊”的用户偏好,重新开启后自动沿用。
- 修复贴边胶囊右键菜单打开二级菜单后,点击子项可能被外部点击保护提前关闭的问题。
- 优化全屏避让体验,修复无边框全屏程序运行时,隐藏任务栏或窗口切换入口的纸片仍可能压在全屏画面上方的问题。
- 修复运行中切换 Windows 显示缩放或跨不同 DPI 显示器后,托盘右键菜单可能偏离鼠标位置或首次打开异常关闭的问题。
- 匿名使用统计,会发送匿名信息供版本改进。
- 仅带有纸片关联或快启路径的空文字待办项会被妥善保留,不再被空项清理或按 Backspace 键静默删除。
- 恢复待办右键菜单的键盘入口,支持通过菜单键或
Shift+F10唤出。 - 减少待办右键菜单的重复创建,降低无意义的界面开销。
Todos and quick launch
- File and folder quick launch: Drop a local file or folder onto a todo to link its path. Open it, reveal its location, or unlink it from the todo; invalid paths are clearly marked. A todo can link to either a path or a paper.
- Link any paper: Todos can now link to another todo paper as well as a note paper. Existing note links remain compatible.
- Move completed items to bottom: When enabled, checking an item moves it to the end of the completed section; unchecking it moves it to the end of the active section. This behavior is suspended while automatic clearing is enabled.
Notes and Markdown
- Clickable plain URLs: Plain
http://andhttps://URLs in note text can be opened directly. URLs in inline code and code blocks remain plain text, and trailing punctuation, brackets, and paired emphasis markers are excluded from the link. - Better rendering performance for notes with images: Fixed small viewport changes causing continuous redraws and high GPU usage while a note was idle in the foreground.
- Lower memory use when importing large images: Images are decoded directly at the target size during import and compression, avoiding a full-resolution decode and reducing peak memory use.
Capsules and appearance
- Adjustable edge capsule spacing: Choose 0, 4, or 8 DIP in Appearance settings; the default remains 4 DIP.
- Clearer shadows: Refined shadows for expanded papers, floating capsules, capsules dragged out of a queue, and master/edge capsules to make their states easier to distinguish.
Settings and system integration
- Interface language selection: Choose System default, 简体中文, English, 日本語, or 한국어 in Settings. Changes take effect after saving and restarting. Fixed language changes not taking effect.
- Numpad digit option: Global shortcuts can distinguish numpad digits from the number row; by default, both trigger the same shortcut.
Bug fixes and other changes
- Improved startup compatibility with older Windows versions, avoiding startup failures in some environments.
- Fixed papers with “Remember expanded position” enabled sometimes opening in the wrong location when restored through global shortcuts, the tray's “Show all,” or visibility toggles.
- Improved batch restoration of multiple papers, reducing repeated layout work and refreshing link states together.
- Fixed note images not promptly updating their layout or decoding at the new DPI after changing Windows display scaling or moving between monitors.
- Reduced repeated refreshes in note prev
- v3.2.1PaperTodo v3.2.12026-08-05 · 2026-08-05 05:16 UTC
查看更新说明
PaperTodo v3.2.1-额外bug修正 bug修复和边界修正
- 优化全屏避让:取消边缘胶囊的高频置顶保护,改为前台窗口事件触发、1 秒轻量检查和 5 秒全局兜底;关闭避让后不再保留相关监听与定时检查。
- 修复程序重启后,直接从未展开的贴边胶囊右键删除非空纸片时,删除确认框可能导致异常退出的问题。
- 修复笔记进入并退出编辑状态后,正文右键菜单可能恢复旧标题或旧操作状态的问题。
PaperTodo v3.2.0-内容 本版本为稳定优化版本,不含各种全新功能 插件支持和其他实验性功能不包含在内 优化
-
缩放优化 纸片调整大小方式可在「视觉」中选三档(默认柔和):
标准为右下角点阵正常不透明
柔和为右下角点阵约 50% 透明
隐藏不显示点阵,可拖动纸片四边或四角缩放
-
优化打开速度,将纸片重建预热操作后台队列处理,提升启动速度
-
优化退出,降低菜单视觉残留
-
笔记图片缓存:同一张笔记图片只保留一份解码缓存,最多约 20 张或约 50 MB ,降低内存占用。
-
优化图片显示清晰度,按DPI 和实际显示宽度精确解码。
-
窄纸片顶栏自适应:纸片支持更小的最小宽度,并自动折叠顶栏按钮。
-
顶栏关联状态与对齐优化:笔记未关联待办时显示
⌖,已被待办关联时显示⦿;同时顶栏按钮视觉对齐。 -
编辑器依赖更新:AvalonEdit 更新至 6.3.1.120。
bug修复和边界修正
-
纸片右键菜单优化:新增快速打开设置,笔记直接用外部 MD 编辑器打开,删除操作使用危险色提示,增加右键菜单动态读取展开折叠。
-
修复隐藏的胶囊重新打开后仍会显示的问题,修复启动时忽略已隐藏纸片/胶囊的
isVisible配置。 -
纸片不再响应 Windows 最小化命令:普通状态下按 Win+↓ 不会最小化;从最大化恢复到普通窗口及最大化操作仍保持系统默认行为。
-
修复隐藏单张纸片时,其他贴边标签可能连续闪动并重复向上挪移的问题;标签现在会一次移动到最终位置。
-
修复同一软件同时存在全屏与普通窗口时,切到普通窗口后纸片或胶囊可能反复闪烁的问题;切到桌面、任务栏或其他窗口会及时解除避让,同时保留浏览器视频和演示进入全屏时的自动识别。
-
修复从笔记右键菜单选择图片后,编辑器偶尔提前切回浏览态,导致图片没有插入且无错误提示的问题。
PaperTodo v3.2.1 — additional fixes
Bug fixes and edge cases
- Improved fullscreen avoidance: replaced frequent edge capsule topmost enforcement with foreground-window events, a lightweight 1-second check, and a 5-second fallback check. Disabling fullscreen avoidance also removes the related listeners and timers.
- Fixed a possible crash after restarting the app when deleting a non-empty paper directly from the context menu of an edge capsule that had not yet been expanded.
- Fixed a note's content context menu sometimes reverting to an old title or outdated actions after entering and leaving edit mode.
Also included: v3.2 improvements
This release focuses on stability and refinements. Plugin support and other experimental features are not included.
Improvements
- Resize handle options: Choose one of three modes in Appearance settings. Standard shows an opaque dotted handle in the lower-right corner; Soft (the default) shows it at about 50% opacity; Hidden removes the dots while allowing resizing from any edge or corner.
- Faster startup: Paper restoration warm-up work now runs through a background queue.
- Cleaner exit: Reduced lingering menu visuals when closing the app.
- Note image cache: Keep one decoded copy of each image, with a cache of approximately 20 images or 50 MB, reducing memory use.
- Sharper images: Decode images according to the display DPI and their actual displayed width.
- Adaptive title bars for narrow papers: Papers support a smaller minimum width and automatically collapse title-bar buttons.
- Improved link indicators and title-bar alignment: unlinked notes show
⌖, while notes linked from a todo show⦿. - Updated AvalonEdit to 6.3.1.120.
Bug fixes and edge cases
- Better paper context menus: Added quick access to Settings and opening notes in an external Markdown editor, highlighted deletion with a warning color, and kept expand/collapse actions in sync with the paper's current state.
- Preserve hidden papers and capsules after restart: Fixed startup ignoring their saved
isVisiblestate. - Papers no longer respond to the Windows minimize command:
Win+↓does not minimize a normal paper window. Maximizing and restoring a maximized window keep their standard Windows behavior. - Fixed hiding a paper making other edge capsules flash and repeatedly shift upward. Capsules now move directly to their final positions.
- Fixed papers or capsules flickering when switching from a fullscreen window to a normal window of the same app. Fullscreen avoidance is promptly released when switching to the desktop, taskbar, or another window, while fullscreen browser video and presentations remain recognized.
- Fixed choosing an image from a note's context menu sometimes returning the editor to reading mode too early, leaving the image uninserted without a
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Preview
| Papers |
|---|
| Markdown View |
|---|
| Edge Browsing |
|---|
| Capsule Mode | Advanced Capsules |
|---|---|
![]() | ![]() |
| Papers can collapse into compact capsules to reduce desktop clutter. | Collapsed capsules automatically dock to screen edges and slide out on hover. |
Philosophy
- Paper first — Every paper is an independent window that lives directly on the desktop, with no layered management console to open first.
- Ready immediately — Write when you want, check things off when done; everything saves automatically and the interaction path stays short.
- No unnecessary management — PaperTodo deliberately avoids complex project-management models, reducing the mental overhead of everyday capture.
- Native & lightweight — Built natively with WPF, without a Web wrapper, for fast startup and low resource use.
- Restrained interaction — The UI stays clean and low-distraction: quiet when idle, immediately available when needed.
No unnecessary interaction layers. No unnecessary visual focus.
Core Features
1. Two Basic Paper Types
- Todo Paper: A clean, efficient checklist with drag-and-drop ordering, continuous swipe multi-selection, and smart splitting of multi-line paste; completed items can be cleared automatically or moved to the bottom.
- Note Paper: Lightweight Markdown and visual notes with three levels of real-time rendering, natural editing/reading flow, and support for pasting or dropping local images.
2. Edge Capsules & Live Preview Cards
- Collapse & Dock: Click the top-right button or press
Ctrl+Wto collapse a paper into a compact capsule that automatically docks to a screen edge and frees up desktop space. - Hover Preview Cards (Preview): Hover an edge capsule to smoothly open a lightweight interactive preview card and inspect content without opening the full paper window:
- Todo Preview: Scroll, check, or uncheck visible tasks directly in the hover card; click the card background to open the full paper.
- Note Preview: Instantly renders Markdown body layout and image placeholders.
- Intent Prediction & Seamless Handoff: Built-in pointer-intent prediction keeps transitions smooth while moving across adjacent capsules and retracts automatically when the pointer leaves.
- Multi-Monitor Flow & Master Capsule: Drag capsules across displays and edges; the master capsule at the top can collapse the whole queue and can be dragged to adjust the queue's starting height.
3. New Plugin System (Preview)
- Desktop Micro-App Expansion: Papers are not limited to notes—you can switch them into clocks, focus Pomodoro timers, review pools, and other rich plugins: a next-generation take on Windows desktop widgets.
- Deep Capsule & Top-Bar Integration: Plugins can collapse into dedicated capsules, provide edge-hover cards and custom top-bar actions, while keeping their data stored independently.
- Drop-in Use: Place a plugin folder in
plugins/and PaperTodo can recognize it directly. To build your own plugin, see the Plugin Development Manual.
4. Ultra-Smooth Native Experience & High-Refresh Tuning
- Full high-refresh optimization: Paper folding/unfolding, edge drawer motion, card handoff, and cross-monitor dragging are deeply tuned for frame pacing, with full support for 120Hz/144Hz/165Hz+ displays for a smooth, stutter-free feel.
- Pure native responsiveness: Built with .NET 10 and native WPF without Web-wrapper overhead, aiming for millisecond-level interaction, very low memory/CPU use, and unobtrusive always-on operation.
- Incremental rendering for long notes: Note input uses localized incremental parsing so long text-and-image notes remain responsive and IME input stays smooth.
- Smooth multi-monitor and mixed-DPI flow: Deeply adapted for multi-display setups with different scaling factors, keeping cross-screen dragging and edge docking precise without flicker or distortion.
5. Universal Todo Linking & Script Capsules
- Quick Launch & Universal Linking: Drag the link icon from another paper's top bar, or drop a file/folder from File Explorer onto a todo item, then click it to jump straight to the target.
- Script Capsules (PowerShell): Put
!por!poweron the first line of a note to turn it into a script runner; when collapsed it becomes a lightning capsule that executes the script when clicked.
6. Advanced Labs Features (Preview)
- Local MCP Interface: Start PaperTodo with
--mcpto expose a standard MCP service, allowing authorized external AI assistants such as Claude or Cursor to securely read, write, and manage todos and notes. - Third-Party Window Tethering: Drag to attach a paper to any third-party app window so it follows that window smoothly as it moves, minimizes, and restores.
- Scheduled Reminders: Todo items support custom countdown reminders with tray notifications and alert sounds when due.
- Idle Behavior & Desktop Integration: Papers can auto-collapse into capsules on focus loss and compact their title bar while idle; global shortcuts can send papers behind other windows and enable mouse click-through for deeper desktop integration.
7. Customization & Data Ownership
- Appearance Customization: Follow system/light/dark themes, choose from Warm Paper, Ink, Forest, and Rosy palettes, use a custom font by placing
papertodo.ttf, and switch between multiple UI languages. - Local Control: Data and images stay in the application directory (
data.jsonandnote-assets.lmdb), with automatic snapshot backups before writes and full offline operation.
Common Operations & Shortcuts
| Action | Shortcut / Trigger | Description |
|---|---|---|
| Collapse / Hide Paper | Ctrl + W or middle-click the top bar | Collapses into a capsule when enabled; otherwise hides the paper |
| Cancel / Retract | Esc | Cancels multi-selection/drag; collapses the current paper when no other interaction is active |
| Undo / Redo | Ctrl + Z / Ctrl + Y | Available in both Todo and Note, with up to 100 history steps |
| Note Formatting | Ctrl + B / I / K | Bold, italic, insert link |
| Note Font Zoom | Ctrl + Scroll Wheel | Zoom note text; click the percentage at bottom-right to reset |
| Retrieve All Papers | Double-click tray icon | Highlights and pulls all papers back into view, useful after monitor disconnects or window drift |
Download & Run
PaperTodo is a portable single-file application and requires no installation. Download the version you need from Releases:
PaperTodo-...-self-contained.exe(Recommended): Includes the .NET runtime and can be launched directly after download.PaperTodo-...-no-runtime.exe: Smaller download for systems that already have .NET 10 Desktop Runtime (x64) installed.
Tip: Keep the executable in a dedicated writable directory such as
D:\Apps\PaperTodo\. Avoid read-only locations or temporary extraction folders. PlacePaperTodo.icoin the application directory to use it as a custom tray icon.
On first launch, papers appear on the desktop and the PaperTodo tray icon remains available. If papers are covered or moved off-screen, double-click the tray icon to show and retrieve all papers.
Documentation & Advanced Guides
- 📖 Full User Manual: Includes a three-minute getting-started guide, advanced Todo/Note usage, multi-monitor capsule management, the full settings reference, script rules, device-migration guidance, and FAQ.
- 🧩 Plugin Development Manual: Learn the PaperTodo paper-body plugin extension model, protocol details, and example index.
- 📋 Changelog: Review release changes and fixes.
Build & Dependencies
Local builds require Windows and the .NET 10 SDK:
git clone --recurse-submodules https://github.com/snownico0722/PaperTodo.git
cd PaperTodo
dotnet build -c Release
If you cloned without submodules, initialize them first:
git submodule update --init --recursive
dotnet build -c Release
Feedback & Community
- Bugs & suggestions: GitHub Issues
Thanks to the linux.do community for the support.
预览
| 纸片 |
|---|
| Markdown 浏览 |
|---|
| 边缘浏览 |
|---|
| 胶囊模式 | 高级胶囊 |
|---|---|
![]() | ![]() |
| 纸片可折叠为小胶囊,减少桌面占用。 | 折叠胶囊自动贴到屏幕边缘,悬浮时滑出。 |
设计理念
- 纸片优先 — 每张纸都是独立窗口,直接常驻桌面,无需打开层级复杂的管理后台。
- 即时使用 — 想记就写,勾选即完;所有内容自动保存,操作路径极短。
- 无需管理 — 不刻意承载复杂的项目管理逻辑,降低日常记录的心智负担。
- 原生轻量 — 基于 WPF 原生开发,拒绝 Web 套壳,启动快速且资源占用低。
- 交互克制 — 界面干净低干扰,该安静时安静,需要时随时呼出。
拒绝长出非必要的交互层级和视觉焦点负担。
核心特性
1. 两种基础纸片
- 待办纸(Todo):清爽高效的任务清单。支持拖拽排序、连续滑动多选、多行粘贴智能拆分;已完成项支持自动清除或置底。
- 笔记纸(Note):轻量 Markdown 与图文备忘。支持常用 Markdown 语法与三档实时渲染,编辑与浏览自然融合;支持粘贴或拖入本地图片。
2. 边缘胶囊与实时预览卡片
- 折叠贴边:点击右上角或按
Ctrl+W将纸片折叠为小胶囊,自动靠在屏幕边缘,彻底释放桌面空间。 - 悬停预览卡片(Preview):鼠标悬停在边缘胶囊上,即可平滑展开轻量、可交互的预览卡片,无需打开完整大窗口即可即时速览:
- 待办预览:直接在悬停卡片上滚动查看、勾选完成或撤销,点击卡片背景呼出完整纸片;
- 笔记预览:即时渲染 Markdown 正文排版与图片占位;
- 意图预测与顺滑接续:内置鼠标移动意图预测,在相邻胶囊间连续滑动时平滑过渡切换,离开后自动收回。
- 多屏流动与主胶囊:支持多显示器拖拽换边;顶部主胶囊可一键收拢整列入口,拖动可调节队列起始高度。
3. 全新插件系统(Preview)
- 桌面微应用扩展:便签不仅能记笔记,还可一键切换为时钟、专注番茄钟、复盘池等丰富插件,下一代的windows桌面小组件。
- 深度融入胶囊与顶栏:插件同样支持折叠为专属胶囊、边缘悬停卡片与专属顶栏按钮,且数据独立安全保存。
- 即放即用:将插件文件夹放入
plugins/目录即可直接识别。如需自行开发插件,可查阅 插件开发手册。
4. 极致流畅与全链路高刷调优
- 全面适配高刷新率:无论是纸片折叠展开、边缘抽屉滑出、卡片顺滑接续还是跨屏拖拽,全链路动效均经过深度帧率调优,完美适配 120Hz/144Hz/165Hz+ 高刷屏,细腻丝滑、完全不掉帧。
- 纯原生极速响应:基于 .NET 10 与 WPF 原生构建,拒绝任何 Web 套壳的性能开销,毫秒级即点即开,内存与 CPU 占用极低,常驻后台毫无负担。
- 长笔记增量渲染:笔记输入采用智能局部增量解析,面对长篇图文依然流畅跟手,彻底杜绝输入法卡顿。
- 多屏与混合 DPI 顺畅流转:深度适配多显示器与不同缩放比例环境,跨屏拖拽与边缘停靠计算精确,不闪烁、不形变。
5. 待办万物互联与脚本胶囊
- 快速启动与万物关联:从另一张纸片顶栏拖出关联图标,或直接从文件管理器拖入文件/文件夹至待办项,点击即可一键直达。
- 脚本胶囊(PowerShell):笔记首行写入
!p或!power,便签即可化身脚本运行器;折叠后显示闪电胶囊,点击直接执行脚本命令。
6. 实验室深度能力(Preview)
- 本地 MCP 接口:支持通过
--mcp模式启动标准 MCP 服务,允许外部 AI 助手(如 Claude、Cursor 等)按授权安全读写与管理待办和笔录。 - 第三方窗口绑定:可拖拽绑定至任意第三方软件窗口,随目标窗口一同平滑移动、最小化与还原。
- 定时提醒:待办支持设置自定义倒计时提醒(到期托盘通知与提示音)。
- 静置与桌面融入:支持失焦自动收起为胶囊、静置收拢标题栏;支持快捷键一键置底并开启鼠标穿透,彻底融入桌面壁纸。
7. 个性化与数据安全
- 外观定制:跟随系统/浅色/深色主题,内置暖纸、墨、林、霞四套配色;支持自定义字体(放置
papertodo.ttf即可生效)与多语言界面。 - 本地自主可控:数据与图片完整存放在程序所在目录(
data.json与note-assets.lmdb),写盘前自动快照备份,完全离线运行。
常用操作与快捷键速查
| 操作 | 快捷键 / 触发方式 | 说明 |
|---|---|---|
| 折叠 / 隐藏纸片 | Ctrl + W 或顶栏中键 | 启用胶囊时折叠为胶囊,未启用时隐藏 |
| 取消交互 / 收起 | Esc | 取消多选/拖拽;无状态时折叠当前纸片 |
| 撤销 / 重做 | Ctrl + Z / Ctrl + Y | 待办与笔记通用(支持深达 100 步记录) |
| 笔记文本格式 | Ctrl + B / I / K | 对应加粗、斜体、插入链接 |
| 笔记字号缩放 | Ctrl + 滚轮 | 缩放正文字号(右下角点击百分比一键复位) |
| 找回全部纸片 | 双击托盘图标 | 显亮并拉回全部纸片(多屏断开或窗口漂移时瞬间召回) |
下载与运行
PaperTodo 为绿色单文件程序,无需安装。请在 Releases 页面 下载对应版本:
PaperTodo-...-self-contained.exe(推荐):已内嵌 .NET 运行时,下载后双击即可直接运行。PaperTodo-...-no-runtime.exe:体积更小,适用于电脑已安装 .NET 10 Desktop Runtime (x64) 的环境。
提示:建议将程序存放在有写入权限的专用目录(如
D:\Apps\PaperTodo\),请勿存放在只读目录或临时解压目录中。程序目录下放置PaperTodo.ico可作为自定义托盘图标。
首次运行后,纸片会出现在桌面上,托盘区会常驻 PaperTodo 图标。若纸片被遮挡或移出屏幕,双击托盘图标即可显示并拉回所有纸片。
详细文档与进阶
- 📖 完整用户手册:包含新手 3 分钟入门指南、待办/笔记深度用法、多屏胶囊调度、全量设置项大字典、脚本编写规则、换机数据迁移教程及常见问题解答(FAQ)。
- 🧩 插件开发手册:了解 PaperTodo 正文插件扩展机制、协议说明与示例索引。
- 📋 版本更新日志:查阅更新与修复记录。
构建与依赖
本地编译需 Windows 环境并安装 .NET 10 SDK:
git clone --recurse-submodules https://github.com/snownico0722/PaperTodo.git
cd PaperTodo
dotnet build -c Release
如克隆时未拉取子模块,请先执行:
git submodule update --init --recursive
dotnet build -c Release
反馈与交流
- 提交 Bug 或建议:GitHub Issues
- QQ 交流群:551612664(奇奇怪怪的魔法研究基地)
感谢 linux.do 社区的支持。

