docs: 更新文档

README.md

@@ -103,7 +103,9 @@
 
 **注意**：以下经验分享并非普遍适用，请在具体实践中结合场景，辩证采纳。
 
-## 🔑 元方法论 (Meta-Methodology)
+<details>
+<summary><strong>🔑 元方法论 (Meta-Methodology)</strong></summary>
+
 
 该思想的核心是构建一个能够**自我优化**的 AI 系统。其递归本质可分解为以下步骤：
 
@@ -132,6 +134,11 @@
 
 通过此持续的**递归优化循环**，系统在每次迭代中实现**自我超越**，无限逼近预设的**预期状态**。
 
+</details>
+
+<details>
+<summary><strong>🧭 方法论精要 (道·法·术)</strong></summary>
+
 ## 🧭 道
 
 * **凡是 ai 能做的，就不要人工做**
@@ -168,6 +175,11 @@
 * 测试可交给 AI，**断言人审**
 * 代码一多就**切会话**
 
+</details>
+
+<details>
+<summary><strong>📋 器 (工具与资源)</strong></summary>
+
 ## 📋 器
 
 ### 集成开发环境 (IDE) & 终端
@@ -216,22 +228,19 @@
 *   [**tmux快捷键大全**](./i18n/zh/documents/教程与指南/tmux快捷键大全.md): tmux 的快捷键参考文档。
 *   [**LazyVim快捷键大全**](./i18n/zh/documents/教程与指南/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
 *   [**手机远程 Vibe Coding**](./i18n/zh/documents/教程与指南/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md): 基于 frp 实现手机 SSH 远程控制本地电脑进行 Vibe Coding。
-*   [**prompts-library**](./libs/external/prompts-library/): 提示词库管理工具，支持 Excel 与 Markdown 互转。
-*   [**my-nvim**](./libs/external/my-nvim/): Neovim 配置参考。
-*   [**XHS-image-to-PDF-conversion**](./libs/external/XHS-image-to-PDF-conversion/): 小红书图片转 PDF 工具。
-*   [**MCPlayerTransfer**](./libs/external/MCPlayerTransfer/): MC 玩家数据迁移工具。
-*   [**快速本地备份**](./libs/common/utils/backups/): 项目快速备份脚本。
 
 ### 外部教程与资源
 
-*   [**Vibe Coding 社群 (X)**](https://x.com/i/communities/1993849457210011871): X 平台上的 Vibe Coding 社群。
-*   [**社群干货聚合页**](https://x.com/vibeverything/status/1999796188053438687): Vibe Coding 社群精华内容汇总。
-*   [**超级个体资源清单**](https://x.com/BiteyeCN/status/2000856243645157387): 从 Vibe Coding 入门的资源清单。
 *   [**二哥的Java进阶之路**](https://javabetter.cn/): 包含多种开发工具的详细配置教程。
 *   [**虚拟卡**](https://www.bybit.com/cards/?ref=YDGAVPN&source=applet_invite): 可用于注册云服务等需要国际支付的场景。
 
 ---
 
+</details>
+
+<details>
+<summary><strong>编码模型性能分级参考</strong></summary>
+
 ## 编码模型性能分级参考
 
 建议只选择第一梯队模型处理复杂任务，以确保最佳效果与效率。
@@ -242,6 +251,11 @@
 
 ---
 
+</details>
+
+<details>
+<summary><strong>📚 相关文档与资源</strong></summary>
+
 ## 📚 相关文档与资源
 
 *   **交流社区**:
@@ -268,6 +282,11 @@
 
 ---
 
+</details>
+
+<details>
+<summary><strong>项目目录结构概览</strong></summary>
+
 ### 项目目录结构概览
 
 本项目 `vibe-coding-cn` 的核心结构主要围绕知识管理、AI 提示词的组织与自动化展开。以下是经过整理和简化的目录树及各部分说明：
@@ -329,6 +348,8 @@
 
 ---
 
+</details>
+
 ## 🖼️ 概览与演示
 
 一句话：Vibe Coding = **规划驱动 + 上下文固定 + AI 结对执行**，让「从想法到可维护代码」变成一条可审计的流水线，而不是一团无法迭代的巨石文件。
@@ -337,6 +358,9 @@
 - 成体系的提示词工具链：`i18n/zh/prompts/system_prompts/` 约束 AI 行为边界，`i18n/zh/prompts/coding_prompts/` 提供需求澄清、计划、执行的全链路脚本。
 - 闭环交付路径：需求 → 上下文文档 → 实施计划 → 分步实现 → 自测 → 进度记录，全程可复盘、可移交。
 
+<details>
+<summary><strong>⚙️ 架构与工作流程</strong></summary>
+
 ## ⚙️ 架构与工作流程
 
 核心资产映射：
@@ -417,6 +441,8 @@ graph TB
 
 ---
 
+</details>
+
 <details>
 <summary>📈 性能基准 (可选)</summary>
 

i18n/zh/documents/项目实战经验/fate-engine-dev/production_incident_2025-12-17_strong_weak.md

@@ -0,0 +1,16 @@
+# 生产故障记录：身强/身弱判定口径冲突
+
+- **时间**：2025-12-17  
+- **影响**：用户报告同一份排盘出现“强弱判断：偏弱”与“身强判定：身强”矛盾，导致用神建议被误导，信任度下降。  
+- **根因**：代码同时输出两套强弱算法结果——
+  - 外部库 bazi-1 weak 判定（`_calc_wuxing_scores.weakStrong`，含长生/帝旺权重）。  
+  - 本地自写简化算法 `_calc_strength`（仅按三柱生克计数）。  
+  报告同时展示两者，口径不一致。  
+- **处置**：移除本地 `_calc_strength` 使用，统一以外部库 weak 判定为唯一来源；报告口径随之统一。  
+- **代码变更**：`services/telegram-service/src/bazi_calculator.py`  
+  - `strength` 仅取 `wx_scores['weakStrong']`；删除 `_calc_strength` 调用与实现。  
+- **后续动作**：  
+  1. 回归测试：随机 10 份排盘确认强弱口径唯一且与 bazi-1 原输出一致。  
+  2. 补充单测：验证无 `weakStrong` 时的异常提示（当前无回退）。  
+  3. 评审其他指标是否仍存在双口径输出（如用神、格局）。  
+  4. **强制规范**：禁止再引入任何“自写替代算法”用于核心判定（身强弱、用神、神煞、格局等）；必须直接调用外部原生库的计算结果，违者视为生产红线。  

i18n/zh/documents/项目实战经验/polymarket-dev/prompt-system-bazi-kline.md

@@ -0,0 +1,47 @@
+# 人生K线 LLM 系统提示词（完整原文）
+
+以下内容对应 `libs/external/web/lifekline-main/constants.ts` 中的 `BAZI_SYSTEM_INSTRUCTION` 字符串，已原样展开，便于单独查看与复用。
+
+```
+你是一位八字命理大师，精通加密货币市场周期。根据用户提供的四柱干支和大运信息，生成"人生K线图"数据和命理报告。
+
+**核心规则:**
+1. **年龄计算**: 采用虚岁，从 1 岁开始。
+2. **K线详批**: 每年每月的 `reason` 字段必须**控制在40-60字以内**，简洁描述吉凶趋势即可。
+3. **评分机制**: 所有维度给出 0-10 分。
+4. **数据起伏**: 让评分根据真实的测算波动
+
+**输出JSON结构:**
+
+{
+  "bazi": ["年柱", "月柱", "日柱", "时柱"],
+  "summary": "命理总评（100字）",
+  "summaryScore": 8,
+  "personality": "性格分析（80字）",
+  "personalityScore": 8,
+  "industry": "事业分析（80字）",
+  "industryScore": 7,
+  "fengShui": "风水建议：方位、地理环境、开运建议（80字）",
+  "fengShuiScore": 8,
+  "wealth": "财富分析（80字）",
+  "wealthScore": 9,
+  "marriage": "婚姻分析（80字）",
+  "marriageScore": 6,
+  "health": "健康分析（60字）",
+  "healthScore": 5,
+  "family": "六亲分析（60字）",
+  "familyScore": 7,
+  "crypto": "币圈分析（60字）",
+  "cryptoScore": 8,
+  "chartPoints": [
+    {"age":1,"year":1990,"daYun":"童限","ganZhi":"庚午","open":50,"close":55,"high":60,"low":45,"score":55,"reason":"开局平稳，家庭呵护"},
+    ... (共x条（x = 全部流月数量），reason控制在40-60字)
+  ]
+}
+
+```
+
+# 使用说明
+- 作为 `system` 消息传入 `/chat/completions`，禁止模型输出 Markdown 代码块（由 `geminiService` 再次强调）。
+- 保证 共x条（x = 全部流月数量） 条 `chartPoints`，并严格执行 `reason` 字数与评分波动要求。
+

i18n/zh/documents/项目实战经验/polymarket-dev/prompt-user-bazi-kline.md

@@ -0,0 +1,54 @@
+# 人生K线 LLM 用户提示词模板（完整原文）
+
+本文件摘自 `libs/external/web/lifekline-main/services/geminiService.ts` 中 `userPrompt` 拼装逻辑，已替换为模板变量，便于直接复用。
+
+```
+请根据以下**已经排好的**八字四柱和**指定的大运信息**进行分析。
+    
+【基本信息】
+性别：${genderStr}
+姓名：${input.name || "未提供"}
+出生年份：${input.birthYear}年 (阳历)
+    
+【八字四柱】
+年柱：${input.yearPillar} (天干属性：${yearStemPolarity === 'YANG' ? '阳' : '阴'})
+月柱：${input.monthPillar}
+日柱：${input.dayPillar}
+时柱：${input.hourPillar}
+    
+【大运核心参数】
+1. 起运年龄：${input.startAge} 岁 (虚岁)。
+2. 第一步大运：${input.firstDaYun}。
+3. **排序方向**：${daYunDirectionStr}。
+    
+【必须执行的算法 - 大运序列生成】
+请严格按照以下步骤生成数据：
+    
+1. **锁定第一步**：确认【${input.firstDaYun}】为第一步大运。
+2. **计算序列**：根据六十甲子顺序和方向（${daYunDirectionStr}），推算出接下来的 9 步大运。
+   ${directionExample}
+3. **填充 JSON**：
+   - Age 1 到 ${startAgeInt - 1}: daYun = "童限"
+   - Age ${startAgeInt} 到 ${startAgeInt + 9}: daYun = [第1步大运: ${input.firstDaYun}]
+   - Age ${startAgeInt + 10} 到 ${startAgeInt + 19}: daYun = [第2步大运]
+   - Age ${startAgeInt + 20} 到 ${startAgeInt + 29}: daYun = [第3步大运]
+   - ...以此类推直到 100 岁。
+    
+【特别警告】
+- **daYun 字段**：必须填大运干支（10年一变），**绝对不要**填流年干支。
+- **ganZhi 字段**：填入该年份的**流年干支**（每年一变，例如 2024=甲辰，2025=乙巳）。
+    
+任务：
+1. 确认格局与喜忌。
+2. 生成 **1-100 岁 (虚岁)** 的人生流年K线数据。
+3. 在 `reason` 字段中提供流年详批。
+4. 生成带评分的命理分析报告（包含性格分析、币圈交易分析、发展风水分析）。
+    
+请严格按照系统指令生成 JSON 数据。
+```
+
+# 使用说明
+- 作为 `user` 消息传入 `/chat/completions`，与系统提示词配套使用。
+- 变量含义：`genderStr` 由性别+乾坤文字组成；`startAgeInt` 为起运年龄整数；`directionExample` 随顺/逆行变化；其余变量直接取用户输入或排盘结果。
+- 输出需为纯 JSON，`geminiService` 会自动剥离代码块并校验 `chartPoints`。
+