要解决的问题
日常笔记和项目上下文需要快速进入、长期可读和本地可控，但通用笔记工具经常在捕获速度、Markdown 体验和数据可迁移性之间取舍。
活跃
Mudsnote
面向快速捕获、搜索、富 Markdown 编辑和本地知识沉淀的 macOS/iOS 笔记工作流。
OVERVIEW
Markdown 优先的捕获和笔记系统
Mudsnote 是一个本地笔记表面，强调快速输入和 Markdown 编辑体验。产品方向是轻量、原生、文件友好：快速进入、稳定编辑、可预测存储，并在有帮助的地方提供伴随入口。
- 角色
- 产品 owner 与原生应用开发
- 重点
- 捕获路由、编辑器体验、伴随 app、打包验证。
- 技术
- SwiftSwiftUISQLiteiOS WidgetMarkdownmacOS
方法
- 把快速捕获、Markdown 编辑和本地存储作为核心产品面。
- 使用原生 macOS/iOS 表面降低进入成本。
- 公开演示只使用 demo notes，真实笔记保持私有。
结果
- 笔记工作流更贴近日常真实输入场景。
- 内容结构保持可检查和可迁移。
- 公共项目展示可以说明产品方向而不泄露私人知识库。
ARCHITECTURE
Mudsnote public-safe 架构
说明捕获、编辑器、本地存储和 demo 表面，同时避免暴露真实私人笔记或知识库。
公开证据
- macOS 包和 iOS companion target。
- URL scheme 捕获入口和 widget launcher。
- 把编辑器行为当作核心产品表面处理。
数据边界
- 不发布私人笔记。
- 截图只使用 seeded demo notes。
更新记录
全部应用更新 ↗开发记录按代码变更日期整理；功能快照标注收录日期，正式发布单独标记。
共 14 项
总览支持连续画布和多层大纲
- 优化总览导图与大纲的日间、夜间样式，统一细线图标和顶部工具栏。
- 导图支持持续平移，在空白处右键新建内容，并记住自由摆放的位置。
- 完善多层节点编辑、折叠、整支拖动与撤销重做，同时保留笔记保存和启动更新功能。
启动时检查更新，退出后自动安装
- 启动和重新打开应用时在后台检查已发布版本，菜单支持手动检查并显示当前构建版本。
- 发现更新后等待应用退出再安装，保留签名校验与回退保护，避免打断笔记编辑。
- 修复切换笔记等待后台保存的问题，并恢复侧栏宽度记忆。
区分总览新建与普通新建，恢复悬停反馈
- 侧边栏、菜单和新标签页继续使用普通笔记编辑器，只有总览内新建使用卡片。
- 恢复图标、按钮和笔记行的鼠标悬停反馈，保留已有保存逻辑。
优化 Notes 式列表与导航交互
- 保留笔记标题、摘要、辅助信息和缩略图，优化悬停与选中反馈。
- 统一图标栏与列表背景，移除白边接缝。
- 普通笔记与总览卡片保持各自的新建和编辑入口，导航前保存当前内容。
新增个人总览与原位卡片编辑
- 通过宗旨、领域和子领域整理现有笔记，建立卡片之间的连接。
- 卡片直接预览正文，点击后原位展开编辑，收起时保留内容和连接。
- 新增侧边快捷按钮，保留原有笔记列表与保存保护。
修复重复浮窗与显隐切换异常
- 重复启动时复用已有应用，避免同一笔记出现多套浮窗。
- 浮窗按当前笔记复用，隐藏、切换笔记及不同路径打开时保持一致。
退出前完成后台删除
- 关闭或退出前等待后台删除完成，避免操作结果丢失。
- 删除失败时恢复笔记显示并取消本次退出，保留后续重试机会。
批量恢复与多行粘贴更可靠
- 批量恢复部分失败时，成功项立即更新，失败项保留选中并可重试。
- 新建或清空笔记后粘贴多行纯文本，正文不再误用标题样式。
恢复资料库启动与搜索清除
- 启动时在后台准备笔记目录，避免 iCloud 路径访问阻塞窗口。
- 进入最近删除时刷新列表，清除搜索后及时恢复完整资料库。
输入搜索词不会自动打开笔记
- 输入时更新搜索结果，按回车或明确选择后才打开笔记。
搜索更新期间避免打开旧结果
- 输入新关键词后，结果更新完成前不会误打开上一次搜索的笔记。
退出保存与资料库恢复更可靠
- 关闭资料库或退出时等待保存完成，写入失败时保留编辑并支持重试。
- 后续保存成功后清除旧失败记录，避免改名后重复恢复旧内容。
- 迁移账户后可恢复当前账户对应的原笔记目录，保留共享目录和其他账户设置。
简化资料库与笔记信息
- 收紧文档标签和侧边栏控件，把可选标签与关联信息融入正文。
- 创建与修改时间集中显示在文档底部。
移动笔记保留引用，冲突时保留副本
- macOS 重命名、移动笔记或文件夹时维护相对引用。
- iOS 编辑遇到保存冲突时，可另存副本并保留原文。
没有匹配结果
试试更简短的关键词，或清除筛选。
接下来
- Demo note workspace规划
- 编辑/捕获截图组规划
- 公开 README 摘要规划