习惯

习惯模块（规格 v1）

个人习惯打卡：养成 / 戒除、三种记录方式、时段分组、统计与补记、多点提醒，并对接日程与目标。产品对标滴答清单习惯面（不含会员限额 / OS 小组件 / 第三方同步）。

命名： 产品名「习惯」；壳 ShellModuleId=habits；组件 / feature / RPC 为 habit；打卡记录组件 habit_check_in。

habit（活习惯）
  └── habit_check_in（按自然日一条；宿主 i18n.timezone 的 YYYY-MM-DD）

打卡动作按极性不同：

极性	产品动作	`amount` 含义	达标
`build`（养成）	打卡	当日完成量	`amount >= target`（无记录未达标）
`break`（戒除）	记一次	当日发生量	`amount <= target`（无记录达标）

无独立 DDL（JSONB + components[]）。

字段	说明
`polarity`	`build` \| `break`
`record_mode`	`boolean`（完成全部 / 严格零次）\| `auto`（每次固定量）\| `manual`（手输量）
`target` / `unit` / `auto_amount`	养成=日目标；戒除=日上限。`boolean`+养成 `target=1`；`boolean`+戒除 `target=0`
`frequency`	`daily`/`weekly` + `interval` + 可选 `weekdays` / `anchor_day`
`day_section`	`morning` \| `afternoon` \| `evening` \| `other`
`reminders[]`	`{ time: "HH:mm" }` 当日多点
`enable_journal` / `check_in_style`	日志开关；`check` \| `stamp`
`status`	`active` \| `archived`
`sort_order` / `color?` / `icon?`	排序与展示

达标谓词见上表（isHabitDayMet）。同一 habit_id+day 仅一条。

`record_mode`	`habit.checkIn`
`boolean`	养成：置 `amount = target`；戒除：置 `amount = target + 1`（刚超上限）
`auto`	`amount += auto_amount`（可多次）
`manual`	`amount += amount_delta`（必填）

可补 day 做补记；undoCheckIn 撤销全日或回退量。删除习惯时级联软删其 check-in。

方法	用途
`habit.list` / `get` / `create` / `patch` / `delete`	CRUD；list 默认 `active`
`habit.reorder`	同 section 内排序
`habit.archive` / `unarchive`	归档 / 恢复
`habit.checkIn` / `undoCheckIn`	打卡 / 撤销
`habit.listCheckIns`	按习惯 + 日期窗
`habit.stats`	总天数、连续、本月、月度格子
`habit.presets`	内置习惯库（静态）

实现：packages/habitat/features/habit/；UI：packages/frontend/features/habit/。

壳路由 /habits（Rail「习惯」）。主列表按时段分组 + 拖拽排序；详情含月度打卡表、补记、编辑、归档；统计页周/月概览；习惯库一键创建。

reminders[] 按宿主时区拼当日 ISO，由任务提醒扫描一并写入 Inbox；source_ref=habit:{id}:time:{HH:mm}:{day}。