19 KiB
PROJECTS.md - 项目开发记录
本文件记录所有开发过的项目,包含简介、启动命令、检查方式。每次开发或修改项目后更新此文件。
项目列表
| # | 项目名称 | 类型 | 端口 | 状态 | 最后更新 |
|---|---|---|---|---|---|
| 1 | PDF翻译助手 V2 | Web | 19000 | ✅ 运行中 | 2026-04-09 |
| 2 | LLM Index RAG | Web | 19001 | ✅ 运行中 | 2026-04-09 |
| 3 | 产品参数爬取系统 | Web | 19011/19012 | ✅ 运行中 | 2026-04-10 |
| 4 | 碎片信息记录 | Web | 19009 | ✅ 运行中 | 2026-04-09 |
| 5 | ParamHub Python版 | Web | 19010 | ✅ 运行中 | 2026-04-09 |
| 6 | LLM Proxy | Web | 19007/19008 | ✅ 运行中 | 2026-04-10 |
| 7 | 项目服务管理面板 | Web | 19013 | ✅ 运行中 | 2026-04-11 |
| 8 | 网页助手插件 | Extension | - | 📦 已完成 | 2026-04-08 |
| 9 | A股历史数据系统 | CLI | - | 🔄 优化中 | 2026-04-09 |
| 10 | Web服务监控 | Cron | - | ✅ 运行中 | 2026-04-10 |
| 11 | A股板块监控 | Cron | - | ✅ 运行中 | 2026-04-10 |
| 12 | AI对话系统 V2 | Web | 19020 | ✅ 运行中 | 2026-04-12 |
| 13 | 磁盘大文件扫描 | CLI | - | 📦 已完成 | 2026-04-12 |
| 14 | 技术论坛 | Web | 19004 | ✅ 运行中 | 2026-04-12 |
项目详情
1. PDF翻译助手 V2 (pdf-translate-web-v2)
简介: 英文PDF翻译中文网站,支持用户系统、会员体系、数据包购买、后台动态配置。
目录: works/pdf-translate-web-v2
启动命令:
cd ~/.openclaw/workspace-coder/works/pdf-translate-web-v2
python3 app.py
访问地址: http://localhost:19000
后台管理: http://localhost:19000/admin (账号: admin / admin123)
检查服务状态:
curl -s http://localhost:19000/api/health || echo "服务未启动"
依赖:
- Python 3 + Flask
- SQLite (自动创建)
- 本地LLM服务 (http://192.168.2.5:1234/v1)
2. LLM Index RAG (llm-index-rag)
简介: 基于索引和搜索的知识检索系统,不依赖向量模型,使用BM25排序和LLM增强索引。
目录: works/llm-index-rag
启动命令:
cd ~/.openclaw/workspace-coder/works/llm-index-rag
python3 app.py
访问地址: http://localhost:19001
系统设置: http://localhost:19001/settings
检查服务状态:
curl -s http://localhost:19001/api/stats
Git仓库: http://192.168.2.8:12007/coder/llm-index-rag
版本: v1.1.2
依赖:
- Python 3 + Flask
- SQLite (自动创建)
- 本地LLM服务 (配置中设置)
3. 产品参数爬取系统 (product-crawler)
简介: 自动从官方网站爬取产品参数信息,支持多步骤爬取流程(入口页→列表页→详情页)。
目录: /home/xian/.openclaw/common/projects/product-crawler
启动命令:
# API服务
cd ~/.openclaw/workspace-coder/works/product-crawler
python3 app.py
# 后台管理
cd ~/.openclaw/workspace-coder/works/product-crawler/admin
python3 app.py
访问地址:
- API服务: http://localhost:19011
- 后台管理: http://localhost:19012
检查服务状态:
curl -s http://localhost:19011/api/products
功能特点:
- 多步骤爬取流程配置
- 浏览器爬虫(Playwright,处理JS渲染)
- 静态爬虫(requests + BeautifulSoup)
- 数据存储和导出
依赖:
- Python 3 + Flask + Playwright + BeautifulSoup
4. 碎片信息记录 (snippet-notes)
简介: 简洁的碎片信息记录工具,支持实时保存、AI自动生成标题、搜索、置顶、导出Markdown。
目录: works/snippet-notes
启动命令:
cd ~/.openclaw/workspace-coder/works/snippet-notes
python3 app.py
访问地址: http://localhost:19009
检查服务状态:
curl -s http://localhost:19009/api/notes || echo "服务未启动"
依赖:
- Python 3 + Flask
- 本地文件存储 (JSON)
- 本地LLM API (生成标题)
4. ParamHub Python版 (param-hub-python)
简介: AI大模型与硬件参数速查平台,支持模型/GPU/CPU数据库、动态分类、对比工具、显存计算器。
目录: works/param-hub-python
启动命令:
cd ~/.openclaw/workspace-coder/works/param-hub-python
python3 app.py
访问地址: http://localhost:19010
后台管理: http://localhost:19010/admin
检查服务状态:
curl -s http://localhost:19010/api/stats
curl -s http://localhost:19010/api/categories
Git仓库: http://192.168.2.8:12007/coder/param-hub-python
版本: v1.2.0
v1.2.0 新功能:
- 网站配置管理:后台可修改网站名称、备案号、页脚文字等
- 配置前台自动读取并显示
v1.1.0 新功能:
- 智能添加:粘贴文本自动解析为结构化数据(大模型API)
- 展示开关:各分类和产品支持显示/隐藏控制
- 原始数据保留:智能添加的产品保留raw_text字段
- 价格显示优化:支持多币种、价格区间、单位
依赖:
- Python 3 + Flask
- Tailwind CSS (CDN)
- JSON文件存储
- LLM Proxy (http://192.168.2.17:19007/v1)
5. 网页助手插件 (web-context-extension)
简介: 浏览器扩展插件,右键菜单支持收藏网页、AI总结、深度研究分析。
目录: works/web-context-extension
安装方法:
- Chrome浏览器打开
chrome://extensions/ - 开启"开发者模式"
- 点击"加载已解压的扩展程序"
- 选择
works/web-context-extension目录
配置: 需在插件设置中配置OpenClaw API地址
依赖:
- Chrome/Edge浏览器
- OpenClaw服务
6. LLM Proxy (llm-proxy)
简介: 大模型API中转系统,兼容OpenAI API格式,支持多上游提供商优先级调度、请求统计。
目录: /home/xian/.openclaw/common/projects/llm-proxy
启动命令:
# API服务
cd ~/.openclaw/common/projects/llm-proxy
python3 app.py
# 后台管理
cd ~/.openclaw/common/projects/llm-proxy/admin
python3 app.py
访问地址:
- API服务: http://localhost:19007
- 后台管理: http://localhost:19008
检查服务状态:
curl -s http://localhost:19007/health
curl -s http://localhost:19008/api/stats
Git仓库: http://192.168.2.8:12007/coder/llm-proxy
版本: v0.5.0
功能特点:
- OpenAI API兼容格式
- 多上游提供商优先级调度
- 自动重试和故障切换
- 请求统计(次数、成功/失败、token数)
- 模型别名和auto配置
- 后台管理界面
API使用示例:
# curl
curl -X POST http://localhost:19007/v1/chat/completions \
-H 'Content-Type: application/json' \
-d '{"model": "auto", "messages": [{"role": "user", "content": "你好"}]}'
# Python OpenAI SDK
from openai import OpenAI
client = OpenAI(base_url='http://localhost:19007/v1', api_key='any')
response = client.chat.completions.create(model='auto', messages=[{'role': 'user', 'content': '你好'}])
print(response.choices[0].message.content)
依赖:
- Python 3 + Flask + Flask-CORS
7. 项目服务管理面板 (project-panel)
简介: 统一管理所有项目和服务,显示运行状态,支持启动、停止、重启控制。
目录: works/project-panel
启动命令:
cd ~/.openclaw/workspace-coder/works/project-panel
python3 app.py
访问地址: http://localhost:19013
检查服务状态:
curl -s http://localhost:19013/api/projects
Git仓库: http://192.168.2.8:12007/coder/project-panel
版本: v1.0.0
功能特点:
- 项目列表展示(Web服务、Cron任务、CLI工具、插件)
- 实时状态检测(端口检测、健康检查)
- 服务控制(启动、停止、重启)
- 日志查看
- 类型筛选
- 动态添加新项目(API)
项目配置: projects.json 文件存储所有项目信息,便于扩展
依赖:
- Python 3 + Flask
- Tailwind CSS (CDN)
- RemixIcon
8. PDF翻译助手 V1 (pdf-translate-web)
简介: 英文PDF翻译中文网站第一版,支持翻译、缓存、用户系统。
目录: works/pdf-translate-web
状态: 已废弃,推荐使用 V2 版本
9. PDF翻译脚本 (pdf-translator)
简介: 基于本地LLM的英文PDF翻译命令行工具,支持Markdown/TXT/JSON输出。
目录: works/pdf-translator
使用命令:
cd ~/.openclaw/workspace-coder/works/pdf-translator
python3 translate_pdf.py input.pdf output.md
依赖:
- Python 3
- 本地LLM服务 (http://192.168.2.5:1234/v1)
10. A股历史数据系统 (stock_system)
简介: 获取所有A股从2010年至今的历史行情数据,支持断点续传。V2版本优化了CPU和磁盘占用。
目录: /home/xian/.openclaw/common/stock_system
启动命令:
cd /home/xian/.openclaw/common/stock_system
bash run_v2.sh
# 或直接运行
python3 fetch_history_v2.py
V2优化点:
- 分文件存储:每只股票存独立小文件,避免每次读写203MB大文件
- 批量合并:每50只股票合并一次到主文件
- SQLite进度库:更可靠的断点续传机制
- 请求间隔减少:从5秒降到0.3秒,用轻量存储补偿
检查进度:
# 查看SQLite进度统计
sqlite3 /home/xian/.openclaw/common/stock_system/data/progress.db \
"SELECT status, COUNT(*) FROM progress GROUP BY status"
# 查看数据文件大小
ls -lh /home/xian/.openclaw/common/stock_system/data/stock_daily_data.parquet
配置:
- Tushare Token: 放入
config.txt文件 - 股票列表:
A股股票列表.csv
依赖:
- Python 3 + tushare + pandas
- Tushare API Token
11. Web服务监控 (service-monitor)
简介: 自动监控所有Web服务状态,每20分钟检查一次,如有服务停止则发送邮件通知。
目录: works/service-monitor
监控服务:
- PDF翻译助手 V2 (19000)
- LLM Index RAG (19001)
- 碎片信息记录 (19009)
- ParamHub Python (19010)
- 产品参数爬取 API (19011)
- 产品参数爬取 后台 (19012)
- LLM Proxy API (19007)
- LLM Proxy 后台 (19008)
运行方式: Cron定时任务,每20分钟执行
通知邮箱: zuitoushang@tphai.com
手动检查:
python3 ~/.openclaw/workspace-coder/works/service-monitor/monitor.py
查看日志:
cat ~/.openclaw/workspace-coder/works/service-monitor/monitor.log
Cron配置:
*/20 * * * * /usr/bin/python3 /home/xian/.openclaw/workspace-coder/works/service-monitor/monitor.py >> /home/xian/.openclaw/workspace-coder/works/service-monitor/monitor.log 2>&1
Git仓库: http://192.168.2.8:12007/coder/service-monitor
版本: v1.0.0
依赖:
- Python 3 + urllib
- 邮件发送技能 (email-sender)
12. A股板块监控 (board-monitor)
简介: 自动获取东方财富板块数据,监控异动并发送邮件通知。
目录: works/board-monitor
功能特点:
- 行业板块涨跌幅排行
- 概念板块涨跌幅排行
- 主力资金流入/流出监控
- 异动检测(涨跌幅≥3%、资金≥10亿)
- HTML格式邮件通知
使用命令:
# 测试API连接
python3 board_monitor.py test
# 获取板块数据
python3 board_monitor.py get industry --limit 20
# 执行监控检查
python3 board_monitor.py monitor -v
Cron配置: 交易日盘中每小时检查(10:00-15:00)
0 10,11,13,14,15 * * 1-5 python3 board_monitor.py monitor
Git仓库: http://192.168.2.8:12007/coder/board-monitor
版本: v1.0.0
依赖:
- Python 3 + urllib
- 东方财富HTTP API
- 邮件发送技能 (email)
12. AI对话系统 V2 (ai-chat-system)
简介: 支持网页端和Matrix端实时同步对话的AI聊天系统,v2.0重构支持大模型池、Agent管理、渠道独立绑定。
目录: works/ai-chat
启动命令:
cd ~/.openclaw/workspace-coder/works/ai-chat
./start_v2.sh
访问地址:
检查服务状态:
curl -s http://localhost:19020/api/v2/providers
curl -s http://localhost:19020/api/admin/stats
Git仓库: http://192.168.2.8:12007/coder/ai-chat-system
版本: v2.0.0
v2.0.0 新功能:
- 大模型池管理: 配置多个LLM Provider,Agent可选择使用
- Agent管理: 每个Agent独立配置系统设定、思考功能开关
- 渠道独立绑定: 网页端和Matrix可绑定不同Agent
- 思考功能: 支持原生思考模型,兼容无思考功能的模型
技术栈:
- FastAPI + WebSocket
- SQLite (新v2模型: LLMProvider, Agent, Channel)
- Matrix Bot (matrix-nio, 支持加密)
依赖:
- Python 3 + FastAPI
- matrix-nio
- 大模型API (可配置多个)
13. 磁盘大文件扫描 (disk-scanner)
简介: 智能扫描Windows/Linux目录,快速定位大文件和大目录,自动跳过零碎文件目录。
目录: works/disk-scanner
使用命令:
# Windows
disk_scanner.bat C:\Users -d 3
# Linux/macOS
python3 disk_scanner.py /home/user -d 3 -s 50M
功能特点:
- 智能跳过零碎目录(node_modules, .git, venv等)
- 文件数量阈值判断(超过100文件视为程序包)
- 大小阈值过滤(默认10MB以下不深入)
- 按大小排序展示
- 树形结构清晰展示
- 跨平台支持
参数:
-d/--depth: 最大扫描深度-f/--file-threshold: 文件数阈值(默认100)-s/--size-threshold: 大小阈值(默认10M)
Git仓库: http://192.168.2.8:12007/coder/disk-scanner
版本: v1.0.0
依赖:
- Python 3.6+(仅标准库,无需额外安装)
14. 技术论坛 (tech-forum)
简介: 技术交流、工具分享、问答讨论社区,支持用户注册、帖子发布、主题管理、后台管理。
目录: /home/xian/.openclaw/common/projects/tech-forum
启动命令:
cd /home/xian/.openclaw/common/projects/tech-forum
python3 backend/app.py
访问地址:
后台登录: admin / admin123
检查服务状态:
curl -s http://localhost:19004/api/health || echo "服务未启动"
功能特点:
- 技术交流帖子(发布、评论、点赞)
- 工具分享主题(子主题、问题追问)
- 用户注册登录系统
- 后台管理(登录验证、用户/帖子/主题管理)
v1.2.0 合并改进:
- 后台整合到 /admin 路径(统一端口)
- 前台保持原有路由
- 简化部署,只需启动一个服务
Git仓库: http://192.168.2.8:12007/coder/tech-forum
版本: v1.2.0
依赖:
- Python 3 + Flask + Flask-CORS + PyJWT + werkzeug
- SQLite(自动创建)
端口分配表
| 端口 | 项目 | 说明 |
|---|---|---|
| 19000 | PDF翻译助手 V2 | 主服务 + 后台 |
| 19001 | LLM Index RAG | API服务 |
| 19002-19003 | 预留 | 待分配 |
| 19004 | 技术论坛 | 主服务 + 后台 |
| 19005-19006 | 预留 | 待分配 |
| 19007 | LLM Proxy | API服务 |
| 19008 | LLM Proxy | 后台管理 |
| 19009 | 碎片信息记录 | Web服务 |
| 19010 | ParamHub Python | Web服务 |
| 19011 | 产品参数爬取 | API服务 |
| 19012 | 产品参数爬取 | 后台管理 |
| 19013 | 项目服务管理面板 | Web服务 |
| 19014 | Xian Favor | 收藏系统 |
| 19015 | 多智能体竞标调度 | Web服务 |
| 19020 | AI对话系统 V2 | 主服务 + Matrix Bot |
| 19021-19100 | 预留 | 待分配 |
端口规范: 所有Web服务必须使用 19000-19100 范围内的端口!
Git仓库索引
| 项目 | 仓库地址 | 版本 |
|---|---|---|
| ParamHub Node | http://192.168.2.8:12007/coder/param-hub | v0.2.0 |
| ParamHub Python | http://192.168.2.8:12007/coder/param-hub-python | v0.3.1 |
| LLM Index RAG | http://192.168.2.8:12007/coder/llm-index-rag | v1.2.0 |
| LLM Proxy | http://192.168.2.8:12007/coder/llm-proxy | v0.5.1 |
| 产品参数爬取系统 | http://192.168.2.8:12007/coder/product-crawler | v1.0.0 |
| 项目服务管理面板 | http://192.168.2.8:12007/coder/project-panel | v1.0.0 |
| 网页助手插件 | http://192.168.2.8:12007/coder/web-context-extension | v0.1.0 |
| A股历史数据系统 | http://192.168.2.8:12007/coder/stock_system | v0.2.0 |
| Web服务监控 | http://192.168.2.8:12007/coder/service-monitor | v1.0.0 |
| 邮件收发技能 | http://192.168.2.8:12007/coder/skill-email | v1.1.0 |
| A股板块监控 | http://192.168.2.8:12007/coder/board-monitor | v1.0.0 |
| AI对话系统 V2 | http://192.168.2.8:12007/coder/ai-chat-system | v2.0.0 |
| 磁盘大文件扫描 | http://192.168.2.8:12007/coder/disk-scanner | v1.0.0 |
Git服务器: http://192.168.2.8:12007/ 账号: coder / Hps123@!
快速操作命令
查看所有服务状态
for port in 19000 19001 19009 19010; do
echo "端口 $port:"
curl -s http://localhost:$port --max-time 1 > /dev/null && echo " ✅ 运行中" || echo " ❌ 未启动"
done
启动所有Web服务
# PDF翻译助手 V2
cd ~/.openclaw/workspace-coder/works/pdf-translate-web-v2 && nohup python3 app.py > /tmp/pdf-v2.log 2>&1 &
# 碎片信息记录
cd ~/.openclaw/workspace-coder/works/snippet-notes && nohup python3 app.py > /tmp/snippet.log 2>&1 &
# ParamHub Python
cd ~/.openclaw/workspace-coder/works/param-hub-python && nohup python3 app.py > /tmp/paramhub.log 2>&1 &
停止所有Web服务
pkill -f "app.py.*port=19000"
pkill -f "app.py.*port=19009"
pkill -f "app.py.*port=19010"
更新日志
2026-04-10
- 创建 Web服务监控系统
- 配置 Cron 定时任务(每20分钟检查)
- 邮件通知功能(发送到 zuitoushang@tphai.com)
2026-04-11
- 创建项目服务管理面板 (project-panel)
- 端口: 19013
- 功能: 项目列表、状态检测、启动/停止/重启控制、日志查看
- Git仓库: http://192.168.2.8:12007/coder/project-panel v1.0.0
2026-04-09
- 创建 PROJECTS.md 项目记录文件
- 记录现有8个项目详情
- 整理端口分配表和快速操作命令
- 优化 stock_system 获取脚本 V2(分文件+批量合并+SQLite)
待办
- 为每个项目创建 Git 仓库和版本 tag
- 配置 systemd 服务实现开机自启动
2026-04-12
- 技术论坛 v1.2.0 合并改进
- 后台整合到 /admin 路径(统一端口19004)
- 前台保持原有路由
- 简化部署,只需启动一个服务
- Git仓库: http://192.168.2.8:12007/coder/tech-forum v1.2.0
### 停止所有Web服务
```bash
pkill -f "app.py.*port=19000"
pkill -f "app.py.*port=19009"
pkill -f "app.py.*port=19010"
更新日志
2026-04-10
- 创建 Web服务监控系统
- 配置 Cron 定时任务(每20分钟检查)
- 邮件通知功能(发送到 zuitoushang@tphai.com)
2026-04-11
- 创建项目服务管理面板 (project-panel)
- 端口: 19013
- 功能: 项目列表、状态检测、启动/停止/重启控制、日志查看
- Git仓库: http://192.168.2.8:12007/coder/project-panel v1.0.0
2026-04-09
- 创建 PROJECTS.md 项目记录文件
- 记录现有8个项目详情
- 整理端口分配表和快速操作命令
- 优化 stock_system 获取脚本 V2(分文件+批量合并+SQLite)
待办
- 为每个项目创建 Git 仓库和版本 tag
- 配置 systemd 服务实现开机自启动<E590AF>
- 整理端口分配表和快速操作命令
- 优化 stock_system 获取脚本 V2(分文件+批量合并+SQLite)
待办
- 为每个项目创建 Git 仓库和版本 tag
- 配置 systemd 服务实现开机自启动