开发草稿¶
本目录只放：
- 工程规划（版本切片、发布）
- 尚未实现的功能设计稿
已实现功能的说明在 ../frontend/ 与 ../backend/，按功能分篇。
未实现草稿¶
| 文档 | 主题 |
|---|---|
| lifecycle-events.md | 生命周期事件系统：语义事件 + 注册式 handler，统一事件命名规范。已落地，保留为设计记录（scoped 事件与 teardown 语义、为何不需要 vault:closed、为何 app:will-quit 延后） |
| plaza.md | 广场（Cool Papers / ModelScope 论文 / 推荐 / 播客）。壳 + 两个站点来源浏览与入库已落地（agentero-coolpapers / agentero-modelscope 站点代理）；推荐 / 播客仍为草稿 |
| plaza-feeds.md | 广场订阅 MVP：本地 RSS/Atom 时间线 + 论文入库。已落地 |
| usage-analytics.md | #239 Activity 总线。P0 存储已落地：XDG usage.sqlite（见 ../backend/usage.md） |
| zotero-word-integration.md | 官方 Zotero Word 插件 provider 兼容、文档迁移与平台实现评估 |
| cloud-sync-s3.md | 云同步（S3 兼容）：catalog sidecar 化前置 + 内容寻址 blob/manifest/CAS 同步引擎。Phase 0–1 已落地（见 ../backend/sync.md）；自动同步 / GC / E2EE / 官方托管仍为草稿 |
| mark-cli-roadmap.md | #170 阅读标注内置进 CLI（方案/命令面/边界）+ 基础→上层→Skill；与 CLI 文档 分发衔接 |
| mark-locate-lazy.md | 文字定位：打开 PDF 再算（惰性，默认主路径） |
| import-api-abstraction.md | Import 学术 API 抽象层：统一论文元数据、期刊指标、PDF URL 与题录批处理的 trait 与数据结构。已落地（crates/agentero-core 的 features/paper/scholar_api/），保留为设计记录 + 论文元数据重构的剩余缺口清单（citation_count 入库断点、status/body_source enum 化代价、PaperTag 生成契约） |
| mark-locate-eager.md | 文字定位：标注时算（即时 B1 viewer / 可选 B2 headless） |
| crate-split-roadmap.md | agentero-core crate 拆分路线：Phase 1/2 已落地（基座 + CLI 数据域迁入、HostHooks 事件抽象、CLI 脱离 agentero_lib）；留守域耦合清单与 Phase 3 建议 |
| rust-arch-refactor.md | Rust 架构重构计划（2026-09-08 更新）：共享业务用例、提交与恢复、Vault 派生状态、论文准备/共享提取、任务生命周期、Agent 上下文六条主线；含前置正确性修复、依赖与验收、旧任务归并及历史裁决。实施未开始 |
macOS 签名与公证（已实现流程说明）在 ../bug_fix/macos-signing.md。
本目录没有单独的 Roadmap / TODO 文件：未决项按能力记在对应已实现文档的「限制与后续」里。内置 provider（翻译 / embedding / 正文 OCR）的未决清单——⟦n⟧ 占位符透传待真实 key 验证、Hunyuan-MT 模板空格待 A/B、目标语言从 en/zh-CN 扩到 37 种、把内嵌 key 换成网关签发的 per-install activation token——在 ../backend/builtin-provider.md §限制与后续；arXiv 推荐的 arxiv_rec_state 不按 model 建键一条在 plaza.md §3.4。