charieswei
/
vibe-coding-cn
mirror of https://github.com/tukuaiai/vibe-coding-cn.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: 更新文档和技能

This commit is contained in:
tukuaiai 2025-12-17 20:39:02 +08:00
parent 924b651e34
commit fb74acbd9b
23 changed files with 956 additions and 346 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
README.md
View File

@ -98,6 +98,27 @@
--- ---
<details open>
<summary><strong>🧬 胶水编程 (Glue Coding)</strong></summary>
> **软件工程的圣杯与银弹——终于出现了。**
胶水编程是 Vibe Coding 的终极进化形态，可能完美解决三大致命缺陷：
| 问题 | 解法 |
|:---|:---|
| 🎭 AI 幻觉 | ✅ 只使用已验证的成熟代码，零幻觉 |
| 🧩 复杂性爆炸 | ✅ 每个模块都是久经考验的轮子 |
| 🎓 门槛过高 | ✅ 你只需要描述"连接方式" |
**核心理念**：能抄不写，能连不造，能复用不原创。
👉 [深入了解胶水编程](./i18n/zh/documents/胶水编程/README.md)
</details>
---
## 🖼️ 概览 ## 🖼️ 概览
**Vibe Coding** 是一个与 AI 结对编程的终极工作流程，旨在帮助开发者丝滑地将想法变为现实。本指南详细介绍了从项目构思、技术选型、实施规划到具体开发、调试和扩展的全过程，强调以**规划驱动**和**模块化**为核心，避免让 AI 失控导致项目混乱。 **Vibe Coding** 是一个与 AI 结对编程的终极工作流程，旨在帮助开发者丝滑地将想法变为现实。本指南详细介绍了从项目构思、技术选型、实施规划到具体开发、调试和扩展的全过程，强调以**规划驱动**和**模块化**为核心，避免让 AI 失控导致项目混乱。
@ -245,6 +266,7 @@
### 项目内部文档 ### 项目内部文档
* [**胶水编程 (Glue Coding)**](./i18n/zh/documents/胶水编程/): 软件工程的圣杯与银弹，Vibe Coding 的终极进化形态。
* [**prompts-library 工具说明**](./libs/external/prompts-library/): 支持 Excel 与 Markdown 格式互转，包含数百个精选提示词。 * [**prompts-library 工具说明**](./libs/external/prompts-library/): 支持 Excel 与 Markdown 格式互转，包含数百个精选提示词。
* [**coding_prompts 集合**](./i18n/zh/prompts/coding_prompts/): 适用于 Vibe Coding 流程的专用提示词。 * [**coding_prompts 集合**](./i18n/zh/prompts/coding_prompts/): 适用于 Vibe Coding 流程的专用提示词。
* [**系统提示词构建原则**](./i18n/zh/documents/方法论与原则/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。 * [**系统提示词构建原则**](./i18n/zh/documents/方法论与原则/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。

1
i18n/en/skills/claude-skills/AGENTS.md
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
# skills/claude-skills # skills/claude-skills
This directory is a **meta-skill**: it turns arbitrary domain material (docs/APIs/code/specs) into a reusable Skill (`SKILL.md` + `references/` + `scripts/` + `assets/`), and ships an executable quality gate + scaffolding. This directory is a **meta-skill**: it turns arbitrary domain material (docs/APIs/code/specs) into a reusable Skill (`SKILL.md` + `references/` + `scripts/` + `assets/`), and ships an executable quality gate + scaffolding.

1
i18n/en/skills/claude-skills/SKILL.md
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
--- ---
name: claude-skills name: claude-skills
description: "Claude Skills meta-skill: extract domain material (docs/APIs/code/specs) into a reusable Skill (SKILL.md + references/scripts/assets), and refactor existing Skills for clarity, activation reliability, and quality gates." description: "Claude Skills meta-skill: extract domain material (docs/APIs/code/specs) into a reusable Skill (SKILL.md + references/scripts/assets), and refactor existing Skills for clarity, activation reliability, and quality gates."

1
i18n/en/skills/claude-skills/assets/template-complete.md
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
--- ---
name: {{skill_name}} name: {{skill_name}}
description: "[Domain] end-to-end capability: includes [capability 1], [capability 2], [capability 3]. Use when [decidable triggers]." description: "[Domain] end-to-end capability: includes [capability 1], [capability 2], [capability 3]. Use when [decidable triggers]."

1
i18n/en/skills/claude-skills/assets/template-minimal.md
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
--- ---
name: {{skill_name}} name: {{skill_name}}
description: "[Domain] capability: includes [key capability]. Use when [decidable triggers]." description: "[Domain] capability: includes [key capability]. Use when [decidable triggers]."

1
i18n/en/skills/claude-skills/references/README.md
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
# Skills # Skills
Skills are folders of instructions, scripts, and resources that Claude loads dynamically to improve performance on specialized tasks. Skills teach Claude how to complete specific tasks in a repeatable way, whether that's creating documents with your company's brand guidelines, analyzing data using your organization's specific workflows, or automating personal tasks. Skills are folders of instructions, scripts, and resources that Claude loads dynamically to improve performance on specialized tasks. Skills teach Claude how to complete specific tasks in a repeatable way, whether that's creating documents with your company's brand guidelines, analyzing data using your organization's specific workflows, or automating personal tasks.

1
i18n/en/skills/claude-skills/references/anti-patterns.md
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
# Anti-Patterns (And How to Fix Them) # Anti-Patterns (And How to Fix Them)
This file documents common ways Skills fail in practice. Use it when refactoring existing Skills. This file documents common ways Skills fail in practice. Use it when refactoring existing Skills.

1
i18n/en/skills/claude-skills/references/index.md
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
# Claude Skills Meta-Skill Reference Index # Claude Skills Meta-Skill Reference Index
This directory contains long-form documentation that supports the `claude-skills` meta-skill. This directory contains long-form documentation that supports the `claude-skills` meta-skill.

1
i18n/en/skills/claude-skills/references/quality-checklist.md
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
# Quality Checklist (Production Gate) # Quality Checklist (Production Gate)
Use this checklist to decide whether a Skill is shippable. It is intentionally biased toward reliability and maintainability over "more content". Use this checklist to decide whether a Skill is shippable. It is intentionally biased toward reliability and maintainability over "more content".

1
i18n/en/skills/claude-skills/references/skill-spec.md
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
# Skill Spec (This Repo) # Skill Spec (This Repo)
This document defines what a "production-grade Skill" means in this repository. Use it as the source of truth when creating or refactoring anything under `skills/`. This document defines what a "production-grade Skill" means in this repository. Use it as the source of truth when creating or refactoring anything under `skills/`.

1
i18n/en/skills/claude-skills/scripts/create-skill.sh
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
#!/usr/bin/env bash #!/usr/bin/env bash
set -euo pipefail set -euo pipefail

1
i18n/en/skills/claude-skills/scripts/validate-skill.sh
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
#!/usr/bin/env bash #!/usr/bin/env bash
set -euo pipefail set -euo pipefail

1
i18n/en/skills/snapdom/SKILL.md
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
--- ---
name: snapdom name: snapdom
description: snapDOM is a fast, accurate DOM-to-image capture tool that converts HTML elements into scalable SVG images. Use for capturing HTML elements, converting DOM to images (SVG, PNG, JPG, WebP), preserving styles, fonts, and pseudo-elements. description: snapDOM is a fast, accurate DOM-to-image capture tool that converts HTML elements into scalable SVG images. Use for capturing HTML elements, converting DOM to images (SVG, PNG, JPG, WebP), preserving styles, fonts, and pseudo-elements.

0
i18n/en/skills/snapdom/assets/.gitkeep Normal file
View File

1
i18n/en/skills/snapdom/references/index.md
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
# Snapdom Documentation Index # Snapdom Documentation Index
## Categories ## Categories

1
i18n/en/skills/snapdom/references/other.md
View File

@ -1,4 +1,3 @@
TRANSLATED CONTENT:
# Snapdom - Other # Snapdom - Other
**Pages:** 1 **Pages:** 1

0
i18n/en/skills/snapdom/scripts/.gitkeep Normal file
View File

613
i18n/en/skills/telegram-dev/references/index.md
View File

@ -1,261 +1,260 @@
TRANSLATED CONTENT: # Telegram Ecosystem Development Resource Index
# Telegram 生态开发资源索引
## 官方文档 ## Official Documentation
### Bot API ### Bot API
**主文档:** https://core.telegram.org/bots/api **Main Documentation:** https://core.telegram.org/bots/api
**描述:** Telegram Bot API 完整参考文档 **Description:** Complete reference documentation for the Telegram Bot API
**核心功能：** **Core Features:**
- 消息发送和接收 - Sending and receiving messages
- 媒体文件处理 - Handling media files
- 内联模式 - Inline mode
- 支付集成 - Payment integration
- Webhook 配置 - Webhook configuration
- 游戏和投票 - Games and polls
### Mini Apps (Web Apps) ### Mini Apps (Web Apps)
**主文档:** https://core.telegram.org/bots/webapps **Main Documentation:** https://core.telegram.org/bots/webapps
**完整平台:** https://docs.telegram-mini-apps.com **Full Platform:** https://docs.telegram-mini-apps.com
**描述:** Telegram 小程序开发文档 **Description:** Development documentation for Telegram Mini Apps
**核心功能：** **Core Features:**
- WebApp API - WebApp API
- 主题和 UI 控件 - Themes and UI controls
- 存储（Cloud/Device/Secure） - Storage (Cloud/Device/Secure)
- 生物识别认证 - Biometric authentication
- 位置和传感器 - Location and sensors
- 支付集成 - Payment integration
### Telegram API & MTProto ### Telegram API & MTProto
**主文档:** https://core.telegram.org **Main Documentation:** https://core.telegram.org
**描述:** 完整的 Telegram 协议和客户端开发 **Description:** Complete Telegram protocol and client development
**核心功能：** **Core Features:**
- MTProto 协议 - MTProto protocol
- TDLib 客户端库 - TDLib client library
- 认证和加密 - Authentication and encryption
- 文件操作 - File operations
- Secret Chats - Secret Chats
## 官方 GitHub 仓库 ## Official GitHub Repositories
### Bot API 服务器 ### Bot API Server
**仓库:** https://github.com/tdlib/telegram-bot-api **Repository:** https://github.com/tdlib/telegram-bot-api
**描述:** Telegram Bot API 服务器实现 **Description:** Implementation of the Telegram Bot API server
**特点:** **Features:**
- 本地模式部署 - Local mode deployment
- 支持大文件（最高 2000 MB） - Support for large files (up to 2000 MB)
- C++ 实现 - C++ implementation
- TDLib 基础 - Based on TDLib
### Android 客户端 ### Android Client
**仓库:** https://github.com/DrKLO/Telegram **Repository:** https://github.com/DrKLO/Telegram
**描述:** 官方 Android 客户端源代码 **Description:** Source code for the official Android client
**特点:** **Features:**
- 完整的 Android 实现 - Complete Android implementation
- Material Design - Material Design
- 可自定义编译 - Customizable compilation
### Desktop 客户端 ### Desktop Client
**仓库:** https://github.com/telegramdesktop/tdesktop **Repository:** https://github.com/telegramdesktop/tdesktop
**描述:** 官方桌面客户端 (Windows, macOS, Linux) **Description:** Official desktop client (Windows, macOS, Linux)
**特点:** **Features:**
- Qt/C++ 实现 - Qt/C++ implementation
- 跨平台支持 - Cross-platform support
- 完整功能 - Full functionality
### 官方组织 ### Official Organization
**组织页面:** https://github.com/orgs/TelegramOfficial/repositories **Organization Page:** https://github.com/orgs/TelegramOfficial/repositories
**包含:** **Includes:**
- Beta 版本 - Beta versions
- 支持工具 - Support tools
- 示例代码 - Example code
## API 方法分类 ## API Method Categories
### 更新管理 ### Update Management
- `getUpdates` - 长轮询 - `getUpdates` - Long polling
- `setWebhook` - 设置 Webhook - `setWebhook` - Set a webhook
- `deleteWebhook` - 删除 Webhook - `deleteWebhook` - Delete a webhook
- `getWebhookInfo` - Webhook 信息 - `getWebhookInfo` - Webhook information
### 消息操作 ### Message Operations
**发送消息：** **Sending Messages:**
- `sendMessage` - 文本消息 - `sendMessage` - Text message
- `sendPhoto` - 图片 - `sendPhoto` - Photo
- `sendVideo` - 视频 - `sendVideo` - Video
- `sendDocument` - 文档 - `sendDocument` - Document
- `sendAudio` - 音频 - `sendAudio` - Audio
- `sendVoice` - 语音 - `sendVoice` - Voice
- `sendLocation` - 位置 - `sendLocation` - Location
- `sendVenue` - 地点 - `sendVenue` - Venue
- `sendContact` - 联系人 - `sendContact` - Contact
- `sendPoll` - 投票 - `sendPoll` - Poll
- `sendDice` - 骰子/飞镖 - `sendDice` - Dice/Darts
**编辑消息：** **Editing Messages:**
- `editMessageText` - 编辑文本 - `editMessageText` - Edit text
- `editMessageCaption` - 编辑标题 - `editMessageCaption` - Edit caption
- `editMessageMedia` - 编辑媒体 - `editMessageMedia` - Edit media
- `editMessageReplyMarkup` - 编辑键盘 - `editMessageReplyMarkup` - Edit keyboard
- `deleteMessage` - 删除消息 - `deleteMessage` - Delete a message
**其他操作：** **Other Operations:**
- `forwardMessage` - 转发消息 - `forwardMessage` - Forward a message
- `copyMessage` - 复制消息 - `copyMessage` - Copy a message
- `sendChatAction` - 发送动作（输入中...） - `sendChatAction` - Send an action (typing...)
### 文件操作 ### File Operations
- `getFile` - 获取文件信息 - `getFile` - Get file information
- 文件下载 URL: `https://api.telegram.org/file/bot<token>/<file_path>` - File download URL: `https://api.telegram.org/file/bot<token>/<file_path>`
- 文件上传：支持 multipart/form-data - File upload: Supports multipart/form-data
- 最大文件：50 MB (标准), 2000 MB (本地 Bot API) - Max file size: 50 MB (standard), 2000 MB (local Bot API)
### 内联模式 ### Inline Mode
- `answerInlineQuery` - 响应内联查询 - `answerInlineQuery` - Respond to an inline query
- 结果类型：article, photo, gif, video, audio, voice, document, location, venue, contact, game, sticker - Result types: article, photo, gif, video, audio, voice, document, location, venue, contact, game, sticker
### 回调查询 ### Callback Queries
- `answerCallbackQuery` - 响应按钮点击 - `answerCallbackQuery` - Respond to a button click
- 可显示通知或警告 - Can display a notification or an alert
### 支付 ### Payments
- `sendInvoice` - 发送发票 - `sendInvoice` - Send an invoice
- `answerPreCheckoutQuery` - 预结账 - `answerPreCheckoutQuery` - Pre-checkout
- `answerShippingQuery` - 配送查询 - `answerShippingQuery` - Shipping query
- 支持提供商：Stripe, Yandex.Money, Telegram Stars - Supported providers: Stripe, Yandex.Money, Telegram Stars
### 游戏 ### Games
- `sendGame` - 发送游戏 - `sendGame` - Send a game
- `setGameScore` - 设置分数 - `setGameScore` - Set a score
- `getGameHighScores` - 获取排行榜 - `getGameHighScores` - Get high scores
### 群组管理 ### Group Management
- `kickChatMember` / `unbanChatMember` - 封禁/解封 - `kickChatMember` / `unbanChatMember` - Ban/unban
- `restrictChatMember` - 限制权限 - `restrictChatMember` - Restrict permissions
- `promoteChatMember` - 提升管理员 - `promoteChatMember` - Promote to admin
- `setChatTitle` / `setChatDescription` - 设置信息 - `setChatTitle` / `setChatDescription` - Set chat info
- `setChatPhoto` - 设置头像 - `setChatPhoto` - Set chat photo
- `pinChatMessage` / `unpinChatMessage` - 置顶消息 - `pinChatMessage` / `unpinChatMessage` - Pin/unpin a message
## Mini Apps API 详解 ## Mini Apps API Details
### 初始化 ### Initialization
```javascript ```javascript
const tg = window.Telegram.WebApp; const tg = window.Telegram.WebApp;
tg.ready(); tg.ready();
tg.expand(); tg.expand();
``` ```
### 主要对象 ### Main Objects
- **WebApp** - 主接口 - **WebApp** - Main interface
- **MainButton** - 主按钮 - **MainButton** - Main button
- **SecondaryButton** - 次要按钮 - **SecondaryButton** - Secondary button
- **BackButton** - 返回按钮 - **BackButton** - Back button
- **SettingsButton** - 设置按钮 - **SettingsButton** - Settings button
- **HapticFeedback** - 触觉反馈 - **HapticFeedback** - Haptic feedback
- **CloudStorage** - 云存储 - **CloudStorage** - Cloud storage
- **BiometricManager** - 生物识别 - **BiometricManager** - Biometrics
- **LocationManager** - 位置服务 - **LocationManager** - Location services
- **Accelerometer** - 加速度计 - **Accelerometer** - Accelerometer
- **Gyroscope** - 陀螺仪 - **Gyroscope** - Gyroscope
- **DeviceOrientation** - 设备方向 - **DeviceOrientation** - Device orientation
### 事件系统 ### Event System
40+ 事件包括： 40+ events including:
- `themeChanged` - 主题改变 - `themeChanged` - Theme changed
- `viewportChanged` - 视口改变 - `viewportChanged` - Viewport changed
- `mainButtonClicked` - 主按钮点击 - `mainButtonClicked` - Main button clicked
- `backButtonClicked` - 返回按钮点击 - `backButtonClicked` - Back button clicked
- `settingsButtonClicked` - 设置按钮点击 - `settingsButtonClicked` - Settings button clicked
- `invoiceClosed` - 支付完成 - `invoiceClosed` - Payment completed
- `popupClosed` - 弹窗关闭 - `popupClosed` - Popup closed
- `qrTextReceived` - 扫码结果 - `qrTextReceived` - QR code scan result
- `clipboardTextReceived` - 剪贴板文本 - `clipboardTextReceived` - Clipboard text
- `writeAccessRequested` - 写入权限请求 - `writeAccessRequested` - Write access requested
- `contactRequested` - 联系人请求 - `contactRequested` - Contact requested
### 主题参数 ### Theme Parameters
```javascript ```javascript
tg.themeParams = { tg.themeParams = {
bg_color, // 背景色 bg_color, // Background color
text_color, // 文本色 text_color, // Text color
hint_color, // 提示色 hint_color, // Hint color
link_color, // 链接色 link_color, // Link color
button_color, // 按钮色 button_color, // Button color
button_text_color, // 按钮文本色 button_text_color, // Button text color
secondary_bg_color, // 次要背景色 secondary_bg_color, // Secondary background color
header_bg_color, // 头部背景色 header_bg_color, // Header background color
accent_text_color, // 强调文本色 accent_text_color, // Accent text color
section_bg_color, // 区块背景色 section_bg_color, // Section background color
section_header_text_color, // 区块头文本色 section_header_text_color, // Section header text color
subtitle_text_color, // 副标题色 subtitle_text_color, // Subtitle color
destructive_text_color // 危险操作色 destructive_text_color // Destructive action color
} }
``` ```
## 开发工具 ## Development Tools
### @BotFather 命令 ### @BotFather Commands
创建和管理 Bot 的核心工具： The core tool for creating and managing Bots:
**Bot 管理：** **Bot Management:**
- `/newbot` - 创建新 Bot - `/newbot` - Create a new Bot
- `/mybots` - 管理我的 Bots - `/mybots` - Manage my Bots
- `/deletebot` - 删除 Bot - `/deletebot` - Delete a Bot
- `/token` - 重新生成 token - `/token` - Regenerate a token
**设置命令：** **Settings Commands:**
- `/setname` - 设置名称 - `/setname` - Set name
- `/setdescription` - 设置描述 - `/setdescription` - Set description
- `/setabouttext` - 设置关于文本 - `/setabouttext` - Set about text
- `/setuserpic` - 设置头像 - `/setuserpic` - Set user picture
**功能配置：** **Feature Configuration:**
- `/setcommands` - 设置命令列表 - `/setcommands` - Set command list
- `/setinline` - 启用内联模式 - `/setinline` - Enable inline mode
- `/setinlinefeedback` - 内联反馈 - `/setinlinefeedback` - Inline feedback
- `/setjoingroups` - 允许加入群组 - `/setjoingroups` - Allow joining groups
- `/setprivacy` - 隐私模式 - `/setprivacy` - Privacy mode
**支付和游戏：** **Payments and Games:**
- `/setgamescores` - 游戏分数 - `/setgamescores` - Game scores
- `/setpayments` - 配置支付 - `/setpayments` - Configure payments
**Mini Apps：** **Mini Apps:**
- `/newapp` - 创建 Mini App - `/newapp` - Create a Mini App
- `/myapps` - 管理 Mini Apps - `/myapps` - Manage Mini Apps
- `/setmenubutton` - 设置菜单按钮 - `/setmenubutton` - Set menu button
### API ID 获取 ### Getting an API ID
访问 https://my.telegram.org Visit https://my.telegram.org
1. 登录账号 1. Log in to your account
2. 进入 API development tools 2. Go to API development tools
3. 创建应用 3. Create an application
4. 获取 API ID 和 API Hash 4. Get your API ID and API Hash
## 常用 Python 库 ## Common Python Libraries
### python-telegram-bot ### python-telegram-bot
```bash ```bash
pip install python-telegram-bot pip install python-telegram-bot
``` ```
**特点：** **Features:**
- 完整的 Bot API 包装 - Complete Bot API wrapper
- 异步和同步支持 - Asynchronous and synchronous support
- 丰富的扩展 - Rich extensions
- 活跃维护 - Actively maintained
**基础示例：** **Basic Example:**
```python ```python
from telegram import Update from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes from telegram.ext import Application, CommandHandler, ContextTypes
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE): async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
await update.message.reply_text('你好！') await update.message.reply_text('Hello!')
app = Application.builder().token("TOKEN").build() app = Application.builder().token("TOKEN").build()
app.add_handler(CommandHandler("start", start)) app.add_handler(CommandHandler("start", start))
@ -267,25 +266,25 @@ app.run_polling()
pip install aiogram pip install aiogram
``` ```
**特点：** **Features:**
- 纯异步 - Purely asynchronous
- 高性能 - High performance
- FSM 状态机 - FSM state machine
- 中间件系统 - Middleware system
### Telethon / Pyrogram ### Telethon / Pyrogram
MTProto 客户端库： MTProto client libraries:
```bash ```bash
pip install telethon pip install telethon
pip install pyrogram pip install pyrogram
``` ```
**用途：** **Uses:**
- 自定义客户端 - Custom clients
- 用户账号自动化 - User account automation
- 完整 Telegram 功能 - Full Telegram functionality
## 常用 Node.js 库 ## Common Node.js Libraries
### node-telegram-bot-api ### node-telegram-bot-api
```bash ```bash
@ -297,25 +296,25 @@ npm install node-telegram-bot-api
npm install telegraf npm install telegraf
``` ```
**特点：** **Features:**
- 现代化 - Modern
- 中间件架构 - Middleware architecture
- TypeScript 支持 - TypeScript support
### grammY ### grammY
```bash ```bash
npm install grammy npm install grammy
``` ```
**特点：** **Features:**
- 轻量级 - Lightweight
- 类型安全 - Type-safe
- 插件生态 - Plugin ecosystem
## 部署选项 ## Deployment Options
### Webhook 托管 ### Webhook Hosting
**推荐平台：** **Recommended Platforms:**
- Heroku - Heroku
- AWS Lambda - AWS Lambda
- Google Cloud Functions - Google Cloud Functions
@ -324,142 +323,142 @@ npm install grammy
- Railway - Railway
- Render - Render
**要求：** **Requirements:**
- HTTPS 支持 - HTTPS support
- 公网可访问 - Publicly accessible
- 支持的端口：443, 80, 88, 8443 - Supported ports: 443, 80, 88, 8443
### 长轮询托管 ### Long Polling Hosting
**推荐平台：** **Recommended Platforms:**
- VPS (Vultr, DigitalOcean, Linode) - VPS (Vultr, DigitalOcean, Linode)
- Raspberry Pi - Raspberry Pi
- 本地服务器 - Local server
**优点：** **Advantages:**
- 无需 HTTPS - No HTTPS required
- 简单配置 - Simple configuration
- 适合开发测试 - Suitable for development and testing
## 安全最佳实践 ## Security Best Practices
1. **Token 安全** 1. **Token Security**
- 不要提交到 Git - Do not commit to Git
- 使用环境变量 - Use environment variables
- 定期轮换 - Rotate tokens regularly
2. **数据验证** 2. **Data Validation**
- 验证 initData - Validate initData
- 服务器端验证 - Server-side validation
- 不信任客户端 - Do not trust the client
3. **权限控制** 3. **Permission Control**
- 检查用户权限 - Check user permissions
- 管理员验证 - Admin verification
- 群组权限 - Group permissions
4. **速率限制** 4. **Rate Limiting**
- 实现请求限制 - Implement request limits
- 防止滥用 - Prevent abuse
- 监控异常 - Monitor for anomalies
## 调试技巧 ## Debugging Tips
### Bot 调试 ### Bot Debugging
```python ```python
import logging import logging
logging.basicConfig(level=logging.DEBUG) logging.basicConfig(level=logging.DEBUG)
``` ```
### Mini App 调试 ### Mini App Debugging
```javascript ```javascript
// 开启调试模式 // Enable debug mode
tg.showAlert(JSON.stringify(tg.initDataUnsafe, null, 2)); tg.showAlert(JSON.stringify(tg.initDataUnsafe, null, 2));
// 控制台日志 // Console logs
console.log('WebApp version:', tg.version); console.log('WebApp version:', tg.version);
console.log('Platform:', tg.platform); console.log('Platform:', tg.platform);
console.log('Theme:', tg.colorScheme); console.log('Theme:', tg.colorScheme);
``` ```
### Webhook 测试 ### Webhook Testing
使用 ngrok 本地测试： Use ngrok for local testing:
```bash ```bash
ngrok http 5000 ngrok http 5000
# 将生成的 https URL 设置为 webhook # Set the generated https URL as the webhook
``` ```
## 社区资源 ## Community Resources
- **Telegram 开发者群组**: @BotDevelopers - **Telegram Developer Group**: @BotDevelopers
- **Telegram API 讨论**: @TelegramBots - **Telegram API Discussion**: @TelegramBots
- **Mini Apps 讨论**: @WebAppChat - **Mini Apps Discussion**: @WebAppChat
## 更新日志 ## Changelog
**最新功能：** **Latest Features:**
- Paid Media (付费媒体) - Paid Media
- Checklist Tasks (检查列表任务) - Checklist Tasks
- Gift Conversion (礼物转换) - Gift Conversion
- Business Features (商业功能) - Business Features
- Poll 选项增加到 12 个 - Poll options increased to 12
- Story 发布和编辑 - Story publishing and editing
--- ---
## 完整实现模板 (新增) ## Complete Implementation Templates (New)
### Telegram Bot 按钮和键盘实现指南 ### Telegram Bot Button and Keyboard Implementation Guide
**文件:** `Telegram_Bot_按钮和键盘实现模板.md` **File:** `Telegram_Bot_button_and_keyboard_implementation_template.md`
**行数:** 404 行 **Lines:** 404
**大小:** 12 KB **Size:** 12 KB
**语言:** 中文 **Language:** Chinese
精简实用的 Telegram Bot 交互式功能实现指南： A concise and practical guide to implementing interactive features for Telegram Bots:
**核心内容：** **Core Content:**
- 三种按钮类型详解（Inline/Reply/Command Menu） - Detailed explanation of three button types (Inline/Reply/Command Menu)
- python-telegram-bot 和 Telethon 双实现对比 - Comparison of implementations with python-telegram-bot and Telethon
- 完整的代码示例（即拿即用） - Complete code examples (ready to use)
- 项目结构和模块化设计 - Project structure and modular design
- Handler 优先级和事件处理 - Handler priority and event handling
- 生产环境部署方案 - Production deployment solutions
- 安全和错误处理最佳实践 - Security and error handling best practices
**特色：** **Features:**
- 核心代码精简，去除冗余示例 - Concise core code, removing redundant examples
- 聚焦常用场景和实用技巧 - Focus on common scenarios and practical tips
- 完整的快速参考表 - A complete quick reference table
--- ---
### 动态视图对齐 - 数据展示指南 ### Dynamic View Alignment - Data Display Guide
**文件:** `动态视图对齐实现文档.md` **File:** `dynamic-view-alignment-implementation-document.md`
**行数:** 407 行 **Lines:** 407
**大小:** 12 KB **Size:** 12 KB
**语言:** 中文 - **Language:** Chinese
专业的等宽字体数据对齐和格式化方案： A professional solution for monospaced font data alignment and formatting:
**核心功能：** **Core Features:**
- 智能动态视图对齐算法（三步法） - Intelligent dynamic view alignment algorithm (three-step method)
- 自动计算列宽，无需硬编码 - Automatic column width calculation, no hardcoding required
- 智能对齐规则（文本左，数字右） - Smart alignment rules (text left, numbers right)
- 完整的格式化系统： - Complete formatting system:
- 交易量智能缩写（B/M/K） - Smart abbreviation for trading volume (B/M/K)
- 价格智能精度（自适应小数位） - Smart precision for price (adaptive decimal places)
- 涨跌幅格式化（+/- 符号） - Formatting for price change percentage (+/- signs)
- 资金流向智能显示 - Smart display for fund flow
**应用场景：** **Use Cases:**
- 排行榜、数据表格、实时行情 - Leaderboards, data tables, real-time tickers
- 任何需要专业数据展示的 Telegram Bot - Any Telegram Bot that needs professional data display
**技术特点：** **Technical Features:**
- O(n×m) 线性复杂度，高效实用 - O(n×m) linear complexity, highly efficient
- 1000 行数据处理仅需 5-10ms - Processes 1000 rows of data in just 5-10ms
- 支持中文字符宽度扩展 - Supports Chinese character width expansion
**视觉效果示例：** **Visual Effect Example:**
``` ```
1. BTC $1.23B $45,000 +5.23% 1. BTC $1.23B $45,000 +5.23%
2. ETH $890.5M $2,500 +3.12% 2. ETH $890.5M $2,500 +3.12%
@ -468,4 +467,4 @@ ngrok http 5000
--- ---
**这些模板提供了从基础到生产级别的完整 Telegram Bot 开发解决方案！** **These templates provide a complete solution for Telegram Bot development, from basic to production level!**

404
i18n/en/skills/telegram-dev/references/telegram-bot-button-and-keyboard-implementation-template.md Normal file
View File

@ -0,0 +1,404 @@
# Telegram Bot Button and Keyboard Implementation Guide
> A complete reference for developing interactive features for Telegram Bots
---
## 📋 Table of Contents
1. [Button and Keyboard Types](#button-and-keyboard-types)
2. [Implementation Comparison](#implementation-comparison)
3. [Core Code Examples](#core-code-examples)
4. [Best Practices](#best-practices)
---
## Button and Keyboard Types
### 1. Inline Keyboard
**Features**:
- Displayed below a message
- Triggers a callback when clicked, without sending a message
- Supports callback data, URLs, switch queries, etc.
**Use Cases**: Confirmation/cancellation, menu navigation, pagination control, setting options
### 2. Reply Keyboard
**Features**:
- Displayed above the input field
- Sends a text message when a button is clicked
- Can be set as persistent or one-time
**Use Cases**: Quick commands, common actions, form input, main menu
### 3. Bot Command Menu
**Features**:
- Displayed in the "/" button to the left of the input field
- Set via BotFather or the API
- Provides a list of commands and their descriptions
**Use Cases**: Function index, new user guidance, quick command access
### 4. Type Comparison
| Feature | Inline | Reply | Command Menu |
|---|---|---|---|
| Position | Below message | Above input field | "/" menu |
| Trigger | Callback query | Text message | Command |
| Persistence | With message | Configurable | Always present |
| Scenario | Temporary interaction | Resident function | Command index |
---
## Implementation Comparison
### python-telegram-bot (Recommended for Bot development)
**Advantages**:
- Officially recommended, with a complete Handler system
- Rich support for buttons and keyboards
- Excellent performance with the asynchronous version
**Installation**:
```bash
pip install python-telegram-bot==20.7
```
### Telethon (Suitable for user account automation)
**Advantages**:
- Full access to the MTProto API
- Can be used with user accounts and Bots
- Powerful message listening capabilities
**Installation**:
```bash
pip install telethon cryptg
```
---
## Core Code Examples
### 1. Inline Keyboard Implementation
**python-telegram-bot:**
```python
from telegram import Update, InlineKeyboardButton, InlineKeyboardMarkup
from telegram.ext import Application, CommandHandler, CallbackQueryHandler, ContextTypes
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
"""Display an inline keyboard"""
keyboard = [
[
InlineKeyboardButton("📊 View Data", callback_data="view_data"),
InlineKeyboardButton("⚙️ Settings", callback_data="settings"),
],
[
InlineKeyboardButton("🔗 Visit Website", url="https://example.com"),
],
]
reply_markup = InlineKeyboardMarkup(keyboard)
await update.message.reply_text("Please choose:", reply_markup=reply_markup)
async def button_callback(update: Update, context: ContextTypes.DEFAULT_TYPE):
"""Handle button clicks"""
query = update.callback_query
await query.answer() # Must be called
if query.data == "view_data":
await query.edit_message_text("Displaying data...")
elif query.data == "settings":
await query.edit_message_text("Settings options...")
# Register handlers
app = Application.builder().token("TOKEN").build()
app.add_handler(CommandHandler("start", start))
app.add_handler(CallbackQueryHandler(button_callback))
app.run_polling()
```
**Telethon:**
```python
from telethon import TelegramClient, events, Button
client = TelegramClient('bot', api_id, api_hash).start(bot_token=BOT_TOKEN)
@client.on(events.NewMessage(pattern='/start'))
async def start(event):
buttons = [
[Button.inline("📊 View Data", b"view_data"), Button.inline("⚙️ Settings", b"settings")],
[Button.url("🔗 Visit Website", "https://example.com")]
]
await event.respond("Please choose:", buttons=buttons)
@client.on(events.CallbackQuery)
async def callback(event):
if event.data == b"view_data":
await event.edit("Displaying data...")
elif event.data == b"settings":
await event.edit("Settings options...")
client.run_until_disconnected()
```
### 2. Reply Keyboard Implementation
**python-telegram-bot:**
```python
from telegram import KeyboardButton, ReplyKeyboardMarkup, ReplyKeyboardRemove
async def menu(update: Update, context: ContextTypes.DEFAULT_TYPE):
"""Display a reply keyboard"""
keyboard = [
[KeyboardButton("📊 View Data"), KeyboardButton("⚙️ Settings")],
[KeyboardButton("📚 Help"), KeyboardButton("❌ Hide Keyboard")],
]
reply_markup = ReplyKeyboardMarkup(
keyboard,
resize_keyboard=True,
one_time_keyboard=False
)
await update.message.reply_text("Menu activated", reply_markup=reply_markup)
async def handle_text(update: Update, context: ContextTypes.DEFAULT_TYPE):
"""Handle text messages"""
text = update.message.text
if text == "📊 View Data":
await update.message.reply_text("Displaying data...")
elif text == "❌ Hide Keyboard":
await update.message.reply_text("Keyboard hidden", reply_markup=ReplyKeyboardRemove())
```
**Telethon:**
```python
@client.on(events.NewMessage(pattern='/menu'))
async def menu(event):
buttons = [
[Button.text("📊 View Data"), Button.text("⚙️ Settings")],
[Button.text("📚 Help"), Button.text("❌ Hide Keyboard")]
]
await event.respond("Menu activated", buttons=buttons)
@client.on(events.NewMessage)
async def handle_text(event):
if event.text == "📊 View Data":
await event.respond("Displaying data...")
```
### 3. Bot Command Menu Setup
**Via BotFather:**
```
1. Send /setcommands to @BotFather
2. Choose your Bot
3. Enter the list of commands (format per line: command - description)
start - Start the bot
help - Get help
menu - Display the main menu
settings - Configure settings
```
**Via API (python-telegram-bot):**
```python
from telegram import BotCommand
async def set_commands(app: Application):
"""Set the command menu"""
commands = [
BotCommand("start", "Start the bot"),
BotCommand("help", "Get help"),
BotCommand("menu", "Display the main menu"),
BotCommand("settings", "Configure settings"),
]
await app.bot.set_my_commands(commands)
# Call on startup
app.post_init = set_commands
```
### 4. Project Structure Example
```
telegram_bot/
├── bot.py # Main program
├── config.py # Configuration management
├── requirements.txt
├── .env
├── handlers/
│ ├── command_handlers.py # Command handlers
│ ├── callback_handlers.py # Callback handlers
│ └── message_handlers.py # Message handlers
├── keyboards/
│ ├── inline_keyboards.py # Inline keyboard layouts
│ └── reply_keyboards.py # Reply keyboard layouts
└── utils/
├── logger.py # Logger
└── database.py # Database
```
**Modular Example (keyboards/inline_keyboards.py):**
```python
from telegram import InlineKeyboardButton, InlineKeyboardMarkup
def get_main_menu():
"""Main menu keyboard"""
return InlineKeyboardMarkup([
[
InlineKeyboardButton("📊 Data", callback_data="data"),
InlineKeyboardButton("⚙️ Settings", callback_data="settings"),
],
[InlineKeyboardButton("📚 Help", callback_data="help")],
])
def get_data_menu():
"""Data menu keyboard"""
return InlineKeyboardMarkup([
[
InlineKeyboardButton("📈 Real-time", callback_data="data_realtime"),
InlineKeyboardButton("📊 History", callback_data="data_history"),
],
[InlineKeyboardButton("⬅️ Back", callback_data="back")],
])
```
---
## Best Practices
### 1. Handler Priority
```python
# Match in order of registration, from most specific to most general
app.add_handler(CommandHandler("start", start)) # 1. Specific command
app.add_handler(CallbackQueryHandler(callback)) # 2. Callback query
app.add_handler(ConversationHandler(...)) # 3. Conversation flow
app.add_handler(MessageHandler(filters.TEXT, text_msg)) # 4. General message (last)
```
### 2. Error Handling
```python
async def error_handler(update: Update, context: ContextTypes.DEFAULT_TYPE):
"""Global error handler"""
logger.error(f"Update {update} caused error", exc_info=context.error)
# Notify the user
if update and update.effective_message:
await update.effective_message.reply_text("Operation failed, please try again")
app.add_error_handler(error_handler)
```
### 3. Callback Data Management
```python
# Use structured callback_data
callback_data = "action:page:item" # e.g., "view:1:product_123"
# Parse callback data
async def callback(update: Update, context: ContextTypes.DEFAULT_TYPE):
query = update.callback_query
parts = query.data.split(":")
action, page, item = parts
if action == "view":
await show_item(query, page, item)
```
### 4. Keyboard Design Principles
- **Concise**: 2-3 buttons per row at most
- **Clear**: Use emojis to enhance recognition
- **Consistent**: Maintain a uniform layout style
- **Responsive**: Provide timely feedback to user actions
### 5. Security Considerations
```python
# Verify user permissions
ADMIN_IDS = [123456789]
async def admin_only(update: Update, context: ContextTypes.DEFAULT_TYPE):
user_id = update.effective_user.id
if user_id not in ADMIN_IDS:
await update.message.reply_text("Permission denied")
return
# Execute admin operations
```
### 6. Deployment Solutions
**Webhook (Recommended for production):**
```python
from flask import Flask, request
app_flask = Flask(__name__)
@app_flask.route('/webhook', methods=['POST'])
def webhook():
update = Update.de_json(request.get_json(), bot)
application.update_queue.put(update)
return "OK"
# Set webhook
bot.set_webhook(f"https://yourdomain.com/webhook")
```
**Systemd Service (Linux):**
```ini
[Unit]
Description=Telegram Bot
After=network.target
[Service]
Type=simple
User=your_user
WorkingDirectory=/path/to/bot
ExecStart=/path/to/venv/bin/python bot.py
Restart=always
[Install]
WantedBy=multi-user.target
```
### 7. Common Library Versions
```txt
# requirements.txt
python-telegram-bot==20.7
python-dotenv==1.0.0
aiosqlite==0.19.0
httpx==0.25.2
```
---
## Quick Reference
### Inline Keyboard Button Types
```python
InlineKeyboardButton("Text", callback_data="data") # Callback button
InlineKeyboardButton("Link", url="https://...") # URL button
InlineKeyboardButton("Switch", switch_inline_query="") # Inline query
InlineKeyboardButton("Login", login_url=...) # Login button
InlineKeyboardButton("Pay", pay=True) # Payment button
InlineKeyboardButton("App", web_app=WebAppInfo(...)) # Mini App
```
### Common Event Types
- `events.NewMessage` - New message
- `events.CallbackQuery` - Callback query
- `events.InlineQuery` - Inline query
- `events.ChatAction` - Group action
---
**This guide covers all the core implementations of Telegram Bot buttons and keyboards!**

0
i18n/en/skills/timescaledb/assets/.gitkeep Normal file
View File

77
i18n/zh/documents/README.md
View File

@ -14,6 +14,9 @@ i18n/zh/documents/
│ ├── 02-开发环境搭建.md │ ├── 02-开发环境搭建.md
│ └── 03-IDE配置.md │ └── 03-IDE配置.md
│ │
├── 胶水编程/ # 🧬 Glue Coding 革命性范式
│ └── README.md
│
├── 方法论与原则/ ├── 方法论与原则/
│ ├── A Formalization of Recursive Self-Optimizing Generative Systems.md │ ├── A Formalization of Recursive Self-Optimizing Generative Systems.md
│ ├── gluecoding.md │ ├── gluecoding.md
@ -21,24 +24,34 @@ i18n/zh/documents/
│ ├── 学习经验.md │ ├── 学习经验.md
│ ├── 开发经验.md │ ├── 开发经验.md
│ ├── 编程之道.md │ ├── 编程之道.md
│ ├── 胶水编程.md
│ └── 系统提示词构建原则.md │ └── 系统提示词构建原则.md
│ │
├── 教程与指南/ ├── 教程与指南/
│ ├── auggie-mcp配置文档.md │ ├── auggie-mcp配置文档.md
│ ├── LazyVim快捷键大全.md │ ├── LazyVim快捷键大全.md
│ ├── tmux快捷键大全.md │ ├── tmux快捷键大全.md
│ ├── 关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md │ └── 关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md
│ └── telegram-dev/
│ │
├── 模板与资源/ ├── 模板与资源/
│ ├── 代码组织.md │ ├── 代码组织.md
│ ├── 工具集.md │ ├── 工具集.md
│ ├── 编程书籍推荐.md │ ├── 编程书籍推荐.md
│ └── 通用项目架构模板.md │ ├── 通用项目架构模板.md
│ └── memory-bank-template/
│ │
└── 项目实战经验/ ├── 外部资源聚合/ # 🔗 外部链接汇总
└── telegram-dev/ │ ├── AI工具与平台/
│ ├── GitHub精选仓库/
│ ├── 提示词资源/
│ ├── 开发工具/
│ ├── 教程与课程/
│ └── 社区与论坛/
│
└── 项目实战经验/ # 📁 实战案例
├── fate-engine-dev/
├── polymarket-dev/
├── telegram-dev/
└── ...
``` ```
## 文档分类 ## 文档分类
@ -52,43 +65,57 @@ i18n/zh/documents/
* [02-开发环境搭建](./从零开始vibecoding/02-开发环境搭建.md) - 搭建开发环境（提示词版） * [02-开发环境搭建](./从零开始vibecoding/02-开发环境搭建.md) - 搭建开发环境（提示词版）
* [03-IDE配置](./从零开始vibecoding/03-IDE配置.md) - 配置 VS Code / Cursor / Windsurf * [03-IDE配置](./从零开始vibecoding/03-IDE配置.md) - 配置 VS Code / Cursor / Windsurf
### 🧬 胶水编程 (Glue Coding)
**软件工程的圣杯与银弹。** 彻底解决 Vibe Coding 的幻觉、复杂性和门槛问题。
* [胶水编程介绍](./胶水编程/README.md) - 革命性编程范式
### 方法论与原则 ### 方法论与原则
关于编程思想、开发哲学和项目核心原则的文档。 关于编程思想、开发哲学和项目核心原则的文档。
* `A Formalization of Recursive Self-Optimizing Generative Systems.md` * `A Formalization of Recursive Self-Optimizing Generative Systems.md` - 递归自优化系统形式化
* `gluecoding.md` * `gluecoding.md` - 胶水编程理论
* `vibe-coding-经验收集.md` * `vibe-coding-经验收集.md` - 经验汇总
* `学习经验.md` * `学习经验.md` - 学习心得
* `开发经验.md` * `开发经验.md` - 开发实践
* `编程之道.md` * `编程之道.md` - 编程哲学
* `胶水编程.md` * `系统提示词构建原则.md` - 提示词工程
* `系统提示词构建原则.md`
### 教程与指南 ### 教程与指南
具体工具的配置、使用指南和操作教程。 具体工具的配置、使用指南和操作教程。
* `auggie-mcp配置文档.md` * `auggie-mcp配置文档.md` - Augment MCP 配置
* `LazyVim快捷键大全.md` * `LazyVim快捷键大全.md` - LazyVim 快捷键
* `tmux快捷键大全.md` * `tmux快捷键大全.md` - tmux 快捷键
* `关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md` * `关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md` - 远程开发
* `telegram-dev/`
### 模板与资源 ### 模板与资源
可复用的项目模板、代码结构规范和资源列表。 可复用的项目模板、代码结构规范和资源列表。
* `代码组织.md` * `代码组织.md` - 代码组织规范
* `工具集.md` * `工具集.md` - 工具推荐
* `编程书籍推荐.md` * `编程书籍推荐.md` - 书籍推荐
* `通用项目架构模板.md` * `通用项目架构模板.md` - 项目模板
* `memory-bank-template/` - Memory Bank 模板
### 项目实战经验 ### 🔗 外部资源聚合
外部优质资源汇总，持续更新。
* [外部资源聚合](./外部资源聚合/README.md) - 总索引
### 📁 项目实战经验
实际项目开发中的经验总结和案例。 实际项目开发中的经验总结和案例。
* `telegram-dev/` - Telegram Bot 开发经验 * [项目实战经验](./项目实战经验/README.md) - 总索引
* `fate-engine-dev/` - 命理引擎开发
* `polymarket-dev/` - Polymarket 数据分析
* `telegram-dev/` - Telegram Bot 开发
## 相关资源 ## 相关资源

172
i18n/zh/documents/胶水编程/README.md Normal file
View File

@ -0,0 +1,172 @@
# 🧬 胶水编程 (Glue Coding)
> **软件工程的圣杯与银弹——终于出现了。**
---
## 🚀 颠覆性宣言
**胶水编程不是一种技术，而是一场革命。**
它可能完美解决了 Vibe Coding 的三大致命缺陷：
| 传统 Vibe Coding 的痛点 | 胶水编程的解法 |
|:---|:---|
| 🎭 **AI 幻觉** - 生成不存在的 API、错误的逻辑 | ✅ **零幻觉** - 只使用已验证的成熟代码 |
| 🧩 **复杂性爆炸** - 项目越大越失控 | ✅ **复杂性归零** - 每个模块都是久经考验的轮子 |
| 🎓 **门槛过高** - 需要深厚编程功底才能驾驭 AI | ✅ **门槛消失** - 你只需要描述"连接方式" |
---
## 💡 核心理念
```
传统编程：人写代码
Vibe Coding：AI 写代码，人审代码
胶水编程：AI 连接代码，人审连接
```
### 范式转移
**从「生成」到「连接」的根本性转变：**
- ❌ 不再让 AI 从零生成代码（幻觉的根源）
- ❌ 不再重复造轮子（复杂性的根源）
- ❌ 不再要求你理解每一行代码（门槛的根源）
- ✅ 只复用成熟的、经过生产验证的开源项目
- ✅ AI 的唯一职责：理解你的意图，将模块连接起来
- ✅ 你的唯一职责：描述清楚「输入是什么，输出要什么」
---
## 🏗️ 架构哲学
```
┌─────────────────────────────────────────────────────────┐
│ 你的业务需求 │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ AI 胶水层 (Glue Layer) │
│ │
│ "我理解你要做什么，让我把这些积木连起来" │
│ │
└─────────────────────────────────────────────────────────┘
│
┌────────────────┼────────────────┐
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 成熟模块 A │ │ 成熟模块 B │ │ 成熟模块 C │
│ (10万+ ⭐) │ │ (生产验证) │ │ (官方 SDK) │
└─────────────┘ └─────────────┘ └─────────────┘
```
**实体 (Entity)**：成熟的开源项目、官方 SDK、久经考验的库
**连接 (Link)**：AI 生成的胶水代码，负责数据流转和接口适配
**功能 (Function)**：你描述的业务目标
---
## 🎯 为什么这是银弹？
### 1. 幻觉问题 → 彻底消失
AI 不再需要"发明"任何东西。它只需要：
- 阅读模块 A 的文档
- 阅读模块 B 的文档
- 写出 A → B 的数据转换
**这是 AI 最擅长的事情，也是最不容易出错的事情。**
### 2. 复杂性问题 → 转嫁给社区
每个模块背后都有：
- 数千个 Issue 的讨论
- 数百个贡献者的智慧
- 数年的生产环境打磨
**你不是在管理复杂性，你是在站在巨人的肩膀上。**
### 3. 门槛问题 → 降到最低
你不需要懂：
- 底层实现原理
- 最佳实践细节
- 边界情况处理
你只需要会说人话：
> "我要把 Telegram 的消息，经过 GPT 处理，存到 PostgreSQL"
**AI 会帮你找到最合适的轮子，然后把它们粘起来。**
---
## 📋 实践流程
```
1. 明确目标
└─→ "我要实现 XXX 功能"
2. 寻找轮子
└─→ "有没有成熟的库/项目已经做过类似的事？"
└─→ 让 AI 帮你搜索、评估、推荐
3. 理解接口
└─→ 把官方文档喂给 AI
└─→ AI 总结：输入是什么，输出是什么
4. 描述连接
└─→ "A 的输出要变成 B 的输入"
└─→ AI 生成胶水代码
5. 验证运行
└─→ 跑通 → 完成
└─→ 报错 → 把错误扔给 AI，继续粘
```
---
## 🔥 经典案例
### 案例：Polymarket 数据分析 Bot
**需求**：实时获取 Polymarket 数据，分析后推送到 Telegram
**传统做法**：从零写爬虫、写分析逻辑、写 Bot → 3000 行代码，2 周时间
**胶水做法**：
```
轮子 1: polymarket-py (官方 SDK)
轮子 2: pandas (数据分析)
轮子 3: python-telegram-bot (消息推送)
胶水代码: 50 行
开发时间: 2 小时
```
---
## 📚 延伸阅读
- [胶水开发提示词](../../prompts/coding_prompts/胶水开发.md)
- [项目实战：polymarket-dev](../项目实战经验/polymarket-dev/)
---
## 🎖️ 总结
> **能抄不写，能连不造，能复用不原创。**
胶水编程是 Vibe Coding 的终极进化形态。
它不是偷懒，而是**工程智慧的最高体现**——
用最少的原创代码，撬动最大的生产力。
**这就是软件工程等待了 50 年的银弹。**
---
*"The best code is no code at all. The second best is glue code."*

0
i18n/zh/documents/方法论与原则/胶水编程.md → i18n/zh/documents/胶水编程/胶水编程.md
View File