docs(tasks): brief for starter home hint split and icons

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017eEAG8HD3mm8gsKXgk8uU8
This commit is contained in:
Jesse_Chen
2026-09-26 06:08:49 +08:00
co-authored by Claude Opus 5.5
parent 65260ca7e0
commit 13c70a162a
2 changed files with 38 additions and 0 deletions
+1
View File
@@ -119,6 +119,7 @@
| 任务书 | 进度 | 主题 | 状态 | 落点 |
| --- | --- | --- | --- | --- |
| `TASK-starter-home-polish-20260926.md` | — | **首页开场小字与图标**:今日趋势(每日模型生成,非写死)移到问候下方副行;入口下方提示只在有未完成校正或非本人时出现,删两句固定文案并修正已校正仍显示首次文案的分支;今日星语图标 MoonStar、点数图标 Coins。排在 BUG-1038、1040 之后 | 待领取 | — |
| `TASK-home-warm-return-20260926.md` | — | **从其他页面回首页不再放加载动画**:首页按组件挂载计揭幕,客户端返回会重跑模型列表 / 后台状态 / 入口摘要 / 今日星语(3–5 次往返 + 最多 4 秒)。产品定:每次打开网页只揭幕一次;模块级暖快照按账户隔离、只存内存,暖返回首帧即就绪、后台静默刷新;缺项回落冷启动,不许半揭幕。**排在 BUG-1038 合入后**。BUG-1040 | 待领取 | — |
| `TASK-new-chat-from-people-20260926.md` | — | **从星盘档案页点新建对话落回上一次生时校正**(产品 09-26 真机):标题显示旧校正会话、输入框「正在打开生时校正…」,中间却是新对话开场;另有两套新建入口(`?new=1` 与 `?newChat=1`)违反 BUG-1015 一处解析红线。先复现写失败测试、定位跨页残留状态再修,合并入口。BUG-1038 | 待领取 | — |
| `TASK-people-archive-p1-fix-20260925.md` | `PROGRESS-people-archive-p1-fix-20260925.md` | **P0修复**:worker按持久化人物解析、真实删除预留退款、本人历史OR is、切人/消息时序及P2/P3;BUG-1031/1032,关联1030/990/1024。永久定向54/54、独立前端5探针与退款r4六场景通过;必须最终Node22 Linux全量+DB逐条基线对照 | 已验收(Claude 09-25:两 P0、两 P1、七 P2 通过;新 P2 删后跳错人、人物接口故障连累聊天 → 收尾单) | `4d801e53`(已部署,health 核对一致) |
@@ -0,0 +1,37 @@
# TASK · 首页开场小字拆分 + 今日星语 / 点数图标(2026-09-26)
## 基线
- `origin/staging` 当前 head。分支 `codex/starter-home-polish-20260926`。
- **串行**:改 `frontend/src/app/(app)/page.tsx`,排在 `TASK-new-chat-from-people-20260926`(BUG-1038)与 `TASK-home-warm-return-20260926`(BUG-1040)**之后**。
## 事故实证(产品 09-26 真机截图)
首页入口按钮下方一段三行小字:「月亮今天行经双鱼座,你的心思容易朝远方和意义飘,节奏偏松,适合慢一点。 · 不确定出生时间时,用记得住的经历一步步缩小范围」。
- `frontend/src/components/starter-home.tsx` `StarterEntries`:`<p className="starter-entry-hint">{dailyHint} · {rectificationHint}</p>` —— 两句无关提示用「·」硬拼。
- 前半句 `dailyHint` = `page.tsx` `dailyStarlanguageTrend` = 今日星语卡片 `trend`:`/api/daily-starlanguage` **每日由模型生成**(`DAILY_STARLANGUAGE_MODEL_ID`,缺省 deepseek),失败时回落 `daily-starlanguage.ts` `composeDailyStarlanguageCard` 规则模板。**不是写死轮转**。
- 后半句 `rectificationHint` 写死三选一(有未完成 case / `rectificationCardAction === "restart"` / 首次);截图账号已校正过,仍显示首次文案,说明分支判断与实际状态不符(`restart` 未命中)。
- 图标:今日星语入口 `Sparkles`(`starter-home.tsx`),右上角点数 `Sparkles`(`page.tsx` `className="credit-icon"`),两处同图标。
## 决策记录(产品 2026-09-26)
- D1 今日趋势句移到问候语**下方**单独一行(`StarterGreeting` 增加可选副行,浅色 `--color-ink-secondary`、`--type-body-sm`,最多两行、超出省略);今日星语未就绪时显示现有静态句「今天的星语还没写出来。」;没有出生分钟(`natalMinuteAvailable` 为假)时不显示副行。
- D2 入口按钮下方**平时不显示任何提示**;只在需要用户动手时出一句:
- 有未完成的校正(`hasResumableCase`)→「上次那次校正还没完成,可以接着做。」
- 当前人物不是本人 →「生时校正暂时只支持本人。」
- 其余情况(首次、已校正)不显示。删除「不确定出生时间时…」「上次已经校正完…」两句。
- 修正分支判断:以 entry summary 的真实状态为准,不再依赖可能未命中的 `restart`。
- D3 今日星语入口图标改 lucide `MoonStar`;右上角点数图标改 lucide `Coins`(`aria-hidden` 不变,按钮可访问名不变)。
- D4 `!natalMinuteAvailable` 时的边界句「出生时间不足以支持的判断我会说明…」保留原位。
## 硬红线
首页 `○ Static`、gzip ±2%;`Home()` 不新增 hook、`page.tsx` 不超增长合同;不改今日星语接口与生成逻辑;首页揭幕规则不变(副行不得引入新的等待态);更新 `frontend/DESIGN.md`(首页空状态一节)与 `frontend/docs/VOICE.md`(删两句、加一句);全量测试与基线逐条一致、新增 0;改动断言三栏写在测试文件里;真实浏览器 375 / 1280 截图(开发预览模式)。
## 任务分解
- T1 `StarterGreeting` 副行 + `page.tsx` 传入今日趋势(D1)。
- T2 `StarterEntries` 提示按需显示 + 分支修正(D2、D4)。验收:组件测试覆盖四种状态(首次、已校正、有未完成、非本人)各自是否显示、显示什么。
- T3 图标替换(D3)。
- T4 CHANGELOG、DESIGN、VOICE、PROGRESS、`docs/testing/` 一条真机项。本单为产品调整,不开 BUG 号(D2 的分支误判若确认为 bug,用开工时下一个空号记一条)。