绫波任务管理器

让 Codex、Claude 与每一次开发 Session，共享同一份可信项目事实。

Local-first project control plane for AI agents on Windows.

下载稳定版 · 用户指南 · Agent 接入 · 安全模型 · 开源预检

_{示例数据：结构取自真实项目，字面内容已全部重写。可用 pnpm exec tsx scripts/render-readme-screenshot.ts 复现。}

Agent 写代码不难，难的是换一次 Session 就忘了项目到哪儿了。上下文被压缩、进程重启、换个 Agent 接手——项目历史只活在聊天记录里，于是每次开工都要重新翻一遍，翻完还未必翻对。

AyanamiTaskManager（ATM）把计划、任务、进度、阻塞、长期记录、证据和 Session 交接收进一个稳定的事实源，Agent 开工时读一份 brief 就能接着干。它不是另一份待办清单，也不保存整段对话，只保留真正会影响项目推进的结构化事实。桌面 UI、MCP、CLI 与本地 HTTP 共用同一套事务应用服务——你在界面上看到的，和 Agent 读到的，永远是同一份数据。

为什么需要 ATM

实战数据

ATM 自己就是用 ATM 管的。下面是本机 SQLite 里的真实计数，截至 2026-08-29：

值得看的不是总量，是平均每个 Session 只推进约 1.1 个工作项——273 次开工分布在 117 个不同的 Agent 身份上：Codex 系 144 次、CLI 71 次、Claude Code 30 次，其余为子 Agent 与本地工具。这正是 Agent 开发的常态：单次会话很短，换手极其频繁。同一段时间里，这些 Session 产出了 47,184 行生产代码与 45,314 行测试代码，分布在 648 个文件中。

支撑这个节奏的不是更长的上下文，是每次开工都能拿到一份可信的 brief。

性能与交付证据

事实源慢一点就没人用，所以性能是硬门禁，不是“以后再优化”。以下是 1.0.22 的实测值，超过门禁上限直接拒绝发布：

每个版本还带一份可核对的证据包：候选先算指纹（gitHead、工作区脏状态哈希、源码哈希、lockfile 哈希、各阶段哈希），再逐层验证，每层记录产物的 SHA-256——

SOURCE_DONE → CI_VERIFIED → PACKAGED_VERIFIED → INSTALLED_VERIFIED

1.0.22 走完四层的实际结果：862 个单元与集成用例、20 个 Playwright e2e（0 失败、0 flaky）、packaged / portable / installed 三套 smoke 各 54 项、分发 smoke 19 项。任一层哈希对不上，流水线就停在那一层。

顺带一个能说明取向的数字：47,184 行生产代码，对 45,314 行测试代码，分布在 247 个测试文件里。

产品结构

正式桌面 daemon 每次启动都会轮换本地鉴权令牌。Agent 配置连接的是动态 bridge，而不是把 endpoint 或 token 固定写进长期配置；完整边界见本地安全模型。

安装

当前稳定版支持 Windows 10/11 x64。

1. 打开 Latest Release。
2. 日常使用选择 AyanamiTaskManager-Setup-*-win-x64.exe；需要免安装时选择 portable ZIP。
3. 启动 ATM，在“设置 → Agent 接入”中安装 Codex、Claude Desktop 或 Claude Code 配置。
4. 开启“登录启动”后，ATM 会在 Windows 登录后随机延迟后台启动；关闭窗口只会收进托盘。

应用数据默认位于 %LOCALAPPDATA%\AyanamiTaskManager。安装版会把精简 Agent Guide 与完整文档同步到该目录，换设备后仍能从同一路径发现使用说明。

[!IMPORTANT]
不要把 %LOCALAPPDATA%\AyanamiTaskManager\runtime\daemon.json、Bearer token、项目数据库或备份提交到仓库。ATM 的运行时发现文件只服务当前 Windows 用户和当前 daemon 实例。

Agent 接入

ATM 会最小合并现有配置，并在写入前创建备份：

最短工作流：

1. atm_begin 开工，并直接使用返回的 brief。
2. 按需读取 READY 叶子 WorkItem，使用 atm_task_patch 领取并开始。
3. 只在状态真正变化时写 progress；长期事实、决策、风险和证据写 record。
4. 验证后完成 WorkItem，Session 结束调用 atm_end。

只有上下文压缩、长时间离开或明确恢复 working set 时才调用 atm_brief。任务过大时，应先按“可交付结果 + 可验证验收”拆成独立叶子 WorkItem。完整规则和字段约定见 Agent 接入指南 与仓库根目录的 ATM_AGENT_GUIDE.md。

工具表拆成 core / memory / actions 三个 profile，不是为了分类好看：单个 profile 的工具 schema 只有 7,680 字节预算（8 KB 上限扣掉 512 字节保留），塞不下就注册不进去。这条预算由用例守着，加字段前先算账。

日常使用

_{总览把所有受管项目的进行中、受阻、等待和在线 Agent 汇到一屏。}

桌面端提供：

• 总览、项目、任务列表/看板/时间线/层级和长期记录；
• Agent 按项目聚合、Session Git 上下文、claim 与交接；
• 临时任务晋升、保存视图、中文搜索和实时事件；
• 在线备份恢复、导入导出、工程统计与托盘通知；
• 开机随机延迟后台启动，以及关闭到托盘的常驻模式。

更完整的操作说明见用户指南，故障定位见排障指南，便携版差异见便携版说明。

本地开发

需要 Node.js >=22.13.0 与 pnpm 11.16.0：

git clone https://github.com/ayanamislover/AyanamiTaskManager.git
Set-Location AyanamiTaskManager
corepack enable
pnpm install --frozen-lockfile
pnpm dev

开发态 Web 界面固定监听 http://127.0.0.1:9999；daemon API 使用运行时发现文件声明的独立 loopback 端口。开发和测试可通过 ATM_DATA_DIR 指向隔离数据目录。

六道质量门禁，缺一道都不算过：

pnpm format:check
pnpm lint
pnpm typecheck
pnpm test
pnpm build
pnpm test:e2e

发布流水线在这之上继续：生成并验证 Squirrel 安装版与 portable ZIP，跑 packaged / distribution smoke、性能 benchmark 和安装态验收，最后把上面那份四层证据包落盘。维护者流程见发布检查表。

README 里的图和截图都由脚本生成，不手工维护：

pnpm exec tsx scripts/render-architecture-diagram.ts
pnpm exec tsx scripts/render-readme-screenshot.ts

参与贡献

欢迎提交问题、文档改进和经过验证的修复。开始前请阅读贡献指南与行为准则。安全问题不要公开提交 Issue，请按安全策略私下报告。

开源许可

AyanamiTaskManager 以 GNU Affero General Public License v3.0 only 发布。项目 logo 与视觉资产的来源说明见视觉资产来源；第三方依赖继续遵循各自许可证。