# 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/19005 | ✅ 已修复 | 2026-04-12 |

---

## 项目详情

### 1. PDF翻译助手 V2 (pdf-translate-web-v2)

**简介**: 英文PDF翻译中文网站，支持用户系统、会员体系、数据包购买、后台动态配置。

**目录**: `works/pdf-translate-web-v2`

**启动命令**:
```bash
cd ~/.openclaw/workspace-coder/works/pdf-translate-web-v2
python3 app.py
```

**访问地址**: http://localhost:19000

**后台管理**: http://localhost:19000/admin (账号: admin / admin123)

**检查服务状态**:
```bash
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`

**启动命令**:
```bash
cd ~/.openclaw/workspace-coder/works/llm-index-rag
python3 app.py
```

**访问地址**: http://localhost:19001

**系统设置**: http://localhost:19001/settings

**检查服务状态**:
```bash
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`

**启动命令**:
```bash
# 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

**检查服务状态**:
```bash
curl -s http://localhost:19011/api/products
```

**功能特点**:
- 多步骤爬取流程配置
- 浏览器爬虫（Playwright，处理JS渲染）
- 静态爬虫（requests + BeautifulSoup）
- 数据存储和导出

**依赖**:
- Python 3 + Flask + Playwright + BeautifulSoup

---

### 4. 碎片信息记录 (snippet-notes)

**简介**: 简洁的碎片信息记录工具，支持实时保存、AI自动生成标题、搜索、置顶、导出Markdown。

**目录**: `works/snippet-notes`

**启动命令**:
```bash
cd ~/.openclaw/workspace-coder/works/snippet-notes
python3 app.py
```

**访问地址**: http://localhost:19009

**检查服务状态**:
```bash
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`

**启动命令**:
```bash
cd ~/.openclaw/workspace-coder/works/param-hub-python
python3 app.py
```

**访问地址**: http://localhost:19010

**后台管理**: http://localhost:19010/admin

**检查服务状态**:
```bash
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`

**安装方法**:
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`

**启动命令**:
```bash
# 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

**检查服务状态**:
```bash
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使用示例**:
```bash
# 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`

**启动命令**:
```bash
cd ~/.openclaw/workspace-coder/works/project-panel
python3 app.py
```

**访问地址**: http://localhost:19013

**检查服务状态**:
```bash
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`

**使用命令**:
```bash
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`

**启动命令**:
```bash
cd /home/xian/.openclaw/common/stock_system
bash run_v2.sh
# 或直接运行
python3 fetch_history_v2.py
```

**V2优化点**:
- 分文件存储：每只股票存独立小文件，避免每次读写203MB大文件
- 批量合并：每50只股票合并一次到主文件
- SQLite进度库：更可靠的断点续传机制
- 请求间隔减少：从5秒降到0.3秒，用轻量存储补偿

**检查进度**:
```bash
# 查看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

**手动检查**:
```bash
python3 ~/.openclaw/workspace-coder/works/service-monitor/monitor.py
```

**查看日志**:
```bash
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格式邮件通知

**使用命令**:
```bash
# 测试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`

**启动命令**:
```bash
cd ~/.openclaw/workspace-coder/works/ai-chat
./start_v2.sh
```

**访问地址**: 
- 网页端: http://localhost:19020
- 后台管理: http://localhost:19020/admin

**检查服务状态**:
```bash
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`

**使用命令**:
```bash
# 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+（仅标准库，无需额外安装）

---

## 端口分配表

| 端口 | 项目 | 说明 |
|------|------|------|
| 19000 | PDF翻译助手 V2 | 主服务 + 后台 |
| 19001 | LLM Index RAG | API服务 |
| 19002-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@!

---

## 快速操作命令

### 查看所有服务状态
```bash
for port in 19000 19001 19009 19010; do
  echo "端口 $port:"
  curl -s http://localhost:$port --max-time 1 > /dev/null && echo "  ✅ 运行中" || echo "  ❌ 未启动"
done
```

### 启动所有Web服务
```bash
# 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服务
```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 服务实现开机自启动

### 2026-04-12
- 技术论坛 v1.1.0 安全重构
  - 后台添加登录验证（Session + JWT）
  - JSON存储改为SQLite数据库
  - API密钥移至配置文件（支持环境变量）
  - SECRET_KEY改为随机生成
  - 新增管理员登录页面
  - Git仓库: http://192.168.2.8:12007/coder/tech-forumclaw/workspace-coder/works/param-hub-python && nohup python3 app.py > /tmp/paramhub.log 2>&1 &
```

### 停止所有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 服务实现开机自启动