# yuanzhipeng 提交内容梳理 本文基于仓库 `qiweimanager-master-git` 中的 Git 历史整理，统计范围为： ```powershell git log --all --author=yuanzhipeng ``` 作者信息：`yuanzhipeng <2501363769@qq.com>` ## 1. 分支与提交概览 当前仓库里 `yuanzhipeng` 共有 4 个提交： | 提交 | 日期 | 所在分支 | 标题 | | --- | --- | --- | --- | | `a926ee6` | 2026-06-25 | `main`, `origin/main`, `origin/HEAD` | `chore(build): 更新.gitignore配置和清理Wails临时文件` | | `1517be2` | 2026-06-26 | `origin/develop` 历史 | `feat(auto-reply): 接入万川平台模型配置 + 各模型独立网关回退` | | `849090a` | 2026-06-26 | `origin/develop` 历史 | `feat(auto-reply): 优化自动回复逻辑和知识库功能` | | `1ca66dc` | 2026-06-26 | `origin/develop` | `docs(batch): 更新批处理脚本注释` | 需要注意：当前 `main/origin/main` 只包含 `a926ee6`；后续 3 个功能提交目前在 `origin/develop` 上。 按 `a926ee6^..1ca66dc` 汇总，整体变更约为： - 51 个文件变化 - 2922 行新增 - 1299 行删除 - 删除旧备份文件 `helper/auto_reply_ai.go.bak` - 删除 Wails 构建生成文件 `build/windows/installer/wails_tools.nsh` ## 2. 主要完善内容 ### 2.1 万川平台模型配置接入 相关提交：`1517be2` 新增了万川平台配置能力，让自动回复模块可以从万川平台拉取模型配置并自动回填到本地 AI 配置。 主要内容： - 新增后端接口文件 `wanchuan_proxy.go`： - `WanchuanLogin`：登录万川平台并获取 token。 - `WanchuanGetModel`：按模型 code 获取模型配置。 - `GetPlatformConfig` / `SavePlatformConfig`：读取和保存平台账号配置。 - 日志中对密码、token、apiKey 做脱敏处理。 - 配置结构新增 `PlatformConfig`，用于保存万川平台地址、账号、密码。 - 前端 `AutoReply.vue` 新增“万川平台”配置卡片： - 填写平台地址、账号、密码。 - 一键“登录并获取模型”。 - 自动拉取 chat、vision、embedding、rerank、voice 等用途模型。 - 将模型名、网关地址、API Key 回填到自动回复配置。 - 前端 Wails 绑定新增： - `GetPlatformConfig` - `SavePlatformConfig` - `WanchuanLogin` - `WanchuanGetModel` ### 2.2 各类模型支持独立网关和独立 Key 相关提交：`1517be2` 完善了自动回复中不同模型的配置拆分，避免所有能力都被迫共用同一个文本模型网关。 主要内容： - `RetrievalConfig` 新增： - `embeddingBaseUrl` - `embeddingApiKey` - `rerankBaseUrl` - `rerankApiKey` - Embedding 和 Rerank 调用优先使用各自独立配置，未配置时才回退到主 AI 网关。 - 非 DashScope 网关下，视觉模型不再强行写死为 DashScope 的默认视觉模型。 - 万川统一网关场景下，视觉模型可动态复用聊天模型；如果平台提供独立 vision 配置，则使用独立 vision 网关。 - 当 embedding 模型或维度变化时，会识别旧向量索引已经属于不同向量空间，并提示或触发重建，避免旧索引造成检索异常。 ### 2.3 自动回复上下文逻辑优化 相关提交：`849090a` 优化了客户追问、换话题和上下文拼接逻辑，减少模型被历史对话带偏的问题。 主要内容： - 新增 `contextPromptForQuestion`： - 只有“它多少钱”“刚才那个再说说”“继续”等指代型追问才注入历史上下文。 - “今天星期几”“你们有什么产品”等自包含问题不再携带上一轮话题。 - 新增换话题识别： - 如“换个话题吧”“聊点别的”“不聊这个了”会直接回复引导语。 - 如果“换个话题，你们产品多少钱”这类句子带了新问题，则继续正常处理新问题。 - Prompt 中强调上下文只用于理解称呼和承接，不应主动延续旧话题。 - 默认回复详细度从 `detailed` 调整为 `medium`，避免自动回复过长、太像模板。 ### 2.4 知识库索引与向量检索增强 相关提交：`849090a`, `1517be2` 修复和增强了知识库扫描、向量索引、重排调用等流程。 主要内容： - 知识库重建从只扫描根目录改为递归扫描子目录。 - 适配 `01_产品/数控机床/xxx.md`、`03_售后/故障排查/xxx.md` 这类分类目录。 - 重建知识库后，前端会显示扫描文件数、分片数、失败文件数。 - 如果 0 个文件被扫描到，会给出明显提示。 - 向量索引加载时检测模型名和维度是否与当前配置一致。 - 不一致时清空陈旧向量，回退关键词检索，并提示重建索引。 - Embedding/Rerank 请求支持独立 Base URL 和 API Key。 ### 2.5 素材库扫描、匹配和开场白生成 相关提交：`a926ee6`, `849090a` 完善了素材库能力，尤其是目录化素材、误匹配控制和 AI 自动生成素材发送话术。 主要内容： - 新增大量示例素材到 `config/materials`，包括： - 产品图片 - 宣传海报 - 工作流图 - 教程截图 - 案例展示 - 联系方式卡片 - 素材扫描从根目录扫描改为递归扫描子目录。 - 素材路径保存为相对路径，并统一使用 `/` 分隔。 - 子目录名也会加入关键词，方便按分类命中素材。 - 新增 `CaptionSource` 字段，区分素材话术来源： - `manual`：人工维护，重新同步时不覆盖。 - `ai`：AI 生成，已有时不重复生成。 - 空值：历史数据或默认话术，可按需生成。 - 新增 `helper/auto_reply_material_caption.go`： - 图片使用视觉模型生成一句自然开场白。 - 视频按标题生成。 - 文档尝试抽取开头内容后概括。 - 生成结果会去引号、压缩换行、过滤 `NO_ANSWER`、限制长度。 - 素材匹配新增“强信号”门槛。 - 只有整词关键词、问句模板、完整标题或文件名命中才会发送素材。 - 仅靠 2-gram 模糊片段命中不会触发发送，减少误发资料。 ### 2.6 媒体消息诊断和类型识别修复 相关提交：`849090a` 增强了企业微信媒体消息回调的识别和诊断能力。 主要内容： - 修正 `rawTypeFromEvent` 对企业微信事件类型的判断。 - 优先使用 DLL 真实 `event` 字段。 - `content_type` 只作为模拟事件或旧版本 DLL 的 fallback。 - 避免文本消息被误判成图片，导致错误触发图片识别。 - 新增媒体字段为空时的诊断日志。 - 仅在图片、视频、链接等媒体消息且 URL、本地路径、FileID 全空时记录。 - 日志只记录媒体相关字段，避免泄露聊天内容。 ### 2.7 构建、开发和打包流程完善 相关提交：`a926ee6`, `1ca66dc` 对 Windows/Wails 的开发和打包流程做了明显增强。 主要内容： - `.gitignore` 增加构建输出、绿色免安装包、Wails 临时文件、WebView2 安装包等忽略规则。 - 删除 `build/windows/installer/wails_tools.nsh` 这类 Wails 自动生成文件，避免把临时产物提交进仓库。 - 新增 `scripts/dev.ps1`： - 自动定位 Go/Wails。 - 自动安装前端依赖和 Go 模块。 - 编译 32 位 GUI 子系统的 `helper.exe`。 - 同步 DLL、`eventdata`、`requestdata` 到运行目录。 - 启动 `wails dev`。 - 新增 `scripts/build.ps1`： - 构建 helper、silkdecode、主程序。 - 输出带时间戳的绿色免安装版目录。 - 写入默认配置文件和空素材索引。 - 改进 `scripts/package-windows.ps1`： - 自动探测 NSIS 标准安装路径。 - gcc 缺失时跳过 silkdecode，而不是直接失败。 - 前端构建和 Wails NSIS 构建改为按退出码判断。 - 安装包文件名增加时间戳。 - 新增 `install-nsis.ps1`。 - 新增根目录批处理： - `启动开发.bat` - `打包.bat` - `1ca66dc` 对这两个 `.bat` 的注释做了英文化和简化。 ### 2.8 主程序退出稳定性修复 相关提交：`a926ee6` 修复 Windows 下关闭主程序时可能因 helper 进程处理方式触发崩溃的问题。 主要内容： - `main.go` 中 Windows 平台优先使用 Windows API 终止 helper。 - 终止后直接返回，不再继续走通用 `Signal/Kill` 分支。 - 避免 Go 1.25+ 中手工构造的 `os.Process` 因句柄模式无效触发 panic。 ### 2.9 测试覆盖增加 相关提交：`1517be2`, `849090a` 补充了多个回归测试，主要覆盖自动回复和配置默认值。 新增或扩展的测试点包括： - 非 DashScope 网关下视觉模型跟随聊天模型。 - DashScope 仍保留默认视觉模型兜底。 - 知识库递归扫描子目录。 - 素材模糊弱命中不应误发。 - 素材开场白生成、清洗、保留人工话术。 - 自动回复上下文只在指代追问时使用。 - 换话题句子的识别。 - embedding 索引模型/维度不一致时判定为陈旧。 - 默认回复详细度变更为 `medium`。 ## 3. 每个提交的简要说明 ### `a926ee6`：构建体系、素材与基础修复 这个提交表面标题是 `.gitignore` 和 Wails 临时文件清理，但实际内容较多： - 清理 Wails 自动生成文件。 - 新增万川平台对接文档。 - 新增大量素材图片。 - 新增开发/打包 PowerShell 脚本和 `.bat` 入口。 - 优化 Windows 打包脚本。 - 修复主程序退出时 helper 进程处理可能导致崩溃的问题。 ### `1517be2`：万川平台模型配置接入 这是核心功能提交之一： - 增加平台账号配置保存。 - 增加登录万川平台和拉取模型配置的后端接口。 - 前端新增万川平台配置区。 - 自动回填 chat、vision、embedding、rerank、voice 模型。 - Embedding 和 Rerank 支持独立网关。 - 删除旧的 `helper/auto_reply_ai.go.bak` 备份文件。 ### `849090a`：自动回复、知识库和素材库优化 这是自动回复体验提升最集中的提交： - 上下文只在指代追问时注入。 - 换话题句子直接回复引导语。 - 知识库递归扫描子目录。 - 素材库递归扫描子目录。 - 素材匹配增加强信号门槛，减少误发。 - 新增 AI 生成素材开场白。 - 调整回复详细度默认值和 prompt 策略。 - 增加媒体消息字段诊断日志。 ### `1ca66dc`：批处理脚本注释更新 这个提交只改了两个 `.bat` 文件的注释： - `启动开发.bat` - `打包.bat` 功能逻辑没有明显变化，主要是说明文字调整。 ## 4. 总结 整体来看，`yuanzhipeng` 的提交主要完善了 4 条主线： 1. **万川平台接入**：从平台登录、拉模型、保存配置到前端一键回填，形成了完整闭环。 2. **自动回复质量提升**：处理追问、换话题、回复长度、知识库完整性和媒体消息诊断，减少答非所问和误判。 3. **知识库/素材库能力增强**：支持目录化管理、递归扫描、向量索引一致性检查、素材自动开场白和误发控制。 4. **开发与交付流程完善**：新增一键开发/打包脚本，优化 NSIS、Wails、helper、DLL、运行资源同步，降低 Windows 环境下的构建和运行成本。 如果按“是否已进主分支”看，目前只有 `a926ee6` 在 `main`；万川接入和自动回复深度优化主要还在 `origin/develop`。