diff --git a/src/billing.rs b/src/billing.rs
index 93d2f40..9f77f6c 100644
--- a/src/billing.rs
+++ b/src/billing.rs
@@ -1,4 +1,4 @@
-//! 计量账本（architecture §4.3/4.4 + P1 点数规则细化）
+//! 计量账本（architecture §3 模块 billing.rs 行 + P1 点数规则细化）
 //!
 //! P0-B（rant 2026-08-18T09:55:57）：
 //! - 成本 = prompt_tokens × input_per_m/1e6 + completion_tokens × output_per_m/1e6
diff --git a/src/gateway.rs b/src/gateway.rs
index 10fb249..1b4ec6c 100644
--- a/src/gateway.rs
+++ b/src/gateway.rs
@@ -1,4 +1,4 @@
-//! 网关兼容端点（architecture §4.1）
+//! 网关兼容端点（architecture §6 API 一览）
 //!
 //! P0-B（rant 2026-08-18T09:55:57）：
 //! - POST /v1/chat/completions（OpenAI 兼容，Bearer atk_ API Key 认证）
diff --git a/src/router.rs b/src/router.rs
index b232bd5..5eaad9a 100644
--- a/src/router.rs
+++ b/src/router.rs
@@ -1,4 +1,4 @@
-//! 路由与故障转移（architecture §4.2.1 七条定案）
+//! 路由与故障转移（architecture §3 模块 router.rs 行；原 4.2.1 节七条定案已并入该行）
 //!
 //! P0-B（rant 2026-08-18T09:55:57）：
 //! - 初始随机：从模型 M 的健康 key（status='on' 且不在冷却期）中随机选一
@@ -14,7 +14,7 @@ use rand::seq::SliceRandom;
 
 use crate::dao::KeyRow;
 
-/// 默认冷却时长（architecture §4.2.1 定案：5 秒）
+/// 默认冷却时长（architecture §3 模块 router.rs 行：5 秒）
 pub const COOLDOWN_SECS: u64 = 5;
 /// 每次路由最多尝试的 key 数（初始 + 2 次切换）
 pub const MAX_SWITCHES: usize = 3;
diff --git a/ui/README.md b/ui/README.md
index 2fb265d..f3bb77d 100644
--- a/ui/README.md
+++ b/ui/README.md
@@ -22,7 +22,7 @@
   - **P0 已行内**：上架表单（`#share-form-card` 行内卡片）、部门添加/编辑（`#dept-form-card` 行内卡片，v1.13 由弹层改造）
   - **P1 已行内（v1.14）**：充值（`#topup-card` 行内卡片）、申请加额（`#raise-card` 行内卡片）——钱包页点按钮原地展开、两卡互斥
   - **P2**：模型消费聊天（chat-modal）→ 独立页 / 行内面板
-- 本原则与 docs/user-stories.md §1.1 对齐。
+- 本原则与 docs/user-stories.md §4「UI 约定」对齐（原文的 1.1 节，已随文档精简合并到此节）。
 
 本原型据此实现：单一登录入口（角色由账号决定），一套导航（仪表盘 / 模型市场 / 共享管理 / 钱包 / 交易记录 / 设置 + 管理员角色视图）。