docs(sysadmin): annotate unwired system_settings keys as phase-2 backlog (X-4)

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
weichen
2026-09-18 04:02:18 +00:00
co-authored by Cursor
parent 527e6daa99
commit da62c49952
+11
View File
@@ -66,6 +66,17 @@ type SettingUpdate struct {
}
// defaultSettingSpecs 一期白名单:先做机制,键空间可后续扩展。
//
// Wave 5 X-4: 除 SettingKeyAllowAuthorOnlyApproval 已接线外,下列 6 键暂无运行时
// 消费方;决策 = 保留白名单待系统管理台二期接线(FEATURE-MATRIX「白名单项接消费方」),
// 不从白名单删除。见 .doc/ops/short-term/2026-09-18-wave5-deadcode-decisions.md#x-4。
// 预期消费方(二期):
// - ui.maintenance_notice → 站点顶部维护公告横幅
// - ui.read_only_mode → 写操作中间件 / 前端写入口阻断
// - chat.default_session_role → 会话创建默认职责
// - tasks.default_auto_repair → 独立任务运行默认 auto_repair
// - kb.default_search_limit → 知识库检索默认 limit
// - notifications.stage_advance_reminder → 阶段就绪提醒 ticker 总开关
func defaultSettingSpecs() []SettingSpec {
return []SettingSpec{
{Key: "ui.maintenance_notice", Label: "维护公告", Group: "ui", Type: SettingTypeString, Default: "", Writable: true, RequiresRestart: false, Description: "全站维护公告横幅文案;空字符串表示关闭"},