Complete admin operations management

ai_knowledge_base_v2/development_records/2026-07-06-decision-register.md

@@ -42,6 +42,8 @@
 | D-019 | 管理后台 Element Plus 改为按需注册，并拆分表格和基础 vendor chunk。 | 默认采用 | 解决后台构建单 chunk 过大的提示，降低首屏主入口体积，同时不引入额外构建插件。 |
 | D-020 | MiniMax 快速添加默认使用 Anthropic Messages 兼容协议。 | 默认采用 | MiniMax 文本生成指南推荐 Anthropic-compatible 路径；后端按 `auth_type` 兼容 Bearer 和 x-api-key 两种鉴权。 |
 | D-021 | 模型管理只负责 LLM 接入，Agent 管理负责提示词、知识库、模型选择和推理参数调试。 | 默认采用 | 避免模型连接配置与 Agent 运行策略混在一起，方便后续做 Agent 版本、调试和发布流程。 |
+| D-022 | 用户-知识库授权先放在用户管理中维护。 | 默认采用 | 一期运营动作更直接：找到用户后分配知识库；后续用户规模变大时再增加角色、用户组或批量授权。 |
+| D-023 | Agent 调试预览采用接近用户端聊天页的交互形态。 | 默认采用 | 测试问题从配置区移到预览窗口底部，减少调试和真实用户问答体验之间的差异。 |
 
 ## 待确认决策
 

ai_knowledge_base_v2/development_records/2026-07-07-admin-operations-completion.md

@@ -0,0 +1,75 @@
+# 管理后台运营能力补齐记录
+
+日期：2026-07-07
+
+## 背景
+
+用户反馈当前后台仍有三块没有做到产品可用状态：
+
+1. 知识库管理只做到新增和列表，缺少编辑、删除、启停、备注维护。
+2. 用户管理只做到查询、启停和额度调整，缺少删除用户和知识库权限分配。
+3. Agent 调试预览不符合用户端聊天体验，测试问题在左侧配置区，预览窗口在右侧，使用时割裂。
+
+本次调整目标是把后台从“可演示”推进到“一期运营人员可使用”的状态。
+
+## 本次完成内容
+
+### 知识库管理
+
+- 新增知识库编辑能力。
+- 新增知识库删除能力。
+- 支持在列表中直接启用或禁用知识库。
+- 表单补充备注字段。
+- 删除知识库时同步清理用户-知识库授权关系，避免外键约束导致删除失败。
+
+### 用户管理
+
+- 用户列表补充 ID、昵称、最近登录时间。
+- 支持删除用户。
+- 支持打开“知识库权限分配”抽屉。
+- 可为用户按知识库开启或关闭权限。
+- 可为每个授权设置生效时间和失效时间。
+- 后端新增用户知识库权限读取和保存接口。
+
+### Agent 管理预览
+
+- 移除左侧配置区中的“调试问题”输入。
+- 右侧预览窗口改为接近用户端聊天的交互：
+  - 上方展示对话消息。
+  - 下方固定输入框。
+  - 右侧发送按钮。
+- 发送后输入框自动清空，消息进入预览对话流。
+
+## 后端接口变化
+
+新增接口：
+
+- `GET /api/admin/user/{user_id}/knowledge-permissions`
+  - 读取指定用户已分配的知识库权限。
+- `PUT /api/admin/user/{user_id}/knowledge-permissions`
+  - 覆盖保存指定用户的知识库权限列表。
+
+复用接口：
+
+- `GET /api/admin/knowledge/list`
+- `POST /api/admin/knowledge`
+- `PUT /api/admin/knowledge/{knowledge_id}`
+- `DELETE /api/admin/knowledge/{knowledge_id}`
+- `GET /api/admin/user/list`
+- `PUT /api/admin/user/{user_id}`
+- `DELETE /api/admin/user/{user_id}`
+- `POST /api/admin/agent/debug`
+
+## 当前边界
+
+- 用户知识库权限已经可以维护，但用户端问答链路后续还需要根据登录态和用户权限过滤可用知识库。
+- 当前用户删除仍是软删除，聊天记录和审计记录不会被物理删除。
+- Agent 管理目前仍是调试态，尚未做正式的 Agent 版本发布、回滚和灰度。
+- 权限分配按用户维护；后续如果用户规模变大，应增加角色、用户组或批量授权能力。
+
+## 后续建议
+
+1. 在用户端接入真实登录后，把当前用户 ID 传入后端问答链路，按 `sys_user_kb` 过滤知识库检索范围。
+2. Agent 管理增加“保存草稿 / 发布版本 / 回滚版本”，把提示词、模型、知识库和参数落成版本。
+3. 用户管理增加批量启停、批量授权和导入导出。
+4. 知识库管理增加同步状态、最后同步时间、文档数量和检索测试入口。

ai_knowledge_base_v2/development_records/README.md

@@ -36,4 +36,5 @@
 | `2026-07-07-model-management-completion.md` | 管理后台模型管理补全记录。 |
 | `2026-07-07-admin-web-build-optimization.md` | 管理后台构建体积优化记录。 |
 | `2026-07-07-agent-management-adjustment.md` | Agent 管理与模型接入边界调整记录。 |
+| `2026-07-07-admin-operations-completion.md` | 管理后台知识库、用户权限和 Agent 预览补齐记录。 |
 | `../test_records/2026-07-06-phase6-verification.md` | 阶段六验证记录。 |