【免费下载链接】floral-notepaper花笺轻量优雅的跨平台桌面便签工具支持 Markdown 编辑与预览项目地址https://gitcode.com/gh_mirrors/fl/floral-notepaper点击查看免费下载花笺Floral Notepaper是一款主打轻巧、优雅、现代化的本地便签工具基于 Tauri 2 React 构建覆盖 Windows、macOS 与 Linux 三大桌面平台。本文以官方 README 为主线结合仓库源码与配置文件系统讲解其 Markdown 编辑预览、快捷便签、磁贴模式、导入导出、应用内更新等核心能力并给出从下载安装到源码构建的完整实战路径帮助读者快速上手并把花笺融入日常记录场景。项目概览为什么选择花笺市面上的笔记或便签软件要么功能繁重、上手门槛高要么界面陈旧、久未更新。花笺的定位是轻便、随呼随用同时提供现代化的界面与舒适的编辑体验。从技术栈来看它并非简单的 Web 页面套壳而是典型的 Tauri 2 桌面应用前端React 19 Vite TypeScript Tailwind CSS见 package.json后端RustEdition 2021核心数据存储与平台能力封装在 src-tauri/src 下窗口与打包Tauri 2 配置集中在 tauri.conf.json当前版本1.1.0产品名为花笺授权遵循 MIT 协议。主窗口默认为 1180×760最小 900×620无系统装饰decorations: false并开启透明背景保证窗口外观与各平台风格一致macOS 使用原生红绿灯控件Windows/Linux 保留自定义控件。功能特点与源码级实现解析Markdown 编辑与预览花笺支持GitHub Flavored MarkdownGFM语法并可在编辑与预览模式间即时切换。预览渲染链路集中在 MarkdownPreview.tsx依赖链如下react-markdownremark-gfmGFM 语法表格、删除线、任务列表、自动链接等remark-mathrehype-katexLaTeX 数学公式渲染引入katex.min.cssrehype-slug为标题生成锚点 id配合自定义a组件实现文章内标题跳转href以#开头时平滑滚动到对应位置自定义插件 remarkAlerts.ts识别[!NOTE]、[!TIP]、[!IMPORTANT]、[!WARNING]、[!CAUTION]五种 GFM Alerts 标记渲染为带图标的提示块可选renderHtml启用rehype-raw解析行内 HTML并经rehype-sanitize白名单过滤额外放行mark、center、font、u、abbr等标签及style属性兼顾功能与安全。代码块自带语言标签与复制按钮图片通过 imageSrc.ts 将笔记内images/...相对路径解析为本地资源convertFileSrc。预览区的标题、段落、引用、表格、列表均定制了与纸笺主题一致的样式。快捷便签托盘与全局快捷键随呼随用通过系统托盘或全局快捷键默认CtrlSpace可随时唤出独立的小窗便签支持多开。其实现要点默认全局快捷键在 Rust 侧定义macOS 平台默认值为CommandOptionN见 notes.rs小窗视图由 NotePad.tsx 承担支持新建/打开两种模式开启跟随鼠标出现配置项openAtCursor后窗口会在鼠标附近弹出打开页NotepadOpenPanel.tsx内置笔记搜索可按标题/内容实时过滤并显示更新日期小窗与磁贴共用一套便签表面状态机模式切换与动作分发分别通过 surfaceMode.ts 与 surfaceActions.ts 的CustomEvent完成floral-notepaper:surface-mode、floral-notepaper:surface-action。磁贴模式把笔记钉在桌面上磁贴模式将笔记以贴纸形态固定在桌面任意位置便于快速查阅与复制。核心组件是 Tile.tsx通过chroma-js依据磁贴颜色自动推导边框、标题、正文的对比色浅色背景混合深色、深色背景混合白色保证可读性支持自定义磁贴颜色与颜色模式跟随系统/自定义、旋转角度、字号以及renderMarkdown开关磁贴内直接渲染 Markdown 预览行为配置丰富tileCtrlCloseCtrl点击关闭、tileDoubleClickToEdit双击进入编辑、tileSaveReturnsToPin保存后回到磁贴、tileRenderMarkdown等均由 types.ts 中的AppConfig承载窗口按路由区分视图index.html?viewtilenoteId...加载磁贴、viewnotepad加载小窗、无参数为主窗口见 windowRoutes.ts。导入导出支持.md文件的导入与导出前端交互在 importExport/api.ts底层落盘在 notes.rs导入调用系统文件选择对话框open过滤器限定.md随后执行notes_import_markdown命令。Rust 侧import_markdown_file会先校验扩展名非.md抛出unsupportedFile再从文件首行提取标题并入库导出调用保存对话框save默认文件名为笔记标题.md随后执行notes_export_markdown将笔记内容写盘文件名安全导出前经safeFileStem清洗非法字符:/\|?*及控制字符替换为_空白合并、首尾去除、长度截断至 80 字符空标题回退为无标题笔记相关行为由 api.test.ts 覆盖验证。应用内更新与自定义背景v1.1.0 亮点应用内更新在设置中即可检查、下载、安装更新无需手动翻 Release。更新功能支持GitHub Release与Mirror 酱两个来源可配置自动检查频率、下载源优先级、稳定/测试渠道等见 update/types.ts 的UpdateSettings与 update/api.ts 的命令封装。安装更新前会自动保存未保存的笔记Windows 侧还内置了安装回滚、注册表备份与进程校验等兜底MSIX 安装含 Microsoft Store暂不支持应用内更新自定义背景主窗口支持设置、调整与移除背景图片相关配置backgroundImagePath、backgroundFit、backgroundDim、backgroundBlur、backgroundScale、backgroundPositionX/Y已纳入AppConfig选择图片的过滤器限定 png/jpg/jpeg/webp/gif。应用场景当作随时可见的剪贴簿快速暂存和复制文本游戏、看视频时随手记录临时记录思路或灵感桌面待办清单。快速开始下载与安装通过 Mirror 酱下载如果你的网络访问官方源不便或下载速度过慢可通过 Mirror 酱下载花笺同时这也是一种对开发者的赞助方式。支持的平台与架构如下系统架构下载说明Windowsx64Windows x64 SetupWindowsAArch64Windows AArch64 SetupmacOSAArch64 (Apple Silicon)macOS Apple Silicon DMGmacOSx64 (Intel)macOS Intel x64 DMG通过 GitHub Release 下载前往官方 Release 页下载最新版本。安装包文件命名遵循以下规则版本号即发布版本系统架构类型文件名Windowsx64安装程序推荐floral-notepaper_版本号_x64-setup.exeWindowsx64便携版floral-notepaper_版本号.exeWindowsx64安装包floral-notepaper_版本号_x64.msixWindowsAArch64安装程序推荐floral-notepaper_版本号_aarch64-setup.exeWindowsAArch64安装包floral-notepaper_版本号_aarch64.msixmacOSAArch64 (Apple Silicon)DMGfloral-notepaper_版本号_aarch64.dmgmacOSx64 (Intel)DMGfloral-notepaper_版本号_x64.dmg通过 Microsoft Store 下载可在 Microsoft Store 中搜索花笺安装。注意MSIX 安装无论来自 Microsoft Store 还是侧载.msix文件暂不支持应用内更新请通过 Microsoft Store 或官方 Releases 获取最新版本。macOS 安装注意事项macOS 下若遇到安装/打开被拦截的问题属于系统安全策略范畴如 Gatekeeper、未签名应用提示可参考官方 Wiki 的 macOS 安装指引处理。从源码构建完整贡献与构建指南见 CONTRIBUTING.md要点如下。环境依赖Node.js20.19 或 22.12Rust工具链平台依赖平台所需依赖macOSXcode Command Line ToolsLinuxlibwebkit2gtk-4.1-dev、libgtk-3-dev、libayatana-appindicator3-dev、librsvg2-dev、libsoup-3.0-devWindowsMicrosoft Visual C Redistributable、Microsoft Edge WebView2Windows 11 或高版本 Windows 10 已内置构建命令git clone 仓库地址 cd floral-notepaper npm install # 启动开发版 npm run tauri dev # 构建正式版 npm run tauri buildtauri build依据 tauri.conf.json 的bundle.targets生成多平台产物Windows 的 NSIS 安装程序含 x64/AArch64、macOS 的.dmg以及 Linux 的.deb、.rpm与 AppImage。配置文件还声明了.md、.markdown、.txt三种文件关联安装后可直接用花笺打开这些文件。质量检查提交 PR 前需通过本地检查前后端分离# 后端Rust cd src-tauri cargo test -p floral-notepaper --lib # 单元测试 cargo clippy --all-targets -- -D warnings # 静态检查 cargo fmt --check # 格式检查 # 前端 npm test # 单元测试Vitest npx oxlint # 静态检查 npx oxfmt --check # 格式检查数据存储、配置与底层架构配置与数据目录v1.1.0 起应用配置与笔记数据被拆分到各自目录见 notes.rs 的NoteStore配置目录默认位于系统配置目录下的floral-notepaper存放config.json也可通过环境变量FLORAL_NOTEPAPER_CONFIG_DIR覆盖数据目录默认在文档目录macOS 为Library/Application Support下的花笺文件夹内含metadata.json、notes/按分类存放.md笔记、images/按笔记 id 存放粘贴的图片、backgrounds/等见DATA_DIR_ITEMS同样支持FLORAL_NOTEPAPER_DATA_DIR环境变量覆盖从旧版本升级时代码会自动迁移旧默认目录与自定义笔记目录并对迁移失败提供回退保护。配置项一览AppConfigsettings/types.ts覆盖了主要用户设置配置项说明globalShortcut呼出小窗的全局快捷键默认CtrlSpacetoggleVisibilityShortcut显示/隐藏主窗口快捷键closeToTray关闭时最小化到系统托盘autostart开机自启defaultViewMode默认视图模式edit/split/previewnoteAutoSave笔记自动保存tileColor/tileColorMode磁贴颜色与颜色模式系统/自定义theme主题light/dark/systemfontSize/surfaceFontSize主编辑区与小窗字号tabIndentSizeTab 缩进宽度1–8openAtCursor全局快捷键唤出时窗口跟随鼠标位置backgroundImagePath等主窗口背景图片及 fit/dim/blur/scale/position 参数多窗口路由与便签模式应用采用单前端多窗口架构Rust 侧创建主窗口、小窗、磁贴三类窗口前端通过 URL 查询参数view、noteId决定渲染哪个视图windowRoutes.ts。主窗口负责笔记管理小窗与磁贴共享NotePad组件支持在两种便签表面间无缝切换并可通过 controls.ts 完成拖拽、缩放、置顶等原生窗口操作。应用内更新的更新源偏好更新设置支持双源Mirror 酱 / GitHub与优先级配置checkSourcePreference、downloadSourcePreference可取mirrorChyanFirst/githubFirst还可填写 Mirror 酱 CDK 走高速下载通道渠道区分stable/beta并支持预发布版本开关allowPrerelease。开源协议花笺以 MIT 协议开源可自由使用、修改与分发。若遇到问题或希望参与贡献欢迎按 CONTRIBUTING.md 提交 Issue 与 Pull Request为项目持续打磨体验。赞分享【免费下载链接】floral-notepaper花笺轻量优雅的跨平台桌面便签工具支持 Markdown 编辑与预览项目地址https://gitcode.com/gh_mirrors/fl/floral-notepaper点击查看免费下载相关推荐花笺 Floral Notepaper 完全指南Tauri 2 React 轻量桌面便签的安装、功能与源码构建花笺 Floral Notepaper 完全指南Tauri 2 React 轻量桌面便签的安装、功能与源码构建 花笺Floral Notepaper是LTX-Video 视频生成硬件配置实测30 秒出片的最低成本显卡方案LTX Video 视频生成硬件配置实测30 秒出片的最低成本显卡方案 LTX Video 是 AI 视频生成模型硬件配置直接决定生成速度。2B 蒸馏模型配花笺 Floral Notepaper 贡献指南从开发环境搭建到 PR 合并的完整实践花笺 Floral Notepaper 贡献指南从开发环境搭建到 PR 合并的完整实践 本文以花笺Floral Notepaper官方 CONTRIBUT上一篇在 Ruby 项目中安装 LefthookGemfile 与 gem install 完整指南下一篇Onekey Steam Depot清单下载器终极游戏解锁解决方案完全指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考