From 3a2c48541cded885a29101d00c07766dca42a8b3 Mon Sep 17 00:00:00 2001
From: wangjia <809946525@qq.com>
Date: Tue, 28 Jul 2026 07:39:51 +0800
Subject: [PATCH] =?UTF-8?q?docs(routing):=20=E8=AE=A1=E5=88=92=E6=BE=84?=
 =?UTF-8?q?=E6=B8=85=20enabled=20=E7=BC=BA=E7=9C=81=E8=AF=AD=E4=B9=89(?=
 =?UTF-8?q?=E5=BF=85=E5=A1=AB/=E5=AE=A2=E6=88=B7=E7=AB=AF=E6=81=92?=
 =?UTF-8?q?=E5=8F=91/=E6=9C=8D=E5=8A=A1=E7=AB=AF=E4=B8=8D=E9=BB=98?=
 =?UTF-8?q?=E8=AE=A4)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Task 2 复核发现 plan 内部不一致(接口注释 vs 代码块)。裁决:enabled 必填,Task 6 model
恒输出 enabled=true、fromJson 容错默认 true;服务端不修正缺省(缺失=禁用属 fail-safe)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01A79VtQA1BwTuQN1ThpvYpo
---
 .../superpowers/plans/2026-07-27-configurable-proxy-phase1.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/superpowers/plans/2026-07-27-configurable-proxy-phase1.md b/docs/superpowers/plans/2026-07-27-configurable-proxy-phase1.md
index ec5ce60..1445ba9 100644
--- a/docs/superpowers/plans/2026-07-27-configurable-proxy-phase1.md
+++ b/docs/superpowers/plans/2026-07-27-configurable-proxy-phase1.md
@@ -249,7 +249,7 @@ func (s *Store) Upsert(ctx context.Context, userID int64, p *Profile) error {
 - Create: `server/internal/routing/profile_test.go`
 
 **Interfaces:**
-- Produces: `func (p *Profile) Validate() []FieldError`(空 slice = 合法);`FieldError{Index int, Field, Reason string}`;`func (p *Profile) Normalize()`(去重、trim、修正 enabled 缺省)。
+- Produces: `func (p *Profile) Validate() []FieldError`(空 slice = 合法);`FieldError{Index int, Field, Reason string}`;`func (p *Profile) Normalize()`(去重、trim)。注:`enabled` 为必填字段,客户端(Task 6 model)恒传 `true`;服务端不对缺省 enabled 做修正(缺失即零值 false=禁用,属 fail-safe 可接受)。
 - Consumes: `routing.Profile`(Task 1)。
 
 - [ ] **Step 1: 写校验测试(先失败)** `server/internal/routing/profile_test.go`
@@ -565,7 +565,7 @@ test('RoutingProfile round-trips json', () {
 });
 ```
 - [ ] **Step 2: 跑确认失败** `cd client && flutter test test/unit/routing_profile_model_test.dart` → FAIL
-- [ ] **Step 3: 写 model** `client/lib/models/routing_profile.dart`(手写 fromJson/toJson,仿 `lib/models/me.dart:50`;含 `RoutingRule`、`Builtin`、`copyWith`)。字段与服务端契约一致(mode/builtin/rules/final;rule = type/value/action/note/enabled)。
+- [ ] **Step 3: 写 model** `client/lib/models/routing_profile.dart`(手写 fromJson/toJson,仿 `lib/models/me.dart:50`;含 `RoutingRule`、`Builtin`、`copyWith`)。字段与服务端契约一致(mode/builtin/rules/final;rule = type/value/action/note/enabled)。**`RoutingRule` 构造默认 `enabled: true`,`toJson()` 恒输出 `enabled` 字段**(服务端不修正缺省 enabled,契约靠客户端保证;缺失=禁用属 fail-safe)。`fromJson` 中 `enabled: m['enabled'] as bool? ?? true`(读取容错默认 true)。
 - [ ] **Step 4: 跑确认通过** `flutter test test/unit/routing_profile_model_test.dart` → PASS
 - [ ] **Step 5: 加 API** `client/lib/services/account_api.dart`(仿 `:43` me()/`:68` renameDevice):
 ```dart