G4W 3.0.0

G4W 3.0.0

G4W 3.0.0 版本：对比 2.0.0（2026-08-11 便携包），控制中心 Dashboard 全面升级、新增长期用户画像、Embedding 安装配置化、桌面壳 G4W.exe 与首次使用向导落地。本版本与 2.0 目录结构差异较大，升级请按下方「升级说明」操作，不要直接覆盖解压。

更新一 · 控制中心 Dashboard 全面升级

• 服务管理：看板新增服务注册表——6 个内置服务（G4W 主服务 / 模型输出监视器 / Embedding / 时间轴 / 看板自身）一键启停；服务日志实时终端页（行高亮、自动跟随、清屏）；agent 可动态注册/移除自定义服务
• 总览页一键启动：▶ 一键启动 G4W（无终端窗口），运行中可直接跳转服务日志
• Worker 监控：Worker 页新增模型输出监视器（实时输出流 + 运行进度摘要）；每条 Worker 记录新增「输出」按钮，已归档 Worker 自动回退读取历史输出
• 待办页：新增待办/已办视图（与微信 /todo 同源，分页浏览）
• 系统简报：右侧新增下一次 checkin 时间显示
• 知识库：支持 .docx 文档（纯标准库解析，Heading 转层级，零依赖）
• 主题系统：内置主题编辑器（自定义配色/圆角/深浅色）+ argon、简洁蓝等 5 套预设；时间轴事件弹窗按分类着色
• 性能：Worker 列表 2.6s → 33ms、服务列表 1.26s → 310ms

更新二 · 长期记忆：总体用户画像

• 新增用户画像：由 conductor 以 neko 语气持续维护的人物叙述文（基本画像 / 性格与习惯 / 生活方式 / 与我的关系 / 期望与规则 / 人生阶段与变化，6 小节）
• 画像演进标记：内容变化自动保留旧值 + 时间（"以前喜欢苹果；08-14 起改吃香蕉"）
• 看板记忆页画像置顶展示；worker 三阶段产出素材草稿 → conductor 审核复述，无变化不写
• L4 记忆挖掘链路加固：finalize 三任务链（总结 → insight → transcript 窗口索引），embedding 失败自动拉起重试

更新三 · 向量检索与 Embedding

• /vector status 实时探测（端口/进程/推理探针），能识别 embedding 服务"假死"
• 检索失败自动拉起 embedding 服务（10 分钟冷却）+ 重试一次，错误原因对 agent 可见
• hybrid 增量区间：检索自动覆盖"向量索引截止 → 最新对话"，当天对话立即可命中
• Embedding 安装配置化：看板环境配置页直接安装（国内/国外源切换）——多镜像池并发测速自动选优、安装进度在服务页可见
• 设备策略：安装期检测显卡自动装 GPU/CPU 版 torch；GPU 机器强制 CUDA、禁止降级 CPU
• 账号归一化 + 向量索引迁移修复（旧账号死条目清零，归属判定改为 userid）

更新四 · G4W.exe 桌面壳 + 首次使用向导（新用户零门槛）

• 新增 G4W.exe（17.3MB，双击即用）：自动拉起/复用看板、X 最小化到托盘、托盘右键显示/退出、登录态持久化
• 新增首次使用向导：未初始化时自动弹出 4 步引导——① 环境准备（离线安装、实时进度）→ ② 填写 API Key → ③ 用户名/称呼/机器人名等配置 → ④ 向导内扫码登录 → 完成直接进看板
• 老用户流程不变，tools\*.bat 照常可用

更新五 · 稳定性与体验修复

• 页面冻结修复：看板改 HTTP/1.1 keep-alive，消除轮询连接风暴；请求 10s 超时 + 失败自动重试
• 双实例防护：重复启动看板直接报错，不再静默双跑
• 多标签提示：同时开多个看板标签页会警告（浏览器连接配额）；时间轴/日记加载失败自动重试
• 后台标签页自动暂停轮询（省资源）
• 一键启动不再弹黑窗口（base Python 直启 + CREATE_NO_WINDOW）
• Worker 中间回复默认关闭（只在完成/失败时汇报，更安静）
• 停止 G4W 时自动清理 Embedding 僵尸进程；向量安装缓存/临时文件改在便携包内，不占 C 盘

更新六 · 打包与目录整理

• 脚本统一移入 tools\（1-5 号安装脚本/启停脚本），路径全部相对定位，便携包更整洁
• 新增备份归仓工具（backup_manager），发布备份统一管理
• README / G4W使用说明.md 更新（目录结构、备份、向导说明）

升级说明（2.0 → 3.0，请仔细阅读）

⚠️ 不要直接在旧便携包上覆盖解压。 与 2.0 相比目录结构变化较大（根目录脚本移入 tools\、新增 desktop\ 与 G4W.exe），覆盖解压会导致新旧文件混存、脚本路径混乱，也无法清理 2.0 残留文件。请按下面步骤操作：

老用户升级（保留数据）：

1. 备份：把整个旧便携包复制一份到安全位置；如果空间有限，至少备份 runtime\G4W-data 文件夹——里面是全部记忆、账号登录、配置与待办，必须完整保留
2. 解压新包到全新目录（不要解压进旧目录）
3. 迁移数据：把旧包的 runtime\G4W-data 整个复制到新包对应位置（新包\runtime\G4W-data）。迁移后微信账号、会话、长期记忆、待办、配置全部保留，无需重新配置
4. 可选：迁移向量环境：如果旧包已安装过语义检索，把旧包的 runtime\G4W-embedding 和 runtime\G4W-vector-index 一并复制过去——可省去重新下载数 GB 的 torch 与模型。新包「环境配置 → Embedding」会自动识别已装状态
5. 首次启动：双击 G4W.exe（推荐入口）→ 首次打开看板按提示设置一次登录密码 → 老账号直接沿用/扫码登录
6. 核对：看板「服务」页确认主服务与 Embedding 状态正常；微信里发 /vector status 验证索引可检索；「记忆」页确认历史对话与用户画像都在

新用户全新安装：

1. 解压便携包到任意目录（路径避免中文与空格）
2. 双击 G4W.exe → 自动弹出首次使用向导：① 环境准备（离线安装，实时进度）→ ② 填写 API Key → ③ 用户名/称呼/机器人名等配置 → ④ 向导内扫码登录 → 完成进入看板
3. 可选：看板「环境配置」页安装 Embedding 语义检索（国内/国外源，自动测速选优，进度实时可见）
4. 日常使用：双击 G4W.exe 启动；也可用 tools\start_G4W_ga.bat / tools\stop_G4W_ga.bat 启停

注意事项：

• 2.0 根目录的 bat 脚本已迁入新包 tools\，不要把旧包根目录的脚本复制进新包；新包以 G4W.exe 为推荐入口
• 已迁移 G4W-embedding / G4W-vector-index 的机器无需重新下载；未迁移的到看板配置页一键安装即可
• Dashboard 登录密码只需首次设置一次；升级不丢失微信账号与聊天记录（都在 G4W-data 内）

版本信息

• GenericAgent Desktop Portable 1.8 底座，内置 Python 3.12.13
• 默认模型 DeepSeek：conductor / worker 使用 deepseek-v4-flash，pro 使用 deepseek-v4-pro
• 语义检索：Qwen3-Embedding-0.6B 本地向量召回 + DeepSeek 生成回答（GPU/CPU 自适应）
• 基础依赖 wheels 离线打包，SHA256 校验