jesse-uxandGrok (agent loop)
8f7c0f7db4
右上角「启程 n/N」按真实使用打勾，收费项读计价表。八条提示一次一条，看过写入已有的 onboarding_state。没有新表、新接口，也没有增加 Home 的状态。 自测：tsc --noEmit 通过；frontend 下 npm run lint 是 0 error、121 warning；定向测试 94 项全过，清单测试在最后一次改动后再跑 12 项全过；npm run build 后 / 仍是 Static。首屏 JS gzip-9 是 617860 字节，相对 592895 增加 4.21%，原因写在进度里。没有跑全量 npm test，没有跑 Python 快速门，没有宣称 test:db。 Co-Authored-By: Grok (agent loop)
118 lines
7.1 KiB
Markdown
118 lines
7.1 KiB
Markdown
# Jyotisha 产品领域
|
||
|
||
本上下文定义 Jyotisha Agent 对话、回复质量与后台排错所使用的统一业务语言。
|
||
|
||
## Language
|
||
|
||
**Agent 会话**：
|
||
用户与某一种 Jyotisha Agent 持续交互的容器，例如普通咨询或出生时间校正。
|
||
_避免使用_：聊天记录、咨询（用于泛指所有 Agent 场景时）
|
||
|
||
**来源对话**：
|
||
用户从中开始一次生时校正的那条普通咨询会话。校正做完回到它；关联记在该会话回答上的提议卡里（`rectificationOffer.caseId`），不另建表（2026-10-07，BUG-1249）。
|
||
_避免使用_：原会话、父会话
|
||
|
||
**提议卡**：
|
||
普通咨询回答下面、由服务端决定能否出现的「开始核对出生时间」卡片；生时校正唯一的新入口（2026-10-07，BUG-1248）。
|
||
_避免使用_：校正入口按钮、首页卡片
|
||
|
||
**Agent 对话轮次**：
|
||
在 Agent 会话中，从用户输入触发 Agent 生成一条回复开始，到 Agent 完整回复或该次回复失败为止的一次交互。
|
||
_避免使用_：单条消息、一轮对话
|
||
|
||
**Agent 执行尝试**：
|
||
使用独立请求标识执行一个 Agent 对话轮次的一次尝试；重试同一轮次会产生新的尝试。
|
||
_避免使用_：重复消息、同一请求
|
||
|
||
**Agent 执行故障**：
|
||
Agent 执行尝试因技术异常未能正常产出完整回复。未登录、余额不足和参数不合法等预期业务拒绝不属于执行故障。
|
||
_避免使用_：所有失败请求、报错
|
||
|
||
**未完成回复**：
|
||
Agent 执行故障发生前已经展示给用户、但未正常结束的 Agent 输出。
|
||
_避免使用_：正常回复、可评价回复
|
||
|
||
**故障诊断摘要**：
|
||
面向管理员的结构化脱敏故障说明，可用于定位执行阶段和失败类型，但不包含敏感原始诊断内容。
|
||
_避免使用_：原始异常、完整日志
|
||
|
||
**故障上下文快照**：
|
||
为排查 Agent 执行故障而保留的故障轮次及该次执行实际使用的近期上下文，不等同于完整会话副本。负向回复评价也保留一份：该轮提问与回答、按会话重建的模型上下文窗口与运行事实，90 天后清空正文。
|
||
_避免使用_：完整聊天记录、错误消息
|
||
|
||
**回复评价**：
|
||
用户针对一条完整 Agent 回复提交的当前正向或负向质量判断。评价属于具体回复，而不是整个 Agent 会话。
|
||
_避免使用_：会话评分、点赞记录
|
||
|
||
**报告语言版本**：
|
||
同一份个人报告的中文版与英文版，由同一次引擎计算、同一个数据包分别渲染，数字逐项一致。英文版是从属版本：缺失或未通过检查时报告仍以中文交付；英文版上线前生成的报告只有中文版。
|
||
_避免使用_：翻译版、机翻、英文报告（指另一份报告时）
|
||
|
||
**同意记录**：
|
||
用户在某个时间接受了某一版本的《用户协议》或《隐私政策》的记录（`user_consents`，只追加不修改）。协议版本变化后需要重新同意。
|
||
_避免使用_：授权、签约
|
||
|
||
**不满意原因**：
|
||
负向回复评价附带的一个或多个原因分类，可包含用户补充说明。
|
||
_避免使用_：投诉、差评文本
|
||
|
||
**反馈与投诉**：
|
||
用户从账户菜单主动提交的一条问题反馈、内容举报、退款与扣点诉求或其他意见，由后台「反馈与投诉」处理，状态为待处理、处理中、已解决或不予处理。只保存用户自己写的内容、选填的联系方式和（勾选时）会话编号，不保存对话原文。它与「回复评价」「对话质量记录」是两回事。
|
||
_避免使用_：工单（泛指时）、差评、客服记录
|
||
|
||
**对话质量记录**：
|
||
管理后台中供管理员排查或审阅的一项 Agent 执行故障或负向回复评价。
|
||
_避免使用_：聊天日志、客服工单
|
||
|
||
**处理状态**：
|
||
对话质量记录的内部处理进度，取值为待处理、处理中、已解决或忽略。
|
||
_避免使用_：用户反馈状态、通知状态
|
||
|
||
**人物**：
|
||
一张星盘档案对应的一个人。户主本人也是其中一个人。不要再叫「当前星盘」来指这个人。
|
||
_避免使用_：当前星盘、关系、默认星盘
|
||
|
||
**关系（人物）**：
|
||
这个人相对户主的家里关系：伴侣、孩子、父母、朋友或其他。只记在别人的档案上，本人不记。没填过的显示「其他」。它不是人物的别名。
|
||
_避免使用_：用「关系」称呼这个人、家人（笼统代替这五项）、客户
|
||
|
||
**启程清单**：
|
||
首页顶栏右侧的「启程 n/N」。七项对应已经能用的功能，勾从真实使用推导，不另存一份进度。点「先不看了」之后不再出现。收费项的价格跟计价表走。
|
||
_避免使用_：新手任务、引导任务、单独把进度环叫进度条
|
||
|
||
**一次性提示**：
|
||
第一次用到某处功能时，指着那个位置说的一句。一共八条，同一时刻只出一条。看过就记下来，不再出现。天空过场、兑换窗、弹窗和回答还在生成时先不出。
|
||
_避免使用_：新手引导、教程、教学气泡
|
||
|
||
**星盘档案**：
|
||
侧栏页面 `/people` 里保存的人物列表。最多 5 人，含本人。本人不可删除。
|
||
_避免使用_：星盘库、星盘资料（设置里的旧面板）
|
||
|
||
**当前人物**：
|
||
这一次星盘、星历、报告、今日星语和新对话默认使用的那个人。只作为请求参数交给服务端，不替换页面上的本人资料。
|
||
_避免使用_：设为默认、active chart
|
||
|
||
**领域别名**：
|
||
生时校正里，健康在证据账本和焦点层记为 `health`，计划层、引擎探针和盘外提示用 `health_pressure`；职业焦点落库为 `other`（题号仍是 `collect:occupation:`），计划层与账本用 `occupation`。比较时两侧都要先归并，不能按字面相等。数据库 `target_domain` 约束不改。
|
||
_避免使用_：把 `health` 和 `health_pressure` 当成两个领域、把职业拒答当成 `other` 领域
|
||
|
||
**盘型**：
|
||
星盘页「星盘」Tab 里可选的一张印度盘：本命（D1）、各分盘（D2–D60）、月亮盘、Bhava 盘、行运盘，共 23 种。每种盘型有自己的一张表。
|
||
_避免使用_：分盘（泛指全部盘型时）、chip
|
||
|
||
**月亮盘**：
|
||
本命盘改以月亮所在星座为第 1 宫重新数宫（Chandra Lagna）。星座、度数与本命相同，只有宫位变。
|
||
_避免使用_：Moon chart 当作分盘、D1 的变体盘名
|
||
|
||
**Bhava 盘**：
|
||
按 Sripati 宫制把本命行星按不等宫的宫界（sandhi）重新归宫的盘；宫头由出生时刻的上升与恒星黄道天顶（MC）三等分象限得出。拿不到真实天顶时不出这张盘。
|
||
_避免使用_：宫位盘、等宫盘
|
||
|
||
**行运盘**：
|
||
某一天（星盘页是今天）中午出生地时区的行星位置，放进本命盘的宫位（本命上升为第 1 宫），岁差与交点和本命相同。
|
||
_避免使用_：流年盘、过运盘（泛指）
|
||
|
||
**那一刻的天空**：
|
||
出生地、出生那一刻头顶的真实天空画成的 3:4 封面（天顶在圆心、东在左，地平线以上的行星与亮星照实画）。图上只有描述天空的一句话，不印任何出生资料，也不讲运势。
|
||
_避免使用_：出生星空图、星盘海报、人设卡
|