diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5a1d47f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,333 @@
+# MyClaude
+
+一个基于 Claude Code 的个人助理工具，支持通过飞书机器人进行远程交互。
+
+## 功能特性
+
+- 🤖 多模型支持：Claude、DeepSeek、Kimi、Kimi Code
+- 💬 飞书机器人集成：随时随地与 AI 助手对话
+- 📝 智能记忆：自动保存对话历史和项目上下文
+- 🔧 技能扩展：支持自定义 Skill 增强功能
+
+## 视频教程
+
+📺 **部署流程详解**：[Bilibili - MyClaude 完整部署指南](https://www.bilibili.com/video/BV15TPrzeELm/)
+
+## 准备工作
+
+### 1. 安装 Claude Code
+
+**macOS/Linux:**
+
+```bash
+# 官方安装脚本
+curl -fsSL https://claude.ai/install.sh | sh
+
+# 或使用 npm
+npm install -g @anthropic-ai/claude-code
+```
+
+**Windows:**
+
+```powershell
+# 方式1：PowerShell 安装（推荐）
+irm https://claude.ai/install.ps1 | iex
+
+# 方式2：WinGet（Windows 包管理器）
+winget install Anthropic.ClaudeCode
+
+# 方式3：npm（需先安装 Node.js 18+）
+npm install -g @anthropic-ai/claude-code
+```
+
+> **注意**：Windows 用户需先安装 [Git for Windows](https://git-scm.com/download/win)。2025 年后 Claude Code 已提供原生 Windows 支持，不再需要 WSL2。
+>
+> **来源**：[Claude Code 官方文档](https://code.claude.com/docs/en/quickstart)
+
+### 2. 开通大模型会员（推荐）
+
+为获得更好的使用体验，建议开通以下服务：
+
+| 服务 | 说明 | 开通地址 |
+|------|------|---------|
+| DeepSeek | 国产高性能大模型 | https://platform.deepseek.com |
+| Kimi | 长文本处理专家 | https://kimi.moonshot.cn |
+| Kimi Code | 代码专用模型 | Kimi 内开通 Code 会员 |
+
+### 3. 安装并配置 cc-switch
+
+cc-switch 用于在多个模型间快速切换：
+
+**macOS：**
+
+```bash
+# 方式1：Homebrew（推荐）
+brew tap farion1231/tap
+brew install cc-switch
+
+# 方式2：从 GitHub Releases 下载
+# 访问 https://github.com/farion1231/cc-switch/releases 下载对应系统版本
+```
+
+**Windows：**
+
+```powershell
+# 方式1：MSI 安装程序（推荐）
+# 1. 访问 https://github.com/farion1231/cc-switch/releases
+# 2. 下载 .msi 安装包并运行
+# 3. 从开始菜单或桌面快捷方式启动
+
+# 方式2：便携版（免安装）
+# 下载 .zip 版本，解压后直接运行
+```
+
+**配置模型**：
+
+```bash
+# 配置模型
+cc-switch add deepseek --api-key YOUR_DEEPSEEK_KEY
+cc-switch add kimi --api-key YOUR_KIMI_KEY
+cc-switch add kimi-code --api-key YOUR_KIMI_KEY
+
+# 设置默认模型
+cc-switch default claude
+```
+
+> **来源**：[CC Switch GitHub](https://github.com/farion1231/cc-switch)
+
+### 4. 安装 Metabot
+
+Metabot 是飞书/Telegram/微信机器人的本地服务端，支持手机控制 Claude Code。
+
+**快速安装（全平台）：**
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/xvirobotics/metabot/main/install.sh | bash
+```
+
+```powershell
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/xvirobotics/metabot/main/install.ps1 | iex
+```
+
+**安装器会引导你完成：**
+1. 设置工作目录
+2. Claude Code 认证
+3. 选择 IM 平台（飞书/Telegram/微信）
+4. 配置机器人凭证
+5. PM2 自动启动设置
+
+**手动安装（备选）：**
+
+```bash
+# 克隆仓库
+git clone https://github.com/xvirobotics/metabot.git
+cd metabot
+
+# 安装依赖
+npm install
+
+# 复制配置模板
+cp bots.example.json bots.json
+cp .env.example .env
+
+# 编辑配置
+# - bots.json: 添加飞书/ Telegram 机器人凭证
+# - .env: 设置 API_SECRET 和 Claude API Key
+
+# 启动
+npm run dev
+```
+
+> **来源**：[Metabot GitHub](https://github.com/xvirobotics/metabot)
+
+### 5. 开通飞书并配置机器人
+
+#### 5.1 创建飞书应用
+
+1. 访问 [飞书开发者平台](https://open.feishu.cn/)
+2. 创建企业自建应用
+3. 启用机器人能力，获取 **AppID** 和 **AppSecret**
+
+#### 5.2 配置 Metabot
+
+创建 `bots.json` 文件：
+
+```json
+{
+  "myclaude": {
+    "app_id": "cli_xxxxx",
+    "app_secret": "xxxxxxxxxxxxx"
+  }
+}
+```
+
+**建议路径**：`~/Documents/myResearch/myProjects/apaam/repo/metabot/bots.json`
+
+> 💡 **提示**：复制上述模板，替换 `cli_xxxxx` 和 `xxxxxxxxxxxxx` 为你的飞书应用凭证。
+
+### 6. 启动与使用
+
+**启动飞书机器人**：
+
+```bash
+metabot start
+```
+
+**本地交互模式**：
+
+```bash
+# 在项目目录下
+myclaude chat
+```
+
+**飞书交互**：
+
+- 在飞书中找到你的机器人
+- 直接发送消息即可对话
+
+### 7. 首次使用引导
+
+第一次使用时，建议发送以下引导语：
+
+> "我是第一次使用这个 Claude 助手，请引导式地问我一些问题，帮我建立个性化的配置，并更新到 CLAUDE.md 中。"
+
+这将帮助助手了解你的：
+- 身份和专业背景
+- 技术栈和偏好
+- 工作习惯和沟通风格
+
+### 8. Workspace 管理建议
+
+为了更好地组织项目，建议在 `workspace/` 下创建子文件夹，并建立软连接：
+
+```bash
+# 进入 workspace
+cd workspace
+
+# 创建项目子目录
+mkdir myproject
+cd myproject
+
+# 建立常用目录的软连接
+ln -s ~/Documents/myWorks/works myWorks
+ln -s ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/myAcademia myAcademia
+
+# 告诉 Claude 这个结构
+# "我在 workspace/myproject 下工作，请帮我管理这个目录"
+```
+
+然后告诉 Claude：
+> "我在 workspace/myproject 下工作，已创建了常用目录的软连接，请帮我管理这个项目的开发。"
+
+## 常用指令
+
+| 指令 | 说明 |
+|------|------|
+| `/help` | 显示帮助信息 |
+| `/reset` | 重置当前对话（飞书回复错误时使用） |
+| `/stop` | 停止当前任务 |
+| `/skills` | 列出可用的技能 |
+| `/memory` | 查看记忆内容 |
+
+## 常见问题
+
+### Q1: 飞书机器人回复 error 或卡住
+
+**解决方案**：发送 `/reset` 重置对话，然后重新提问。
+
+### Q2: 如何切换模型？
+
+```bash
+# 查看可用模型
+cc-switch list
+
+# 切换到 DeepSeek
+cc-switch use deepseek
+
+# 切换到 Kimi Code（适合编程任务）
+cc-switch use kimi-code
+```
+
+### Q3: 如何添加自定义 Skill？
+
+```bash
+# 在 .claude/skills/ 下创建技能目录
+mkdir .claude/skills/my-skill
+
+# 创建 SKILL.md
+touch .claude/skills/my-skill/SKILL.md
+```
+
+### Q4: 飞书机器人不响应
+
+1. 检查 `metabot start` 是否正常启动
+2. 检查 `bots.json` 中的 AppID/AppSecret 是否正确
+3. 在飞书开发者平台检查机器人权限是否开启
+
+### Q5: Windows 上 Claude Code 找不到 Git Bash
+
+在 `~/.claude/settings.json` 中添加：
+
+```json
+{
+  "env": {
+    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
+  }
+}
+```
+
+### Q6: Metabot 在 Windows 上安装失败
+
+1. 确保 Node.js 20+ 已安装：`node --version`
+2. 确保 Git for Windows 已安装
+3. 检查 PowerShell 执行策略：`Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`
+4. 使用手动安装方式替代一键安装脚本
+
+### 9. 云盘同步与 Obsidian 集成（推荐）
+
+为了更好地与 Claude 交互文件和资料，建议：
+
+**创建云盘同步文件夹**：
+
+```bash
+# 在 iCloud 云盘创建文件夹
+mkdir -p ~/Library/Mobile\ Documents/iCloud~com~apple~CloudDocs/ClaudeWorkspace
+
+# 软连接到 workspace
+cd ~/Documents/myResearch/myProjects/apaam/repo/myclaude/workspace
+ln -s ~/Library/Mobile\ Documents/iCloud~com~apple~CloudDocs/ClaudeWorkspace iCloudSync
+```
+
+**使用 Obsidian 管理**：
+
+1. 安装 Obsidian（https://obsidian.md）
+2. 创建新 Vault，选择 `ClaudeWorkspace` 文件夹
+3. 使用 Obsidian 查看、编辑和管理 Claude 生成的文件
+
+**优势**：
+- 📱 跨设备同步：iPhone/iPad 上随时查看 Claude 生成的内容
+- 📝 双向编辑：在 Obsidian 中编辑后，Claude 可以读取更新
+- 🔍 快速检索：Obsidian 的搜索和链接功能方便资料管理
+- 📁 文件共享：通过 iCloud 方便地与 Claude 分享图片、PDF 等文件
+
+## 项目结构
+
+```
+myclaude/
+├── .claude/
+│   ├── skills/          # 自定义技能
+│   ├── memory/          # 持久化记忆
+│   └── conversations/   # 对话记录
+├── workspace/           # 工作目录
+│   ├── archives/        # 归档资料
+│   ├── references/      # 参考资料
+│   └── templates/       # 常用模板
+├── CLAUDE.md            # 项目配置（自动生成）
+└── README.md            # 本文件
+```
+
+## License
+
+MIT