ly1213/get_wechat

Fork 0

Files

ly1213 b913b8c78c Initial upload for secondary development

2026-06-08 19:00:03 +08:00

18 KiB

Raw Permalink Blame History

修改日志 CHANGELOG

本文件记录每次代码修改的内容、原因与时间，精确到分钟，便于回溯和审查。 规则：每次修复 Bug 或新增功能，必须在此文件追加一条记录。

[2026-05-11 01:15] 项目瘦身：清理分发包多余文件

背景

项目原始大小 2.3 GB，包含构建产物、Go SDK、PyInstaller 输出等开发专用文件，发送给用户体积过大。清理后保留"无痕启动控制台"完整运行所需的最小文件集。

删除内容

路径	大小	原因
`chatlog_fastAPI/dist/`	653 MB	PyInstaller 打包输出，不走此 exe 启动
`chatlog_fastAPI/build/`	206 MB	PyInstaller 中间产物
`electron-launcher/dist/`	349 MB	electron-builder 安装包，不走此包启动
`go_env/`	276 MB	完整 Go SDK，chatlog.exe 已编译完毕
`chatlab-web/frontend/dist/`	~1 MB	Vite 构建输出，走 npm run dev
`cmd/` `internal/` `pkg/` `bin/`	<2 MB	Go 源码，不重新编译则无用
`chatlab-web/backend/`	49 KB	废弃旧版 Python 后端
`scripts/` `.github/` `.vscode/`	小	开发专用
`main.go` `go.mod` `go.sum` `Makefile` `.goreleaser.yaml` `.gitignore`	小	Go 构建文件
`lib/windows_x64/wx_key.exp/.lib/.pdb`	小	链接/调试符号，运行只需 .dll
`chatlog_fastAPI/__pycache__/` 等	28 KB	Python 字节码缓存，运行时自动重建
`chatlog_fastAPI/chatlog.db` `knowledge.db` `*.spec` `test_wxid.py` `backend_design.md`	小	空文件/调试/设计文档
`test_audio*.py` `test_upload.go.bak` `launcher_error.log`	小	临时调试文件
`README（原）.md` `chatlab.md` `dll调用指南.md` `启动与编译命令指南.md`	小	开发参考文档
`chatlog_fastAPI/knowledge_wxid_*.db`	~224 KB	个人账号知识库，用户登录后自动生成

节省：~1.49 GB（2.3 GB → 863 MB）

保留内容（最小运行集）

get_wechat_me/
├── 无痕启动控制台.vbs        启动入口
├── chatlog.exe               Go 后端（63 MB）
├── CHANGELOG.md / README.md / DISCLAIMER.md / LICENSE
├── lib/windows_x64/wx_key.dll
├── electron-launcher/
│   ├── main.js / preload.js / index.html / package.json / package-lock.json
│   └── node_modules/（650 MB，electron 二进制）
├── chatlog_fastAPI/
│   ├── main.py / config.py / database.py / scheduler.py
│   ├── .env / requirements.txt
│   ├── routers/ / services/
└── chatlab-web/frontend/
    ├── src/ / public/ / index.html / vite.config.js / package.json
    └── node_modules/（150 MB，Vite + React）

[2026-05-11 01:05] Bug 修复：可搜索下拉浮层背景透明

问题描述

上一轮新增的"添加群聊"可搜索下拉浮层背景完全透明，条目文字叠在底层内容上，可读性极差。

根因

代码中使用了 var(--surface) 和 var(--surface-2) 两个 CSS 变量，但 index.css 的 :root 从未定义这两个变量，浏览器 fallback 为 transparent。
这两个变量在整个项目（TopicsPage.jsx、KnowledgePage.jsx、MessageBubble.jsx、SettingsPage.jsx、App.jsx）中被广泛引用。

修改文件明细

1. `chatlab-web/frontend/src/index.css`

改动：在 :root 的颜色变量区域追加两行别名定义：

/* 别名：兼容组件中使用的 var(--surface) / var(--surface-2) */
--surface:   #ffffff;   /* 等同于 --bg-surface */
--surface-2: #f0f2f5;  /* 等同于 --bg-overlay */

原因：项目现有的背景变量命名为 --bg-surface、--bg-overlay 等，但大量组件使用了更简短的 --surface/--surface-2 命名。根本修复是在 CSS 中统一补充定义这两个别名，一次修复所有引用，避免逐文件替换。

位置：chatlab-web/frontend/src/index.css，:root 第 6 行后
新增 3 行

2. `chatlab-web/frontend/src/pages/TopicsPage.jsx`

改动：将浮层容器和条目中仍残留的错误变量名手动替换为正确值：

浮层容器：var(--surface) → var(--bg-surface)
条目默认背景：transparent → var(--bg-surface)（使其与浮层容器背景一致）
条目选中态：var(--surface-2) → var(--bg-overlay)
onMouseEnter：var(--surface-2) → var(--bg-hover)
onMouseLeave：var(--surface-2) → var(--bg-overlay)

原因：在 CSS 补充别名定义之外，同步将浮层的引用改为语义更明确的 --bg-* 系列变量，确保悬停/选中状态的颜色层次感正确（白底 → 悬停浅灰 → 选中深灰）。

位置：showGroupDropdown 浮层（第 315-340 行）
修改 5 处变量名

总结

文件	改动性质	解决的问题
`chatlab-web/frontend/src/index.css`	Bug 修复	全局补充 `--surface`/`--surface-2` CSS 变量定义，消除所有相关透明背景问题
`chatlab-web/frontend/src/pages/TopicsPage.jsx`	变量名规范化	浮层下拉列表背景透明，条目悬停/选中状态无法区分

[2026-05-10 15:42] Bug 修复：新账号首次解密引导 + 账号切换前端数据刷新

问题描述

新账号无法在启动器一键解密：切换到从未登录过的新微信账号时，需要手动进入 chatlog.exe 的 TUI 界面执行解密，启动器无法自动引导。
账号切换后前端消息不刷新：切换微信账号并重启控制台后，React 前端仍然显示上一个账号的会话列表和消息，没有切换到新账号的数据。
FastAPI 层账号数据库不切换：_resolved_wxid 全局变量一旦解析成功后永不刷新，账号切换后 Python 业务层仍读取旧账号的知识库数据库。

修改文件明细

1. `electron-launcher/main.js`

改动：在 keyProcess.on('close') 回调中，读取完 savedWorkDir 后，新增对工作目录的检测逻辑：

若工作目录不存在或目录内无 .db 文件 → 判定为"新账号首次解密"，向渲染进程发送 show-decrypt-dialog IPC 事件，弹出引导弹窗。
若工作目录已存在 .db 文件 → 判定为"已解密账号"，直接启动 server，不弹窗。

原因：chatlog.exe key 命令执行完毕后会更新 ~/.chatlog/chatlog.json 的 last_account，此时读取的 savedWorkDir 才是当前账号对应的工作目录。通过检测该目录是否含有解密产物（.db 文件），即可区分新旧账号。

位置：electron-launcher/main.js，keyProcess.on('close') 内，第 251 行附近
新增约 20 行代码

2. `electron-launcher/preload.js`

改动：在 contextBridge.exposeInMainWorld 中新增一条 IPC 监听：

onShowDecryptDialog: (callback) => ipcRenderer.on('show-decrypt-dialog', () => callback())

原因：Electron 的 contextIsolation 模式下，渲染进程无法直接访问 ipcRenderer，必须通过 preload.js 的 contextBridge 安全暴露。新增的 show-decrypt-dialog 事件需要在这里注册后，index.html 中的 JS 才能通过 window.electronAPI.onShowDecryptDialog 收到通知。

位置：electron-launcher/preload.js，第 19-20 行
新增 1 行

3. `electron-launcher/index.html`

改动（CSS 部分）：新增模态弹窗相关样式（.modal-overlay、.modal-box、.modal-title、.modal-body、.modal-steps、.modal-footer、.modal-spinner 及其动画）。

改动（HTML 部分）：在 <body> 顶部新增 #decrypt-dialog 模态弹窗元素，包含：

标题："🔓 检测到新账号，正在解密数据"
操作步骤引导（切换到微信、点击聊天窗口、翻看历史消息）
与 chatlog.exe 一致的提示说明
底部旋转 spinner + 计时显示

改动（JS 部分）：

新增 decryptDialog、decryptDialogStatus、decryptDialogElapsed DOM 引用。
onDecryptStatus 回调中额外同步更新弹窗计时器（decryptDialogElapsed）。
onDecryptReady 回调中增加 decryptDialog.classList.remove('show') 关闭弹窗。
新增 window.electronAPI.onShowDecryptDialog 监听，收到事件时显示弹窗。

原因：用户切换新账号时需要按照 chatlog.exe TUI 中相同的操作提示（点击微信聊天界面）才能完成密钥提取。弹窗承担了原来需要手动进入 TUI 界面的提示职责，实现"一键解密"体验。

位置：electron-launcher/index.html
新增 ~90 行 CSS + HTML + JS

4. `chatlab-web/frontend/src/App.jsx`

改动：

去掉 localStorage 冷加载旧账号数据：将 useState(() => loadSessionCache()) 改为 useState([])，避免启动时直接显示上一个账号的旧会话列表。
新增账号指纹机制：
- calcFingerprint(sessions) —— 取前 3 个会话 id 拼接成指纹字符串。
- loadAccountFingerprint() / saveAccountFingerprint(fp) —— 读写 localStorage 中的 chatlab_account_fingerprint 键。
getSessions 返回后检测账号切换：loadSessions 函数（封装了原 getSessions 调用）在拿到新会话列表后，对比新旧指纹。若指纹不同，说明账号已切换，立即执行：
- localStorage.removeItem(CACHE_KEY) 清除旧缓存。
- setSelectedRoom(null) 重置当前选中群（否则会拿旧群 id 去查询新账号的消息）。
每 30 秒轮询一次：新增 useEffect 设置 30 秒定时器，静默调用 loadSessions(true)（轮询模式不显示 loading 也不报错），以便在用户不刷新页面的情况下自动感知账号切换。

原因：

旧代码的 getSessions() 只在组件挂载时执行一次，账号切换不触发重新加载。
旧代码从 localStorage 取缓存作为初始 state，导致旧账号数据在新账号登录时"闪现"。
两处修复合力确保前端始终显示当前微信账号的真实数据。

位置：chatlab-web/frontend/src/App.jsx
修改约 40 行，新增约 30 行

5. `chatlog_fastAPI/database.py`

改动：

新增 import time。
新增全局变量 _wxid_last_resolved: float = 0.0 和常量 _WXID_TTL = 60.0。
get_current_wxid() 函数：在命中现有缓存时增加时间判断 (now - _wxid_last_resolved) < _WXID_TTL，超过 60 秒强制重新解析。
在两处成功解析到 wxid 时，均更新 _wxid_last_resolved = time.time()。

原因：原代码中 _resolved_wxid 一旦解析成功就永久缓存，账号切换后 Python 层仍用旧 wxid 路由到旧知识库数据库文件（knowledge_<旧wxid>.db），导致 AI 话题分析、知识库搜索等功能数据错误。60 秒 TTL 平衡了性能与准确性。

位置：chatlog_fastAPI/database.py，第 1-53 行
修改约 10 行，新增约 5 行

6. `chatlog_fastAPI/main.py`

改动：

新增 import asyncio 和 import logging。
新增后台协程 _account_watch_loop()：每 60 秒调用一次 update_db_path()，静默捕获异常。
在 lifespan 上下文管理器中，yield 前用 asyncio.create_task 启动该协程，yield 后取消任务并等待清理。

原因：仅靠 database.py 的 TTL 机制还不够——TTL 只在被调用时才重新检测，如果 FastAPI 长时间运行无请求则无法触发。后台轮询任务确保即使 FastAPI 在后台静默运行，账号切换也能在约 60 秒内被感知并切换数据库。

位置：chatlog_fastAPI/main.py，全文
修改约 5 行，新增约 15 行

总结

文件	改动性质	解决的问题
`electron-launcher/main.js`	功能新增	新账号自动检测 + 弹窗触发
`electron-launcher/preload.js`	IPC 暴露	渲染进程收到新账号通知
`electron-launcher/index.html`	UI 新增	首次解密引导弹窗，等同 chatlog.exe TUI 提示
`chatlab-web/frontend/src/App.jsx`	Bug 修复 + 功能增强	账号切换后前端立即显示新账号数据
`chatlog_fastAPI/database.py`	Bug 修复	账号切换后 Python 层自动切换知识库数据库
`chatlog_fastAPI/main.py`	功能新增	后台定期检测账号变化，无需依赖请求触发

[2026-05-11 00:32] Bug 修复：AI话题分析 & 知识库 4 个 UI 问题

问题描述

AI话题分析"添加群聊"无搜索：群聊列表使用原生 <select>，群多时只能逐条翻找，体验差。
知识库文档无分组：文档平铺展示，无法区分属于哪个群聊/话题。
AI分析无进度条：点击"AI 分析"或"AI 生成知识文档"后，用户不知道当前执行到哪一步。
管理消息弹窗"已添加"不可操作：已加入话题的消息显示静态文字"已添加"，无法直接点击移除。

修改文件明细

1. `chatlab-web/frontend/src/pages/TopicsPage.jsx`

Bug 1 修复 — 群聊选择改为可搜索下拉

将"添加群聊"面板内的原生 <select> 替换为自定义可搜索组件：<input> 搜索框 + 绝对定位浮层列表。
新增 state：groupSearchKeyword、showGroupDropdown。
浮层列表实时过滤（同时匹配群聊名称和群 ID），点击某项后填充输入框并收起浮层。

位置：showAddGroup 块内（第 268 行附近）
新增约 45 行 JSX

Bug 3A 修复 — AI分析进度条

handleInitGroup 轮询中新增 JSON.parse(task.progress) 解析，将 {processed, total} 赋值到 initProgress state（初始化/完成时重置为 null）。
在"AI 分析"按钮下方插入进度条 UI：显示 processed/total 数值 + 彩色进度条（宽度由百分比驱动，0.5s 过渡动画）。
新增 state：initProgress。

位置：handleInitGroup 函数（第 117 行）+ 按钮区域（第 336 行）
修改约 15 行，新增约 22 行

Bug 3B 修复 — AI生成知识文档进度条

handleSummarize 改为接收后端返回的 task_id（res.data.task_id），若存在则用 getTask(task_id) 每 3 秒轮询，解析 progress 字段，更新 summarizeProgress state；若无 task_id 则 fallback 5 秒后刷新。
在"AI 生成知识文档"按钮下方插入进度条 UI（与 3A 样式一致，宽度 180px）。
新增导入：getTask（已在 api/index.js 中定义）。
新增 state：summarizeProgress。

位置：handleSummarize 函数（第 241 行）+ 按钮区域（第 422 行）
修改约 12 行，新增约 40 行

Bug 4 修复 — "已添加"改为红色"移除"按钮

管理消息弹窗左栏：将 topicSeqs.has(Number(m.id)) 为真时显示的 <span>已添加</span> 改为红色 <button>− 移除</button>，点击调用已有的 handleRemoveMsg(Number(m.id))。
样式：color: 'var(--danger)'，borderColor: 'rgba(243,139,168,0.4)'。

位置：管理消息弹窗左栏消息列表（第 531 行）
修改 1 处，约 6 行

2. `chatlog_fastAPI/routers/knowledge.py`

Bug 2 后端 — SQL 联表返回 group_name

两处 SELECT（普通查询 + FTS 关键词查询）均扩展为：
- 新增 LEFT JOIN groups g ON t.group_id=g.id
- 新增返回字段：t.group_id、g.name as group_name
普通查询的 ORDER BY 改为 ORDER BY g.name, k.updated_at DESC，使同一群聊的文档聚在一起。

位置：chatlog_fastAPI/routers/knowledge.py，第 18-33 行
修改约 8 行

3. `chatlab-web/frontend/src/pages/KnowledgePage.jsx`

Bug 2 前端 — 文档列表按群聊分组展示

将原来平铺的 docs.map(...) 改为先按 doc.group_name（后端新增字段）分组，渲染时在每个群聊前加粘性标题头（灰色小号大写文字，背景 var(--surface-2)，position: sticky）。
group_name 为空时归入"未知群聊"分组。

位置：KnowledgePage.jsx，第 96-114 行
修改约 20 行，新增约 30 行

4. `chatlog_fastAPI/routers/topics.py`

Bug 3B 后端 — summarize 接口返回 task_id

POST /api/topics/{id}/summarize 在调用 run_summarize 前，先向 ai_tasks 表插入一条类型为 'summarize'、状态为 'running' 的记录，并把 task_id 随响应返回：{"ok": True, "task_id": task_id}。
前端可用 getTask(task_id) 轮询该记录的 status/progress 字段以展示进度。

位置：chatlog_fastAPI/routers/topics.py，第 142-151 行
修改约 10 行

5. `chatlog_fastAPI/services/summary_engine.py`

Bug 3B 后端 — run_summarize 接收 task_id，完成/出错时更新状态

函数签名新增可选参数 task_id: int | None = None。
新增内部辅助函数 _update_task(status, processed, total)：打开独立数据库连接，UPDATE ai_tasks 记录的 status 和 progress。
在以下关键节点调用 _update_task：
- 任务开始：running, 0, 1
- 无消息/无有效消息/LLM 失败：error, 0, 1
- 生成完成：done, 1, 1
新增 import json（用于序列化 progress 字段）。

位置：chatlog_fastAPI/services/summary_engine.py，第 65-190 行
修改约 8 行，新增约 20 行

总结

文件	改动性质	解决的问题
`TopicsPage.jsx`	UI 替换 + 功能新增	Bug1（可搜索下拉）+ Bug3A（初始化进度条）+ Bug3B（生成知识文档进度条）+ Bug4（移除按钮）
`KnowledgePage.jsx`	UI 重构	Bug2（知识库按群聊分组展示）
`chatlog_fastAPI/routers/knowledge.py`	SQL 扩展	Bug2（返回 group_name 字段）
`chatlog_fastAPI/routers/topics.py`	功能新增	Bug3B（summarize 接口返回 task_id）
`chatlog_fastAPI/services/summary_engine.py`	功能新增	Bug3B（运行时更新 ai_tasks 进度状态）

18 KiB Raw Permalink Blame History Unescape Escape

修改日志 CHANGELOG

[2026-05-11 01:15] 项目瘦身：清理分发包多余文件

背景

删除内容

保留内容（最小运行集）

[2026-05-11 01:05] Bug 修复：可搜索下拉浮层背景透明

问题描述

根因

修改文件明细

1. chatlab-web/frontend/src/index.css

2. chatlab-web/frontend/src/pages/TopicsPage.jsx

总结

[2026-05-10 15:42] Bug 修复：新账号首次解密引导 + 账号切换前端数据刷新

问题描述

修改文件明细

1. electron-launcher/main.js

2. electron-launcher/preload.js

3. electron-launcher/index.html

4. chatlab-web/frontend/src/App.jsx

5. chatlog_fastAPI/database.py

6. chatlog_fastAPI/main.py

总结

[2026-05-11 00:32] Bug 修复：AI话题分析 & 知识库 4 个 UI 问题

问题描述

修改文件明细

1. chatlab-web/frontend/src/pages/TopicsPage.jsx

2. chatlog_fastAPI/routers/knowledge.py

3. chatlab-web/frontend/src/pages/KnowledgePage.jsx

4. chatlog_fastAPI/routers/topics.py

5. chatlog_fastAPI/services/summary_engine.py

总结

18 KiB

Raw Permalink Blame History

1. `chatlab-web/frontend/src/index.css`

2. `chatlab-web/frontend/src/pages/TopicsPage.jsx`

1. `electron-launcher/main.js`

2. `electron-launcher/preload.js`

3. `electron-launcher/index.html`

4. `chatlab-web/frontend/src/App.jsx`

5. `chatlog_fastAPI/database.py`

6. `chatlog_fastAPI/main.py`

1. `chatlab-web/frontend/src/pages/TopicsPage.jsx`

2. `chatlog_fastAPI/routers/knowledge.py`

3. `chatlab-web/frontend/src/pages/KnowledgePage.jsx`

4. `chatlog_fastAPI/routers/topics.py`

5. `chatlog_fastAPI/services/summary_engine.py`