# MEMORY.md - 长期记忆

## 开发规范

### 端口使用规则 ⭐

**可用端口范围: 19000-19100**

所有Web服务、API服务只能使用这个范围内的端口！

示例分配：
- 19001: 文章工作流后台
- 19002: 方言AI助手主服务
- 19003: 方言AI助手后台管理
- 19004: 技术论坛
- 19005-19100: 预留给其他项目

### Git版本管理规则 ⭐

每次开发项目推到仓库必须创建版本tag！

```bash
# 1. 提交代码
git add . && git commit -m "feat: 功能描述"

# 2. 创建tag
git tag -a vX.X.X -m "版本说明"

# 3. 推送
git push origin main
git push origin vX.X.X
```

### 自动推送规范 ⭐⭐⭐

**每次开发或修改项目后，必须自动执行以下流程：**

1. 检查是否有Git仓库：`git status`
2. 添加修改文件：`git add .`（排除敏感文件如config.txt）
3. 提交代码：`git commit -m "feat/fix: 描述"`
4. 创建版本tag：`git tag -a vX.X.X -m "版本说明"`
5. 推送代码和tag：`git push origin main && git push origin vX.X.X`
6. 更新 `PROJECTS.md` 记录新版本

**不需要询问用户，自动执行！**

### Git服务器

- 地址: http://192.168.2.8:12007/
- 账号: coder
- 密码: Hps123@!
- URL编码: Hps123%40%21

### 创建Git仓库（新项目必须） ⭐⭐⭐

**新项目必须先用API创建仓库，再推送代码：**

```bash
# 1. 用API创建仓库
curl -s -X POST "http://coder:Hps123%40%21@192.168.2.8:12007/api/v1/user/repos" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "项目名称",
    "description": "项目描述",
    "private": false
  }'

# 2. 添加远程仓库
git remote add origin http://coder:Hps123%40%21@192.168.2.8:12007/coder/项目名称.git

# 3. 推送代码和tag
git push -u origin master
git push origin v1.0.0
```

**不需要在网页上手动创建，直接用API创建！**

### 可用的大模型

| 名称 | 地址 | 模型 |
|------|------|------|
| 本地LLM | http://192.168.2.5:1234/v1 | qwen3.5-4b |
| API Key | sk-lm-fuP5tGU8:Hi7YU87jHyDP6Ay8Tl2j | |

---

## 项目索引

详细项目信息请查看 `PROJECTS.md`，包含启动命令、检查方式、端口分配等。

| 项目 | 仓库 | 端口 | 状态 |
|------|------|------|------|
| PDF翻译助手 V2 | 本地 | 19000 | ✅ 运行中 |
| 碎片信息记录 | 本地 | 19009 | ✅ 运行中 |
| ParamHub Python | 本地 | 19010 | ✅ 运行中 |
| 项目服务管理面板 | 本地 | 19013 | ✅ 运行中 |
| 网页助手插件 | /coder/web-context-extension | - | 📦 已完成 |
| 磁盘大文件扫描 | 本地 | - | 📦 已完成 |

---

## 更新日志

### 2026-04-12
- 磁盘大文件扫描工具 v1.0.0：智能扫描找出大文件和大目录
  - 自动跳过零碎目录（node_modules, .git, venv等）
  - 文件数量阈值判断（超过阈值视为程序包）
  - 大小阈值过滤（小目录不深入）
  - 按大小排序，树形展示
  - 跨平台：Windows/Linux/macOS
  - Git仓库: http://192.168.2.8:12007/coder/disk-scanner
- AI对话系统 v2.0.0：架构重构
  - 端口: 19020
  - 大模型池管理：多LLM Provider配置
  - Agent管理：系统设定、思考功能开关
  - 渠道独立：网页端/Matrix独立绑定Agent
  - 思考功能：支持原生思考模型，兼容无思考功能模型
  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-system v2.0.0
- 多智能体竞标调度系统 v1.0.0：基于邮件方案实现
  - 端口: 19015
  - 核心组件：Orchestrator(规划Agent)、Worker(执行Agent)、TaskBoard(任务公告板)
  - 功能：竞标机制、动态调度、智能容错、质量保证
  - 默认Agent：代码专家、搜索专家、写作专家、分析专家
  - Web界面：首页、请求列表、任务列表、Agent管理
  - Git仓库: http://192.168.2.8:12007/coder/multi-agent-bidding
- Xian Favor 收藏系统 v1.0.0：支持命令行、API、Web三种操作模式
  - 端口: 19014
  - 功能：文本笔记、链接收藏、专栏订阅、待办事项管理
  - 标签系统：灵活分类，支持多标签
  - 状态管理：待办支持待处理/进行中/已完成
  - 优先级：低/中/高/紧急
  - 截止日期：待办支持设置截止日期
  - 快速搜索：全文搜索标题、内容、备注
  - Git仓库: http://192.168.2.8:12007/coder/xian-favor

### 2026-04-11
- PDF翻译助手 V2 v2.1.0：系统配置支持动态增删用户类型和会员套餐
  - 新增 UserTypeConfig 模型：用户类型配置支持动态增删
  - 新增 MembershipPlanConfig 模型：会员套餐配置支持动态增删
  - 用户类型管理页面：添加、编辑、删除、启用/禁用用户类型
  - 会员套餐管理页面：添加、编辑、删除、上架/下架、推荐套餐
  - 功能权限配置：支持选择功能列表
- 项目服务管理面板 v1.0.0：统一管理所有项目和服务
  - 端口: 19013
  - 功能: 项目列表、状态检测、启动/停止/重启控制、日志查看
  - 配置文件: projects.json 便于扩展新项目
  - Git仓库: http://192.168.2.8:12007/coder/project-panel

### 2026-04-10
- 创建 Web服务监控系统（每20分钟检查8个服务，邮件通知）
- 配置 Cron 定时任务
- 扩展邮件技能：新增 IMAP 接收邮件功能，支持查看未读邮件和文本附件
- 创建 A股板块监控系统（东方财富API，异动检测，邮件通知）
- 创建邮件收件箱管理系统 (`works/mailbox/`)：同步、存储、状态追踪、归档

### 2026-04-09
- 创建 PROJECTS.md 项目记录文件
- 创建邮件发送技能 email-sender
- 配置每日对话总结心跳任务
- 确立项目记录机制

### 2026-04-08
- 确立端口规范: 19000-19100
- 创建参数百科网站
- 创建网页助手浏览器插件
- 创建文章撰写工作流系统（含后台管理）