Files
ai-chat-app/PROJECTS.md

19 KiB
Raw Blame History

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 "服务未启动"

依赖:


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

访问地址:

检查服务状态:

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字段
  • 价格显示优化:支持多币种、价格区间、单位

依赖:


5. 网页助手插件 (web-context-extension)

简介: 浏览器扩展插件右键菜单支持收藏网页、AI总结、深度研究分析。

目录: works/web-context-extension

安装方法:

  1. Chrome浏览器打开 chrome://extensions/
  2. 开启"开发者模式"
  3. 点击"加载已解压的扩展程序"
  4. 选择 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

访问地址:

检查服务状态:

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

依赖:


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 ProviderAgent可选择使用
  • 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

2026-04-09

  • 创建 PROJECTS.md 项目记录文件
  • 记录现有8个项目详情
  • 整理端口分配表和快速操作命令
  • 优化 stock_system 获取脚本 V2分文件+批量合并+SQLite

待办

  • 为每个项目创建 Git 仓库和版本 tag
  • 配置 systemd 服务实现开机自启动

2026-04-12

  • 技术论坛 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

2026-04-09

  • 创建 PROJECTS.md 项目记录文件
  • 记录现有8个项目详情
  • 整理端口分配表和快速操作命令
  • 优化 stock_system 获取脚本 V2分文件+批量合并+SQLite

待办

  • 为每个项目创建 Git 仓库和版本 tag
  • 配置 systemd 服务实现开机自启动<E590AF>
  • 整理端口分配表和快速操作命令
  • 优化 stock_system 获取脚本 V2分文件+批量合并+SQLite

待办

  • 为每个项目创建 Git 仓库和版本 tag
  • 配置 systemd 服务实现开机自启动