本期一句话: 管理后台与客户端能力持续补齐, 知识库从接口到分页体验打通, 同步沉淀一套环境部署与发布更新的文档化流程.

时间锚点md/issue_04/index.md 最后入库: d93802b · 2026-04-14 17:18:59 +0800 · 本期范围 git log d93802b..HEAD

这次更新做了什么

客户端 · 知识库能力闭环

文件列表从假数据切到真实接口, 分页与翻页状态修复, 新建知识库增加创建中提示, 让知识库管理从可用变成好用.

后端 · 百炼知识库分页与 total 修复

修复分页接口 total 误判导致的客户端分页置灰, 支持稳定翻到第 N 页. 同步补齐审计脱敏与 OpenAPI 中文化, 方便排查和交付.

前端后台 · 稳定性修复

修复管理后台下拉菜单 Label 组件的 Group 上下文缺失问题, 避免运行时直接报错导致页面不可用.

1. 前端后台管理系统搭建

核心点: 先让后台稳定跑起来, 再谈功能扩展. 本期把一个会导致页面崩溃的下拉菜单分组问题修掉了.

前端后台管理系统搭建

2. 宝塔搭建与环境部署流程

核心点: 环境搭建要可复用, 发布流程要可复现. 所以除了搭建过程, 我们也把 Electron 的打包与版本更新流程迁移到 skills 文档, 清理仓库临时脚本.

宝塔搭建与环境部署

3. 客户端知识库搭建与体验闭环

为什么要写这一段

用户侧看到的是分页按钮能不能点, 能不能翻到第二页. 这背后同时依赖后端 total 计算和客户端页码状态管理, 任意一端不对都会让体验崩掉.

客户端知识库搭建

本期围绕知识库做了几件关键事:

• • 客户端文件列表切服务端分页, 修复页码被 metadata 更新重置的问题

• • 后端分页接口返回正确 total, 避免总数被误判为 page_size

• • 新建知识库增加创建中加载提示, 避免用户误以为卡死

• • 登录默认配置与错误提示优化, 方便本地与交付测试

本期 Git 更新(按域归纳)

本期覆盖范围: git log d93802b..HEAD --oneline --no-merges。

|
域
|
重点内容
|
代表提交(节选)
|
| — | — | — |
|
客户端(client_electron)
|
知识库 CRUD, 文件分页与翻页状态, 创建中提示, 登录体验优化
| fb13bb8
5c4f88d``471be5b``00e53b0``e2edece``7dfd554
|
|
后端(backend)
|
百炼知识库接口全链路, 分页 total 修复, 审计脱敏, OpenAPI 中文化
| 882a420
f2b8654``6f558d4``00e53b0``03275fd``84bb83b
|
|
前端后台(frontend_next)
|
登录与路由稳定性, 管理后台运行时错误修复
| b00da92
8bc849e``f37cd01
|
|
文档与规范(md, skills)
|
README Changelog 规范化, 清理临时脚本, issue 文档入库
| 472e13c
6ce6fa8``fb27e43``f37cd01
|

关键提交清单(更细一层)

|
主题
|
代表提交(节选)
|
| — | — |
|
知识库对话联动
| 71a5b1c
0890d60``b52ca06``12fe1fa
|
|
知识库上传与审计
| 2e9db4f
03275fd``b09edd1
|
|
知识库列表解析兼容
| cadde6e
f29c10f``fe04a9d``9d57ce5
|
|
客户端 UI 与基础能力
| 3b4db01
cee21ad``0d28924
|
|
规范与流程(更新日志, 提交链)
| 472e13c
70da3d6``acf0518
|

完整提交列表(节选, 便于对照 git log)

f37cd01 chore: 更新日志并修复后台下拉菜单报错 

fb27e43 chore: 清理无用文档脚本并修复设置页报错

 03b86d2 chore(client): 隐藏默认敏感信息并清理测试脚本

 acf0518 chore: 忽略本地客户端产物与说明文档 

c597ee0 feat(client): 更新默认地址与登录默认凭据

 7dfd554 feat(client): 关闭AI周报入口并补充创建知识库加载提示 8

1b6b64 feat(client): 屏蔽 AI 周报并统一开发中占位 

e2edece fix(client): keep kb page state when list metadata updates 00e53b0 fix(kb): correct total for paged file list and enable server paging 6fe1443 feat: 知识库文件分页与全局刷新

0d28924 feat: 中文化 OpenAPI 文档并修复客户端图标打包 

12fe1fa feat(agent): add kb sources and dashscope env compat b52ca06 fix: 修复知识库查询结果拼接角色导致大模型 400 错误 

0890d60 fix: 客户端知识库页面展示当前选中知识库的 ID 

71a5b1c feat: AI 对话支持选择并结合知识库进行回答 cfb896c fix: 客户端隐藏由于测试脚本生成的测试分类

 a9bcc0c fix: 客户端移除不支持的文件移动和重命名按钮并修复旋转动画

 e0bac2c fix: 客户端暂时屏蔽不支持的文件移动与重命名功能 

2e9db4f feat: 客户端知识库上传文件时显示加载进度状态

 03275fd fix: 知识库上传文本接口审计日志脱敏与冗余文件清理

 b09edd1 fix: 知识库上传文本接口审计日志脱敏与冗余文件清理

 6ce6fa8 docs: 更新知识库 API 及客户端测试指南与 

Changelog 471be5b feat: 客户端接入知识库增删改查, 所有知识库归入默认分类

 f29c10f fix: 客户端知识库解析兼容百炼首字母大写字段 

fe04a9d fix: 修复知识库列表在客户端由于 FastAPI 包装层导致的解析为空问题

 9d57ce5 test: 知识库列表脚本增强解析 410e99d fix: 知识库列表解析与上传参数修复并增强自测输出

 e1a9765 fix: 知识库服务类定义修复 

2e2bb7e fix: 客户端知识库页面改为真实数据并修正目录命名 f2b8654 feat: 知识库增删改查接口与全流程自测脚本

 cadde6e fix: 知识库分类获取失败时降级默认分类

 9adfa94 fix: 知识库列表接口异常返回更清晰 882a420 feat: 知识库接入百炼列表接口并同步到客户端

 5c4f88d refactor: 客户端接口集中管理并支持新建知识库

 84bb83b docs: OpenAPI 全量中文化增强 fad065c docs: OpenAPI 健康检查等摘要中文化与标签去重

 0738e97 docs: 补齐管理后台接口中文摘要 

9bec001 docs: OpenAPI 路由中文化与知识库接口补齐 070e479 feat: 客户端支持配置服务地址与接口文档中文化 

22f1f82 fix: 客户端 dev 模式禁用缓存 f483cd0 fix: 客户端白屏定位日志与前端文件头 

8bc849e fix: 管理后台未登录不再白屏 

8a4b6bb chore: 前端零告警与日志时间修正 dc408f3 fix: 修复后端数据库连接与前端登录可用性

 6f558d4 feat: 新增百炼知识库 demo 创建接口 f52274e feat: 增加企业微信组织同步与登录回调 

fb13bb8 feat(client_electron): 新增知识库管理页面及多页面UI重构 

1422b57 fix: 修复根据角色自动跳转路由以及局域网开发时的 403 跨域问题 

70da3d6 fix: 修复后端启动与导入问题及前端 Lint 警告, 并按规范更新 README da3700d fix(client_electron): 补充遗漏的主进程 IPC 监听器 

ai:generate_report, 解决点击生成报错问题 

472e13c chore(skills): 在 git_submit 和 frontend_next 技能中加入前端格式化与异常检查机制  

下一步计划

• • 管理后台补齐更多核心页面, 同步完善权限与审计链路

• • 客户端知识库补齐更多文件类型与状态同步能力, 提升可观测性

• • 上线TRAI 域名