refactor(i18n): 重构中文文档结构并同步更新链接

主要变更：

1.  **目录重命名**:
    *   将  下的 , ,  重命名为中文的 , , 。
2.  **新增新手入门**:
    *   创建  目录，为新用户提供入门指南。
3.  **文件迁移与清理**:
    *   将原有文档迁移到新的中文目录结构下。
    *   删除了部分过时或重复的中文文档。
4.  **链接与脚本同步**:
    *   更新了根 ,  以及  中所有指向旧路径的链接。
    *   修改了  下的英文文档，以反映中文文档的结构变化。
    *   更新了  翻译脚本，使其能够处理新的中文路径。

此次重构统一了中文文档的目录命名，使其更符合中文用户的习惯，并优化了整体文档的组织结构，提升了可维护性。

AGENTS.md

@@ -3,7 +3,7 @@
 ## Project Structure & Module Organization
 - 根目录：`README.md` 给出全貌，`Makefile` 封装日常命令，`CONTRIBUTING.md` 说明贡献流程，`LICENSE` 载明协议。保持根目录扁平，避免巨石文件。
 - 多语言 i18n：`i18n/<lang>/` 统一三层结构（documents / prompts / skills）。现有语言：中文 `zh`、英文 `en`、希伯来语 `he`，以及高频/常用的 `es`、`hi`、`ar`、`pt`、`ru`、`fr`、`de`、`ja`、`ko`、`it`、`tr`、`nl`、`pl`、`id`、`vi`、`th`、`fa`、`uk`、`bn`、`ta`、`ur`、`ms`、`sw`、`ha`；新增语言遵循同样层级。
-- 文档库：`i18n/zh/documents/` 仍是默认中文方法论入口（如 `i18n/zh/documents/Templates and Resources/代码组织.md` 等），新增语言文档按需在对应 `documents/` 下创建并保持同步。
+- 文档库：`i18n/zh/documents/` 仍是默认中文方法论入口（如 `i18n/zh/documents/模板与资源/代码组织.md` 等），新增语言文档按需在对应 `documents/` 下创建并保持同步。
 - 提示词资产：`i18n/zh/prompts/` 按角色拆分（system / assistant / coding / user），`libs/external/prompts-library/` 提供 Excel ↔ Markdown 互转工具与脚本目录，便于批量维护提示词，适合作为“单一真实来源”。
 - 代码与集成：`libs/` 预留核心实现骨架，`common/`、`database/`、`external/` 分别对应通用模型、存储适配与外部依赖登记；新增模块需保持分层边界与单一职责，避免跨层调用。
 - 备份：`backups/` 内含 `一键备份.sh` 与 `快速备份.py`，用于本地快照或同步，请先在隔离目录试跑，确认输出路径与权限。
@@ -18,7 +18,7 @@
 - 文字层：文档、注释、日志使用中文；代码符号（函数 / 变量 / 模块）统一英文且语义直白，避免晦涩缩写。
 - 缩进与排版：全仓保持空格缩进（2 或 4 空格任选其一但不得混用）；Markdown 列表、代码块与表格对齐清晰，行宽控制在 120 列内。Git diff 可读性优先。
 - 设计品味：优先消除分支与重复；函数力求单一职责且短小；命名遵循小写加中划线或下划线，不使用空格与特殊字符；跨模块接口保持稳定签名。
-- 依赖管理：新增工具或库时记录安装方式、最小版本与来源，必要时在 `i18n/zh/documents/Templates and Resources/工具集.md` 或 README 中补充，并说明为何需要它（性能、兼容、功能）。
+- 依赖管理：新增工具或库时记录安装方式、最小版本与来源，必要时在 `i18n/zh/documents/模板与资源/工具集.md` 或 README 中补充，并说明为何需要它（性能、兼容、功能）。
 
 ## Testing Guidelines
 - 当前无实测用例；引入代码时请至少提供最小可复现测试。推荐 Python 使用 `pytest`，文件命名 `test_*.py`，夹具精简可读，遵循 red-green-refactor 循环。

README.md

@@ -95,7 +95,7 @@
 
 该思想的核心是构建一个能够**自我优化**的 AI 系统。其递归本质可分解为以下步骤：
 
-> 延伸阅读：[A Formalization of Recursive Self-Optimizing Generative Systems](./i18n/zh/documents/Methodology%20and%20Principles/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)
+> 延伸阅读：[A Formalization of Recursive Self-Optimizing Generative Systems](./i18n/zh/documents/方法论与原则/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)
 
 #### 1. 定义核心角色：
 
@@ -199,10 +199,10 @@
 *   [**第三方系统提示词学习库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): 用于学习和参考其他 AI 工具的系统提示词。
 *   [**Skills 制作器**](https://github.com/yusufkaraaslan/Skill_Seekers): 可根据需求生成定制化 Skills 的工具。
 *   [**元提示词**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词。
-*   [**通用项目架构模板**](./i18n/zh/documents/Templates%20and%20Resources/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。
+*   [**通用项目架构模板**](./i18n/zh/documents/模板与资源/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。
 *   [**元技能：Skills 的 Skills**](./i18n/zh/skills/claude-skills/SKILL.md): 用于生成 Skills 的元技能。
-*   [**tmux快捷键大全**](./i18n/zh/documents/Tutorials%20and%20Guides/tmux快捷键大全.md): tmux 的快捷键参考文档。
-*   [**LazyVim快捷键大全**](./i18n/zh/documents/Tutorials%20and%20Guides/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
+*   [**tmux快捷键大全**](./i18n/zh/documents/教程与指南/tmux快捷键大全.md): tmux 的快捷键参考文档。
+*   [**LazyVim快捷键大全**](./i18n/zh/documents/教程与指南/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
 *   [**二哥的Java进阶之路**](https://javabetter.cn/): 包含多种开发工具的详细配置教程。
 *   [**虚拟卡**](https://www.bybit.com/cards/?ref=YDGAVPN&source=applet_invite): 可用于注册云服务等需要国际支付的场景。
 
@@ -224,8 +224,8 @@
     *   [Telegram 交流群](https://t.me/glue_coding)
     *   [Telegram 频道](https://t.me/tradecat_ai_channel)
 *   **个人分享**:
-    *   [我的学习经验](./i18n/zh/documents/Methodology%20and%20Principles/学习经验.md)
-    *   [编程书籍推荐](./i18n/zh/documents/Templates%20and%20Resources/编程书籍推荐.md)
+    *   [我的学习经验](./i18n/zh/documents/方法论与原则/学习经验.md)
+    *   [编程书籍推荐](./i18n/zh/documents/模板与资源/编程书籍推荐.md)
 *   **核心资源**:
     *   [**元提示词库**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词集合。
     *   [**元技能 (Meta-Skill)**](./i18n/zh/skills/claude-skills/SKILL.md): 用于生成 Skills 的 Skill。
@@ -236,10 +236,10 @@
 *   **项目内部文档**:
     *   [**prompts-library 工具说明**](./libs/external/prompts-library/): 该工具支持在 Excel 和 Markdown 格式之间转换提示词，并包含数百个精选提示词。
     *   [**coding_prompts 集合**](./i18n/zh/prompts/coding_prompts/): 适用于 Vibe Coding 流程的专用提示词。
-    *   [**系统提示词构建原则**](./i18n/zh/documents/Methodology%20and%20Principles/系统提示词构建原则.md): 关于如何构建高效、可靠的 AI 系统提示词的综合指南。
-    *   [**开发经验总结**](./i18n/zh/documents/Methodology%20and%20Principles/开发经验.md): 包含变量命名、文件结构、编码规范、架构原则等实践经验。
-    *   [**通用项目架构模板**](./i18n/zh/documents/Templates%20and%20Resources/通用项目架构模板.md): 提供多种项目类型的标准目录结构与最佳实践。
-    *   [**Augment MCP 配置文档**](./i18n/zh/documents/Tutorials%20and%20Guides/auggie-mcp配置文档.md): Augment 上下文引擎的详细配置说明。
+    *   [**系统提示词构建原则**](./i18n/zh/documents/方法论与原则/系统提示词构建原则.md): 关于如何构建高效、可靠的 AI 系统提示词的综合指南。
+    *   [**开发经验总结**](./i18n/zh/documents/方法论与原则/开发经验.md): 包含变量命名、文件结构、编码规范、架构原则等实践经验。
+    *   [**通用项目架构模板**](./i18n/zh/documents/模板与资源/通用项目架构模板.md): 提供多种项目类型的标准目录结构与最佳实践。
+    *   [**Augment MCP 配置文档**](./i18n/zh/documents/教程与指南/auggie-mcp配置文档.md): Augment 上下文引擎的详细配置说明。
     *   [**system_prompts 集合**](./i18n/zh/prompts/system_prompts/): 用于指导 AI 开发的系统提示词，包含多个版本的开发规范与思维框架。
 
 ---
@@ -261,9 +261,9 @@
 ├── CLAUDE.md                    # AI 助手的核心行为准则或配置。
 │
 ├── i18n/zh/documents/           # 存放各类说明文档、经验总结和配置详细说明。
-│   ├── Methodology and Principles/ # 方法论与原则
-│   ├── Templates and Resources/    # 模板与资源
-│   └── Tutorials and Guides/       # 教程与指南
+│   ├── 方法论与原则/                # 方法论与原则
+│   ├── 模板与资源/                  # 模板与资源
+│   └── 教程与指南/                  # 教程与指南
 │
 ├── libs/                        # 通用库代码，用于项目内部模块化。
 │   ├── common/                  # 通用功能模块。
@@ -323,7 +323,7 @@ i18n/zh/prompts/
   assistant_prompts/     # 辅助/配合型提示
   user_prompts/          # 可复用的用户侧提示词
 i18n/zh/documents/
-  Templates and Resources/代码组织.md, Templates and Resources/通用项目架构模板.md, Methodology and Principles/开发经验.md, Methodology and Principles/系统提示词构建原则.md 等知识库
+  模板与资源/代码组织.md, 模板与资源/通用项目架构模板.md, 方法论与原则/开发经验.md, 方法论与原则/系统提示词构建原则.md 等知识库
 backups/
   一键备份.sh, 快速备份.py  # 本地/远端快照脚本
 ```
@@ -428,7 +428,15 @@ gantt
 
 ---
 
-## 🚀 入门指南（这里是原作者的，不是我写的，我更新了一下我认为最好的模型）
+## 🚀 入门指南
+
+### 🆕 完全新手？从这里开始！
+
+1. [01-网络环境配置](./i18n/zh/documents/从零开始vibecoding/01-网络环境配置.md) - 配置网络访问
+2. [02-开发环境搭建](./i18n/zh/documents/从零开始vibecoding/02-开发环境搭建.md) - 复制提示词给 AI，让 AI 指导你搭建环境
+
+### 已有开发环境？
+
 要开始 Vibe Coding，你只需要以下两种工具之一：
 - **Claude Opus 4.5**，在 Claude Code 中使用
 - **gpt-5.1-codex.1-codex (xhigh)**，在 Codex CLI 中使用

i18n/en/documents/README.md

@@ -1,9 +1,8 @@
-TRANSLATED CONTENT:
-# 📖 文档库 (Documents)
+# 📖 Document Library (Documents)
 
-`i18n/zh/documents/` 目录汇总项目的流程文档、架构说明、开发经验与最佳实践，是理解方法论与协作规则的首选入口。
+The `i18n/zh/documents/` directory summarizes project process documents, architecture descriptions, development experiences, and best practices, serving as the primary entry point for understanding methodologies and collaboration rules.
 
-## 目录结构
+## Directory Structure
 
 ```
 i18n/zh/documents/
@@ -12,69 +11,69 @@ i18n/zh/documents/
 ├── Methodology and Principles/
 │   ├── A Formalization of Recursive Self-Optimizing Generative Systems.md
 │   ├── gluecoding.md
-│   ├── vibe-coding-经验收集.md
-│   ├── 学习经验.md
-│   ├── 开发经验.md
-│   ├── 编程之道.md
-│   ├── 胶水编程.md
-│   └── 系统提示词构建原则.md
+│   ├── vibe-coding-Experience_Collection.md
+│   ├── Learning_Experience.md
+│   ├── Development_Experience.md
+│   ├── The_Way_of_Programming.md
+│   ├── Glue_Programming.md
+│   └── System_Prompt_Construction_Principles.md
 │
 ├── Tutorials and Guides/
-│   ├── auggie-mcp配置文档.md
-│   ├── LazyVim快捷键大全.md
-│   ├── tmux快捷键大全.md
-│   ├── 关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md
+│   ├── auggie-mcp_Configuration_Document.md
+│   ├── LazyVim_Shortcut_Cheatsheet.md
+│   ├── tmux_Shortcut_Cheatsheet.md
+│   ├── Method_for_SSH_Linking_Mobile_Phone_to_Local_Computer_Anywhere_Based_on_FRP_Implementation.md
 │   └── telegram-dev/
 │
 └── Templates and Resources/
-    ├── 代码组织.md
-    ├── 工具集.md
-    ├── 编程书籍推荐.md
-    └── 通用项目架构模板.md
+    ├── Code_Organization.md
+    ├── Tool_Set.md
+    ├── Recommended_Programming_Books.md
+    └── General_Project_Architecture_Template.md
 ```
 
-## 文档分类
+## Document Classification
 
 ### Methodology and Principles
 
-此类别存放关于编程思想、开发哲学和项目核心原则的文档。
+This category contains documents about programming philosophy, development philosophy, and core project principles.
 
 *   `A Formalization of Recursive Self-Optimizing Generative Systems.md`
 *   `gluecoding.md`
-*   `vibe-coding-经验收集.md`
-*   `学习经验.md`
-*   `开发经验.md`
-*   `编程之道.md`
-*   `胶水编程.md`
-*   `系统提示词构建原则.md`
+*   `vibe-coding-Experience_Collection.md`
+*   `Learning_Experience.md`
+*   `Development_Experience.md`
+*   `The_Way_of_Programming.md`
+*   `Glue_Programming.md`
+*   `System_Prompt_Construction_Principles.md`
 
 ### Tutorials and Guides
 
-此类别存放具体工具的配置、使用指南和操作教程。
+This category contains configuration, usage guides, and operation tutorials for specific tools.
 
-*   `auggie-mcp配置文档.md`
-*   `LazyVim快捷键大全.md`
-*   `tmux快捷键大全.md`
-*   `关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md`
+*   `auggie-mcp_Configuration_Document.md`
+*   `LazyVim_Shortcut_Cheatsheet.md`
+*   `tmux_Shortcut_Cheatsheet.md`
+*   `Method_for_SSH_Linking_Mobile_Phone_to_Local_Computer_Anywhere_Based_on_FRP_Implementation.md`
 *   `telegram-dev/`
 
 ### Templates and Resources
 
-此类别存放可复用的项目模板、代码结构规范和资源列表。
+This category contains reusable project templates, code structure specifications, and resource lists.
 
-*   `代码组织.md`
-*   `工具集.md`
-*   `编程书籍推荐.md`
-*   `通用项目架构模板.md`
+*   `Code_Organization.md`
+*   `Tool_Set.md`
+*   `Recommended_Programming_Books.md`
+*   `General_Project_Architecture_Template.md`
 
-## 贡献新文档
+## Contribute New Documents
 
-1.  将文档放置在最合适的分类目录中。
-2.  如果需要，可以创建新的分类目录。
-3.  更新本 README 文件以反映变更。
+1.  Place documents in the most appropriate category directory.
+2.  Create new category directories if needed.
+3.  Update this README file to reflect changes.
 
-## 相关资源
+## Related Resources
 
-- [提示词库](../prompts/) - AI 提示词集合
-- [技能库](../skills/) - AI Skills 技能
-- [通用库](../libs/) - 工具与外部集成
+- [Prompt Library](../prompts/) - AI Prompt Collection
+- [Skill Library](../skills/) - AI Skills
+- [General Library](../libs/) - Tools and External Integrations

i18n/en/documents/Templates and Resources/General_Project_Architecture_Template.md

@@ -1,461 +1,71 @@
-TRANSLATED CONTENT:
-# 通用项目架构模板
-
-## 1️⃣ Python Web/API 项目标准结构
-
-```
-项目名称/
-├── README.md                 # 项目说明文档
-├── LICENSE                   # 开源协议
-├── requirements.txt          # 依赖管理（pip）
-├── pyproject.toml           # 现代Python项目配置（推荐）
-├── setup.py                 # 包安装脚本（如果做成库）
-├── .gitignore              # Git忽略文件
-├── .env                    # 环境变量（不提交到Git）
-├── .env.example            # 环境变量示例
-├── CLAUDE.md              # claude持久上下文
-├── AGENTS.md              # codex持久上下文
-├── Sublime-Text.txt                   # 放需求和注意事项，给自己看的，和cli的会话恢复指令^_^
-│
-├── docs/                   # 文档目录
-│   ├── api.md             # API文档
-│   ├── development.md     # 开发指南
-│   └── architecture.md    # 架构说明
-│
-├── scripts/               # 脚本工具
-│   ├── deploy.sh          # 部署脚本
-│   ├── backup.sh          # 备份脚本
-│   └── init_db.sh         # 数据库初始化
-│
-├── tests/                 # 测试代码
+# General Project Architecture Template
+
+## 1️⃣ Standard Structure for Python Web/API Projects
+
+```
+ProjectName/
+├── README.md                 # Project description document
+├── LICENSE                   # Open-source license
+├── requirements.txt          # Dependency management (pip)
+├── pyproject.toml           # Modern Python project configuration (recommended)
+├── setup.py                 # Package installation script (if used as a library)
+├── .gitignore              # Git ignore file
+├── .env                    # Environment variables (not committed to Git)
+├── .env.example            # Example environment variables
+├── CLAUDE.md              # Claude persistent context
+├── AGENTS.md              # Codex persistent context
+├── Sublime-Text.txt                   # For demands and notes, for myself, and CLI session recovery commands ^_^
+│
+├── docs/                   # Documentation directory
+│   ├── api.md             # API documentation
+│   ├── development.md     # Development guide
+│   └── architecture.md    # Architecture description
+│
+├── scripts/               # Script tools
+│   ├── deploy.sh          # Deployment script
+│   ├── backup.sh          # Backup script
+│   └── init_db.sh         # Database initialization
+│
+├── tests/                 # Test code
 │   ├── __init__.py
-│   ├── conftest.py        # pytest配置
-│   ├── unit/              # 单元测试
-│   ├── integration/       # 集成测试
-│   └── test_config.py     # 配置测试
+│   ├── conftest.py        # Pytest configuration
+│   ├── unit/              # Unit tests
+│   ├── integration/       # Integration tests
+│   └── test_config.py     # Configuration tests
 │
-├── src/                   # 源代码（推荐方式）
+├── src/                   # Source code (recommended)
 │   ├── __init__.py
-│   ├── main.py           # 程序入口
-│   ├── app.py            # Flask/FastAPI应用
-│   ├── config.py         # 配置管理
+│   ├── main.py           # Program entry point
+│   ├── app.py            # Flask/FastAPI application
+│   ├── config.py         # Configuration management
 │   │
-│   ├── core/             # 核心业务逻辑
+│   ├── core/             # Core business logic
 │   │   ├── __init__.py
-│   │   ├── models/       # 数据模型
-│   │   ├── services/     # 业务服务
-│   │   └── utils/        # 工具函数
+│   │   ├── models/       # Data models
+│   │   ├── services/     # Business services
+│   │   └── utils/        # Utility functions
 │   │
-│   ├── api/              # API接口层
+│   ├── api/              # API interface layer
 │   │   ├── __init__.py
-│   │   ├── v1/           # 版本1
+│   │   ├── v1/           # Version 1
 │   │   └── dependencies.py
 │   │
-│   ├── data/             # 数据处理
+│   ├── data/             # Data processing
 │   │   ├── __init__.py
-│   │   ├── repository/   # 数据访问层
-│   │   └── migrations/   # 数据库迁移
+│   │   ├── repository/   # Data access layer
+│   │   └── migrations/   # Database migrations
 │   │
-│   └── external/         # 外部服务
+│   └── external/         # External services
 │       ├── __init__.py
-│       ├── clients/      # API客户端
-│       └── integrations/ # 集成服务
+│       ├── clients/      # API clients
+│       └── integrations/ # Integration services
 │
-├── logs/                  # 日志目录（不提交到Git）
+├── logs/                  # Log directory (not committed to Git)
 │   ├── app.log
 │   └── error.log
 │
-└── data/                  # 数据目录（不提交到Git）
-    ├── raw/               # 原始数据
-    ├── processed/         # 处理后的数据
-    └── cache/             # 缓存
-```
-
-**使用场景**：Flask/FastAPI Web应用、RESTful API服务、Web后端
-
----
-
-## 2️⃣ 数据科学/量化项目标准结构
-
-```
-项目名称/
-├── README.md
-├── LICENSE
-├── requirements.txt
-├── .gitignore
-├── .env
-├── .env.example
-├── CLAUDE.md              # claude持久上下文
-├── AGENTS.md              # codex持久上下文
-├── Sublime-Text.txt                   # 放需求和注意事项，给自己看的，和cli的会话恢复指令^_^
-│
-├── docs/                   # 文档目录
-│   ├── notebooks/         # Jupyter文档
-│   └── reports/           # 分析报告
-│
-├── notebooks/             # Jupyter Notebook
-│   ├── 01_data_exploration.ipynb
-│   ├── 02_feature_engineering.ipynb
-│   └── 03_model_training.ipynb
-│
-├── scripts/               # 脚本工具
-│   ├── train_model.py     # 训练脚本
-│   ├── backtest.py        # 回测脚本
-│   ├── collect_data.py    # 数据采集
-│   └── deploy_model.py    # 模型部署
-│
-├── tests/                 # 测试
-│   ├── test_data/
-│   └── test_models/
-│
-├── configs/               # 配置文件
-│   ├── model.yaml
-│   ├── database.yaml
-│   └── trading.yaml
-│
-├── src/                   # 源代码
-│   ├── __init__.py
-│   │
-│   ├── data/              # 数据处理模块
-│   │   ├── __init__.py
-│   │   ├── collectors/    # 数据采集器
-│   │   ├── processors/    # 数据清洗
-│   │   ├── features/      # 特征工程
-│   │   └── loaders.py     # 数据加载
-│   │
-│   ├── models/            # 模型模块
-│   │   ├── __init__.py
-│   │   ├── strategies/    # 交易策略
-│   │   ├── backtest/      # 回测引擎
-│   │   └── risk/          # 风险管理
-│   │
-│   ├── utils/             # 工具模块
-│   │   ├── __init__.py
-│   │   ├── logging.py     # 日志配置
-│   │   ├── database.py    # 数据库工具
-│   │   └── api_client.py  # API客户端
-│   │
-│   └── core/              # 核心模块
-│       ├── __init__.py
-│       ├── config.py      # 配置管理
-│       ├── signals.py     # 信号生成
-│       └── portfolio.py   # 投资组合
-│
-├── data/                  # 数据目录（Git忽略）
-│   ├── raw/               # 原始数据
-│   ├── processed/         # 处理后数据
-│   ├── external/          # 外部数据
-│   └── cache/             # 缓存
-│
-├── models/                # 模型文件（Git忽略）
-│   ├── checkpoints/       # 检查点
-│   └── exports/           # 导出模型
-│
-└── logs/                  # 日志（Git忽略）
-    ├── trading.log
-    └── errors.log
-```
-
-**使用场景**：量化交易、机器学习、数据分析、AI研究
-
----
-
-## 3️⃣ Monorepo（多项目仓库）标准结构
-
-```
-项目名称-monorepo/
-├── README.md
-├── LICENSE
-├── .gitignore
-├── .gitmodules           # Git子模块
-├── docker-compose.yml    # Docker编排
-├── CLAUDE.md              # claude持久上下文
-├── AGENTS.md              # codex持久上下文
-├── Sublime-Text.txt                   # 这个是文件，放需求和注意事项，给自己看的，和cli的会话恢复指令^_^
-│
-├── docs/                 # 全局文档
-│   ├── architecture.md
-│   └── deployment.md
-│
-├── scripts/              # 全局脚本
-│   ├── build_all.sh
-│   ├── test_all.sh
-│   └── deploy.sh
-│
-├── backups/                 #  放备份文件
-│   ├── archive/             #  放旧的备份文件
-│   └── gz/                  #  放备份文件的gz
-│
-├── services/             # 微服务目录
-│   │
-│   ├── user-service/     # 用户服务
-│   │   ├── Dockerfile
-│   │   ├── requirements.txt
-│   │   ├── src/
-│   │   └── tests/
-│   │
-│   ├── trading-service/  # 交易服务
-│   │   ├── Dockerfile
-│   │   ├── requirements.txt
-│   │   ├── src/
-│   │   └── tests/
-│   ...
-│   └── data-service/     # 数据服务
-│       ├── Dockerfile
-│       ├── requirements.txt
-│       ├── src/
-│       └── tests/
-│
-├── libs/                 # 共享库
-│   ├── common/           # 公共模块
-│   │   ├── utils/
-│   │   └── models/
-│   ├── external/         # 第三方库（不可修改，只调用）
-│   └── database/         # 数据库访问库
-│
-├── infrastructure/       # 基础设施
-│   ├── terraform/        # 云资源定义
-│   ├── kubernetes/       # K8s配置
-│   └── nginx/            # 反向代理配置
-│
-└── monitoring/           # 监控系统
-    ├── prometheus/       # 指标收集
-    ├── grafana/          # 可视化
-    └── alertmanager/     # 告警
-```
-
-**使用场景**：微服务架构、大型项目、团队协作
-
----
-
-## 4️⃣ Full-Stack Web 应用标准结构
-
-```
-项目名称/
-├── README.md
-├── LICENSE
-├── .gitignore
-├── docker-compose.yml    # 前后端一起编排
-├── CLAUDE.md              # claude持久上下文
-├── AGENTS.md              # codex持久上下文
-├── Sublime-Text.txt                   # 放需求和注意事项，给自己看的，和cli的会话恢复指令^_^
-│
-├── frontend/             # 前端目录
-│   ├── public/           # 静态资源
-│   ├── src/              # 源码
-│   │   ├── components/   # React/Vue组件
-│   │   ├── pages/        # 页面
-│   │   ├── store/        # 状态管理
-│   │   └── utils/        # 工具
-│   ├── package.json      # NPM依赖
-│   └── vite.config.js    # 构建配置
-│
-└── backend/              # 后端目录
-    ├── requirements.txt
-    ├── Dockerfile
-    ├── src/
-    │   ├── api/          # API接口
-    │   ├── core/         # 业务逻辑
-│   │   └── models/       # 数据模型
-    └── tests/
-```
-
-**使用场景**：全栈应用、SPA单页应用、前后端分离项目
-
----
-
-## 📌 核心设计原则
-
-### 1. 关注点分离（Separation of Concerns）
-```
-API → 服务 → 数据访问 → 数据库
-一目了然，层级清晰
-```
-
-### 2. 可测试性（Testability）
-```
-每个模块可独立测试
-依赖可mock
-```
-
-### 3. 可配置性（Configurability）
-```
-配置与代码分离
-环境变量 > 配置文件 > 默认值
-```
-
-### 4. 可维护性（Maintainability）
-```
-代码自解释
-合理的文件命名
-清晰的目录结构
-```
-
-### 5. 版本控制友好（Git-Friendly）
-```
-data/、logs/、models/ 添加到 .gitignore
-只提交源代码和配置示例
-```
-
----
-
-## 🎯 最佳实践建议
-
-1. **使用 `src/` 目录**：把源代码放在专门的src目录，避免顶级目录混乱
-2. **相对导入**：统一使用 `from src.module import thing` 的导入方式
-3. **测试覆盖**：保证核心业务逻辑有单元测试和集成测试
-4. **文档先行**：重要模块都要写README.md说明
-5. **环境隔离**：使用virtualenv或conda创建独立环境
-6. **依赖明确**：所有依赖都写入requirements.txt，并锁定版本
-7. **配置管理**：使用环境变量 + 配置文件的组合方式
-8. **日志分级**：DEBUG、INFO、WARNING、ERROR、FATAL
-9. **错误处理**：不要吞掉异常，要有完整的错误链
-10. **代码规范**：使用black格式化，flake8检查
-
----
-
-## 🔥 .gitignore 推荐模板
-
-```gitignore
-# Python
-__pycache__/
-*.py[cod]
-*$py.class
-*.so
-.Python
-*.egg-info/
-dist/
-build/
-
-# 环境
-.env
-.venv/
-env/
-venv/
-ENV/
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-
-# 数据
-data/
-*.csv
-*.json
-*.db
-*.sqlite
-*.duckdb
-
-# 日志
-logs/
-*.log
-
-# 模型
-models/
-*.h5
-*.pkl
-
-# 临时文件
-tmp/
-temp/
-*.tmp
-.DS_Store
-```
-
----
-
-## 📚 技术选型参考
-
-| 场景 | 推荐技术栈 |
-|-----|----------|
-| Web API | FastAPI + Pydantic + SQLAlchemy |
-| 数据处理 | Pandas + NumPy + Polars |
-| 机器学习 | Scikit-learn + XGBoost + LightGBM |
-| 深度学习 | PyTorch + TensorFlow |
-| 数据库 | PostgreSQL + Redis |
-| 消息队列 | RabbitMQ / Kafka |
-| 任务队列 | Celery |
-| 监控 | Prometheus + Grafana |
-| 部署 | Docker + Docker Compose |
-| CI/CD | GitHub Actions / GitLab CI |
-
----
-
-## 📝 文件模板示例
-
-### requirements.txt
-```txt
-# 核心依赖
-fastapi==0.104.1
-uvicorn[standard]==0.24.0
-pydantic==2.5.0
-
-# 数据库
-sqlalchemy==2.0.23
-alembic==1.12.1
-psycopg2-binary==2.9.9
-
-# 测试
-pytest==7.4.3
-pytest-cov==4.1.0
-pytest-asyncio==0.21.1
-
-# 工具
-python-dotenv==1.0.0
-loguru==0.7.2
-
-# 开发（可选）
-black==23.11.0
-flake8==6.1.0
-mypy==1.7.1
-```
-
-### pyproject.toml（现代Python项目推荐）
-```toml
-[project]
-name = "项目名称"
-version = "0.1.0"
-description = "项目描述"
-authors = [{name = "作者", email = "邮箱@example.com"}]
-dependencies = [
-    "fastapi>=0.104.0",
-    "uvicorn[standard]>=0.24.0",
-    "sqlalchemy>=2.0.0",
-]
-
-[project.optional-dependencies]
-dev = ["pytest", "black", "flake8", "mypy"]
-
-[build-system]
-requires = ["setuptools", "wheel"]
-build-backend = "setuptools.build_meta"
-```
-
----
-
-## ✅ 新项目检查清单
-
-启动新项目时，确保完成以下事项：
-
-- [ ] 创建README.md，包含项目简介和使用说明
-- [ ] 创建LICENSE文件，明确开源协议
-- [ ] 设置Python虚拟环境（venv/conda）
-- [ ] 创建requirements.txt并锁定依赖版本
-- [ ] 创建.gitignore，排除敏感和不必要的文件
-- [ ] 创建.env.example，说明需要的环境变量
-- [ ] 设计目录结构，符合关注点分离原则
-- [ ] 创建基础的配置文件
-- [ ] 设置代码格式化工具（black）
-- [ ] 设置代码检查工具（flake8/ruff）
-- [ ] 编写第一个测试用例
-- [ ] 设置Git仓库并提交初始代码
-- [ ] 创建CHANGELOG.md，记录版本变更
-
----
-
-**版本**: 1.0
-**更新日期**: 2025-11-24
-**维护**: CLAUDE，CODEX，KIMI
+└── data/                  # Data directory (not committed to Git)
+    ├── raw/               # Raw data
+    ├── processed/         # Processed data
+    └── cache/             # Cache
+```

i18n/en/documents/Templates and Resources/Recommended_Programming_Books.md

@@ -1,152 +1,151 @@
-TRANSLATED CONTENT:
-# z-lib 里面全部都可以免费下载
+# All available for free download on z-lib
 
-从零开始大模型开发与微调：基于PyTorch与ChatGLM - 王晓华
+From Zero to Large Model Development and Fine-tuning: Based on PyTorch and ChatGLM - Wang Xiaohua
 
-编程的原则：改善代码质量的101个方法 - 上田勋
+The Principles of Programming: 101 Ways to Improve Code Quality - Isao Ueda
 
-生成式 AI 设计模式 - Valliappa Lakshmanan & Hannes Hapke
+Generative AI Design Patterns - Valliappa Lakshmanan & Hannes Hapke
 
-人月神话 - 弗雷德里克·布鲁克斯
+The Mythical Man-Month - Frederick Brooks
 
-人件（原书第3版） - Tom DeMarco & Timothy Lister
+Peopleware (3rd Edition) - Tom DeMarco & Timothy Lister
 
-高效程序员的45个习惯：敏捷开发修炼之道 - Andy Hunt & Venkat Subramaniam
+The 45 Habits of Highly Effective Programmers: Agile Development Practice - Andy Hunt & Venkat Subramaniam
 
-项目管理修炼之道 - 罗斯曼
+The Art of Project Management Practice - Rothman
 
-编程珠玑（续） - 乔恩·本特利
+Programming Pearls (Continued) - Jon Bentley
 
-编程珠玑（第2版） - 乔恩·本特利
+Programming Pearls (2nd Edition) - Jon Bentley
 
-编程原则：来自代码大师Max Kanat-Alexander的建议（让简约设计的思想回归到计算机编程，适合软件开发者、开发团队管理者和软件相关专业学生阅读） （华章程序员书库） - Max Kanat-Alexande
+Programming Principles: Advice from Code Master Max Kanat-Alexander (Bringing the idea of minimalist design back to computer programming, suitable for software developers, development team managers, and students majoring in software-related fields) (Huazhang Programmer Library) - Max Kanat-Alexander
 
-编写可读代码的艺术 - Dustin Boswell & Trevor Foucher
+The Art of Readable Code - Dustin Boswell & Trevor Foucher
 
-统计思维：程序员数学之概率统计（第2版） - Allen B.Downey
+Statistical Thinking: Probability and Statistics for Programmers (2nd Edition) - Allen B. Downey
 
-精通Rust（第2版） - Rahul Sharma & Vesa Kaihlavirta
+Mastering Rust (2nd Edition) - Rahul Sharma & Vesa Kaihlavirta
 
-程序员超强大脑（图灵程序设计丛书·程序员修炼系列） - 费莉安·赫尔曼斯
+Programmer's Super Brain (Turing Programming Series: Programmer's Cultivation Series) - Felian Hermans
 
-程序员必读之软件架构 - Simon Brown
+Software Architecture for Programmers - Simon Brown
 
-程序员修炼之道：专业程序员必知的33个技巧 - Josh·Carter
+The Pragmatic Programmer: Thirty-three Tips for Professional Developers - Josh Carter
 
-看漫画学Python：有趣、有料、好玩、好用 - 关东升
+Learn Python with Comics: Fun, Informative, Interesting, and Useful - Guan Dongsheng
 
-混沌工程：通过可控故障实验提升软件系统可靠性 - 米科拉吉·帕利科夫斯基_1
+Chaos Engineering: Improving Software System Reliability Through Controlled Fault Experiments - Mikolaj Palikowski_1
 
-深入理解Python特性 - 达恩·巴德尔
+Deep Dive into Python Features - Dann Bader
 
-微服务实战（覆盖从微服务设计到部署的各个阶段的技术实战书）（异步图书） - 摩根·布鲁斯 & 保罗·A·佩雷拉
+Microservices in Action (A practical book covering technical practices from microservice design to deployment) (Async Books) - Morgan Bruce & Paul A. Pereira
 
-大数据系统构建：可扩展实时数据系统构建原理与最佳实践 - NathanMarz & JamesWarren
+Building Big Data Systems: Principles and Best Practices for Building Scalable Real-time Data Systems - Nathan Marz & James Warren
 
-图解性能优化（图灵程序设计丛书） - 小田圭二 & 榑松谷仁 & 平山毅 & 冈田宪昌
+Illustrated Performance Optimization (Turing Programming Series) - Keiji Oda & Jin Kurematsutani & Takeshi Hirayama & Norichika Okada
 
-图灵程序设计丛书：大规模数据处理入门与实战（套装全10册）【图灵出品！一套囊括SQL、Python、Spark、Hadoop、妮哈·纳克海德 & 格温·沙皮拉托德 & 帕利诺 & 本杰明·班福特 & 珍妮·基姆 & 埃伦·弗里德曼 & 科斯塔斯·宙马斯
+Turing Programming Series: Large-Scale Data Processing Introduction and Practice (Set of 10 Books) [Turing Edition! A set encompassing SQL, Python, Spark, Hadoop, Neha Narkhede & Gwen Shapira Todd & Palino & Benjamin Banford & Jenny Kim & Ellen Friedman & Kostas Tzoumas
 
-代码整洁之道 - Robert C. Martin
+Clean Code - Robert C. Martin
 
-代码之髓：编程语言核心概念（图灵程序设计丛书） - 西尾泰和
+The Essence of Code: Core Concepts of Programming Languages (Turing Programming Series) - Taiwa Nishio
 
-人人都懂设计模式：从生活中领悟设计模式 - 罗伟富
+Design Patterns for Everyone: Understanding Design Patterns from Real Life - Luo Weifu
 
-Rust权威指南（第2版） - Steve Klabnik & Carol Nichols
+The Rust Programming Language (2nd Edition) - Steve Klabnik & Carol Nichols
 
-Python金融大数据分析（第2版） - 伊夫·希尔皮斯科
+Python for Financial Big Data Analysis (2nd Edition) - Yves Hilpisch
 
-Python科学计算基础教程 - Hemant Kumar Mehta_1
+Python Scientific Computing Fundamentals Tutorial - Hemant Kumar Mehta_1
 
-Python数据挖掘入门与实践 - Robert Layton
+Python Data Mining Introduction and Practice - Robert Layton
 
-Python数据分析与算法指南（套装共8册） - 江雪松 & 邹静 & 邓立国 & 翟锟 & 胡锋 & 周晓然 & 王国平 & 白宁超 & 唐聃 & 文俊 & 张若愚 & 洪锦魁
+Python Data Analysis and Algorithm Guide (Set of 8 Books) - Jiang Songsong & Zou Jing & Deng Liguo & Zhai Kun & Hu Feng & Zhou Xiaoran & Wang Guoping & Bai Ningchao & Tang Dan & Wen Jun & Zhang Ruoyu & Hong Jinkui
 
-Python性能分析与优化 - Fernando Doglio
+Python Performance Analysis and Optimization - Fernando Doglio
 
-Python函数式编程（第2版）（图灵图书） - 史蒂文·洛特_1
+Python Functional Programming (2nd Edition) (Turing Books) - Steven Lott_1
 
-GPT时代的量化交易：底层逻辑与技术实践 - 罗勇 & 卢洪波_1
+Quantitative Trading in the GPT Era: Underlying Logic and Technical Practice - Luo Yong & Lu Hongbo_1
 
-ChatGPT数据分析实践 - 史浩然 & 赵辛 & 吴志成
+ChatGPT Data Analysis Practice - Shi Haoran & Zhao Xin & Wu Zhicheng
 
-AI时代Python金融大数据分析实战：ChatGPT让金融大数据分析插上翅膀 - 关东升
+AI Era Python Financial Big Data Analysis Practice: ChatGPT Makes Financial Big Data Analysis Soar - Guan Dongsheng
 
-跨市场交易策略 - John J. Murphy
+Cross-Market Trading Strategies - John J. Murphy
 
-资产定价与机器学习 - 吴轲
+Asset Pricing and Machine Learning - Wu Ke
 
-工程思维 - 马克 N. 霍伦斯坦
+Engineering Thinking - Marc N. Holenstein
 
-程序员的思维修炼：开发认知潜能的九堂课（图灵程序设计丛书） - Andy Hunt
+The Programmer's Brain: Develop Cognitive Potential with Nine Lessons (Turing Programming Series) - Andy Hunt
 
-程序员修炼之道：通向务实的最高境界（第2版）【这本书颠覆了无数人的软件生涯！并推动整个IT行业走到今天！时隔20年的再版重磅来袭！】 -  大卫·托马斯 & 安德鲁·亨特
+The Pragmatic Programmer: Your Journey to Mastery (2nd Edition) [This book has revolutionized countless software careers! And propelled the entire IT industry to where it is today! A heavy-hitting re-release after 20 years!] - David Thomas & Andrew Hunt
 
-不确定状况下的判断：启发式和偏差 - 丹尼尔·卡尼曼
+Thinking, Fast and Slow (original: Judgment Under Uncertainty: Heuristics and Biases) - Daniel Kahneman
 
-简约之美：软件设计之道 - Max Kanant-Alexander
+The Beauty of Simplicity: The Art of Software Design - Max Kanant-Alexander
 
-程序员的底层思维 - 张建飞
+The Programmer's Underlying Logic - Zhang Jianfei
 
-程序员的三门课：技术精进、架构修炼、管理探秘 - 于君泽
+The Programmer's Three Courses: Technical Advancement, Architecture Cultivation, Management Exploration - Yu Junze
 
-机器学习系统设计（图灵程序设计丛书） - Willi Richert & Luis Pedro Coelho
+Machine Learning System Design (Turing Programming Series) - Willi Richert & Luis Pedro Coelho
 
-思维工程导论 - 钱小一
+Introduction to Mind Engineering - Qian Xiaoyi
 
-算法精粹：经典计算机科学问题的Python实现 - David Kopec
+Algorithmic Essentials: Python Implementations of Classic Computer Science Problems - David Kopec
 
-函数式编程思维 (图灵程序设计丛书) - Neal Ford
+Functional Programming Thinking (Turing Programming Series) - Neal Ford
 
-Python函数式编程（第2版）（图灵图书） - 史蒂文·洛特
+Python Functional Programming (2nd Edition) (Turing Books) - Steven Lott
 
-Effective Python 编写高质量Python代码的90个有效方法（原书第2版） (Effective系列丛书) - Brett Slatkin
+Effective Python: 90 Specific Ways to Write Better Python (2nd Edition) (Effective Series) - Brett Slatkin
 
-高频交易（原书第2版） - Irene Aldridge
+High-Frequency Trading (2nd Edition) - Irene Aldridge
 
-高频交易员：华尔街的速度游戏 - 迈克尔·刘易斯
+Flash Boys: A Wall Street Revolt - Michael Lewis
 
-金融学原理（第6版） - 彭兴韵
+Principles of Finance (6th Edition) - Peng Xinyun
 
-聪明投资者的第一本金融学常识书 - 肖玉红
+Financial Literacy for the Smart Investor - Xiao Yuhong
 
-可视化量化金融 - Michael Lovelady
+Visualizing Quantitative Finance - Michael Lovelady
 
-GPT时代的量化交易：底层逻辑与技术实践 - 罗勇 & 卢洪波
+Quantitative Trading in the GPT Era: Underlying Logic and Technical Practice - Luo Yong & Lu Hongbo
 
-图灵经典计算机基础系列（套装全4册） -  矢泽久雄 & 户根勤 & 平泽章
+Turing Classic Computer Science Series (Set of 4 Books) - Hisao Yazawa & Tsutomu Togen & Takeshi Hirayama & Norichika Okada
 
-软件开发的201个原则 - Alan M· Davis
+201 Principles of Software Development - Alan M. Davis
 
-程序员的AI书：从代码开始 - 张力柯 & 潘晖
+The Programmer's AI Book: Starting from Code - Zhang Like & Pan Hui
 
-计算的本质：深入剖析程序和计算机 - Tom Stuart
+The Nature of Computation: An In-depth Look at Programs and Computers - Tom Stuart
 
-程序员投资指南 -  Stefan Papp
+The Programmer's Investment Guide - Stefan Papp
 
-精通正则表达式（第3版） - Jeffrey E.F.Friedl
+Mastering Regular Expressions (3rd Edition) - Jeffrey E.F. Friedl
 
-巧用ChatGPT进行数据分析与挖掘 - 谢佳标
+Leveraging ChatGPT for Data Analysis and Mining - Xie Jiabiao
 
-工业人工智能三部曲（套装共三册）（世界一流的智能制造专家著作合辑）（2016年被美国制造工程师学会（SME）评选为“美国30位最有远见的智能制造人物”） - 李杰
+Industrial AI Trilogy (Set of 3 Books) (Collection of Works by World-Class Intelligent Manufacturing Experts) (Named "30 Most Visionary Intelligent Manufacturing Figures in the US" by SME in 2016) - Li Jie
 
-从零构建大模型：算法、训练与微调 - 梁楠
+Building Large Models from Scratch: Algorithms, Training, and Fine-tuning - Liang Nan
 
-Vibe Coding_ Building Production-Grade Software With GenAI, Chat, Agents, and Beyond - Gene Kim & Steve Yegge
+Vibe Coding: Building Production-Grade Software With GenAI, Chat, Agents, and Beyond - Gene Kim & Steve Yegge
 
-Vibe Coding AI 编程完全手册 - 谭星星
+Vibe Coding AI Programming Manual - Tan Xingxing
 
-计算机科学概论（第13版） - J. 格伦·布鲁克希尔 & 丹尼斯·布里罗
+Computer Science: An Overview (13th Edition) - J. Glenn Brookshear & Dennis Brylow
 
-Pro Git （中文版） - Scott Chacon & Ben Straub
+Pro Git (Chinese Edition) - Scott Chacon & Ben Straub
 
-像程序员一样思考 - V.Anton Spraul
+Think Like a Programmer - V. Anton Spraul
 
-Python核心编程（第3版） - Wesley Chun_1
+Core Python Programming (3rd Edition) - Wesley Chun_1
 
-AI 工程：从基础模型建构应用 - Chip Huyen
+AI Engineering: Building Applications from Foundation Models - Chip Huyen
 
-AI辅助编程实战 - 汤姆·陶利
+AI-Assisted Programming in Practice - Tom Taulli
 
-编码：隐匿在计算机软硬件背后的语言 - Charles Petzold
+Code: The Hidden Language of Computer Hardware and Software - Charles Petzold

i18n/en/documents/Templates and Resources/Tool_Set.md

@@ -1,6 +1,5 @@
-TRANSLATED CONTENT:
-ide与插件；vscode ，Windsurf（白嫖用），闪电说（输出用），Continue - open-source AI code agent，Local History，Partial Diff
+IDE and Plugins; VSCode, Windsurf (for free use), Sparkle Talk (for output), Continue - open-source AI code agent, Local History, Partial Diff
 
-模型；codex，gemini，kimik2，grok
+Models; Codex, Gemini, KimiK2, Grok
 
-网站；https://aistudio.google.com/；https://zread.ai/；https://chatgpt.com/；https://github.com；https://www.bilibili.com；https://www.mermaidchart.com/app/dashboard；https://notebooklm.google.com/；https://z-lib.fm/；https://docs.google.com/spreadsheets/u/0/；https://script.google.com/home?pli=1
+Websites; https://aistudio.google.com/; https://zread.ai/; https://chatgpt.com/; https://github.com; https://www.bilibili.com; https://www.mermaidchart.com/app/dashboard; https://notebooklm.google.com/; https://z-lib.fm/; https://docs.google.com/spreadsheets/u/0/; https://script.google.com/home?pli=1

i18n/en/documents/Tutorials and Guides/telegram-dev/telegram_Markdown_Code_Block_Format_Fix_Log_2025_12_15.md

@@ -1,21 +1,20 @@
-TRANSLATED CONTENT:
-#  telegram Markdown 代码块格式修复记录 2025-12-15
+# Telegram Markdown Code Block Format Fix Log 2025-12-15
 
-## 问题
+## Problem
 
-排盘完成后发送消息报错：
+After completing the astrological chart generation, sending a message reports an error:
 ```
-❌ 排盘失败: Can't parse entities: can't find end of the entity starting at byte offset 168
+❌ Chart generation failed: Can't parse entities: can't find end of the entity starting at byte offset 168
 ```
 
-## 原因
+## Cause
 
-`bot.py` 中 `header` 消息的 Markdown 代码块格式错误。
+The Markdown code block format for the `header` message in `bot.py` is incorrect.
 
-原代码使用字符串拼接，在 ``` 后面加了 `\n`，导致 Telegram Markdown 解析器无法正确识别代码块边界：
+The original code used string concatenation, adding `\n` after ```, which caused the Telegram Markdown parser to incorrectly identify the code block boundary:
 
 ```python
-# 错误写法
+# Incorrect way
 header = (
     "```\n"
     f"{filename}\n"
@@ -23,13 +22,13 @@ header = (
 )
 ```
 
-## 修复
+## Fix
 
-改用三引号字符串，确保 ``` 单独成行：
+Changed to a triple-quoted string to ensure ``` is on a separate line:
 
 ```python
-# 正确写法
-header = f"""报告见附件
+# Correct way
+header = f"""Report attached
 ```
 {filename}
 {ai_filename}
@@ -37,6 +36,8 @@ header = f"""报告见附件
 """
 ```
 
-## 修改文件
+## Modified File
 
-- `services/telegram-service/src/bot.py` 第 293-308 行
+- `services/telegram-service/src/bot.py` lines 293-308
+
+```

i18n/en/documents/Tutorials and Guides/tmux_Shortcut_Cheatsheet.md

@@ -1,50 +1,49 @@
-TRANSLATED CONTENT:
-## tmux快捷键大全（前缀 Ctrl+b）
+## tmux Shortcut Cheatsheet (Prefix Ctrl+b)
 
-### 会话
-| 操作 | 快捷键 |
-|------|--------|
-| 脱离会话 | d |
-| 列出会话 | s |
-| 重命名会话 | $ |
+### Sessions
+| Operation | Shortcut |
+|-----------|----------|
+| Detach Session | d |
+| List Sessions | s |
+| Rename Session | $ |
 
-### 窗口
-| 操作 | 快捷键 |
-|------|--------|
-| 新建窗口 | c |
-| 关闭窗口 | & |
-| 下一个窗口 | n |
-| 上一个窗口 | p |
-| 切换到第N个窗口 | 0-9 |
-| 重命名窗口 | , |
-| 列出窗口 | w |
+### Windows
+| Operation | Shortcut |
+|-----------|----------|
+| New Window | c |
+| Close Window | & |
+| Next Window | n |
+| Previous Window | p |
+| Switch to Window N | 0-9 |
+| Rename Window | , |
+| List Windows | w |
 
-### 窗格
-| 操作 | 快捷键 |
-|------|--------|
-| 左右分屏 | % |
-| 上下分屏 | " |
-| 切换窗格 | 方向键 |
-| 关闭窗格 | x |
-| 显示窗格编号 | q |
-| 窗格全屏/还原 | z |
-| 调整大小 | Ctrl+方向键 |
-| 交换窗格位置 | { / } |
-| 窗格转为独立窗口 | ! |
+### Panes
+| Operation | Shortcut |
+|-----------|----------|
+| Split Pane Horizontal | % |
+| Split Pane Vertical | " |
+| Switch Pane | Arrow keys |
+| Close Pane | x |
+| Display Pane Numbers | q |
+| Toggle Pane Fullscreen/Restore | z |
+| Resize | Ctrl+Arrow keys |
+| Swap Panes | { / } |
+| Break Pane to New Window | ! |
 
-### 其他
-| 操作 | 快捷键 |
-|------|--------|
-| 进入复制模式 | [ |
-| 粘贴 | ] |
-| 显示时间 | t |
-| 命令模式 | : |
-| 列出快捷键 | ? |
+### Others
+| Operation | Shortcut |
+|-----------|----------|
+| Enter Copy Mode | [ |
+| Paste | ] |
+| Show Time | t |
+| Command Mode | : |
+| List Shortcuts | ? |
 
-### 命令行
+### Command Line
 bash
-tmux                  # 新建会话
-tmux new -s 名字      # 新建命名会话
-tmux ls               # 列出会话
-tmux attach -t 名字   # 连接会话
-tmux kill-session -t 名字  # 杀掉会话
+tmux                  # New session
+tmux new -s name      # New named session
+tmux ls               # List sessions
+tmux attach -t name   # Attach session
+tmux kill-session -t name  # Kill session

i18n/zh/README.md

@@ -82,7 +82,7 @@
 
 该思想的核心是构建一个能够**自我优化**的 AI 系统。其递归本质可分解为以下步骤：
 
-> 延伸阅读：[A Formalization of Recursive Self-Optimizing Generative Systems](./i18n/zh/documents/Methodology%20and%20Principles/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)
+> 延伸阅读：[A Formalization of Recursive Self-Optimizing Generative Systems](./documents/方法论与原则/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)
 
 #### 1. 定义核心角色：
 
@@ -186,10 +186,10 @@
 *   [**第三方系统提示词学习库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): 用于学习和参考其他 AI 工具的系统提示词。
 *   [**Skills 制作器**](https://github.com/yusufkaraaslan/Skill_Seekers): 可根据需求生成定制化 Skills 的工具。
 *   [**元提示词**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词。
-*   [**通用项目架构模板**](./i18n/zh/documents/Templates%20and%20Resources/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。
-*   [**元技能：Skills 的 Skills**](./i18n/zh/skills/claude-skills/SKILL.md): 用于生成 Skills 的元技能。
-*   [**tmux快捷键大全**](./i18n/zh/documents/Tutorials%20and%20Guides/tmux快捷键大全.md): tmux 的快捷键参考文档。
-*   [**LazyVim快捷键大全**](./i18n/zh/documents/Tutorials%20and%20Guides/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
+*   [**通用项目架构模板**](./documents/模板与资源/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。
+*   [**元技能：Skills 的 Skills**](./skills/claude-skills/SKILL.md): 用于生成 Skills 的元技能。
+*   [**tmux快捷键大全**](./documents/教程与指南/tmux快捷键大全.md): tmux 的快捷键参考文档。
+*   [**LazyVim快捷键大全**](./documents/教程与指南/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
 *   [**二哥的Java进阶之路**](https://javabetter.cn/): 包含多种开发工具的详细配置教程。
 *   [**虚拟卡**](https://www.bybit.com/cards/?ref=YDGAVPN&source=applet_invite): 可用于注册云服务等需要国际支付的场景。
 
@@ -211,8 +211,8 @@
     *   [Telegram 交流群](https://t.me/glue_coding)
     *   [Telegram 频道](https://t.me/tradecat_ai_channel)
 *   **个人分享**:
-    *   [我的学习经验](./i18n/zh/documents/Methodology%20and%20Principles/学习经验.md)
-    *   [编程书籍推荐](./i18n/zh/documents/Templates%20and%20Resources/编程书籍推荐.md)
+    *   [我的学习经验](./documents/方法论与原则/学习经验.md)
+    *   [编程书籍推荐](./documents/模板与资源/编程书籍推荐.md)
 *   **核心资源**:
     *   [**元提示词库**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词集合。
     *   [**元技能 (Meta-Skill)**](./i18n/zh/skills/claude-skills/SKILL.md): 用于生成 Skills 的 Skill。
@@ -223,10 +223,10 @@
 *   **项目内部文档**:
     *   [**prompts-library 工具说明**](./libs/external/prompts-library/): 该工具支持在 Excel 和 Markdown 格式之间转换提示词，并包含数百个精选提示词。
     *   [**coding_prompts 集合**](./i18n/zh/prompts/coding_prompts/): 适用于 Vibe Coding 流程的专用提示词。
-    *   [**系统提示词构建原则**](./i18n/zh/documents/Methodology%20and%20Principles/系统提示词构建原则.md): 关于如何构建高效、可靠的 AI 系统提示词的综合指南。
-    *   [**开发经验总结**](./i18n/zh/documents/Methodology%20and%20Principles/开发经验.md): 包含变量命名、文件结构、编码规范、架构原则等实践经验。
-    *   [**通用项目架构模板**](./i18n/zh/documents/Templates%20and%20Resources/通用项目架构模板.md): 提供多种项目类型的标准目录结构与最佳实践。
-    *   [**Augment MCP 配置文档**](./i18n/zh/documents/Tutorials%20and%20Guides/auggie-mcp配置文档.md): Augment 上下文引擎的详细配置说明。
+    *   [**系统提示词构建原则**](./documents/方法论与原则/系统提示词构建原则.md): 关于如何构建高效、可靠的 AI 系统提示词的综合指南。
+    *   [**开发经验总结**](./documents/方法论与原则/开发经验.md): 包含变量命名、文件结构、编码规范、架构原则等实践经验。
+    *   [**通用项目架构模板**](./documents/模板与资源/通用项目架构模板.md): 提供多种项目类型的标准目录结构与最佳实践。
+    *   [**Augment MCP 配置文档**](./documents/教程与指南/auggie-mcp配置文档.md): Augment 上下文引擎的详细配置说明。
     *   [**system_prompts 集合**](./i18n/zh/prompts/system_prompts/): 用于指导 AI 开发的系统提示词，包含多个版本的开发规范与思维框架。
 
 ---
@@ -248,9 +248,9 @@
 ├── CLAUDE.md                    # AI 助手的核心行为准则或配置。
 │
 ├── i18n/zh/documents/           # 存放各类说明文档、经验总结和配置详细说明。
-│   ├── Methodology and Principles/ # 方法论与原则
-│   ├── Templates and Resources/    # 模板与资源
-│   └── Tutorials and Guides/       # 教程与指南
+│   ├── 方法论与原则/                # 方法论与原则
+│   ├── 模板与资源/                  # 模板与资源
+│   └── 教程与指南/                  # 教程与指南
 │
 ├── libs/                        # 通用库代码，用于项目内部模块化。
 │   ├── common/                  # 通用功能模块。
@@ -310,7 +310,7 @@ i18n/zh/prompts/
   assistant_prompts/     # 辅助/配合型提示
   user_prompts/          # 可复用的用户侧提示词
 i18n/zh/documents/
-  Templates and Resources/代码组织.md, Templates and Resources/通用项目架构模板.md, Methodology and Principles/开发经验.md, Methodology and Principles/系统提示词构建原则.md 等知识库
+  模板与资源/代码组织.md, 模板与资源/通用项目架构模板.md, 方法论与原则/开发经验.md, 方法论与原则/系统提示词构建原则.md 等知识库
 backups/
   一键备份.sh, 快速备份.py  # 本地/远端快照脚本
 ```
@@ -415,7 +415,15 @@ gantt
 
 ---
 
-## 🚀 入门指南（这里是原作者的，不是我写的，我更新了一下我认为最好的模型）
+## 🚀 入门指南
+
+### 🆕 完全新手？从这里开始！
+
+1. [01-网络环境配置](./documents/从零开始vibecoding/01-网络环境配置.md) - 配置网络访问
+2. [02-开发环境搭建](./documents/从零开始vibecoding/02-开发环境搭建.md) - 复制提示词给 AI，让 AI 指导你搭建环境
+
+### 已有开发环境？
+
 要开始 Vibe Coding，你只需要以下两种工具之一：
 - **Claude Opus 4.5**，在 Claude Code 中使用
 - **gpt-5.1-codex.1-codex (xhigh)**，在 Codex CLI 中使用

i18n/zh/documents/README.md

@@ -8,7 +8,11 @@
 i18n/zh/documents/
 ├── README.md
 │
-├── Methodology and Principles/
+├── 从零开始vibecoding/          # 🚀 新手入门必读
+│   ├── 01-网络环境配置.md
+│   └── 02-开发环境搭建.md
+│
+├── 方法论与原则/
 │   ├── A Formalization of Recursive Self-Optimizing Generative Systems.md
 │   ├── gluecoding.md
 │   ├── vibe-coding-经验收集.md
@@ -18,14 +22,14 @@ i18n/zh/documents/
 │   ├── 胶水编程.md
 │   └── 系统提示词构建原则.md
 │
-├── Tutorials and Guides/
+├── 教程与指南/
 │   ├── auggie-mcp配置文档.md
 │   ├── LazyVim快捷键大全.md
 │   ├── tmux快捷键大全.md
 │   ├── 关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md
 │   └── telegram-dev/
 │
-└── Templates and Resources/
+└── 模板与资源/
     ├── 代码组织.md
     ├── 工具集.md
     ├── 编程书籍推荐.md
@@ -34,7 +38,14 @@ i18n/zh/documents/
 
 ## 文档分类
 
-### Methodology and Principles
+### 🚀 从零开始vibecoding（新手入门）
+
+完全零基础？从这里开始！
+
+*   [01-网络环境配置](./从零开始vibecoding/01-网络环境配置.md) - 配置网络访问
+*   [02-开发环境搭建](./从零开始vibecoding/02-开发环境搭建.md) - 搭建开发环境（提示词版）
+
+### 方法论与原则
 
 此类别存放关于编程思想、开发哲学和项目核心原则的文档。
 
@@ -47,7 +58,7 @@ i18n/zh/documents/
 *   `胶水编程.md`
 *   `系统提示词构建原则.md`
 
-### Tutorials and Guides
+### 教程与指南
 
 此类别存放具体工具的配置、使用指南和操作教程。
 
@@ -57,7 +68,7 @@ i18n/zh/documents/
 *   `关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md`
 *   `telegram-dev/`
 
-### Templates and Resources
+### 模板与资源
 
 此类别存放可复用的项目模板、代码结构规范和资源列表。
 

i18n/zh/documents/从零开始vibecoding/01-网络环境配置.md

@@ -0,0 +1,93 @@
+# 网络环境配置指南
+
+> Vibe Coding 的前置条件：确保能正常访问 GitHub、Google、Claude 等服务。
+
+---
+
+## 你需要
+
+1. **网络服务订阅** - 提供节点的服务商
+2. **FlClash** - 跨平台网络配置客户端
+
+---
+
+## 第一步：购买网络服务
+
+访问服务商：https://xn--9kqz23b19z.com/#/register?code=35BcnKzl
+
+- 注册账号
+- 选择套餐（约 6 元/月起）
+- 付款后在用户面板找到 **订阅链接**，复制备用
+
+---
+
+## 第二步：下载 FlClash
+
+GitHub 下载：https://github.com/chen08209/FlClash/releases
+
+根据系统选择：
+- Windows: `FlClash-x.x.x-windows-setup.exe`
+- macOS: `FlClash-x.x.x-macos.dmg`
+- Linux: `FlClash-x.x.x-linux-amd64.AppImage`
+- Android: `FlClash-x.x.x-android.apk`
+
+---
+
+## 第三步：导入订阅
+
+1. 打开 FlClash
+2. 点击 **配置** → **添加**
+3. 选择 **URL 导入**
+4. 粘贴第一步复制的订阅链接
+5. 点击确认，等待节点加载
+
+---
+
+## 第四步：开启代理
+
+依次设置以下三项：
+
+| 设置项 | 操作 |
+|:---|:---|
+| **虚拟网卡 (TUN)** | 开启 - 实现全局流量代理 |
+| **系统代理** | 开启 - 让系统应用走代理 |
+| **代理模式** | 选择 **全局模式** |
+
+设置完成后，FlClash 主界面显示已连接即可。
+
+---
+
+## 验证
+
+```bash
+# 测试 Google 连通性
+curl -I https://www.google.com
+
+# 测试 GitHub 连通性
+curl -I https://github.com
+```
+
+返回 `HTTP/2 200` 表示配置成功。
+
+---
+
+## 常见问题
+
+**Q: 节点连不上？**
+A: 切换其他节点试试，或检查订阅是否过期。
+
+**Q: 部分应用不走代理？**
+A: 确保 TUN 模式（虚拟网卡）已开启。
+
+**Q: 想让终端也走代理？**
+A: TUN 模式开启后终端自动走代理；或手动设置：
+```bash
+export https_proxy=http://127.0.0.1:7890
+export http_proxy=http://127.0.0.1:7890
+```
+
+---
+
+## 下一步
+
+网络配置完成后，继续阅读 [02-开发环境搭建](./02-开发环境搭建.md)。

i18n/zh/documents/从零开始vibecoding/02-开发环境搭建.md

@@ -0,0 +1,124 @@
+# 开发环境搭建提示词
+
+> 使用方法：复制下方对应你设备的提示词，粘贴到任意 AI 对话框（ChatGPT、Claude、Gemini 网页版等），AI 会一步步指导你完成配置。
+
+**前置条件**：请先完成 [01-网络环境配置](./01-网络环境配置.md)
+
+---
+
+## 🪟 Windows 用户提示词
+
+### 方案 A：WSL2 + Linux 环境（推荐）
+
+> 适合：想要完整 Linux 开发体验，兼容性最好
+
+```
+你是一个耐心的开发环境配置助手。我是一个完全的新手，使用 Windows 系统，需要你一步一步指导我通过 WSL2 搭建 Linux 开发环境。
+
+请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
+
+1. 安装 WSL2（Windows Subsystem for Linux）
+2. 在 WSL2 中安装 Ubuntu
+3. 配置 Ubuntu 基础环境（更新系统）
+4. 安装 nvm 和 Node.js
+5. 安装 Gemini CLI 或其他免费 AI CLI 工具
+6. 安装基础开发工具（git, python, build-essential, tmux）
+7. 配置 Git 用户信息
+8. 安装代码编辑器（VS Code 并配置 WSL 插件）
+9. 验证所有工具是否正常工作
+
+要求：
+- 每个步骤给出具体的命令，告诉我在哪里运行（PowerShell 还是 Ubuntu 终端）
+- 用简单易懂的语言解释每个命令的作用
+- 如果我遇到错误，帮我分析原因并给出解决方案
+- 每完成一步，问我是否成功，然后再继续下一步
+
+现在开始第一步吧。
+```
+
+### 方案 B：Windows 原生终端
+
+> 适合：不想装 WSL，直接在 Windows 上开发
+
+```
+你是一个耐心的开发环境配置助手。我是一个完全的新手，使用 Windows 系统，需要你一步一步指导我在 Windows 原生环境下搭建开发环境（不使用 WSL）。
+
+请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
+
+1. 安装 Windows Terminal（如果还没有）
+2. 安装 Node.js（通过官网安装包或 winget）
+3. 安装 Git for Windows
+4. 安装 Python
+5. 安装 Gemini CLI 或其他免费 AI CLI 工具
+6. 配置 Git 用户信息
+7. 安装代码编辑器（VS Code）
+8. 验证所有工具是否正常工作
+
+要求：
+- 每个步骤给出具体的命令或操作步骤
+- 用简单易懂的语言解释每个步骤的作用
+- 如果我遇到错误，帮我分析原因并给出解决方案
+- 每完成一步，问我是否成功，然后再继续下一步
+
+现在开始第一步吧。
+```
+
+---
+
+## 🍎 macOS 用户提示词
+
+```
+你是一个耐心的开发环境配置助手。我是一个完全的新手，使用 macOS 系统，需要你一步一步指导我从零搭建 Vibe Coding 开发环境。
+
+请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
+
+1. 安装 Homebrew 包管理器
+2. 使用 Homebrew 安装 Node.js
+3. 安装 Gemini CLI 或其他免费 AI CLI 工具
+4. 安装基础开发工具（git, python, tmux）
+5. 配置 Git 用户信息
+6. 安装代码编辑器（VS Code 或 Neovim）
+7. 验证所有工具是否正常工作
+
+要求：
+- 每个步骤给出具体的命令
+- 用简单易懂的语言解释每个命令的作用
+- 如果我遇到错误，帮我分析原因并给出解决方案
+- 每完成一步，问我是否成功，然后再继续下一步
+
+现在开始第一步吧。
+```
+
+---
+
+## 🐧 Linux 用户提示词
+
+```
+你是一个耐心的开发环境配置助手。我是一个完全的新手，使用 Linux 系统（Ubuntu/Debian），需要你一步一步指导我从零搭建 Vibe Coding 开发环境。
+
+请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
+
+1. 更新系统并安装基础依赖（curl, build-essential）
+2. 安装 nvm 和 Node.js
+3. 安装 Gemini CLI 或其他免费 AI CLI 工具
+4. 安装开发工具（git, python, tmux）
+5. 配置 Git 用户信息
+6. 安装代码编辑器（VS Code 或 Neovim）
+7. 验证所有工具是否正常工作
+
+要求：
+- 每个步骤给出具体的命令
+- 用简单易懂的语言解释每个命令的作用
+- 如果我遇到错误，帮我分析原因并给出解决方案
+- 每完成一步，问我是否成功，然后再继续下一步
+
+现在开始第一步吧。
+```
+
+---
+
+## 配置完成后
+
+环境搭建完成后，继续下一步：
+
+→ [03-IDE配置](./03-IDE配置.md) - 配置 VS Code 开发环境

i18n/zh/documents/从零开始vibecoding/03-IDE配置.md

@@ -0,0 +1,132 @@
+# IDE 配置提示词
+
+> 使用方法：复制下方对应你设备的提示词，粘贴到任意 AI 对话框，AI 会一步步指导你完成 VS Code 配置。
+
+**前置条件**：请先完成 [02-开发环境搭建](./02-开发环境搭建.md)
+
+---
+
+## 🪟 Windows + WSL 用户提示词
+
+```
+你是一个耐心的 VS Code 配置助手。我已经安装好了 WSL2 和 Ubuntu，现在需要你一步一步指导我配置 VS Code 以获得最佳的 WSL 开发体验。
+
+请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
+
+1. 在 Windows 上安装 VS Code（如果还没装）
+2. 安装 Remote - WSL 扩展
+3. 通过 WSL 打开项目文件夹
+4. 安装基础开发扩展：
+   - GitLens（Git 增强）
+   - Prettier（代码格式化）
+   - ESLint（代码检查）
+   - Local History（本地历史记录）
+5. 配置终端默认使用 WSL
+6. 配置自动保存和格式化
+7. 验证配置是否正常工作
+
+要求：
+- 每个步骤给出具体的操作方法
+- 用简单易懂的语言解释每个配置的作用
+- 如果我遇到问题，帮我分析原因并给出解决方案
+- 每完成一步，问我是否成功，然后再继续下一步
+
+现在开始第一步吧。
+```
+
+---
+
+## 🪟 Windows 原生用户提示词
+
+```
+你是一个耐心的 VS Code 配置助手。我使用 Windows 系统（不使用 WSL），现在需要你一步一步指导我配置 VS Code。
+
+请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
+
+1. 安装 VS Code（如果还没装）
+2. 安装基础开发扩展：
+   - GitLens（Git 增强）
+   - Prettier（代码格式化）
+   - ESLint（代码检查）
+   - Local History（本地历史记录）
+   - Python（如果写 Python）
+3. 配置终端使用 PowerShell 或 Git Bash
+4. 配置自动保存和格式化
+5. 配置 Git 集成
+6. 验证配置是否正常工作
+
+要求：
+- 每个步骤给出具体的操作方法
+- 用简单易懂的语言解释每个配置的作用
+- 如果我遇到问题，帮我分析原因并给出解决方案
+- 每完成一步，问我是否成功，然后再继续下一步
+
+现在开始第一步吧。
+```
+
+---
+
+## 🍎 macOS 用户提示词
+
+```
+你是一个耐心的 VS Code 配置助手。我使用 macOS 系统，现在需要你一步一步指导我配置 VS Code。
+
+请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
+
+1. 安装 VS Code（通过 Homebrew 或官网）
+2. 配置 code 命令行工具（在终端中用 code 打开文件）
+3. 安装基础开发扩展：
+   - GitLens（Git 增强）
+   - Prettier（代码格式化）
+   - ESLint（代码检查）
+   - Local History（本地历史记录）
+4. 配置自动保存和格式化
+5. 配置快捷键（可选：Vim 模式）
+6. 验证配置是否正常工作
+
+要求：
+- 每个步骤给出具体的操作方法
+- 用简单易懂的语言解释每个配置的作用
+- 如果我遇到问题，帮我分析原因并给出解决方案
+- 每完成一步，问我是否成功，然后再继续下一步
+
+现在开始第一步吧。
+```
+
+---
+
+## 🐧 Linux 用户提示词
+
+```
+你是一个耐心的 VS Code 配置助手。我使用 Linux 系统（Ubuntu/Debian），现在需要你一步一步指导我配置 VS Code。
+
+请按以下顺序指导我，每次只给我一个步骤，等我确认完成后再进行下一步：
+
+1. 安装 VS Code（通过 apt 或 snap）
+2. 安装基础开发扩展：
+   - GitLens（Git 增强）
+   - Prettier（代码格式化）
+   - ESLint（代码检查）
+   - Local History（本地历史记录）
+3. 配置自动保存和格式化
+4. 配置终端集成
+5. 配置快捷键（可选：Vim 模式）
+6. 验证配置是否正常工作
+
+要求：
+- 每个步骤给出具体的操作方法
+- 用简单易懂的语言解释每个配置的作用
+- 如果我遇到问题，帮我分析原因并给出解决方案
+- 每完成一步，问我是否成功，然后再继续下一步
+
+现在开始第一步吧。
+```
+
+---
+
+## 配置完成后
+
+VS Code 配置完成后，你可以：
+
+1. 继续阅读 [04-AI编程工具](./04-AI编程工具.md) 安装 AI CLI 工具
+2. 或直接阅读 [README.md](../../../../README.md) 了解 Vibe Coding 工作流

i18n/zh/documents/从零开始vibecoding/README.md

@@ -0,0 +1,28 @@
+# 🚀 从零开始 Vibe Coding
+
+> 完全零基础？按顺序完成以下步骤，即可开始 AI 编程之旅。
+
+---
+
+## 学习路径
+
+| 序号 | 文档 | 说明 |
+|:---:|:---|:---|
+| 01 | [网络环境配置](./01-网络环境配置.md) | 配置网络，确保能访问 GitHub、Google 等服务 |
+| 02 | [开发环境搭建](./02-开发环境搭建.md) | 复制提示词给 AI，让 AI 指导你安装开发工具 |
+| 03 | [IDE配置](./03-IDE配置.md) | 配置 VS Code 编辑器 |
+
+---
+
+## 使用方法
+
+1. 按顺序阅读每个文档
+2. 文档中的提示词可以直接复制到 AI 对话框（ChatGPT、Claude、Gemini 网页版）
+3. AI 会一步步指导你完成配置
+4. 遇到问题直接问 AI
+
+---
+
+## 完成后
+
+全部配置完成后，阅读 [主文档](../../../../README.md) 了解 Vibe Coding 工作流。

libs/external/l10n-tool/translate_files.py

@@ -4,7 +4,11 @@ import json
 from pathlib import Path
 
 # Load PATH_TRANSLATION_MAP from JSON
-with open('path_translation_map.json', 'r', encoding='utf-8') as f:
+# Ensure the path is relative to the script's location or absolute
+script_dir = Path(__file__).parent
+path_translation_map_path = script_dir / 'path_translation_map.json'
+
+with open(path_translation_map_path, 'r', encoding='utf-8') as f:
     PATH_TRANSLATION_MAP = json.load(f)
 
 def translate_path_component(component):
@@ -23,95 +27,96 @@ def translate_path_component(component):
         return re.sub(r"[^a-zA-Z0-9]+", "_", cleaned_component).strip("_")
 
     # If it's a very long Chinese filename that might have specific terms
-    if "代码" in component:
-        return component.replace("代码", "Code").replace("组织", "Organization").replace(" ", "_")
-    if "编程" in component:
-        return component.replace("编程", "Programming").replace("书籍推荐", "Books_Recommendation").replace(" ", "_")
-    if "通用项目架构模板" in component:
+    # These were added to PATH_TRANSLATION_MAP now, so this generic logic might not be hit as often
+    if "代码组织" == component: # Exact match for a known common Chinese filename part
+        return "Code_Organization"
+    if "编程书籍推荐" == component:
+        return "Recommended_Programming_Books"
+    if "通用项目架构模板" == component:
         return "General_Project_Architecture_Template"
-    if "工具集" in component:
+    if "工具集" == component:
         return "Tool_Set"
-    if "系统提示词构建原则" in component:
+    if "系统提示词构建原则" == component:
         return "System_Prompt_Construction_Principles"
-    if "胶水编程" in component:
+    if "胶水编程" == component:
         return "Glue_Programming"
-    if "vibe-coding-经验收集" in component:
+    if "vibe-coding-经验收集" == component:
         return "vibe-coding-Experience_Collection"
-    if "开发经验" in component:
+    if "开发经验" == component:
         return "Development_Experience"
-    if "学习经验" in component:
+    if "学习经验" == component:
         return "Learning_Experience"
-    if "编程之道" in component:
+    if "编程之道" == component:
         return "The_Way_of_Programming"
-    if "客观分析" in component:
+    if "客观分析" == component:
         return "Objective_Analysis"
-    if "精华技术文档生成提示词" in component:
+    if "精华技术文档生成提示词" == component:
         return "Essential_Technical_Document_Generation_Prompt"
-    if "智能需求理解与研发导航引擎" in component:
+    if "智能需求理解与研发导航引擎" == component:
         return "Intelligent_Requirement_Understanding_and_R_D_Navigation_Engine"
-    if "软件工程分析" in component:
+    if "软件工程分析" == component:
         return "Software_Engineering_Analysis"
-    if "系统架构可视化生成Mermaid" in component:
+    if "系统架构可视化生成Mermaid":
         return "System_Architecture_Visualization_Generation_Mermaid"
-    if "系统架构" in component:
+    if "系统架构":
         return "System_Architecture"
-    if "简易提示词优化器" in component:
+    if "简易提示词优化器":
         return "Simple_Prompt_Optimizer"
-    if "提示工程师任务说明" in component:
+    if "提示工程师任务说明":
         return "Prompt_Engineer_Task_Description"
-    if "高质量代码开发专家" in component:
+    if "高质量代码开发专家":
         return "High_Quality_Code_Development_Expert"
-    if "标准项目目录结构" in component:
+    if "标准项目目录结构":
         return "Standard_Project_Directory_Structure"
-    if "分析1" in component:
+    if "分析1":
         return "Analysis_1"
-    if "分析2" in component:
+    if "分析2":
         return "Analysis_2"
-    if "执行纯净性检测" in component:
+    if "执行纯净性检测":
         return "Perform_Purity_Test"
-    if "标准化流程" in component:
+    if "标准化流程":
         return "Standardized_Process"
-    if "项目上下文文档生成" in component:
+    if "项目上下文文档生成":
         return "Project_Context_Document_Generation"
-    if "人机对齐" in component:
+    if "人机对齐":
         return "Human_AI_Alignment"
-    if "plan提示词" in component:
+    if "plan提示词":
         return "Plan_Prompt"
-    if "Claude Code 八荣八耻" in component:
+    if "Claude Code 八荣八耻":
         return "Claude_Code_Eight_Honors_and_Eight_Shames"
-    if "任务描述，分析与补全任务" in component:
+    if "任务描述，分析与补全任务":
         return "Task_Description_Analysis_and_Completion"
-    if "前端设计" in component:
+    if "前端设计":
         return "Frontend_Design"
-    if "输入简单的日常行为的研究报告摘要" in component:
+    if "输入简单的日常行为的研究报告摘要":
         return "Summary_of_Research_Report_on_Simple_Daily_Behaviors"
-    if "胶水开发" in component:
+    if "胶水开发":
         return "Glue_Development"
-    if "sh控制面板生成" in component:
+    if "sh控制面板生成":
         return "SH_Control_Panel_Generation"
-    if "角色定义" in component:
+    if "角色定义":
         return "Role_Definition"
-    if "CLAUDE 记忆" in component:
+    if "CLAUDE 记忆":
         return "CLAUDE_Memory"
-    if "Docs文件夹中文命名提示词" in component:
+    if "Docs文件夹中文命名提示词":
         return "Docs_Folder_Chinese_Naming_Prompt"
-    if "通用项目架构综合分析与优化框架" in component:
+    if "通用项目架构综合分析与优化框架":
         return "General_Project_Architecture_Comprehensive_Analysis_and_Optimization_Framework"
-    if "执行📘_文件头注释规范（用于所有代码文件最上方）" in component:
+    if "执行📘_文件头注释规范（用于所有代码文件最上方）" == component:
         return "Execute_File_Header_Comment_Specification_for_All_Code_Files"
-    if "数据管道" in component:
+    if "数据管道" == component:
         return "Data_Pipeline"
-    if "项目变量与工具统一维护" in component:
+    if "项目变量与工具统一维护" == component:
         return "Unified_Management_of_Project_Variables_and_Tools"
-    if "ASCII图生成" in component:
+    if "ASCII图生成" == component:
         return "ASCII_Art_Generation"
-    if "Kobe's Diary of Saving Mother, Father, Fiancee, and In-laws × OTE Model Trading Mode × M.I.T White Professor (Accused of Sexual Harassment by Female Student) v2" in component:
+    if "Kobe's Diary of Saving Mother, Father, Fiancee, and In-laws × OTE Model Trading Mode × M.I.T White Professor (Accused of Sexual H_arassment by Female Student) v2" == component:
         return "Kobe_s_Diary_of_Saving_Mother_Father_Fiancee_and_In_laws_OTE_Model_Trading_Mode_M_I_T_White_Professor_Accused_of_Sexual_Harassment_by_Female_Student_v2" # Simplified for filename
-    if "动态视图对齐实现文档" in component:
+    if "动态视图对齐实现文档" == component:
         return "Dynamic_View_Alignment_Implementation_Document"
-    if "Telegram_Bot_按钮和键盘实现模板" in component:
+    if "Telegram_Bot_按钮和键盘实现模板" == component:
         return "Telegram_Bot_Button_and_Keyboard_Implementation_Template"
-    if "README" in component:
+    if "README" == component:
         return "README" # Keep README as is
     
     # Default: simply replace spaces with underscores and remove problematic characters for filenames
@@ -139,40 +144,39 @@ def get_translated_path(chinese_path_str): # Accept string
     return Path(*translated_parts) # Reconstruct path using pathlib
 
 # Load chinese_files from JSON
-with open('chinese_files_list.json', 'r', encoding='utf-8') as f:
+chinese_files_list_path = script_dir / 'chinese_files_list.json'
+with open(chinese_files_list_path, 'r', encoding='utf-8') as f:
     chinese_files_str_list = json.load(f)
 
-for chinese_file_path_str in chinese_files_str_list:
-    chinese_file_path = Path(chinese_file_path_str) # Convert string to Path object
+files_to_translate_content = []
 
-    # Construct the corresponding English directory path
-    english_file_path = get_translated_path(chinese_file_path_str) # Pass string to get_translated_path for component splitting
-    english_dir = english_file_path.parent # Get parent directory from Path object
-    
-    # Create the English directory if it doesn't exist
-    os.makedirs(english_dir, exist_ok=True)
+for chinese_file_path_str in chinese_files_str_list:
+    english_file_path = get_translated_path(chinese_file_path_str) # Get translated Path object
     
-    # Read the content of the Chinese file
+    # Read the content of the English placeholder file
     try:
-        # Use pathlib.Path.open() which is generally more robust
-        with chinese_file_path.open('r', encoding='utf-8') as f:
-            chinese_content = f.read()
+        with english_file_path.open('r', encoding='utf-8') as f:
+            content = f.read()
+        
+        if content.startswith("TRANSLATED CONTENT:\n"):
+            chinese_content = content.replace("TRANSLATED CONTENT:\n", "")
+            files_to_translate_content.append({
+                "chinese_content": chinese_content,
+                "english_target_path": str(english_file_path) # Store as string for easy display
+            })
+            
     except FileNotFoundError:
-        print(f"Error: File not found - {chinese_file_path_str}. Skipping.")
+        # This can happen if the previous script run failed for this file
+        print(f"Warning: English placeholder file not found for {english_file_path}. Skipping content extraction for this file.")
         continue
     except Exception as e:
-        print(f"Error reading {chinese_file_path_str}: {e}. Skipping.")
+        print(f"Error reading {english_file_path} for content extraction: {e}. Skipping.")
         continue
-    
-    # Simulate content translation (actual LLM translation will be done manually later)
-    # For now, just copy content with a prefix.
-    # THIS WILL BE REPLACED BY LLM-BASED TRANSLATION IN A LATER STEP.
-    translated_content = f"TRANSLATED CONTENT:\n{chinese_content}"
-    
-    # Write the translated content to the English file path
-    try:
-        with english_file_path.open('w', encoding='utf-8') as f:
-            f.write(translated_content)
-        print(f"Processed: {chinese_file_path_str} -> {english_file_path}")
-    except Exception as e:
-        print(f"Error writing to {english_file_path}: {e}. Skipping.")
+
+# Output the list of files to translate content for
+print("--- Files for Content Translation ---")
+for item in files_to_translate_content:
+    print(f"Target Path: {item['english_target_path']}")
+    print(f"Chinese Content:\n```markdown\n{item['chinese_content'].strip()}\n```\n{'='*50}\n")
+
+print(f"Total files requiring content translation: {len(files_to_translate_content)}")