Document explicit system settings page

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

@@ -51,6 +51,7 @@
 | D-026 | 学员批量导入正式入口改为 Excel 模板上传。 | 用户确认 | 后台提供模板下载和 Excel 上传导入；导入结果展示新增、更新、失败及失败原因。 |
 | D-027 | Agent 调试预览采用接近 DeepSeek 等聊天产品的显示方式。 | 用户确认 | 预览窗口以真实聊天体验为目标，支持连续对话、底部输入和生成中状态。 |
 | D-028 | 系统配置页面从占位 Key/Value 调整为中文分组配置表单。 | 用户确认 | 配置保存到 `sys_system_config`，默认每日额度接入学员新增和导入逻辑；其他配置作为后续运行时读取的统一入口。 |
+| D-029 | 系统配置页不保留高级配置入口。 | 用户确认 | 所有允许后台配置的项目必须显式列在配置页中，不允许管理员通过自由 Key/Value 临时增加配置项。 |
 
 ## 待确认决策
 

ai_knowledge_base_v2/development_records/2026-07-06-phase1-scope.md

@@ -46,7 +46,7 @@
 | Prompt / Agent 管理 | 必须 | 查看、编辑、保存、恢复默认；选择模型和知识库；在聊天式预览窗口中调试 Agent。 |
 | AI 模型管理 | 必须 | 新增、编辑、启用、删除模型；同一时间仅一个模型启用。 |
 | 聊天记录 | 必须 | 查询、详情、导出。 |
-| 系统配置 | 必须 | 以中文分组表单维护登录有效期、每日聊天次数、AI 超时、飞书重试次数、上下文长度、是否展示引用来源；保留原始 Key/Value 排查表。 |
+| 系统配置 | 必须 | 以中文分组表单维护全部允许后台配置的项目；不提供高级配置或自由 Key/Value 入口。 |
 | 操作日志 | 必须 | 关键后台操作必须写日志；日志不允许删除。 |
 
 ### AI/RAG 能力

ai_knowledge_base_v2/development_records/2026-07-07-admin-experience-settings-import-change.md

@@ -56,7 +56,9 @@ Agent 管理中的右侧预览窗口需要调整为接近 DeepSeek、ChatGPT 等
 - AI 问答：AI 请求超时时间、上下文消息数、是否展示引用来源。
 - 外部服务：飞书检索重试次数、是否使用 mock 检索、是否使用 mock 模型。
 
-配置项保存到 `sys_system_config`，后台展示为中文配置项；高级表格保留原始 Key/Value 便于排查。
+配置项保存到 `sys_system_config`，后台展示为中文配置项；页面不再提供“高级配置”或自由 Key/Value 输入。
+
+后续允许管理员配置的项目必须显式登记在系统配置页中，不能只通过输入任意 Key 的方式临时增加。这样可以避免配置项含义不清、交接困难、误填 Key 后功能不生效等问题。
 
 本次实现中，默认每日聊天额度需要接入手动添加和批量导入学员逻辑；其他配置先完成持久化和后台可维护，为后续运行时接入保留明确 Key。
 
@@ -66,5 +68,5 @@ Agent 管理中的右侧预览窗口需要调整为接近 DeepSeek、ChatGPT 等
 2. 学员管理可以下载 Excel 模板。
 3. 按模板上传 Excel 后可以导入学员，并显示导入结果。
 4. Excel 中不合法数据不会整体中断导入，失败行有明确原因。
-5. 系统设置页面不再是裸输入框，管理员可以按分组维护配置。
+5. 系统设置页面不再是裸输入框，也不展示高级配置入口；管理员可以按分组维护全部允许配置的项目。
 6. 修改默认每日聊天额度后，新手动添加或导入且未单独填写额度的学员使用新的默认额度。