"Life is just a mix of 'Now' (one-off) and 'Again' (recurring)."
家庭事务管理平台 — Web UI + CLI + RESTful API，三端统一。
生活中的琐事只有两种：
- Now（此刻）：临时起意、只做一次的事 — 取快递、给绿植换盆、预约体检。
- Again（再次）：循环往复、刻在生活节律里的事 — 每两周换四件套、每天铲猫砂、每月大扫除。
Now & Again 把它们统一管理起来，让你无论在手机、电脑还是命令行终端，都能随手处理这些生活碎片。
家庭事务分散在各个角落：手机提醒、冰箱贴纸条、微信群里的"别忘了"……Now & Again 把它们全部收拢到一个平台：
- Web UI — 家庭成员在手机/电脑上查看任务大屏，一目了然
- CLI (
na) — 极简命令行，一条na todo done就能完成待办，轻松融入终端工作流 - Go SDK — 外部工具（脚本、CI、定时任务）直接调用，无需手写 HTTP 请求
- AI 集成 — 搭配 AI 助手，通过自然语言即可管理家庭事务
最重要的是 易于融入现有场景，不必打开任何界面。
Now & Again 不是另一个待办 App，而是 给 AI 的家庭事务状态机。
AI 理解自然语言、感知上下文，但家务需要状态管理——什么该做、谁来做、做了没有。Now & Again 提供确定性的状态管理，让 AI 不需要自己维护复杂的任务拓扑和进度，只需调用简单的 API 就能查询状态、推进流程。
你早上把衣服丢进洗衣机就走了。
洗衣机完成洗涤 → 检测器调用 fulfill API → "洗衣"待办自动完成 → chain 插件自动推进到"晾晒"。你在办公室收到提醒，AI 跳过已完成的步骤，整条任务链自动推进。
人驱动 AI → AI 驱动状态机 → 设备反馈结果。 Now & Again 是其中"状态机"这一环。
→ 详见 未来场景
两步走：Docker 启动服务 → AI 助手接管一切。
mkdir -p ./na-data
docker run -d \
--name now-and-again \
--user "$(id -u):$(id -g)" \
-p 8080:8080 \
-v $(pwd)/na-data:/data \
-e GIN_MODE=release \
ghcr.io/dezhishen/now-and-again:latest也可使用 docker compose：
curl -O https://raw.githubusercontent.com/dezhishen/now-and-again/main/docker-compose.yml && docker compose up -d
服务启动后访问 http://localhost:8080，默认账号 admin。
首次启动时密码会打印在日志中，查看方式：
docker logs now-and-again | grep "Password:"也可以通过环境变量 NA_ADMIN_DEFAULT_PASSWORD 自行指定密码。
数据持久化在
na-data中，升级时不会丢失。详见 Docker 部署。
把下面这段话复制给你的 AI 助手（OpenClaw / Hermes …），它会自动完成 CLI 安装、初始化，之后你就可以用自然语言管理一切：
帮我在当前电脑上安装 Now & Again 的命令行工具
na。去 GitHub Releases 页面找到适合我系统的版本，下载并安装到 /usr/local/bin/。 发布地址是 https://github.com/dezhishen/now-and-again/releases 支持 Linux、macOS、Windows，amd64 和 arm64 都有。
安装完成后初始化，先通过
docker logs now-and-again | grep "Password:"获取管理员密码：
- 服务器地址：http://localhost:8080
- 用户名：admin
- 密码：<从日志中获取>
初始化后选择默认家庭，然后告诉我今天有什么事要做。
之后直接用自然语言对话：
👤 今天有什么事要做？
🤖 待办有 3 项：倒垃圾、遛狗、大扫除
👤 倒垃圾搞定了，备注分类投放
🤖 ✅ 已完成 — 分类投放
👤 每天晚上8点倒垃圾
🤖 ✅ 已创建，每天 20:00
👤 创建一个家庭叫"温馨小家"
🤖 ✅ 已创建，邀请码: ABCD1234
👤 帮我设置一个定时提醒：每半小时检查接下来一小时的待办，以及之前还没完成的待办，汇总提醒我。注意夜间（22:00-08:00）不要打扰
🤖 ✅ 已设置，每 30 分钟检查一次，夜间静默
👤 把遛狗改成每天早上7点半
🤖 ✅ 已更新，每天 07:30
👤 这周末我要出门，帮我把周末的任务全部跳过
🤖 ✅ 已跳过周六、周日共 6 项待办
→ 完整对话示例见 OpenClaw 接入指南。
| 变量 | 默认值 | 说明 |
|---|---|---|
NA_PORT |
8080 |
HTTP 端口 |
NA_ADMIN_DEFAULT_PASSWORD |
(随机) | 初始管理员密码 |
NA_DATA_DIR |
/data |
数据根目录（容器内） |
NA_JWT_SECRET |
(自动生成) | JWT 签名密钥 |
后端强制使用 UTC。客户端在 API 边界自动做 UTC ↔ 本地时区转换，对用户透明。
| 版本 | 目标 |
|---|---|
| v1.0.x | 数据模型、认证、家庭/小组、任务调度、插件系统、待办、ICS、模板、Web/CLI/SDK |
| v1.1.0 🚧 | fulfill API、Hook 插件体系、通知渠道（邮件/企微/钉钉） |
| v1.2.0 | 家庭事务统计、耗时趋势、自动化建议 |
→ 详见 完整路线图
核心模块全部完成，详见 核心特性。
当前重点：
- v1.1.0 外部交互与通知 — fulfill API、Hook 插件
| 文档 | 说明 |
|---|---|
| 核心特性 | 完整功能列表与插件系统介绍 |
| 未来场景 | AI + 智能家居 + 任务链自动化 |
| 架构设计 | 系统架构、分层设计 |
| API 文档 | 73 个 RESTful 端点 |
| 数据库 Schema | 数据模型与表结构 |
| Docker 部署 | Docker 一键部署 |
| 教程索引 | 模板、巡检、家庭、日历、AI 接入 |
| 路线图 | 版本规划与里程碑 |
| CLI 使用 | 命令行工具安装与命令参考 |
MIT © Now & Again Contributors