docs(comments): 注释中文化 · internal/runtime/model + internal/services/backthink（54 文件，纯替换）
- 只翻注释/文档字符串：`go/scanner` 剥注释后按 token 序列+literal 逐 token 比对，**54/54 文件 SAME**；
改动文件总行数与 HEAD 漂移 = 0（严格 1:1，无合并/拆行）
- 裁决编号与 design 节号逐字保留（03.4.1/03.4.2/03.4.3/14.4.1/14.4.5/07.4.2-4、design/04 §3.1/§3.2 等）；
`chat_template_kwargs` / `enable_thinking` / `reasoning_effort` / `thinking:{type}` 字段名与形状说明未动
- 存疑译法（已登记）：`persona` 在叙事语境用「角色」、标识符语境保留 `persona`（仓库既有模块本身混用）；
`rung`→「级」；`provider` 存在「提供商/提供者」两种落笔（可按需一键统一）
- 复核：build/vet 绿 + 两包测试绿；gofmt 干净；残留英文注释 0 条
- 既有存量（未修，只报告）：`model/anthropic_test.go` 612 行 >500；`applyAnthropicEvent` 115 行 >80
This commit is contained in:
AskaEth committed
1 parent
f5cf117482
commit
3dc1232bc2
54 files changed
+1923
-1923
No files matched your search
@@ -11,8 +11,8 @@ import (
|
||||
"git.yeij.top/AskaEth/Cyrene_v2/internal/iot"
|
||||
)
|
||||
|
||||
// newBackthink builds a Backthink with a fresh in-memory DB and the given deps,
|
||||
// returning the zeroed deps filled with the DB handle so tests can inspect deps.
|
||||
// newBackthink 用一份新的内存 DB 与给定 deps 构建 Backthink，
|
||||
// 并返回填好 DB 句柄的 deps，好让测试能检查 deps。
|
||||
func newBackthink(t *testing.T, cfg Config, deps Deps) (*Backthink, Deps) {
|
||||
t.Helper()
|
||||
deps.DB = newTestDB(t)
|
||||
@@ -34,9 +34,9 @@ func TestNew_Validation(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestConfig_Defaults verifies the tightened proactive-push defaults: a 15-minute
|
||||
// heartbeat, at most 1 push per 60 minutes, a 30-minute post-push cooldown, a
|
||||
// 10-minute recent-conversation cooldown, and a 2-hour per-flavor window.
|
||||
// TestConfig_Defaults 验证收紧后的主动推送默认值：15 分钟
|
||||
// 心跳、每 60 分钟最多 1 次推送、推送后 30 分钟冷却、
|
||||
// 最近对话 10 分钟冷却，以及按风格 2 小时的窗口。
|
||||
func TestConfig_Defaults(t *testing.T) {
|
||||
t.Parallel()
|
||||
cfg := normalize(Config{})
|
||||
@@ -192,8 +192,8 @@ func TestBackthink_EventTrigger_NoPush(t *testing.T) {
|
||||
|
||||
func TestBackthink_SystemEventLowValueDowngraded(t *testing.T) {
|
||||
t.Parallel()
|
||||
// design/12 §6 策略一: a low-value system event on a public platform does not
|
||||
// wake a full thinking pass — it is downgraded to a registration-only record.
|
||||
// design/12 §6 策略一：公开平台上的低价值系统事件不会
|
||||
// 唤醒一整轮思考——它被降级为仅登记一条记录。
|
||||
thinker := &mockThinker{text: "should not be called"}
|
||||
bs := bus.New()
|
||||
b, _ := newBackthink(t, Config{}, Deps{
|
||||
@@ -240,8 +240,8 @@ func TestBackthink_SystemEventLowValueDowngraded(t *testing.T) {
|
||||
|
||||
func TestBackthink_SystemEventHighValueThinks(t *testing.T) {
|
||||
t.Parallel()
|
||||
// A high-importance (owner-relevant) system event still wakes a thinking pass —
|
||||
// the denoise gate only downgrades low-value noise (design/12 §6 策略一).
|
||||
// 高重要度（与主人相关）的系统事件仍会唤醒一轮思考——
|
||||
// 降噪门只降级低价值噪声（design/12 §6 策略一）。
|
||||
thinker := &mockThinker{text: "important notice"}
|
||||
bs := bus.New()
|
||||
b, _ := newBackthink(t, Config{}, Deps{
|
||||
@@ -289,8 +289,8 @@ func TestBackthink_List_NewestFirst(t *testing.T) {
|
||||
if err != nil {
|
||||
t.Fatalf("List: %v", err)
|
||||
}
|
||||
// The single-row listing must be the same newest record as the head of the
|
||||
// full listing, and the full listing must be strictly newest-first.
|
||||
// 单行列表里的那一条必须与完整列表的头部是同一条最新
|
||||
// 记录，且完整列表必须是严格的由新到旧。
|
||||
if top[0].ID != all[0].ID {
|
||||
t.Fatalf("List(1)[0].ID = %d, want %d (== newest)", top[0].ID, all[0].ID)
|
||||
}
|
||||
@@ -312,7 +312,7 @@ func TestBackthink_Stop_NoLeak(t *testing.T) {
|
||||
if err := b.Stop(context.Background()); err != nil {
|
||||
t.Fatalf("Stop: %v", err)
|
||||
}
|
||||
// Idempotent.
|
||||
// 幂等。
|
||||
if err := b.Stop(context.Background()); err != nil {
|
||||
t.Fatalf("second Stop: %v", err)
|
||||
}
|
||||
@@ -331,9 +331,9 @@ func TestBackthink_Stop_UnsubscribesBus(t *testing.T) {
|
||||
b, _ := newBackthink(t, Config{Interval: 25 * time.Millisecond}, Deps{Bus: bs, Thinker: thinker})
|
||||
|
||||
b.Start(context.Background())
|
||||
// Confirm the subscription is live by triggering one think (identified by its
|
||||
// persisted record, so the 07.4.4 startup round and heartbeat ticks with their
|
||||
// own trigger strings cannot mask or overwrite it).
|
||||
// 通过触发一次思考来确认订阅是活的（以它持久化的
|
||||
// 记录为准，这样 07.4.4 的启动轮与心跳 tick 各自的
|
||||
// 触发字符串不会掩盖或覆盖它）。
|
||||
if err := bs.Publish(context.Background(), SubjectReminderTrigger, "first"); err != nil {
|
||||
t.Fatalf("Publish: %v", err)
|
||||
}
|
||||
@@ -363,10 +363,10 @@ func TestBackthink_Stop_UnsubscribesBus(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// TestBackthink_EventPush_DedupSameEvent verifies the same-event dedup guard: a
|
||||
// repeating identical event (same source + summary) is suppressed after the first
|
||||
// push (防刷), while a genuinely different event still goes out. The duplicate is
|
||||
// recorded as suppressed (route none), not delivered.
|
||||
// TestBackthink_EventPush_DedupSameEvent 验证同一事件去重门：
|
||||
// 重复的相同事件（同源 + 同摘要）在首次推送后
|
||||
// 被抑制（防刷），而真正不同的事件仍会发出。重复的那条
|
||||
// 被记为已抑制（route none），而不是投递出去。
|
||||
func TestBackthink_EventPush_DedupSameEvent(t *testing.T) {
|
||||
t.Parallel()
|
||||
thinker := &mockThinker{text: "washing finished, clothes ready"}
|
||||
@@ -382,9 +382,9 @@ func TestBackthink_EventPush_DedupSameEvent(t *testing.T) {
|
||||
Device: iot.Device{ID: "washer", Type: "sensor"}, Action: "finished",
|
||||
}})
|
||||
|
||||
b.think(context.Background(), ev) // first: pushes
|
||||
b.think(context.Background(), ev) // second: same event -> suppressed
|
||||
b.think(context.Background(), ev) // third: same event -> suppressed
|
||||
b.think(context.Background(), ev) // 第一次：推送
|
||||
b.think(context.Background(), ev) // 第二次：同一事件 -> 被抑制
|
||||
b.think(context.Background(), ev) // 第三次：同一事件 -> 被抑制
|
||||
|
||||
if got := pusher.count(); got != 1 {
|
||||
t.Fatalf("pusher calls = %d, want 1 (repeating same event deduped)", got)
|
||||
@@ -396,7 +396,7 @@ func TestBackthink_EventPush_DedupSameEvent(t *testing.T) {
|
||||
if len(recs) < 3 {
|
||||
t.Fatalf("len(recs) = %d, want at least 3 (one per think)", len(recs))
|
||||
}
|
||||
// Newest first: the two most recent records are the suppressed duplicates.
|
||||
// 最新的在前：最近的这两条就是被抑制的重复。
|
||||
for i := 0; i < 2; i++ {
|
||||
if recs[i].PushResult.Pushed || recs[i].PushResult.Route != RouteNone {
|
||||
t.Fatalf("recs[%d] = %+v, want suppressed duplicate", i, recs[i].PushResult)
|
||||
@@ -405,12 +405,12 @@ func TestBackthink_EventPush_DedupSameEvent(t *testing.T) {
|
||||
t.Fatalf("recs[%d].Detail = %q, want it to mention duplicate", i, recs[i].PushResult.Detail)
|
||||
}
|
||||
}
|
||||
// The third-most-recent record is the first (delivered) push.
|
||||
// 第三新的那条是首次（已投递的）推送。
|
||||
if !recs[2].PushResult.Pushed || recs[2].PushResult.Route != RouteActiveClient {
|
||||
t.Fatalf("recs[2] = %+v, want the first delivered push", recs[2].PushResult)
|
||||
}
|
||||
|
||||
// A genuinely different event resets the chain and goes out.
|
||||
// 真正不同的事件会重置该链并发出。
|
||||
ev2 := triggerForEvent(bus.Event{Subject: iot.DeviceUpdateSubject, Payload: iot.DeviceUpdate{
|
||||
Device: iot.Device{ID: "dryer", Type: "sensor"}, Action: "finished",
|
||||
}})
|
||||
@@ -418,8 +418,8 @@ func TestBackthink_EventPush_DedupSameEvent(t *testing.T) {
|
||||
if got := pusher.count(); got != 2 {
|
||||
t.Fatalf("pusher calls after a different event = %d, want 2", got)
|
||||
}
|
||||
// After the different event, the original identical event is no longer a
|
||||
// consecutive duplicate, so it pushes again — the guard only dedups consecutively.
|
||||
// 在出现不同事件之后，原先那个相同事件不再是
|
||||
// 连续重复，因此它会再次推送——该门只去重连续重复。
|
||||
b.think(context.Background(), ev)
|
||||
if got := pusher.count(); got != 3 {
|
||||
t.Fatalf("pusher calls after an intervening different event = %d, want 3", got)
|
||||
|
||||
Reference in new issue
Block a user