docs: 重画系统架构图——单脊柱布局替代五线乌鸦脚，补 Redis 节点

客户端五端收进分组条（单一竖线入 nginx），标签白底不再压线，
nginx 泳道排满不留空带，MySQL/Redis 并排（jiu_redis 上线后架构图欠账）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o

.claude/commands/release.md

@@ -40,7 +40,7 @@ export PATH="/opt/homebrew/bin:$PATH"
   ```
 - **client**：
   ```bash
-  cd client && flutter analyze --no-fatal-infos --no-fatal-warnings
+  cd client && flutter analyze --no-fatal-infos --no-fatal-warnings && flutter test
   ```
 - **site**：
   ```bash

.gitea/workflows/checks.yml

@@ -1,8 +1,9 @@
 name: Design Source Checks
 
 # 设计真相源检查（治理规则见 CLAUDE.md「设计真相源分层」）：
-# PR 与合并 main 时自动跑四道闸，全部纯静态检查（node + dart format），
-# 不跑 golden/fidelity（重型像素闸维持「定期体检」定位，本地手动跑）。
+# PR 与合并 main 时自动跑：四道静态闸（node + dart format）+ flutter test
+# （单测 + golden ×3 主题回归自比，2026-07-07 纳入——此前 DoD 写了但无闸）。
+# fidelity 重型像素闸维持「定期体检」定位，本地手动跑。
 on:
   pull_request:
   push:
@@ -23,7 +24,7 @@ jobs:
         run: sh scripts/ci/provision-mac.sh
 
       - name: 原型设计系统闸（check-ds 12 道）
-        run: node .superpowers/prototype/tools/check-ds.mjs
+        run: node design/prototype/tools/check-ds.mjs
 
       - name: L1 真相源同源闸（tokens 快照 / icons / 官网 token 值 / web hex）
         run: node tools/check-l1-sync.mjs
@@ -37,3 +38,8 @@ jobs:
           node tool/gen_tokens.mjs
           dart format lib/core/theme/app_tokens.g.dart lib/core/theme/app_dims.g.dart lib/core/theme/app_chrome.g.dart
           git diff --exit-code -- lib/core/theme/app_tokens.g.dart lib/core/theme/app_dims.g.dart lib/core/theme/app_chrome.g.dart
+
+      - name: Flutter 测试（单测 + golden ×3 主题回归自比）
+        run: |
+          cd client
+          flutter test

.gitignore

@@ -67,10 +67,8 @@ backend/gencode
 # iOS 证书私钥（绝不入库）
 .ios-certs/
 
-# superpowers 工作目录：brainstorm/sdd 是草稿不入库；
-# prototype 是设计像素真源 + 设计系统守门闸（check-ds.mjs），入库供 CI 跑。
-.superpowers/*
-!.superpowers/prototype/
+# superpowers 工作目录（草稿不入库）。原型已迁 design/prototype/（2026-07-07）。
+.superpowers/
 
 # design-distill 保真目检对比图（可重生，见 tools/ds-compare.mjs）
 design/_compare/

CHANGELOG-client.md

@@ -5,6 +5,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.7] - 2026-07-07
+
+### 新功能
+- 库存列表列头排序：点击 库存 / 成本价 / 总价 / 生产日期 / 入库时间 列头
+  即可全局排序（升序 ↑ / 降序 ↓ / 再点恢复默认）。
+
+### 改进
+- 库存筛选全部移到工具栏（与出库管理同一形式）：规格 / 系列 / 仓库 / 状态
+  改为工具栏下拉标签，可单独清除；列头不再放筛选漏斗。
+
+## [1.1.6] - 2026-07-07
+
+### 新功能
+- 库存三态管理：状态列改为「在售 / 库存 / 已售」。商品详情抽屉的状态徽章旁
+  新增开关，一键把商品挂上/撤下公开酒单（桌面与手机都支持）；只有挂「在售」
+  的商品才会出现在店铺公开页。
+- 卖光的商品以「已售」留痕：点库存页「已售」统计卡查看，平时列表不显示。
+
+### 改进
+- 库存筛选改为「全部 / 在售 / 库存 / 已售」；低库存提示改由数量颜色标注
+  （红=缺货、橙=低于安全库存）。
+
 ## [1.1.5] - 2026-07-06
 
 ### 新功能

CHANGELOG-server.md

@@ -5,6 +5,12 @@
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.11] - 2026-07-07
+
+### 新功能
+- 库存列表支持按 库存 / 成本价 / 总价 / 生产日期 / 入库时间 排序，
+  全局生效（跨分页），成本类按显示口径排序结果一致。
+
 ## [1.1.10] - 2026-07-07
 
 ### 新功能

CLAUDE.md

@@ -257,7 +257,7 @@ cd client && flutter test
 
 ### 设计真相源分层（原型漂移治理，2026-07-04 拍板）
 
-原型（`.superpowers/prototype/`）与真实页面**不追求全量永久同步**，按层分治：
+原型（`design/prototype/`）与真实页面**不追求全量永久同步**，按层分治：
 
 - **L1 设计系统层**（`tokens.css` / `atoms.css` / `mobile-atoms.css` / `icons.js` + `index.html` 登记）：原型是**单一真源**。新增颜色/组件/图标必须**先登记原型再同步**代码与官网（如 `web/_includes/icons.njk`）。闸：pre-commit `check-ds.mjs` 12 道（本地钩子，新机器先跑 `sh scripts/hooks/install.sh`）+ 代码侧 `client/tool/check_ds_code.mjs`。
 - **L2 屏级三态**（台账 = `design/CONTRACT.md` 块 4「真相源」列）：
@@ -268,16 +268,16 @@ cd client && flutter test
 - **漂移体检**：不逐提交强制同步；大版本/整屏改版前跑 `node tools/fidelity.mjs`，按报告逐屏决定「重新对齐原型」或「降级快照」，结果回填 CONTRACT。
 - **CI 闸**（`.gitea/workflows/checks.yml`，PR + main push 自动跑）：① `check-ds.mjs` 原型 12 道；② `tools/check-l1-sync.mjs` L1 同源四道（tokens 快照逐字节 / icons 两端同集同内容 / 官网 token 值对齐原型主题 A / web 硬编码 hex，白名单 #fff、#1677ff，`ds-allow` 可豁免）；③ `client/tool/check_ds_code.mjs` Flutter 颜色单源；④ codegen 新鲜度（regen→`dart format`→与入库产物零 diff）。本地可直接跑同名命令。
 
-### 表格与列头筛选（ds 真相源）
-- 列表屏统一 `DsTable`（`widgets/ds/ds_table.dart`：toolbar+表格+pager 连成一卡），列定义 `DsColumn`，可筛选列走其列头漏斗（`filtered` 态高亮），可隐藏列走列设置菜单
-- 不要在 toolbar 放独立筛选按钮，筛选入口内嵌列头或工具栏 `DsChip`
+### 表格与筛选/排序（ds 真相源）
+- 列表屏统一 `DsTable`（`widgets/ds/ds_table.dart`：toolbar+表格+pager 连成一卡），列定义 `DsColumn`，可隐藏列走列设置菜单
+- **筛选统一放工具栏 `DsChip`**（2026-07-07 用户口径，形式参照出库管理：单选/多选 chip + 选中值/N 项摘要 + × 单清）；列头**只放排序** `DsSortHeader`（点击循环 无→升→降→无，服务端全局排序）。列头漏斗 `DsFilterHeader` 已退役删除
 - 旧 `FilterableColumnHeader`/`multi_select_dropdown.dart` 仅存量引用，勿在新屏使用
 
 ### 响应式 / 移动端适配
 - 断点判定统一用 `context.isMobile`（`client/lib/core/responsive/responsive.dart`，宽度 < 600 为窄屏/手机），**禁止**在各处散落 `MediaQuery.width < 600` 这类魔法数
-- **列表屏**：统一用 `DsTable`（`widgets/ds/ds_table.dart`，真相源表格：toolbar+列+pager）；窄屏卡片流复用 `MobileListCard` / `MobileCardField`（`widgets/mobile_list_card.dart`）。旧 `DataTableCard` 已删除（2026-07-03），勿再引用
+- **列表屏**：统一用 `DsTable`（`widgets/ds/ds_table.dart`，真相源表格：toolbar+列+pager）；窄屏卡片流用 `MCard`（`widgets/ds/m_card.dart`，镜像原型 mobile-atoms）。旧 `MobileListCard` 为 legacy 仅存量引用（迁移在 todo），旧 `DataTableCard` 已删除（2026-07-03），勿再引用
 - **弹窗固定宽度**：一律用 `context.dialogWidth(X)`（≤ 屏宽 92%），**禁止**裸写 `width: <固定值>` 导致窄屏溢出
-- **导航**：窄屏（手机）用 Drawer 抽屉（`app_shell.dart`），宽屏保持侧边栏；新增页面无需单独处理，挂在 shell 下即可
+- **导航**：窄屏（手机）= 底部 5 tab（库存/入库/出库/财务/我的）+「我的」hub 聚合二级屏（`app_shell.dart` + `m_tab_bar.dart`，2026-07-04 起，Drawer 已退役）；宽屏保持侧边栏；一切弹层窄屏统一走 `showMSheet` 底部 sheet
 - 平台判断仍遵守上面「前端平台判断」规则（`kIsWeb` 先于 `dart:io`）
 
 ### 权限中间件（已全局挂载）

backend/internal/handler/inventory.go

@@ -158,6 +158,23 @@ func (h *InventoryHandler) List(c *gin.Context) {
 		return
 	}
 
+	// 排序（2026-07-07 列头排序）：白名单列 → SQL 表达式，防注入；带 id 兜底保证分页稳定。
+	// cost/price/prod_date 用与 SELECT 相同的 COALESCE 口径，排序结果与显示一致。
+	orderExpr := "inv.id DESC"
+	if sortCol, ok := map[string]string{
+		"qty":       "inv.quantity",
+		"cost":      "COALESCE(sii.cost_price, inv.unit_price, p.purchase_price)",
+		"price":     "inv.quantity * COALESCE(sii.cost_price, inv.unit_price, p.purchase_price)",
+		"prod_date": "COALESCE(DATE(sii.production_date), DATE(inv.production_date))",
+		"in_time":   "inv.created_at",
+	}[c.Query("sort_by")]; ok {
+		dir := "ASC"
+		if c.Query("sort_dir") == "desc" {
+			dir = "DESC"
+		}
+		orderExpr = sortCol + " " + dir + ", inv.id DESC"
+	}
+
 	// Data query
 	dataSQL := `
 		SELECT
@@ -183,7 +200,7 @@ func (h *InventoryHandler) List(c *gin.Context) {
 		LEFT JOIN products p ON p.id = inv.product_id AND p.deleted_at IS NULL
 		LEFT JOIN warehouses w ON w.id = inv.warehouse_id
 		WHERE ` + baseWhere + `
-		ORDER BY inv.id DESC
+		ORDER BY ` + orderExpr + `
 		LIMIT ? OFFSET ?`
 
 	dataArgs := append(args, pageSize, (page-1)*pageSize)

backend/internal/handler/inventory_test.go

@@ -3,6 +3,7 @@ package handler
 import (
 	"fmt"
 	"net/http"
+	"net/http/httptest"
 	"testing"
 	"time"
 
@@ -525,3 +526,44 @@ func TestInventoryHandler_StatusTenantIsolation(t *testing.T) {
 	require.NoError(t, db.Where("id = ?", invB.ID).First(&got).Error)
 	assert.Equal(t, "stock", got.Status)
 }
+
+// 列头排序（2026-07-07）：白名单列全局排序，非法列忽略回默认
+func TestInventoryHandler_ListSort(t *testing.T) {
+	db := testutil.SetupTestDB()
+	shop := testutil.CreateTestShop(db, "INV_SORT")
+	user := testutil.CreateTestUser(db, shop.ID, "admin", "pass", "admin")
+	wh := testutil.CreateTestWarehouse(db, shop.ID, "仓")
+	token := getAuthToken(user.ID, shop.ID, "admin")
+	r := setupProtectedRouter(db)
+
+	for i, qty := range []float64{5, 20, 10} {
+		p := testutil.CreateTestProduct(db, shop.ID, fmt.Sprintf("酒%d", i))
+		price := float64(100 * (i + 1))
+		require.NoError(t, db.Create(&model.Inventory{
+			ShopID: shop.ID, WarehouseID: &wh.ID, ProductID: &p.ID,
+			Quantity: qty, UnitPrice: &price,
+		}).Error)
+	}
+
+	qtys := func(w *httptest.ResponseRecorder) []float64 {
+		rows := parseResponse(w)["data"].([]interface{})
+		out := make([]float64, len(rows))
+		for i, r := range rows {
+			out[i] = r.(map[string]interface{})["quantity"].(float64)
+		}
+		return out
+	}
+
+	// qty 升序
+	w := makeRequest(r, "GET", "/api/v1/inventory?sort_by=qty&sort_dir=asc", token, nil)
+	assert.Equal(t, []float64{5, 10, 20}, qtys(w))
+	// qty 降序
+	w = makeRequest(r, "GET", "/api/v1/inventory?sort_by=qty&sort_dir=desc", token, nil)
+	assert.Equal(t, []float64{20, 10, 5}, qtys(w))
+	// 总价 = qty×进价：5×100=500, 20×200=4000, 10×300=3000 → 升序 5,10,20
+	w = makeRequest(r, "GET", "/api/v1/inventory?sort_by=price&sort_dir=asc", token, nil)
+	assert.Equal(t, []float64{5, 10, 20}, qtys(w))
+	// 非法列忽略 → 默认 id 倒序（最后插入的 qty=10 在前）
+	w = makeRequest(r, "GET", "/api/v1/inventory?sort_by=evil;drop", token, nil)
+	assert.Equal(t, []float64{10, 20, 5}, qtys(w))
+}

backend/internal/handler/templates/public_product.html

@@ -6,7 +6,7 @@
 <title>{{.PageTitle}}</title>{{.OGTags}}
 <style>
   /* 设计系统单一真源：变量名与三主题（a 经典蓝浅 / b 琥珀深 / c 酒窖暖浅）色值
-     逐字取自 .superpowers/prototype/tokens.css。SSR 页自包含无法直接引 tokens.css，
+     逐字取自 design/prototype/tokens.css。SSR 页自包含无法直接引 tokens.css，
      改配色须先改原型令牌再同步此处。--glow/--seal-bg 为本页派生变量（主色低透明度/表面高透明度）。 */
   :root{
     --r-md:6px; --r-lg:10px; --r-xl:14px; --r-pill:999px;

backend/internal/handler/templates/public_shop.html

@@ -5,7 +5,7 @@
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>{{.PageTitle}}</title>{{.OGTags}}
 <style>
-  /* 设计系统单一真源：变量名与三主题（a/b/c）色值逐字取自 .superpowers/prototype/tokens.css。
+  /* 设计系统单一真源：变量名与三主题（a/b/c）色值逐字取自 design/prototype/tokens.css。
      与商品公开页同族；改配色须先改原型令牌再同步此处。--glow 为本页派生变量（主色低透明度）。 */
   :root{
     --r-md:6px; --r-lg:10px; --r-xl:14px; --r-pill:999px;

client/lib/providers/inventory_provider.dart

@@ -31,6 +31,8 @@ class InventoryListNotifier extends AsyncNotifier<PageResult<Inventory>> {
   String _keyword = '';
   String _code = ''; // 商品编码独立筛选（原型 codeInput）
   String _status = ''; // 三态筛选（空=后端默认排除已售）
+  String _sortBy = ''; // 列头排序（空=默认 id 倒序）
+  bool _sortAsc = true;
   List<String> _series = [];
   List<String> _spec = [];
   PageResult<Inventory>? _cache;
@@ -55,6 +57,8 @@ class InventoryListNotifier extends AsyncNotifier<PageResult<Inventory>> {
           keyword: _keyword.isEmpty ? null : _keyword,
           code: _code.isEmpty ? null : _code,
           status: _status.isEmpty ? null : _status,
+          sortBy: _sortBy.isEmpty ? null : _sortBy,
+          sortAsc: _sortAsc,
           series: _series.isEmpty ? null : _series,
           spec: _spec.isEmpty ? null : _spec,
           page: _page,
@@ -97,6 +101,13 @@ class InventoryListNotifier extends AsyncNotifier<PageResult<Inventory>> {
     reload();
   }
 
+  void setSort(String sortBy, bool asc) {
+    _sortBy = sortBy;
+    _sortAsc = asc;
+    _page = 1;
+    reload();
+  }
+
   void setSeries(List<String> series) {
     _series = series;
     _page = 1;

client/lib/repositories/inventory_repository.dart

@@ -17,6 +17,8 @@ class InventoryRepository {
     List<String>? series,
     List<String>? spec,
     String? status, // 三态筛选：stock/on_sale/sold（逗号可多值）；空=后端默认（排除已售）
+    String? sortBy, // 列头排序：qty/cost/price/prod_date/in_time（后端白名单）
+    bool sortAsc = true,
     int page = 1,
     int pageSize = 50,
   }) async {
@@ -31,6 +33,10 @@ class InventoryRepository {
         if (series != null && series.isNotEmpty) 'series': series.join(','),
         if (spec != null && spec.isNotEmpty) 'spec': spec.join(','),
         if (status != null && status.isNotEmpty) 'status': status,
+        if (sortBy != null && sortBy.isNotEmpty) ...{
+          'sort_by': sortBy,
+          'sort_dir': sortAsc ? 'asc' : 'desc',
+        },
       };
       final resp = await _client.get('/inventory', params: params);
       return PageResult.fromJson(

client/lib/screens/inventory/inventory_list_screen.dart

@@ -141,6 +141,34 @@ class _InventoryListScreenState extends ConsumerState<InventoryListScreen> {
         .setStatus(_statusParam[label] ?? '');
   }
 
+  // ── 列头排序（点击循环 无→升→降→无，服务端全局排序） ──
+  String _sortBy = ''; // 列 key（屏内），空=未排序
+  bool _sortAsc = true;
+  static const _sortParam = {
+    'qty': 'qty',
+    'cost': 'cost',
+    'price': 'price',
+    'prodDate': 'prod_date',
+    'inTime': 'in_time',
+  };
+
+  void _toggleSort(String key) {
+    setState(() {
+      if (_sortBy != key) {
+        _sortBy = key;
+        _sortAsc = true;
+      } else if (_sortAsc) {
+        _sortAsc = false;
+      } else {
+        _sortBy = '';
+        _sortAsc = true;
+      }
+    });
+    ref
+        .read(inventoryListProvider.notifier)
+        .setSort(_sortBy.isEmpty ? '' : _sortParam[_sortBy]!, _sortAsc);
+  }
+
   // 成本仅管理员可见（与出库同口径）：非管理员隐藏成本价/总价列、卡片单价、货值 KPI。
   bool get _isAdmin => ref.watch(isAdminProvider);
   bool _colAllowed(ColDef c) =>
@@ -178,7 +206,25 @@ class _InventoryListScreenState extends ConsumerState<InventoryListScreen> {
     if (v != null && mounted) _applyStatusFilter(v);
   }
 
-  // ── 多选漏斗（规格/系列/仓库） ──
+  // ── 工具栏多选 chip（规格/系列/仓库，2026-07-07 从列头漏斗上移） ──
+  Widget _multiChip(String label, List<String> options, Set<String> selected,
+      ValueChanged<Set<String>> onChanged) {
+    return Builder(
+      builder: (chipCtx) => DsChip(
+        label: label,
+        value: selected.isEmpty
+            ? null
+            : selected.length == 1
+                ? selected.first
+                : '${selected.length} 项',
+        onTap: () => _openMultiFilter(chipCtx,
+            options: options, selected: selected, onChanged: onChanged),
+        onClear: () => onChanged({}),
+      ),
+    );
+  }
+
+  // ── 多选菜单（规格/系列/仓库，chip 锚定） ──
   void _openMultiFilter(
     BuildContext anchorContext, {
     required List<String> options,
@@ -880,11 +926,40 @@ class _InventoryListScreenState extends ConsumerState<InventoryListScreen> {
                         );
                       }
 
-                      // 桌面 toolbar：合一搜索框 + 重置
-                      // （状态筛选 chip 已按用户口径删除，状态列漏斗保留）
+                      // 桌面 toolbar：搜索 + 筛选 chips + 重置
+                      // （2026-07-07 用户口径反转：筛选全部上移工具栏，形式
+                      //  参照出库管理；列头只留排序，漏斗退役）
                       return Row(
                         children: [
                           SizedBox(width: 260, child: searchField),
+                          const SizedBox(width: AppDims.sp2),
+                          _multiChip('规格', specOptions, _filterSpec, (v) {
+                            setState(() => _filterSpec = v);
+                            ref
+                                .read(inventoryListProvider.notifier)
+                                .setSpec(v.toList());
+                          }),
+                          const SizedBox(width: AppDims.sp2),
+                          _multiChip('系列', seriesOptions, _filterSeries, (v) {
+                            setState(() => _filterSeries = v);
+                            ref
+                                .read(inventoryListProvider.notifier)
+                                .setSeries(v.toList());
+                          }),
+                          const SizedBox(width: AppDims.sp2),
+                          _multiChip('仓库', warehouseOptions, _filterWarehouse,
+                              (v) => setState(() => _filterWarehouse = v)),
+                          const SizedBox(width: AppDims.sp2),
+                          Builder(
+                            builder: (chipCtx) => DsChip(
+                              label: '状态',
+                              value: _statusFilter == '全部'
+                                  ? null
+                                  : _statusFilter,
+                              onTap: () => _openStatusMenu(chipCtx),
+                              onClear: () => _applyStatusFilter('全部'),
+                            ),
+                          ),
                           const Spacer(),
                           DsButton('重置', small: true, onPressed: _clearFilters),
                         ],
@@ -899,45 +974,18 @@ class _InventoryListScreenState extends ConsumerState<InventoryListScreen> {
                     },
                     emptyText: '没有匹配的商品 · 试试调整筛选或搜索',
                     columns: visibleCols.map((c) {
+                      // 筛选已全部上移工具栏 chips（2026-07-07），列头只留排序。
                       final Widget? header = switch (c.key) {
-                        'spec' => DsFilterHeader(
+                        // 可排序列（原型 COLS sort:true，服务端全局排序）
+                        'qty' ||
+                        'cost' ||
+                        'price' ||
+                        'prodDate' ||
+                        'inTime' =>
+                          DsSortHeader(
                             label: c.label,
-                            filtered: _filterSpec.isNotEmpty,
-                            onOpen: (bctx) => _openMultiFilter(bctx,
-                                options: specOptions,
-                                selected: _filterSpec, onChanged: (v) {
-                              setState(() => _filterSpec = v);
-                              ref
-                                  .read(inventoryListProvider.notifier)
-                                  .setSpec(v.toList());
-                            }),
-                          ),
-                        'series' => DsFilterHeader(
-                            label: c.label,
-                            filtered: _filterSeries.isNotEmpty,
-                            onOpen: (bctx) => _openMultiFilter(bctx,
-                                options: seriesOptions,
-                                selected: _filterSeries, onChanged: (v) {
-                              setState(() => _filterSeries = v);
-                              ref
-                                  .read(inventoryListProvider.notifier)
-                                  .setSeries(v.toList());
-                            }),
-                          ),
-                        'warehouse' => DsFilterHeader(
-                            label: c.label,
-                            filtered: _filterWarehouse.isNotEmpty,
-                            onOpen: (bctx) => _openMultiFilter(bctx,
-                                options: warehouseOptions,
-                                selected: _filterWarehouse,
-                                onChanged: (v) =>
-                                    setState(() => _filterWarehouse = v)),
-                          ),
-                        // 原型 COLS 里带 filter 的列只有状态（单选）。
-                        'status' => DsFilterHeader(
-                            label: c.label,
-                            filtered: _statusFilter != '全部',
-                            onOpen: _openStatusMenu,
+                            ascending: _sortBy == c.key ? _sortAsc : null,
+                            onTap: () => _toggleSort(c.key),
                           ),
                         _ => null,
                       };

client/lib/widgets/ds/ds_table.dart

@@ -479,38 +479,49 @@ class _DsTableState extends State<DsTable> {
   }
 }
 
-/// 原型 thead th .fh 漏斗列头：label + funnel(12, sw1.6)，有筛选值时整体 primary。
-/// 点击回调携带列头自身 BuildContext（供 showDsMenu 锚定）。
-class DsFilterHeader extends StatelessWidget {
+/// 原型 thead th .sh 排序列头（2026-07-07 登记）：label + 方向箭头。
+/// 未排序 = 淡 chevron-down 暗示可排；激活整体 primary，asc=↑ / desc=↓。
+/// 点击由调用方循环 无→升→降→无（服务端全局排序）。
+class DsSortHeader extends StatelessWidget {
   final String label;
-  final bool filtered;
-  final void Function(BuildContext anchorContext) onOpen;
-  const DsFilterHeader(
-      {super.key,
-      required this.label,
-      required this.filtered,
-      required this.onOpen});
+
+  /// null = 未按本列排序；true = 升序；false = 降序
+  final bool? ascending;
+  final VoidCallback onTap;
+  const DsSortHeader(
+      {super.key, required this.label, this.ascending, required this.onTap});
 
   @override
   Widget build(BuildContext context) {
     final t = context.tokens;
-    final color = filtered ? t.primary : t.muted;
-    return Builder(
-      builder: (bctx) => InkWell(
-        onTap: () => onOpen(bctx),
-        child: Row(
-          mainAxisSize: MainAxisSize.min,
-          children: [
-            Text(label,
-                style: TextStyle(
-                    fontSize: AppDims.fsSm,
-                    fontWeight: FontWeight.w600,
-                    color: color)),
-            const SizedBox(width: 5),
-            Icon(LucideIcons.funnel, size: 12, color: color),
-          ],
-        ),
+    final on = ascending != null;
+    final color = on ? t.primary : t.muted;
+    return InkWell(
+      onTap: onTap,
+      child: Row(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          Text(label,
+              style: TextStyle(
+                  fontSize: AppDims.fsSm,
+                  fontWeight: FontWeight.w600,
+                  color: color)),
+          const SizedBox(width: 4),
+          Opacity(
+            opacity: on ? 1 : .45,
+            child: Icon(
+              ascending == true
+                  ? LucideIcons.chevronUp
+                  : LucideIcons.chevronDown,
+              size: 12,
+              color: color,
+            ),
+          ),
+        ],
       ),
     );
   }
 }
+
+// DsFilterHeader（列头漏斗筛选）已于 2026-07-07 退役删除：筛选统一上移工具栏
+// chips（用户口径，形式参照出库管理），列头仅保留 DsSortHeader 排序。

client/lib/widgets/mobile_list_card.dart

@@ -1,6 +1,11 @@
 import 'package:flutter/material.dart';
 import '../core/theme/context_tokens.dart';
 
+// ⚠️ LEGACY（2026-07-07 标注）：本组件为旧移动卡片范式（label:value 竖排字段），
+// 新范式 = widgets/ds/m_card.dart 的 MCard（镜像原型 mobile-atoms .m-card，
+// 图标徽章 + 双栏紧凑）。**新屏禁用本组件，一律用 MCard**；存量 6 屏
+// （出入库录单/往来/盘点/基础数据/财务）迁移已登记 todo，迁完删除本文件。
+
 /// 移动端列表卡片的单个字段（label: value）。
 class MobileCardField {
   final String label;

client/test/golden/product_detail_golden_test.dart

@@ -52,6 +52,8 @@ class _FakeInvRepo implements InventoryRepository {
     List<String>? series,
     List<String>? spec,
     String? status,
+    String? sortBy,
+    bool sortAsc = true,
     int page = 1,
     int pageSize = 50,
   }) async =>

client/test/stock_out_insufficient_stock_flow_test.dart

@@ -100,6 +100,8 @@ class _FakeInventoryRepository extends InventoryRepository {
     List<String>? series,
     List<String>? spec,
     String? status,
+    String? sortBy,
+    bool sortAsc = true,
     int page = 1,
     int pageSize = 50,
   }) async {

design/CONTRACT.md

@@ -11,11 +11,11 @@
 
 | 项 | 位置 | 说明 |
 |---|---|---|
-| token 单源 | `.superpowers/prototype/tokens.css` | 三主题 `[data-theme=a/b/c]`，已 snapshot 到 `client/lib/core/theme/token_source/tokens.css` |
+| token 单源 | `design/prototype/tokens.css` | 三主题 `[data-theme=a/b/c]`，已 snapshot 到 `client/lib/core/theme/token_source/tokens.css` |
 | token codegen | `client/lib/core/theme/tool/gen_tokens.mjs` → `app_tokens.g.dart` | 单源生成，**禁手改**；`kTokensA/B/C` + `appTokensOf(key)` |
 | 实现层 | `themes.dart`（buildTheme）+ `context_tokens.dart`（`context.tokens`） | AppTokens ThemeExtension 挂三 ThemeData |
-| 原型清单 | `.superpowers/prototype/screens/*.html` | 桌面 + `m-*` 移动；viewport 桌面 1280×860 / 移动 390×844 |
-| 设计铁律 | `.superpowers/prototype/index.html`（atoms 注册）+ `tools/check-ds.mjs` 闸 | 颜色只走 token；组件出自已登记 atoms |
+| 原型清单 | `design/prototype/screens/*.html` | 桌面 + `m-*` 移动；viewport 桌面 1280×860 / 移动 390×844 |
+| 设计铁律 | `design/prototype/index.html`（atoms 注册）+ `tools/check-ds.mjs` 闸 | 颜色只走 token；组件出自已登记 atoms |
 | 验收工具 | `~/.claude/skills/design-distill/tools/{shoot-prototype,diff}.mjs` | prototype shoot 已验证三主题可出图 |
 
 ### 主题
@@ -206,7 +206,7 @@ AppTokens 目前**仅颜色**。原型还驱动：
 > - 关于：旧版 帮助文档/扫码防伪/系统信息 卡删除，构建号并入版本 cell；更新日志走 `/public/release`（与官网时间线同源），接口不可达回退只显当前版本。
 
 **验收法（HTML→Flutter 特例）**：HTML(Chromium) 与 Flutter 渲染器不同，**严格 0.1% pixelmatch 不适用跨渲染器**（见 design-distill `references/flutter-golden.md`）。本项目双闸：
-1. **保真闸（人工目检）**：`node tools/ds-compare.mjs --html .superpowers/prototype/screens/<screen>.html --prefix <prefix>` → 截原型基准 + 与 Flutter golden 用 montage 并排 → `design/_compare/`。
+1. **保真闸（人工目检）**：`node tools/ds-compare.mjs --html design/prototype/screens/<screen>.html --prefix <prefix>` → 截原型基准 + 与 Flutter golden 用 montage 并排 → `design/_compare/`。
 2. **回归闸（自动）**：`test/golden/<screen>_golden_test.dart` 走 `pumpGolden`/`goldenAcrossThemes`（`test/support/golden_harness.dart`）出 A/B/C 三主题 golden，入库随 `flutter test` 同渲染器自比，抓串色/漏 token。
 3. token 残留闸：`grep 0xFF…` 该屏为 0（颜色全走 `context.tokens`）。
 

design/prototype/atoms.css

@@ -135,6 +135,12 @@ th.act,td.act{width:78px;}
 thead th .fh{display:inline-flex; align-items:center; gap:5px; cursor:pointer;}
 thead th .fh.filtered{color:var(--primary);}
 .funnel{width:12px; height:12px; stroke-width:1.6;}
+/* 列头排序（2026-07-07）：label+方向箭头；未排序淡 chevron-down 暗示可排，激活整体 primary。
+   点击循环 无→升→降→无（服务端全局排序）。 */
+thead th .sh{display:inline-flex; align-items:center; gap:4px; cursor:pointer; user-select:none;}
+thead th .sh.on{color:var(--primary);}
+.sort-ic{width:12px; height:12px; stroke-width:2;}
+thead th .sh:not(.on) .sort-ic{opacity:.45;}
 tbody td{padding:12px 14px; font-size:var(--fs-body); border-bottom:1px solid var(--border-subtle); color:var(--text); white-space:nowrap;}
 tbody tr:last-child td{border-bottom:none;}
 tbody tr.click{cursor:pointer;} tbody tr:hover{background:var(--row-hover);}

design/prototype/screens/inventory.html

@@ -57,8 +57,12 @@
           <div class="kpi alert click" onclick="filterStatus('已售')"><div class="ic ic-alert"><svg viewBox="0 0 24 24"><use href="#i-check"/></svg></div><div class="t">已售 · 点击筛选</div><div class="v">17</div><div class="d down">需补货 6 项</div></div>
         </div>
         <div class="toolbar">
-          <div class="searchbox"><svg viewBox="0 0 24 24"><use href="#i-search"/></svg><input id="searchInput" placeholder="商品名 / 拼音" oninput="state.q=this.value; state.page=1; render()"></div>
-          <div class="searchbox code"><svg viewBox="0 0 24 24"><use href="#i-search"/></svg><input id="codeInput" placeholder="商品编码" oninput="state.code=this.value; state.page=1; render()"></div>
+          <!-- 搜索合一（2026-07-07 用户口径）：名称/拼音/编码同框，与 Flutter 实现一致 -->
+          <div class="searchbox"><svg viewBox="0 0 24 24"><use href="#i-search"/></svg><input id="searchInput" placeholder="商品名 / 拼音 / 编码" oninput="state.q=this.value; state.page=1; render()"></div>
+          <!-- 2026-07-07 用户口径：筛选全部上移工具栏（参照出库管理），列头漏斗退役、只留排序 -->
+          <div class="chip" id="chipSpec" onclick="openDimFilter('spec',this)">规格 <span class="cv" id="specVal"></span><svg viewBox="0 0 24 24"><use href="#i-chevron-down"/></svg></div>
+          <div class="chip" id="chipSeries" onclick="openDimFilter('series',this)">系列 <span class="cv" id="seriesVal"></span><svg viewBox="0 0 24 24"><use href="#i-chevron-down"/></svg></div>
+          <div class="chip" id="chipWh" onclick="openDimFilter('wh',this)">仓库 <span class="cv" id="whVal"></span><svg viewBox="0 0 24 24"><use href="#i-chevron-down"/></svg></div>
           <div class="chip" id="chipStatus">状态 <span class="cv" id="statusVal"></span><svg viewBox="0 0 24 24"><use href="#i-chevron-down"/></svg></div>
           <div class="sp"></div>
           <div class="btn ghost sm" onclick="clearFilters()">重置</div>
@@ -113,19 +117,20 @@ const ITEMS=[
   {name:'水井坊 井台',code:'SJF-JT-500',spec:'500ml×6',series:'井台',batch:'PZ231209',cat:'浓香',qty:6,unit:'件',cost:'¥680',price:'¥4,080',prodDate:'2023-12-09',inDate:'2026-05-20',supplier:'四川水井坊',value:'¥4,100',status:'已售'},
 ];
 const STATUS=['全部','在售','库存','已售'];
-const COLS=[{key:'product',label:'商品',fixed:true},{key:'spec',label:'规格'},{key:'series',label:'系列'},{key:'batch',label:'批次号'},{key:'qty',label:'库存',num:true},{key:'cost',label:'成本价',num:true},{key:'price',label:'总价',num:true},{key:'prodDate',label:'生产日期'},{key:'inDate',label:'入库时间'},{key:'supplier',label:'供应商'},{key:'status',label:'状态',filter:'status'},{key:'act',label:'操作',fixed:true}];
-const state={q:'',code:'',status:'全部',page:1,perPage:10,hidden:new Set()};
+const COLS=[{key:'product',label:'商品',fixed:true},{key:'spec',label:'规格'},{key:'series',label:'系列'},{key:'batch',label:'批次号'},{key:'qty',label:'库存',num:true,sort:true},{key:'cost',label:'成本价',num:true,sort:true},{key:'price',label:'总价',num:true,sort:true},{key:'prodDate',label:'生产日期',sort:true},{key:'inDate',label:'入库时间',sort:true},{key:'supplier',label:'供应商'},{key:'status',label:'状态'},{key:'act',label:'操作',fixed:true}];
+const state={q:'',code:'',status:'全部',page:1,perPage:10,hidden:new Set(),sortBy:null,sortAsc:true};
 
 function setActive(k){ document.querySelectorAll('.nav[data-k]').forEach(e=>e.classList.toggle('active',e.dataset.k===k)); }
 function navTo(k){ setActive(k); const inv=document.querySelector('[data-view="inventory"]'), ph=document.querySelector('[data-view="placeholder"]'); if(k==='inventory'){inv.classList.add('active');ph.classList.remove('active');return;} inv.classList.remove('active');ph.classList.add('active'); const nav=NAVS.find(n=>n.k===k); document.getElementById('phTitle').textContent=nav.label; document.getElementById('phIcon').innerHTML=navSvg(nav.d); }
 
 function visibleCols(){ return COLS.filter(c=>!state.hidden.has(c.key)); }
-function filtered(){ return ITEMS.filter(it=>{ if(state.status!=='全部'&&it.status!==state.status)return false; if(state.q){const q=state.q.toLowerCase(); if(!it.name.toLowerCase().includes(q))return false;} if(state.code){const c=state.code.toLowerCase(); if(!it.code.toLowerCase().includes(c))return false;} return true; }); }
+function filtered(){ const rows=ITEMS.filter(it=>{ if(state.status!=='全部'&&it.status!==state.status)return false; if(state.spec&&it.spec!==state.spec)return false; if(state.series&&it.series!==state.series)return false; if(state.wh&&it.supplier!==state.wh)return false; if(state.q){const q=state.q.toLowerCase(); if(!it.name.toLowerCase().includes(q)&&!it.code.toLowerCase().includes(q))return false;} return true; }); if(state.sortBy&&SORT_VAL[state.sortBy]){const v=SORT_VAL[state.sortBy];rows.sort((a,b)=>{const x=v(a),y=v(b);return (x<y?-1:x>y?1:0)*(state.sortAsc?1:-1);});} return rows; }
 function render(){
   document.getElementById('statusVal').textContent=state.status==='全部'?'':state.status;
+  [['spec','chipSpec','specVal'],['series','chipSeries','seriesVal'],['wh','chipWh','whVal']].forEach(([k,cid,vid])=>{ document.getElementById(vid).textContent=state[k]||''; document.getElementById(cid).classList.toggle('on',!!state[k]); });
   document.getElementById('chipStatus').classList.toggle('on',state.status!=='全部');
   const cols=visibleCols();
-  document.getElementById('thead').innerHTML='<tr>'+cols.map(c=>{ const cls=(c.num?'num ':'')+(c.key==='act'?'act ':''); if(c.filter){const on=state.status!=='全部'; return `<th class="${cls}"><span class="fh ${on?'filtered':''}" onclick="openFilter('${c.filter}',this)">${c.label} <svg class="funnel" viewBox="0 0 24 24"><use href="#i-ic22"/></svg></span></th>`;} return `<th class="${cls}">${c.label}</th>`; }).join('')+'</tr>';
+  document.getElementById('thead').innerHTML='<tr>'+cols.map(c=>{ const cls=(c.num?'num ':'')+(c.key==='act'?'act ':''); if(c.filter){const on=state.status!=='全部'; return `<th class="${cls}"><span class="fh ${on?'filtered':''}" onclick="openFilter('${c.filter}',this)">${c.label} <svg class="funnel" viewBox="0 0 24 24"><use href="#i-ic22"/></svg></span></th>`;} if(c.sort){const on=state.sortBy===c.key; const ic=!on?'i-chevron-down':(state.sortAsc?'i-ic51':'i-chevron-down'); return `<th class="${cls}"><span class="sh ${on?'on':''}" onclick="toggleSort('${c.key}')">${c.label} <svg class="sort-ic" viewBox="0 0 24 24"><use href="#${ic}"/></svg></span></th>`;} return `<th class="${cls}">${c.label}</th>`; }).join('')+'</tr>';
   const rows=filtered(); const start=(state.page-1)*state.perPage; const pageRows=rows.slice(start,start+state.perPage); const tb=document.getElementById('tbody');
   if(rows.length===0){ tb.innerHTML=`<tr><td colspan="${cols.length}"><div class="empty">没有匹配的商品 · 试试调整筛选或搜索</div></td></tr>`; }
   else { tb.innerHTML=pageRows.map(it=>{ const idx=ITEMS.indexOf(it); return '<tr class="click" onclick="openProduct('+idx+')">'+cols.map(c=>{ if(c.key==='product')return `<td><div class="pname">${it.name}</div><div class="pcode">${it.code}</div></td>`; if(c.key==='qty')return `<td class="num"><span class="qty ${it.qty<=10?'low':''}">${it.qty}</span></td>`; if(c.key==='prodDate')return `<td style="font-family:var(--font-mono);color:var(--text)">${it.prodDate}</td>`; if(c.key==='inDate')return `<td style="font-family:var(--font-mono);color:var(--muted)">${it.inDate}</td>`; if(c.key==='status')return `<td><span class="badge b-${it.status}">${it.status}</span></td>`; if(c.key==='act')return `<td class="act"><div class="row-act" onclick="event.stopPropagation()"><svg viewBox="0 0 24 24" onclick="openProduct(${idx})"><use href="#i-eye"/></svg></div></td>`; return `<td class="${c.num?'num':''}">${it[c.key]}</td>`; }).join('')+'</tr>'; }).join(''); }
@@ -138,9 +143,15 @@ const PAGE_SIZES=[10,20,50,100];
 function openPageSize(e){ openMenu(e.currentTarget, PAGE_SIZES.map(n=>({v:String(n),label:String(n),sel:n===state.perPage})), v=>{ closeMenus(); setPerPage(v); }, 'pgsize-menu', 88); }
 function setPerPage(v){ state.perPage=+v; state.page=1; const el=document.getElementById('pageSizeVal'); if(el)el.textContent=v; render(); }
 function filterStatus(s){ state.status=s; state.page=1; navTo('inventory'); render(); }
-function clearFilters(){ state.q='';state.code='';state.status='全部';state.page=1; document.getElementById('searchInput').value=''; document.getElementById('codeInput').value=''; render(); }
+// 列头排序：无→升→降→无 循环（真实实现为服务端全局排序）
+function toggleSort(k){ if(state.sortBy!==k){state.sortBy=k;state.sortAsc=true;} else if(state.sortAsc){state.sortAsc=false;} else {state.sortBy=null;state.sortAsc=true;} state.page=1; render(); }
+const SORT_VAL={qty:it=>it.qty,cost:it=>parseFloat(String(it.cost).replace(/[¥,]/g,''))||0,price:it=>parseFloat(String(it.price).replace(/[¥,]/g,''))||0,prodDate:it=>it.prodDate||'',inDate:it=>it.inDate||''};
+function clearFilters(){ state.q='';state.status='全部';state.spec=null;state.series=null;state.wh=null;state.page=1; document.getElementById('searchInput').value=''; render(); }
 
 function openFilter(kind,t){ openMenu(t,STATUS.map(v=>({v,label:v,sel:v===state.status})),v=>{ state.status=v; state.page=1; closeMenus(); render(); }); }
+// 维度筛选 chip（规格/系列/仓库，2026-07-07 从列头漏斗上移；真实实现为多选）
+const DIM_KEY={spec:'spec',series:'series',wh:'supplier'};
+function openDimFilter(dim,t){ const key=DIM_KEY[dim]; const opts=['全部',...new Set(ITEMS.map(it=>it[key]).filter(Boolean))]; openMenu(t,opts.map(v=>({v,label:v,sel:(state[dim]||'全部')===v})),v=>{ state[dim]=v==='全部'?null:v; state.page=1; closeMenus(); render(); }); }
 document.getElementById('chipStatus').onclick=e=>openFilter('status',e.currentTarget);
 const COL_KEY='jiu-inv-hidden';
 function saveHidden(){ try{ localStorage.setItem(COL_KEY, JSON.stringify([...state.hidden])); }catch(e){} }