---
source_url: 
ingested: 2026-08-02
status: inbox
---

# Links 首页/搜索改造：大哥拍板的决策与设计红线（2026-08-02，1.0.399-1.0.407）

首页从"浏览表格"改为**搜索驱动管理**，连续上线多版本，大哥的关键决策：

## 决策
- **列表兜底化**（大哥原话"我基本上都会搜索"）：LINKS_PAGE_SIZE 50→20、默认排序 click_count→updated_at desc（最近更新优先）、Load more +20、移动端搜索框全宽；hero 顶部搜索保留不动（GoLinks 灵魂）。
- **⌘K 命令面板全站上线**：`/search/palette/?q=` 分组搜索（links 6 条 + pages 4 条 + posts 4 条），键盘 ↑↓/Enter/→(详情)/e(编辑)。
- **Link/Template 合并架构原则**（大哥经两轮纠正定案）："每个 link type 有自己的组件/UI/字段，不要混进别的 type"；但 **Template 不是独立 type——"只是一种小小的需求，只是带参数的链接而已"**，1.0.406 曾拆成 4 tab 被否，1.0.407 合并回 Link（3 tab，migration 0055 回滚 TEMPLATE→LINK）。当前 LinkType = LINK/CUSTOM/ACTION。
- **Sketch 式模板参数构建器**（Link tab 内）：URL 含 `{` 自动展开、普通链接折叠；chips 插入 `q={q,default=1}` 风格 token、参数列表、实时预览。坑：改默认值必须用纯占位符 token `{name,default=v}`（buildPlaceholderToken），用 query token 会变 `q=q={q}` 重复 key。

## 设计红线（别再走回头路）
- **Random Images 区块不许收窄/移动/并入二级页**——大哥原话"图片太小了我就看不清了"，明确否决"收窄成一行或并入画廊页"。
- **导航否决浅色毛玻璃，恢复深绿 bg-custom-blue**——浅色版（1.0.401）导致移动端 Menu 下拉塌缩成 3px 高：`backdrop-filter` 和 transform 一样会创建 containing block，`position:fixed inset-0` 的全屏菜单变成 nav 内部小条（实测 790px→3px）。**教训：nav 上永远不要加 transform/backdrop-filter/filter**。
- 移动端表格转卡片必须加 `.apple-table tbody td.hidden { display:none !important }`，否则 Tailwind hidden 列被 `display:block` 覆盖重新出现、横滑复活。

## 其他
- 搜索驱动卡片：debounce 250ms、alias 高亮跳转、点卡片进详情、键盘导航、清空恢复表格；移动端 Delete Selected 吸底工具栏（未选中 disabled 防误触）。
- 流程铁律：本地 dev 迭代 → pytest 全绿 → push → ArgoCD 手动钉 revision 同步 → kubectl exec 生产验证。
