From ff5ece34cc3008a03d434cbd5b15d601eec2e2ac Mon Sep 17 00:00:00 2001 From: argszero Date: Sat, 12 Sep 2026 14:23:28 +0800 Subject: [PATCH] docs: repoint 5 dangling section references to their current sections MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The 2026-08-22 docs flattening (6d87213) cut docs/architecture.md from 18 headings to 9 and docs/user-stories.md from 14 to 5, dropping the entire 4.x subsection layer. Five section references in tracked files have pointed at headings that no longer exist ever since: src/router.rs:1,17 architecture 4.2.1 -> 3 (module table, router.rs row) src/billing.rs:1 architecture 4.3/4.4 -> 3 (module table, billing.rs row) src/gateway.rs:1 architecture 4.1 -> 6 (API list; gateway.rs has no row in the module table) ui/README.md:25 user-stories 1.1 -> 4 (UI 约定) Each target was read at HEAD and verified to actually carry the cited content before repointing. src/db.rs:3 (architecture 5) already resolves and is deliberately left untouched. Comment/doc-only: no production behaviour change, no i18n keys, no cache-bust. --- src/billing.rs | 2 +- src/gateway.rs | 2 +- src/router.rs | 4 ++-- ui/README.md | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) 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 节，已随文档精简合并到此节）。 本原型据此实现：单一登录入口（角色由账号决定），一套导航（仪表盘 / 模型市场 / 共享管理 / 钱包 / 交易记录 / 设置 + 管理员角色视图）。