新增：文档体系重构+CHANGELOG补充+发布产物清理

docs/08-用户指南/GLM4.7-配置指南.md

@@ -0,0 +1,308 @@
+# Clawdbot + GLM-4.7 快速配置
+
+> **你的配置**：国内用户 + GLM Coding Plan 套餐（GLM-4.7）
+>
+> **通信方式**：Web 控制面板
+>
+> **目标**：5 分钟完成配置
+
+---
+
+## 🚀 快速配置（WSL2）
+
+### 第 1 步：进入 WSL2
+
+在 Windows PowerShell 中运行：
+
+```powershell
+wsl
+```
+
+### 第 2 步：配置 GLM-4.7
+
+在 WSL2 Ubuntu 终端中运行（一键复制）：
+
+```bash
+# 配置 GLM-4.7（替换你的 API KEY）
+echo 'export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"' >> ~/.bashrc && \
+echo 'export OPENAI_API_KEY="你的GLM_API_KEY"' >> ~/.bashrc && \
+echo 'export MODEL_NAME="glm-4-plus"' >> ~/.bashrc && \
+source ~/.bashrc && \
+echo "✅ 配置完成！验证如下：" && \
+echo "BASE_URL: $OPENAI_BASE_URL" && \
+echo "API_KEY: ${OPENAI_API_KEY:0:15}..." && \
+echo "MODEL: $MODEL_NAME"
+```
+
+**重要**：
+- 使用 `glm-4-plus` 作为模型名称（GLM-4.7 的别名）
+- 如果套餐中指定了其他模型名称，按套餐说明修改
+
+### 第 3 步：验证 API 连接
+
+```bash
+# 测试 GLM-4.7 API
+curl -X POST $OPENAI_BASE_URL/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -d '{
+    "model": "glm-4-plus",
+    "messages": [{"role": "user", "content": "你好，请用中文回复"}]
+  }'
+```
+
+如果返回 JSON 响应包含 AI 回复，说明配置成功！✅
+
+### 第 4 步：安装并启动 Clawdbot
+
+```bash
+# 安装 Clawdbot（如果还没安装）
+npm install -g clawdbot@latest
+
+# 启动网关（前台运行，测试用）
+clawdbot gateway --port 18789 --verbose
+```
+
+### 第 5 步：访问 Web 界面
+
+在浏览器中打开：
+
+```
+http://localhost:18789/
+```
+
+**如果无法访问**：
+
+```bash
+# 在 PowerShell（管理员）中运行，配置端口转发
+# 先获取 WSL2 IP
+wsl hostname -I
+
+# 然后配置端口转发（假设 WSL2 IP 是 172.x.x.x）
+netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=172.x.x.x
+```
+
+现在访问 `http://localhost:18789/` 应该可以打开控制面板了！
+
+---
+
+## 🎯 GLM-4.7 套餐模型说明
+
+### GLM Coding Plan 支持的模型
+
+根据你的套餐类型，可以使用以下模型：
+
+| 模型名称 | 说明 | 适用场景 |
+|---------|------|----------|
+| `glm-4-plus` | GLM-4.7 旗舰版 | 复杂推理、代码生成、多模态 |
+| `glm-4-flash` | 快速响应版 | 日常对话、简单任务 |
+| `glm-4-air` | 高性价比版 | 生产环境 |
+| `glm-4-0520` | 代码专用版 | 编程辅助 |
+
+**推荐配置**：
+- 如果你有 **Pro/Max 套餐**：使用 `glm-4-plus`
+- 如果你有 **Lite 套餐**：使用 `glm-4-flash` 或 `glm-4-air`
+
+### 修改模型
+
+如果需要切换模型：
+
+```bash
+# 编辑配置
+vim ~/.bashrc
+
+# 修改 MODEL_NAME
+export MODEL_NAME="glm-4-plus"  # 或其他模型
+
+# 重新加载
+source ~/.bashrc
+
+# 重启 Clawdbot
+# Ctrl+C 停止，然后重新运行
+clawdbot gateway --port 18789
+```
+
+---
+
+## ⚠️ GLM 套餐验证
+
+### 验证是否使用套餐额度
+
+**方法 1：查看控制台**
+
+1. 访问 [智谱AI控制台 - 套餐使用](https://open.bigmodel.cn/usercenter/billing)
+2. 发送几条测试消息
+3. 查看"套餐使用情况"是否减少
+
+**方法 2：使用 curl 测试**
+
+```bash
+# 发送测试请求
+curl -X POST $OPENAI_BASE_URL/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -d '{
+    "model": "glm-4-plus",
+    "messages": [{"role": "user", "content": "测试"}]
+  }' -v
+
+# 查看返回的速率限制头部
+# 如果显示套餐相关的限制信息，说明使用了套餐
+```
+
+### 如果消耗账户余额而非套餐
+
+**原因**：Clawdbot 不在 GLM 官方支持列表中
+
+**解决方案**：使用 One-API 中转
+
+```bash
+# 安装 One-API
+docker run -d --name one-api -p 3000:3000 \
+  -e TZ=Asia/Shanghai \
+  -v /root/data/one-api:/data \
+  ghcr.io/songquanpeng/one-api:latest
+
+# 访问 http://localhost:3000
+# 配置 GLM 套餐渠道
+
+# 修改 Clawdbot 配置使用 One-API
+export OPENAI_BASE_URL="http://localhost:3000/v1"
+export OPENAI_API_KEY="sk-one-api-token"
+
+# 重启 Clawdbot
+```
+
+---
+
+## 📊 GLM-4.7 性能特点
+
+GLM-4.7 是智谱AI 2025 年 12 月发布的最新旗舰模型：
+
+- ✅ **Vibe Coding 能力**：编程能力全球开源第一
+- ✅ **200K 长上下文**：支持长文本处理
+- ✅ **多模态支持**：文本、图像、代码
+- ✅ **复杂推理**：数学、科学、逻辑问题
+- ✅ **工具调用**：Function Calling、思考模式
+
+### 在 Clawdbot 中的使用场景
+
+1. **代码生成**：`请帮我写一个 Python 快速排序`
+2. **长文本分析**：`分析这个 100 页的 PDF 文档`
+3. **复杂推理**：`如何优化这个算法的时间复杂度？`
+4. **多轮对话**：保持上下文的深度讨论
+5. **工具调用**：让 AI 调用外部 API 完成任务
+
+---
+
+## 🔧 常用命令
+
+```bash
+# 启动 Clawdbot（前台）
+clawdbot gateway --port 18789 --verbose
+
+# 启动 Clawdbot（后台）
+nohup clawdbot gateway --port 18789 > ~/clawdbot.log 2>&1 &
+
+# 查看日志
+tail -f ~/clawdbot.log
+
+# 停止服务
+ps aux | grep clawdbot
+kill <进程ID>
+
+# 查看配置
+echo $OPENAI_BASE_URL
+echo $OPENAI_API_KEY
+echo $MODEL_NAME
+
+# 测试 API
+curl -X POST $OPENAI_BASE_URL/chat/completions \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"model":"glm-4-plus","messages":[{"role":"user","content":"测试"}]}'
+```
+
+---
+
+## ❓ 常见问题
+
+### Q1: 如何确认使用的是 GLM-4.7？
+
+**A**: 查看日志或测试响应：
+
+```bash
+# 启动时添加详细日志
+clawdbot gateway --port 18789 --verbose
+
+# 在日志中查找模型信息
+grep -i "model\|glm" ~/clawdbot.log
+```
+
+### Q2: 套餐额度不够用怎么办？
+
+**A**: 有三个选择：
+
+1. **等待 5 小时**：套餐额度会自动刷新
+2. **升级套餐**：Lite → Pro → Max
+3. **多账号轮换**：使用 One-API 配置多个账号
+
+### Q3: GLM-4.7 和其他模型的区别？
+
+**A**:
+
+| 特性 | GLM-4-Flash | GLM-4-Air | GLM-4-Plus (GLM-4.7) |
+|------|-------------|-----------|---------------------|
+| 速度 | 最快 | 快 | 中等 |
+| 质量 | 基础 | 良好 | 最佳 |
+| 成本 | 免费 | 低 | 中等 |
+| 适用 | 测试 | 生产 | 复杂任务 |
+
+### Q4: Web 界面访问不了？
+
+**A**: 检查防火墙和端口：
+
+```bash
+# 检查端口是否监听
+netstat -tlnp | grep 18789
+
+# 检查防火墙
+sudo ufw status
+
+# 如果防火墙开启，允许端口
+sudo ufw allow 18789
+
+# Windows 防火墙（PowerShell 管理员）
+New-NetFirewallRule -DisplayName "Clawdbot" -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow
+```
+
+### Q5: 如何设置开机自启？
+
+**A**: 使用 systemd 服务（前面已有完整配置）
+
+---
+
+## 🎉 完成！
+
+现在你已经成功配置了：
+
+- ✅ Clawdbot（在 WSL2 中运行）
+- ✅ GLM-4.7（使用你的套餐）
+- ✅ Web 控制面板（浏览器访问）
+
+**访问地址**：http://localhost:18789/
+
+**开始使用**：在 Web 界面中与 GLM-4.7 对话！
+
+---
+
+## 📚 下一步
+
+1. **测试对话**：在 Web 界面发送"你好"
+2. **尝试功能**：让 AI 帮你写代码、分析文档
+3. **配置自动化**：设置定时任务、消息推送
+4. **探索高级功能**：浏览器操作、文件管理等
+
+祝使用愉快！🚀
+
+有问题随时问我！

docs/08-用户指南/README.md

@@ -0,0 +1,22 @@
+# 用户指南
+
+本目录包含面向最终用户的使用文档和配置指南。
+
+## 📖 文档列表
+
+### 使用手册
+- [user-manual.md](./user-manual.md) - U-Desk 用户使用手册
+
+### AI 配置指南
+- [GLM4.7-配置指南.md](./GLM4.7-配置指南.md) - GLM4.7 模型配置详细指南
+- [Windows-GLM4.7-配置.md](./Windows-GLM4.7-配置.md) - Windows 环境专用配置指南
+- [clawdbot安装使用.md](./clawdbot安装使用.md) - Clawdbot 安装和使用说明
+- [clawdbot国内用户配置方案.md](./clawdbot国内用户配置方案.md) - 国内用户网络配置方案
+
+## 💡 使用建议
+
+1. **新用户**：先阅读 [user-manual.md](./user-manual.md) 了解基本功能
+2. **配置 AI**：根据您的环境选择对应的配置指南
+   - 国内用户 → [clawdbot国内用户配置方案.md](./clawdbot国内用户配置方案.md)
+   - Windows 用户 → [Windows-GLM4.7-配置.md](./Windows-GLM4.7-配置.md)
+3. **遇到问题**：查阅对应模块的文档或提交问题

docs/08-用户指南/Windows-GLM4.7-配置.md

@@ -0,0 +1,356 @@
+# Windows + Clawdbot + GLM-4.7 配置指南
+
+> **准确步骤**：从零开始，10 分钟完成配置
+>
+> **你的环境**：Windows + WSL2 + GLM Coding Plan (GLM-4.7)
+
+---
+
+## 第一步：打开 WSL2 Ubuntu
+
+在 Windows 中，按 `Win + R`，输入：
+```
+wsl
+```
+
+**或者**：打开 PowerShell，输入 `wsl` 回车
+
+---
+
+## 第二步：配置 GLM-4.7（在 WSL2 中执行）
+
+### 复制以下命令，粘贴到 WSL2 终端
+
+```bash
+echo 'export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"' >> ~/.bashrc && \
+echo 'export OPENAI_API_KEY="你的GLM_API_KEY"' >> ~/.bashrc && \
+echo 'export MODEL_NAME="glm-4-plus"' >> ~/.bashrc && \
+source ~/.bashrc
+```
+
+**重要**：
+- 将 `你的GLM_API_KEY` 替换为你的真实 API Key
+- 不要删除引号
+
+### 验证配置
+
+```bash
+echo $OPENAI_BASE_URL
+echo $OPENAI_API_KEY
+echo $MODEL_NAME
+```
+
+应该显示：
+- `https://open.bigmodel.cn/api/paas/v4/`
+- 你的 API Key
+- `glm-4-plus`
+
+---
+
+## 第三步：安装 Node.js 22（如果还没安装）
+
+在 WSL2 中执行：
+
+```bash
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+sudo apt-get install -y nodejs
+```
+
+验证安装：
+```bash
+node --version
+```
+应该显示：`v22.x.x`
+
+---
+
+## 第四步：安装 Clawdbot
+
+在 WSL2 中执行：
+
+```bash
+npm install -g clawdbot@latest
+```
+
+验证安装：
+```bash
+clawdbot --version
+```
+
+---
+
+## 第五步：启动 Clawdbot
+
+在 WSL2 中执行：
+
+```bash
+clawdbot gateway --port 18789
+```
+
+**看到以下输出说明成功**：
+```
+[INFO] Gateway starting on port 18789
+[INFO] Ready
+```
+
+---
+
+## 第六步：访问 Web 界面
+
+### 在 Windows 浏览器中打开
+
+```
+http://localhost:18789/
+```
+
+### 如果访问不了
+
+**在 PowerShell（管理员）中执行**：
+
+```powershell
+# 1. 获取 WSL2 IP
+wsl hostname -I
+
+# 2. 配置端口转发（替换下面的 IP 地址）
+netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=172.x.x.x
+```
+
+再次访问 `http://localhost:18789/`
+
+---
+
+## 第七步：测试对话
+
+在 Web 界面中输入：
+```
+你好
+```
+
+如果收到回复，配置成功！✅
+
+---
+
+## 完整配置命令（复制即用）
+
+### 在 WSL2 中一次性执行：
+
+```bash
+# 1. 配置 GLM-4.7（替换你的 API KEY）
+echo 'export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"' >> ~/.bashrc && \
+echo 'export OPENAI_API_KEY="你的GLM_API_KEY"' >> ~/.bashrc && \
+echo 'export MODEL_NAME="glm-4-plus"' >> ~/.bashrc && \
+source ~/.bashrc && \
+
+# 2. 安装 Node.js 22（如果需要）
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && \
+sudo apt-get install -y nodejs && \
+
+# 3. 安装 Clawdbot
+npm install -g clawdbot@latest && \
+
+# 4. 启动服务
+clawdbot gateway --port 18789
+```
+
+---
+
+## 常用操作
+
+### 查看 Clawdbot 日志
+
+启动时添加 `--verbose`：
+```bash
+clawdbot gateway --port 18789 --verbose
+```
+
+### 后台运行
+
+```bash
+nohup clawdbot gateway --port 18789 > ~/clawdbot.log 2>&1 &
+```
+
+查看日志：
+```bash
+tail -f ~/clawdbot.log
+```
+
+### 停止服务
+
+```bash
+ps aux | grep clawdbot
+kill <进程ID>
+```
+
+### 重启服务
+
+```bash
+# 停止
+ps aux | grep clawdbot
+kill <进程ID>
+
+# 启动
+clawdbot gateway --port 18789
+```
+
+---
+
+## 验证 GLM-4.7 连接
+
+在 WSL2 中执行：
+
+```bash
+curl -X POST https://open.bigmodel.cn/api/paas/v4/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -d '{
+    "model": "glm-4-plus",
+    "messages": [{"role": "user", "content": "你好"}]
+  }'
+```
+
+如果返回 JSON 包含 AI 回复，说明 API 连接正常。
+
+---
+
+## 配置文件位置
+
+```
+~/.bashrc                 # 环境变量配置
+~/.clawdbot/              # Clawdbot 配置目录
+  ├── config.json         # 主配置文件
+  └── workspace/          # 工作空间
+```
+
+---
+
+## 故障排查
+
+### 问题 1：`node: command not found`
+
+**解决**：安装 Node.js 22
+```bash
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+sudo apt-get install -y nodejs
+```
+
+### 问题 2：`clawdbot: command not found`
+
+**解决**：安装 Clawdbot
+```bash
+npm install -g clawdbot@latest
+```
+
+### 问题 3：浏览器访问不了 `localhost:18789`
+
+**解决**：检查服务是否启动
+```bash
+ps aux | grep clawdbot
+```
+
+如果没有运行，重新启动：
+```bash
+clawdbot gateway --port 18789
+```
+
+### 问题 4：配置没生效
+
+**解决**：重新加载环境变量
+```bash
+source ~/.bashrc
+```
+
+验证配置：
+```bash
+echo $OPENAI_BASE_URL
+echo $OPENAI_API_KEY
+echo $MODEL_NAME
+```
+
+### 问题 5：API 返回错误
+
+**检查**：
+1. API Key 是否正确
+2. 网络是否正常
+3. 套餐是否有效
+
+测试网络：
+```bash
+curl -I https://open.bigmodel.cn
+```
+
+---
+
+## 快速检查清单
+
+配置完成后，逐项检查：
+
+- [ ] WSL2 可以正常使用
+- [ ] `node --version` 显示 v22.x.x
+- [ ] `clawdbot --version` 显示版本号
+- [ ] `echo $OPENAI_API_KEY` 显示你的 API Key
+- [ ] `echo $MODEL_NAME` 显示 `glm-4-plus`
+- [ ] `curl` 测试 API 返回正常
+- [ ] `clawdbot gateway` 启动成功
+- [ ] 浏览器可以访问 `http://localhost:18789/`
+- [ ] Web 界面可以发送消息并收到回复
+
+全部勾选 ✅ = 配置成功！
+
+---
+
+## 下一步
+
+配置成功后，你可以：
+
+1. **开始对话**：在 Web 界面与 GLM-4.7 对话
+2. **尝试功能**：让 AI 帮你写代码、分析文档
+3. **设置自启**：配置开机自动启动（见下方）
+
+---
+
+## 开机自动启动（可选）
+
+在 WSL2 中执行：
+
+```bash
+# 创建 systemd 服务
+sudo cat > /etc/systemd/system/clawdbot.service << 'EOF'
+[Unit]
+Description=Clawdbot AI Assistant
+After=network.target
+
+[Service]
+Type=simple
+User=$USER
+WorkingDirectory=/home/$USER
+Environment="OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4/"
+Environment="OPENAI_API_KEY=$OPENAI_API_KEY"
+Environment="MODEL_NAME=glm-4-plus"
+ExecStart=/usr/bin/clawdbot gateway --port 18789
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+EOF
+
+# 启动服务
+sudo systemctl daemon-reload
+sudo systemctl enable clawdbot
+sudo systemctl start clawdbot
+
+# 查看状态
+sudo systemctl status clawdbot
+```
+
+---
+
+## 完成！
+
+现在你的 Windows 电脑上已经运行着：
+- ✅ Clawdbot（24/7 AI 助手）
+- ✅ GLM-4.7（最新旗舰模型）
+- ✅ Web 界面（浏览器访问）
+
+**访问地址**：http://localhost:18789/
+
+**开始使用吧！** 🚀

docs/08-用户指南/clawdbot国内用户配置方案.md

@@ -0,0 +1,395 @@
+# Clawdbot 国内用户通信方案
+
+> **你的情况**：国内用户 + GLM 套餐
+>
+> **限制**：无法使用 WhatsApp/Telegram
+>
+> **解决方案**：使用 Web 界面或其他国内平台
+
+---
+
+## 🎯 推荐方案（按优先级）
+
+### 方案 1：Web 控制面板 ⭐ 最简单
+
+**优点**：
+- ✅ 无需额外配置
+- ✅ 直接在浏览器使用
+- ✅ 功能完整
+- ✅ 无需翻墙
+
+**使用方法**：
+
+1. 启动 Clawdbot 网关
+   ```bash
+   # WSL2 中运行
+   clawdbot gateway --port 18789 --verbose
+   ```
+
+2. 浏览器访问
+   ```
+   http://localhost:18789/
+   ```
+
+3. 如果配置了 Token，粘贴 Token 到设置中
+
+4. 开始对话！
+
+**适用场景**：
+- 本地开发测试
+- 个人使用
+- 不需要移动端访问
+
+---
+
+### 方案 2：钉钉机器人
+
+**优点**：
+- ✅ 国内可用
+- ✅ 支持消息推送
+- ✅ 支持群聊和私聊
+- ✅ 企业友好
+
+**配置步骤**：
+
+#### 1. 创建钉钉机器人
+
+1. 打开钉钉电脑版
+2. 进入某个群聊
+3. 点击右上角"群设置" → "智能群助手"
+4. 点击"添加机器人" → "自定义"
+5. 机器人名称：`Clawdbot`
+6. 安全设置：选择"自定义关键词"，输入 `AI`
+7. 创建后获取 **Webhook URL**
+
+#### 2. 创建中转服务
+
+由于 Clawdbot 原生不支持钉钉，需要创建一个简单的中转服务：
+
+```bash
+# 创建项目目录
+mkdir ~/clawdbot-dingtalk
+cd ~/clawdbot-dingtalk
+
+# 创建中转脚本
+cat > dingtalk-bridge.py << 'EOF'
+from flask import Flask, request, jsonify
+import requests
+import os
+
+app = Flask(__name__)
+
+CLAWDBOT_API = os.getenv("CLAWDBOT_API", "http://localhost:18789")
+WEBHOOK_URL = os.getenv("DINGTALK_WEBHOOK")
+
+@app.route('/dingtalk/webhook', methods=['POST'])
+def dingtalk_webhook():
+    data = request.json
+    content = data.get('text', {}).get('content', '')
+
+    # 发送到 Clawdbot
+    response = requests.post(f"{CLAWDBOT_API}/api/message", json={
+        "message": content
+    })
+
+    # 获取回复并发送到钉钉
+    if response.status_code == 200:
+        reply = response.json().get('reply', '处理中...')
+        requests.post(WEBHOOK_URL, json={"msgtype": "text", "text": {"content": reply}})
+
+    return jsonify({"status": "ok"})
+
+if __name__ == '__main__':
+    app.run(port=5000)
+EOF
+
+# 安装依赖
+pip install flask requests
+
+# 配置环境变量
+echo 'export DINGTALK_WEBHOOK="你的钉钉Webhook URL"' >> ~/.bashrc
+echo 'export CLAWDBOT_API="http://localhost:18789"' >> ~/.bashrc
+source ~/.bashrc
+
+# 启动中转服务
+python dingtalk-bridge.py
+```
+
+#### 3. 配置钉钉机器人 Webhook
+
+在钉钉机器人设置中，将 Webhook URL 设置为：
+```
+http://你的服务器IP:5000/dingtalk/webhook
+```
+
+**使用**：
+在钉钉群聊中发送：`AI 你好`
+
+---
+
+### 方案 3：飞书机器人
+
+**优点**：
+- ✅ 国内可用
+- ✅ 功能强大
+- ✅ 支持富文本
+- ✅ 开发友好
+
+**配置步骤**：
+
+#### 1. 创建飞书应用
+
+1. 访问 [飞书开放平台](https://open.feishu.cn/)
+2. 创建企业自建应用
+3. 获取 App ID 和 App Secret
+4. 启用机器人能力
+
+#### 2. 配置事件订阅
+
+类似于钉钉方案，需要创建中转服务接收飞书事件并转发到 Clawdbot。
+
+**详细文档**：[飞书机器人开发指南](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM)
+
+---
+
+### 方案 4：企业微信机器人
+
+**优点**：
+- ✅ 国内可用
+- ✅ 企业级
+- ✅ 安全稳定
+
+**配置步骤**：
+
+1. 在企业微信群聊中添加机器人
+2. 获取 Webhook URL
+3. 参考钉钉方案创建中转服务
+
+---
+
+### 方案 5：微信公众号（高级）
+
+**优点**：
+- ✅ 随时随地使用
+- ✅ 无需翻墙
+- ✅ 用户友好
+
+**缺点**：
+- 需要服务器域名备案
+- 配置复杂
+
+**适用场景**：需要公开服务或团队使用
+
+---
+
+### 方案 6：命令行 + 定时推送
+
+**优点**：
+- ✅ 最简单
+- ✅ 无需额外配置
+- ✅ 适合开发者
+
+**使用方法**：
+
+```bash
+# 发送消息给 Clawdbot
+clawdbot message send --message "帮我分析这段代码"
+
+# 查看回复
+clawdbot message list
+```
+
+**结合定时任务**：
+
+```bash
+# 创建定时任务脚本
+cat > ~/daily-ai-report.sh << 'EOF'
+#!/bin/bash
+# 每天早上 9 点生成 AI 报告
+clawdbot message send --message "生成今日工作计划"
+EOF
+
+chmod +x ~/daily-ai-report.sh
+
+# 添加到 crontab
+crontab -e
+# 添加：0 9 * * * ~/daily-ai-report.sh
+```
+
+---
+
+### 方案 7：浏览器扩展 + 本地服务
+
+**优点**：
+- ✅ 在浏览器中使用
+- ✅ 支持所有网页
+- ✅ 可视化好
+
+**实现方式**：
+
+1. Clawdbot 提供 Web API
+2. 开发简单的浏览器扩展
+3. 在任意网页上与 AI 对话
+
+---
+
+## 🎯 推荐配置组合
+
+### 个人开发
+- **Web 控制面板**（主要）
+- **命令行**（辅助）
+
+### 小团队
+- **Web 控制面板**
+- **钉钉机器人**（团队协作）
+
+### 企业使用
+- **企业微信机器人**
+- **飞书应用**
+- **Web 控制面板**（备用）
+
+---
+
+## 🚀 快速开始（Web 控制面板）
+
+这是最简单的方式，无需额外配置：
+
+### 第 1 步：安装 Clawdbot（WSL2）
+
+```bash
+# 打开 WSL2
+wsl
+
+# 安装 Node.js 22
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+sudo apt-get install -y nodejs
+
+# 安装 Clawdbot
+npm install -g clawdbot@latest
+```
+
+### 第 2 步：配置 GLM
+
+```bash
+# 配置环境变量
+echo 'export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"' >> ~/.bashrc
+echo 'export OPENAI_API_KEY="你的GLM_API_KEY"' >> ~/.bashrc
+echo 'export MODEL_NAME="glm-4-flash"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### 第 3 步：启动网关
+
+```bash
+# 前台运行（测试）
+clawdbot gateway --port 18789 --verbose
+
+# 或后台运行
+nohup clawdbot gateway --port 18789 > ~/clawdbot.log 2>&1 &
+```
+
+### 第 4 步：访问 Web 界面
+
+在浏览器中打开：
+
+```
+http://localhost:18789/
+```
+
+**如果访问不了**：
+
+```bash
+# 检查 WSL2 IP
+ip addr show eth0
+
+# 或者使用 localhost 端口转发
+# 在 PowerShell（管理员）中运行：
+netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=$(wsl hostname -I)
+```
+
+### 第 5 步：开始对话
+
+在 Web 界面中输入消息，开始与 AI 对话！
+
+---
+
+## 💡 进阶配置
+
+### 允许局域网访问
+
+如果你想在手机或其他设备上访问：
+
+```bash
+# 启动时绑定所有网卡
+clawdbot gateway --port 18789 --host 0.0.0.0 --verbose
+
+# 查看你的 WSL2 IP
+ip addr show eth0 | grep inet
+# 假设显示：inet 172.x.x.x
+
+# 在手机浏览器访问
+# http://172.x.x.x:18789/
+```
+
+### 设置开机自启
+
+```bash
+# 创建 systemd 服务
+sudo cat > /etc/systemd/system/clawdbot.service << 'EOF'
+[Unit]
+Description=Clawdbot AI Assistant
+After=network.target
+
+[Service]
+Type=simple
+User=你的用户名
+WorkingDirectory=/home/你的用户名
+Environment="OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4/"
+Environment="OPENAI_API_KEY=你的GLM_API_KEY"
+Environment="MODEL_NAME=glm-4-flash"
+ExecStart=/usr/bin/clawdbot gateway --port 18789
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+EOF
+
+# 启动服务
+sudo systemctl daemon-reload
+sudo systemctl enable clawdbot
+sudo systemctl start clawdbot
+
+# 查看状态
+sudo systemctl status clawdbot
+```
+
+---
+
+## 🎉 总结
+
+作为国内用户，最佳方案是：
+
+1. **主要使用**：Web 控制面板（http://localhost:18789）
+2. **团队协作**：钉钉/飞书机器人
+3. **开发者**：命令行 + Web 界面
+
+**快速开始（3 分钟）**：
+
+```bash
+# 1. 进入 WSL2
+wsl
+
+# 2. 配置 GLM-4.7
+echo 'export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"' >> ~/.bashrc
+echo 'export OPENAI_API_KEY="你的GLM_API_KEY"' >> ~/.bashrc
+echo 'export MODEL_NAME="glm-4-plus"' >> ~/.bashrc
+source ~/.bashrc
+
+# 3. 启动服务
+clawdbot gateway --port 18789
+
+# 4. 浏览器访问
+# http://localhost:18789/
+```
+
+就这么简单！有任何问题随时问我 🚀

docs/08-用户指南/clawdbot安装使用.md

@@ -0,0 +1,620 @@
+# Clawdbot 快速上手指南
+
+> **你现在的状态**：新用户 + 已有 GLM 套餐账号
+>
+> **目标**：10 分钟内完成 Clawdbot 安装并配置 GLM 套餐
+
+---
+
+## 📦 什么是 Clawdbot？
+
+**Clawdbot** 是一个 24/7 运行的个人 AI 助手，可以：
+- ✅ 在 WhatsApp、Telegram、Discord 等平台与你对话
+- ✅ 操作你的电脑（浏览器、文件系统）
+- ✅ 执行任务（写代码、查资料、自动化）
+- ✅ 主动给你发消息（不是被动响应）
+
+**简单理解**：一个长在你电脑上的 AI 助理，类似"贾维斯"。
+
+---
+
+## 🚀 快速安装（Windows + WSL2）
+
+### 步骤 1：安装 WSL2（5 分钟）
+
+打开 PowerShell（管理员），运行：
+
+```powershell
+wsl --install
+```
+
+重启电脑，完成 Ubuntu 初始化设置。
+
+### 步骤 2：安装 Node.js 22+（2 分钟）
+
+在 WSL2 Ubuntu 终端运行：
+
+```bash
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+sudo apt-get install -y nodejs
+
+# 验证
+node --version
+```
+
+### 步骤 3：安装 Clawdbot（1 分钟）
+
+```bash
+# 一键安装
+curl -fsSL https://clawd.bot/install.sh | bash
+
+# 或使用 npm
+npm install -g clawdbot@latest
+```
+
+### 步骤 4：配置 GLM 套餐（2 分钟）
+
+#### 获取你的 GLM API Key
+
+1. 登录 [智谱AI开放平台](https://open.bigmodel.cn/)
+2. 进入控制台 → API Keys
+3. 复制你的 API Key
+
+#### 配置环境变量
+
+编辑 `~/.bashrc`：
+
+```bash
+vim ~/.bashrc
+```
+
+添加以下内容：
+
+```bash
+# GLM Coding Plan 配置
+export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"
+export OPENAI_API_KEY="你的GLM_API_KEY"
+export MODEL_NAME="glm-4-flash"
+```
+
+保存后执行：
+
+```bash
+source ~/.bashrc
+```
+
+### 步骤 5：运行向导（可选）
+
+```bash
+clawdbot onboard --install-daemon
+```
+
+向导会帮你配置：
+- 通信渠道（WhatsApp、Telegram 等）
+- 后台服务
+- 其他设置
+
+**如果你有 GLM 套餐**，向导中的认证配置可以选择跳过或手动配置。
+
+---
+
+## 🔥 使用 GLM 套餐的注意事项
+
+### ⚠️ 重要提醒
+
+**Clawdbot 不在 GLM 官方支持的工具列表中**，这意味着：
+
+1. **可能被识别为普通 API 调用**，消耗账户余额而非套餐额度
+2. **需要验证配置**是否正确使用套餐
+
+### 验证是否使用套餐额度
+
+**方法 1：查看控制台**
+
+1. 访问 [智谱AI控制台 - 套餐使用](https://open.bigmodel.cn/usercenter/billing)
+2. 发送几条测试消息
+3. 查看"套餐使用情况"是否减少
+4. 如果"账户余额"减少，说明被识别为普通调用
+
+**方法 2：使用 One-API 中转（推荐）**
+
+```bash
+# 安装 One-API
+docker run -d --name one-api -p 3000:3000 \
+  -e TZ=Asia/Shanghai \
+  -v /root/data/one-api:/data \
+  ghcr.io/songquanpeng/one-api:latest
+
+# 访问 http://localhost:3000
+# 配置 GLM 套餐渠道
+# 在 Clawdbot 中使用：
+export OPENAI_BASE_URL="http://localhost:3000/v1"
+export OPENAI_API_KEY="sk-one-api-token"
+```
+
+### 套餐并发限制
+
+- **Lite**：并发数 2
+- **Pro**：并发数 5
+- **Max**：并发数 7
+
+如果遇到并发错误，调整配置或升级套餐。
+
+---
+
+## ▶️ 启动 Clawdbot
+
+### 方法 1：前台运行（测试用）
+
+```bash
+clawdbot gateway --port 18789 --verbose
+```
+
+### 方法 2：后台服务（推荐）
+
+```bash
+# 安装服务（如果向导中已安装可跳过）
+clawdbot onboard --install-daemon
+
+# 启动服务
+sudo systemctl start clawdbot
+
+# 查看状态
+sudo systemctl status clawdbot
+
+# 查看日志
+journalctl -u clawdbot -f
+```
+
+---
+
+## 🎯 开始使用
+
+### 配置通信渠道
+
+#### WhatsApp（推荐）
+
+1. 在手机上打开 WhatsApp
+2. 设置 → 关联设备
+3. 扫描二维码完成登录
+
+#### Telegram
+
+1. 在 Telegram 中搜索 [@BotFather](https://t.me/BotFather)
+2. 发送 `/newbot` 创建机器人
+3. 获取 Bot Token
+4. 在 Clawdbot 中配置
+
+### 首次配对
+
+第一条消息会收到配对代码，需要批准：
+
+```bash
+# 批准 WhatsApp 配对
+clawdbot pairing approve whatsapp <配对代码>
+
+# 批准 Telegram 配对
+clawdbot pairing approve telegram <配对代码>
+```
+
+### 发送测试消息
+
+在 WhatsApp/Telegram 中发送：
+
+```
+你好
+```
+
+如果收到回复，配置成功！🎉
+
+---
+
+## 🔧 常用命令
+
+```bash
+# 查看状态
+clawdbot status
+
+# 健康检查
+clawdbot health
+
+# 重启服务
+sudo systemctl restart clawdbot
+
+# 停止服务
+sudo systemctl stop clawdbot
+
+# 查看完整状态
+clawdbot status --all
+```
+
+---
+
+## ❓ 常见问题
+
+### Q1: 安装失败怎么办？
+
+**A**: 检查 Node.js 版本：
+
+```bash
+node --version  # 必须 >= 22
+```
+
+如果版本过低，重新安装 Node.js 22。
+
+### Q2: GLM 套餐不生效？
+
+**A**: 按以下步骤排查：
+
+```bash
+# 1. 检查配置
+echo $OPENAI_BASE_URL
+echo $OPENAI_API_KEY
+echo $MODEL_NAME
+
+# 2. 测试 API 连接
+curl -X POST https://open.bigmodel.cn/api/paas/v4/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -d '{"model":"glm-4-flash","messages":[{"role":"user","content":"测试"}]}'
+
+# 3. 检查日志
+journalctl -u clawdbot -n 50
+```
+
+### Q3: 服务启动失败？
+
+**A**: 查看错误日志：
+
+```bash
+journalctl -u clawdbot -n 100
+```
+
+常见问题：
+- 端口被占用：修改端口号 `--port 18790`
+- 配置文件错误：检查 `~/.clawdbot/config.json`
+- API Key 无效：重新获取并配置
+
+### Q4: 如何更新 Clawdbot？
+
+```bash
+npm update -g clawdbot@latest
+```
+
+### Q5: 如何卸载？
+
+```bash
+# 停止服务
+sudo systemctl stop clawdbot
+
+# 卸载
+npm uninstall -g clawdbot
+
+# 删除配置
+rm -rf ~/.clawdbot
+```
+
+---
+
+## 📚 下一步
+
+### 基础使用
+
+1. **对话**：在 WhatsApp/Telegram 中直接对话
+2. **任务**：让 AI 帮你写代码、查资料、分析日志
+3. **自动化**：配置定时任务、消息转发等
+
+### 高级功能
+
+1. **浏览器操作**：让 AI 操作浏览器完成任务
+2. **文件操作**：读取、编辑、管理文件
+3. **工具集成**：接入搜索引擎、API 等
+4. **多智能体**：配置多个 AI 代理协同工作
+
+### 学习资源
+
+- [Clawdbot GitHub](https://github.com/clawdbot/clawdbot)
+- [官方文档](https://docs.clawd.bot/)
+- [社区讨论](https://github.com/clawdbot/clawdbot/discussions)
+
+---
+
+## 💡 使用技巧
+
+### 技巧 1：高效提示词
+
+❌ 坏："帮我看看这个"
+✅ 好："审查这段代码的性能问题，重点关注内存泄漏和循环效率"
+
+### 技巧 2：利用文件系统能力
+
+"读取 /var/log/app.log，分析过去 1 小时的错误模式"
+
+### 技巧 3：多轮对话
+
+保持上下文，可以持续追问：
+
+```
+你：解释一下 React hooks
+AI：[解释]
+你：给我一个 useEffect 的例子
+AI：[代码示例]
+你：这个例子中依赖数组的作用是什么？
+AI：[详细说明]
+```
+
+---
+
+## 🎉 恭喜！
+
+你已经成功安装并配置了 Clawdbot + GLM 套餐！
+
+**现在可以**：
+- ✅ 在 WhatsApp/Telegram 中与 AI 对话
+- ✅ 让 AI 帮你处理任务
+- ✅ 享受 GLM 套餐的高性价比
+
+**下一步**：
+- 探索更多功能
+- 配置自动化任务
+- 优化使用体验
+
+---
+
+## 📝 快速参考
+
+### 配置文件位置
+
+```
+~/.clawdbot/
+├── config.json              # 主配置
+├── credentials/             # 凭据
+└── workspace/               # 工作空间
+```
+
+### 服务管理
+
+```bash
+# 启动
+sudo systemctl start clawdbot
+
+# 停止
+sudo systemctl stop clawdbot
+
+# 重启
+sudo systemctl restart clawdbot
+
+# 状态
+sudo systemctl status clawdbot
+
+# 日志
+journalctl -u clawdbot -f
+```
+
+### GLM 套餐配置
+
+```bash
+# 环境变量
+export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"
+export OPENAI_API_KEY="你的API_KEY"
+export MODEL_NAME="glm-4-flash"
+
+# 验证
+curl -X POST $OPENAI_BASE_URL/chat/completions \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -d '{"model":"glm-4-flash","messages":[{"role":"user","content":"测试"}]}'
+```
+
+---
+
+**祝使用愉快！** 🚀
+
+有问题？查看 [常见问题](#-常见问题) 或访问 [GitHub Issues](https://github.com/clawdbot/clawdbot/issues)
+
+---
+
+## 📌 本机配置记录
+
+> **最后更新**: 2026-01-28
+> **配置环境**: Windows 11
+> **Clawdbot 版本**: 2026.1.24-3
+
+### ✅ 当前运行状态
+
+| 项目 | 状态 | 详情 |
+|------|------|------|
+| **网关状态** | 🟢 运行中 | 端口 18789 (127.0.0.1) |
+| **默认模型** | GLM-4.7 | `zai/glm-4.7` |
+| **工作空间** | `C:\Users\23780\clawd` | |
+| **进程 PID** | 20992 | |
+
+### 📁 配置文件路径
+
+#### 主配置目录
+```
+C:\Users\23780\.clawdbot\
+├── clawdbot.json              # 主配置文件 ⭐
+├── agents\
+│   └── main\
+│       ├── agent\
+│       │   └── auth-profiles.json  # 认证配置
+│       └── sessions\
+│           └── sessions.json       # 会话存储
+├── credentials\               # OAuth 凭证
+├── cron\jobs.json            # 定时任务
+└── devices\                  # 设备配对
+```
+
+#### 工作空间
+```
+C:\Users\23780\clawd\
+├── canvas\                   # Canvas 文件
+├── AGENTS.md                 # Agent 文档
+├── BOOTSTRAP.md              # 启动文档
+├── HEARTBEAT.md              # 心跳任务
+├── SOUL.md                   # 系统提示
+├── TOOLS.md                  # 工具文档
+└── USER.md                   # 用户信息
+```
+
+### 🔑 GLM-4.7 模型配置
+
+#### 配置文件: `C:\Users\23780\.clawdbot\clawdbot.json`
+
+```json
+{
+  "gateway": {
+    "mode": "local"
+  },
+  "env": {
+    "ZAI_API_KEY": "7f83dc939a60488b8cf48a2ee1c8150e.NY3aOR0qlVS8m37a"
+  },
+  "agents": {
+    "defaults": {
+      "workspace": "C:\\Users\\23780\\clawd",
+      "model": {
+        "primary": "zai/glm-4.7"
+      },
+      "models": {
+        "zai/glm-4.7": {
+          "alias": "GLM"
+        }
+      }
+    }
+  }
+}
+```
+
+#### GLM 模型信息
+
+| 配置项 | 值 |
+|--------|-----|
+| **Provider** | Z.AI (智谱) |
+| **Model ID** | `zai/glm-4.7` |
+| **别名** | `GLM` |
+| **API Key** | `7f83dc939a60488b8cf48a2ee1c8150e.NY3aOR0qlVS8m37a` |
+| **环境变量** | `ZAI_API_KEY` |
+| **通用端点** | `https://api.z.ai/api/paas/v4` |
+| **编程端点** | `https://api.z.ai/api/coding/paas/v4` |
+
+### 🚀 本机常用命令
+
+#### 网关管理
+```bash
+# 启动网关
+clawdbot gateway --port 18789
+
+# 查看网关健康状态
+clawdbot health
+
+# 查看网关日志
+clawdbot logs
+
+# 重启网关 (Windows)
+taskkill //F //PID <pid> && clawdbot gateway --port 18789
+```
+
+#### 模型管理
+```bash
+# 查看模型状态
+clawdbot models status
+
+# 列出可用模型
+clawdbot models list
+
+# 设置默认模型
+clawdbot models set zai/glm-4.7
+```
+
+#### 诊断命令
+```bash
+# 运行完整诊断
+clawdbot doctor
+
+# 自动修复问题
+clawdbot doctor --fix
+
+# 查看频道状态
+clawdbot status
+```
+
+#### 控制面板
+```bash
+# 打开 Web 控制面板
+clawdbot dashboard
+```
+
+#### Agent 交互
+```bash
+# 运行 Agent (本地模式)
+clawdbot agent --local --message "你好"
+
+# 发送消息到会话
+clawdbot message send --target <number> --message "测试消息"
+
+# 查看会话列表
+clawdbot sessions list
+```
+
+### 🛠️ 故障排查
+
+#### 网关无法启动
+```bash
+# 检查端口占用
+netstat -ano | grep 18789
+
+# 终止占用进程 (Windows)
+taskkill //F //PID <pid>
+
+# 查看错误日志
+clawdbot logs | tail -50
+```
+
+#### 模型认证失败
+```bash
+# 检查 API Key 配置
+clawdbot models status
+
+# 验证环境变量
+echo $ZAI_API_KEY
+
+# 重新配置
+clawdbot configure
+```
+
+### 📊 配置验证
+
+```bash
+# 验证模型配置
+clawdbot models status
+
+# 输出应包含：
+# Default       : zai/glm-4.7
+# Aliases (1)   : GLM -> zai/glm-4.7
+# Auth overview : zai effective=env:7f83dc93...lVS8m37a
+
+# 验证网关健康
+clawdbot health
+
+# 输出应包含：
+# Agents: main (default)
+# Heartbeat interval: 30m (main)
+```
+
+### 📚 参考资源
+
+#### 官方文档
+- [Configuration - Clawdbot](https://docs.clawd.bot/gateway/configuration)
+- [Clawdbot GitHub](https://github.com/clawdbot/clawdbot)
+
+#### 中文指南
+- [主权个人必看的Clawdbot 模型配置完全指南（2026版）](https://brave2049.com/groups/artificial-intelligence-learning/forum/discussion/zhu-quan-ge-ren-bi-kan-de-clawdbot-mo-xing-pei-zhi-wan-quan-zhi-nan-2026-ban/)
+- [Clawdbot 完整配置指南](https://zhuanlan.zhihu.com/p/1999437992549447616)
+
+#### 模型提供商
+- [Z.AI (智谱AI)](https://open.bigmodel.cn/)
+- [GLM-4.7 文档](https://open.bigmodel.cn/dev/howuse/model)
+
+---
+
+**提示**: 本节记录了本机 Clawdbot 的实际配置，定期更新以保持同步。

docs/08-用户指南/user-manual.md

@@ -0,0 +1,292 @@
+# U-Desk 使用手册
+
+> 轻量级桌面工具集 - 数据库管理 | 文件管理 | 设备测试
+
+---
+
+## 📖 快速开始
+
+| 操作 | 说明 |
+|------|------|
+| **启动应用** | 双击 `u-desk.exe` |
+| **默认界面** | 数据库、文件管理、设备调用测试 |
+| **打开设置** | 点击右上角 ⚙️ 按钮 |
+| **拖动窗口** | 按住标题栏 "U-Desk" 文字区域 |
+
+---
+
+## 💾 数据库管理
+
+### 界面布局
+
+```
+┌──────────────┬──────────────────────────────┐
+│  连接树      │  SQL 编辑器                  │
+│              │  ─────────────               │
+│ ▼ 连接1      │  SELECT * FROM users...      │
+│   📋 表1     │                              │
+│   📋 表2     │  ─────────────               │
+│              │  结果区域                    │
+│ ▼ 连接2      │  ┌───┬────┬────┐            │
+│              │  │id │name│ age│            │
+│              │  ├───┼────┼────┤            │
+│              │  │ 1 │Tom │ 20 │            │
+│              │  └───┴────┴────┘            │
+└──────────────┴──────────────────────────────┘
+```
+
+### 常用操作
+
+#### 添加数据库连接
+
+1. 点击连接树顶部的 **+ 新建连接**
+2. 填写连接信息
+
+| 字段 | 说明 |
+|------|------|
+| 类型 | MySQL / PostgreSQL / SQLite / MongoDB / Redis |
+| 主机 | `localhost` 或服务器 IP |
+| 端口 | MySQL 默认 `3306`，PostgreSQL 默认 `5432` |
+| 用户名/密码 | 数据库登录信息 |
+| 数据库名 | SQLite 填文件路径 |
+
+3. 点击 **测试连接** 验证
+4. 点击 **保存**
+
+#### 查询数据
+
+```
+展开连接 → 点击表名 → 自动生成SQL → 执行（Ctrl + Enter）
+```
+
+#### 查看表结构
+
+```
+右键表名 → 查看结构 → 切换到"结构"标签页
+```
+
+#### 修改表结构
+
+```
+编辑模式 → 修改字段/索引 → 保存 → 预览SQL → 确认执行
+```
+
+#### 查看历史
+
+```
+点击"历史"标签页 → 查看所有执行过的SQL
+```
+
+---
+
+## 📁 文件管理
+
+### 界面布局
+
+```
+┌─────────────────────────────────────────┐
+│ 路径框 [快捷访问▼] [历史▼] [刷新] [☰]  │
+├──────┬────────────┬────────────────────┤
+│收藏夹│ 文件列表    │ 文件内容           │
+└──────┴────────────┴────────────────────┘
+```
+
+### 导航操作
+
+| 方式 | 操作 |
+|------|------|
+| **输入路径** | 在路径框输入（如 `C:\Users\Documents`），按回车 |
+| **快捷访问** | 点击按钮选择：桌面、文档、下载、图片 |
+| **历史记录** | 查看最近访问的 10 个路径 |
+
+### 文件操作
+
+| 操作 | 方法 |
+|------|------|
+| **查看文件** | 单击文件 |
+| **打开文件** | 双击文件（预览/编辑） |
+| **进入目录** | 双击文件夹 |
+| **收藏文件** | 点击 ⭐ 按钮，添加到左侧收藏夹 |
+| **重命名** | 右键 → 重命名 → 按回车确认 |
+
+### 文件预览支持
+
+| 类型 | 扩展名 | 功能 |
+|------|--------|------|
+| **图片** | `.jpg`, `.png`, `.gif`, `.svg`, `.webp` | 预览 |
+| **视频** | `.mp4`, `.webm`, `.ogg` | 播放器 |
+| **音频** | `.mp3`, `.wav`, `.ogg` | 播放器 |
+| **PDF** | `.pdf` | 预览 |
+| **HTML** | `.html`, `.htm` | 预览 ↔ 编辑切换 |
+| **Markdown** | `.md` | 渲染 ↔ 编辑切换 |
+| **代码** | `.js`, `.py`, `.go`, `.java`, `.sql`, `.json` 等 | 语法高亮 |
+
+### ZIP 文件浏览
+
+```
+双击 .zip 文件 → 进入浏览模式 → 查看文件列表 → 双击预览 → 退出 ZIP
+```
+
+### 面板调整
+
+| 操作 | 方法 |
+|------|------|
+| **调整宽度** | 拖动文件列表和内容区之间的分隔条 |
+| **显示收藏夹** | 点击顶部 ☰ 按钮 |
+
+---
+
+## 🔧 设备调用测试
+
+### 系统信息
+
+点击 **刷新系统信息** 获取：
+
+| 类别 | 显示内容 |
+|------|----------|
+| **CPU** | 核心数、型号、使用率 |
+| **内存** | 总内存、已用、可用、使用率 |
+| **系统** | 操作系统、架构、主机名、平台 |
+| **磁盘** | 所有分区和使用情况 |
+
+### 文件系统操作
+
+```
+输入路径 → 列出目录 → 查看文件列表 → 预览内容
+```
+
+---
+
+## ⚙️ 设置
+
+### Tab 配置
+
+| 功能 | 操作 |
+|------|------|
+| **调整顺序** | 拖拽 ⋮⋮ 图标 |
+| **显示/隐藏** | 勾选/取消勾选（至少保留一个） |
+| **设置默认** | 点击 ○ 默认 单选按钮 |
+| **保存** | 点击 **保存配置** 按钮 |
+| **重置** | 点击 **重置** 恢复上次保存的状态 |
+
+### 版本更新
+
+```
+切换到"版本更新"标签页 → 检查更新 → 下载并安装
+```
+
+---
+
+## ❓ 常见问题
+
+### 应用启动慢？
+
+**原因**：启用了所有模块
+
+**解决**：设置中取消勾选不用的模块，只保留需要的
+
+---
+
+### 数据库连接失败？
+
+**检查清单**：
+
+- [ ] 主机、端口、用户名、密码是否正确
+- [ ] 数据库服务器是否已启动
+- [ ] 点击 **测试连接** 验证配置
+
+---
+
+### 文件预览乱码？
+
+**原因**：文件编码不是 UTF-8
+
+**解决**：使用专业编辑器（VS Code、Notepad++）查看
+
+---
+
+### 编辑器无法保存？
+
+**说明**：编辑器当前为只读模式
+
+**替代**：复制内容到外部编辑器保存
+
+---
+
+### 如何重置配置？
+
+| 系统 | 操作 |
+|------|------|
+| **Windows** | 删除 `%LOCALAPPDATA%\u-desk\` 文件夹内容 |
+| **macOS** | 删除 `~/Library/Application Support/u-desk/` 文件夹 |
+| **Linux** | 删除 `~/.config/u-desk/` 文件夹 |
+
+删除后重启应用，自动恢复默认配置
+
+---
+
+### ZIP 文件无法修改？
+
+**说明**：ZIP 浏览模式为只读
+
+**解决**：使用专业压缩软件（WinRAR、7-Zip）修改
+
+---
+
+## 📂 配置文件位置
+
+| 系统 | 路径 |
+|------|------|
+| **Windows** | `%LOCALAPPDATA%\u-desk\` |
+| **macOS** | `~/Library/Application Support/u-desk/` |
+| **Linux** | `~/.config/u-desk/` |
+
+---
+
+## ⌨️ 快捷键
+
+### 数据库模块
+
+| 快捷键 | 功能 |
+|--------|------|
+| `F5` | 执行 SQL |
+| `Ctrl + Enter` | 执行选中的 SQL |
+
+### 文件管理模块
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Ctrl + N` | 新建文件 |
+| `Ctrl + Shift + N` | 新建文件夹 |
+| `F2` | 重命名选中文件 |
+| `Del` | 删除选中文件 |
+| `Ctrl + B` | 显示/隐藏收藏夹侧边栏 |
+| `Ctrl + ←` | 后退到上一个目录 |
+| `Ctrl + →` | 前进到下一个目录 |
+| `Ctrl + Shift + C` | 快速打开 C 盘 |
+| `Ctrl + Shift + D` | 快速打开 D 盘 |
+| `Ctrl + Shift + E` | 快速打开 E 盘 |
+| `Enter` | 确认（编辑文件名时） |
+| `Esc` | 取消（编辑文件名时） |
+
+### 通用快捷键
+
+| 快捷键 | 功能 |
+|--------|------|
+| `F5` | 刷新当前视图 |
+
+---
+
+## 🎯 窗口控制
+
+| 按钮 | 功能 |
+|------|------|
+| `-` | 最小化到任务栏 |
+| `□` | 最大化/还原 |
+| `×` | 关闭窗口 |
+
+**拖动窗口**：按住标题栏 "U-Desk" 文字区域或标签页空白区域
+
+---
+
+**版本**：1.0.0 | **更新日期**：2026-01-28