-
-
- {post.title}
-
-
-
- {post.excerpt}
-
- {post.tags.map(tag => (
-
- #{tag}
-
- ))}
-
-
- )
-}
-```
-
-## 📝 示例文章格式
-
-```mdx
----
-title: "Hello World"
-date: "2024-01-01"
-tags: ["入门", "博客"]
-excerpt: "这是我的第一篇博客文章"
---
-# Hello World
-
-欢迎来到我的博客！
-
-## 代码示例
-
-```javascript
-console.log('Hello, Vibe Coding!')
-```
-
-## 总结
-
-这就是我的第一篇文章。
-```
-
-## 🚀 部署步骤
-
-1. 推送代码到 GitHub
-2. 在 Vercel 导入项目
-3. 自动部署完成
-
-## ✅ 验收清单
-
-- [ ] 首页正确显示文章列表
-- [ ] 点击文章可以进入详情页
-- [ ] 代码块有语法高亮
-- [ ] 标签页面可以筛选文章
-- [ ] 移动端显示正常
-- [ ] 部署到 Vercel 成功
-
-## 🔗 相关资源
-
-- [Next.js 文档](https://nextjs.org/docs)
-- [MDX 文档](https://mdxjs.com/)
-- [Tailwind CSS](https://tailwindcss.com/)
-
-## 💡 进阶挑战
-
-完成基础版本后，可以尝试：
-- 添加搜索功能
-- 添加评论系统（Giscus）
-- 添加 RSS 订阅
-- 添加暗色模式
-- 添加阅读时间估算
+*(内容待填充...)*
\ No newline at end of file
diff --git a/i18n/zh/documents/实战案例/04-cli-tool.md b/i18n/zh/documents/实战案例/04-cli-tool.md
index b10264f..cad94ae 100644
--- a/i18n/zh/documents/实战案例/04-cli-tool.md
+++ b/i18n/zh/documents/实战案例/04-cli-tool.md
@@ -1,298 +1,11 @@
-# 实战案例：命令行工具
+# 实战案例：开发一个高效的命令行工具 (CLI)
-> 难度：⭐⭐ 中等 | 预计时间：1-2 小时 | 技术栈：Python + Click
+> 本案例将指导您如何与 AI 协作，构思、设计并实现一个实用的命令行工具，例如一个文件处理器或信息查询工具。
-## 🎯 项目目标
+* **技术栈**: [待定，例如：Python (Typer/Click), Go (Cobra)]
+* **难度**: 初级到中级
+* **预计用时**: 4-6 小时
-构建一个实用的命令行工具，实现：
-- 文件批量重命名
-- 支持多种命名规则
-- 预览和确认机制
-- 彩色输出
+---
-## 📋 开始前的准备
-
-### 环境要求
-- Python 3.8+
-- pip
-
-### 第一步：需求澄清
-
-复制以下提示词给 AI：
-
-```
-我想用 Vibe Coding 的方式开发一个文件批量重命名的命令行工具。
-
-技术要求：
-- 语言：Python 3.8+
-- CLI 框架：Click
-- 输出美化：Rich
-
-功能需求：
-1. 支持多种重命名规则：
- - 添加前缀/后缀
- - 替换文本
- - 序号命名
- - 日期命名
-2. 预览模式（不实际执行）
-3. 递归处理子目录（可选）
-4. 支持文件类型过滤
-
-请帮我：
-1. 确认技术栈是否合适
-2. 生成项目结构
-3. 一步步指导我完成开发
-
-要求：每完成一步问我是否成功，再继续下一步。
-```
-
-## 🏗️ 项目结构
-
-```
-file-renamer/
-├── renamer/
-│ ├── __init__.py
-│ ├── cli.py # CLI 入口
-│ ├── core.py # 核心逻辑
-│ └── rules.py # 重命名规则
-├── tests/
-│ └── test_core.py
-├── pyproject.toml
-└── README.md
-```
-
-## 🔧 核心代码
-
-### CLI 入口 (renamer/cli.py)
-
-```python
-import click
-from rich.console import Console
-from rich.table import Table
-from .core import FileRenamer
-from .rules import PrefixRule, SuffixRule, ReplaceRule, SequenceRule
-
-console = Console()
-
-@click.group()
-@click.version_option(version='1.0.0')
-def cli():
- """文件批量重命名工具"""
- pass
-
-@cli.command()
-@click.argument('directory', type=click.Path(exists=True))
-@click.option('--prefix', '-p', help='添加前缀')
-@click.option('--suffix', '-s', help='添加后缀')
-@click.option('--replace', '-r', nargs=2, help='替换文本 (旧文本 新文本)')
-@click.option('--sequence', '-n', is_flag=True, help='序号命名')
-@click.option('--ext', '-e', multiple=True, help='文件扩展名过滤')
-@click.option('--recursive', '-R', is_flag=True, help='递归处理子目录')
-@click.option('--dry-run', '-d', is_flag=True, help='预览模式')
-def rename(directory, prefix, suffix, replace, sequence, ext, recursive, dry_run):
- """批量重命名文件"""
- renamer = FileRenamer(directory, recursive=recursive, extensions=ext)
-
- # 添加规则
- if prefix:
- renamer.add_rule(PrefixRule(prefix))
- if suffix:
- renamer.add_rule(SuffixRule(suffix))
- if replace:
- renamer.add_rule(ReplaceRule(replace[0], replace[1]))
- if sequence:
- renamer.add_rule(SequenceRule())
-
- if not renamer.rules:
- console.print("[red]错误：请至少指定一个重命名规则[/red]")
- return
-
- # 获取预览
- changes = renamer.preview()
-
- if not changes:
- console.print("[yellow]没有找到匹配的文件[/yellow]")
- return
-
- # 显示预览表格
- table = Table(title="重命名预览")
- table.add_column("原文件名", style="cyan")
- table.add_column("新文件名", style="green")
-
- for old, new in changes:
- table.add_row(old, new)
-
- console.print(table)
- console.print(f"\n共 [bold]{len(changes)}[/bold] 个文件")
-
- if dry_run:
- console.print("[yellow]预览模式，未执行实际操作[/yellow]")
- return
-
- # 确认执行
- if click.confirm('确认执行重命名？'):
- renamer.execute()
- console.print("[green]✓ 重命名完成！[/green]")
- else:
- console.print("[yellow]已取消[/yellow]")
-
-if __name__ == '__main__':
- cli()
-```
-
-### 核心逻辑 (renamer/core.py)
-
-```python
-import os
-from pathlib import Path
-from typing import List, Tuple
-
-class FileRenamer:
- def __init__(self, directory: str, recursive: bool = False, extensions: tuple = ()):
- self.directory = Path(directory)
- self.recursive = recursive
- self.extensions = extensions
- self.rules = []
-
- def add_rule(self, rule):
- self.rules.append(rule)
-
- def get_files(self) -> List[Path]:
- pattern = '**/*' if self.recursive else '*'
- files = []
- for path in self.directory.glob(pattern):
- if path.is_file():
- if self.extensions:
- if path.suffix.lower() in [f'.{e.lower()}' for e in self.extensions]:
- files.append(path)
- else:
- files.append(path)
- return sorted(files)
-
- def apply_rules(self, filename: str) -> str:
- result = filename
- for rule in self.rules:
- result = rule.apply(result)
- return result
-
- def preview(self) -> List[Tuple[str, str]]:
- changes = []
- for file in self.get_files():
- old_name = file.stem
- new_name = self.apply_rules(old_name)
- if old_name != new_name:
- changes.append((file.name, new_name + file.suffix))
- return changes
-
- def execute(self):
- for file in self.get_files():
- old_name = file.stem
- new_name = self.apply_rules(old_name)
- if old_name != new_name:
- new_path = file.parent / (new_name + file.suffix)
- file.rename(new_path)
-```
-
-### 重命名规则 (renamer/rules.py)
-
-```python
-from abc import ABC, abstractmethod
-
-class Rule(ABC):
- @abstractmethod
- def apply(self, filename: str) -> str:
- pass
-
-class PrefixRule(Rule):
- def __init__(self, prefix: str):
- self.prefix = prefix
-
- def apply(self, filename: str) -> str:
- return f"{self.prefix}{filename}"
-
-class SuffixRule(Rule):
- def __init__(self, suffix: str):
- self.suffix = suffix
-
- def apply(self, filename: str) -> str:
- return f"{filename}{self.suffix}"
-
-class ReplaceRule(Rule):
- def __init__(self, old: str, new: str):
- self.old = old
- self.new = new
-
- def apply(self, filename: str) -> str:
- return filename.replace(self.old, self.new)
-
-class SequenceRule(Rule):
- def __init__(self, start: int = 1, padding: int = 3):
- self.counter = start
- self.padding = padding
-
- def apply(self, filename: str) -> str:
- result = f"{str(self.counter).zfill(self.padding)}_{filename}"
- self.counter += 1
- return result
-```
-
-## 📦 安装配置 (pyproject.toml)
-
-```toml
-[build-system]
-requires = ["setuptools>=61.0"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "file-renamer"
-version = "1.0.0"
-description = "文件批量重命名工具"
-requires-python = ">=3.8"
-dependencies = [
- "click>=8.0",
- "rich>=13.0",
-]
-
-[project.scripts]
-renamer = "renamer.cli:cli"
-```
-
-## 🚀 使用示例
-
-```bash
-# 安装
-pip install -e .
-
-# 添加前缀
-renamer rename ./photos --prefix "2024_"
-
-# 替换文本
-renamer rename ./docs --replace "old" "new"
-
-# 序号命名 + 过滤扩展名
-renamer rename ./images --sequence --ext jpg --ext png
-
-# 预览模式
-renamer rename ./files --prefix "backup_" --dry-run
-
-# 递归处理
-renamer rename ./project --suffix "_v2" --recursive
-```
-
-## ✅ 验收清单
-
-- [ ] 命令行帮助信息正确显示
-- [ ] 前缀/后缀功能正常
-- [ ] 替换功能正常
-- [ ] 序号命名功能正常
-- [ ] 预览模式不执行实际操作
-- [ ] 扩展名过滤正常
-- [ ] 递归处理正常
-
-## 💡 进阶挑战
-
-- 添加撤销功能（记录操作日志）
-- 支持正则表达式
-- 添加日期格式化规则
-- 支持配置文件
-- 添加交互式模式
+*(内容待填充...)*
\ No newline at end of file
diff --git a/i18n/zh/documents/实战案例/05-chrome-extension.md b/i18n/zh/documents/实战案例/05-chrome-extension.md
index 52d26e8..708fa16 100644
--- a/i18n/zh/documents/实战案例/05-chrome-extension.md
+++ b/i18n/zh/documents/实战案例/05-chrome-extension.md
@@ -1,402 +1,11 @@
-# 实战案例：Chrome 扩展
+# 实战案例：制作一个浏览器扩展程序
-> 难度：⭐⭐ 中等 | 预计时间：2-3 小时 | 技术栈：JavaScript + Chrome API
+> 本案例将指导您如何与 AI 协作，开发一个简单的 Chrome 浏览器扩展，例如页面截图、内容聚合或自定义脚本注入工具。
-## 🎯 项目目标
+* **技术栈**: [JavaScript, HTML, CSS, Manifest V3]
+* **难度**: 中级
+* **预计用时**: 6-10 小时
-构建一个实用的 Chrome 扩展 - **网页笔记助手**：
-- 选中文本快速保存
-- 自动记录来源 URL
-- 本地存储笔记
-- 导出功能
+---
-## 📋 开始前的准备
-
-### 环境要求
-- Chrome 浏览器
-- 代码编辑器
-
-### 第一步：需求澄清
-
-复制以下提示词给 AI：
-
-```
-我想用 Vibe Coding 的方式开发一个 Chrome 扩展 - 网页笔记助手。
-
-技术要求：
-- Manifest V3
-- 纯 JavaScript（不用框架）
-- Chrome Storage API
-
-功能需求：
-1. 右键菜单：选中文本后右键保存
-2. 弹出窗口：显示所有笔记
-3. 自动记录：来源 URL、保存时间
-4. 导出功能：导出为 JSON/Markdown
-
-请帮我：
-1. 确认技术方案
-2. 生成项目结构
-3. 一步步指导我完成开发
-
-要求：每完成一步问我是否成功，再继续下一步。
-```
-
-## 🏗️ 项目结构
-
-```
-web-notes/
-├── manifest.json # 扩展配置
-├── background.js # 后台脚本
-├── popup/
-│ ├── popup.html # 弹出窗口
-│ ├── popup.css
-│ └── popup.js
-├── icons/
-│ ├── icon16.png
-│ ├── icon48.png
-│ └── icon128.png
-└── README.md
-```
-
-## 🔧 核心代码
-
-### 扩展配置 (manifest.json)
-
-```json
-{
- "manifest_version": 3,
- "name": "网页笔记助手",
- "version": "1.0.0",
- "description": "快速保存网页内容到本地笔记",
- "permissions": [
- "storage",
- "contextMenus",
- "activeTab"
- ],
- "background": {
- "service_worker": "background.js"
- },
- "action": {
- "default_popup": "popup/popup.html",
- "default_icon": {
- "16": "icons/icon16.png",
- "48": "icons/icon48.png",
- "128": "icons/icon128.png"
- }
- },
- "icons": {
- "16": "icons/icon16.png",
- "48": "icons/icon48.png",
- "128": "icons/icon128.png"
- }
-}
-```
-
-### 后台脚本 (background.js)
-
-```javascript
-// 创建右键菜单
-chrome.runtime.onInstalled.addListener(() => {
- chrome.contextMenus.create({
- id: 'saveNote',
- title: '保存到笔记',
- contexts: ['selection']
- });
-});
-
-// 处理右键菜单点击
-chrome.contextMenus.onClicked.addListener(async (info, tab) => {
- if (info.menuItemId === 'saveNote' && info.selectionText) {
- const note = {
- id: Date.now().toString(),
- text: info.selectionText,
- url: tab.url,
- title: tab.title,
- createdAt: new Date().toISOString()
- };
-
- // 获取现有笔记
- const { notes = [] } = await chrome.storage.local.get('notes');
-
- // 添加新笔记
- notes.unshift(note);
-
- // 保存
- await chrome.storage.local.set({ notes });
-
- // 显示通知（可选）
- console.log('笔记已保存:', note.text.slice(0, 50));
- }
-});
-```
-
-### 弹出窗口 HTML (popup/popup.html)
-
-```html
-
-
-
-