docs: 更新wiki

- 更新了wiki的语言规范
- 优化了骨架屏样式

Author: hzb666

frontend/src/components/ui/FilterTable.tsx

@@ -132,6 +132,19 @@ function getScrollHeight(
   return "calc(100vh - 112px - 16px)";
 }
 
+// 首屏无数据时仍给 loading 容器保留稳定高度，避免鉴权骨架切换后表格区域塌陷。
+function getLoadingSurfaceStyle(scrollHeight: number | string): React.CSSProperties {
+  if (typeof scrollHeight === "number") {
+    return { height: `${scrollHeight}px` };
+  }
+
+  if (scrollHeight !== "auto") {
+    return { height: scrollHeight };
+  }
+
+  return { minHeight: "25.5rem" };
+}
+
 function resolveTableColumns(
   customColumns?: ColumnDef<Record<string, unknown>, unknown>[],
 ): ColumnDef<Record<string, unknown>, unknown>[] {
@@ -474,8 +487,14 @@ function FilterTableContent({
 }: Readonly<FilterTableContentProps>) {
   if (filter.isLoading && filter.data.length === 0) {
     return (
-      <div className="flex items-center justify-center py-8 text-muted-foreground">
-        <Loader2 className="w-5 h-5 animate-spin mr-2" />
+      <div className="px-6 pb-6">
+        <div
+          className="flex items-center justify-center rounded-md border border-border bg-card text-muted-foreground"
+          style={getLoadingSurfaceStyle(scrollHeight)}
+        >
+          <Loader2 className="mr-2 h-5 w-5 animate-spin" />
+          <span>加载中...</span>
+        </div>
       </div>
     );
   }

wiki/dev-guide/cart-sync.md

@@ -52,7 +52,7 @@
 - `POST /api/reagent-orders`：当前 `CartImport` 页面提交试剂条目时实际调用的接口。
 - `POST /api/consumable-orders`：当前 `CartImport` 页面提交耗材条目时实际调用的接口。
 
-如果你在排查“扩展导入成功，但页面没有落单”，要先确认是桥接阶段失败，还是页面逐条调用标准订单 API 失败，而不是默认怀疑 `/api/cart-sync/import`。
+排查“扩展导入成功，但页面没有落单”时，应先确认是桥接阶段失败，还是页面逐条调用标准订单 API 失败，而不是默认怀疑 `/api/cart-sync/import`。
 
 ## 安全与边界
 

wiki/dev-guide/key-files.md

@@ -1,6 +1,6 @@
 # 关键文件索引
 
-本页不是简单列文件名，而是说明“遇到某类问题时，优先看哪几个文件，为什么先看它们”。
+本页不是简单列文件名，而是说明“遇到某类问题时，优先看哪些文件，以及它们为何排在前面”。
 
 ## 启动与运行边界
 

wiki/dev-guide/principal-guide.md

@@ -17,7 +17,7 @@
 - Redis 是加速层，不是事实源。当前项目把会话失效通知、登录限流和跨进程 SSE 放在 Redis 上，但就算 Redis 退化，SQLite 仍是业务主数据源。
 - 公共账号不是“弱权限用户”，而是专门受限身份。它在导入、建单等路径上会被显式拒绝。
 
-## 先看什么，才能最快进入状态
+## 快速进入状态的阅读顺序
 
 - 运行边界：<InlineCodeRef href="https://github.com/hzb666/LabStorageManager/blob/main/app/main.py" />、<InlineCodeRef href="https://github.com/hzb666/LabStorageManager/blob/main/frontend/src/main.tsx" />
 - 数据基线：<InlineCodeRef href="https://github.com/hzb666/LabStorageManager/blob/main/app/database.py" />、<InlineCodeRef href="https://github.com/hzb666/LabStorageManager/blob/main/app/services/pinyin_utils.py" />、<InlineCodeRef href="https://github.com/hzb666/LabStorageManager/blob/main/app/services/internal_code.py" />
@@ -54,7 +54,7 @@
 
 - 列表里数据旧，但刷新后正确：优先查短 TTL 缓存和 SSE stale 处理。
 - 到货后找不到库存：优先查 `reagent_orders_workflow.py` 的确认到货/入库分支。
-- 被踢下线但页面还挂着：优先查 `auth.invalid` 事件、`triggerSessionInvalidation` 和当前会话 token hash。
+- 会话被强制下线但页面仍停留在当前状态：优先查 `auth.invalid` 事件、`triggerSessionInvalidation` 和当前会话 token hash。
 - 扩展导入打开了页面但没有批次：优先查 bridge、批次 TTL 和 `batch_id`。
 
 ## 接手时容易漏掉的点

wiki/dev-guide/zero-to-hero.md

@@ -34,7 +34,7 @@
 4. 提交一条耗材订单，完成审批并标记完成。
 5. 走一遍库存借用 -> 归还链路，并观察列表是否通过 SSE 提示刷新。
 
-如果你能把这五步分别对应到模型、API、页面和 SSE 事件房间，后面再看代码就不会只停留在文件名层面。
+若能把这五步分别对应到模型、API、页面和 SSE 事件房间，后续阅读代码时就不会只停留在文件名层面。
 
 ## 第四阶段：补一遍外部导入链路
 

wiki/overview/tech-stack.md

@@ -137,13 +137,13 @@ flowchart LR
 | 后端启动 | `python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000` |
 | 前端启动 | `cd frontend && npm run dev` |
 
-## 继续看哪一页
+## 相关主题
 
-- 想看代码目录怎么分：去 [目录结构](/overview/directory-structure)
-- 想看接口怎么组织：去 [API 边界与导航](/overview/api-boundary)
-- 想看后端职责：去 [后端服务地图](/backend/service-map)
-- 想看前端基础设施：去 [前端 Hooks](/frontend/hooks) 和 [前端 Lib 工具箱](/frontend/lib-overview)
-- 想看数据库实体：去 [数据模型](/database/data-model) 和 [字段参考](/database/field-reference)
+- 代码目录划分：参见 [目录结构](/overview/directory-structure)
+- 接口组织方式：参见 [API 边界与导航](/overview/api-boundary)
+- 后端职责分层：参见 [后端服务地图](/backend/service-map)
+- 前端基础设施：参见 [前端 Hooks](/frontend/hooks) 和 [前端 Lib 工具箱](/frontend/lib-overview)
+- 数据库实体与字段：参见 [数据模型](/database/data-model) 和 [字段参考](/database/field-reference)
 
 ## 参考代码
 - [app/core/auth.py](https://github.com/hzb666/LabStorageManager/blob/main/app/core/auth.py)

wiki/user-guide/account-and-support.md

@@ -1,6 +1,6 @@
 # 账户、公告与使用支持
 
-本页主要讲三件事：个人账户怎么管、公告怎么看、常见问题怎么先判断。
+本页主要覆盖三类内容：个人账户管理、公告查看方式和常见问题的初步判断。
 
 ## 个人账户页
 
@@ -29,7 +29,7 @@
 
 ### 头像怎么处理
 
-你可以上传头像，也可以删除头像。上传后通常会先看到预览，再完成保存。
+支持上传和删除头像。上传后通常会先显示预览，再完成保存。
 
 ## 修改密码
 
@@ -55,15 +55,15 @@
 - 首次登录时间
 - 当前设备标记
 
-### 你可以做什么
+### 可执行操作
 
 #### 重命名设备
 
-你可以给设备起更容易认的名字，比如实验室电脑、办公室电脑或个人笔记本。这样以后查起来更方便。
+可为设备设置更易识别的名称，例如实验室电脑、办公室电脑或个人笔记本，便于后续区分。
 
 #### 踢出单个设备
 
-如果某台设备不该继续登录，可以直接把它踢下线。踢出后，那台设备要重新登录才能继续用。
+如果某台设备不应继续保持登录状态，可直接将其下线。下线后，该设备需要重新登录才能继续使用。
 
 常见场景包括：
 
@@ -75,7 +75,7 @@
 
 这个操作会保留当前设备，只清掉其他设备。常见于：
 
-- 改完密码后顺手清理旧会话
+- 改完密码后同步清理旧会话
 - 共享电脑比较多，需要统一收口
 
 #### 刷新会话
@@ -86,7 +86,7 @@
 
 系统对设备和 IP 数量会有一定限制，用来保护账号安全。如果超限，通常需要先清理旧设备或旧会话。
 
-## 公告怎么看
+## 公告查看方式
 
 公告有两个常见入口：
 
@@ -101,7 +101,7 @@
 
 如果某条公告后来又变回未读，通常说明公告内容更新过了。
 
-### 公告列表里通常能看到什么
+### 公告列表常见内容
 
 - 标题
 - 日期
@@ -115,7 +115,7 @@
 
 顶部横幅只会显示已经置顶、而且当前可见的公告。
 
-你可以把它理解成“当前最重要的提醒”。如果你把它关掉，它只是暂时不显示，不代表以后不会再出现。
+可将其理解为“当前最重要的提醒”。关闭后仅为暂时隐藏，不代表后续不会再次出现。
 
 ## 公告详情
 
@@ -145,27 +145,27 @@
 - 忘记密码
 - 共享电脑上还留着登录
 
-### 共享电脑上先做什么
+### 共享电脑使用建议
 
 - 用完后主动退出。
 - 定期看一下设备列表。
 - 不要把公用账户当成真实借用人。
 
-### 跳回登录页是什么意思
+### 自动返回登录页的含义
 
 通常表示当前会话已经失效，不一定是页面坏了。
 
 ## 使用建议
 
-如果你是普通用户，建议这样做：
+普通用户建议按以下方式处理：
 
 - 改用户名后记住新的登录名。
 - 定期检查设备列表，清理不再使用的设备。
 - 重要公告尽量点开看全文。
 - 在共享终端上，尽量用“踢出其他设备”收尾。
 
-如果你是管理员，个人账户页也很重要：
+管理员也应关注个人账户页：
 
 - 定期检查自己的设备列表。
-- 改密码后顺手清理其他设备。
+- 改密码后同步清理其他设备。
 - 设备重命名可以帮你更快分辨不同终端。