feat(gateway): 配置只读事实面 + 后台思考行「档位/穿透」（契约 v0.68）
- 新增 GET /api/v1/admin/config-facts：记忆整理 7 键 + 安静时段 2 键的**进程生效值** + 声明默认值（反射读 default 标签，不读 .env） - 面板：记忆整理卡 + 安静时段卡（Miuix 只读），文案按新语义「只服务主动搭话，不静默回复」 - 后台思考行加 urgency（**只能是下限**，存档不可分 high/critical）+ quietHoursBypassed（与既有 bypassed 是两件事） - 红线实测：往响应里塞 JWT ⇒ TestAdminConfigFacts_NeverLeaksSecretValues 打红（连断言消息都把整个响应打出来了） - 前端：configFacts 24 checks / ConfigFactsCards 29 / BackthinkUrgencyTags 19 全过 - 契约 v0.68（纯增量：B12 新端点 + B8 两字段 + §4.10 形状与语义 + §7.4-17 下限限定）
This commit is contained in:
AskaEth committed
1 parent
a057a0f61f
commit
34cef95e17
25 files changed
+1741
-14
No files matched your search
@@ -124,6 +124,12 @@ type AdminUserRecord struct {
|
||||
// design/10 §3 #12）回答「走了哪条路、为什么打扰/为什么不打扰」——
|
||||
// 它们直接来自后端已存的 PushResult，因此面板不必靠猜来解释
|
||||
// 一次静默。
|
||||
//
|
||||
// Urgency / QuietHoursBypassed（v0.68）回答「这一轮有多紧急、是不是
|
||||
// 穿透了安静时段」。二者都**只在存档可证时**出现，缺席 ≠ 常规档位：
|
||||
// 推导依据见 admin_backthink_urgency.go（那一轮的 `At` 落在安静时段窗口内
|
||||
// 时，判定级联已把档位锁死到可证的范围；窗口之外的轮次存档里没有档位，
|
||||
// 因此不下发，而不是编一个 routine）。
|
||||
type AdminBackthinkItem struct {
|
||||
ID string `json:"id"`
|
||||
Trigger string `json:"trigger"`
|
||||
@@ -137,6 +143,14 @@ type AdminBackthinkItem struct {
|
||||
// Bypassed 表示这是事件驱动的推送、绕过了限频闸（"该发就发"）。
|
||||
Bypassed bool `json:"bypassed"`
|
||||
At int64 `json:"at"`
|
||||
// Urgency 是这一轮紧急度的**存档可证下限**（urgency 档位词汇：
|
||||
// routine | warning | critical）。`warning` 读作「≥ high 档（可能更高）」；
|
||||
// 无法证明时省略该键（面板显示「未知」）。
|
||||
Urgency string `json:"urgency,omitempty"`
|
||||
// QuietHoursBypassed 为 true 时表示这一轮**穿透了安静时段**（轮次时间落在
|
||||
// 安静时段窗口内且该轮判定要推送）。只在为 true 时出现：安静时段之外的轮次
|
||||
// 与「没穿透」不必在线上区分，缺席即「没有这件事」。
|
||||
QuietHoursBypassed bool `json:"quietHoursBypassed,omitempty"`
|
||||
}
|
||||
|
||||
// AdminRagDoc 是管理 RAG 列表中一个知识库文档（项目索引
|
||||
|
||||
@@ -0,0 +1,70 @@
|
||||
package gateway
|
||||
|
||||
import (
|
||||
"time"
|
||||
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/services/backthink"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/urgency"
|
||||
)
|
||||
|
||||
// 本文件把「这一轮后台思考有多紧急、是不是穿透了安静时段」变成**存档里可证**的
|
||||
// 事实（切片 P4）。它刻意只读 `backthink.Record` 已有的字段 —— 本片不动
|
||||
// `internal/services/backthink/**`（通用紧急度通道的落库属那片的面）：
|
||||
//
|
||||
// - `Record.ShouldPush` 是那一轮的打扰判定结果；
|
||||
// - `Record.At` 是那一轮的墙钟时间（库里存 UTC，取钟点前必须换回本地
|
||||
// 时区，因为安静时段是**本地钟点**窗口）；
|
||||
// - 安静时段窗口取**进程生效**的 `QUIET_START_HOUR`/`QUIET_END_HOUR`
|
||||
// （`config.Background`，与 backthink 的 cfg 同源：组合根把同一对值交给它）。
|
||||
//
|
||||
// 由 `backthink.Decide` 的判定级联（`decide.go` 的 baseDecide）可证：
|
||||
//
|
||||
// - 安静时段内被**放行** ⇒ 该轮重要度必然 ≥ `ImportanceHigh`（更低档位在安静
|
||||
// 时段一律被扣下）⇒ 这一轮**穿透了安静时段**，档位**至少**是 `warning`
|
||||
// （high）。这就是 `quietHoursBypassed` 的全部依据，不是启发式。
|
||||
// - 安静时段内被**扣下** ⇒ 档位 < high ⇒ `routine`，未穿透。
|
||||
// - 安静时段**之外** ⇒ 判定根本不看档位（「想不想说」由她自己的结论决定），
|
||||
// 并且推送成功的行其 `PushResult.Detail` 已被投递说明覆盖 ⇒ 存档里没有任何
|
||||
// 字段能反推档位。此时**不下发** urgency（面板显示「未知」），绝不猜。
|
||||
//
|
||||
// 因此 `AdminBackthinkItem.Urgency` 的语义是「**存档可证的档位下限**」而不是
|
||||
// 「精确档位」：`warning` 读作「≥ high（含 critical）」。要做到精确档位，需要
|
||||
// backthink 把每轮的 `Import` 落进 `Record`（本片不做，已在契约 §4.10(c) 与
|
||||
// §7.4-17 如实登记）。
|
||||
|
||||
// backthinkQuietOutcome 是「该轮与安静时段的关系」的推导结果。
|
||||
type backthinkQuietOutcome struct {
|
||||
// urgency 是档位下限标签（urgency.Level 的词汇），无法证明时为空串。
|
||||
urgency string
|
||||
// bypassed 报告该轮是否穿透了安静时段（安静时段内仍被放行）。
|
||||
bypassed bool
|
||||
}
|
||||
|
||||
// backthinkQuietOutcomeOf 推导一条存档记录可证的紧急度下限与穿透标记。
|
||||
//
|
||||
// `at` 为零值（时间戳格式错乱的行，见 backthink.store.parseTime 的兜底）时一律
|
||||
// 返回「无事实」：宁可不显示，也不把零值时间当成凌晨而谎报一轮穿透。
|
||||
func backthinkQuietOutcomeOf(rec backthink.Record, startHour, endHour int) backthinkQuietOutcome {
|
||||
if rec.At.IsZero() {
|
||||
return backthinkQuietOutcome{}
|
||||
}
|
||||
if !quietHoursActiveAt(startHour, endHour, rec.At.Local()) {
|
||||
return backthinkQuietOutcome{}
|
||||
}
|
||||
if rec.ShouldPush {
|
||||
return backthinkQuietOutcome{urgency: urgency.LevelWarning.String(), bypassed: true}
|
||||
}
|
||||
return backthinkQuietOutcome{urgency: urgency.LevelRoutine.String()}
|
||||
}
|
||||
|
||||
// quietHoursActiveAt 报告 at 是否落在安静时段窗口内。口径与既有三处逐字一致
|
||||
// （`backthink.decide.inQuietHours`、`channelbridge` 轻思考门、
|
||||
// `memory.TidyConfig.inQuietHours`）：窗口是半开的 `[start, end)`，可跨午夜；
|
||||
// 两端相等即关闭（`23/23` 与 `0/0` 都得到「从不生效」）。
|
||||
func quietHoursActiveAt(startHour, endHour int, at time.Time) bool {
|
||||
h := at.Hour()
|
||||
if startHour <= endHour {
|
||||
return h >= startHour && h < endHour
|
||||
}
|
||||
return h >= startHour || h < endHour
|
||||
}
|
||||
@@ -0,0 +1,168 @@
|
||||
package gateway
|
||||
|
||||
import (
|
||||
"net/http"
|
||||
"strings"
|
||||
"testing"
|
||||
"time"
|
||||
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/auth"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/config"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/services/backthink"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/urgency"
|
||||
)
|
||||
|
||||
// 本文件是 P4「后台思考行紧急度 / 穿透安静时段」的测试：钉住
|
||||
// 「穿透标记 ⇔ 档位下限」的对应关系，以及「不可证时不下发」的诚实边界。
|
||||
|
||||
// quietCfg 构造安静时段 = 23:00-07:00（跨午夜）的生效配置。
|
||||
func quietCfg() *config.Config {
|
||||
cfg := cfgDefault()
|
||||
cfg.Background.QuietStartHour = 23
|
||||
cfg.Background.QuietEndHour = 7
|
||||
return cfg
|
||||
}
|
||||
|
||||
// localAt 造一个**本地时区**的墙钟时刻（安静时段是本地钟点窗口）。
|
||||
func localAt(hour int) time.Time {
|
||||
return time.Date(2026, 10, 6, hour, 30, 0, 0, time.Local)
|
||||
}
|
||||
|
||||
// TestAdminBackthink_QuietHoursBypassMatchesUrgency 是判据 ④：管理行上的穿透标记
|
||||
// 必须与 `urgency` 档位下限一一对应 ——
|
||||
// - 安静时段内 + 判定要推 → urgency=warning（≥ high）+ quietHoursBypassed=true；
|
||||
// - 安静时段内 + 判定不推 → urgency=routine + 无穿透键；
|
||||
// - 安静时段外 → 两个键都不下发（存档不可证，绝不猜）。
|
||||
func TestAdminBackthink_QuietHoursBypassMatchesUrgency(t *testing.T) {
|
||||
t.Parallel()
|
||||
feed := &stubBackthinkFeed{records: []backthink.Record{
|
||||
{
|
||||
ID: 3, Trigger: "iot.device.smoke", At: localAt(2), Conclusion: "烟雾告警，得叫她",
|
||||
ShouldPush: true,
|
||||
PushResult: backthink.PushResult{Pushed: true, Route: backthink.RouteActiveClient, Bypassed: true, Detail: "delivered to 1 active client(s), event_bypass"},
|
||||
},
|
||||
{
|
||||
ID: 2, Trigger: "heartbeat", At: localAt(3), Conclusion: "深夜只是想一想",
|
||||
ShouldPush: false,
|
||||
PushResult: backthink.PushResult{Route: backthink.RouteNone, Detail: "quiet hours; not interrupting"},
|
||||
},
|
||||
{
|
||||
ID: 1, Trigger: "heartbeat", At: localAt(12), Conclusion: "白天的一轮",
|
||||
ShouldPush: true,
|
||||
PushResult: backthink.PushResult{Pushed: true, Route: backthink.RouteIMBridge, Detail: "delivered via IM bridge"},
|
||||
},
|
||||
}}
|
||||
_, ts, jwt := buildEnv(t, quietCfg(), Deps{Backthink: feed})
|
||||
status, raw, items := listBackthinkItems(t, ts, signAny(t, jwt, "acct", auth.RoleOwner))
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("status = %d, body = %s", status, raw)
|
||||
}
|
||||
if len(items) != 3 {
|
||||
t.Fatalf("items = %d, want 3", len(items))
|
||||
}
|
||||
body := string(raw)
|
||||
byID := map[string]AdminBackthinkItem{}
|
||||
for _, it := range items {
|
||||
byID[it.ID] = it
|
||||
}
|
||||
// ① 安静时段内被放行 ⇒ 穿透 + 档位下限 warning（= 至少 high）。
|
||||
bypass := byID["3"]
|
||||
if !bypass.QuietHoursBypassed || bypass.Urgency != urgency.LevelWarning.String() {
|
||||
t.Fatalf("穿透行 = %+v, want urgency=%s + quietHoursBypassed=true", bypass, urgency.LevelWarning)
|
||||
}
|
||||
// ② 安静时段内被扣下 ⇒ routine，且不得标成穿透。
|
||||
held := byID["2"]
|
||||
if held.QuietHoursBypassed || held.Urgency != urgency.LevelRoutine.String() {
|
||||
t.Fatalf("静默行 = %+v, want urgency=routine 且不穿透", held)
|
||||
}
|
||||
// ③ 安静时段之外 ⇒ 两个键都不下发（存档不可证）。
|
||||
day := byID["1"]
|
||||
if day.QuietHoursBypassed || day.Urgency != "" {
|
||||
t.Fatalf("白天行 = %+v, want 两个键都缺席", day)
|
||||
}
|
||||
// 线上形状：真穿透的行必须带这两个键；不可证的行必须**不带**它们（不是 false）。
|
||||
if !strings.Contains(body, `"urgency":"warning"`) || !strings.Contains(body, `"quietHoursBypassed":true`) {
|
||||
t.Fatalf("响应缺少穿透/档位键：%s", body)
|
||||
}
|
||||
if !strings.Contains(body, `"urgency":"routine"`) {
|
||||
t.Fatalf("响应缺少被扣下那轮的档位：%s", body)
|
||||
}
|
||||
if strings.Contains(body, `"quietHoursBypassed":false`) {
|
||||
t.Fatalf("「没穿透」不得写成 false（键必须缺席，才不把「未知」画成事实）：%s", body)
|
||||
}
|
||||
}
|
||||
|
||||
// TestAdminBackthink_OmitsUrgencyForZeroTimestamp 钉住兜底：时间戳坏掉的行
|
||||
// （backthink 存储层解析失败会给零值时间）**不下发**任何档位/穿透 ——
|
||||
// 宁可不显示，也不把零值时间当成凌晨而谎报一轮穿透。
|
||||
func TestAdminBackthink_OmitsUrgencyForZeroTimestamp(t *testing.T) {
|
||||
t.Parallel()
|
||||
feed := &stubBackthinkFeed{records: []backthink.Record{
|
||||
{ID: 1, Trigger: "broken", ShouldPush: true},
|
||||
}}
|
||||
_, ts, jwt := buildEnv(t, quietCfg(), Deps{Backthink: feed})
|
||||
status, raw, items := listBackthinkItems(t, ts, signAny(t, jwt, "acct", auth.RoleOwner))
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("status = %d, body = %s", status, raw)
|
||||
}
|
||||
got := items[0]
|
||||
if got.Urgency != "" || got.QuietHoursBypassed {
|
||||
t.Fatalf("零值时间戳不得产出档位/穿透：%+v", got)
|
||||
}
|
||||
if strings.Contains(string(raw), `"urgency"`) || strings.Contains(string(raw), `"quietHoursBypassed"`) {
|
||||
t.Fatalf("零值时间戳必须省略两个键：%s", raw)
|
||||
}
|
||||
}
|
||||
|
||||
// TestQuietHoursActiveAt_WindowSemantics 钉住窗口口径（与 backthink.decide 的
|
||||
// inQuietHours 逐字一致）：半开区间、可跨午夜、两端相等即关闭。
|
||||
func TestQuietHoursActiveAt_WindowSemantics(t *testing.T) {
|
||||
t.Parallel()
|
||||
at := func(hour, minute int) time.Time {
|
||||
return time.Date(2026, 10, 6, hour, minute, 0, 0, time.Local)
|
||||
}
|
||||
cases := []struct {
|
||||
name string
|
||||
start, end int
|
||||
when time.Time
|
||||
want bool
|
||||
}{
|
||||
{"跨午夜：起点", 23, 7, at(23, 0), true},
|
||||
{"跨午夜：午前", 23, 7, at(2, 30), true},
|
||||
{"跨午夜：终点前", 23, 7, at(6, 59), true},
|
||||
{"跨午夜：终点（半开区间不含）", 23, 7, at(7, 0), false},
|
||||
{"跨午夜：起点前", 23, 7, at(22, 59), false},
|
||||
{"跨午夜：白天", 23, 7, at(12, 0), false},
|
||||
{"日间窗口", 9, 17, at(10, 0), true},
|
||||
{"日间窗口：窗口外", 9, 17, at(22, 0), false},
|
||||
{"两端相等 ⇒ 关闭", 23, 23, at(23, 30), false},
|
||||
{"零值 ⇒ 关闭", 0, 0, at(1, 0), false},
|
||||
}
|
||||
for _, tc := range cases {
|
||||
tc := tc
|
||||
t.Run(tc.name, func(t *testing.T) {
|
||||
t.Parallel()
|
||||
if got := quietHoursActiveAt(tc.start, tc.end, tc.when); got != tc.want {
|
||||
t.Fatalf("quietHoursActiveAt(%d,%d,%v) = %v, want %v", tc.start, tc.end, tc.when, got, tc.want)
|
||||
}
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
// TestBackthinkQuietOutcomeOf_ReadsLocalHour 钉住时区口径：库里存 UTC，但安静
|
||||
// 时段是**本地钟点**窗口 ⇒ 推导必须先换回本地时区再取钟点（否则北京时间凌晨 2 点
|
||||
// 会被当成 UTC 18 点，穿透标记整片错位）。
|
||||
func TestBackthinkQuietOutcomeOf_ReadsLocalHour(t *testing.T) {
|
||||
t.Parallel()
|
||||
if _, offset := time.Now().In(time.Local).Zone(); offset == 0 {
|
||||
t.Skip("本机 UTC：时区换算在这种环境下不可观测")
|
||||
}
|
||||
local2am := localAt(2)
|
||||
utc := local2am.UTC()
|
||||
if utc.Hour() == local2am.Hour() {
|
||||
t.Skip("本机 UTC：时区换算在这种环境下不可观测")
|
||||
}
|
||||
if got := backthinkQuietOutcomeOf(backthink.Record{At: utc, ShouldPush: true}, 23, 7); !got.bypassed {
|
||||
t.Fatalf("UTC 存储的本地凌晨 2 点必须判为穿透：%+v", got)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,107 @@
|
||||
package gateway
|
||||
|
||||
import (
|
||||
"reflect"
|
||||
"strconv"
|
||||
"strings"
|
||||
)
|
||||
|
||||
// 本文件从 `internal/config` 的 env 标签里读出各键的**声明默认值**，供只读配置
|
||||
// 事实面（admin_config_facts.go）如实展示「默认 / 已改」。
|
||||
//
|
||||
// 为什么用标签而不是另一份默认值清单：`default:"…"` 标签本身就是配置层的唯一
|
||||
// 真源（`config.lookupRaw` 在进程环境与 `.env` 都没给值时正是用它）。网关再抄
|
||||
// 一份等于制造第二份事实，两边迟早对不上；而反射读标签既不需要 fopen `.env`
|
||||
// （主人红线：键名单读 `.env.example`，**绝不读 `.env`**），也不需要新增配置包
|
||||
// 导出面。
|
||||
|
||||
// envTagName 与 config 包的内部约定一致：env 标签可带逗号分隔的选项，
|
||||
// 变量名是逗号前的部分。
|
||||
func envTagName(tag string) string {
|
||||
name, _, _ := strings.Cut(tag, ",")
|
||||
return strings.TrimSpace(name)
|
||||
}
|
||||
|
||||
// declaredEnvDefaults 遍历配置结构体，返回 `env:"KEY"` 字段的声明默认值
|
||||
// （`default:"…"` 标签），按字段类型归一化成字符串，键与取值口径与
|
||||
// `buildConfigFacts` 对齐：
|
||||
//
|
||||
// - bool → "true"/"false"（标签里的写法大小写、多余空白都被吸收）；
|
||||
// - int → 十进制；
|
||||
// - float → 归一化小数（`0.80` ⇒ `0.8`）；
|
||||
// - string→ 原样（去首尾空白）。
|
||||
//
|
||||
// 没有 `default` 标签的字段不进表（其「未设置」语义由各自的 Set 标志单独表达，
|
||||
// 不是本事实面的内容）；无法归一化的值原样保留，宁可显示原始文本也不猜。
|
||||
func declaredEnvDefaults(root any) map[string]string {
|
||||
out := make(map[string]string)
|
||||
if root == nil {
|
||||
return out
|
||||
}
|
||||
collectEnvDefaults(reflect.ValueOf(root), out, 0)
|
||||
return out
|
||||
}
|
||||
|
||||
// maxConfigDepth 是递归下探嵌套配置组的深度上限（防御性：配置是静态结构，
|
||||
// 但它必须是常量而不是魔法数字）。
|
||||
const maxConfigDepth = 8
|
||||
|
||||
// collectEnvDefaults 递归收集默认值。非结构体、指针、不可寻址的字段一律跳过：
|
||||
// 配置结构体是静态的平面嵌套，够不到的东西不猜。
|
||||
func collectEnvDefaults(v reflect.Value, out map[string]string, depth int) {
|
||||
if depth > maxConfigDepth {
|
||||
return
|
||||
}
|
||||
if v.Kind() == reflect.Pointer {
|
||||
if v.IsNil() {
|
||||
return
|
||||
}
|
||||
v = v.Elem()
|
||||
}
|
||||
if v.Kind() != reflect.Struct {
|
||||
return
|
||||
}
|
||||
t := v.Type()
|
||||
for i := 0; i < t.NumField(); i++ {
|
||||
field := t.Field(i)
|
||||
if !field.IsExported() {
|
||||
continue
|
||||
}
|
||||
fv := v.Field(i)
|
||||
tag, hasEnv := field.Tag.Lookup("env")
|
||||
if !hasEnv {
|
||||
// 没有 env 标签的字段是嵌套配置组。
|
||||
collectEnvDefaults(fv, out, depth+1)
|
||||
continue
|
||||
}
|
||||
name := envTagName(tag)
|
||||
if name == "" {
|
||||
continue
|
||||
}
|
||||
def, hasDefault := field.Tag.Lookup("default")
|
||||
if !hasDefault {
|
||||
continue
|
||||
}
|
||||
out[name] = normalizeDefault(fv.Kind(), def)
|
||||
}
|
||||
}
|
||||
|
||||
// normalizeDefault 把标签里的默认值按字段类型归一化，形状与事实面的生效值一致。
|
||||
func normalizeDefault(kind reflect.Kind, raw string) string {
|
||||
text := strings.TrimSpace(raw)
|
||||
switch kind {
|
||||
case reflect.Bool:
|
||||
if b, err := strconv.ParseBool(strings.ToLower(text)); err == nil {
|
||||
return strconv.FormatBool(b)
|
||||
}
|
||||
case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64:
|
||||
if n, err := strconv.ParseInt(text, 10, 64); err == nil {
|
||||
return strconv.FormatInt(n, 10)
|
||||
}
|
||||
case reflect.Float32, reflect.Float64:
|
||||
if f, err := strconv.ParseFloat(text, 64); err == nil {
|
||||
return formatRatio(f)
|
||||
}
|
||||
}
|
||||
return text
|
||||
}
|
||||
@@ -0,0 +1,232 @@
|
||||
package gateway
|
||||
|
||||
import (
|
||||
"net/http"
|
||||
"strconv"
|
||||
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/config"
|
||||
)
|
||||
|
||||
// 本文件承载 P3「配置只读事实面」：把面板此前**看不见、只能照模板猜**的一组调参
|
||||
// 键做成只读事实展示（记忆整理 7 键 + 安静时段 2 键）。三条边界（AGENTS §10 与
|
||||
// 主人红线）：
|
||||
//
|
||||
// 1. **键名单的权威来源是 `.env.example`**（不是 `.env`、也不是本文件自己发明
|
||||
// 一份清单）：事实表逐条与模板键名对齐，由
|
||||
// `TestAdminConfigFacts_KeysMatchEnvExample` 钉住；加了键却忘了同步模板会被
|
||||
// 这条测试打红（协同 E6 的同一类固定动作）。
|
||||
// 2. **值只取「进程生效值」**：即 `config.Load` 解析后的字段（进程环境 → `.env`
|
||||
// → 默认标签的优先级链已经由配置层消化）。网关**绝不 fopen `.env`**，因此
|
||||
// 面板看到的是运行实例真正在用的数，而不是 `.env` 原文。每条事实另带**声明
|
||||
// 默认值**（从 `default:"…"` 标签反射读出）与 `isDefault`，于是「这项还是默认
|
||||
// 值」与「这项被改过」都能如实显示，不必假装知道 `.env` 里写过什么。
|
||||
// 3. **绝不回任何密钥 / 令牌值**：本端点只覆盖上述 9 个非敏感调参键，响应里连
|
||||
// 凭据类键的「是否已配置」都不出现。
|
||||
// `TestAdminConfigFacts_NeverLeaksSecretValues` 用哨兵值把这条钉死。
|
||||
//
|
||||
// 安静时段的**语义**（面板文案必须照此写）：它**只服务「定时主动思考 → 主动搭话」**，
|
||||
// **不静默回复**（design/12 §6 策略五；主人裁决 10）。所以这里只报「窗口是多少、
|
||||
// 是否被关掉」，绝不在契约或文案里说「夜间全静默」。
|
||||
|
||||
// AdminConfigFact 是一条只读「配置事实」：键名 + 进程生效值 + 声明默认值。
|
||||
//
|
||||
// Value 与 Default 都是**归一化后的字符串**（bool → "true"/"false"，整数 →
|
||||
// 十进制，比例 → 归一化小数如 "0.8"），因为面板把它当文本显示，且归一化后
|
||||
// 「生效值 == 声明默认值」才是一次可靠的比较。
|
||||
type AdminConfigFact struct {
|
||||
Key string `json:"key"`
|
||||
// Value 是进程生效值（已解析），不是 `.env` 原文。
|
||||
Value string `json:"value"`
|
||||
// Default 是该键的声明默认值（internal/config 的 default 标签，唯一真源）。
|
||||
Default string `json:"default"`
|
||||
// IsDefault 报告生效值是否等于声明默认值。它为 true 时面板显示「默认」；
|
||||
// 为 false 时显示「已改」。**它不是**「`.env` 没写过这个键」的断言 ——
|
||||
// 本端点不读 `.env`，两者不可区分，因此不做那个更强的声称。
|
||||
IsDefault bool `json:"isDefault"`
|
||||
}
|
||||
|
||||
// AdminConfigQuietHours 是安静时段窗口的**解释**（不是新配置）：两个裸钟点不足以
|
||||
// 表达「跨午夜」「已关闭」与「两端写 0 视为未填」，而面板文案需要这些结论。
|
||||
type AdminConfigQuietHours struct {
|
||||
StartHour int `json:"startHour"`
|
||||
EndHour int `json:"endHour"`
|
||||
Disabled bool `json:"disabled"`
|
||||
// Label 是可直接显示的窗口文案（"23:00-07:00" 或 "已关闭"）。
|
||||
Label string `json:"label"`
|
||||
// FallbackToDefault 报告窗口两端都被写成 0。0/0 是**未填**而不是**关闭**：
|
||||
// backthink（cfg.go normalize）与记忆整理（tidy_config.go normalizeTidyConfig）
|
||||
// 都会在这个形状上回落到设计默认 23:00-07:00，因此这里的 StartHour/EndHour
|
||||
// 报的是**回落之后真正生效**的钟点，面板要把这层解释显示出来 —— 否则事实面会把
|
||||
// 「未填」谎报成「已关闭」。要关窗口请写两个相等的**非 0** 钟点（如 23/23）。
|
||||
FallbackToDefault bool `json:"fallbackToDefault,omitempty"`
|
||||
}
|
||||
|
||||
// AdminConfigFacts 是 GET /api/v1/admin/config-facts 的线上结构。
|
||||
type AdminConfigFacts struct {
|
||||
Facts []AdminConfigFact `json:"facts"`
|
||||
QuietHours AdminConfigQuietHours `json:"quietHours"`
|
||||
}
|
||||
|
||||
// 安静时段关闭时的展示文案（窗口两端相等即关闭，见 quietHoursWindow）。
|
||||
const quietHoursDisabledLabel = "已关闭"
|
||||
|
||||
// configFactSpec 是一条事实的取数说明：env 键名 + 从生效配置里取值。
|
||||
type configFactSpec struct {
|
||||
key string
|
||||
value func(cfg *config.Config) string
|
||||
}
|
||||
|
||||
// configFactSpecs 是事实表的**唯一真源**：顺序即面板显示顺序（先记忆整理，
|
||||
// 后安静时段）。键名必须与 `.env.example` 逐字一致（测试钉住）。
|
||||
func configFactSpecs() []configFactSpec {
|
||||
return []configFactSpec{
|
||||
{"MEMORY_TIDY_ENABLED", func(c *config.Config) string {
|
||||
return strconv.FormatBool(c.MemoryTidy.Enabled)
|
||||
}},
|
||||
{"MEMORY_TIDY_INTERVAL_SEC", func(c *config.Config) string {
|
||||
return strconv.Itoa(c.MemoryTidy.IntervalSec)
|
||||
}},
|
||||
{"MEMORY_TIDY_QUIET_START_HOUR", func(c *config.Config) string {
|
||||
return strconv.Itoa(c.MemoryTidy.QuietStartHour)
|
||||
}},
|
||||
{"MEMORY_TIDY_QUIET_END_HOUR", func(c *config.Config) string {
|
||||
return strconv.Itoa(c.MemoryTidy.QuietEndHour)
|
||||
}},
|
||||
{"MEMORY_TIDY_RECALL_THRESHOLD", func(c *config.Config) string {
|
||||
return formatRatio(c.MemoryTidy.RecallThreshold)
|
||||
}},
|
||||
{"MEMORY_TIDY_SCAN_LIMIT", func(c *config.Config) string {
|
||||
return strconv.Itoa(c.MemoryTidy.ScanLimit)
|
||||
}},
|
||||
{"MEMORY_TIDY_CANDIDATE_LIMIT", func(c *config.Config) string {
|
||||
return strconv.Itoa(c.MemoryTidy.CandidateLimit)
|
||||
}},
|
||||
{"QUIET_START_HOUR", func(c *config.Config) string {
|
||||
return strconv.Itoa(c.Background.QuietStartHour)
|
||||
}},
|
||||
{"QUIET_END_HOUR", func(c *config.Config) string {
|
||||
return strconv.Itoa(c.Background.QuietEndHour)
|
||||
}},
|
||||
}
|
||||
}
|
||||
|
||||
// formatRatio 把比例值归一化成与 declaredEnvDefaults 相同的形状，使
|
||||
// 「生效值 == 声明默认值」的比较不受写法影响（标签写 `0.80`、值算出来 `0.8`）。
|
||||
func formatRatio(v float64) string {
|
||||
return strconv.FormatFloat(v, 'g', -1, 64)
|
||||
}
|
||||
|
||||
// buildConfigFacts 组装配置事实面。它是纯函数（不读文件、不读 env），因此可
|
||||
// 直接单测；cfg 为 nil 时回退到一个零值配置（此时 9 条事实全部照实报零值 +
|
||||
// 声明默认值，面板会看到 isDefault=false 的「已改」而不是一个编出来的值）。
|
||||
func buildConfigFacts(cfg *config.Config) AdminConfigFacts {
|
||||
if cfg == nil {
|
||||
cfg = &config.Config{}
|
||||
}
|
||||
defaults := declaredEnvDefaults(cfg)
|
||||
specs := configFactSpecs()
|
||||
out := AdminConfigFacts{Facts: make([]AdminConfigFact, 0, len(specs))}
|
||||
for _, spec := range specs {
|
||||
value := spec.value(cfg)
|
||||
def := defaults[spec.key]
|
||||
out.Facts = append(out.Facts, AdminConfigFact{
|
||||
Key: spec.key,
|
||||
Value: value,
|
||||
Default: def,
|
||||
IsDefault: def != "" && value == def,
|
||||
})
|
||||
}
|
||||
out.QuietHours = quietHoursFacts(cfg.Background.QuietStartHour, cfg.Background.QuietEndHour, defaults)
|
||||
return out
|
||||
}
|
||||
|
||||
// effectiveQuietHours 返回**运行时真正生效**的安静时段钟点，并报告是否发生了
|
||||
// 「未填 → 默认」的回落：
|
||||
//
|
||||
// - 两端相等且非 0 ⇒ 窗口关闭（既有三处同口径），返回原来的钟点；
|
||||
// - 两端都为 0 ⇒ **未填**：组合根把 `config.Background` 交给 backthink，而
|
||||
// backthink（cfg.go 的 normalize）与记忆整理（tidy_config.go 的
|
||||
// normalizeTidyConfig）都会在 0/0 上回落到设计默认 23:00-07:00。事实面与
|
||||
// 后台思考行的事实推导都必须按**回落之后**的窗口算，否则会把「未填」当成
|
||||
// 「没有安静时段」，从而漏报真正的穿透。回落值取**声明默认值**（env 标签），
|
||||
// 与事实行的 default 同源，不另抄一份常量。
|
||||
//
|
||||
// defaults 是 declaredEnvDefaults 的结果；缺值（或非法）时如实**不回落**，让调用方
|
||||
// 看到原始值，而不是编一个 23 点窗口。
|
||||
func effectiveQuietHours(cfg *config.Config, defaults map[string]string) (start, end int, fell bool) {
|
||||
if cfg == nil {
|
||||
return 0, 0, false
|
||||
}
|
||||
return normalizeQuietHours(cfg.Background.QuietStartHour, cfg.Background.QuietEndHour, defaults)
|
||||
}
|
||||
|
||||
// normalizeQuietHours 是上面那条回落规则的纯函数内核（0/0 ⇒ 用声明默认）。
|
||||
func normalizeQuietHours(start, end int, defaults map[string]string) (int, int, bool) {
|
||||
if start != 0 || end != 0 {
|
||||
return start, end, false
|
||||
}
|
||||
ds, okS := parseHourDefault(defaults["QUIET_START_HOUR"])
|
||||
de, okE := parseHourDefault(defaults["QUIET_END_HOUR"])
|
||||
if !okS || !okE {
|
||||
return start, end, false
|
||||
}
|
||||
return ds, de, true
|
||||
}
|
||||
|
||||
// effectiveQuietHours 是 Server 侧取生效窗口的便捷入口（后台思考行的事实推导与
|
||||
// 配置事实面共用同一口径，避免两处漂移）。
|
||||
func (s *Server) effectiveQuietHours() (int, int) {
|
||||
start, end, _ := effectiveQuietHours(s.cfg, declaredEnvDefaults(s.cfg))
|
||||
return start, end
|
||||
}
|
||||
|
||||
// quietHoursFacts 把生效窗口解释成线上结构（跨午夜 / 已关闭 / 是否回落）。
|
||||
func quietHoursFacts(start, end int, defaults map[string]string) AdminConfigQuietHours {
|
||||
effStart, effEnd, fell := normalizeQuietHours(start, end, defaults)
|
||||
out := AdminConfigQuietHours{StartHour: effStart, EndHour: effEnd, FallbackToDefault: fell}
|
||||
// 关闭 = 两个相等的非 0 钟点（回落之后不可能出现 0/0，所以不必再特判）。
|
||||
out.Disabled = !fell && effStart == effEnd && effStart != 0
|
||||
if out.Disabled {
|
||||
out.Label = quietHoursDisabledLabel
|
||||
} else {
|
||||
out.Label = formatHour(effStart) + "-" + formatHour(effEnd)
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
// parseHourDefault 解析声明默认值里的钟点；缺失或不合法时如实报「不知道」
|
||||
// （调用方据此不做回落，而不是编一个 0 点窗口）。
|
||||
func parseHourDefault(raw string) (int, bool) {
|
||||
if raw == "" {
|
||||
return 0, false
|
||||
}
|
||||
hour, err := strconv.Atoi(raw)
|
||||
if err != nil {
|
||||
return 0, false
|
||||
}
|
||||
return hour, true
|
||||
}
|
||||
|
||||
// formatHour 把钟点格式化成 "HH:00"（面板文案用）。
|
||||
func formatHour(hour int) string {
|
||||
if hour < 0 {
|
||||
hour = 0
|
||||
}
|
||||
return pad2(hour) + ":00"
|
||||
}
|
||||
|
||||
// pad2 把 0..99 补成两位；三位及以上的值原样返回（配置非法时也不吞掉信息）。
|
||||
func pad2(n int) string {
|
||||
if n >= 0 && n < 10 {
|
||||
return "0" + strconv.Itoa(n)
|
||||
}
|
||||
return strconv.Itoa(n)
|
||||
}
|
||||
|
||||
// adminConfigFacts 是 GET /api/v1/admin/config-facts 的处理函数：只读、不审计、
|
||||
// 不读 `.env`、不回凭据。它与消费它的两个面板页（记忆管理、后台思考）同门
|
||||
// （owner/admin），因为它们是**面板配置事实**，与 `/admin/memories`、`/admin/llm`
|
||||
// 同一档，而不是给 viewer 的运行时监控投影。
|
||||
func (s *Server) adminConfigFacts(w http.ResponseWriter, _ *http.Request) {
|
||||
writeJSON(w, http.StatusOK, buildConfigFacts(s.cfg))
|
||||
}
|
||||
@@ -0,0 +1,312 @@
|
||||
package gateway
|
||||
|
||||
import (
|
||||
"encoding/json"
|
||||
"net/http"
|
||||
"os"
|
||||
"path/filepath"
|
||||
"strings"
|
||||
"testing"
|
||||
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/auth"
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/config"
|
||||
)
|
||||
|
||||
// 本文件是 P3「配置只读事实面」的测试。四条被钉住的判据：
|
||||
// ① 安静时段的**值** = 进程生效值（不是常量、不是模板默认）；
|
||||
// ② 「未配置/默认」如实呈现（value + default + isDefault 三者合起来不伪造事实）；
|
||||
// ③ 响应里**不含任何密钥/令牌值**（红线，用哨兵值钉死）；
|
||||
// ④ 键名单 = `.env.example`（键名单的权威来源，协同 E6 的固定动作）。
|
||||
|
||||
// getConfigFacts 调用管理端点并返回状态码、原始响应体与解码结果。
|
||||
func getConfigFacts(t *testing.T, cfg *config.Config, tok string) (int, []byte, AdminConfigFacts) {
|
||||
t.Helper()
|
||||
_, ts, jwt := buildEnv(t, cfg, Deps{})
|
||||
token := tok
|
||||
if token == "" {
|
||||
token = signAny(t, jwt, "acct", auth.RoleOwner)
|
||||
}
|
||||
resp, raw := doReq(t, http.MethodGet, ts.URL+"/api/v1/admin/config-facts", nil, token)
|
||||
var out struct {
|
||||
Data AdminConfigFacts `json:"data"`
|
||||
}
|
||||
if resp.StatusCode == http.StatusOK {
|
||||
if err := json.Unmarshal(raw, &out); err != nil {
|
||||
t.Fatalf("decode: %v (%s)", err, raw)
|
||||
}
|
||||
}
|
||||
return resp.StatusCode, raw, out.Data
|
||||
}
|
||||
|
||||
// factByKey 取出某键的事实（不存在 ⇒ 测试失败）。
|
||||
func factByKey(t *testing.T, facts []AdminConfigFact, key string) AdminConfigFact {
|
||||
t.Helper()
|
||||
for _, f := range facts {
|
||||
if f.Key == key {
|
||||
return f
|
||||
}
|
||||
}
|
||||
t.Fatalf("fact %s missing from %+v", key, facts)
|
||||
return AdminConfigFact{}
|
||||
}
|
||||
|
||||
// quietHoursCfg 构造一个「安静时段 = 01:00-05:00、记忆整理阈值被改过」的生效配置：
|
||||
// 值全部来自配置字段，因此它模拟的正是 `config.Load` 解析后的样子。
|
||||
func quietHoursCfg() *config.Config {
|
||||
cfg := cfgDefault()
|
||||
cfg.Background.QuietStartHour = 1
|
||||
cfg.Background.QuietEndHour = 5
|
||||
cfg.MemoryTidy = config.MemoryTidyConfig{
|
||||
Enabled: false,
|
||||
IntervalSec: 3600,
|
||||
QuietStartHour: 2,
|
||||
QuietEndHour: 6,
|
||||
RecallThreshold: 0.7,
|
||||
ScanLimit: 10,
|
||||
CandidateLimit: 3,
|
||||
}
|
||||
return cfg
|
||||
}
|
||||
|
||||
// TestAdminConfigFacts_QuietHoursAreProcessEffective 是判据 ①：端点回的是
|
||||
// **进程生效值**（config 字段），而不是模板默认值、更不是写死的常量。
|
||||
func TestAdminConfigFacts_QuietHoursAreProcessEffective(t *testing.T) {
|
||||
t.Parallel()
|
||||
status, _, facts := getConfigFacts(t, quietHoursCfg(), "")
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("status = %d", status)
|
||||
}
|
||||
if facts.QuietHours.StartHour != 1 || facts.QuietHours.EndHour != 5 {
|
||||
t.Fatalf("quietHours = %+v, want 1..5（进程生效值）", facts.QuietHours)
|
||||
}
|
||||
if facts.QuietHours.Disabled {
|
||||
t.Fatalf("quietHours 1..5 不应被判定为关闭：%+v", facts.QuietHours)
|
||||
}
|
||||
if facts.QuietHours.Label != "01:00-05:00" {
|
||||
t.Fatalf("label = %q, want 01:00-05:00", facts.QuietHours.Label)
|
||||
}
|
||||
for key, want := range map[string]string{
|
||||
"QUIET_START_HOUR": "1",
|
||||
"QUIET_END_HOUR": "5",
|
||||
"MEMORY_TIDY_QUIET_START_HOUR": "2",
|
||||
"MEMORY_TIDY_QUIET_END_HOUR": "6",
|
||||
"MEMORY_TIDY_ENABLED": "false",
|
||||
"MEMORY_TIDY_INTERVAL_SEC": "3600",
|
||||
"MEMORY_TIDY_RECALL_THRESHOLD": "0.7",
|
||||
"MEMORY_TIDY_SCAN_LIMIT": "10",
|
||||
"MEMORY_TIDY_CANDIDATE_LIMIT": "3",
|
||||
} {
|
||||
if got := factByKey(t, facts.Facts, key).Value; got != want {
|
||||
t.Fatalf("%s value = %q, want %q", key, got, want)
|
||||
}
|
||||
}
|
||||
// 被改过的键必须标成「非默认」，面板才知道它不是默认值。
|
||||
if factByKey(t, facts.Facts, "QUIET_START_HOUR").IsDefault {
|
||||
t.Fatal("QUIET_START_HOUR=1 与声明默认 23 不同，isDefault 必须为 false")
|
||||
}
|
||||
}
|
||||
|
||||
// TestAdminConfigFacts_DeclaredDefaultsAndDefaultFlag 是判据 ②：每条事实都带
|
||||
// **声明默认值**（default 标签，非空），且当生效值等于它时 isDefault=true ——
|
||||
// 面板因此能如实显示「默认」，而不是把默认值当成「用户配过的值」。
|
||||
func TestAdminConfigFacts_DeclaredDefaultsAndDefaultFlag(t *testing.T) {
|
||||
t.Parallel()
|
||||
defaults := map[string]string{
|
||||
"MEMORY_TIDY_ENABLED": "true",
|
||||
"MEMORY_TIDY_INTERVAL_SEC": "86400",
|
||||
"MEMORY_TIDY_QUIET_START_HOUR": "23",
|
||||
"MEMORY_TIDY_QUIET_END_HOUR": "7",
|
||||
"MEMORY_TIDY_RECALL_THRESHOLD": "0.8",
|
||||
"MEMORY_TIDY_SCAN_LIMIT": "5000",
|
||||
"MEMORY_TIDY_CANDIDATE_LIMIT": "20",
|
||||
"QUIET_START_HOUR": "23",
|
||||
"QUIET_END_HOUR": "7",
|
||||
}
|
||||
defaultCfg := &config.Config{
|
||||
MemoryTidy: config.MemoryTidyConfig{
|
||||
Enabled: true, IntervalSec: 86400, QuietStartHour: 23, QuietEndHour: 7,
|
||||
RecallThreshold: 0.8, ScanLimit: 5000, CandidateLimit: 20,
|
||||
},
|
||||
Background: config.BackgroundConfig{QuietStartHour: 23, QuietEndHour: 7},
|
||||
}
|
||||
status, _, facts := getConfigFacts(t, defaultCfg, "")
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("status = %d", status)
|
||||
}
|
||||
if len(facts.Facts) != len(defaults) {
|
||||
t.Fatalf("facts = %d, want %d", len(facts.Facts), len(defaults))
|
||||
}
|
||||
for key, want := range defaults {
|
||||
got := factByKey(t, facts.Facts, key)
|
||||
if got.Default == "" {
|
||||
t.Fatalf("%s 没有声明默认值：default 标签与事实表漂移了", key)
|
||||
}
|
||||
if got.Default != want {
|
||||
t.Fatalf("%s default = %q, want %q（字面量钉桩）", key, got.Default, want)
|
||||
}
|
||||
if !got.IsDefault || got.Value != want {
|
||||
t.Fatalf("%s 生效值等于默认值时必须 isDefault=true 且 value=%q：%+v", key, want, got)
|
||||
}
|
||||
}
|
||||
// 「已改」的呈现：改一个键，只有它掉出默认。
|
||||
changed := defaultCfg
|
||||
changed.MemoryTidy.RecallThreshold = 0.55
|
||||
_, _, after := getConfigFacts(t, changed, "")
|
||||
got := factByKey(t, after.Facts, "MEMORY_TIDY_RECALL_THRESHOLD")
|
||||
if got.Value != "0.55" || got.IsDefault {
|
||||
t.Fatalf("改过的键必须如实报 value=0.55 且 isDefault=false：%+v", got)
|
||||
}
|
||||
if !factByKey(t, after.Facts, "QUIET_END_HOUR").IsDefault {
|
||||
t.Fatal("未改的键不得被标成「已改」")
|
||||
}
|
||||
}
|
||||
|
||||
// TestAdminConfigFacts_QuietHoursWindowCanBeDisabled 钉住窗口关闭态的如实呈现
|
||||
// （两个相等的**非 0** 钟点）：面板必须能显示「已关闭」而不是一个 23:00-23:00 的假窗口。
|
||||
func TestAdminConfigFacts_QuietHoursWindowCanBeDisabled(t *testing.T) {
|
||||
t.Parallel()
|
||||
cfg := cfgDefault()
|
||||
cfg.Background.QuietStartHour = 23
|
||||
cfg.Background.QuietEndHour = 23
|
||||
_, _, facts := getConfigFacts(t, cfg, "")
|
||||
if !facts.QuietHours.Disabled || facts.QuietHours.Label != quietHoursDisabledLabel {
|
||||
t.Fatalf("两端相等的窗口必须报「已关闭」：%+v", facts.QuietHours)
|
||||
}
|
||||
}
|
||||
|
||||
// TestAdminConfigFacts_ZeroZeroQuietHoursFallsBackToDefault 钉住那个容易谎报的边角：
|
||||
// 两端都写 0 **不是**「关闭窗口」，而是「未填」—— backthink（cfg.go 的 normalize）与
|
||||
// 记忆整理都会回落到设计默认 23:00-07:00。事实面必须报**运行时真正生效**的窗口，否则
|
||||
// 会把「未填」谎报成「已关闭」，进而漏报真实发生的穿透。
|
||||
func TestAdminConfigFacts_ZeroZeroQuietHoursFallsBackToDefault(t *testing.T) {
|
||||
t.Parallel()
|
||||
cfg := cfgDefault()
|
||||
cfg.Background.QuietStartHour = 0
|
||||
cfg.Background.QuietEndHour = 0
|
||||
_, _, facts := getConfigFacts(t, cfg, "")
|
||||
if facts.QuietHours.Disabled {
|
||||
t.Fatalf("0/0 是「未填」而不是「关闭」：%+v", facts.QuietHours)
|
||||
}
|
||||
if !facts.QuietHours.FallbackToDefault {
|
||||
t.Fatalf("0/0 必须如实报告回落：%+v", facts.QuietHours)
|
||||
}
|
||||
if facts.QuietHours.StartHour != 23 || facts.QuietHours.EndHour != 7 || facts.QuietHours.Label != "23:00-07:00" {
|
||||
t.Fatalf("回落后的生效窗口应为 23:00-07:00：%+v", facts.QuietHours)
|
||||
}
|
||||
// 事实行本身仍如实报「这个键解析出来的值」（0），不替用户改写配置。
|
||||
if got := factByKey(t, facts.Facts, "QUIET_START_HOUR"); got.Value != "0" {
|
||||
t.Fatalf("事实行的 value 必须是该键实际解析出的值：%+v", got)
|
||||
}
|
||||
}
|
||||
|
||||
// TestEffectiveQuietHours_MatchesBackthinkNormalize 钉住「生效窗口」是同一口径：
|
||||
// 非 0 值原样、0/0 才回落。
|
||||
func TestEffectiveQuietHours_MatchesBackthinkNormalize(t *testing.T) {
|
||||
t.Parallel()
|
||||
defaults := declaredEnvDefaults(&config.Config{})
|
||||
cases := []struct {
|
||||
name string
|
||||
start, end int
|
||||
wantS int
|
||||
wantE int
|
||||
wantFell bool
|
||||
}{
|
||||
{"常规窗口原样", 1, 5, 1, 5, false},
|
||||
{"跨午夜原样", 23, 7, 23, 7, false},
|
||||
{"相等非 0（关闭）原样", 23, 23, 23, 23, false},
|
||||
{"只有起点为 0 仍是真实窗口", 0, 7, 0, 7, false},
|
||||
{"0/0 视为未填 ⇒ 回落", 0, 0, 23, 7, true},
|
||||
}
|
||||
for _, tc := range cases {
|
||||
tc := tc
|
||||
t.Run(tc.name, func(t *testing.T) {
|
||||
t.Parallel()
|
||||
cfg := &config.Config{Background: config.BackgroundConfig{QuietStartHour: tc.start, QuietEndHour: tc.end}}
|
||||
gotS, gotE, fell := effectiveQuietHours(cfg, defaults)
|
||||
if gotS != tc.wantS || gotE != tc.wantE || fell != tc.wantFell {
|
||||
t.Fatalf("effectiveQuietHours(%d,%d) = (%d,%d,%v), want (%d,%d,%v)",
|
||||
tc.start, tc.end, gotS, gotE, fell, tc.wantS, tc.wantE, tc.wantFell)
|
||||
}
|
||||
})
|
||||
}
|
||||
// nil 配置不 panic、不编窗口。
|
||||
if s, e, fell := effectiveQuietHours(nil, nil); s != 0 || e != 0 || fell {
|
||||
t.Fatalf("nil 配置必须如实报没有窗口：(%d,%d,%v)", s, e, fell)
|
||||
}
|
||||
}
|
||||
|
||||
// TestAdminConfigFacts_NeverLeaksSecretValues 是判据 ③（红线）：响应体里绝不许
|
||||
// 出现任何密钥/令牌值。哨兵值刻意取得足够独特，任何形式的泄漏都会被逮到。
|
||||
func TestAdminConfigFacts_NeverLeaksSecretValues(t *testing.T) {
|
||||
t.Parallel()
|
||||
secrets := []string{
|
||||
"jwt-secret-sentinel-0123456789abcdef",
|
||||
"sk-llm-api-key-sentinel",
|
||||
"local-llm-key-sentinel",
|
||||
"embedding-key-sentinel",
|
||||
"postgres://user:pgpassword-sentinel@localhost:5432/cyrene",
|
||||
}
|
||||
cfg := cfgDefault()
|
||||
cfg.Auth.JWTSecret = secrets[0]
|
||||
cfg.Auth.AdminPass = "admin-pass-sentinel"
|
||||
cfg.LLM.APIKey = secrets[1]
|
||||
cfg.LLM.Local.APIKey = secrets[2]
|
||||
cfg.Embedding.APIKey = secrets[3]
|
||||
cfg.DB.PGURL = secrets[4]
|
||||
cfg.Channels = config.ChannelsConfig{
|
||||
AccountsJSON: `{"telegram":[{"id":"conf0","config":{"bot_token":"channel-token-sentinel"}}]}`,
|
||||
}
|
||||
|
||||
status, raw, _ := getConfigFacts(t, cfg, "")
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("status = %d, body = %s", status, raw)
|
||||
}
|
||||
body := string(raw)
|
||||
for _, secret := range append(secrets, "admin-pass-sentinel", "channel-token-sentinel") {
|
||||
if strings.Contains(body, secret) {
|
||||
t.Fatalf("响应里出现了凭据值 %q —— 这是红线：%s", secret, body)
|
||||
}
|
||||
}
|
||||
// 正对照：非敏感的事实确实在响应里（否则上面那条断言可能只是空响应混过关）。
|
||||
if !strings.Contains(body, `"QUIET_START_HOUR"`) || !strings.Contains(body, `"quietHours"`) {
|
||||
t.Fatalf("响应缺少配置事实本身：%s", body)
|
||||
}
|
||||
}
|
||||
|
||||
// TestAdminConfigFacts_KeysMatchEnvExample 是判据 ④：键名单的权威来源是
|
||||
// `.env.example` —— 9 个键必须逐字出现在模板里（键名写错一个字母，用户照面板
|
||||
// 抄去改就是静默不生效，AGENTS §10 的 E6 固定动作）。
|
||||
func TestAdminConfigFacts_KeysMatchEnvExample(t *testing.T) {
|
||||
t.Parallel()
|
||||
raw, err := os.ReadFile(filepath.Join("..", "..", "..", ".env.example"))
|
||||
if err != nil {
|
||||
t.Fatalf("read .env.example: %v", err)
|
||||
}
|
||||
template := string(raw)
|
||||
for _, spec := range configFactSpecs() {
|
||||
if !strings.Contains(template, spec.key+"=") {
|
||||
t.Fatalf(".env.example 里没有 %s= —— 事实表与模板漂移", spec.key)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// TestAdminConfigFacts_RequiresOwnerOrAdmin 钉住 RBAC 门：可读的是 owner/admin，
|
||||
// viewer 拿不到配置事实面（它不是运行时监控投影）。
|
||||
func TestAdminConfigFacts_RequiresOwnerOrAdmin(t *testing.T) {
|
||||
t.Parallel()
|
||||
_, ts, jwt := buildEnv(t, cfgDefault(), Deps{})
|
||||
respViewer, _ := doReq(t, http.MethodGet, ts.URL+"/api/v1/admin/config-facts", nil, signAny(t, jwt, "acct", auth.RoleViewer))
|
||||
if respViewer.StatusCode != http.StatusForbidden {
|
||||
t.Fatalf("viewer = %d, want 403", respViewer.StatusCode)
|
||||
}
|
||||
for _, role := range []auth.Role{auth.RoleOwner, auth.RoleAdmin} {
|
||||
resp, _ := doReq(t, http.MethodGet, ts.URL+"/api/v1/admin/config-facts", nil, signAny(t, jwt, "acct", role))
|
||||
if resp.StatusCode != http.StatusOK {
|
||||
t.Fatalf("role %s = %d, want 200", role, resp.StatusCode)
|
||||
}
|
||||
}
|
||||
resp, _ := doReq(t, http.MethodGet, ts.URL+"/api/v1/admin/config-facts", nil, "")
|
||||
if resp.StatusCode != http.StatusUnauthorized {
|
||||
t.Fatalf("匿名 = %d, want 401", resp.StatusCode)
|
||||
}
|
||||
}
|
||||
@@ -375,7 +375,12 @@ func (s *Server) adminListBackthink(w http.ResponseWriter, r *http.Request) {
|
||||
writeError(w, apperr.Wrap(apperr.ErrInternal, "backthink_failed", "failed to list backthink records"))
|
||||
return
|
||||
}
|
||||
// 安静时段窗口取**运行时真正生效**的那一个（0/0 是「未填」而不是「没有安静时段」，
|
||||
// 见 admin_config_facts.go 的 effectiveQuietHours —— 与 backthink 的 normalize 同口径），
|
||||
// 否则 0/0 部署下会漏报真正的穿透。
|
||||
quietStart, quietEnd := s.effectiveQuietHours()
|
||||
for _, rec := range records {
|
||||
quiet := backthinkQuietOutcomeOf(rec, quietStart, quietEnd)
|
||||
out = append(out, AdminBackthinkItem{
|
||||
ID: strconv.FormatInt(rec.ID, 10),
|
||||
Trigger: rec.Trigger,
|
||||
@@ -386,6 +391,9 @@ func (s *Server) adminListBackthink(w http.ResponseWriter, r *http.Request) {
|
||||
Detail: rec.PushResult.Detail,
|
||||
Bypassed: rec.PushResult.Bypassed,
|
||||
At: rec.At.UnixMilli(),
|
||||
// 紧急度下限 / 是否穿透安静时段（v0.68）：只报存档可证的部分。
|
||||
Urgency: quiet.urgency,
|
||||
QuietHoursBypassed: quiet.bypassed,
|
||||
})
|
||||
}
|
||||
writeJSON(w, http.StatusOK, out)
|
||||
|
||||
@@ -176,6 +176,10 @@ func (s *Server) registerAdminRoutes(
|
||||
mux.Handle("GET /api/v1/admin/llm/catalog", writeAuth(http.HandlerFunc(s.adminGetLlmCatalog)))
|
||||
mux.Handle("GET /api/v1/admin/users", writeAuth(http.HandlerFunc(s.adminListUsers)))
|
||||
mux.Handle("GET /api/v1/admin/backthink", writeAuth(http.HandlerFunc(s.adminListBackthink)))
|
||||
// 配置事实面（切片 P3，**v0.68**）：记忆整理 7 键 + 安静时段两键的**进程生效值**
|
||||
// 与声明默认值。只读、不审计、**不读 `.env`**、**不含任何凭据**；与消费它的面板页
|
||||
// （记忆管理 / 后台思考）同门，故走 owner|admin 档而不是 viewer 监控档。
|
||||
mux.Handle("GET /api/v1/admin/config-facts", writeAuth(http.HandlerFunc(s.adminConfigFacts)))
|
||||
mux.Handle("GET /api/v1/admin/observability/audit", writeAuth(http.HandlerFunc(s.adminObservabilityAudit)))
|
||||
mux.Handle("GET /api/v1/admin/sessions/{id}/export", writeAuth(http.HandlerFunc(s.adminExportSession)))
|
||||
mux.Handle("POST /api/v1/admin/rag/query", writeAuth(http.HandlerFunc(s.adminSearchRag)))
|
||||
|
||||
Reference in new issue
Block a user