Files

T

jackyu66gitandCursor bd22d9dddd feat: P1 合盘/星座/问答与测测完整设计包及模拟器取证工具

落地 synastry/star/ask API 与 H5 页面，补齐 cece-frontend-re complete-design 证据文档，并加入 Android 模拟器截图抓取脚本。

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-08-03 11:37:53 +08:00

5.0 KiB

Raw Blame History

Feature Spec: 意象卡片

Status: Active（设计）· Map: 2.8 意象卡片 [P2] · Phase: P2
规范：../feature-design.md · 队列：P2-BACKLOG.md
竞品对照：塔罗体系（能力同构；UI 禁止「塔罗」入口名）

1. 功能定义

字段	内容
Name	意象卡片
Purpose	通过抽取 1～3 张意象卡，对当下议题做投射反思，并给出结构化反思题与行动建议
Business Goal	高趣味探索与分享；免费次数 + 深度解读转化

In	Out
场景选题 · 抽卡 · 探索摘要 · 深度组合解读	吉凶判定、神谕、恐吓
卡面内容库（seed）	UI 文案「塔罗」「牌阵占卜」
每日免费次数规则	宿命叙事

2. 用户价值

为何需要： 卡住时需要一个轻量的外在意象帮助整理感受。
完成后获得： 卡片意象说明、反思问题、可执行小建议；深度版含组合解读与练习。
为何付费： 多卡组合与完整练习路径。

3. 用户角色

Actor	能力
Visitor	每日免费 N 次基础抽卡（N 实现时定数，建议 1～3）
DeepAccess（本结果）/ VIP	深度组合解读
可选挂档案	有档案时文案可轻微个性化（非必须）

4. 用户流程

/cards
  ↓
选择场景：情绪整理 / 关系 / 选择 / 自我
  ↓
检查今日免费次数
  ├─ 耗尽 → 引导会员或明日再来（可看历史）
  └─ 有余 → 抽 1 张（免费）或解锁 3 张组合（深度）
        ↓
      展示意象 + 反思题 + 建议
        ↓
      分享（积极、非恐吓视觉）

5. 页面设计

路由	页面
`/cards`	ImageCardPage（P2 draft）
`/explore`	入口「意象卡片」
`/reports/:id` 或结果页内	深度结果沉淀（可选）

/cards
├── Scene picker
├── Loading（抽卡动画，克制）
├── Normal（单卡摘要）
├── Locked（组合深度）
├── Quota empty
└── Error

6. 页面状态规范

状态	UI
Loading	抽卡中
Normal	意象说明 + 反思
Locked	组合解读墙
Quota empty	次数用尽说明 + 会员 CTA
Error	重试

7. Business Rules

ID	Rule
R1	用户可见文案不得出现「塔罗」；用「意象卡片」「探索」「反思」
R2	禁止吉凶、神谕式断言、恐吓（如「大难」）
R3	输出必须含：意象描述 · 至少 1 个反思问题 · 1 条可执行建议
R4	免费：每日有限次单卡摘要；深度：3 卡组合 + 练习（Membership 或单次 DeepAccess）
R5	抽卡随机可接受，但卡面文案来自审核过的内容库（非模型现场胡编吉凶）
R6	分享卡不得含恐吓图文；过 lexicon
R7	次数与权益 Server 判定

8. 数据模型影响

项	说明
内容库	`image_cards` 表或 seed JSON（id, title, image_key, explore_text, prompts[]）
结果	`growth_reports.type=image_card` 或 `scale_results` 变体（实现时二选一，写 OpenAPI）
配额	用户日维度计数（表或 Redis）；实现时定

禁止：tarot_* 作用户可见 API 路径名（对内包名用 imagecard）。

9. API 需求（草案）

Method	Path	意图
GET	`/api/v1/image-cards/scenes`	场景列表
POST	`/api/v1/image-cards/draw`	scene → 抽卡结果（扣免费次）
GET	`/api/v1/image-cards/quota`	今日剩余
GET	`/api/v1/reports/{id}`	若沉淀为报告

深度组合可同 draw 参数 depth=true + 权益校验。

10. 权限设计

能力	免费额度内	额度外	深度权益
单卡摘要	✓	✗	✓
三卡组合解读	✗	✗	✓

11. 埋点

Event	触发
`cards_scene_selected`	选场景
`cards_drawn`	抽卡成功
`cards_quota_exhausted`	次数用尽
`deep_access_clicked`	surface=cards
`cards_share_clicked`	分享

12. 测试验收标准

Given 有免费次数
When 抽卡
Then 返回意象+反思题+建议；响应与 UI 无「塔罗」「吉凶」

Given 次数为 0
When 再抽
Then 业务错误，不生成假深度

Given 无深度权益
When 请求组合解读
Then Locked / 剥离

13. AI 开发前检查

Spec 齐全 · 禁用塔罗入口已写清
lexicon ImageCard
内容库 seed 与 OpenAPI（编码时）

14. Implementation Notes

项	内容
复用	ShareSheet · membership/orders · Explore 入口
工作量	卡面文案/视觉资产最大；宜先 22～78 张小库 MVP
Packages	`internal/imagecard` · `ImageCardPage` `/cards`
实现	scenes/quota/draw API · 报告 type=`image_card` · 日配额表 · seed 12 卡
编码顺序	P2-BACKLOG 切片 3 Done

5.0 KiB Raw Blame History Unescape Escape