docs(research): chart UI vs competitor breakdown (agent loop, issue #114)

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LutgzyJqNhPpZy1nFsJtN3

docs/research/chart_ui_vs_competitor_2026_10_27.md

@@ -0,0 +1,85 @@
+# 星盘界面对标竞品：拆解与方案（issue #114，2026-10-27）
+
+产品负责人 10-27 转来某竞品 13 张截图（星盘页、盘面检视、深读四个页签、对话页右侧盘面），要求「按这种来做」，先按业务拆开、逐项把需要他定的事说清，全部定了再开工。截图里有一张含真实出生资料，本文不引用。
+
+我方现状来自 staging `009456d8e` 代码盘点（`frontend/src/components/chart-page/*`、`chat-chart-frame.tsx`、`chart-view-*.ts`）。
+
+## 0. 总体对照
+
+| 竞品 | 我方今天 |
+| --- | --- |
+| 一页铺开：左边大盘 + 盘面检视，右边九曜表 / 宫位主题 / 大运条 / 命盘速览，下面「深读」四个页签 | 四个页签（星盘 / 基础信息 / 大运 / 西洋盘），每次只看一块 |
+| 南印度方盘为默认，可切北印度菱形盘 | **只有北印度菱形盘** |
+| 点星 / 点宫：盘上画宫主线和视相线、表格同行高亮、检视面板展开 | 点星只弹一个文字气泡；西洋盘有相位线联动，印度盘没有 |
+| 盘上可叠「八宫点 / 宫力 / 行运」图层 | 没有图层；行运是单独一种盘型 |
+| 六力、宫力、八宫点、瑜伽、出生历法都有可视化 | **引擎都算了（有接口），星盘页一样都没接** |
+| 大运三层（大运 / 分运 / 子运）带进度条，等比长卷可逐层展开，可换观测日期 | 两层（大运 → 子运），子运日期是前端按年数比例拆的，没有进度、不能换日期 |
+| 对话页右侧是完整可点的盘 + 检视 + 九曜表，空对话给按盘出的问题 | 右侧只有一张不能点的 D1 小图，默认收起，手机没有 |
+
+竞品也有没做好的地方：「宫主流向」整列「未提供」，六力「门槛未提供」，瑜伽把大量「未满足」也列出来——这些我们引擎都有数据，可以做得更完整、更干净。
+
+## 1. 业务拆分（每块一张任务书，按顺序）
+
+### M1 盘面本身
+
+- 新做南印度方盘（固定星座格、上升斜线、中心大字「上升 巨蟹」样式、度数上标、旺 / 陷 / 逆标记），与现有北印度盘可切换，记住用户选择。
+- 盘型条沿用现有 23 种（D1～D60、月亮盘、宫位盘、行运）。
+- 中心显示当前三层大运小标签。
+- 图层：无 / 八宫点（每宫角落显示点数，高于 28 金色、低于蓝色）/ 宫力 / 叠加行运（行运星以浅色叠在本命盘上）。
+
+### M2 点选联动 + 盘面检视
+
+- 点星：该星所在格高亮，其余变淡；实线连到它主管的宫，虚线连到它视相的宫；中心改显示这颗星；右侧表格同一行高亮。
+- 检视面板：星座内位置条（0°～30°，标月宿分界）、月宿、尊贵刻度（陷 → 中 → 旺）、六力（对门槛的百分比）、视相宫位、主管大运区间、此刻行运位置；按钮「问 AI：这颗星」「在 D9 定位」。
+- 点宫 / 点「宫位主题」小签：该宫高亮，面板显示宫主、宫内星、宫力、八宫点。
+- 键盘 ← / → 切换、Esc 收起（桌面）。
+
+### M3 命盘速览 + 顶部小签
+
+- 速览卡：上升（度分）、月亮星座与月宿、灵魂星（Atmakaraka，写中文）、当前大运 › 分运（带进度条与结束日）、六力最强、需留意（最弱或落陷）。
+- 页头小签：上升 / 月亮 / 太阳 / 当前大运，点了在盘上定位。
+- 与 #112 的「上升确定 / 可能换座」那一行放在一起。
+
+### M4 时运流年
+
+- 观测日期：日期选择 + 上月 / 下月 / 上年 / 下年 / 此刻；换日期后大运进度、行运表、叠加图层一起更新。
+- 当前运期三层（大运 / 分运 / 子运）：起止日期、已过百分比、剩余时长。
+- 九曜行运表：星座度数、从上升起第几宫、从月亮起第几宫、该宫八宫点；土星七年半状态。
+- 人生长卷：三行等比条（大运 / 该大运的分运 / 该分运的子运），点哪段展开哪段；「叠到盘面」。
+- 需要引擎补：子运第三层（目前前端按比例拆，需改用引擎值）、任意日期行运（接口已有）。
+
+### M5 能量图谱
+
+- 行星六力：每星一条总量 + 六段分量（自然 / 位置 / 方位 / 时间 / 运动 / 视相），竖线为门槛，右侧百分比。
+- 宫位力量柱状图，均值虚线，点柱选宫。
+- 八宫点矩阵：按宫位 / 按星座；原始 / 三角削减 / 同主削减三种口径切换；格子按点数深浅着色。
+- 数据：引擎已有 `/api/shadbala`、`/api/bhava_bala`、`/api/ashtakavarga`，需接进星盘页。
+
+### M6 命性格局（瑜伽）
+
+- 组合列表：名称、涉及行星、状态（条件满足 / 部分满足）；点一条在盘上高亮涉及的星。
+- 引擎 `/api/yogas` 是否给「部分满足」需开工前核对。
+
+### M7 排盘底册
+
+- 出生资料与计算口径（岁差、宫制、交点）、出生历法（提毗、羯罗那、常瑜伽、日出日落、月出、当时行星时）与各要素下次交界时刻、行星名册、宫主流向（第 N 宫之主 → 落第几宫）。
+- 历法数据：星历页已有五要素，日出日落 / 行星时 / 交界时刻需引擎补。
+
+### M8 对话页右侧盘面
+
+- 右栏换成可点的完整盘（M1 + M2 的窄版）：顶部小签、盘、检视、九曜表；「换一盘」切人物档案里的人。
+- 空对话中间显示「盘面已带入」+ 按这张盘出的 4 个示例问题。
+- 检视面板「问 AI：这颗星」直接在当前对话里发问。
+
+## 2. 顺序与依赖
+
+- #111（组件库修复）、#112（星盘页页头一行）都在改星盘页，**本需求排在它们合入之后**。
+- 建议分三批：
+  - **第一批**：M1 + M2 + M3 + M8（看得见、用得最多）。
+  - **第二批**：M4 时运流年。
+  - **第三批**：M5 + M6 + M7（数据型）。
+- 执行：按任务书模式交 Grok，Claude 验收；一次揭幕、首屏 gzip ±2%、`page.tsx` 不增状态等红线照旧。
+
+## 3. 需要产品负责人定的事
+
+见 issue #114 评论（Q1～Q9）。