# {{任务编号}} 桌面端任务:{{任务标题}} ## 概述 {{一段描述:服务目标、纯本地服务说明}} **前置依赖**: {{依赖任务列表}} ## tmux 执行协议 - **Session**: `arno-team`,始终复用 `项目` / `后端` / `前端` / `测试` 四个 pane,禁止新建 tmux session / window / pane - **环境重置**: 开始前确保目标 pane 中是新启动的 `cc` 环境(/exit 后重启,清除遗留上下文) - **分发方式**: 由 `项目` pane 发送简短提示词,让目标 pane 自行读取任务文件 ## 前置文档(必读) > 执行本任务前必须加载以下文档,作为接口和存储规范。 ### 接口与架构规范(所有桌面端任务通用) - `docs/09-API契约.md` — 客户端本地接口定义(桌面端需遵守请求/响应格式) - §1 通用规范 | §2 通用响应格式 | §4 错误码规范 - §9 客户端本地接口(HTTPS IPC):§9.1~§9.20 全部端点 - `docs/07-系统架构.md` §2.1(客户端架构)| §4(CRDT 同步架构)| §5(数据流) ### 数据库规范(所有桌面端任务通用) - `docs/08-数据库设计.md` §3(客户端本地数据库) - §3.3 索引设计 | §3.5 SQLite DDL 参考 - §4 数据版本迁移策略(§4.2 迁移脚本规范) ### 工程规范(所有桌面端任务通用) - `docs/11-工程规范.md` §1.5(术语使用规范)| §2(编码规范) ### 按任务选取 | 任务 | API 契约章节 | 数据库章节 | 其他参考 | |------|-------------|-----------|---------| | M3-001 | §9.12 证书状态、§9.13 导出、§9.14 导入 | §3.2.5 SyncMeta | — | | M3-002 | §9.1 登录、§9.2 锁定、§9.15 修改密码、§9.16 密码恢复 | §3.2.7 LocalConfig | | | M4-001 | 无直接 API(纯本地服务) | 无直接表操作 | — | | M4-002 | §9.3~§9.7 接口、§9.8~§9.11 分类接口 | §3.2.1、§3.2.3、§3.2.4、§3.2.6 | | | M5-001 | §6 同步接口(push/pull 格式参考) | §3.2.3 CRDTEntry、§3.2.5 SyncMeta | `docs/07-系统架构.md` §4(CRDT 同步架构) | | M7-001 | §9.8~§9.11 分类接口 | §3.2.2 Category | | | M7-002 | §9.16 POST /api/v1/local/password/recover | §3.2.7 LocalConfig | — | ## 功能需求(FR-NNN ~ FR-NNN) - {{需求条目}} ## 需要创建的文件 ### 1. `src/{{module_name}}/services/{{service}}.py` — {{服务名}} {{类/方法骨架}} ### 2. 其他文件 {{附加文件}} ## 编码规范 - Python 3.12+,mypy strict,禁止 Any - ruff format/check,Google 风格 docstring ## 验收标准 - {{逐条检查}} - 模块测试覆盖率 >{{阈值}}% ## 验证命令 ```bash {{具体命令}} ``` 完成后将产出物清单写入 `/workspace/tasks/result/{{任务编号}}.md`。