docs: 整理2026-04-28会话记录并更新长期记忆

2026-04-29 11:09:24 +08:00
parent 74b95f9f18
commit 055c60aae2
4 changed files with 298 additions and 4 deletions
--- a/MEMORY.md
+++ b/MEMORY.md
@@ -1,8 +1,58 @@
 # MEMORY.md - 长期记忆

-## 开发规范
+## 项目索引

-### 开发测试流程 ⭐⭐⭐
+详细项目信息请查看 `PROJECTS.md`，包含启动命令、检查方式、端口分配等。
+
+| 项目 | 仓库 | 端口 | 状态 |
+|------|------|------|------|
+| PDF翻译助手 V2 | 本地 | 19000 | ✅ 运行中 |
+| 碎片信息记录 | 本地 | 19009 | ✅ 运行中 |
+| ParamHub Python | 本地 | 19010 | ✅ 运行中 |
+| 项目服务管理面板 | 本地 | 19013 | ✅ 运行中 |
+| 视觉记录系统 | /coder/vision-record | 19016 | ✅ 运行中 |
+| AI Chat App | /coder/ai-chat-app | - | 📦 开发中 |
+| 网页助手插件 | /coder/web-context-extension | - | 📦 已完成 |
+| 磁盘大文件扫描 | 本地 | - | 📦 已完成 |
+
+---
+
+## ParamHub Python - 参数百科系统
+
+**Git仓库**: http://192.168.2.8:12007/coder/param-hub-python
+
+### 核心功能架构
+
+**1. 参数字段配置系统**
+- 类别层面：基础参数字段（所有子类别共享）
+- 子类别层面：可添加额外参数字段（extra_fields）
+- 字段结构：`{key, label, type, description, required, input_style}`
+- 前端表格列和编辑表单从类别配置动态生成
+
+**2. 子类别管理**
+- 内置分类（ai-models、gpus、cpus）支持子类别编辑
+- 子类别有 `key_features`（关键特性字段）和 `extra_fields`（额外参数）
+- 智能添加时可选子类别，解析时包含额外字段
+
+**3. 智能添加/补充解析**
+- 上传参数截图（规格表、参数页面）而非产品图
+- AI根据类别字段配置解析参数
+- 支持多次解析，每次来源记录到 `parse_sources` 数组
+- 解析来源记录：`{type, timestamp, images, text, updated_fields}`
+
+**4. 子类别分配**
+- AI模型：chat、code、reasoning、vision
+- GPU：datacenter、professional、gaming
+- CPU：server、desktop、mobile
+
+**5. 数据字段规范**
+- 所有参数字段统一为文本类型
+- 长文本字段（description等）标记 `input_style: 'long'
+- 发布日期统一格式：YYYY-MM-DD
+
+---
+
+## 更新日志

 **必须遵循的工作流程：**

@@ -166,6 +216,96 @@ server.quit()

 ## 更新日志

+- **AI Chat App v3.14.4**：修复API URL拼接问题
+  - 前端自动拼接 `/chat/completions` 到后台配置的 API URL
+  - 解决后台存储 `https://api.xxx/v1` 但前端需要完整 URL 的问题
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.14.4
+
+- **AI Chat App v3.14.3**：修复普通对话不使用后台配置的LLM
+  - `/api/config` 现根据 `chat_config.llm_config_id` 获取对应的 LLM 配置
+  - 解决原来直接取默认 LLM 配置的问题
+  - 后台管理"对话配置"选择的 LLM 现在在前端生效
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.14.3
+
+- **AI Chat App v3.14.2**：TTS文本清理优化
+  - 语音播放过滤Markdown特殊字符：标题#、列表-*、代码块、链接、粗体斜体等
+  - 过滤表情符号（emoji）
+  - 过滤引用符号>、分割线等
+  - 清理多余空白，保留纯文本内容
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.14.2
+
+- **AI Chat App v3.14.1**：TTS流式播放+新对话默认关闭
+  - 新建对话（普通对话和智能体对话）默认关闭语音播放
+  - AI回复边生成边播放（流式TTS），不等完全生成完
+  - 每80字符左右播放一段，智能断句（句子结束符号）
+  - 使用队列机制管理播放，顺序播放各段文本
+  - 切换对话时自动停止当前播放
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.14.1
+
+- **AI Chat App v3.14.0**：AI回复语音播放功能
+  - 普通对话和智能体对话支持语音播放（Edge TTS）
+  - 对话界面顶部右侧添加语音播放开关按钮（替代原清除按钮）
+  - AI消息操作栏添加播放按钮，点击可播放/停止
+  - 开启后AI回复完成自动播放
+  - 后台管理系统设置添加TTS方案和语音配置
+  - 支持多种中文语音（晓晓、云希等）
+  - API：POST /api/tts（生成语音），GET /api/tts/voices（语音列表）
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.14.0
+
+- **AI Chat App v3.13.3**：修复用户信息API路由缺失
+  - `/api/user/<int:id>` 只有PUT方法，添加GET方法
+  - 前端初始化可正确获取用户信息（包括头像）
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.13.3
+
+- **AI Chat App v3.13.2**：修复登录用户跨设备头像不同步
+  - 初始化时从后台 API `/api/user/<id>` 获取最新用户信息（包括头像）
+  - 解决原来只从 localStorage 加载导致换设备头像不更新的问题
+  - 同时更新 localStorage 保持离线可用
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.13.2
+
+- **AI Chat App v3.13.1**：修复系统设置部分配置项无法保存
+  - init_db 添加兼容逻辑，自动检测并插入缺失的系统配置字段
+  - 解决旧数据库缺少 app_developer、app_update_date、app_technology、app_description 等字段的问题
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.13.1
+
+- **AI Chat App v3.13.0**：我的页面和关于页面绑定后台系统配置
+  - 版本号、技术基础、开发者、更新日期从后台管理设置生效
+  - 隐私政策、用户协议链接从后台配置读取，点击跳转外部链接
+  - 前端加载后台配置后赋值到 CONFIG.system
+  - 前端加载后台 LLM 配置（api_url、api_key、model）
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.13.0
+
+- **AI Chat App v3.12.3**：修复发现智能体搜索bug
+  - 搜索功能现在正确过滤基础智能体（basic类别）
+  - filterDiscoverAgents 函数添加 basic 类别处理
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.12.3
+
+- **AI Chat App v3.12.2**：历史使用记录布局修正
+  - 左边：对话标题
+  - 右边：智能体名字（带样式标签）
+  - 主页最近使用列表同样修正
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.12.2
+
+- **AI Chat App v3.12.1**：历史使用记录布局调整
+  - 左边：智能体名字（如"代码助手"）
+  - 右边：对话标题
+  - 主页最近使用列表同样调整
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.12.1
+
+- **AI Chat App v3.12.0**：智能体对话标题自动更新+历史显示优化
+  - 智能体对话初始标题改为"新对话"，和普通对话一致
+  - 第一次对话和每5次对话自动生成标题（AI总结）
+  - 历史使用界面：左边是对话标题，右边显示智能体类型（工作/学习/生活等）
+  - 主页最近使用列表同样优化显示智能体类型
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.12.0
+
+- **AI Chat App v3.11.0**：用户头像在对话界面正确显示
+  - 修改消息渲染逻辑，用户头像使用 currentUser.avatar
+  - 普通对话和智能体对话界面都正确显示用户修改的头像
+  - AI 头像使用智能体头像（智能体对话）或默认头像（普通对话）
+  - 支持图片头像和 emoji 头像的渲染
+  - Git仓库: http://192.168.2.8:12007/coder/ai-chat-app v3.11.0
+
 - **AI Chat App v3.10.4**：智能体对话界面工具栏优化
  - 智能体对话不显示工具选择按钮（深度思考、联网搜索、更多工具）
  - 智能体使用的工具由后台管理配置决定
--- a/memory/2026-04-28.md
+++ b/memory/2026-04-28.md
@@ -0,0 +1,132 @@
+# 2026-04-28 每日事务记录
+
+## 开发任务
+
+### ParamHub Python - 子类别管理与参数字段配置系统
+
+**需求来源**: 用户（openclaw-control-ui）
+
+**版本迭代**（下午开发，v1.7.2 ~ v1.14.0）:
+
+| 版本 | 功能 |
+|------|------|
+| v1.7.2 | 修复分类编辑API缺失 - 添加 GET /api/categories/<id> |
+| v1.8.0 | 智能补充参数功能 - 编辑已有产品时上传参数截图/文本补充缺失字段 |
+| v1.8.1 | 内置分类子类别管理 - 分类管理中可编辑内置类别的子类别配置 |
+| v1.8.2 | ID自动生成 - 分类和子类别ID无需手动填写 |
+| v1.9.0 | 子类别字段和筛选 - 所有数据支持子类别字段，列表可筛选 |
+| v1.9.1 | 产品子类别分配 - 为模型/GPU/CPU等分配子类别 |
+| v1.10.0 | 参数字段管理 - 类别和子类别可配置参数列表 |
+| v1.10.1 | 参数字段配置 - 为所有类别配置14-17个参数字段 |
+| v1.11.0 | 智能添加字段配置解析 - 根据类别参数字段配置解析数据 |
+| v1.12.0 | 动态字段显示 - 表格列和编辑表单从类别配置动态生成 |
+| v1.12.1 | 语法错误修复 - JSON.stringify images字段重复定义 |
+| v1.12.2 | 发布日期统一 - 所有产品发布日期格式 YYYY-MM-DD |
+| v1.13.0 | 参数截图+解析来源历史 - 图片改为参数截图，支持多次解析并记录来源 |
+| v1.14.0 | 字段统一为文本类型 - 长文本字段标记 input_style |
+
+**核心功能点**:
+
+1. **参数字段配置系统**
+   - 类别层面：基础参数字段（所有子类别共享）
+   - 子类别层面：可添加额外参数字段
+   - 字段结构：key、label、type、description、required、input_style
+   - 前端动态生成表格列和编辑表单
+
+2. **子类别管理**
+   - 内置分类（ai-models、gpus、cpus）支持子类别编辑
+   - 子类别有 key_features（关键特性）和 extra_fields（额外参数）
+   - 智能添加时可选子类别，解析时包含额外字段
+
+3. **智能添加/补充解析**
+   - 上传参数截图（规格表、参数页面）而非产品图
+   - AI根据类别字段配置解析参数
+   - 支持多次解析，每次来源记录到 parse_sources
+   - 解析来源记录：timestamp、images、text、updated_fields
+
+4. **数据结构**
+   ```json
+   {
+     "parse_sources": [{
+       "type": "smart_add",
+       "timestamp": "2026-04-28 22:41:00",
+       "images": ["参数截图URL"],
+       "text": "解析文本",
+       "updated_fields": ["补充的字段"]
+     }],
+     "product_images": []  // 产品展示图（后续功能）
+   }
+   ```
+
+**Git仓库**: http://192.168.2.8:12007/coder/param-hub-python
+
+---
+
+### AI Chat App - 用户头像在对话界面显示
+
+**需求来源**: 用户（huangzhuang_bro）
+
+**v3.11.0 主要改动**:
+1. 修改 `renderMessages` 函数中的头像逻辑
+2. 用户头像使用 `currentUser?.avatar || '👤'`
+3. AI 头像使用智能体头像 `currentAgent?.avatar || '🤖'`
+4. 使用 `renderAvatar()` 函数渲染用户头像（支持图片和 emoji）
+5. 普通对话和智能体对话界面都正确显示用户修改的头像
+
+**Git仓库**: http://192.168.2.8:12007/coder/ai-chat-app v3.11.0
+
+---
+
+### AI Chat App - 智能体对话标题自动更新+历史显示优化
+
+**需求来源**: 用户（huangzhuang_bro）
+
+**v3.12.0 主要改动**:
+1. 智能体对话初始标题改为"新对话"（和普通对话一致）
+2. 第一次对话和每5次对话自动生成标题（AI总结）
+3. 历史使用界面：左边显示对话标题，右边显示智能体类型
+4. 主页最近使用列表同样优化显示智能体类型
+
+**Git仓库**: http://192.168.2.8:12007/coder/ai-chat-app v3.12.0
+
+---
+
+### AI Chat App - 我的页面和关于页面绑定后台系统配置
+
+**需求来源**: 用户（huangzhuang_bro）
+
+**v3.13.0 主要改动**:
+1. 前端加载后台配置后赋值到 CONFIG.system
+2. 我的页面底部显示版本号、技术基础从后台配置读取
+3. 关于页面所有信息从后台配置读取
+4. 隐私政策、用户协议链接从后台配置读取
+
+**Git仓库**: http://192.168.2.8:12007/coder/ai-chat-app v3.13.0
+
+---
+
+### AI Chat App - AI回复语音播放功能（Edge TTS）
+
+**需求来源**: 用户（huangzhuang_bro）
+
+**v3.14.0 主要改动**:
+1. 普通对话和智能体对话界面顶部右侧添加语音播放开关按钮
+2. AI消息操作栏添加播放按钮，点击播放/停止语音
+3. 开启后AI回复完成自动播放
+4. 后台管理系统设置添加TTS配置（方案、语音选择）
+5. 支持多种中文语音（晓晓、云希、云健等）
+
+**技术要点**:
+- 使用 edge-tts 库（免费）生成语音
+- 后端 API：POST /api/tts，GET /api/tts/voices
+- 前端使用 Audio 对象播放 MP3 音频
+
+**Git仓库**: http://192.168.2.8:12007/coder/ai-chat-app v3.14.0
+
+---
+
+## 备注
+
+今日完成了两个项目的重要功能：
+- **ParamHub Python**: 子类别管理、参数字段配置、智能解析系统（14个版本迭代）
+- **AI Chat App**: 头像显示、标题机制、语音播放（4个版本迭代）
--- a/memory/2026-04-29.md
+++ b/memory/2026-04-29.md
@@ -0,0 +1,22 @@
+# 2026-04-29 每日事务记录
+
+## 开发任务
+
+### ParamHub Python - 参数字段统一为文本类型
+
+**需求来源**: 用户（openclaw-control-ui）
+
+**v1.14.0 主要改动**:
+1. 所有参数字段改为文本类型（type: 'text'）
+2. 长文本字段（description、specs）标记 input_style: 'long'
+3. 普通文本字段标记 input_style: 'normal'
+4. 前端根据 input_style 显示不同输入控件（textarea vs input）
+5. 数值字段暂时保持文本存储，后期考虑数值对比功能
+
+**Git仓库**: http://192.168.2.8:12007/coder/param-hub-python v1.14.0
+
+---
+
+## 备注
+
+上午整理了昨天的会话记录并更新记忆文件。
--- a/memory/heartbeat-state.json
+++ b/memory/heartbeat-state.json
@@ -1,7 +1,7 @@
 {
-  "lastSummaryDate": "2026-04-28",
+  "lastSummaryDate": "2026-04-29",
  "lastChecks": {
    "memory_created": "2026-04-21T02:24:00Z",
-    "2026-04-27_summary": "已整理并更新 memory/2026-04-27.md"
+    "2026-04-28_summary": "已整理，memory/2026-04-28.md 已存在，记录完整"
  }
 }