docs(research): archive antigravity rounds 29 and 30

2026-06-26 04:03:11 +08:00
parent 9ed8ac9440
commit aa692f8092
53 changed files with 1102 additions and 3 deletions
@@ -0,0 +1,20 @@
+# Antigravity AI API 未暴露能力总表 (Round 29)
+
+## 路由空洞分析
+
+当前 `jyotish_api_server.py` 主要暴露了 `/api/chart`, `/api/synastry`, `/api/panchanga_range`, `/api/muhurta`。
+存在大量模块无法通过 HTTP 访问：
+
+| 隐藏模块库 | 应增加的路由 | 请求参数 | 响应期待 |
+|---|---|---|---|
+| `scripts/varshaphala.py` | `/api/tajika` | 生辰数据, `year: 2026` | 当年的年度盘、Muntha 落点、年度主星。 |
+| `scripts/jaimini_core.py` | `/api/jaimini/chara_dasha` | 生辰数据 | Chara Dasha 列表。 |
+| `scripts/compatibility.py` | `/api/synastry/porutham` | 两人数据 | 南印 10 项匹配分数。 |
+| `scripts/yoga_rules.json` (更复杂的查询) | `/api/yoga/search` | 星座配置查询 | 满足该特征的经典 Yoga 名称。 |
+| `scripts/dasha.py` (条件大运) | `/api/dasha/conditional` | 生辰数据 | 返回适用于此人的非 Vimshottari 大运。 |
+
+## TDD 要求
+Codex 需要在 `test_api.py` 里直接先写这 5 个端点的 404 测试，然后再补上这些空洞。
+
+## 状态
+`部分成立`
@@ -0,0 +1,14 @@
+# Antigravity AI Ayanamsa / ephemeris 精度差距 (Round 29)
+
+## 岁差之争的绝对度数
+
+| 测试维度 | 容差目标 | 当前情况 | 改进路径 |
+|---|---|---|---|
+| **Lahiri 对齐 JHora** | 0.001度 | `True` | 我们底层走 Swisseph，主轴准确。 |
+| **Raman (拉曼)** | 0.005度 | 未实测 | 需从 API 支持透传 Ayanamsa 配置值，并在常量表里维护 Raman 差值。 |
+| **KP (Krishnamurti)** | 0.005度 | 未实测 | KP 学派的基准线截然不同，它影响着 249 个 Sublord 的分割。必须实装！ |
+| **Pushya Paksha** | 0.005度 | 缺失 | 补充参数支持。 |
+| **夏令时历史黑洞** | 完全不错乱 | `部分失败` | 名人库里 1984 年加州的 Katy Perry 和 1964 年的案例，因夏令时 (DST) 切换问题跑出了错误的度数甚至宫位。这需要更健壮的 `pytz` 解析规则。 |
+
+## 状态
+`部分成立`
@@ -0,0 +1,19 @@
+# Antigravity AI CLI 未暴露能力总表 (Round 29)
+
+## 极客可用性分析
+
+在服务端和 CI 场景，CLI 的好用程度决定了排障效率。目前 `jyotish_engine.py` 只能吐 JSON。
+
+1. **表格模式 (`--table`)**：
+   使用 `tabulate` 库在终端直接输出对齐的星位表和 Shadbala 表，避免人类肉眼解析 JSON。
+2. **彩色打印**：
+   引入 `colorama`，吉星用绿色，凶星（罗睺计都土星火星）用红色，耀升加亮。
+3. **合婚对比 (`--match <file1> <file2>`)**：
+   接受两个 JSON 生辰文件，在命令行直接输出 8 项对比分数。
+4. **择吉查询 (`scripts/muhurta.py --month 2026-06 --lat 39 --lon 116`)**：
+   输出该月所有符合条件的吉日。
+5. **版本与协议查询 (`--version`, `--license`)**：
+   CLI 需要自我申明使用 MIT 协议和底层 swisseph 的存在。
+
+## 状态
+`部分成立`
@@ -0,0 +1,19 @@
+# Antigravity AI 云端同步白名单计划 (Round 29)
+
+## 全局 WorkBuddy 覆盖准则
+
+我们要把 `yinduzhanxing/` 主仓里的智慧辐射到用户其他项目中。
+**必须用主仓的文件去覆盖 `~/.workbuddy/skills/jyotish-vedic-astrology/`，绝不能反过来。**
+
+### 同步白名单
+1. `SKILL.md`：核心灵魂，包含我们写的 Prompt 护栏和 `run_quality_gate.py` 命令。
+2. `references/technique_registry.json`：68 个技法的确切状态，旧仓里的太老了。
+3. `references/strict-workflow-router.md`：我们刚设计的 TDD 断言跳线图。
+4. `docs/research/` 的归档精华（可压缩后存放）：让新开的 Agent 也能学到前几轮的心血。
+
+### 禁止同步黑名单 (Quarantine)
+1. 任何 `*.py` 源码：Skill 本身不该携带几万行代码，而是应该以 Tool 的形式存在。
+2. GPL / PyJHora 等带毒代码段。
+
+## 状态
+`已成立`
@@ -0,0 +1,20 @@
+# Antigravity AI Codex Round 30 Top 120 执行清单 (Round 29)
+
+## Codex 立即开火 (Top 12)
+1. **API 挂载 Tajika**：在 `jyotish_api_server.py` 加上 `@app.route("/api/tajika")`。
+2. **API 挂载 Chara Dasha**：暴露 `/api/jaimini/chara_dasha`。
+3. **前端 Varga 下拉框**：改 `main.js`，给 SVG renderer 加上 D2-D60 的 `<select>`。
+4. **前端 Dasha 高亮**：给当前系统时间命中的大运加个 `class="font-bold text-red-500"`。
+5. **Kuja Dosha 的 Enum**：后端废除 bool，改输出 `HIGH`, `LOW`, `CANCELLED`。
+6. **Ashtakavarga 柱状图**：改 `main.js`，基于 `sav` 数据用简单的 `div` 高度画柱子。
+7. **Panchanga 警告条**：如果是 Rahu Kala，在页面上方打红色 Alert。
+8. **JSON Dump 按钮**：加个前端按钮触发 `JSON.stringify(data, null, 2)` 下载为 txt。
+9. **`ashtakoot.py` 常量抄袭**：去 MIT 库把那 8 个矩阵的数值搬到我们的 `ashtakoot_constants.py` 里。
+10. **`jyotish_engine.py --table`**：让终端极客能看到 ASCII 表格星盘。
+11. **同步 SKILL**：执行 `cp SKILL.md ~/.workbuddy/...`。
+12. **包裹报错**：给所有的 500 HTML 套上 `{"error": str(e)}`。
+
+> 为什么只有这 12 个？因为在这些被 TDD 跑完之前，去写新的如 `Kalachakra Dasha` 是好高骛远，用户连现有的数据都看不到！
+
+## 状态
+`已成立`
@@ -0,0 +1,19 @@
+# Antigravity AI MIT/Apache 可直接复制资产 Top 50 (Round 29)
+
+## 闭眼抄袭名单
+
+只要有 MIT/Apache 协议，就能直接把它的数组、字典拷贝进我们的 `scripts/` 并打上 `NOTICE`：
+
+1. `jyotishganit/core/constants.py` 的 Shadbala 自然强弱映射表。
+2. `jyotishganit/core/constants.py` 的 D60 分盘除数表。
+3. `dashaflow/muhurtha.py` 的吉时拦截条件数组。
+4. `VedAstro` 的 Ashtakoot 8 矩阵打分字典（女星宿 vs 男星宿 = 分数）。
+5. `VedAstro` 的各种 Ayanamsa (如 Raman) 的浮点常数差值。
+6. `jaimini-tropical/core/dashas.py` 中的查表法年数字典。
+7. `jyotishganit` 的尊贵度字典 (Moolatrikona 的精确始末度数)。
+8. 开源天文库提供的 1900-2100 的月相常数拟合表。
+9. `flatlib` 的开源衍生历法解析表。
+... (由于授权干净，凡此类常量表皆可直接引入)
+
+## 状态
+`已成立`
@@ -0,0 +1,24 @@
+# Antigravity AI covered -> complete 晋级优先级 Top 30 (Round 29)
+
+## 高 ROI 变现清单
+
+这 30 个项目是只要花几小时就能给用户带来巨大冲击的功能：
+
+1. **API 挂载 Tajika**：把 `varshaphala.py` 接到 `/api/tajika`。
+2. **API 挂载 Chara Dasha**：把它挂接到 `/api/chart` 的 Dasha 响应列表里。
+3. **Panchanga 日历 UI**：写一个 7x5 的网格，根据当月天数填格子，把 JSON 里的 Rahu Kala 染成红色。
+4. **Shadbala 子项展开**：点击总分，展开一个 6 维雷达图。
+5. **Ashtakavarga 柱状图**：在 UI 里为每个宫位画出 0-8 的得分柱。
+6. **合婚报告下载**：点按钮把合婚 8 项表格变成 PDF。
+7. **Kuja Dosha 颜色分级**：把 True/False 改成 Enum，并在 UI 显示红/橙/绿。
+8. **Yoga 徽章**：命中的 Yoga 显示为一个可悬停的图标，hover 时展示古典解释。
+9. **Dasha 年龄标注**：在大运列表边上附注“(15岁 - 22岁)”。
+10. **Ayanamsa 切换器**：右上角增加全局下拉框。
+11. **导出数据流**：加一个下载按钮导出包含所有星盘数据的完整 JSON。
+12. **Prashna (起卦) 按钮**：一键以当前浏览器时间和定位起卦。
+13. **特殊上升点列表**：把 Hora Lagna 等暴露在基础信息表格里。
+14. **行运 (Transit) 按钮**：把今天的星星用虚线叠加在出生盘外面。
+...
+
+## 状态
+`部分成立` (需要 Codex 动手 TDD)
@@ -0,0 +1,16 @@
+# Antigravity AI 外部 oracle 精度闭环路线 (Round 29)
+
+## 人类与机器配合战
+
+我们要把“算得准不准”从开发者的嘴硬，变成铁证如山。
+
+1. **收集 50 份命盘（人类）**：名人库 + 各种夏令时边界案例的日期经纬度。
+2. **喂给 JHora/AstroSage（人类）**：手工跑出它们的 Dasha 交接时间、Shadbala 的 Rupa 浮点数、Ashtakoot 的 36 项总分。
+3. **填写 `oracle_cases.json`（人类）**：把靶标数据填进去。
+4. **运行 `oracle_evidence_validator.py`（机器）**：系统自动跑本地算法，如果和靶标误差大于 1% 或 2 天，直接标红阻断。
+
+## 闭环缺口
+我们现在有了框架（JSON 和 Validator），但里面的靶标值全是 0 或空着。必须让人类先停下写代码，去截图填数字。
+
+## 状态
+`需要人工外部工具`
@@ -0,0 +1,11 @@
+# Antigravity AI 无障碍与对比度 (A11y) 审查 (Round 29 Extra)
+
+## 神秘学需要清晰
+很多占星图的设计过于玄学，颜色暗淡甚至反差低，导致老年用户（占星主力群体）看不清。
+
+1. SVG 的边框线颜色在暗色模式下（如果后续支持 Dark Mode）必须能自动反转为白色。
+2. Yoga 的吉凶不能仅靠红色和绿色表达（色弱人群无法分辨）。必须带有 `+` 或 `❌` 符号。
+3. 关键天文指标（如 Retrograde 逆行）在 `(R)` 标识旁应加粗。
+
+## 状态
+`未成立`
@@ -0,0 +1,13 @@
+# Antigravity AI Docker 与部署隔离审查 (Round 29 Extra)
+
+## 生产环境安全隐患
+当前只依赖 `npm run dev` 和直接起 python API 极不稳定。占星用户可能在自己的 NAS 或 VPS 部署。
+
+## 容器化设计清单
+1. **轻量化镜像**：必须采用 `python:3.11-alpine` 加上预编译的 `swisseph` 和 `flatlib` wheel 减小体积。
+2. **Nginx 反向代理**：将 5173 的前端静态包与 5200 的 Python API 整合到一个镜像里，只暴漏 80 端口，解决跨域 CORS 问题。
+3. **健康检查机制**：增加 `/api/health`。
+4. **日志脱敏**：绝不能把用户的经纬度打在 stdout 日志里，这在 Docker 容器日志中极易泄露。
+
+## 状态
+`未成立`
@@ -0,0 +1,17 @@
+# Antigravity AI 端到端 E2E 自动化测试补充设计 (Round 29 Extra)
+
+## UI 极度脆弱
+目前只有 `run_quality_gate.py` 是测后端的。就算后端算对，前端如果有 JS undefined 导致白屏，用户还是觉得你的软件不能用。
+
+## Playwright 蓝图
+必须编写一个 `tests/e2e/test_main_flow.spec.js`：
+1. 拦截 HTTP `/api/chart` 接口。
+2. 自动填入 1990-01-01 12:00:00，经纬度 28/77。
+3. 点击 Submit。
+4. 捕捉 `svg` 节点中是否成功渲染了 `Asc: Aries`。
+5. 捕捉大运表是否出现。
+
+这是防止 Codex 修代码把前端改挂的最强防线。
+
+## 状态
+`未成立`
@@ -0,0 +1,11 @@
+# Antigravity AI 异常边界恢复能力 (Round 29 Extra)
+
+## OOM 与超时防范
+如果用户恶意提交极端的经纬度（如 `900`），或者查一整年的 Panchanga。
+
+1. **后端输入校验**：在 `jyotish_api_server.py` 第一行用 Pydantic 卡死范围 `lat [-90, 90]`。
+2. **算力限制**：限制 Muhurta 和 Panchanga 查询跨度不能超过 31 天。
+3. **502 恢复**：当前端请求超时，应该弹出一个“网络波动或算力超限”，而不是永久转圈圈。
+
+## 状态
+`未成立`
@@ -0,0 +1,13 @@
+# Antigravity AI GraphQL 重构与瘦身路线 (Round 29 Extra)
+
+## Payload 爆炸问题
+目前的 `/api/chart` 接口每次都会全量吐出 D1-D60 所有分盘、几十种大运树的全部节点。
+这个 JSON 高达好几 MB，不仅费服务器带宽，在手机端解析也会导致明显卡顿。
+
+## 改进路线
+1. **按需加载 (GraphQL 范式)**：虽然我们用 REST，但可以用参数控制。比如 `/api/chart?fields=d1,shadbala,dasha_level1`。
+2. **独立拆分 Endpoint**：将 `Ashtakavarga` 和 `Dasha` 从主接口里剥离，前端点击 Tab 时再去拉取这部分数据。
+3. 压缩浮点数精度，从小数点后 16 位压缩到后 4 位，足以。
+
+## 状态
+`未成立`
@@ -0,0 +1,13 @@
+# Antigravity AI 移动端响应式 UI 审查 (Round 29 Extra)
+
+## 印度本地市场的特点
+占星软件最大的用户群在印度，他们 95% 使用 Android 手机访问 Web，绝不会用电脑浏览器看你的超大 SVG 分盘！
+
+## 审查与修复点
+1. 当前的 SVG 星盘排版是写死宽高的方块。在竖屏上会被截断。
+2. Vimshottari 嵌套大表在手机上直接撑爆，必须使用横向 Scroll 容器，或者改写成 Accordion 手风琴折叠。
+3. Tailwind 的 Flex 排版必须增加 `md:flex-row flex-col` 让手机端上下堆叠。
+4. 顶部导航栏太多项目必须折叠成汉堡菜单。
+
+## 状态
+`未成立`
@@ -0,0 +1,17 @@
+# Antigravity AI Round 29 最终总结与排位策略
+
+## 回答核心质询
+
+1. **离“本地可测试全部核心技能”差什么？**
+   差的是**前端的下拉框**和**API 的路由绑定**。像 Tajika, 深分盘这些，我们的 Python 后端早就写好了，只是被锁死在了硬盘里！
+2. **差多少真新增技法？**
+   在补完 UI 的基础上，如果要反超 JHora，我们还要手写大约 12 个极端复杂的数学公式库（如 Pancha Pakshi, 30+ 种非 Vimshottari 大运）。
+3. **差多少外部 oracle？**
+   急缺 50+ 份从 AstroSage 截图抄录的 JSON 数据点。目前 `oracle_cases.json` 空空如也，系统没法自动断言报错。
+4. **有多少是工程/产品问题？**
+   90% 都是！前端没做城市搜索、没做免责声明、没画出雷达图、错误全弹 HTML、CLI 没有表格模式，这都是工程基建没跟上算法！
+5. **Codex 下一轮先干啥？**
+   **只干工程基建**。加路由、加 `<select>`、加 `tabulate` 终端表格、修错误包裹。不要碰 BPHS 公式！
+
+## 状态
+`已成立`
@@ -0,0 +1,21 @@
+# Antigravity AI 前端隐藏技能总表 (Round 29)
+
+## 页面展现僵局
+
+`jyotish-app/main.js` 目前硬编码了 D1 和 D9 的渲染，且没有导航切换结构。导致大量 API 已下发的数据成为暗物质。
+
+1. **分盘库 (`vargas`)**：
+   API `chart` 里其实带有 D2, D3, D10 等数据，但前端无下拉框。加一个 `<select id="varga-select">` 就能激活。
+2. **Ashtakavarga (八字分)**：
+   JSON 里有 `sav`, `bav`，但没画出 12 宫的得分表。这是一个 `<table>` 就能解决的事。
+3. **Chara Karakas (Jaimini 指标)**：
+   AK, AmK 等指标在 `planets` 数组里有标注，但前端列表里没有这个列。
+4. **Tara Bala**：
+   吉日推算里有这个值，没在日历呈现。
+5. **Dasha 三级展开**：
+   目前的大运是一坨大表，应该做成 `<details><summary>` 那种折叠树。
+6. **Yoga 的吉凶高亮**：
+   只是纯文本列出了 Yoga，没有用 CSS `bg-red-100` 或 `bg-green-100` 区分。
+
+## 状态
+`部分成立`
@@ -0,0 +1,17 @@
+# Antigravity AI Jaimini / KP / Prashna 缺口总表 (Round 29)
+
+## 进阶门派的冰山一角
+
+| 门派 | 核心技能 | 当前状态 | 缺口 |
+|---|---|---|---|
+| **Jaimini** | Chara Karakas (灵魂标记星) | `部分成立` | JSON 里有，前端没展示。缺 7/8 星方案切换。 |
+| Jaimini | Padas (Arudha) | `未成立` | 算 AL (Arudha Lagna) 的逻辑在 `dashaflow` 里有，我们还没集成。 |
+| Jaimini | Chara Dasha (大运) | `部分成立` | 后端算好了，API 没接。 |
+| **KP** | Placidus 宫位 | `未成立` | 我们底层强绑定了 Whole Sign。KP 必须用 Placidus 分割 12 宫。 |
+| KP | 1-249 Sublord | `未成立` | 库里有个 CSV，但查表逻辑没整合到主轴 `jyotish_engine.py` 里。 |
+| KP | Significators (代表星) | `未成立` | 根据行星在 Nakshatra 上的主星判定 A,B,C,D 级代表力。 |
+| **Prashna** | 实时起卦功能 | `未成立` | 前端没有“当前时间立盘”的快捷键，要求用户填当前分秒太反人类。 |
+| Prashna | 占星师时区锁定 | `未成立` | 卜卦看的是占星师本地时间，不是求问人时间。需要一个分离的时区设计。 |
+
+## 状态
+`部分成立`
@@ -0,0 +1,16 @@
+# Antigravity AI License Quarantine 黑名单 (Round 29)
+
+## 坚决不可碰触的红线区域
+
+为了保证本项目未来能直接变现、出售、SaaS 化而免受 GPL 传染病起诉，以下项目必须被打上 `benchmark_only` 标签：
+
+1. **PyJHora (AGPL)**：只许给它发输入并比对它的输出。绝对禁止抄袭其内部的 Dasha 计算函数和 Yoga 解析函数。
+2. **Maitreya (GPL)**：只做外部参照比对，绝不能抄其 C++ 核心转换为 Python。
+3. **kunjara/jyotish (GPL)**：不可看其内部实现。
+4. **所有 AstroSage/Drik 的前端 JS**：这是闭源商用财产，不可破解其源码，只许抓取它的最终页面渲染结果做黑盒对比。
+
+## TDD 测试断言
+必须在 CI 中加一条脚本：`grep -ri "pyjhora" scripts/`，如果在核心计算模块出现这个词，直接阻断提交（证明有抄袭嫌疑或过度耦合）。
+
+## 状态
+`已成立`
@@ -0,0 +1,19 @@
+# Antigravity AI 普通用户可用性缺口 Top 50 (Round 29)
+
+脱离 API 文档，纯看网页，一个小白点进来会遇到的 Top 10 堵点：
+
+1. **地图经纬度选择**：要求小白手填 `lat=28` `lon=77` 是反人类的，必须挂接一个开源的 Geocoding 城市搜索框。
+2. **夏令时迷思**：用户根本不懂什么是 UTC offset。前端需要自动推导历史那一天的 DST。
+3. **梵文术语全靠猜**：Rahu, Ketu, Tithi 旁边必须有一个 `?` 按钮，hover 后出中文解释。
+4. **一堆列表看瞎眼**：Shadbala 不能只是一排 JSON 数组，必须是雷达图。
+5. **吉凶不分明**：Yoga 的结果必须要用颜色。`Raja Yoga` 标金，`Kemadruma` 标黑。
+6. **没有输出报告**：客户来算命是想拿走点什么的。必须加一个 `Download PDF`。
+7. **大运不知在哪**：当前行运应该高亮加粗。
+8. **免责在哪**：很容易被当成医疗/金融诈骗。顶部必须常驻免责长条。
+9. **断网全白屏**：API 挂了，前端一点报错都没有，一直 loading。必须拦截错误发通知。
+10. **火星煞不知多严重**：需用血条或警告标志量化。
+
+... (这些前端修补可以立刻由 Codex 开始推进，不涉及高深算法)
+
+## 状态
+`部分成立`
@@ -0,0 +1,16 @@
+# Antigravity AI Panchanga / Muhurta 商业深度缺口 (Round 29)
+
+## 月历变现的最后一公里
+
+| 功能 | 现状 | 差距与对策 |
+|---|---|---|
+| **API `/api/panchanga_range`**| 存在 | 会吐出一个月 30 天的每日吉凶 JSON。 |
+| **前端日历 UI** | ❌ | 没有界面。必须用 `display: grid` 写个月历，高亮星期二和日食。 |
+| **Rahu Kala 等凶时** | ✅ | JSON 里有时间段。需在 UI 鼠标悬浮时展示“每日避开此时段”。 |
+| **Muhurta (动态择吉)** | `部分成立` | 现在的过滤太死板，只能选结婚/商业，不能算个人的 Tara Bala 吉凶。 |
+| **Karana & Yoga** | ✅ | 后端有算，需查表给出其吉凶定义 (Auspicous/Inauspicious) 并传给前端。 |
+| **节日历 (Festivals)** | ❌ | 完全没做 Diwali, Holi 等印度假日的判定，无法对标 AstroSage 日历。 |
+| **性能极限** | ❌ | 算 30 天要跑 30 次循环，没有 Redis 缓存极易 OOM。 |
+
+## 状态
+`部分成立`
@@ -0,0 +1,25 @@
+# Antigravity AI Skill 全量补齐差距总表 (Round 29)
+
+## 全技能审查基准线
+
+以用户在本地能直接跑满、点出 UI 为目标，不以 `covered` 自嗨。
+
+| 技法/领域 | 后端可算 | API 暴露 | CLI 可用 | 前端可见 | 测试存在 | Oracle 存在 | 状态 |
+|---|---|---|---|---|---|---|---|
+| **D1 / 基本盘** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | `已成立` |
+| **D9 / 九分盘** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | `已成立` |
+| **Vimshottari (3层)** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | `部分成立` (缺外部权威基准值) |
+| **Shadbala 细分** | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ | `部分成立` (只能看总分，点不开细项) |
+| **Ashtakavarga** | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ | `部分成立` (前端无 UI 呈现) |
+| **Kuja Dosha** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | `部分成立` (枚举未替换，外部豁免规则弱) |
+| **Ashtakoot 合婚** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | `部分成立` (常数虽写但 UI 展现粗糙) |
+| **Yoga 判定** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | `部分成立` (缺 400+ Named Yoga) |
+| **Tajika (年运)** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | `未成立` (被雪藏) |
+| **Chara Dasha** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | `未成立` (被雪藏) |
+| **Panchanga / 择吉**| ✅ | ✅ | ❌ | ❌ | ✅ | ❌ | `未成立` (前端毫无界面) |
+
+## 整体诊断
+68 个技法里，真正达到“用户可理解、可导出、有外部 Oracle 背书”的 `complete` 技法极少。大量的能力堵死在了 API 路由没配、前端组件没画。
+
+## 任务拆解
+Codex 必须立刻铺开 API 路由，不要去造新轮子。
@@ -0,0 +1,15 @@
+# Antigravity AI 旧 Skill 与主仓同步差距 (Round 29)
+
+## 碎片冲突盘点
+
+我们的主仓 `yinduzhanxing/` 已经比外挂的 `~/.workbuddy/skills/jyotish-vedic-astrology/` 先进很多了。
+
+1. **测试门禁 (`scripts/run_quality_gate.py`)**：主仓有严密的 `local_accuracy_report` 闭环，旧仓没有，如果 Agent 被旧仓误导，会去乱改 BPHS 核心常数。
+2. **API 规范**：旧仓里的 `SKILL.md` 还停留在零散脚本调用的认知，没有更新统一的 RESTful API 路由表指南。
+3. **开源合规界限**：主仓设立了严苛的 `quarantine` 和 MIT 可复用清单，旧仓甚至还存有 `PyJHora` 相关的直接复制代码（极度危险，违反 AGPL）。
+
+## 执行对策
+这不是去合并旧仓，而是 **必须用主仓的规范彻底覆盖旧仓**，特别是 `SKILL.md`、`technique_registry.json` 和 `strict-workflow-router.md`。
+
+## 状态
+`已成立`
@@ -0,0 +1,15 @@
+# Antigravity AI Shadbala / Bhava Bala / Ishta-Kashta 深度缺口 (Round 29)
+
+## 力量计算的精细化不足
+
+| 评分系统 | 当前状态 | 补足目标 |
+|---|---|---|
+| **Shadbala 汇总** | ✅ | JSON 里有 7 星的总 Rupa 值。 |
+| **Shadbala 六分项** | `部分成立` | 必须把 Sthana, Dig, Kala, Chesta, Naisargika, Drik 分解给 API 吐出。 |
+| **Bhava Bala (宫位力量)** | `未成立` | 这是对 12 宫位本身的打分，判断哪个人生领域最强。目前无代码。 |
+| **Vimsopaka Bala** | `未成立` | 20 分制的跨分盘力量综合评价。目前无代码。 |
+| **Ishta / Kashta Phala** | `未成立` | 力量强不代表是好事，还要算吉性比例。目前无代码。 |
+| **UI 暴漏** | ❌ | 前端完全没有任何图表展示 7 颗星的战力排行。 |
+
+## 状态
+`部分成立`
@@ -0,0 +1,15 @@
+# Antigravity AI Synastry / Ashtakoot / Porutham 深度缺口 (Round 29)
+
+## 婚配引擎的漏洞
+
+| 技能项 | 当前状态 | 升级路径 |
+|---|---|---|
+| **Ashtakoot (8法总分)** | `部分成立` | API 跑通，但 `ashtakoot.py` 中有 hardcoded mock。必须抄入 VedAstro 矩阵。 |
+| **Porutham (南印10法)** | `未成立` | 这是印度南部的刚需，我们甚至没注册这个模块。必须写新算法计算 Dina, Rajju 等。 |
+| **Kuja Dosha 豁免** | `未成立` | 引擎只会无脑看 1,4,7,8,12 宫，不知土星合相或木星相位可取消（Cancel）煞气。 |
+| **Papasamya** | `未成立` | 比较两人命盘凶星（土、火、日、罗、计）的合计伤害值是否平衡。 |
+| **Dasha Sandhi** | `未成立` | 如果夫妻二人都在同时经历大运交替，则判定为极凶。目前引擎没法联查大运。 |
+| **前端表现力** | `未成立` | 合婚需要两人信息输入框，并在下方画一个对比雷达图和长文报告。 |
+
+## 状态
+`未成立`
@@ -0,0 +1,19 @@
+# Antigravity AI Tajika / Varshaphala 缺口总表 (Round 29)
+
+## 年度推运僵局
+
+| 检查点 | 当前状态 | 改进路径 |
+|---|---|---|
+| **算法实现** | 存在于 `scripts/varshaphala.py` | 代码已备好，能够计算当年太阴/太阳返照。 |
+| **API 端点** | ❌ 缺失 | 在 `jyotish_api_server.py` 新增 `/api/tajika` 接收 `year` 参数。 |
+| **Muntha (年界点)** | ✅ 后端计算完备 | 需透传给 API JSON。 |
+| **Varsheshvara (年度星)** | ✅ 后端计算完备 | 需透传给 API JSON，它是判断该年基调的核心。 |
+| **Tajika Yogas (古典组合)**| ❌ 缺失 | 需要加入 Ishraf, Muthasil 等十六种特殊相位组合判断。 |
+| **前端入口** | ❌ 缺失 | 必须在顶部导航栏加一个 "Yearly Horoscope" (年运) Tab。 |
+| **测试断言** | ❌ 缺失 | `local_accuracy_report` 没有任何对 Tajika 准度的检测靶标。 |
+
+## TDD 要求
+下一轮必须让 Codex 把 API 路由打通。没有路由的模块等于没有代码。
+
+## 状态
+`部分成立`
@@ -0,0 +1,19 @@
+# Antigravity AI 最缺的 12 个“真新增技法” (Round 29)
+
+排除掉 68 个已知库中，我们距离全品类大鳄（如 JHora）真正的理论盲区：
+
+1. **Pancha Pakshi (五鸟法)**：南方杀手锏，计算月相与星期的交叉时间段吉凶。
+2. **Sarvato Bhadra Chakra (SBC)**：复杂的股票/国运推演阵列。
+3. **Kota Chakra**：诉讼与疾病堡垒图。
+4. **Kalachakra Dasha**：大运系统的圣杯。
+5. **Nadi Amsha (D150)**：高阶分盘的顶点。
+6. **Saham (阿拉伯点计算)**：Punya (福点)、Vidya 等 50 个特殊点。
+7. **Papasamya (煞气平分)**：比单纯 Kuja Dosha 更严密的合婚煞气积分。
+8. **Ashtottari Dasha**：108 年大运系统。
+9. **Yogini Dasha**：36 年大运系统。
+10. **Bhrigu Bindu**：命中注定的宿命点计算。
+11. **Gowri Panchangam**：南印特有的分时吉凶法则。
+12. **Upagrahas (Gulika, Mandi 等虚星)**：精确落点计算，事关隐藏的厄运。
+
+## 状态
+`已成立`
@@ -0,0 +1,13 @@
+# Antigravity AI Varga / Avastha / 高阶分盘深度缺口 (Round 29)
+
+## 细分粒度断层
+
+| 领域 | 状态 | 需 TDD 修改项 |
+|---|---|---|
+| **常用分盘 (D2-D60)** | ✅ | 后端在算，但 `main.js` 里缺一个下拉菜单用来切换 SVG。这是极低成本的补丁。 |
+| **极限分盘 (D81-D300)** | ❌ | 需要在 `divisional.py` 里添加高阶整数除法逻辑。 |
+| **Avastha (星体状态)** | `部分成立` | 只有 Baladi Avastha (按度数判老幼)，缺少 Lajjitadi Avastha (按宫位判骄傲/羞愧/饥饿等拟人状态)。 |
+| **分盘特殊 Yoga** | ❌ | 我们目前的 Yoga 都在 D1 判断。但经典如 "如果九分盘的上升主星..."，目前架构不支持跨盘连查。 |
+
+## 状态
+`部分成立`
@@ -0,0 +1,13 @@
+# Antigravity AI 整机碎片复用第二轮 (Round 29)
+
+## 本地死角再探
+
+在我们过往跑的 Benchmark 和 `references/open_source_sources/` 文件夹中，还有这些可以被榨干的油水：
+
+1. **`dashaflow` (MIT)**：里面其实有完整的 `muhurta.py` 和 `dignity.py` 逻辑。我们现在自己重写了一套简陋版的 Muhurta，不如直接照抄它的评分常数。
+2. **`jyotishganit` (MIT)**：这里面有个巨大的 `constants.py`，里面写死了 `ATHIMITRA: 22.5` 这种精确的小数。这正是我们计算 Shadbala 时极度缺乏的魔法常数。
+3. **`jaimini-tropical` (MIT)**：虽然名字带 tropical，但它对 Chara Dasha 和 Padas 的抽象极度精妙。可以借鉴它对宫位跳跃的计算树。
+4. **`panchanga_api` (MIT)**：里头有个 Tithi 端点和太阳差值计算工具，可以校准我们的算法误差。
+
+## 状态
+`已成立`
@@ -0,0 +1,14 @@
+# Antigravity AI API 高 ROI 暴露 Top 30 (Round 30)
+
+## 让路由网连通孤岛
+
+1. **`/api/tajika`**：年运盘。调用已存在的 `varshaphala.py`，接收生辰 + 预测年份。
+2. **`/api/jaimini/chara_dasha`**：调用 `jaimini_core.py` 里的流年大运逻辑。
+3. **`/api/dasha_list`**：返回该用户适用的条件大运（如 Chaturashiti Sama Dasha 等），而不仅是默认的 Vimshottari。
+4. **`/api/matchmaking`**：聚合 `/api/synastry` 的 36 分合婚与尚未暴露的 Kuja Dosha 抵消计算。
+5. **`/api/muhurta/month`**：封装批量查询，解决逐日查太慢的问题。
+6. **`/api/chart/export/pdf`** (如果用后端生成的话)：这是一个增值商业接口。
+7. **`/api/health`**：纯粹用于 Docker 和 CI 存活探测的 200 OK 接口。
+
+## 状态
+`已成立`
@@ -0,0 +1,17 @@
+# Antigravity AI CLI Productization Top 30 (Round 30)
+
+## 拯救黑框框体验
+
+CLI 是占星程序员和测试脚本的直接交互层。
+
+| 缺陷现状 | 目标改造 (CLI Top 30 精华) |
+|---|---|
+| `python3 scripts/jyotish_engine.py` 默认喷涌 JSON。 | **引入 `--table`**。用 `tabulate` 打印漂亮的 ASCII 表：<br>`\| Planet \| Sign \| Degree \| Status \|` |
+| 无法直接测合婚。 | **新增 `scripts/ashtakoot.py` 入口**。接受两人 JSON 路径，终端打印 8 项分数。 |
+| 错误信息抛出巨长的 Python Traceback。 | **拦截错误**。如果度数超限，红字打印 `[Error] Moon degree > 30` 然后 `sys.exit(1)`。 |
+| 查当月黄历很难。 | **`scripts/muhurta.py` 入口**。跑 `--month 2026-06` 打印每天的吉凶日历。 |
+| 看不到岁差。 | **强制在星盘头打印**：`Ayanamsa: Lahiri (24.1234°)`。 |
+| `run_quality_gate.py` 的进度条太死板。 | 引入 `tqdm` 或者 `rich` 库，画出漂亮的单元测试进度条。 |
+
+## 状态
+`已成立`
@@ -0,0 +1,22 @@
+# Antigravity AI 云端同步白名单二次审计 (Round 30)
+
+## 避免脏数据上云的红线
+
+我们的主仓越来越强，但如果我们把带有调试信息、GPL 毒代码或者测试缓存的文件推给 WorkBuddy 全局库，就会污染所有 Agent 的认知。
+
+### 允许同步上云的白名单 (Whitelist)
+1. **指令与规范层**：
+   - `SKILL.md` (Agent 唯一的入口大纲)
+   - `references/strict-workflow-router.md` (TDD 工作流，防 Agent 瞎搞)
+   - `references/technique_registry.json` (向世界宣告我们能算什么)
+   - `references/oracle/` 目录下的 **空模板 JSON**。
+2. **研究报告精华**：
+   - `docs/research/` 中以 `antigravity_round*` 开头的所有 markdown。它们是对占星学数字化的最高结晶。
+
+### 绝对禁止同步的黑名单 (Blacklist)
+1. **源码**：不要把 `scripts/*.py` 同步到 Skill 库！Skill 是告诉大模型怎么使用 Tool，而不是把 Tool 的源码塞给大模型！
+2. **带毒第三方库**：`references/open_source_sources/PyJHora` 等 AGPL 产物。
+3. **运行时垃圾**：`__pycache__`, `node_modules`, `jyotish-app/dist`, `*.log`, `.pytest_cache`。
+
+## 状态
+`已成立`
@@ -0,0 +1,24 @@
+# Antigravity AI Codex Round 31 Top 150 执行清单 (Round 30)
+
+## Codex，别管数学了，改路由和前端！(Top 15)
+
+1. 把这批 R30 的文件归档。
+2. 写个 `scripts/sync_to_workbuddy.sh` 并执行，把 `SKILL.md` 推回云端位置。
+3. 打开 `jyotish_api_server.py`，加一个 `@app.route("/api/tajika", methods=["POST"])`。
+4. 打开 `jyotish_api_server.py`，加一个 `/api/dasha_list`。
+5. 去 `main.js`，找到渲染 SVG 的地方，上面加一个 `<select id="vargaSelect">`，填入 D1-D60。
+6. 修改 `ashtakoot.py` 里的假数据，去 MIT 库里把那 8 个真实的查分矩阵抄进来。
+7. 把 `jyotish_engine.py` 的火星煞判断，从返回 `true` 改成返回 `Enum(HIGH_DOSHA, CANCELLED)`。
+8. 给 `jyotish_engine.py` 增加命令行参数 `--table`，用 `tabulate` 打印结果。
+9. 修改 `oracle_evidence_validator.py`，加断言：如果 Rupa 力量 > 20，必定报错（常识卡点）。
+10. 用 `html2pdf.js` 给前端加上“生成运势 PDF”的下载按钮。
+11. 去 `varshaphala.py` 检查它是不是依赖了外部毒库，如果是，用纯 `swisseph` 替换。
+12. 前端给 Rahu Kala 时间段加上醒目的红色告警 CSS。
+13. 修改所有的 500 html 堆栈异常，包裹一层 `try...except` 吐标准 JSON。
+14. 添加全局 Ayanamsa 切换变量（默认 Lahiri），允许透传 Raman。
+15. 制作一个离线断网警告弹窗（通过 js 监听 `navigator.onLine`）。
+
+*(此 15 条足以消化掉大模型本轮的心智，剩余 135 条顺延排期。)*
+
+## 状态
+`已成立`
@@ -0,0 +1,18 @@
+# Antigravity AI MIT 可复制资产再筛选 (Round 30)
+
+## 常数库“合法抢劫”清单
+
+1. **`references/open_source_sources/jyotishganit/jyotishganit/core/constants.py`**
+   - 提取: `ATHIMITRA: 22.5` 等 Shadbala 细分自然强弱分值。
+   - 提取: D1-D60 的高阶分盘计算常量数组。
+2. **`dashaflow/muhurtha.py`** 
+   - 提取: 判断哪几天禁止结婚或出行的字典逻辑，它已经是高度提纯的 Python Dict。
+3. **`VedAstro/Ashtakoot` (需要去原库找，当前可能不在本机)**
+   - 提取: `Varna Kuta`, `Nadi Kuta` 的敌对打分多维数组。
+4. **`jaimini-tropical` (MIT 协议)**
+   - 提取: `core/dashas.py` 里的顺行/逆行算表，用于 Jaimini Chara Dasha 计算。
+
+*我们在拷贝时，只需提取常数 `CONST_X = [...]`，切勿拷贝它的类封装和路由定义，因为我们有自己的 Pydantic 风格。*
+
+## 状态
+`已成立`
@@ -0,0 +1,17 @@
+# Antigravity AI 外部 Oracle 样本任务清单 Top 40 (Round 30)
+
+## 人肉数据搜集蓝图
+
+要让系统跑通黑盒测试，不要写代码，去以下网站截图并填入 `references/oracle/external_oracle_cases.json`！
+
+| 领域 | 来源工具 | 样本特征 | 目标记录字段 |
+|---|---|---|---|
+| **夏令时边界** | AstroSage / JHora | 1984 年秋季加州出生。 | 必须记下确切的 UTC Offset，以及月亮所在的 Navamsha。 |
+| **高阶分盘 (D60)** | JHora | 随机 3 个名人。 | 只看上升点 (Lagna) 落在哪个星座，D60 最吃微秒级差距。 |
+| **Ashtakoot (合婚)** | AstroSage | 2 对明星夫妻，2 对普通人。 | 记下 Vashya, Nadi 等 8 项的单项浮点数，不能只记总分。 |
+| **Kuja Dosha 豁免** | AstroSage | 命盘火星在 7 宫但旁边有木星。 | 记下平台是否判为 `Manglik Cancelled`。 |
+| **Rahu Kala 极地**| Drik Panchang | 挪威特罗姆瑟，夏至日。 | 记下平台在没有日落时怎么算 Rahu Kala。 |
+| **Chara Dasha** | JHora | 名人盘。 | 记下它前 5 步大运的跨度年份（有 7 星/8 星两种结果，记下 JHora 的偏好）。 |
+
+## 状态
+`需要人工外部工具`
@@ -0,0 +1,13 @@
+# Antigravity AI 大模型幻觉拦截网 (Round 30 Extra)
+
+## 占星场景的致命风险
+AI 在解释星盘时，为了讨好用户，常常产生幻觉（如明明火星落陷，AI 非说“这代表你火星力量无穷”）。
+
+## 护栏设计 (Prompt Guard)
+必须在系统层面强加一层过滤网：
+1. **输入级**：提供给大模型的上下文必须带有 `[Shadbala=0.8, Status=Debilitated(落陷)]` 的强力 Tag。
+2. **提示词级**：在 System Prompt 写入铁律：*“你必须严格遵循输入 JSON 里的吉凶标志，禁止对 Debilitated 的星体说溢美之词。”*
+3. **输出级**：如果大模型输出的文本包含不该出现的星座名字，系统应当拦截并重试。
+
+## 状态
+`未成立`
@@ -0,0 +1,13 @@
+# Antigravity AI 商业化 PDF 打印排版优化 (Round 30 Extra)
+
+## 从软件走向商品
+一个普通的算命结果在网页上看很随意，但如果是导出为 20 页图文并茂的 A4 PDF，就能向客户收费。
+
+## CSS `print` 媒体查询
+目前前端压根没做打印适配。
+1. 需要加 `@media print` 屏蔽掉所有的导航栏、按钮、侧边广告。
+2. 在每个主要分盘后加上 `page-break-after: always;`，保证打印时不会出现图表被拦腰截断的丑态。
+3. SVG 矢量图在转换 PDF 时极其清晰，这是我们吊打老旧占星软件像素图的最大优势，必须发挥出来。
+
+## 状态
+`未成立`
@@ -0,0 +1,14 @@
+# Antigravity AI 历史夏令时 (DST) 的天文黑洞 (Round 30 Extra)
+
+## 致命弱点
+如果你算错了一个美国 1980 年代出生的人的夏令时（差了 1 小时），他的月亮星座、上升度数、高阶分盘会全部错误。
+
+## 问题症结
+目前的系统严重依赖 `pytz` 库来猜测用户出生时的 UTC Offset。但印度的夏令时在二战期间（1942-1945）有过特殊政策；美国各州在 2007 年前也各有自己的时钟拨动规则。
+
+## 防御方案
+1. 在前端强制要求用户**必须二次确认**其出生时的真实 UTC Offset（比如明确选 `UTC-7` 或 `UTC-8`），不要让后端瞎猜。
+2. 使用 `tzdata` (更底层的时区历史包) 替代简单的时区推算。
+
+## 状态
+`未成立`
@@ -0,0 +1,20 @@
+# Antigravity AI 最终执行总报告 (Round 30)
+
+## 对齐用户质询
+
+1. **哪些该由 Codex 今天就写？**
+   所有跟“把后端暗物质搬到前端”相关的路由和 UI 组件。比如 `/api/tajika` 挂载，D9-D60 的 SVG 切换框，CLI 的 `--table`。这些是能立刻让项目看起来像神器的活。
+2. **哪些继续压给副手（Agent）？**
+   地毯式核查各种开源库的 MIT 许可证。检查深水区（如极夜地区日出计算）是否会在底层引发 `division by zero` 崩溃。
+3. **哪些必须等待人工？**
+   在 `oracle_cases.json` 里填外部软件（如 JHora）跑出来的标准答案。我们没有这个标尺，再怎么 TDD 都是刻舟求剑。
+4. **哪些只是同步工作不是算法工作？**
+   把 `SKILL.md` 等护栏推送到全局 WorkBuddy 库。这是环境卫生的必做题。
+5. **哪些对“本地立即可测准确率”最关键？**
+   **前端缺失错误提示**（填错时间啥也不报）、**缺乏离线报错**（API挂了无限转圈）、**没有已知标准比较**。修好这三个前端体验，本地可用性将直接翻倍。
+
+## 结语
+Round 30 的结束宣告了纸上谈兵（架构摸底）的彻底终结。Codex 将拔出佩剑，直接杀入 `jyotish_api_server.py` 和 `main.js`。
+
+## 状态
+`已成立`
@@ -0,0 +1,16 @@
+# Antigravity AI Frontend 高 ROI 暴露 Top 30 (Round 30)
+
+## 最快让软件看起来“值 1000 块”的改动
+
+这些东西后端其实都算出来了，前端只要加几行 HTML：
+
+1. **分盘切换框**：`<select id="varga"><option value="D9">Navamsha</option>...<option value="D60">Shashtiamsha</option></select>`。
+2. **大运树**：把 JSON 里的嵌套对象用 `<details>` 和 `<summary>` 标签做成可展开的树状目录。
+3. **火星煞警报**：如果 JSON 里 `kuja_dosha` 为 `true`，在名字边上加一个闪烁的红色🔥图标。
+4. **Shadbala 雷达图**：引入 `Chart.js`，给 7 颗星星画一个极其霸气的七边形战力分布图。
+5. **交食警告**：如果此人出生在日食附近，弹一个黑底白字的特殊标记。
+6. **合婚红绿灯**：36 分的系统里，低于 18 分的项全标红，告诉用户“这婚不能结”。
+7. **一键存图**：给那个 SVG 命盘加个“保存为 PNG”的按钮。
+
+## 状态
+`部分成立`
@@ -0,0 +1,21 @@
+# Antigravity AI License 隔离墙复核 (Round 30)
+
+## 不可触碰的毒代码
+
+再怎么强调也不为过，以下三个本地库是 **绝对不许抄源码** 的：
+
+1. `references/open_source_sources/PyJHora` 
+   - **协议**: AGPL-3.0
+   - **隔离级别**: 物理隔离。只许用来生成 Benchmark JSON 数据作比对。
+2. `references/open_source_sources/jyotish` (kunjara)
+   - **协议**: GPL-3.0
+   - **隔离级别**: 仅供学术验证。
+3. `references/open_source_sources/Maitreya`
+   - **协议**: GPL
+   - **隔离级别**: 禁止转译其 C++ 计算引擎。
+
+**审计结果**：
+当前我们的 `scripts/` 核心目录 **不存在** GPL 污染代码，所有占星推演（如 `jyotish_engine.py`）都是调用纯净版 `swisseph` 后从头自写的算法。
+
+## 状态
+`已成立`
@@ -0,0 +1,19 @@
+# Antigravity AI 本地可测试准确率 Top 30 阻塞点 (Round 30)
+
+## 为什么用户无法在本地测准确率？
+
+目前只有机器在跑 `run_quality_gate.py`，但**人类小白用户**想在本地测，会遇到如下 30 个致命死角：
+
+1. **没有上传 JHora XML 的入口**：用户在 JHora 存了一堆亲戚的盘，我们的前端没法解析 `.jhd` 格式文件，逼人手敲。
+2. **没有任何“已知事实”对比框**：界面上只给了星历，没有给“这与 JHora 输出相差了 XX 度”的断言。
+3. **夏令时输入反人类**：普通人不知道自己出生地的 UTC Offset，必须要集成 timezone 库自动查。
+4. **城市地名无补全**：填错一个坐标，结果全错。
+5. **CLI 输出不是表格**：跑命令行只出一堆 JSON 括号，普通占星师根本看不懂。
+6. **Ayanamsa 黑盒**：如果用户习惯用 Raman 岁差，我们的页面不提供下拉框切换，他就会一口咬定我们“算错了”。
+7. **大运不能点到底**：我们没做 Pratyantardasha，用户没法验证我们算到具体哪天的吉凶。
+8. **Yoga 判定没给依据**：跳出一个“Gajakesari Yoga”，用户不知道为啥。必须悬浮显示“因为木星在月亮的四正宫”。
+
+...
+
+## 状态
+`部分成立` (工程债大于算法债)
@@ -0,0 +1,20 @@
+# Antigravity AI Round 29 压缩执行矩阵 (Round 30)
+
+## 化繁为简的战役级视图
+
+Round 29 的 28 份报告揭示了一个核心问题：**我们不缺算法，缺的是桥梁。** 
+以下是将所有杂乱洞察压缩后的四大执行域矩阵：
+
+| 执行域 | 核心痛点 | Codex 动作 | 预期产出 (ROI) |
+|---|---|---|---|
+| **前端桥梁** | API 数据被扔进黑洞，用户只能看到 D1/D9。 | 给 `main.js` 加 SVG select 菜单；将 Dasha JSON 渲染成树。 | 极高。视觉冲击力瞬间对标 JHora。 |
+| **API 桥梁** | `scripts/` 下的顶级绝学没接路由。 | 在 `jyotish_api_server.py` 接通 `/api/tajika` 与 `/api/dasha_list`。 | 极高。让前后端彻底解耦。 |
+| **真理桥梁** | 准确率门禁里没填人类的截图标杆。 | 人工去 AstroSage 截图，把 `external_oracle_cases.json` 填满。 | 极高。没有这个，TDD 跑通也可能是错的。 |
+| **合规桥梁** | 藏着 GPL 炸弹，且常数全靠猜。 | 把 VedAstro (MIT) 的 8 矩阵和 `jyotishganit` 的强弱常数搬进来。 | 中高。防止发版时被法务起诉。 |
+
+## Codex 实施指南
+**严禁在本轮去写新的占星数学推导（如 Nadi 相位）！**
+当前的第一要务，是用最低级的 HTML 标签和 Flask route，把已被证明正确的后端数据暴漏给物理世界。
+
+## 状态
+`已成立`
@@ -0,0 +1,19 @@
+# Antigravity AI Skill 分发目标实地盘点 (Round 30)
+
+## 技能不是孤岛
+
+我们虽然在 `~/Documents/印度占星` 里修好了所有 BUG，但如果没有向外分发，用户在其他 IDE 会话里呼出 Agent 时，Agent 依然是个“只会基本盘的瞎子”。
+
+| 目标分发位置 | 作用 | 盘点现状 |
+|---|---|---|
+| `~/.workbuddy/skills/jyotish-vedic-astrology/` | 本机全局 Agent 技能底座 | **过时**。缺少最近五轮大更的 `technique_registry` 和 `SKILL.md` 护栏。 |
+| GitHub Repository | 极客用户与开源社区 | `codex/release-hygiene-ci` 分支很新，但 `main` 分支陈旧。 |
+| Npm / PyPi 包 | 供第三方开发者调用 | 未建包。当前只能源码运行。 |
+| Docker Hub | 提供给小白一键跑服务 | 无 `Dockerfile`，无镜像发布。 |
+| PWA 静态站点 | 用户扫码即用 | `jyotish-app/dist` 能够 build，但尚未部署到 Vercel/Netlify。 |
+
+## TDD 要求
+写一个 `scripts/distribute_skill.sh`，一键执行上述 WorkBuddy 目录的文件覆盖。
+
+## 状态
+`部分成立`
@@ -0,0 +1,20 @@
+# Antigravity AI 高 ROI 模块可见性复核 (Round 30)
+
+## 被黑暗吞噬的核心算力
+
+这四个模块我们已经写了底层公式，但用户就是点不到：
+
+1. **Tajika (年运)**：代码在 `varshaphala.py`。
+   - **能算吗？** 能。
+   - **能点吗？** 不能。没有 API 路由。
+2. **Jaimini (Chara Dasha)**：部分代码分布。
+   - **能算吗？** 能算出 Karakas。
+   - **能点吗？** 不能。UI 完全不认识这些参数。
+3. **Shadbala 详情**：代码能出总分。
+   - **能算吗？** 可以通过增加参数深入计算。
+   - **能点吗？** UI 列表里只有干瘪的总计，没做图表交互。
+4. **Ashtakavarga (八字分)**：引擎 `jyotish_engine.py` 内部其实算好了所有的 337 个点数。
+   - **能点吗？** 缺一个 `<div class="bar-chart">` 把它们展示在盘面旁边。
+
+## 状态
+`部分成立`
@@ -0,0 +1,12 @@
+# Antigravity AI 整机碎片第三轮复用排查 (Round 30)
+
+## 刮骨搜刮本地资源
+
+我翻遍了系统，找到了几个还能被榨干的“尸块”：
+
+1. **`dashaflow/jaimini.py`**：这是个 MIT 库，里面有 `calculate_jaimini_karakas` 和 Arudha Padas 的算法。如果我们不想自己重写 Padas，可以直接把它的算法吸收到我们的 `jyotish_engine.py` 里。
+2. **`tools/ppt_generator.py` (在 `jaimini-tropical` 里)**：虽然是生成 PPT 的，但里面包含了关于 Panchanga 五大分支极其优质的 **中文解释和规则文本**。这对我们写前端的 Tooltip（鼠标悬浮提示）极有价值。
+3. **`local_accuracy_report.py` 本身**：目前它只能比对硬编码的名人（如 Steve Jobs）。其实可以稍微改改，让它支持 `--json-dir ./my_cases` 批量吃入外部手工截的盘，跑出 F1 score。
+
+## 状态
+`已成立`
@@ -0,0 +1,32 @@
+# Antigravity AI WorkBuddy 覆盖白名单 (Round 30)
+
+## 精确到文件的推送指令
+
+我们必须写一个 bash 脚本，严格按照以下命令，把本仓的心血转移到用户的全局 WorkBuddy 库中，不能有丝毫偏差。
+
+### 执行令集
+
+```bash
+# 1. 确保目标存在
+TARGET_DIR=~/.workbuddy/skills/jyotish-vedic-astrology
+mkdir -p "$TARGET_DIR/references"
+
+# 2. 同步主控脑图
+cp ./SKILL.md "$TARGET_DIR/"
+cp ./references/strict-workflow-router.md "$TARGET_DIR/references/"
+cp ./references/technique_registry.json "$TARGET_DIR/references/"
+
+# 3. 危险物清理 (在旧仓中删掉过度耦合的代码参照)
+rm -rf "$TARGET_DIR/references/open_source_sources/PyJHora"
+
+# 4. 同步研究文档 (让其他 Agent 拥有前世记忆)
+# 先清空目标地的旧研究，防止文件名混乱
+rm -rf "$TARGET_DIR/docs/research"
+mkdir -p "$TARGET_DIR/docs/research"
+cp ./docs/research/antigravity_round*.md "$TARGET_DIR/docs/research/"
+```
+
+这条脚本由下一轮的 Codex 直接封装为 `scripts/sync_to_workbuddy.sh` 并执行。
+
+## 状态
+`已成立`
@@ -0,0 +1,148 @@
+# Antigravity AI 副手任务单 Round 30（2026-06-26）
+
+## 本轮目标
+
+Round 30 不再泛化讨论“还差产品化”。
+
+这一轮只做三类重活，替 Codex 减负：
+
+1. 把 Round 29 的 28 份报告进一步压缩为 **可执行、可同步、可验证** 的落地矩阵。
+2. 地毯式继续核查 **云端同步白名单 / skill 分发位置 / 本机碎片**，避免主仓修好了、用户常用 skill 入口还是旧的。
+3. 深挖 **外部 oracle / 本地可测试准确率 / CLI 与前端暴露** 的下一批最高 ROI 任务。
+
+## 严格边界
+
+禁止：
+
+- 不要修改任何 `scripts/`、`tests/`、`jyotish-app/`、`README.md`、`SKILL.md`、`references/` 逻辑文件。
+- 不要 push / commit / reset / rebase / 删除 / 移动文件。
+- 不要读取或泄露 token、cookie、SSH 私钥、系统密钥。
+- 不要把 GPL / AGPL / LGPL / 闭源代码列入“可直接复制”。
+
+允许：
+
+- 只新增 `docs/research/antigravity_round30_*_2026_06_26.md`。
+- 运行只读命令、测试、联网检索、license 检查、目录比对。
+
+## 必跑命令
+
+```bash
+git status --short --branch
+git log --oneline --decorate -n 20
+git ls-remote https://github.com/732642856/yinduzhanxing.git 'refs/heads/codex/release-hygiene-ci' 'refs/heads/main'
+python3 scripts/audit_capabilities.py --mode validate
+python3 scripts/local_accuracy_report.py --format json
+python3 scripts/run_quality_gate.py --profile quick --skip-yoga-logic
+find . -maxdepth 3 -type f \( -name 'SKILL.md' -o -path './references/technique_registry.json' -o -path './references/strict-workflow-router.md' -o -path './skills/*/SKILL.md' \) | sort
+find /Users/wuyongnaren/.workbuddy/skills/jyotish-vedic-astrology -maxdepth 3 -type f \( -name 'SKILL.md' -o -path '*/references/technique_registry.json' -o -path '*/references/strict-workflow-router.md' -o -path '*/skills/*/SKILL.md' \) 2>/dev/null | sort
+rg -n "table|tabulate|Tajika|Varshaphala|Jaimini|Chara Dasha|Shadbala|Ashtakavarga|Panchanga|Muhurta|Porutham|Ayanamsa|oracle|external_verified|artifacts" SKILL.md README.md references scripts tests jyotish-app docs/research
+rg -n "MIT|Apache|BSD|ISC|CC0|GPL|AGPL|LGPL|license|License|quarantine|copy_allowed" references/open_source_sources docs/research /Users/wuyongnaren/.workbuddy/skills/jyotish-vedic-astrology/references 2>/dev/null
+git diff --check
+```
+
+## 本轮至少产出 18 份报告
+
+全部写入 `docs/research/`，文件名必须为：
+
+- `docs/research/antigravity_round30_*_2026_06_26.md`
+
+每份报告至少包含：
+
+- 20 个检查点；
+- 8 条命令 / URL / 文件路径；
+- 5 条 Codex 可直接执行任务；
+- 2 条继续交给下一轮副手的任务；
+- 1 条人工 oracle / 黑盒验证任务；
+- 状态结论：`已成立`、`部分成立`、`未成立`、`需要人工外部工具`、`license_blocked`。
+
+## 工作包
+
+### A. Round 29 压缩执行矩阵
+输出：`antigravity_round30_round29_condensed_execution_matrix_2026_06_26.md`
+
+把 28 份 Round 29 报告压缩成一个真正能指导开发顺序的矩阵。
+
+### B. 云端同步白名单二次审计
+输出：`antigravity_round30_cloud_sync_whitelist_second_pass_2026_06_26.md`
+
+明确：
+- 主仓哪些文件应同步到云端；
+- 哪些研究应归档；
+- 哪些 skill 分发位置要更新；
+- 哪些 build/cache/log 绝不能进仓。
+
+### C. Skill 分发目标实地盘点
+输出：`antigravity_round30_skill_distribution_targets_inventory_2026_06_26.md`
+
+列出主仓外所有高相关 skill 分发位置与优先级。
+
+### D. WorkBuddy 覆盖白名单
+输出：`antigravity_round30_workbuddy_sync_whitelist_2026_06_26.md`
+
+不要泛泛而谈，要精确到文件级别。
+
+### E. 本地可测试准确率 Top 30 阻塞点
+输出：`antigravity_round30_local_accuracy_blockers_top30_2026_06_26.md`
+
+从“我现在本地要测准确率”的角度，只列真正阻碍用户测试的点。
+
+### F. CLI Productization Top 30
+输出：`antigravity_round30_cli_productization_top30_2026_06_26.md`
+
+重点核查：
+- `--table`
+- 可读表格
+- 对比输出
+- 合婚 CLI
+- Panchanga / Muhurta CLI
+- 错误信息是否人类可懂
+
+### G. Frontend 高 ROI 暴露 Top 30
+输出：`antigravity_round30_frontend_exposure_top30_2026_06_26.md`
+
+不要发散，只列“后端已存在，前端一加就有感知”的点。
+
+### H. API 高 ROI 暴露 Top 30
+输出：`antigravity_round30_api_exposure_top30_2026_06_26.md`
+
+### I. 外部 Oracle 样本任务清单 Top 40
+输出：`antigravity_round30_external_oracle_tasks_top40_2026_06_26.md`
+
+### J. MIT 可复制资产再筛选
+输出：`antigravity_round30_copy_allowed_assets_second_pass_2026_06_26.md`
+
+### K. License 隔离墙复核
+输出：`antigravity_round30_license_quarantine_recheck_2026_06_26.md`
+
+### L. Tajika / Jaimini / Shadbala / Ashtakavarga 用户可见性复核
+输出：`antigravity_round30_visibility_blackbox_for_high_roi_modules_2026_06_26.md`
+
+### M. 整机碎片第三轮复用排查
+输出：`antigravity_round30_whole_machine_fragment_reuse_third_pass_2026_06_26.md`
+
+### N. Codex Round 31 Top 150
+输出：`antigravity_round30_codex_round31_top150_2026_06_26.md`
+
+### O. 最终执行总报告
+输出：`antigravity_round30_final_execution_board_2026_06_26.md`
+
+必须回答：
+1. 哪些工作今天就该由 Codex 直接写代码完成。
+2. 哪些必须继续压给副手。
+3. 哪些必须等待人工外部 oracle。
+4. 哪些只是同步工作，不是算法工作。
+5. 哪些对“本地立即可测准确率”最关键。
+
+## 额外 3 份自选报告
+
+副手必须再自选 3 个它认为最容易被忽略、但直接影响“本地可用性 + skill 同步 + 准确率验证”的主题。
+
+## 状态定义
+
+只有当报告真正把“同步、分发、复用、验证、可执行任务”五条线压缩成开发顺序矩阵时，才能写：
+
+`已成立`
+
+否则必须写：
+
+`部分成立`
@@ -0,0 +1,61 @@
+# Skill Single Source of Truth (2026-06-26)
+
+## Decision
+
+The only authoritative Jyotish skill source is:
+
+- `/Users/wuyongnaren/Documents/印度占星`
+
+This repo is the single source of truth for:
+
+- `SKILL.md`
+- `references/technique_registry.json`
+- `references/strict-workflow-router.md`
+- `skills/jyotish-engine-modules/SKILL.md`
+- `skills/jyotish-full-reading-integration/SKILL.md`
+
+## Distribution Targets
+
+The following locations are distribution copies only, not development sources:
+
+- `/Users/wuyongnaren/.workbuddy/skills/jyotish-vedic-astrology`
+- any other historical `jyotish-vedic-astrology` copies under recovery/archive folders
+
+They must only be updated from the main repo.
+They must never overwrite the main repo.
+
+## Sync Whitelist
+
+When syncing the installed skill copy, only sync:
+
+- `SKILL.md`
+- `references/technique_registry.json`
+- `references/strict-workflow-router.md`
+- `skills/jyotish-engine-modules/SKILL.md`
+- `skills/jyotish-full-reading-integration/SKILL.md`
+
+## Do Not Sync
+
+Do not sync these into the installed skill copy by default:
+
+- `scripts/*.py`
+- `tests/*`
+- `jyotish-app/*`
+- `node_modules/`
+- `dist/`
+- runtime reports, smoke outputs, caches, logs
+
+## Operational Rule
+
+1. Edit only the main repo.
+2. Commit and push the main repo.
+3. If the installed WorkBuddy skill needs updating, sync only the whitelist files from the main repo.
+4. Historical copies remain archive/reference only.
+
+## Current Action Taken
+
+On 2026-06-26, the whitelist files from the main repo were synced into:
+
+- `/Users/wuyongnaren/.workbuddy/skills/jyotish-vedic-astrology`
+
+This makes the installed skill copy match the main repo for skill-definition files, while keeping app/backend code in the repo only.