Boardly

一款原生、离线优先的 macOS 个人任务看板。

Boardly 使用 SwiftUI 构建，为个人任务提供项目分类、自定义工作流、拖放排序、带草稿保护的任务详情和本地持久化。应用无需账号或网络服务，数据保存在当前 Mac 上。

Note

Boardly 目前处于可运行的原型阶段，尚未提供签名安装包或自动更新。请通过 SwiftPM 运行，或使用仓库脚本生成本地 .app。

界面预览

_{截图使用应用内置示例数据，不包含真实个人任务。}

功能

• 自定义工作流：新增、编辑、排序和删除看板列，并为列设置图标、颜色和完成语义。
• 任务管理：记录标题、描述、优先级、项目、截止日期和标签；支持列内排序、跨列拖放与移动菜单。
• 安全编辑：任务详情使用草稿和显式保存；关闭存在未保存修改的详情时会先确认，避免误操作丢失内容。
• 聚焦视图：按项目、未分类、今天或所有任务查看看板，并可从工具栏搜索任务。
• 原生 macOS 体验：SwiftUI 侧栏与看板布局、独立右侧 Inspector、系统字体、SF Symbols 和键盘操作。
• 项目与列管理：可创建项目并设置图标和颜色，也可从看板末尾添加自定义状态列。
• 显示偏好：在独立设置面板中调整字号、卡片密度，以及任务描述和元数据的显示方式。
• 可靠持久化：已确认的修改会在后台串行写入本地 JSON；侧栏仅在保存中、短暂保存成功或失败时显示状态，旧版迁移和损坏数据恢复前会保留原始备份。
• 辅助功能：支持 VoiceOver 文案、键盘入口和“减弱动态效果”设置。

使用说明

• 单击任务卡片可打开右侧详情。编辑先保留在草稿中，选择“保存”或按 Return 后才会更新任务。
• 详情存在未保存修改时，关闭按钮或 Esc 会显示放弃确认；没有修改时会直接关闭。
• 设置与任务详情共用右侧 Inspector，但状态彼此独立；按 Esc 只关闭当前面板。
• 任务、项目和列的已确认修改会自动写入磁盘，无需额外执行文件保存操作。保存成功提示会短暂出现后自动隐藏，写入失败则持续提示。

快速开始

环境要求

• macOS 14 Sonoma 或更高版本
• Swift 6 toolchain
• Xcode Command Line Tools

项目不依赖第三方 Swift Package。

从源码运行

git clone https://github.com/Zorabi/Boardly.git
cd Boardly
swift run

也可以先构建，再运行调试版二进制：

swift build
.build/debug/Boardly

生成 macOS 应用

bash Sources/Boardly/Resources/make-app.sh
open build/Boardly.app

脚本会执行 Release 构建、生成应用图标，并输出 build/Boardly.app。生成结果使用 ad-hoc 签名，仅适合本地开发和体验，不是经过 Developer ID 签名与公证的发行包。

如需安装到当前 Mac，请先退出正在运行的 Boardly，再执行：

ditto build/Boardly.app /Applications/Boardly.app
open /Applications/Boardly.app

快捷键

操作	快捷键
新建任务	⌘ N
打开或关闭看板设置	⌥ ⌘ I
关闭任务详情或弹窗	Esc
保存任务详情或确认表单	Return

数据与隐私

Boardly 不包含账号、在线同步、遥测或后台服务。

数据	保存位置
项目、列和任务	~/Library/Application Support/Boardly/board.json
字号、卡片密度等显示偏好	macOS UserDefaults
迁移与恢复备份	~/Library/Application Support/Boardly/*.backup

首次启动且不存在 board.json 时，Boardly 会载入一组示例项目和任务。当前数据格式为 schema v2，并兼容旧版 status 字段。

开发与测试

运行全部测试：

swift test

测试覆盖数据解码与迁移、自定义列、任务移动与排序、任务详情保存、异步持久化状态、备份恢复，以及显示设置持久化。

主要目录：

Sources/Boardly/           应用源码与打包资源
Tests/BoardlyTests/        单元测试
docs/images/               README 截图
docs/PRODUCT_DESIGN.md     产品与交互设计
design-system/todos-mac/   macOS 视觉规范

进一步了解设计与实现约束：

• 产品与交互设计
• macOS 视觉规范

贡献

欢迎提交 Issue 或 Pull Request。提交代码前请运行 swift test；涉及界面调整时，建议附上变更前后的截图。

License

Boardly 基于 MIT License 发布。