growork 1.0.0

package/test/prd-5spread.md

@@ -0,0 +1,74 @@
+# 【V1.7】五牌阵（外化）
+
+| 日期 | 版本 | 修改人 |
+| --- | --- | --- |
+| 2026/1/7 | V1.0: 创建文档 | @ou_b7af96ce7aa4c1c66fc6dfe05920f483 |
+| 2026/1/16 | V1.1：修改首页牌阵场景逻辑 | @ou_b7af96ce7aa4c1c66fc6dfe05920f483 |
+| 2026/1/21 | V1.2：牌阵外化卡片新增字段：使用次数&点赞次数 | @ou_aee8dadd00d620825dc7d479734dc300  |
+
+# 一、需求背景
+
+目前产品内容侧已有 5 个牌阵，但在用户进入解读之前的关键链路上体验偏薄：用户从输入问题到开始抽牌/解读之间，系统仅提供一段简短的问题确认文字，缺少对牌阵选择逻辑的呈现与引导，导致用户对「为什么用这个牌阵、这个牌阵能解决什么」的理解不足。因此，本期需求将现有的5牌阵外化出来，增强用户对牌阵的参与感，同时外化丰富产品内容；
+
+# 二、需求详情
+
+**问题确认流程**
+
+**需求详情**
+
+| 原型 | 说明 |
+| --- | --- |
+|  | **解读页牌阵推荐****卡** **展示** **交互**  |
+|  | **首页牌阵场景** **展示** **交互**  |
+
+**牌阵文字库（已找教研确认）**
+
+| Spread Name | Spread Description |
+| --- | --- |
+| 时间流牌阵 (Past, Present, Future Spread) | Unfold your complete timeline to see how past influences are shaping your future outcomes.  |
+| 追本溯源牌阵 (Situation Analysis Spread) | Get to the bottom of 'why' by uncovering the hidden internal and external factors driving this situation.  |
+| 关系大十字 (Five-Card Cross Spread) | Analyze the causes and core issues, and provide analysis and action suggestions for the interaction of emotional relationships. |
+| 二择一牌阵 (Two-Choose-One Spread) | Weigh two potential futures side-by-side to clarify which path leads to your desired goal. |
+| 综合运势 (General Reading Spread) | Analyze past, present, and future trends to provide a comprehensive forecast for wealth, love, or career. |
+
+
+[嵌入表格: JaWGsQ9zghCsfltzHB1liQTfgPb_LijZ9A]
+
+# 调研附录
+
+字段补充
+
+| Esty | Walmart | Amazon? |  |
+| --- | --- | --- | --- |
+|  |  |  |  |
+
+**后期修改prompt后（多场景/更具体）可参考增加牌阵介绍页**
+
+**方案一：问题场景与牌阵一一对应**
+
+| 原型 | 说明 |
+| --- | --- |
+|  | **首页推荐** **展示** |
+|  | **牌阵介绍** **展示（以时间流示例）** 是不是正压着一块石头，不知道等待你的会是惊喜还是惊吓？ 无论是那场至关重要的考试，那个正在推进的项目，还是那段刚刚萌芽的关系，未来的不确定性总是让人焦虑。如果你正时间站在岔路口，想知道当前的努力是否白费，那就抽牌张看看吧！ 此牌阵会为你展开时间的卷轴，帮你理清过去的影响，透视现在的关键阻碍，更重要的是——我为你“剧透”这件事最终的大结局！ 英文版 ✅ **Those anxiously waiting for results:** Whether it's a job interview, a final exam, or a visa application, and you just can't sit still.  ✅ **Explorers of new beginnings:** You've just started a new project, business, or relationship and want to know if it will sail smoothly.  ✅ **Those seeking reassurance:** You are facing uncertainty and desperately need to know, "Will this actually work out?" **Is the fear of the unknown weighing you down?** Are you wondering if a big surprise or a sudden setback is waiting for you around the corner? Whether it's that crucial test, a high-stakes project, or a fresh romance, the uncertainty can be overwhelming. If you are standing at a crossroads in time, draw a card to clear the fog. This spread unfolds your personal timeline to reveal how the past shapes your present, what obstacles are currently in your way, and most importantly—**I will give you a "spoiler" on the final ending!**   **交互** 从牌阵介绍页进入解读页 推荐问题？不推荐 牌阵确认？不确认 使用原流程   |
+
+**方案二：一个牌阵对应多个问题场景（增加爱情场景高频问题/问题更具体）**
+
+高频问题定期根据用户数据调整？
+
+| 原型 | 说明 |
+| --- | --- |
+|  | **首页推荐** **展示** |
+|  | **问题介绍** **展示（以Does he/she actually like me?为例）** 英文版 |
+
+调研简述：
+
+- 可以仿照Quin，在问题确认下方增加问题解析+牌阵推荐（牌阵可选），牌阵的排布按照具体抽牌时的排布设计；在牌阵选择页给出牌阵简介
+| Hellobot |  | Lumi | laby | Quin |
+| --- | --- | --- | --- | --- |
+|  |  |  |  | 共16个牌阵，4个和感情相关 |
+
+| Quin | 小雀幸 | 测测 | AI Tarot | Sidera | Tarot card reading and meaning | Moonly | Lumi | Tarotoo | Tarot | Trusted Tarot | Labyrinthos Tarot Cards | Tarot reading |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+|  |  |  |  |  |  |  |  |  |  |  |  |  |
+
+[五牌阵prompt](https://romangic.sg.larksuite.com/wiki/RqR7w1dEgiwtFBk3vUnltS6lgWe?from=from_copylink&sheet=55f1a3)

package/test/push-prd-notion.md

@@ -0,0 +1,126 @@
+# 测试
+
+
+需求详情
+
+
+| 日期         | 版本         | 修改人  |
+| ---------- | ---------- | ---- |
+| 2025/11/28 | V1.0: 创建文档 | @徐子彤 |
+
+
+# 一、需求背景
+
+
+Push 在用户离开 App 后，产品与用户保持持续连接的最重要触点。通过系统化的 Push 能力，在合适的时间，可把有价值的内容主动送达到用户手中，从而：
+
+- 提升留存：通过每日塔罗牌 / 箴言提醒、回流提醒等，帮助用户养成使用习惯；
+- 建立情感连接：在节日、生日、特殊节点推送祝福或关怀内容，让产品不仅是工具，而是放大产品情感化；
+- 支持运营活动：在新功能上线、限时活动、专属优惠权益等场景，通过 Push 进行触达和转化，放大运营效果；
+- 获取用户声音：通过调研问卷、满意度回访等 Push，引导用户反馈体验，为后续产品优化提供数据支撑。
+
+因此，本版本围绕 Push 能力进行初版建设，为后续的精细化触达、运营玩法和留存提升打下基础。
+
+
+### **需求触发：**
+
+1. **信息缺口（站外）**：新功能上线、版本更新
+2. **用户潜在需求唤醒（留存）：活跃用户**：限时折扣（站内外）、专属权益（站内外）；~~**沉睡用户**~~~~：召回优惠券、回归礼包/折扣（站外）~~
+3. *特殊节点推送（站内外）：**节日/生日祝福（适当配合折扣福利）
+4. *社区活动推送（站内）：**站内push引流到站外社区（话题讨论、用户反馈等）（配合社区运营）
+
+### **展现形式：**
+
+
+**站外：****ios**系统Push、邮箱、社区消息
+
+- *站内：**站内信（banner）、弹窗
+
+### **推送时间：**
+
+1. *“Daily push”：****固定每天早上的时间（8h30-9h）：**每日运势
+2. **生日/节日** **“Celebration”：****特殊日的早上（8h30-9h）：**生日祝福、节日祝福结合每日运势文案，如：“xxx祝你生日快乐，今日宇宙与你的链接最强，来看看今天的牌有什么指引”
+3. **要apple store 好评、评论** **“Review”：****晚上20h（8:00pm）**
+4. **折扣/福利** **“Offer”：****根据用户习惯使用时间（初始默认中午12h30）：**折扣福利、社区引流、专属权益
+5. **社区话题** **“Community”：****晚上20h（8:00pm）：**加入社区、话题讨论
+6. 用户个性化设置推送时间（站内的推送）
+
+需要监测点：
+
+
+push到达率、push打开率、push转化率、卸载率
+
+
+# 二、需求详情
+
+
+### 2.1 权限获取
+
+
+**新增字段：notification_permission_status**
+
+
+### 规则：
+
+1. **APNs 权限获取弹窗：**
+
+**授权**
+
+
+**拒绝：拒绝后官方默认不会再出现，用户使用一个月后站内弹窗**出现：提醒用户去iphone**后台打开权限**，再次拒绝后本**年度**不会再提醒
+
+1. **站内权限获取弹窗：**
+
+默认开着权限，
+
+
+在 **23:00 - 08:00** 之间禁止发送任何push
+
+
+**取值**
+
+- not_determined （从未请求过权限）
+- denied（用户明确拒绝/关闭）
+- authorized（已授权）
+
+### 弹窗
+
+| 说明 | 文件 | 场景 |
+| --- | --- | --- |
+| 弹窗时机**—站外系统通知权限**<br><br>苹果官方的 APNs (Apple Push Notification service)<br><br>- 第一次使用App：第一次 quick card 的**“reading completed”**解读完成时<br>    <br>      有了体验后可以降低拒绝概率<br>    <br>    - 弹权限获取弹窗<br>         | https://romangic.sg.larksuite.com/space/api/box/stream/download/asynccode/?code=NTQwN2NhNzM1ZDJiMzcxNWU2OGJlZTJlNGVkMmExMmRfcTJ0TERvNFRHSnA2aE9UV3Rhb245YjRtMU04QmhSbFNfVG9rZW46Wng4SWJOZTA3b2swZWV4QW5X |  |
+| 弹窗时机—站内系统通知跳转ios系统权限<br><br>- 弹出节点：第二次使用app：Quick card 解读完成“reading completed”时（也还没有深度问问题解读）<br>    <br>- 第一次弹出：<br>    <br>    - 判断notification_permission_status是否为authorized<br>        <br>    - 是，不 | https://romangic.sg.larksuite.com/space/api/box/stream/download/asynccode/?code=MWI5NjUxZmJlYTU3OTU1ODE2MjJkZmVjMzA0NzAwMzJfTGR5Q0NncGEwR2t1ZFNqV3JqV3VvRWtZWXo3ZWZjMmNfVG9rZW46REREVWJnbXh0b0wxelh4YVBp |  |
+
+
+
+### 2.2 push内容
+
+
+### push内容
+
+| 类型 | 文件 | 推送对象<br><br>Audience | 标题 / 内容 | 推送时间 | Trigger<br><br>(触发条件) | 点击跳转页面 |  | 优先级 | UI原型 | 位置 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| 生日/节日<br><br>Celebration | https://romangic.sg.larksuite.com/space/api/box/stream/download/asynccode/?code=NTljNzUwOGRlMTUzNGJiMjM3YmM0NjAxYTc4ZGY2NGFfOEJvWjZmWHpQT0hGVGpWa0IyNzg0Z0pGMWEwUVhzbWhfVG9rZW46QWllQmJka3B3b1NMYmt4anpx | 节日for全体用户 | 随机抽取 WooMoo 节日Push中对应的内容<br><br>即将到来的：3月 St. Patrick's Day | 用户时区每天8:30am | Auto<br><br>3月 St. Patrick's Day | 首页 |  | 极高 | 情人节<br><br> | ios系统push |
+| Daily push | https://romangic.sg.larksuite.com/space/api/box/stream/download/asynccode/?code=NGU3ZmE4NWUxMDZjNTVjYTBjMjY5Y2I3NmM4YWE0MWVfVFJ6NnVPbkdVSDZNQ0htbDh1Y3ZrRFAxcmthaHQxU3JfVG9rZW46UXlySGJ0ZGFRb2ZRQTl4T3FM | 全体用户 | 随机抽取WooMoo DailyPush中任意一条标题+内容 | 用户时区每天8:30am | Auto | 首页 |  | 高 (核心留存) |  | ios系统push |
+| 折扣/福利/活动<br><br>“Offer” | https://romangic.sg.larksuite.com/space/api/box/stream/download/asynccode/?code=MWZmZGJhYjBiNDAyNDRiZjhhOWRmOGYzNGE0ZmM2YzNfRXMxUHo2S29aTE9OM25lb0ZDZ3ZHT2cwZUVhSHV1YmJfVG9rZW46UW45NmJQZlBPb3BlZlZ4a3hx | <br><br>全体用户 | 按照福利活动计划再编辑 | **站外push：**用户时区中午12:30pm<br><br>站内：当天打开App就显示<br><br>社区、邮箱：群发 | 有产品福利活动推送的时候 | 与用户身份相对应的订阅墙、<br><br>跳转Discord |  | 中高 |  | ios系统push、社区、邮箱、站内信 |
+| 社区话题<br><br>“Community” | https://romangic.sg.larksuite.com/space/api/box/stream/download/asynccode/?code=MGEyOWY0ZTEyMjQ4ZjAwNGM0NWEzYjNkOWY2Njg5MzdfRjFLRTJYdTVCMmZsbkRyU0dhSm9iWkVKWlJObjliMWtfVG9rZW46U2hlamJ0MTd3b1NrMEp4YmRy | 全体用户 | 标题：（以情人节话题为例） Valentine’s is coming—got tea?<br><br>Body：Join our Discord to spill the tea & score exclusive freebie alerts. Don't miss the steal!<br><br>  <br><br>WooMoo 社区引流 | 站外push：用户时区每周五晚上 8:00pm<br><br>**站内：**当天打开App就显示 时效：24h<br><br>社区：运营群发 | 循环触发： 每周五晚上 8:00pm<br><br>站内触发场景：用户打开App，到达首页 | 跳转到外部Diacord里WooMoo对话加入 |  | 中 |  | iOS系统push、站内push、Discord社区 |
+| 要apple store 好评、评论<br><br>“Review” | https://romangic.sg.larksuite.com/space/api/box/stream/download/asynccode/?code=YWE4NTQyOWUzOTlkZjY2YTZkZjRkZWU5N2QwNTFmN2JfSXB4cnhrN05pcDNnQlZrZUR6eG1jbFhvZHFlRUJ1REtfVG9rZW46SlhsMGJ2bERZb2c1TGl4cmJy | 全体用户 | - 标题：<br>    <br><br>Headline: Love our readings? 🔮<br><br>Body: Score more free readings! Just rate us and snap a screenshot of your review.<br><br>按钮：关闭icon / Go！<br><br>  <br><br>  <br><br>- 标题： H |  | 用户解读完一次触发，不管是Quick card 还是Deep drive 都是完成一次“reading completed”就触发 第一次弹窗“banner push comment”<br><br>（现在设置一个评论就赠送2次免费解读的活动）<br><br>- 用户点击“banner push comment”直接跳转iOS评价页面<br>    <br>- 用户回到WooMoo APP，识别判 | 跳转到外部iOS评价 |  | 中高 | <br><br>  <br><br> | 站内push、Discord社区 |
+|  |  |  |  |  |  | 订阅墙 |  |  |  |  |
+
+
+
+# 三、数据需求
+
+
+**埋点需求**
+
+
+|                                 |                             |          |      |      |     |      |      |     |     |     |     |     |      |
+| ------------------------------- | --------------------------- | -------- | ---- | ---- | --- | ---- | ---- | --- | --- | --- | --- | --- | ---- |
+| 模块                              | 事件名称（英文）                    | 事件说明（中文） | 事件类型 | 触发时机 | 参数名 | 参数说明 | 参数类型 | 枚举  | 埋点端 | 优先级 | 备注  | 状态  | 问题记录 |
+| 系统通知权限弹窗                        | notification_popup_show     | 系统弹窗展示   | 弹窗曝光 |      |     |      |      |     | 客户端 | P0  |     | 待验收 |      |
+| notification_popup_allow_click  | 系统弹窗点击allow                 | 点击事件     |      |      |     |      |      | 客户端 | P0  |     | 待验收 |     |      |
+| notification_popup_refuse_click | 系统弹窗点击don't allow           | 点击事件     |      |      |     |      |      | 客户端 | P0  |     | 待验收 |     |      |
+| app通知权限弹窗                       | app_notification_popup_show | app弹窗展示  | 弹窗曝光 |      |     |      |      |     | 客户端 | P0  |     |     |      |
+| app_notification_allow_click    | app弹窗点击allow                | 点击事件     |      |      |     |      |      | 客户端 | P0  |     |     |     |      |
+| app_notification_refuse_click   | app弹窗点击don't allow          | 点击事件     |      |      |     |      |      | 客户端 | P0  |     |     |     |      |
+

package/test/push.md

@@ -0,0 +1,119 @@
+# 【V1.8】Push 
+
+| 日期 | 版本 | 修改人 |
+| --- | --- | --- |
+| 2025/11/28 | V1.0: 创建文档 | @ou_aee8dadd00d620825dc7d479734dc300 |
+
+# 一、需求背景
+
+Push 在用户离开 App 后，产品与用户保持持续连接的最重要触点。通过系统化的 Push 能力，在合适的时间，可把有价值的内容主动送达到用户手中，从而：
+
+- 提升留存：通过每日塔罗牌 / 箴言提醒、回流提醒等，帮助用户养成使用习惯；
+- 建立情感连接：在节日、生日、特殊节点推送祝福或关怀内容，让产品不仅是工具，而是放大产品情感化；
+- 支持运营活动：在新功能上线、限时活动、专属优惠权益等场景，通过 Push 进行触达和转化，放大运营效果；
+- 获取用户声音：通过调研问卷、满意度回访等 Push，引导用户反馈体验，为后续产品优化提供数据支撑。
+因此，本版本围绕 Push 能力进行初版建设，为后续的精细化触达、运营玩法和留存提升打下基础。
+
+
+### **需求触发：**
+
+1. **信息缺口（站外）**：新功能上线、版本更新
+1. **用户潜在需求唤醒（留存）：活跃用户**：限时折扣（站内外）、专属权益（站内外）；~~**沉睡用户**~~~~：召回优惠券、回归礼包/折扣（站外）~~
+1. **特殊节点推送（站内外）：**节日/生日祝福（适当配合折扣福利）
+1. **社区活动推送（站内）：**站内push引流到站外社区（话题讨论、用户反馈等）（配合社区运营）
+
+### **展现形式：**
+
+**站外：****ios**系统Push、邮箱、社区消息
+
+**站内：**站内信（banner）、弹窗
+
+
+### **推送时间：**
+
+1. **“Daily push”：****固定每天早上的时间（8h30-9h）：**每日运势
+1. **生日/节日 ****“Celebration”：****特殊日的早上（8h30-9h）：**生日祝福、节日祝福结合每日运势文案，如：“xxx祝你生日快乐，今日宇宙与你的链接最强，来看看今天的牌有什么指引”
+1. **要apple store 好评、评论**** “Review”：****晚上20h（8:00pm）**
+1. **折扣/福利 ****“Offer”：****根据用户习惯使用时间（初始默认中午12h30）：**折扣福利、社区引流、专属权益
+1. **社区话题**** “Community”：****晚上20h（8:00pm）：**加入社区、话题讨论
+1. 用户个性化设置推送时间（站内的推送）
+
+需要监测点：
+
+push到达率、push打开率、push转化率、卸载率
+
+
+# 二、需求详情
+
+### 2.1 权限获取
+
+**新增字段：notification_permission_status**
+
+#### 规则：
+
+1. **APNs 权限获取弹窗：**
+**       授权**
+
+**       拒绝：**拒绝后官方默认不会再出现，用户使用**一个月后站内弹窗**出现：提醒用户去iphone**后台打开权限**，再次拒绝后本**年度**不会再提醒
+
+
+1. **站内权限获取弹窗：**
+      默认开着权限，
+
+~~但在设置页面也加一个“关闭弹窗”的选项通道，如果用户自己关闭了，就每过30天时间弹一次权限弹窗提醒~~
+
+~~**       授权**~~
+
+~~     ~~~~** 拒绝：**~~~~用户使用~~~~**30天后站内弹窗再次**~~~~出现，提醒打开站内消息提醒~~
+
+
+在 **23:00 - 08:00** 之间禁止发送任何push
+
+
+
+**取值**
+
+- not_determined （从未请求过权限）
+- denied（用户明确拒绝/关闭）
+- authorized（已授权）
+| 场景 | 说明 |
+| --- | --- |
+|  | **弹窗时机****—站外系统通知权限 ** **苹果官方的 APNs (Apple Push Notification service)**  |
+|  | **弹窗时机—站内系统通知跳转ios系统权限** |
+
+### 2.2 push内容
+
+| 位置 | 类型 | 优先级  | 推送对象 Audience | Trigger  (触发条件) | 推送时间  | UI原型 | 标题 / 内容 |  | 点击跳转页面 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| ios系统push  | ~~**生日**~~**/节日** **Celebration** | 极高  | 节日for全体用户 ~~生日for个别用户(等加入）~~  | Auto 3月 St. Patrick's Day  | 用户时区每天8:30am  | 情人节 | 随机抽取 [WooMoo 节日Push](https://romangic.sg.larksuite.com/wiki/M8jnwaDUxiFZ46kxe9SlRCMlgQd)中对应的内容 即将到来的：3月 St. Patrick's Day  |  | 首页  |
+| ios系统push  | **Daily push** | 高 (核心留存) | 全体用户  | Auto  | 用户时区每天8:30am  |  | 随机抽取[WooMoo DailyPush](https://romangic.sg.larksuite.com/wiki/JPNAwDX3tiWR30kKPqklcElJghd?sheet=a33f4c)中任意一条标题+内容  |  | 首页  |
+| 站内push、Discord社区  | **要apple store 好评、评论** **“Review”**  | 中高  | 全体用户  | 用户解读完一次触发，不管是Quick card 还是Deep drive 都是完成一次“**reading completed”**就触发 **第一次弹窗“banner push comment”** （现在设置一个评论就赠送2次免费解读的活动）              |   |  | **Headline:** **Love our readings? 🔮** **Body:** **Score more free readings! Just rate us and snap a screenshot of your review.** **按钮：关闭icon / Go！**   **按钮：** **Go on Discord**  |  | 跳转到外部iOS评价  |
+| ios系统push、社区、邮箱、站内信 | **折扣/福利/活动** **“Offer”** | 中高  | ~~活跃用户（激励）~~ 全体用户  | 有产品福利活动推送的时候  | **站外push：**用户时区中午12:30pm **站内**：当天打开App就显示 社区、邮箱：群发  |  | 按照福利活动计划再编辑  |  | 与用户身份相对应的订阅墙、 跳转Discord  |
+| ~~iOS系统push、邮箱~~ | ~~**折扣/福利**~~  | ~~中高~~  | ~~沉睡用户（召回）~~  |  |  |  |  |  | 订阅墙 |
+|  iOS系统push、站内push、Discord社区  | **社区话题** **“Community”**  | 中 | 全体用户  | **循环触发：** 每周五晚上 **8:00pm** **站内触发场景**：用户打开App，到达首页  | **站外push**：用户时区每周五晚上 8:00pm **站内：**当天打开App就显示 时效：24h 社区：运营群发 |  | 标题：（以情人节话题为例） Valentine’s is coming—got tea? Body：Join our Discord to spill the tea & score exclusive freebie alerts. Don't miss the steal!  [WooMoo 社区引流](https://romangic.sg.larksuite.com/wiki/Fjsnw2zLXiHDVzkDl9yliZpVgre?from=from_copylink)  |  | 跳转到外部Diacord里WooMoo对话加入 |
+
+# 三、数据需求
+
+**埋点需求**
+
+[嵌入表格: N8cAsiN6yhVh8dtP5MOl0MSggIf_hyggyt]
+
+# 调研附录
+
+### 竞品调研
+
+(目前调研的竞品中moonly和costar的push比较积极：moonly上午9:00和11:00各一次；costar11:30一次）
+
+| 产品 | 图例 | 流程简述 |
+| --- | --- | --- |
+| starla  |  | 设计：以主页为底，直接跳系统页； timing：先要评分，然后对其他APP的活动追踪，接着要push权限； 手动关闭系统设置后，APP内没有内置按钮可以打开。  |
+| Co-Star |  | 设计：有消息示例（每日更新、好友申请通知）  timing：注册完直接跳转打开通知  二次请求：设置了not right now按钮（较小），点击后跳转到消息定制页（每日建议、好友申请通知、申请通过通知）且三个开关默认打开  内置按钮：APP内置推送按钮，点击后跳转到系统页，同意后进入消息定制页，这里新增（联系人加入通知、Eros）  |
+| Moonly |  | 设计：背景为使用前后变化对比 timing：注册后直接跳出系统页  |
+| CHANI  |  | 设计：登录页 timing：首次打开应用后 手动关闭系统设置后，APP内没有内置按钮可以打开； |
+| Futurio |  | 设计：通知图标为底 timing：注册后直接选通知时间段，选完后弹出系统页，拒绝后收集邮箱 内置按钮：setting处有邮箱和通知权限按钮  |
+| MoonX （Moon calendar) |  | 设计：消息示例 timing:打开APP未注册，先要地理位置权限，然后要push权限，点继续后跳转到系统页 内置按钮：setting中有细分通知按钮，可选多个消息类别、提示时间  |
+| Astrotalk |  | 设计：登录页 timing：首次打开就要push权限 没有内置push开关 |
+| Faladin |  | 设计： timing：注册后要通知权限，点击非高亮处退出 内置按钮：setting处有通知按钮，打开后可选择性关闭不同功能按钮 |
+| nebula  |  |  |
+| headspace |  |  |
+

package/tests/config.test.ts

@@ -0,0 +1,186 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'yaml';
+
+// 直接测试配置解析逻辑，不依赖 process.cwd()
+interface DocConfig {
+  name: string;
+  type: 'feishu' | 'notion';
+  url: string;
+  output: string;
+}
+
+interface GroworkConfig {
+  feishu?: { appId: string; appSecret: string; domain?: 'feishu' | 'lark' };
+  notion?: { token: string };
+  docs: DocConfig[];
+}
+
+function validateConfig(config: GroworkConfig): void {
+  if (!config.docs || config.docs.length === 0) {
+    throw new Error('配置文件中没有配置任何文档');
+  }
+
+  const hasFeishuDocs = config.docs.some(d => d.type === 'feishu');
+  const hasNotionDocs = config.docs.some(d => d.type === 'notion');
+
+  if (hasFeishuDocs && (!config.feishu?.appId || !config.feishu?.appSecret)) {
+    throw new Error('配置文件缺少飞书凭证 (feishu.appId, feishu.appSecret)');
+  }
+
+  if (hasNotionDocs && !config.notion?.token) {
+    throw new Error('配置文件缺少 Notion 凭证 (notion.token)');
+  }
+}
+
+describe('配置文件解析', () => {
+  it('应正确解析有效的 YAML 配置', () => {
+    const yamlContent = `
+feishu:
+  appId: "cli_test"
+  appSecret: "secret_test"
+docs:
+  - name: prd
+    type: feishu
+    url: "https://xxx.feishu.cn/docx/abc123"
+    output: "docs/prd.md"
+`;
+    const config = yaml.parse(yamlContent) as GroworkConfig;
+
+    assert.strictEqual(config.feishu?.appId, 'cli_test');
+    assert.strictEqual(config.docs.length, 1);
+    assert.strictEqual(config.docs[0].name, 'prd');
+    assert.strictEqual(config.docs[0].type, 'feishu');
+  });
+
+  it('应解析包含 Notion 配置的 YAML', () => {
+    const yamlContent = `
+notion:
+  token: "ntn_test_token"
+docs:
+  - name: notion-doc
+    type: notion
+    url: "https://www.notion.so/abc123"
+    output: "docs/notion.md"
+`;
+    const config = yaml.parse(yamlContent) as GroworkConfig;
+
+    assert.strictEqual(config.notion?.token, 'ntn_test_token');
+    assert.strictEqual(config.docs[0].type, 'notion');
+  });
+
+  it('应解析混合配置（飞书 + Notion）', () => {
+    const yamlContent = `
+feishu:
+  appId: "cli_test"
+  appSecret: "secret_test"
+notion:
+  token: "ntn_test"
+docs:
+  - name: feishu-doc
+    type: feishu
+    url: "https://xxx.feishu.cn/docx/abc"
+    output: "docs/feishu.md"
+  - name: notion-doc
+    type: notion
+    url: "https://www.notion.so/def"
+    output: "docs/notion.md"
+`;
+    const config = yaml.parse(yamlContent) as GroworkConfig;
+
+    assert.strictEqual(config.docs.length, 2);
+    assert.strictEqual(config.docs[0].type, 'feishu');
+    assert.strictEqual(config.docs[1].type, 'notion');
+  });
+});
+
+describe('配置文件验证', () => {
+  it('应拒绝空文档配置', () => {
+    const config: GroworkConfig = {
+      feishu: { appId: 'test', appSecret: 'test' },
+      docs: []
+    };
+
+    assert.throws(
+      () => validateConfig(config),
+      /配置文件中没有配置任何文档/
+    );
+  });
+
+  it('应拒绝缺少飞书凭证的配置', () => {
+    const config: GroworkConfig = {
+      docs: [{
+        name: 'test',
+        type: 'feishu',
+        url: 'https://xxx.feishu.cn/docx/abc',
+        output: 'docs/test.md'
+      }]
+    };
+
+    assert.throws(
+      () => validateConfig(config),
+      /配置文件缺少飞书凭证/
+    );
+  });
+
+  it('应拒绝缺少 Notion 凭证的配置', () => {
+    const config: GroworkConfig = {
+      docs: [{
+        name: 'test',
+        type: 'notion',
+        url: 'https://www.notion.so/abc',
+        output: 'docs/test.md'
+      }]
+    };
+
+    assert.throws(
+      () => validateConfig(config),
+      /配置文件缺少 Notion 凭证/
+    );
+  });
+
+  it('应接受只有飞书文档的配置（无需 Notion 凭证）', () => {
+    const config: GroworkConfig = {
+      feishu: { appId: 'test', appSecret: 'test' },
+      docs: [{
+        name: 'test',
+        type: 'feishu',
+        url: 'https://xxx.feishu.cn/docx/abc',
+        output: 'docs/test.md'
+      }]
+    };
+
+    assert.doesNotThrow(() => validateConfig(config));
+  });
+
+  it('应接受只有 Notion 文档的配置（无需飞书凭证）', () => {
+    const config: GroworkConfig = {
+      notion: { token: 'ntn_test' },
+      docs: [{
+        name: 'test',
+        type: 'notion',
+        url: 'https://www.notion.so/abc',
+        output: 'docs/test.md'
+      }]
+    };
+
+    assert.doesNotThrow(() => validateConfig(config));
+  });
+
+  it('混合文档配置需要所有相关凭证', () => {
+    const configMissingNotion: GroworkConfig = {
+      feishu: { appId: 'test', appSecret: 'test' },
+      docs: [
+        { name: 'feishu', type: 'feishu', url: 'https://xxx.feishu.cn/docx/a', output: 'a.md' },
+        { name: 'notion', type: 'notion', url: 'https://www.notion.so/b', output: 'b.md' }
+      ]
+    };
+
+    assert.throws(
+      () => validateConfig(configMissingNotion),
+      /配置文件缺少 Notion 凭证/
+    );
+  });
+});