From fe4324025b8504400ceae65eeb475ac187454747 Mon Sep 17 00:00:00 2001 From: w287346141 <287346141@qq.com> Date: Sun, 31 May 2026 12:08:45 +0800 Subject: [PATCH] Clarify slash command documentation contract --- docs/ARCHITECTURE.md | 3 ++- docs/arch-i18n.js | 4 ++-- docs/architecture.html | 3 ++- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 997b633..1925c74 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -214,7 +214,8 @@ src/ Files kept small by design: the largest module under `cli/ui/` is 2K lines (App.tsx), every handler under `slash/handlers/` is ≤200 lines, every hook under `cli/ui/` is ≤310 lines. Adding a new slash command -means editing one handler file and one registry line. +means updating its handler, registry entry, localized help copy, and any +public command reference that surfaces the slash list. ## Design evolution diff --git a/docs/arch-i18n.js b/docs/arch-i18n.js index fa68c60..061a41e 100644 --- a/docs/arch-i18n.js +++ b/docs/arch-i18n.js @@ -111,7 +111,7 @@ "mod.title": "Module layout", "mod.note": - "Files kept small by design: the largest module under cli/ui/ is 2K lines (App.tsx), every handler under slash/handlers/ is ≤200 lines, every hook under cli/ui/ is ≤310 lines. Adding a new slash command means editing one handler file and one registry line.", + "Files kept small by design: the largest module under cli/ui/ is 2K lines (App.tsx), every handler under slash/handlers/ is ≤200 lines, every hook under cli/ui/ is ≤310 lines. Adding a new slash command means updating its handler, registry entry, localized help copy, and any public command reference that surfaces the slash list.", "evo.title": "Design evolution", @@ -231,7 +231,7 @@ "mod.title": "模块布局", "mod.note": - "文件故意保持精简：cli/ui/ 下最大的模块是 2K 行（App.tsx），slash/handlers/ 下每个 handler ≤200 行，cli/ui/ 下每个 hook ≤310 行。新增斜杠命令只需改一个 handler 文件和一行注册。", + "文件故意保持精简：cli/ui/ 下最大的模块是 2K 行（App.tsx），slash/handlers/ 下每个 handler ≤200 行，cli/ui/ 下每个 hook ≤310 行。新增斜杠命令需要同步更新 handler、注册表、本地化帮助文案，以及任何公开展示斜杠列表的命令参考。", "evo.title": "设计演进", diff --git a/docs/architecture.html b/docs/architecture.html index 91c4420..d34c91b 100644 --- a/docs/architecture.html +++ b/docs/architecture.html @@ -475,7 +475,8 @@

Module layout

Files kept small by design: the largest module under cli/ui/ is 2K lines (App.tsx), every handler under slash/handlers/ is ≤200 lines, every hook under cli/ui/ is ≤310 lines. Adding a - new slash command means editing one handler file and one registry line. + new slash command means updating its handler, registry entry, localized + help copy, and any public command reference that surfaces the slash list.