Update algorithm and API documentation for smoking recovery and motivation features

- Added unified backend calculations for health recovery, savings, and motivation generation in the algorithm documentation.
- Updated API documentation to include new endpoints for retrieving statistics and motivation messages, enhancing clarity on data retrieval processes.
- Revised product documentation to reflect changes in API usage for health recovery and savings calculations, ensuring consistency across all related files.

docs/smoke/PRODUCT.md

@@ -82,9 +82,10 @@
 
 ## 5. 页面能力清单
 - 首页：上次实际抽烟时间（用于计时）、今日累计、今日克制、较昨日增减（可为负并标识“超出昨日”）、下次建议时间（默认/AI）、时间节点列表、快速入口（抽烟/忍住）。
+- 首页激励语：`GET /api/v1/smoke/motivation`
 - 记录页：快速添加抽烟、快速忍住、补录真实时间 `smoke_at`。
 - 列表页：按日期筛选、分页、区分“抽烟/忍住”标签、支持编辑/删除。
-- 看板页：周视图/区间视图，展示每日支数与 `minutes_since_last`。
+- 看板/统计页：使用 `GET /api/v1/smoke/stats?range=week|month|year` 获取趋势、均值、环比、健康与省钱等数据。
 - AI 建议页：每日建议展示（解锁后生成）。
 - 基础信息页：补全/编辑基础烟量、动机/动力、作息。