“待办”是一款本地优先的 Windows 桌面悬浮待办：想到事情时快速记下，按自己需要的顺序处理，并保留完成历史作为周报和回顾依据。
当前公开版本为 0.1.6。本次补丁阻止正式应用重复打开，再次启动时只唤回现有窗口；同时让新建父待办默认出现在列表最上方，子待办仍按创建顺序向下追加。数据库继续使用 schema v5，内部 zuoban 身份、数据目录、更新端点和签名公钥保持不变。Windows x64 安装器、更新签名与 latest.json 已由 GitHub Actions 发布并完成验签核对。宠物、番茄钟、AI 和日历均不在本阶段范围内。
下方功能说明以当前公开版本 0.1.6 为准；后续变化继续记录在 CHANGELOG.md 的 Unreleased。
- 快速记录待办；新建父待办默认出现在列表最上方，子待办仍按创建顺序向下追加。
- 正式应用只允许一个运行实例；再次启动只会唤回并展开已有窗口。展开面板、当前任务胶囊和系统托盘继续共用同一窗口。
- 每条待办都可直接勾选完成，也可软删除；删除会移出待办队列，但保留事件历史且不产生奖励。
- 双击未完成待办标题，或聚焦后按
Enter/F2，可在原位置修改标题；Enter或失焦保存，Esc取消。 - 截止日期默认不设置，可在编辑待办时额外选择或清除。列表只在有期限时显示“今天”“明天”“M/D”“YYYY/M/D”或“逾期 N 天”等紧凑标签。
- 通过拖动柄或
Alt+↑/↓调整完整待办顺序。 - 在待办页和已完成页按
Ctrl+F，或从更多菜单进入当前页面搜索。搜索只按标题实时筛选并高亮；搜索期间仍可完成、修改、删除或撤销，但禁止重排过滤后的局部列表。 - 独立查看已完成事项和完成时间，并通过
↶撤销完成；撤销后的任务回到待办队尾。 - 从已完成页右上角更多菜单选择“复制本周完成”，可把本地自然周内仍然有效的完成项复制为 Markdown 编号列表；本周为空时不会覆盖剪贴板。完整周报、上周或自定义日期仍属于后续能力。
- 长列表只在列表内部滚动，录入区和底部入口保持固定；进入已完成页时，返回入口与页名直接替换顶部应用标题，不再额外占用一行。
- 正常模式启动后会检查更新，并每 24 小时再次检查；也可从更多菜单手动检查。发现新版本后，由用户明确点击安装。
- 正常模式接入单实例保护；重复启动不再生成第二个待办窗口，而是唤回并展开已经运行的窗口。桌面冒烟模式保持独立，不会干扰正式实例。
- 新建顶层待办默认插入列表最上方，已有父待办保持彼此的相对顺序；新建子待办仍追加到所属父项的同级末尾，之后的手动排序保持不变。
- 新创建事件显式记录队首语义；旧版本没有该元数据的历史事件仍按原队尾规则回放，升级不会倒转已有列表。
- 待办页和已完成页都通过父项右侧的进度信息与箭头展开或收起子项；页面之间切换时保留用户已经选择的展开状态。
- 子列表常态保持透明，以缩进和只覆盖子项区域的短轨道表达层级，不再使用贯穿各行的分隔线。
- 子项在鼠标悬浮或键盘聚焦时淡入轻量行级背景；已完成子项在高亮区域前后保留内边距，避免内容贴边。
- 用户可见名称由“代办”更正为“待办”，但内部应用标识、数据目录和更新信任身份保持不变。
- “完成记录”简化为“已完成”：返回入口与页名合并进顶部窗口栏，“复制本周完成”收进该页更多菜单；待办页底部只让右侧“已完成 + 数量 + 箭头”紧凑按钮响应点击，减少误触。
- 父待办与子待办的可选操作统一靠右；删除入口隐藏后，排序柄不再移位。展开子列表时父行保持原位置，编辑态左侧橙色标记随首行居中。
- 软件图标改为深色底座与珊瑚橙任务牌组成的“悬浮任务牌”，桌面、托盘和安装器复用同一源文件生成的图标资源。
- 每个父待办行右侧固定一个低存在感
＋，作为唯一的子代办新增入口；有子代办后，标题后的紧凑进度只负责展开或收起。搜索时隐藏新增入口，删除和排序按钮在新增、编辑过程中保持原位置。 - 点击
＋后，输入框位于子列表末尾。非空标题按Enter或移开焦点创建；空白失焦或按Esc直接取消。没有旧子项时取消会恢复收起，已有子项时仍保持展开，成功创建第一条后也保持展开。 - 子标题支持原位修改，按
Enter或失焦保存；子项还可软删除、完成、撤销完成，并在同一父项内拖动或使用Alt+↑/↓重排。 - 勾选父项会在一次可靠写入中自动完成全部未完成子项，再完成父项；子项各自保留完成事实但不发金币，父项仍只奖励
1枚金币。单独完成最后一条子项不会自动完成父项，仍需用户明确勾选父项。 - 搜索会保留父项上下文和整组真实进度；已完成事项按父项分组并默认折叠；胶囊显示“父项 / 当前子代办”以及父项期限。父项在本周最终完成时，周回顾会把更早完成且仍有效的子项作为缩进明细；普通子项只有在本周完成时才单独进入本周结果。
- 第一版只支持一级；子代办没有独立期限和金币，不能跨父项排序，也不能在父项与子项之间互相转换。
- 桌面壳：Tauri 2。
- 前端：原生 HTML、CSS、JavaScript 模块（ES modules），不依赖前端框架和构建器。
- 核心与应用服务：Rust，负责任务状态、队列、事件、奖励、幂等和窗口运行模式。
- 持久化：SQLite，本地任务投影、事件、奖励和命令回执在同一事务中提交。
- 可靠写入：前端通过操作箱保存稳定操作 ID，再经
LedgerSession → TauriGateway → Tauri 命令 → TaskService提交意图；前端只渲染后端快照，不复制领域状态机。 - 子代办交互：
SubtaskController只维护展开、单次添加态、子项编辑、组内重排和焦点等临时状态；snapshot.subtasks与snapshot.effectiveCompletions是后端投影，新增子项和同组重排分别使用create_subtask、reorder_subtasks，其他操作复用现有可靠写入链路。 - 父项完成：前端只提交一次
complete_task意图；Rust 在同一 SQLite 事务中完成仍为pending的活动子项，再写父项主完成事件、+1奖励和唯一外部命令回执。已完成子项不重复写，已软删除子项不参与级联。 - 创建顺序：Rust 领域层使用显式
TaskPlacement区分顶层队首、顶层队尾和子项同级末尾；SQLite 在一次事务中为新父待办让出队首，完整性回放同时兼容旧事件的历史队尾语义。 - 桌面单实例：正常模式优先注册官方单实例插件，重复启动与托盘恢复复用同一个“恢复展开态”入口；smoke 模式不注册该插件。
- 本周完成复制：
WeeklyCompletionController复用现有只读weekly_facts查询，通过项目自己的剪贴板写入端口调用 Tauri 官方插件；应用只申请文本写入权限，不读取剪贴板。 - 更新适配：
UpdateController → TauriGateway → 项目自有更新命令 → AppUpdateService → Tauri updater。前端只负责检查时机和交互，Rust 负责运行模式校验、待安装版本与单次安装锁。
代码依赖方向和可靠性不变式见《代码架构与模块边界 v0.1》，事件与任务状态说明见《任务状态与事件账本 v0.1》，一级子代办的交互与领域边界见《子代办完整交互与领域设计 v0.1》，发布边界与操作流程见《Windows 发布与自动更新 v0.1》，面向使用者的版本变化统一记录在 CHANGELOG.md。
- Windows 10 或 Windows 11。
- Node.js 与 npm，建议使用当前维护中的 LTS 版本。
- 通过
rustup安装的 Rust stable 工具链。 - Visual Studio 2022 Build Tools，并安装“使用 C++ 的桌面开发”工作负载、MSVC 工具集和 Windows SDK。
- Microsoft Edge WebView2 Runtime。
以下命令均从仓库根目录运行。Windows PowerShell 中使用 npm.cmd，避免执行策略拦截 npm.ps1。
安装锁定依赖：
npm.cmd ci启动开发版：
npm.cmd run desktop:dev运行统一测试门禁：
npm.cmd run desktop:check该命令会先运行前端 Node 测试，再运行 Rust 测试。需要进一步验证本地账本或桌面联合链路时，可运行：
npm.cmd run ledger:smoke
npm.cmd run desktop:smoke构建不带安装器的 release EXE：
npm.cmd run desktop:build产物位于 src-tauri/target/release/zuoban-desktop-spike.exe。用户可见产品名与 Windows 文件元数据为“待办”；内部 identifier、EXE 名和数据库文件名继续保留 zuoban 兼容名称，避免破坏已有本地数据。
构建 Windows x64 NSIS 安装器与更新签名：
npm.cmd run desktop:bundle:windows安装器与 .sig 更新签名位于 src-tauri/target/release/bundle/nsis/。v0.1.6 GitHub Release 的线上 latest.json、更新签名和安装器已由发布工作流完成核验；当前正式安装基线仍需在实际用户环境单独确认。
正式发布前需要先试装时，使用独立候选配置生成“待办测试版”：
npx.cmd tauri build --bundles nsis --ci --no-sign --config src-tauri\tauri.candidate.conf.json候选配置使用独立 identifier 和应用数据目录，不覆盖正式“待办”；同时关闭 updater 产物和 Authenticode 签名，只用于本机功能试用，不能作为正式 Release 资产。
- 首次安装：用户从
v0.1.6GitHub Release 手动下载 Windows x64setup.exe并安装；安装范围为当前用户。 - 后续更新：正常模式启动后立即静默检查一次，此后每 24 小时检查；更多菜单提供“检查更新”。发现新版本后，用户点击“安装更新”才会下载、安装并重启应用。
- 冒烟隔离：smoke 前端不会启动更新控制器，Rust 更新服务也会在访问网络前拒绝请求，避免测试触碰正式更新源。
- 自动发布：
.github/workflows/release.yml支持从main手动触发和v*标签触发；已公开的版本禁止覆盖，新版本必须先同步提升 npm、Tauri、Cargo 三份清单及对应锁文件的版本事实，并把CHANGELOG.md的Unreleased内容收口到带实际日期的当前版本段。GitHub Release 正文只读取该标准版本段，不混入自动提交列表；tauri-apps/tauri-action@v1先生成草稿 Release、安装器、更新签名和latest.json，工作流回读核对正文、用客户端公钥验签并核对元数据后才自动发布。 - 发布密钥：仓库只约定 GitHub Actions Secrets
TAURI_SIGNING_PRIVATE_KEY与TAURI_SIGNING_PRIVATE_KEY_PASSWORD；私钥和密码不得提交到仓库，应在受控的加密离线位置保留恢复备份。 - Windows Authenticode 代码签名暂未配置。Tauri 的
.sig用于校验自动更新产物，不能替代 Authenticode；首次运行安装器时可能出现 Microsoft Defender SmartScreen 提示。
- 待办、完成历史、事件和奖励账本保存在本机 Tauri 应用数据目录的 SQLite 数据库中。
- 核心待办流程可离线运行，不接入云同步、AI 服务或外部日历，也不会把截止日期发送到外部系统；只有正常模式的更新检查会访问 GitHub Releases。
- 写命令使用幂等回执和可靠操作箱；结果未知时会保留原操作并锁住后续写入，不会静默重复执行。
0.1.1使用数据库 v4；0.1.2的一级子代办把本地结构升级为 v5，并保留 v4→v5 迁移前备份、旧数据和旧回执兼容。降级安装程序不会自动降级数据库。- 面向用户的删除是可追溯软删除，不会物理清除历史。永久清理、通用自动备份、手动导出和跨设备恢复尚未实现。
- 当前只按 Windows 桌面环境开发和验证，不承诺 macOS 或 Linux 可用。
- 当前安装器只面向 Windows x64；
v0.1.6的公开下载、元数据和更新签名已完成验证，版本间应用内发现、安装重启与数据保留仍待实机验证。 - Windows Authenticode 暂未配置，安装器可能触发 SmartScreen 提示。
- 多显示器、所有 Windows 缩放比例以及任务栏位于四个方向的组合仍需更多实机验证。
- 截止日期只用于本地展示，不会自动排序、隐藏任务、提醒、发送通知、同步日历或产生奖惩。
- 当前子代办仍只支持一级，不提供子项期限、子项金币、跨父项移动、父子转换、批量粘贴或 AI 自动拆解。
- 当前不提供有道待办同步或历史迁移；产品仍处于试用阶段，尚未达到完整替代有道待办的发布标准。
- 宠物成长、番茄钟、AI、日历联动、完整周报、阻塞/恢复工作流、通用备份和导出均为后续方向；当前只提供固定自然周的有效完成项 Markdown 复制。
极简原生风是当前实现和验收基线。展开面板只保留快速记录、统一待办列表和已完成入口；搜索、复制本周完成和低频技术操作收进右上角更多菜单。
- 极简原生主方案完整流程原型
- 桌面悬浮窗口技术实验 v0.1
- 本地事件历史、金币账本与异常恢复技术实验 v0.1
- 界面与交互设计说明 v0.2
- 产品设计方案 v0.1
- 产品路线图 v0.1
- 子代办完整交互与领域设计 v0.1
- 一级子代办早期交互原型（
v0.1.2前历史草案） - Windows 发布与自动更新 v0.1
- 发布与自动更新学习指南——按实际顺序学习版本、门禁、标签、Actions 和 Release 验证
- 标准更新日志
三种视觉设计全部保留，但第一版不并行开发三套完整主题：
- 极简原生风格研究稿——当前主方案。
- 深色透明风——后续候选皮肤。
- 像素桌宠风——后续候选皮肤。
- 三种风格统一比较入口
- 视觉方向决策 v0.3
- 三种视觉风格对比 v0.2
深色透明和像素桌宠只复用同一套组件、协议和业务逻辑，不会各自复制一套任务实现。
暖色手账风只作为历史探索保留，不是当前实现基线。
主方案网页原型用于保存完整业务设想，不能替代真实 Tauri 桌面应用。默认可直接打开 prototype/native/index.html；若浏览器限制本地脚本，可在仓库根目录运行：
python -m http.server 4173 --bind 127.0.0.1 --directory .\prototype然后访问 http://127.0.0.1:4173/native/。
本项目使用 MIT License 开源。