|
1 | | -# 🤖 小红书AI话题自动采集系统 |
| 1 | +# Claude Code 使用指南 |
2 | 2 |
|
3 | | -> 基于Playwright的智能化小红书AI话题采集工具,支持本地定时任务和GitHub Actions云端自动化运行 |
| 3 | +<div align="center"> |
| 4 | + <h1>🚀 Claude Code 镜像站使用教程</h1> |
| 5 | + <p>快速、准确、强大的 AI 编程助手</p> |
| 6 | + |
| 7 | + <a href="https://gaccode.cc/"><img src="https://img.shields.io/badge/Claude_Code-镜像站-blue?style=for-the-badge"></a> |
| 8 | + <a href="#安装教程"><img src="https://img.shields.io/badge/安装-教程-green?style=for-the-badge"></a> |
| 9 | + <a href="#使用方法"><img src="https://img.shields.io/badge/使用-方法-orange?style=for-the-badge"></a> |
| 10 | +</div> |
4 | 11 |
|
5 | | -[](https://github.com/features/actions) |
6 | | -[](https://nodejs.org/) |
7 | | -[](https://playwright.dev/) |
| 12 | +## 📖 项目简介 |
8 | 13 |
|
9 | | -## ✨ 功能特点 |
| 14 | +Claude Code 是一款革命性的 AI 编程助手,具有以下特点: |
10 | 15 |
|
11 | | -🚀 **全自动化采集** - 智能获取小红书AI相关热门话题 |
12 | | -📊 **数据去重处理** - 自动识别和更新重复内容 |
13 | | -☁️ **云端运行支持** - GitHub Actions免费云端执行 |
14 | | -📈 **飞书集成** - 直接上传数据到飞书多维表格 |
15 | | -📋 **详细报告** - 自动生成每日数据分析报告 |
16 | | -🔔 **智能通知** - 支持多种通知方式 |
| 16 | +- **⚡ 快速响应** - 秒级生成代码和解决方案 |
| 17 | +- **🎯 精准理解** - 准确理解开发需求和意图 |
| 18 | +- **💪 强大功能** - 支持代码生成、重构、调试等多种场景 |
| 19 | +- **🌏 国内可用** - 通过镜像站无需魔法即可使用 |
17 | 20 |
|
18 | | -## 🎯 适用场景 |
| 21 | +## 🆚 对比优势 |
19 | 22 |
|
20 | | -- 🔍 **AI从业者** - 跟踪行业热点和趋势 |
21 | | -- 📝 **内容创作者** - 发现热门话题和创作灵感 |
22 | | -- 📊 **数据分析师** - 收集社交媒体数据进行分析 |
23 | | -- 🚀 **创业者** - 洞察市场需求和用户关注点 |
| 23 | +相比其他 AI 编程工具(如 Cursor、Gemini CLI),Claude Code 在以下方面表现突出: |
24 | 24 |
|
25 | | -## 🚀 快速开始 |
| 25 | +- **响应速度更快** - 几十秒内完成复杂任务 |
| 26 | +- **理解能力更强** - 精准理解复杂代码库和重构需求 |
| 27 | +- **代码质量更高** - 生成的代码更加规范和可维护 |
| 28 | +- **体验更流畅** - 界面友好,操作简单 |
26 | 29 |
|
27 | | -### 方案选择 |
| 30 | +## 🔧 系统要求 |
28 | 31 |
|
29 | | -| 方案 | 优势 | 适用场景 | |
30 | | -|------|------|---------| |
31 | | -| 🌐 **GitHub Actions** | 免费、稳定、零维护 | 推荐给所有用户 | |
32 | | -| 💻 **本地运行** | 完全控制、即时调试 | 技术用户、定制需求 | |
| 32 | +在开始使用 Claude Code 之前,请确保您的系统满足以下要求: |
33 | 33 |
|
34 | | -### ⚡ GitHub云端部署(推荐) |
| 34 | +- **操作系统**: macOS 10.15+ / Ubuntu 20.04+ / Debian 10+ |
| 35 | +- **Windows 用户**: 需要在 WSL (Windows Subsystem for Linux) 上部署 |
| 36 | +- **Node.js**: 18.0+ 版本 |
35 | 37 |
|
36 | | -1. **Fork本仓库**到您的GitHub账号 |
37 | | -2. **配置Secrets**(可选) |
38 | | -3. **启用Actions**并运行测试 |
39 | | -4. **享受每日自动采集** |
| 38 | +## 📝 安装教程 |
40 | 39 |
|
41 | | -> 📖 详细步骤请查看:[GitHub自动化部署指南.md](./GitHub自动化部署指南.md) |
| 40 | +### 1. 注册账号 |
42 | 41 |
|
43 | | -### 💻 本地部署 |
| 42 | +首先访问 Claude Code 镜像站并注册账号: |
44 | 43 |
|
45 | | -```bash |
46 | | -# 1. 克隆仓库 |
47 | | -git clone https://github.com/your-username/xiaohongshu-ai-scraper.git |
48 | | -cd xiaohongshu-ai-scraper |
| 44 | +> **Claude Code 镜像站**: [https://gaccode.cc/](https://gaccode.cc/) |
49 | 45 |
|
50 | | -# 2. 安装依赖 |
51 | | -npm install |
52 | | -npx playwright install chromium |
| 46 | +### 2. 安装 Node.js 环境 |
53 | 47 |
|
54 | | -# 3. 测试运行 |
55 | | -npm run test |
| 48 | +#### macOS 用户 |
56 | 49 |
|
57 | | -# 4. 配置飞书 |
58 | | -npm run setup |
| 50 | +```bash |
| 51 | +# 使用 Homebrew 安装 |
| 52 | +brew install node |
59 | 53 |
|
60 | | -# 5. 正式运行 |
61 | | -npm start |
| 54 | +# 或使用 nvm 安装 |
| 55 | +curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash |
| 56 | +nvm install 18 |
| 57 | +nvm use 18 |
62 | 58 | ``` |
63 | 59 |
|
64 | | -> 📖 详细步骤请查看:[Windows定时任务设置指南.md](./Windows定时任务设置指南.md) |
65 | | -
|
66 | | -## 📁 项目结构 |
| 60 | +#### Ubuntu/Debian 用户 |
67 | 61 |
|
| 62 | +```bash |
| 63 | +# 安装 Node.js 22.x |
| 64 | +curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash - |
| 65 | +sudo apt-get install -y nodejs |
68 | 66 | ``` |
69 | | -xiaohongshu-ai-scraper/ |
70 | | -├── 📄 xiaohongshu_auto_scraper.js # 小红书数据采集引擎 |
71 | | -├── 🔄 data_processor.js # 数据处理和去重模块 |
72 | | -├── 📤 feishu_uploader.js # 飞书自动上传模块 |
73 | | -├── 🎯 daily_ai_scraper.js # 主调度程序 |
74 | | -├── 📦 package.json # 项目配置和依赖 |
75 | | -├── 🔧 config.example.env # 环境变量配置示例 |
76 | | -├── 🖥️ run_daily_scraper.bat # Windows批处理脚本 |
77 | | -├── 📊 .github/workflows/ # GitHub Actions工作流 |
78 | | -│ └── daily-ai-scraper.yml |
79 | | -├── 📋 data/ # 数据存储目录(自动创建) |
80 | | -│ ├── master_topics.json # 主数据库 |
81 | | -│ ├── daily_scraper.log # 运行日志 |
82 | | -│ └── daily_report_*.md # 每日报告 |
83 | | -└── 📚 docs/ # 文档目录 |
84 | | - ├── GitHub自动化部署指南.md |
85 | | - └── Windows定时任务设置指南.md |
86 | | -``` |
87 | | - |
88 | | -## 🔧 配置选项 |
89 | | - |
90 | | -### 环境变量 |
91 | 67 |
|
92 | | -| 变量名 | 说明 | 默认值 | |
93 | | -|--------|------|--------| |
94 | | -| `HEADLESS` | 无头模式运行 | `false` | |
95 | | -| `GITHUB_ACTIONS` | GitHub Actions环境 | 自动检测 | |
96 | | -| `FEISHU_TABLE_URL` | 飞书表格URL | - | |
97 | | - |
98 | | -### 运行模式 |
| 68 | +#### 验证安装 |
99 | 69 |
|
100 | 70 | ```bash |
101 | | -# 测试模式(不上传到飞书) |
102 | | -node daily_ai_scraper.js test |
103 | | - |
104 | | -# 正常运行(完整流程) |
105 | | -node daily_ai_scraper.js run |
106 | | - |
107 | | -# 仅上传模式 |
108 | | -node daily_ai_scraper.js upload |
109 | | - |
110 | | -# 飞书配置向导 |
111 | | -node daily_ai_scraper.js setup |
| 71 | +node --version |
| 72 | +npm --version |
112 | 73 | ``` |
113 | 74 |
|
114 | | -## 📊 数据输出 |
| 75 | +确保输出版本号为 18.0 或更高。 |
115 | 76 |
|
116 | | -### 📈 采集数据格式 |
| 77 | +### 3. 安装 Claude Code |
117 | 78 |
|
118 | | -```json |
119 | | -{ |
120 | | - "title": "AI工具推荐合集", |
121 | | - "author": "AI知识库", |
122 | | - "likes": 7922, |
123 | | - "category": "AI工具", |
124 | | - "heat_level": "高热度", |
125 | | - "scraped_time": "2025-01-07", |
126 | | - "source": "小红书" |
127 | | -} |
128 | | -``` |
129 | | - |
130 | | -### 📋 输出文件 |
| 79 | +#### 卸载旧版本(如果存在) |
131 | 80 |
|
132 | | -- `📊 feishu_export_YYYY-MM-DD.csv` - 飞书导入格式 |
133 | | -- `📄 daily_report_YYYY-MM-DD.md` - 每日分析报告 |
134 | | -- `🗄️ master_topics.json` - 完整数据库 |
135 | | -- `📝 daily_scraper.log` - 运行日志 |
| 81 | +```bash |
| 82 | +npm uninstall -g @anthropic-ai/claude-code |
| 83 | +``` |
136 | 84 |
|
137 | | -## 🔍 监控和维护 |
| 85 | +#### 安装镜像版本 |
138 | 86 |
|
139 | | -### GitHub Actions |
| 87 | +```bash |
| 88 | +cd ~ |
| 89 | +npm install -g https://gaccodecode.com/claudecode/install --registry=https://registry.npmmirror.com |
| 90 | +claude --version |
| 91 | +``` |
140 | 92 |
|
141 | | -- ✅ **运行状态**:Actions页面查看历史记录 |
142 | | -- 📥 **下载数据**:Artifacts部分获取结果文件 |
143 | | -- 🔔 **失败通知**:自动邮件提醒 |
| 93 | +## 🚀 使用方法 |
144 | 94 |
|
145 | | -### 本地运行 |
| 95 | +### 1. 创建项目目录 |
146 | 96 |
|
147 | | -- 📋 **查看日志**:`./data/daily_scraper.log` |
148 | | -- 📊 **数据统计**:每日报告自动生成 |
149 | | -- 🔧 **手动调试**:测试模式验证功能 |
| 97 | +```bash |
| 98 | +mkdir my-claude-project |
| 99 | +cd my-claude-project |
| 100 | +``` |
150 | 101 |
|
151 | | -## 🛠️ 故障排除 |
| 102 | +### 2. 启动 Claude Code |
152 | 103 |
|
153 | | -### 常见问题 |
| 104 | +```bash |
| 105 | +claude |
| 106 | +``` |
154 | 107 |
|
155 | | -<details> |
156 | | -<summary>🔸 采集到的数据为空</summary> |
| 108 | +### 3. 授权验证 |
157 | 109 |
|
158 | | -**可能原因:** |
159 | | -- 小红书页面结构变化 |
160 | | -- 网络连接问题 |
161 | | -- 反爬虫机制 |
| 110 | +首次运行时会跳转到浏览器进行授权: |
162 | 111 |
|
163 | | -**解决方案:** |
164 | | -1. 运行测试模式:`npm run test` |
165 | | -2. 检查网络连接 |
166 | | -3. 查看错误日志:`./data/daily_scraper.log` |
167 | | -</details> |
| 112 | +1. 在浏览器中登录您的账号 |
| 113 | +2. 完成授权验证 |
| 114 | +3. 选择主题和配置选项 |
| 115 | +4. 允许 Claude Code 访问项目目录 |
168 | 116 |
|
169 | | -<details> |
170 | | -<summary>🔸 飞书上传失败</summary> |
| 117 | +## 💳 订阅激活 |
171 | 118 |
|
172 | | -**可能原因:** |
173 | | -- 未配置飞书连接 |
174 | | -- 登录状态过期 |
175 | | -- 表格权限不足 |
| 119 | +如果遇到需要订阅的提示,可以使用以下体验码: |
176 | 120 |
|
177 | | -**解决方案:** |
178 | | -1. 重新运行设置:`npm run setup` |
179 | | -2. 检查飞书登录状态 |
180 | | -3. 确认表格访问权限 |
181 | | -</details> |
| 121 | +``` |
| 122 | +MCE8JH4P-VDFOD0 |
| 123 | +MCE8JH4X-JN3F3S |
| 124 | +MCE8JH53-93U6FC |
| 125 | +``` |
182 | 126 |
|
183 | | -<details> |
184 | | -<summary>🔸 GitHub Actions运行失败</summary> |
| 127 | +**激活步骤**: |
| 128 | +1. 访问 [Claude Code 镜像站](https://gaccode.cc/) |
| 129 | +2. 进入 "管理订阅" 页面 |
| 130 | +3. 点击 "兑换优惠券" |
| 131 | +4. 输入体验码完成激活 |
185 | 132 |
|
186 | | -**可能原因:** |
187 | | -- 代码语法错误 |
188 | | -- 依赖安装失败 |
189 | | -- 运行时间超时 |
| 133 | +## 💡 使用技巧 |
190 | 134 |
|
191 | | -**解决方案:** |
192 | | -1. 查看Actions运行日志 |
193 | | -2. 检查代码更改 |
194 | | -3. 重新触发运行 |
195 | | -</details> |
| 135 | +### 代码生成 |
| 136 | +- 详细描述需求,Claude Code 会生成完整的代码实现 |
| 137 | +- 支持多种编程语言和框架 |
196 | 138 |
|
197 | | -## 🎯 发展规划 |
| 139 | +### 代码重构 |
| 140 | +- 提供现有代码,说明重构目标 |
| 141 | +- Claude Code 会保持文件名和变量一致性 |
198 | 142 |
|
199 | | -### 🚀 即将推出 |
| 143 | +### 调试助手 |
| 144 | +- 提供错误信息和代码片段 |
| 145 | +- 获得详细的调试建议和解决方案 |
200 | 146 |
|
201 | | -- [ ] 🎨 Web可视化界面 |
202 | | -- [ ] 📱 支持更多社交平台 |
203 | | -- [ ] 🤖 AI内容分析和预测 |
204 | | -- [ ] 📧 邮件/微信自动通知 |
205 | | -- [ ] 📈 数据可视化图表 |
| 147 | +## 🛠️ 常见问题 |
206 | 148 |
|
207 | | -### 💡 长期规划 |
| 149 | +### Q: Windows 用户如何安装? |
| 150 | +A: Windows 用户需要先安装 WSL,然后在 WSL 环境中按照 Linux 安装步骤进行。 |
208 | 151 |
|
209 | | -- [ ] 🌍 多语言支持 |
210 | | -- [ ] ☁️ 云端数据库集成 |
211 | | -- [ ] 🔗 API接口开放 |
212 | | -- [ ] 📚 插件生态系统 |
| 152 | +### Q: 授权失败怎么办? |
| 153 | +A: 确保网络连接正常,不要使用代理,重新运行 `claude` 命令。 |
213 | 154 |
|
214 | | -## 🤝 贡献指南 |
| 155 | +### Q: 如何获取更多体验码? |
| 156 | +A: 访问 [https://717ka.com/p/1xqz24eni937lycwlnq98ybz](https://717ka.com/p/1xqz24eni937lycwlnq98ybz) 获取最新体验码。 |
215 | 157 |
|
216 | | -欢迎贡献代码和建议! |
| 158 | +### Q: 远程服务器如何使用? |
| 159 | +A: 复制命令行中的链接,在本地浏览器中打开并输入验证码。 |
217 | 160 |
|
218 | | -1. Fork本仓库 |
219 | | -2. 创建功能分支:`git checkout -b feature/amazing-feature` |
220 | | -3. 提交更改:`git commit -m 'Add amazing feature'` |
221 | | -4. 推送分支:`git push origin feature/amazing-feature` |
222 | | -5. 提交Pull Request |
| 161 | +## 📞 联系支持 |
223 | 162 |
|
224 | | -## 📄 开源协议 |
| 163 | +如需企业合作或技术支持,请联系: |
225 | 164 |
|
226 | | -本项目采用 [MIT License](LICENSE) 开源协议。 |
| 165 | +- **微信客服**: coder-maynor |
| 166 | +- **QQ**: 1002569303 |
| 167 | +- **镜像站**: [https://gaccode.cc/](https://gaccode.cc/) |
227 | 168 |
|
228 | | -## ⭐ 支持项目 |
| 169 | +## 🎉 开始使用 |
229 | 170 |
|
230 | | -如果这个项目对您有帮助,请考虑: |
| 171 | +恭喜您!现在可以开始使用 Claude Code 来提升您的编程效率了。 |
231 | 172 |
|
232 | | -- 🌟 **Star本仓库** |
233 | | -- 🐛 **报告Bug** |
234 | | -- 💡 **提出建议** |
235 | | -- 🔗 **分享给朋友** |
| 173 | +```bash |
| 174 | +# 在项目目录中运行 |
| 175 | +claude |
| 176 | +``` |
236 | 177 |
|
237 | | -## 📞 联系我们 |
| 178 | +## 📄 许可证 |
238 | 179 |
|
239 | | -- 📧 Issues:[GitHub Issues](https://github.com/your-username/xiaohongshu-ai-scraper/issues) |
240 | | -- 💬 讨论:[GitHub Discussions](https://github.com/your-username/xiaohongshu-ai-scraper/discussions) |
| 180 | +本项目遵循 MIT 许可证。 |
241 | 181 |
|
242 | 182 | --- |
243 | 183 |
|
244 | 184 | <div align="center"> |
245 | | - |
246 | | -**🚀 立即开始您的AI话题采集之旅!** |
247 | | - |
248 | | -[快速部署](#-快速开始) • [查看文档](./GitHub自动化部署指南.md) • [报告问题](https://github.com/your-username/xiaohongshu-ai-scraper/issues) |
249 | | - |
| 185 | + <p>Made with ❤️ by Claude Code Community</p> |
| 186 | + <p>快速、准确、强大的 AI 编程助手</p> |
250 | 187 | </div> |
0 commit comments