gavindiaz/vibe-coding-cn
1
0
Fork 0
mirror of https://github.com/tradecatlabs/vibe-coding-cn.git synced 2026-08-18 21:38:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source 
主要变更：

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

此次重构统一了中文文档的目录命名，使其更符合中文用户的习惯，并优化了整体文档的组织结构，提升了可维护性。
This commit is contained in:
tukuaiai
2025-12-17 12:07:54 +08:00
parent 9b42dd10dd
commit e239f9e4b8
33 changed files with 753 additions and 738 deletions
Download Patch File Download Diff File Expand all files Collapse all files
i18n/en/documents/README.md
+43 -44
View File
@@ -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
+49 -439
View File
@@ -1,461 +1,71 @@
TRANSLATED CONTENT:
# 通用项目架构模板
# General Project Architecture Template
## 1️⃣ Python Web/API 项目标准结构
## 1️⃣ Standard Structure for Python Web/API Projects
```
项目名称/
├── 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的会话恢复指令^_^
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/ # 文档目录
│ ├── api.md # API文档
│ ├── development.md # 开发指南
│ └── architecture.md # 架构说明
├── docs/ # Documentation directory
│ ├── api.md # API documentation
│ ├── development.md # Development guide
│ └── architecture.md # Architecture description
│
├── scripts/ # 脚本工具
│ ├── deploy.sh # 部署脚本
│ ├── backup.sh # 备份脚本
│ └── init_db.sh # 数据库初始化
├── scripts/ # Script tools
│ ├── deploy.sh # Deployment script
│ ├── backup.sh # Backup script
│ └── init_db.sh # Database initialization
│
├── tests/ # 测试代码
├── 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
+76 -77
View File
@@ -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
+3 -4
View File
@@ -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
+16 -15
View File
@@ -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
+43 -44
View File
@@ -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