docs: update en/ documents with latest zh/ translations

- Update 00-fundamentals: Language Layer Elements, Glue Coding, Common Pitfalls, The Way of Programming, General Project Architecture Template
- Update 01-getting-started: all 4 guides
- Update 04-resources: Tool Collection, External Resource Aggregation
- Add fate-engine-dev practice examples
- Update all README.md files

Translated using Gemini CLI headless mode
This commit is contained in:
tukuaiai
2025-12-19 17:36:38 +08:00
parent 7ed780fc74
commit 2fba88ab60
23 changed files with 1621 additions and 1216 deletions
@@ -0,0 +1,48 @@
Here is the English translation:
# Life K-Line LLM System Prompt (Full Text)
The following content corresponds to the `BAZI_SYSTEM_INSTRUCTION` string in `libs/external/web/lifekline-main/constants.ts`, expanded as is for easy viewing and reuse.
```
你是一位八字命理大师,精通加密货币市场周期。根据用户提供的四柱干支和大运信息,生成"人生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字)
]
}
```
# Usage Instructions
- Pass as a `system` message to `/chat/completions`. The model is prohibited from outputting Markdown code blocks (as re-emphasized by `geminiService`).
- Ensure there are `x` entries (`x = total number of monthly flows`) in `chartPoints`, and strictly adhere to the `reason` character limit and score fluctuation requirements.
@@ -0,0 +1,55 @@
Here is the English translation of the provided text:
# Life Chart LLM User Prompt Template (Full Original Text)
This document is extracted from the `userPrompt` assembly logic in `libs/external/web/lifekline-main/services/geminiService.ts`, and has been replaced with template variables for direct reuse.
```
请根据以下**已经排好的**八字四柱和**指定的大运信息**进行分析。
【基本信息】
性别:${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 数据。
```
# Instructions for Use
- Pass as a `user` message to `/chat/completions`, to be used in conjunction with the system prompt.
- Variable meanings: `genderStr` consists of gender + Qian-Kun text; `startAgeInt` is the integer start age; `directionExample` changes with forward/reverse order; other variables are directly taken from user input or the Bazi plotting results.
- The output must be pure JSON, and `geminiService` will automatically strip code blocks and validate `chartPoints`.