# awem 开发任务索引（task-awem-dev）

- **总任务状态**：🔄 进行中 —— 9/11 子任务 ✅、70/71 功能点已检查（余：T10 三个真机验证项 ⏸️、T11-F4 核对表待用户复核）
- **计划依据**：[design.md](../design/design.md)（v1 定稿，2026-10-24）+ [AGENTS.md](../../AGENTS.md)
- **计划生成**：2026-10-24，拆解为 11 个子任务、71 个功能点
- **执行方式**：用 `awem-dev` 技能（仓库 `.agents/skills/awem-dev/`）说"继续 awem 开发/执行 T0X/检查 T0X"；或按 [conventions.md](conventions.md) §7–8 的流程手动执行与更新状态。

---

## 状态字典（全目录统一，详见 conventions.md §6）

| 标记 | 子任务/功能点开发状态 | 功能点检查状态 |
|---|---|---|
| ⬜ | 未开始 | 未检查 |
| 🔄 | 进行中 | — |
| ⏸️ | 已暂停（须记原因） | — |
| 🟠 | 已完成（待检查） | — |
| ✅ | 已检查 | 通过 |
| ❌ | — | 不通过（打回 🔄） |

## 子任务状态总览

| 编号 | 子任务 | 前置依赖 | 功能点进度（已检查/总数） | 子任务状态 | 文档 |
|---|---|---|---|---|---|
| T01 | 工程骨架与构建基础 | — | 5/5 | ✅ 已检查 | [t01-project-scaffold.md](t01-project-scaffold.md) |
| T02 | 配置与存储 | T01 | 6/6 | ✅ 已检查 | [t02-config-storage.md](t02-config-storage.md) |
| T03 | 启动命令解析与导入 | T01 | 6/6 | ✅ 已检查 | [t03-launch-command-parser.md](t03-launch-command-parser.md) |
| T04 | 日志系统 | T01、T02 | 6/6 | ✅ 已检查 | [t04-logging.md](t04-logging.md) |
| T05 | Supervisor 进程守护 | T02、T03、T04 | 7/7 | ✅ 已检查 | [t05-supervisor.md](t05-supervisor.md) |
| T06 | daemon 与本地 API | T02、T04、T05 | 7/7 | ✅ 已检查 | [t06-daemon-api.md](t06-daemon-api.md) |
| T07 | CLI 子命令集 | T03、T05、T06 | 10/10 | ✅ 已检查 | [t07-cli.md](t07-cli.md) |
| T08 | 平台状态联动（只读） | T02、T03、T06 | 6/6 | ✅ 已检查 | [t08-platform-sync.md](t08-platform-sync.md) |
| T09 | Web SPA | T03、T06、T08 | 8/8 | ✅ 已检查 | [t09-web-spa.md](t09-web-spa.md) |
| T10 | 系统服务与跨平台专项 | T06、T07 | 3/6 | ⏸️ 已暂停（F3/F4/F5 待真机） | [t10-service-cross-platform.md](t10-service-cross-platform.md) |
| T11 | 打包分发与 Agent 文档 | T01–T10 | 3/4 | ⏸️ F4 待用户复核 | [t11-release-docs.md](t11-release-docs.md) |

## 执行顺序与并行说明

- **推荐顺序 = 编号顺序**：T01 → T02 → T03 → T04 → T05 → T06 → T07 → T08 → T09 → T10 → T11。
- 可并行的组合（同一人/Agent 串行执行时忽略）：T07 与 T08 在 T06 完成后可并行；T09 在 T06 完成后可开工，但"平台状态列/漂移黄标"要等 T08。
- T11 是收尾任务，必须在 T01–T10 全部 ✅ 后执行。

## 执行流程摘要（详细规则见 conventions.md §7–8）

1. 读本索引 + conventions.md；涉 UI 再读 [ui-guidelines.md](../design/ui-guidelines.md)。
2. 选定子任务（用户指定编号，或取推荐顺序中第一个非 ✅ 的）。
3. 开工：子任务状态 ⬜→🔄（本文档与子任务文档同步 + 双方变更记录各加一行）。
4. 逐功能点开发：完成一个 → 该功能点 🟠（index 进度同步）。
5. 全部功能点 🟠 且 `go build/vet/test` 三绿 → 子任务 🟠。
6. 检查环节：逐功能点跑验收要点 → 全 ✅ → 子任务 ✅；不通过 → 打回并登记。
7. 全部子任务 ✅ → 总任务状态改为 ✅。

## 仓库外联动事项（不在本目录跟踪状态）

- 改造 `~/.agents/skills/autowonder-project-onboarding` 技能模板：从生成 `executor-manager.sh` 改为生成 `awem add --launch-command …` 指引（独立仓库，见 design.md §15 本期交付第 3 项）。**在 T11 完成后另行处理。**

## 更新记录

| 日期 | 动作 | 说明 |
|---|---|---|
| 2026-10-24 | 创建 | 依据 design.md v1 定稿拆解：11 子任务 / 71 功能点 |
| 2026-10-24 | T01 开工 | 子任务状态 ⬜→🔄，无人值守开发会话开始 |
| 2026-10-24 | T01-F1 ✅ | module 初始化与目录骨架，三绿通过（1/5） |
| 2026-10-24 | T01-F2 ✅ | 子命令分发框架 + version，验收实测通过（2/5） |
| 2026-10-24 | T01-F3 ✅ | 退出码常量与错误分类（internal/exitcode），验收通过（3/5） |
| 2026-10-24 | T01-F4 ✅ | Makefile 与 README 开发者快速开始，验收通过（4/5） |
| 2026-10-24 | T01-F5 ✅ + 子任务 ✅ | go:embed 静态资源骨架验收通过；T01 全部 5 功能点 ✅，子任务完成（5/5），已推送 |
| 2026-10-24 | T02 开工 | 子任务状态 ⬜→🔄 |
| 2026-10-24 | T02-F1 ✅ | 配置目录与 data 布局，单测通过（1/6） |
| 2026-10-24 | T02-F2 ✅ | config.toml 模型与读写（BurntSushi/toml），单测通过（2/6） |
| 2026-10-24 | T02-F3 🔄 部分 | 配置校验（name/bind/非空）完成；命令字段校验待 T03 解析器（预授权路径） |
| 2026-10-24 | T02-F4 ✅ | 配置热加载（fsnotify+去抖），单测通过（3/6） |
| 2026-10-25 | T02-F5 ✅ | api-token 生成/复用/权限，单测通过（4/6） |
| 2026-10-25 | T02-F6 ✅ + ⏸️ | daemon.json 读写/stale/自愈通过（5/6）；子任务暂停待 T03 补 F3 命令字段校验 |
| 2026-10-25 | T03 开工 | 子任务状态 ⬜→🔄（T02 ⏸️ 转入） |
| 2026-10-25 | T03-F1 ✅ | 拆词与前缀识别，单测通过（1/6） |
| 2026-10-25 | T03-F2 ✅ | 结构化字段解析与校验，单测通过（2/6） |
| 2026-10-25 | T03-F3 ✅ | 命令重建 roundtrip 幂等，单测通过（3/6） |
| 2026-10-25 | T03-F4 ✅ | 旧脚本 import 解析（真实 fixture），单测通过（4/6） |
| 2026-10-25 | T03-F5 ✅ | 旧日志归档准备，单测通过（5/6） |
| 2026-10-25 | T03-F6 ✅ + 子任务 ✅ | 测试矩阵收口（覆盖率 92.7%）；T03 全部 6 功能点 ✅，已推送 |
| 2026-10-25 | T02-F3 ✅ + 子任务 ✅ | F3 命令字段校验经 T03 解析器回填完成；T02 6/6 ✅（16/71） |
| 2026-10-25 | T04 开工 | 子任务状态 ⬜→🔄 |
| 2026-10-25 | T04-F1 ✅ | LogSink 收割管道，单测通过（1/6） |
| 2026-10-25 | T04-F2 ✅ | 按大小滚动（编号链），单测通过（2/6） |
| 2026-10-25 | T04-F3 ✅ | 保留策略清理，单测通过（3/6） |
| 2026-10-25 | T04-F4 ✅ | 管理事件日志（JSONL），单测通过（4/6） |
| 2026-10-25 | T04-F5 ✅ | --debug 透传（事件标记+命令查询），单测通过（5/6） |
| 2026-10-25 | T04-F6 ✅ + 子任务 ✅ | tail/跟随/分页 + Manager；T04 全部 6 功能点 ✅（22/71），已推送 |
| 2026-10-25 | T05 开工 | 子任务状态 ⬜→🔄；已从真实 autowonder@0.3.22 包采样运行时事实（workspace-root 覆盖途径、连接日志关键字）记入子任务变更记录 |
| 2026-10-25 | T05-F1 ✅ | 子进程 spawn（跨平台 npx 解析/argv 重建/env 注入/workspace_root 覆盖），单测+交叉编译验证通过（23/71） |
| 2026-10-25 | T05-F2 ✅ | 守护状态机：崩溃退避拉起/稳定重置/可关/人为停止不拉起，-count=5 稳定（24/71） |
| 2026-10-25 | T05-F3 ✅ | 停止与进程树终止：pgid 整树 SIGTERM/宽限/SIGKILL，无残留断言+幂等（25/71） |
| 2026-10-25 | T05-F4 ✅ | autostart 拉起与 ApplyConfig 热加载语义（新增即拉/存量不动/消失即停）（26/71） |
| 2026-10-25 | T05-F5 ✅ | 状态快照与连接状态解析（关键字实标自真实 daemon 二进制）（27/71） |
| 2026-10-25 | T05-F6 ✅ | 事件联动收口：全生命周期序列断言+排障详情+令牌安全（28/71） |
| 2026-10-25 | T05-F7 ✅ + 子任务 ✅ | 冒烟套件一键全绿（-count=3 稳定、~0.9s、无残留进程）；T05 全部 7 功能点 ✅（29/71），已推送 |
| 2026-10-25 | T06 开工 | 子任务状态 ⬜→🔄；新增 AWEM_CONFIG_DIR 测试隔离环境变量 |
| 2026-10-25 | T06-F1 ✅ | daemon 生命周期与单实例锁：文件锁互斥/强杀可重启/daemon.json 启停（30/71） |
| 2026-10-25 | T06-F2 ✅ | 端口绑定与自动写回：port=0 写回 config、等价重载抑制、文件监视常驻（31/71） |
| 2026-10-25 | T06-F3 ✅ | REST API 全集：执行器 CRUD/动作/日志/设置/reload，错误 schema 与视图契约定稿（32/71） |
| 2026-10-25 | T06-F4 ✅ | WebSocket 日志实时流：backlog+实时行+断开回收；修复 T04-F6 Follow 首开竞态吞行（33/71） |
| 2026-10-25 | T06-F5 ✅ | 鉴权与 CSRF：Host/Origin/token 三层中间件，401/403 矩阵 + 真实 curl 六项冒烟（34/71） |
| 2026-10-25 | T06-F6 ✅ | CLI 惰性拉起 daemon：探活/后台拉起/就绪等待/退出码 5 指引，awem reload 接通（35/71） |
| 2026-10-25 | T06-F7 ✅ + 子任务 ✅ | 静态资源与 reload 收口：SPA fallback/JSON 404 兜底/reload 全链路生效验证；T06 全部 7 功能点 ✅（36/71），已推送 |
| 2026-10-25 | T07 开工 | 子任务状态 ⬜→🔄；fakeproc 提为 internal/fakeproc 共享包；cli Deps 注入骨架 |
| 2026-10-25 | T07-F1 ✅ | awem add：自动命名/开关/文件输入/掩码摘要/退出码 2·4（37/71） |
| 2026-10-25 | T07-F2 ✅ | awem list：表格/空态引导/--json 与 API schema 一致（38/71） |
| 2026-10-25 | T07-F3 ✅ | awem status：单个详细/全部摘要/三态退出码/--json 全信息项（39/71） |
| 2026-10-25 | T07-F4 ✅ | awem start/stop/restart：幂等三态、stop 全部确认、逐条汇报（40/71） |
| 2026-10-25 | T07-F5 ✅ | awem edit：字段直改/整条替换/布尔开关/运行中提示（41/71） |
| 2026-10-25 | T07-F6 ✅ | awem remove：确认交互/先停后删/purge 日志清理（42/71） |
| 2026-10-25 | T07-F7 ✅ | awem log：tail/空态/--json/WS 跟随干净退出（43/71） |
| 2026-10-25 | T07-F8 ✅ | awem import：预览/改名确认/批量导入/--with-logs 归档/--json 汇总（44/71） |
| 2026-10-25 | T07-F9 ✅ | awem doctor：Node/npx/provider CLI/磁盘/平台占位五项体检（45/71） |
| 2026-10-25 | T07-F10 ✅ + 子任务 ✅ | reload/version 收口、退出码矩阵与 --json schema 汇总表；T07 全部 10 功能点 ✅（46/71），已推送 |
| 2026-10-25 | T08 开工 | 子任务状态 ⬜→🔄 |
| 2026-10-25 | T08-F1 ✅ | MCP 只读客户端：握手/点号工具/错误分类/SSE（47/71）；端点路径与响应字段待真实环境验证 |
| 2026-10-25 | T08-F5 ✅ | 只读白名单双保险：私有 call 白名单 + 导出面反射断言（48/71） |
| 2026-10-25 | T08-F2 ✅ | 归属自动发现：多空间匹配/权限跳过/缓存落盘按需扫描（49/71） |
| 2026-10-25 | T08-F3 ✅ | 状态轮询：按空间分组刷新/unreachable 退避恢复/未配置不启动（50/71） |
| 2026-10-25 | T08-F4 ✅ | 漂移检测：五字段对比/权限静默跳过/与轮询同周期（51/71） |
| 2026-10-25 | T08-F6 ✅ + 子任务 ✅ | API/CLI/doctor 接入：平台状态+漂移视图、/api/platform/health、daemon 热装配；T08 全部 6 功能点 ✅（52/71），已推送 |
| 2026-10-25 | T09 开工 + F1 ✅ | Vite+React+TS 脚手架、设计令牌全量落地、主题机制、布局骨架（53/71） |
| 2026-10-25 | T09-F2 ✅ | 鉴权流程：token 验证后持久化、错误文案、401 自动回登录卡（54/71） |
| 2026-10-25 | T09-F3 ✅ | 总览页：双状态列表格、行内操作+确认、5s 轮询、空态/骨架（55/71） |
| 2026-10-25 | T09-F4 ✅ | 详情页：摘要条、暗底 ANSI 日志查看器（WS+跟随+翻页）、编辑表单（56/71） |
| 2026-10-25 | T09-F5 ✅ | 添加/导入页：解析预览高亮、逐字段错误、批量导入端点与明细（57/71） |
| 2026-10-25 | T09-F6 ✅ | 设置页：平台/日志/外观三组表单，主题即时切换（58/71） |
| 2026-10-25 | T09-F7 ✅ | 组件与可访问性收口：可执行 UI 自检脚本 + §4 逐条对照（59/71） |
| 2026-10-25 | T09-F8 ✅ + 子任务 ✅ | 构建链与 embed：make build 单命令、端到端冒烟 8 项全过、gzip 56.77KB 达标；T09 全部 8 功能点 ✅（60/71），已推送 |
| 2026-10-25 | T10 开工 + F1 ✅ | service 框架：Platform 注册分发、幂等策略、CLI 接线（61/71） |
| 2026-10-25 | T10-F2 ✅ | Linux systemd user 真机全链路：install/uninstall 干净幂等（62/71） |
| 2026-10-25 | T10-F3 ⏸️ | macOS launchd：代码+模板单测+交叉编译完成，真机验证待 macOS 环境（63/71） |
| 2026-10-25 | T10-F4 ⏸️ | Windows 登录自启（HKCU Run，sc create 备选文案）：代码完成，真机待验证（64/71） |
| 2026-10-25 | T10-F5 ⏸️ | Windows 专项：交叉编译持续通过，真机行为待回归（65/71） |
| 2026-10-25 | T10-F6 ✅ | 全链路冒烟 scripts/smoke.sh 一键全绿 + README 平台说明（66/71）；T10 ⏸️ 汇总：代码全部完成，macOS/Windows 真机验证待用户环境 |
| 2026-10-25 | T11 开工 | T10 ⏸️ 不阻塞可无人值守部分；F1/F2/F3 推进、F4 待用户复核 |
| 2026-10-25 | T11-F1 ✅ | 发布构建：make release 五平台 + checksums 实测全过（67/71） |
| 2026-10-25 | T11-F2 ✅ | install.sh 本机演练（正常/幂等/坏校验拒绝）+ install.ps1（68/71） |
| 2026-10-25 | T11-F3 ✅ | Agent 使用说明 docs/agent-guide.md（实测比对命令/schema/退出码一致）（69/71） |
| 2026-10-25 | T11-F1 增强 | 发布自动化 workflow（tag 触发、质量门、五平台 + checksums 自动 Release，actionlint 通过） |
| 2026-10-25 | T11-F4 ⏸️ | 16 条决策核对表已填证据（15 ✅ + 决策 16 ⚠️：onboarding 技能改造在仓库外需用户执行）；待用户复核确认后总任务 ✅（70/71） |
| 2026-10-25 | T09 开工 + F1 ✅ | Vite+React+TS 脚手架、设计令牌全量落地、主题机制、布局骨架（53/71） |