@v587d/capital-generation 2.8.3 → 2.9.0

package/watchlist/client.src.cjs

@@ -1,73 +1,16 @@
 /**
- * `@v587d/watchlist` 的浏览器半边。
- *
- * 两个 surface，缺一都不成立：
- *  1. `ctx.commandUi` 的一条 **contribution**（不是 decoration——我们没有同名宿主命令），
- *     `available(session)` 按会话的 agent preset 收敛：`ClientSessionContext` 只带
- *     `sessionId`，preset 要从 `ctx.sessions.list` 的投影里读（官方 `AgentPresetLabel` 同一读法）。
- *  2. `conversation.input.overlay` 的一条 list entry（`kind:'list'` / `scope:'session'`），
- *     弹窗由官方 `Modal` 以 `headless` 卡片渲染（遮罩 / Esc / 焦点进出是官方的，内部几何是自己的），
- *     开合状态住在 `createSnapshotStore` 里经 `hooks` 交给组件——
- *     `run(session)` 在 React 之外触发，没有 store 就没有通道。
- *
- * ⛔ 座位是常驻的：这个组件在**每个**会话页都会 mount（bundle 挂 host 平面，与 preset 无关），
- * 所以关闭时必须 `return null` 且 mount 期间零 fetch——"只在 Capital 出现"到这里才真正落地。
- *
- * ⛔ 不占 turn-tail 座位、不自造会话事件（本仓 2026-09-18 事故，判据见
- * docs/dev/chart-delivery-events.md §6.3 与 AGENTS.md §7）。
- *
- * 出网：只由用户动作触发（打开面板一次批量刷新 + 手动「刷新报价」+ 添加完顺手刷一次），
- * 无轮询、无自动重试；`/search` 那一路另有三条闸（尾部防抖 / IME 合成期不发 / 同一个词不重发，
- * 见 `onQueryChange`）——把"每敲一个键出一次网"压成"每次真正改词才出网"。全组件唯一的定时器
- * 就是那个防抖。请求打 host 平面的 `/capital-watchlist/*`（`webServer` 前缀路由不在 typed
- * remote 命名空间表里，所以用 `fetch`，与 `chart-ui` 取序列同一写法）。
- *
- * 行内「更多」菜单用官方 `Menu` primitive（`portal: true`）：清单区是滚动容器，就地渲染的浮层
- * 会被它裁掉；portal 模式把菜单挂到 `document.body`（官方 `.portal` = `z-index: 1100`，压在
- * 模态的 1000 之上），Escape / Tab / 焦点归还 / 点到外面收起全归它自己，且它按官方的模态层
- * 契约在 capture 阶段吃掉 Escape——弹窗本体因此不会跟着一起关。我们只提供锚点按钮、
- * `items` 只放「置顶」，持仓那一簇（勾选行 / 比例行 / 移除）全在 `children` 里，不自己写浮层几何。
- * ⚠️ 菜单是 portal 出去的：它**读不到**本文件挂在 `.capital-watchlist-card` 上的自定义属性
- * （自定义属性只随 DOM 树继承，而列表在 `document.body` 下）。菜单里的样式一律走
- * `--dsw-alias-*` 与裸类选择器，别指望 `--capital-watchlist-up` 那一对透进去。
- *
- * 失败显示：**两档颜色、五个落点，位置跟着 cause 走**（2026-09-29 用户点名：整批刷新的红字飘在
- * 输入框下方、离它指的按钮隔了一整张表，而同样是"没成"的两个通道一个红一个黄）：
- *  - **黄 = 你这一下动作没成**：搜索失败占下拉的 hint 位（与「搜索中…」「输入完成后自动搜索」
- *    「没有匹配的标的」同一个槽，所以它**替换**它们而不是并排多出一条——同一屏不许同时说"没有
- *    这个票"和"服务限流"）；那三句按"这个词到底查过没有"分档：合成期说再等一步、防抖/在途说
- *    搜索中、「没有匹配的标的」**只在当前这个词真有一次空回包**时才说（⛔ 没查过 ≠ 查无此票）。
- *    添加失败（`list_full` / `ambiguous`）留在搜索区下方。这两条是**两个字段**：`list_full` 与
- *    输入无关，改一个字就把它抹掉是错的——但**成功移除一行**要抹掉它（清单腾出了空位，那句话
- *    当场不再成立）。
- *  - **红 = 数据不可信**：整批刷新失败跟在「刷新报价」按钮下面（跟着动词走），逐标的失败只在这一
- *    行的价格位标红——且**只有这一行从来没有过值**才标 `—`。取数失败不等于没有价：上一次成功的
- *    快照仍在域里（后端 `doRefresh` 只写成功的那几条），面板就把那个值照画，只是降一档色 +
- *    tooltip 说清它是哪一刻的快照。底部那个时间是整批共用的，不替单行背书。**清单本身读不回来**
- *    （域不可用 / 登录失效）时红字占空态那一格，绝不渲染成「还没有自选股」；401 / 403 有自己
- *    那条文案，不冒充"行情服务暂时不可用"——那等于让用户去等一个根本不会自己恢复的错误。
+ * Browser half of `@v587d/watchlist`: a session-scoped overlay entry rendered by
+ * the official headless `Modal`, plus a preset-gated `commandUi` contribution.
+ * The overlay mounts in every session, so it returns null when closed and never
+ * fetches while closed. No turn-tail slot and no custom session events (closed
+ * vocabulary, AGENTS.md §7). Only the search debounce is a timer.
  */
 const { createElement: h, useEffect, useState } = require('react')
 const { createSnapshotStore } = require('@deepseek-ai/dsh-client-store')
-// 图标只从官方集取（`dsh-client-ui-primitives` 导出的 Icon*Regular / Icon*Medium 那一份，
-// 里面没有 Star / Bookmark 类收藏图标——收藏语义靠 IconChecklistOutlineRegular）。
-// 不用 primitives 的 Button：面板里的每个动作都有自带几何（圆形关闭、描边刷新、行内省略号），
-// 套官方 Button 反而要对抗它的 sm/md 高度与 variant 调色。
-// `MenuItemButton` 是官方给"组件行"用的那一颗（与数据行走同一套 markup、同一条键盘走位）：
-// 「移除」走它，才能带着 `separatorBefore` 的发丝线排在持仓那一簇之后。
-// `Switch` 也是官方件（`role="switch"` + `aria-checked`，视觉状态与读屏状态同一个来源）：
-// 「持仓」那一行的开关就是它，我们不再自己画勾选态。
-// 持仓那一行的图标用 Database（一摞圆盘）。这一支不是按名字猜的：把 24 支候选从安装态里连 SVG
-// 一起抽出来、排成深色菜单的对照表按眼睛比过——Archive 那只箱子在 14px 下糊成一坨，Plan /
-// Checklist 读起来是"单子"不是"仓位"，Data 带齿轮太忙，Folder 是"文件"；这摞圆盘在小尺寸下
-// 像一摞硬币，几何最干净。官方集里**没有**钱包 / 饼图 / 公文包 / 硬币这类金融图标（对着安装态的
-// export 表把全部 Icon* 逐名核过），也没有 minus——所以步进键是文本 −/+ 一对，不混用 IconPlus
-// 组件与文本减号。⛔ 也不用 `IconCheckCircle*`：那两支圆心里都画着东西，未勾选挂着它就像已经被
-// 选中（2026-10-09 实机点名的正是这个错觉）。
+// Official icons only; the set has no wallet/pie/coin glyph, so stepper keys use text −/+.
+// `MenuItemButton` gives the remove row official geometry and its separator line.
 const { IconChecklistOutlineRegular, IconCloseOutlineRegular, IconDatabaseOutlineRegular, IconEllipsisOutlineRegular, IconGoalOutlineRegular, IconListPenOutlineRegular, IconPinOutlineRegular, IconRefreshOutlineRegular, IconSearchOutlineRegular, IconTrashOutlineRegular, Menu, MenuItemButton, Modal, Switch } = require('@deepseek-ai/dsh-client-ui-primitives')
-// 「哪些标的可以是一个仓位」与「占比合计封顶多少」都来自 `watchlist/holding-rules.js`
-// （构建期由 esbuild 内联进来）：面板画不画那一行、`+` 什么时候置灰，与 `/holding` 收不收这一格
-// 不许各说一套。
+// Holdability and ceiling come from the same module the host gate uses.
 const { isHoldable, weightCeiling } = require('./holding-rules.js')
 
 const ENTRY_NAME = 'capital-watchlist'
@@ -76,11 +19,7 @@ const SLOT = 'conversation.input.overlay'
 const ROUTE = '/capital-watchlist'
 const PRESET = 'capital-generation'
 const SEARCH_DEBOUNCE_MS = 300
-/**
- * 持仓比例的步进幅度（百分点）。用户点名"步长 10、不设默认值"：勾选那一刻是"持有、比例还没填"，
- * 第一次按 `+` 才落 10。⛔ 这是**几何参数**不是文案，所以住在这里而不是字典里。
- * 不吸附：域里存着 37.5（旧版自由文本填的）就照它 ±10，不替用户把一个他写过的数掰正。
- */
+/** Weight step in percentage points; no snapping (37.5 stays 37.5 ± 10). */
 const HOLDING_STEP = 10
 const STYLE_TAG = 'capital-watchlist-css'
 
@@ -101,69 +40,44 @@ const zh = {
   colAction: '操作',
   updated: '更新时间',
   notRefreshed: '未刷新',
-  /** 陈旧值的 tooltip：「……限流，请稍后再试 · 上一次快照 09-29 19:04」。 */
+  /** Stale tooltip: failure reason · last snapshot time. */
   stale: '上一次快照',
-  /**
-   * 港美股回包带的是**交易所当地时间**（HKT / 美东），与页脚那个"我们几点取的数"是两件事。
-   * 只写进 tooltip，不做时区换算（换算要用到我们没有的偏移表与夏令时口径）。
-   */
+  /** Exchange-local time, tooltip only; no timezone conversion (no offset/DST table). */
   exchangeTime: '交易所时间',
-  /** 有最新价、但没有涨跌（停牌 / 未开盘）时 tooltip 说的那件事。 */
+  /** Price exists but change does not (halted / not open). */
   noChangePct: '暂无涨跌数据',
-  /**
-   * 徽标说**市场**（2026-10-07 用户点名：「股票」这一档要拆成 A股 / 港股 / 美股，指数三档跟着拆）。
-   * 六档一字典，场内 ETF 不单列——它的报价同样是二级市场行情，归 A股那一档（"这是 ETF"那一层
-   * 留在递进输入框那句话里，见下面 `kindStock` 一族）。
-   */
+  /** Badge names the market only; ETF is covered by A-share (same secondary-market quote). */
   typeAShare: 'A股',
   typeHkStock: '港股',
   typeUsStock: '美股',
   typeAIndex: 'A指',
   typeHkIndex: '港指',
   typeUsIndex: '美指',
-  /**
-   * ⛔ 这一族**不是徽标**：它只进「预测」「复盘」递进输入框的那句话，说的是**取数端点那一族**。
-   * 徽标按市场配色之后就不说"股票 / 指数 / ETF"了，而 Agent 恰恰靠这三档选端点
-   * （A 股股票、A 股指数、场内基金是三个不同上游端点，港美股又各两档）。
-   * 市场不在这儿重复：中间那段 thscode 自己带（`.SZ` / `.HK` / `.US`）。
-   */
+  /** Prompt-only wording: the Agent picks an endpoint from stock / index / ETF; market comes from thscode. */
   kindStock: '股票',
   kindIndex: '指数',
   kindEtf: 'ETF',
   remove: '移除',
   more: '更多',
   pin: '置顶',
-  /**
-   * 持仓标记这一族（2026-10-09 起，主 Agent 经 `get_watchlist` 读的就是它）。
-   * ⚠️ 文案说的始终是**用户自报**的标记，不是券商账上的事实。
-   *
-   * 这一族只有五行：行标签与开关的可达名共用 `holdingName`（「持仓」两个字，名词——
-   * 状态由那颗开关说，不需要"标记 / 取消标记"两个动词各写一份），其余四行是比例那一簇。
-   * 比例读数里那句 `0~85` 不在这里：它是**数字**（这一格的剩余额度，随其余持仓变），
-   * 不是措辞，所以在代码里拼。旧的 `holdingMenu`（标记持仓）与 `holdingUnset`（未填）都删了
-   * ——用户点名"改成持仓两个字"与"未填不用显示，用 0~100 这种 placeholder 提示"。
-   */
+  /** User-reported holding, never broker fact; `0~N` headroom is computed, not stored in the dictionary. */
   holdingWeightLabel: '持仓比例',
   holdingStepper: '持仓比例（每档 10 个百分点）',
   holdingStepUp: '增加持仓比例',
   holdingStepDown: '减少持仓比例',
-  /** 行标签、开关的 aria-label，以及名称标红之外那句非颜色通道（红名与"红涨"同色）共用这一个词。 */
+  /** Shared by row label, switch aria-label and the non-color channel (red name = red-up color). */
   holdingName: '持仓',
   predict: '预测',
   predictTip: 'AI预测',
   review: '复盘',
   reviewTip: 'AI复盘',
-  /**
-   * ⚠️「预测」与「复盘」写进输入框的那句话**只改这四行**（zh / en 各两处，两套语言必须同时改）。
-   * 中间的 `名称 (thscode · 类型)` 是结构不是措辞，不住在这里：Agent 靠 thscode 认标的、
-   * 靠类型选端点（股票 / 指数 / ETF 是三个不同的上游端点），少一段就多半一轮取数或一轮反问。
-   */
+  /** Prompt shape is `name (thscode · kind)`; thscode and kind are data, not copy. */
   predictPromptPrefix: '请预测 ',
   predictPromptSuffix: '：未来 5 个交易日的走势与关键点位，说明依据，并给出判断的不确定性。',
   reviewPromptPrefix: '请复盘 ',
   reviewPromptSuffix: '：今日走势与量价、近 20 日趋势、基础面、消息面，给出结论和必要风险评估。',
   searching: '搜索中…',
-  /** 拼音合成期下拉里那句：它要说"再等一步"，不能把"还没查"说成"查了，没有"。 */
+  /** IME composition: say "wait", never "already checked, no match". */
   composingHint: '输入完成后自动搜索',
   clearInput: '清空输入',
   confirmTitle: '确认移除？',
@@ -171,18 +85,9 @@ const zh = {
   confirmDescSuffix: ' 从自选中移除吗？',
   confirmCancel: '取消',
   confirmOk: '确认移除',
-  /**
-   * `truncated`：候选已经**一行不落地全画出来了**（服务端不切片），所以这句里没有"候选不止这些"
-   * ——那半句说的是"还有没显示的"，此刻是假话。2026-10-08 用户改写成"没有更多"：它讲的是
-   * **上游那一路回满了自己那一档**（A 股 50 / 港 10 / 美 10），而它自己就住在滚动区末尾，
-   * 滚到底才看得见（不做成钉在底部的常驻条）。也**故意不写 N**：数字的上游是宿主常量，
-   * 抄进两套字典就迟早只改红一边（`error.list_full` 那条教训）。
-   */
+  /** "No more" means a branch filled its own cap; lives at scroll end and never names N. */
   truncated: '没有更多，请输入准确的证券代码或名称。',
-  /**
-   * 候选下拉的筛选头（全部 / CN / HK / US，默认全部）：**只在客户端筛已经拿全的候选**，
-   * 不重新出网、也不改变上游入参（`asset_type` 白名单那条纪律讲的是入参收窄，不是这里的显示筛选）。
-   */
+  /** Client-side filter over fully fetched candidates: no refetch, no upstream param change. */
   filterAll: '全部',
   filterLabel: '按市场筛选候选',
   filterNoHit: '这个市场下没有匹配的标的。',
@@ -190,15 +95,10 @@ const zh = {
   'error.invalid_query': '输入不被接受',
   'error.not_found': '没有找到该标的',
   'error.ambiguous': '命中多条，请从候选里选一条',
-  /**
-   * `{max}` 由宿主回包里的 `limit` 填（`list_full` 那条 409 一直带着它）：上限是服务端的一个常量，
-   * 2.5.2 把它在中英文字典里各抄了一遍数字，抬上限时只会改红一边——这里起只留一个真值源。
-   * 万一拿到的是没有 `limit` 的旧回包，退到 `error.list_full_noMax` 那句不带数字的话，
-   * 而不是把 `{max}` 原样印在面板上。
-   */
+  /** `{max}` comes from the host's `limit`; fall back to the no-number sentence. */
   'error.list_full': '自选股最多 {max} 条，先删一条再加',
   'error.list_full_noMax': '自选股已达上限，先删一条再加',
-  'error.credential_missing': '未配置 Fuyao 密钥：在「插件」页的 Capital 模式卡片里填 API Key（只影响 A 股那一路，港美股照常用）',
+  'error.credential_missing': '未配置 Fuyao 密钥：在「插件」页的 自动模式卡片里填 API Key（只影响 A 股那一路，港美股照常用）',
   'error.rate_limited': '行情服务限流，请稍后再试',
   'error.fuyao_unavailable': 'A 股行情暂时取不到，请稍后再试',
   'error.tencent_unavailable': '港美股行情暂时取不到，请稍后再试',
@@ -207,10 +107,7 @@ const zh = {
   'error.store_unavailable': '自选股存储不可用',
   'error.unauthorized': '登录状态已失效：请先回到宿主窗口重新登录',
   errorSuffix: '（其他标的仍是上一次成功快照）',
-  /**
-   * 某一路检索挂了：候选照常给其余路，这一句说**挂掉的那一路**（R12 / 设计文档 §5.4）。
-   * 值自带冒号，中英文各按各的标点；接的是同一份 `error.*` 文案，不另起一套说法。
-   */
+  /** One branch failed; other branches still return candidates. */
   'partial.a-share': 'A 股检索不可用：',
   'partial.hk': '港股检索不可用：',
   'partial.us': '美股检索不可用：',
@@ -248,14 +145,13 @@ const en = {
   remove: 'Remove',
   more: 'More',
   pin: 'Pin to top',
-  // 持仓那一族：五个 key，理由与"行标签与开关共用同一个名词"都写在 zh 那一处（两套语言必须同时改）。
+  // Holding family: five keys; row label and switch share one singular noun.
   holdingWeightLabel: 'Holding weight',
   holdingStepper: 'Holding weight, in steps of 10 percentage points',
   holdingStepUp: 'Increase holding weight',
   holdingStepDown: 'Decrease holding weight',
   holdingName: 'Holding',
-  /** ⚠️ 这两条标签受**格宽预算**约束：动作列是定值 52px（见 CSS 里 grid 那一处），
-   *  12px/500 下八个字符就顶到边。要改名先量长度，别让它溢出描边。 */
+  /** Predict / Review labels are constrained by the fixed 52px action column. */
   predict: 'Predict',
   predictTip: 'AI prediction',
   review: 'Review',
@@ -297,14 +193,8 @@ const en = {
 }
 
 /**
- * `asset_type` → 类型徽标文案的**字典键**。文案本身住两套字典里（2.5.2 是在这里写死中文，
- * 英文界面于是画着「股票 / 指数」，还绕过了"两套语言 key 必须齐平"那道闸门）。
- *
- * 六档只说**市场**（2026-10-07 用户点名：「股票」拆成 A股 / 港股 / 美股，指数跟着拆三档，
- * 三市三种底色）。两件事因此从徽标上退场，各自另有落点：
- * ① "这是 ETF / 这是股票还是指数"进递进输入框那句话（`KIND_LABEL_KEYS`，Agent 按它选端点）；
- * ② 港股 ETF 在检索阶段本来就分不出与个股的差别（实测 `03037` 搜索给 `GP`、快照给 `GP-FUND`），
- *    所以 `港股` 那一档同时盖住两者是**如实**，不是合并出了错。
+ * `asset_type` → badge copy key. Six market-only badges: product type lives in the
+ * prompt wording, and HK ETFs are indistinguishable from stocks at search time.
  */
 const TYPE_LABEL_KEYS = {
   'a-share': 'typeAShare',
@@ -313,10 +203,10 @@ const TYPE_LABEL_KEYS = {
   'a-share-index': 'typeAIndex',
   'hk-index': 'typeHkIndex',
   'us-index': 'typeUsIndex',
-  // 场内 ETF 归 A股那一档：徽标说市场，而它交易的就是 A 股二级市场的价格。
+  // ETF trades on the A-share secondary market, so it shares that badge.
   'fund-etf': 'typeAShare',
 }
-/** 递进输入框那句话里的"这一族走哪个端点"，与徽标各管各的（见字典里 `kindStock` 一族的注释）。 */
+/** Endpoint family for prompts, separate from the market badge. */
 const KIND_LABEL_KEYS = {
   'a-share': 'kindStock',
   'hk-stock': 'kindStock',
@@ -326,7 +216,7 @@ const KIND_LABEL_KEYS = {
   'us-index': 'kindIndex',
   'fund-etf': 'kindEtf',
 }
-/** 未知类型（上游哪天多一档）照原样画出来，比硬套一个错的中文标签诚实。 */
+/** Unknown types print verbatim rather than a wrong label. */
 function typeLabel(assetType, t) {
   const key = TYPE_LABEL_KEYS[assetType]
   return key === undefined ? String(assetType ?? '') : t(key)
@@ -337,21 +227,13 @@ function kindLabel(assetType, t) {
 }
 
 /**
- * 面板**不画币种**（2026-10-07 用户两次点名：先不要 ISO 码、再不要 `¥` / `$`——"正常人都 get
- * 货币单元的问题"）。落点只有这一处：`quote.currency` 照旧取、照旧入库、照旧过 schema，
- * 只是不进 DOM。要恢复显示，只需要在这一处重新读它，上游与宿主都不必动。
- * ⚠️ 已知代价（记录在 `docs/design/watchlist-hk-us.md` R9 与 P10）：`80700` 这类 `-R` 柜台是
- * **港币市场、人民币计价**，同一屏里它与 `00700`(HKD) 现在长得一样。用户按市场读币种，
- * 在这一类标的上会读错——这是这一版接受了的取舍，不是没看见。
+ * Currency is stored but not rendered; known cost: `-R` counters are HKD-market,
+ * CNY-denominated and look identical to HKD quotes.
  */
 
 /**
- * 上游（同花顺搜索结果）的标的名在进面板、进 tooltip、进输入框之前，先剥掉不可见与双向控制字符。
- * 这是本仓对外部内容共用的出口口径（host 侧同一份字符类在 `src/web-retriever/html-markdown.ts`
- * 的 `INVISIBLE_PATTERN`）：零宽与方向覆盖符肉眼看不见，却能把一句话的**显示顺序**改成与 Agent
- * 实际收到的不一样——用户按发送时读到的不是他核对过的那句。
- * 两份实现隔着构建边界（浏览器半边不能 import 插件侧 TS），所以由 test/watchlist-client.test.mjs
- * 逐字比对两边的字符类：谁改了、另一边没跟上，测试就红。
+ * Strip zero-width and bidi controls before display; the host uses the same class
+ * (`INVISIBLE_PATTERN`), and tests compare both sides verbatim.
  */
 const INVISIBLE_CHARS = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F\u00AD\u200B-\u200F\u2028\u2029\u202A-\u202E\u2060-\u2064\u2066-\u2069\uFEFF]/gu
 
@@ -359,15 +241,11 @@ function scrubInvisible(value) {
   return String(value ?? '').replace(INVISIBLE_CHARS, '')
 }
 
-/** 宿主回包里的每一行都过这一道：显示、tooltip、aria-label 与递进输入框的那句话因此是同一个名字。 */
+/** Host rows are scrubbed once so display, tooltip, aria-label and prompt share one name. */
 function cleanRows(rows) {
   return Array.isArray(rows) ? rows.map((row) => (row === null || typeof row !== 'object' ? row : { ...row, name: scrubInvisible(row.name) })) : rows
 }
-/**
- * 类型徽标的配色：**一色只说一件事 = 市场**（2026-10-07 用户点名：A 股 / 港股 / 美股三种底色；
- * 此前 A 股与港股共用同一支琥珀色，三市在色上分不开）。同一市场里股票与指数同色，
- * 品种那一层只由文字给（`A股` / `A指`）——颜色不再同时表达市场与品种两件事。
- */const TYPE_TONES = {
+/** Color encodes market only; product type is carried by the label. */const TYPE_TONES = {
   'a-share': 'capital-watchlist-tag-cn',
   'a-share-index': 'capital-watchlist-tag-cn',
   'fund-etf': 'capital-watchlist-tag-cn',
@@ -377,305 +255,136 @@ function cleanRows(rows) {
   'us-index': 'capital-watchlist-tag-us',
 }
 
-/**
- * 候选筛选头的四档（2026-10-08 用户点名：**默认「全部」**，三市都摆出来让用户自己筛）。
- * 只在客户端筛**已经拿全的候选**：A 股 50 + 港 10 + 美 10 一次回包，切换不重新出网，
- * 也不碰上游入参（`asset_type` 白名单那条纪律讲的是入参收窄，与这里的显示筛选是两件事）。
- * `marketIdOf` 是这一层唯一的判据：候选的 `exchange` 存的是**市场**（`SH`/`SZ`/`HK`/`US`，
- * 美股的具体交易所留在 canonical 代码里），所以 A 股那一档由"不是 HK 也不是 US"给出。
- */
+/** Client-side filter over fully fetched candidates; `exchange` stores the market. */
 const MARKET_FILTERS = [{ id: 'all' }, { id: 'cn', label: 'CN' }, { id: 'hk', label: 'HK' }, { id: 'us', label: 'US' }]
 const marketIdOf = (candidate) => (candidate.exchange === 'HK' ? 'hk' : candidate.exchange === 'US' ? 'us' : 'cn')
 
 /**
- * 面板几何。
- *
- * 官方 `Modal` 的 `.dialog` / `.header` / `.body` 是 CSS Module 的**散列类**（本机
- * `dsh-web-frontend` 产物里是 `_body_17vb8_5` 这种），插件 CSS 够不着它们——所以弹窗用
- * `headless: true`（官方 props 之一：卡片、遮罩、Esc、aria-label 都还在，只去掉默认
- * header/body/footer 骨架），几何全部由下面这些自有类承担。
- * 唯一还需要压官方的是**卡片本身**：`.capital-watchlist-dialog` 与官方类同落在 dialog 元素上，
- * 双类名选择器（重复一次类名）把 specificity 抬到 0-2-0 才赢得过 `.dialog` 的默认宽/内边距/圆角。
- *
- * 颜色一律取宿主 design token，而且**按角色取**、不按"看着深浅"取：官方规则（`docs/web-styling`）
- * 是功能 CSS 不得写主题选择器、不得写颜色字面量，明暗两套值由 token 自己翻。浅色踩坑的三条：
- *  1. `--dsw-alias-label-dimmed` 在浅色解析成 `#e1e5ee`（深色是 `#43454a`）——压在白卡片上等于隐形，
- *     所以**凡是承载信息的文字**都走 `label-secondary` / `label-tertiary`，`dimmed` 只留给
- *     "看不见也无所谓"的东西（我们的面板里它一处都不剩）。
- *  2. `bg-layer-1/2/3` 在浅色**同为纯白**：控件底面要反差就用 `bg-module-platform`
- *     （浅 `#f5f6f7` / 深 `#353638`，官方 `.selector`、`.badge` 都是这一条）。浮层用
- *     `--dsw-specific-menu` + `--dsw-elevation-prominent`——官方口径是高层级表面 `border: 0`、
- *     靠 0.5px 描边投影分离，**不得**把 `border-l*` 与 elevation 投影配对。
- *     ⚠️ `--dsw-specific-menu` 是**半透明**菜单材质（浅 `#f8f9fa94` = 58%、深 `#43454a73` = 45%，
- *     只有 macOS 才近不透明），官方规则要求画它的表面**必须**同时声明
- *     `backdrop-filter: var(--dsw-menu-backdrop-filter)`（`blur(40px) saturate(150%)`）：
- *     只拿填充不拿模糊，浮层底下的清单行会直接透视上来（`MenuSurface .material`、会话侧
- *     `.media` 滚动面板都是这一对）。深色那档描边不用我们分支——宿主有
- *     `body[data-ds-dark-theme] [data-menu-material] { …border-l3 }`，节点挂上
- *     `data-menu-material="translucent"`（官方 `MenuSurface` 的挂法）就自动翻，功能 CSS
- *     写主题选择器是违规的。
- *  3. `interactive-bg-hover` 在浅色只有 6% 不透明度，画不出"常态灰底"，只配当 hover；
- *     常态灰底用 `bg-module-platform`，hover 加深用 `interactive-bg-hover-accent`。
- * 只有 A 股口径的**红涨绿跌**两个色是字面量——涨跌语义不在宿主调色板里，宿主也没逐元素声明
- * `color-scheme`（`light-dark()` 用不了），所以浅深两套共用一对值：#d1493f / #17a063 在
- * 「浅卡 / 深卡」四种组合里最差的一档是 3.14:1（涨 on 深卡），已是最优折中。
- * 这一对写在 `.capital-watchlist-card` 的两个自定义属性上、由规则去 `var()` 它们：
- * "持仓的那一行名称标红"用的就是**同一个红**（用户点名），而字面量闸门只许这一对存在一次。
- * ⛔ 也因此这两个变量只覆盖卡片子树——portal 出去的菜单读不到（见文件头那条）。
+ * Official Modal classes are CSS-module hashes, so the dialog uses `headless: true`
+ * and our own classes; repeated class names raise specificity over `.dialog`.
+ * Colors use host tokens by role; menu surfaces pair `--dsw-specific-menu` with its
+ * backdrop filter. The red/green pair is the only literal color.
  */
 const CSS = `
-/* 宽 420 / 圆角 18 / 无内边距（内边距住在各段自己头上，好让表头与分隔线对齐）。
-   限高按官方口径走 max-height: 100%（对 .root 的 padding box），不自己算 vh。 */
 .capital-watchlist-dialog.capital-watchlist-dialog { width: min(420px, 92vw); max-height: 100%; padding: 0; gap: 0; border-radius: 18px; }
-/* 底色与投影归官方 .dialog；滚动条按官方契约只在容器上重绑 l2 那一对，不自己写 scrollbar-* 选择器。 */
 .capital-watchlist-card { position: relative; display: flex; flex-direction: column; min-height: 0; overflow: hidden; border-radius: 18px; --capital-watchlist-up: #d1493f; --capital-watchlist-down: #17a063; --dsh-scrollbar-thumb: var(--dsw-alias-scrollbar-bg-l2); --dsh-scrollbar-thumb-hover: var(--dsw-alias-scrollbar-hover-l2); }
 .capital-watchlist-header { display: flex; align-items: center; justify-content: space-between; gap: 8px; padding: 18px 20px 14px; }
 .capital-watchlist-title { margin: 0; font-size: 17px; line-height: 24px; font-weight: 600; letter-spacing: .3px; color: var(--dsw-alias-label-primary); }
-/* 圆形灰底键：灰底 bg-module-platform + glyph label-secondary，两套主题都拉得开；正圆须配 corner-shape: round。 */
 .capital-watchlist-close { flex: none; width: 28px; height: 28px; display: inline-flex; align-items: center; justify-content: center; border: none; border-radius: 50%; corner-shape: round; background: var(--dsw-alias-bg-module-platform); color: var(--dsw-alias-label-secondary); cursor: pointer; }
 .capital-watchlist-close:hover { background: var(--dsw-alias-interactive-bg-hover-accent); color: var(--dsw-alias-label-primary); }
-/* 搜索段：position:relative 是下拉的包含块（下拉 top: calc(100% - 8px) 贴着输入框下沿）。 */
 .capital-watchlist-search { position: relative; padding: 0 20px 16px; }
 .capital-watchlist-field { position: relative; display: flex; align-items: center; height: 42px; padding: 0 14px 0 40px; border: none; border-radius: 12px; background: var(--dsw-alias-bg-module-platform); transition: box-shadow .2s var(--ds-ease-in-out); }
-/* 聚焦用 inset 投影而不是 border（官方 .selector 这类控件就没有 border，加了会顶出 1px 抖动）；
-   颜色 brand-primary 浅=近黑、深=近白，与官方 Input 的 focus-within 同一支笔。 */
 .capital-watchlist-field:focus-within { box-shadow: inset 0 0 0 1.5px var(--dsw-alias-brand-primary); }
 .capital-watchlist-searchicon { position: absolute; left: 14px; display: inline-flex; color: var(--dsw-alias-label-tertiary); pointer-events: none; }
 .capital-watchlist-input { flex: 1 1 auto; min-width: 0; height: 100%; padding: 0; border: none; outline: none; background: transparent; color: var(--dsw-alias-label-primary); font-family: inherit; font-size: 14px; line-height: 22px; }
-/* 占位符比官方 Input 提一档到 tertiary：dimmed / caption 压在浅底只有 1.26 / 1.97:1，
-   而这一行是面板里唯一告诉用户"这里能输入什么"的地方。 */
 .capital-watchlist-input::placeholder { color: var(--dsw-alias-label-tertiary); }
-/* 清空键：与关闭键同一支笔，按 42px 的框缩一档。底面不能用 bg-module-platform——它正坐在
-   同色的输入框底上会糊成一片，所以走 interactive-bg-hover，hover 再深一档到 hover-accent。 */
 .capital-watchlist-clear { flex: none; width: 18px; height: 18px; display: inline-flex; align-items: center; justify-content: center; border: none; border-radius: 50%; corner-shape: round; background: var(--dsw-alias-interactive-bg-hover); color: var(--dsw-alias-label-secondary); cursor: pointer; }
 .capital-watchlist-clear:hover { background: var(--dsw-alias-interactive-bg-hover-accent); color: var(--dsw-alias-label-primary); }
-/* 下拉候选：官方半透明菜单材质。--dsw-specific-menu 浅 58% / 深 45%，**必须**与
-   --dsw-menu-backdrop-filter（blur40 saturate150）成对声明——只拿填充不拿模糊，底下的清单行会
-   直接透视上来（官方滚动浮层 .media 面板与 MenuSurface .material 都是这一对）。border: 0 +
-   elevation-prominent 分离；描边浅色重绑 l1，深色由宿主 [data-menu-material] 规则翻成 l3。 */
-/* 候选下拉是**卡片内**的浮层，而卡片 overflow: hidden（圆角与清单滚动都靠它）：浮层一旦比
-   卡片剩余的空间高，多出来的部分就被无声裁掉。所以它的 max-height 必须与下面
-   capital-watchlist-list-open 那格的 min-height **同值**（下拉正好铺满清单那一格：够高，又压不到
-   页脚）——246px → **320px**（2026-10-08 用户点名"一屏只能显示 3 个标的"：行高压到约 47px、
-   浮层抬到 320，一屏 5~6 行；这两个数一改必须一起改，测试里有同值断言）。
-   这一层自己不滚：里面 .capital-watchlist-options 才是滚动区——筛选头钉在顶上（"锁定这个头"），
-   "没有更多"那句住在**滚动区末尾**（滚到底才看得见，不冻结在底部），其余 hint 贴在选项之后。
-   候选池是 50+10+10=70 行（三路上游硬顶之和，服务端不切片）。 */
+/* max-height must equal the .capital-watchlist-list-open min-height (test pins both). */
 .capital-watchlist-dropdown { position: absolute; top: calc(100% - 8px); left: 20px; right: 20px; z-index: 20; display: flex; flex-direction: column; max-height: 320px; overflow: hidden; background: var(--dsw-specific-menu); backdrop-filter: var(--dsw-menu-backdrop-filter); border: 0; border-radius: 12px; --dsw-elevation-stroke-color: var(--dsw-alias-border-l1); box-shadow: var(--dsw-elevation-prominent); animation: capital-watchlist-drop .18s var(--ds-ease-in-out); }
-/* 筛选头与那几句"此刻怎么了"的 hint 都是 flex: none，只有选项层 flex: 0 1 auto 可收缩、可滚：
-   头永远在顶，hint 在选项之后（内容短时紧贴最后一行，内容长时也不会被挤没）。 */
 .capital-watchlist-filter { flex: none; display: flex; align-items: center; gap: 6px; padding: 6px 10px; border-bottom: .5px solid var(--dsw-alias-border-l2); }
 .capital-watchlist-options { flex: 0 1 auto; min-height: 0; overflow-y: auto; }
 .capital-watchlist-filterbtn { display: inline-flex; align-items: center; gap: 4px; padding: 3px 9px; border: none; border-radius: 999px; corner-shape: round; background: var(--dsw-alias-interactive-bg-hover); color: var(--dsw-alias-label-secondary); font-family: inherit; font-size: 12px; line-height: 16px; cursor: pointer; }
 .capital-watchlist-filterbtn:hover { background: var(--dsw-alias-interactive-bg-hover-accent); color: var(--dsw-alias-label-primary); }
-/* 选中态读 aria-pressed：状态住在属性里，样式只是它的投影（读屏也听得见"已选中"）。
-   压在半透明菜单材质上用 color-mix 的透明淡染——它不写背景实底，底下的菜单模糊照常透上来。 */
 .capital-watchlist-filterbtn[aria-pressed="true"] { background: color-mix(in srgb, var(--dsw-alias-brand-primary) 14%, transparent); color: var(--dsw-alias-label-primary); }
 .capital-watchlist-filtercount { font-size: 11px; color: var(--dsw-alias-label-tertiary); font-variant-numeric: tabular-nums; }
 @keyframes capital-watchlist-drop { from { opacity: 0; transform: translateY(-6px); } to { opacity: 1; transform: translateY(0); } }
 @keyframes capital-watchlist-breathe { 0% { opacity: 1; } 40% { opacity: .6; } 80%, 100% { opacity: 1; } }
 @media (prefers-reduced-motion: reduce) { .capital-watchlist-dropdown { animation: none; } .capital-watchlist-skeleton { animation: none; } }
-/* 候选行高度（2026-10-08 用户点名"减少每个标的展示高度"）：padding 6 + 名称 18 + 间隙 1 + 代码行 15
-   ≈ 47px。与上面那条"浮层 320px"一起算：(320 − 筛选头约 32) ÷ 47 ≈ 6 行一屏（改前是 3 行）。
-   两个数是一对——只抬浮层不压行高，多出来的空间会被行高吃掉；只压行高不抬浮层，一屏还是 3 行。 */
 .capital-watchlist-option { display: flex; width: 100%; align-items: center; justify-content: space-between; gap: 8px; padding: 6px 12px; border: none; border-bottom: .5px solid var(--dsw-alias-border-l2); background: transparent; color: inherit; font-family: inherit; text-align: left; cursor: pointer; }
 .capital-watchlist-option:last-of-type { border-bottom: none; }
-/* 「已添加」与"在途"这一档读的是 **aria-disabled 而不是 :disabled**（真 disabled 会把焦点踢到
-   body，搜索段的 onBlur 就判"点到框外"收起下拉 —— 见渲染处那段），所以视觉降档也跟着读它：
-   整行 opacity .45、指针 not-allowed，焦点照旧留在这一行。 */
+/* Reads aria-disabled, not :disabled: real disabled would drop focus and close the dropdown. */
 .capital-watchlist-option:hover:not([aria-disabled="true"]) { background: color-mix(in srgb, var(--dsw-alias-state-business-primary) 10%, transparent); }
 .capital-watchlist-option[aria-disabled="true"] { opacity: .45; cursor: not-allowed; }
-/* 键盘焦点走官方表达式：环色由宿主按主题与输入模态管好（指针模态自动透明），不自己造环。 */
 .capital-watchlist-close:focus-visible, .capital-watchlist-clear:focus-visible, .capital-watchlist-option:focus-visible, .capital-watchlist-filterbtn:focus-visible, .capital-watchlist-more:focus-visible, .capital-watchlist-predict:focus-visible, .capital-watchlist-review:focus-visible, .capital-watchlist-refresh:focus-visible, .capital-watchlist-confirmbtn:focus-visible, .capital-watchlist-stepperbtn:focus-visible { outline: var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary)); outline-offset: 1px; }
 .capital-watchlist-optionmain { display: flex; flex-direction: column; gap: 1px; min-width: 0; }
 .capital-watchlist-optionname { font-size: 14px; line-height: 18px; font-weight: 500; color: var(--dsw-alias-label-primary); overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
 .capital-watchlist-optioncode { font-size: 12px; line-height: 15px; color: var(--dsw-alias-label-tertiary); }
-/* 右侧那颗「添加」是**整行这个 button 的可见动词**，不是第二个可聚焦控件（button 里套 button
-   是非法 HTML）：所以它只是一颗胶囊——常态灰底、hover 跟着整行加深；「已添加」那档由整行 disabled
-   的 opacity 统一降下去，不再往代码行里塞「· 已添加」（代码 + 徽标才是第二行要读的两样）。 */
-/* 右侧那颗「添加」是**整行这个 button 的可见动词**，不是第二个可聚焦控件（button 里套 button
-   是非法 HTML）。两态（2026-10-08 第三轮用户点名）：
-   - **添加 = 醒目**：沿用「刷新报价」那颗 verb 按钮的配方（state 色 12% 淡底 + 25% 描边 + 同色字），
-     整行里唯一带色的元素就是它，一眼知道点哪儿；
-   - **已添加 = 暗**：透明底 + l1 描边 + tertiary 字（data-state="added"），跟整行的 aria-disabled
-     一起降下去，并且点了也不再出网（guard 在渲染处）。 */
 .capital-watchlist-addbtn { flex: none; padding: 3px 9px; border: 1px solid color-mix(in srgb, var(--dsw-alias-state-business-primary) 25%, transparent); border-radius: 999px; corner-shape: round; background: color-mix(in srgb, var(--dsw-alias-state-business-primary) 12%, transparent); color: var(--dsw-alias-state-business-primary); font-size: 12px; line-height: 15px; font-weight: 500; }
 .capital-watchlist-option:hover:not([aria-disabled="true"]) .capital-watchlist-addbtn { background: color-mix(in srgb, var(--dsw-alias-state-business-primary) 20%, transparent); }
 .capital-watchlist-addbtn[data-state="added"] { border-color: var(--dsw-alias-border-l1); background: transparent; color: var(--dsw-alias-label-tertiary); font-weight: 400; }
 .capital-watchlist-tag { flex: none; display: inline-block; padding: 2px 7px; border-radius: 6px; font-size: 11px; line-height: 14px; font-weight: 500; }
-/* 类型徽标 = 官方状态徽标那对写法：底色用 state-*-tertiary（主题包为"状态色的底"准备的实心档，
-   自己 color-mix 出来的透明档压在白卡片上等于没混），文字用同色系 primary；
-   amber 例外走 warn-label——warn-primary 压白底只有 2:1，官方"状态色当文字"另有 label 一档。 */
-/* 三档徽标按**市场**配色，取的是"钞票的主色"这把直觉：人民币=红、港币=金琥珀、美元=绿
-   （2026-10-07 用户点名，并明确绿那一档"和美元很像"）。股票与指数同市同色，品种只由文字分。
-   ⚠️ 红档与"红涨"那颗红是两种东西：徽标是整行固定的底，价格只在涨跌时上色。
-   state-*-tertiary 是主题包给状态色准备的**实心底**；error 那一族的 tertiary 本仓从未用过、
-   无法在此确认存在，于是给一条 color-mix 兜底——猜错 token 的症状是"底色没了"，不会报错。
-   ⚠️ 这段 CSS 住在模板字符串里：注释里不许出现反引号，出现就把整段样式截断（本轮踩过）。 */
+/* Badge uses a solid tertiary background; state color as text uses the label tier. */
 .capital-watchlist-tag-cn { color: var(--dsw-alias-state-error-primary); background: var(--dsw-alias-state-error-tertiary, color-mix(in srgb, var(--dsw-alias-state-error-primary) 12%, transparent)); }
 .capital-watchlist-tag-hk { color: var(--dsw-alias-state-warn-label); background: var(--dsw-alias-state-warn-tertiary); }
 .capital-watchlist-tag-us { color: var(--dsw-alias-state-success-primary); background: var(--dsw-alias-state-success-tertiary); }
-/* 表头与数据行共用同一个 grid 定义：宽度只在这一处，两处各自排版就会串行（实机踩过）。
-   三列：名称（第二行是「代码 · 徽标」）/ 报价 / 「操作」那一簇（「预测」「复盘」「更多」三枚）。
-   92px 与 84px 必须是**定值**：表头与数据行是两个独立的 grid 容器，只有定值才让两行的列边线对齐；
-   写成 auto 就变成"谁的内容谁宽"，表头跟着数据串行。84px = 两枚 26px 图标键 + 一枚 28px「更多」
-   + 两个 2px 间隙，整簇贴右缘。
-   这一版是 2026-10-01 用户第三、第四轮反馈的结果：两枚动作从"独立两列的铺满方块"改成图标键
-   （"太宽、显得笨、且挤"、"不要显示中文，tooltip 提示"→ 字面只活在 aria-label 与 title 里），
-   座位再从中性化的名称行**挪回「操作」列**——三个动作同一栏，"这一行能干什么"才一处可读。 */
+/* Header and rows are separate grids, so 92px / 84px must stay fixed for column alignment. */
 .capital-watchlist-grid { display: grid; grid-template-columns: 1fr 92px 84px; gap: 8px; align-items: center; }
 .capital-watchlist-head { padding: 0 20px 8px; font-size: 12px; line-height: 18px; letter-spacing: .2px; white-space: nowrap; color: var(--dsw-alias-label-tertiary); }
-/* 「操作」贴在最后一列之上**居右**（2026-10-01 用户点名：居中太丑，读起来像第三列的列名）。
-   这一格装着这一行的三个动作：「预测」「复盘」与「更多」，表头贴的就是它们共同那条右缘。 */
 .capital-watchlist-headaction { text-align: right; }
 .capital-watchlist-list { max-height: 300px; padding: 0 12px 8px; overflow-y: auto; }
-/* 下拉打开时把这一格撑到浮层的最大高度（见上面 capital-watchlist-dropdown 那一段的理由）：
-   **这两个数必须同值**——一个改了另一个不改，下拉就会被卡片裁掉一截（或者清单被顶出卡片外）。
-   2026-10-08 一起从 246 抬到 320（用户点名"一屏只能显示 3 个标的"），测试里有同值断言。
-   只在打开时撑：平时 1-2 行的短清单不该平白多出一截空白。
-   ⚠️ 打开时 min-height(320) > 上面那条 max-height(300)，而 CSS 里 min 恒胜 max ⇒ 这一格此时按
-   320 高、内部照旧 overflow-y: auto 自己滚；收起后 max-height 300 恢复生效。 */
+/* Must equal the dropdown max-height; min wins over max-height while open. */
 .capital-watchlist-list-open { min-height: 320px; }
 .capital-watchlist-row { padding: 11px 8px; border-radius: 10px; transition: background .15s var(--ds-ease-in-out); }
 .capital-watchlist-row:hover { background: var(--dsw-alias-interactive-bg-hover); }
 .capital-watchlist-namewrap { display: flex; flex-direction: column; gap: 1px; min-width: 0; }
 .capital-watchlist-name { font-size: 14px; font-weight: 500; color: var(--dsw-alias-label-primary); overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
-/* 用户在这条面板上亲手标过持仓的那一行：名称标红（2026-10-09 用户点名，替代原先那枚徽标）。
-   ⚠️ 颜色不是这条标记的唯一通道——它与"红涨"同色，所以 title 里同时写着"持仓 20%"，
-   读屏与鼠标悬停都拿得到同一句话（见 nameTitle）。 */
 .capital-watchlist-name-held { color: var(--capital-watchlist-up); }
-/* 代码与类型徽标同处第二行（2026-10-07 起这一行就这两样，币种不进面板）：gap 是这一对唯一的间距来源，徽标自带内边距，别再各写 margin。10px 与候选行 capital-watchlist-option 那条 gap 同值——同一件事的两种排法，不该一处紧一处松；6px 在实机上读起来是"贴着"（2026-10-07 用户点名）。 */
 .capital-watchlist-codeline { display: flex; align-items: center; gap: 10px; min-width: 0; }
 .capital-watchlist-code { font-size: 11px; color: var(--dsw-alias-label-tertiary); overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
-/* 最新价在上、涨跌幅在下，右对齐：两行都同一列里排，列宽才不需要跟着涨跌位数抖。
-   padding-right 是**数字与动作区之间那口气的唯一来源**（2026-10-01 用户点名：报价和预测/复盘太近，
-   整行不均衡）：右对齐的数字永远贴着一列的右缘收笔，所以把这一列改窄**不会**让数字离按钮更远——
-   列宽只改左边界，右边界一直是那 8px 的 gap。表头「最新价 / 涨跌幅」借同一个类，跟着一起左移，
-   标签与它底下的数字因此始终对齐。 */
+/* Right-aligned numbers end at the same edge, so padding-right is the only gap before actions. */
 .capital-watchlist-quote { min-width: 0; padding-right: 12px; text-align: right; font-variant-numeric: tabular-nums; }
 .capital-watchlist-price { font-size: 14px; font-weight: 500; color: var(--dsw-alias-label-primary); white-space: nowrap; }
 .capital-watchlist-change { margin-top: 1px; font-size: 12px; font-weight: 500; white-space: nowrap; }
 .capital-watchlist-up { color: var(--capital-watchlist-up); }
 .capital-watchlist-down { color: var(--capital-watchlist-down); }
 .capital-watchlist-flat { color: var(--dsw-alias-label-secondary); }
-/* 第四档：价有、涨跌还没有（停牌 / 未开盘）。刻意比 flat 再浅一档——flat 那一档说的是"今日平盘"
-   这个结论，借用它就把"没这个数"画成了一个投资判断。 */
 .capital-watchlist-nodata { color: var(--dsw-alias-label-tertiary); }
-/* 这一行本次没取到报价、且从来没有过值：破折号标红（红 = 数据不可信，与整批刷新同一档）。
-   写在 up/down/flat 之后，与 .capital-watchlist-price 同 specificity 靠源码序赢——不靠 !important 抢。 */
 .capital-watchlist-quotefailed { color: var(--dsw-alias-state-error-primary); }
-/* 本次没取到、但上一次成功的快照还在（后端只覆写成功的那几条）：值照画，两行都降到 secondary。
-   红涨绿跌是"当前"的语义，一个陈旧值不该借用；它是哪一刻的写在 tooltip 里。 */
+/* Failed refresh keeps the last good snapshot; the tooltip names its time. */
 .capital-watchlist-stale { color: var(--dsw-alias-label-secondary); }
-/* 骨架条：bg-skeleton 在浅色只有 4%，官方那一条（.skeletonBar）也是配 2s 呼吸一起用的。 */
 .capital-watchlist-skeleton { display: block; height: 12px; margin: 2px 0 0 auto; border-radius: 6px; background: var(--dsw-alias-bg-skeleton); animation: capital-watchlist-breathe 2s cubic-bezier(.36, 0, .64, 1) infinite; }
 .capital-watchlist-skeleton-price { width: 68px; }
 .capital-watchlist-skeleton-change { width: 44px; height: 10px; }
-/* 「更多」键：dimmed 在浅底等于图标整个消失，所以常态取 label-tertiary，hover 提亮到 primary
-   （破坏性的「移除」降级成菜单里的一条 danger 行，行内不再常驻一个红色动作）。 */
 .capital-watchlist-more { width: 28px; height: 28px; display: inline-flex; align-items: center; justify-content: center; border: none; border-radius: var(--dsw-radius-sm); background: transparent; color: var(--dsw-alias-label-tertiary); cursor: pointer; }
 .capital-watchlist-more:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover); color: var(--dsw-alias-label-primary); }
 .capital-watchlist-more:disabled { opacity: .45; cursor: not-allowed; }
-/* 官方 Menu 的锚点包着一层 span（.root 是 inline-flex）：贴右缘靠 justify-content——旧版删除键是
-   格子本身，用 margin-left:auto；包一层之后 auto 外边距落在 span 自己身上，已无效果。
-   现在它住在 .capital-watchlist-rowactions 那一簇里，同一簇还有「预测」「复盘」两枚图标键。 */
 .capital-watchlist-actions { justify-content: flex-end; }
 .capital-watchlist-rowactions { display: inline-flex; align-items: center; justify-content: flex-end; gap: 2px; min-width: 0; }
-/* 「预测」与「复盘」= 动作列里的两枚**图标键**（2026-10-01 用户两次点名：不显示中文，靠 tooltip 说；
-   铺满整格的描边方块"太宽、显得笨、且挤"；座位从名称行挪回「操作」列，三个动作同栏才读得出"这一行能干什么"）。
-   图标取官方集里语义直的那两支：**靶心** IconGoalOutlineRegular = 那句话要的是未来走势与关键点位，
-   **带笔的清单** IconListPenOutlineRegular = 对着已发生的行情把这一行写一遍。字面只活在 aria-label 与
-   title 里，所以列宽与字体度量不再是这件事的约束——英文标签写成什么都不会溢出。
-   同一支笔照行内「更多」键来：透明底、无描边（一行里挂三个方框会抢读），hover 才落 bg-hover-accent
-   （bg-hover 在浅色只有 6%，透明底上等于没反应）；也不借用涨跌的红绿——它们不报数据。
-   26×24 是这一档图标键的下限，再小就成点不到的装饰。 */
+/* 26×24 is the minimum hit target for icon-only actions. */
 .capital-watchlist-review, .capital-watchlist-predict { flex: none; width: 26px; height: 24px; display: inline-flex; align-items: center; justify-content: center; border: none; border-radius: var(--dsw-radius-sm); background: transparent; color: var(--dsw-alias-label-secondary); cursor: pointer; }
 .capital-watchlist-review:hover:not(:disabled), .capital-watchlist-predict:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover-accent); color: var(--dsw-alias-label-primary); }
 .capital-watchlist-review:disabled, .capital-watchlist-predict:disabled { opacity: .45; cursor: not-allowed; }
-/* 底部一行：左列是「刷新报价」动词 + 它自己的整批失败行，右列是共用的更新时间。
-   flex-start 而不是 center：失败行出现时左列变高，居中的话更新时间会跟着往下坠。 */
 .capital-watchlist-footer { display: flex; align-items: flex-start; justify-content: space-between; gap: 10px; padding: 14px 20px 18px; border-top: .5px solid var(--dsw-alias-border-l2); }
 .capital-watchlist-footcol { display: flex; flex-direction: column; align-items: flex-start; gap: 6px; min-width: 0; }
-/* 刷新按钮底走官方 Tag 的 info 配方（state 色 + color-mix 透明档，要的是"轻"，实心 tertiary 在按钮上
-   会糊成一块色斑）；边框按口径例外：状态色 border 保持 1px，0.5px 那条只管中性 border。 */
 .capital-watchlist-refresh { display: inline-flex; align-items: center; gap: 6px; height: 34px; padding: 0 14px; border: 1px solid color-mix(in srgb, var(--dsw-alias-state-business-primary) 25%, transparent); border-radius: 10px; background: color-mix(in srgb, var(--dsw-alias-state-business-primary) 12%, transparent); color: var(--dsw-alias-state-business-primary); font-family: inherit; font-size: 13px; line-height: 20px; font-weight: 500; cursor: pointer; }
 .capital-watchlist-refresh:hover:not(:disabled) { background: color-mix(in srgb, var(--dsw-alias-state-business-primary) 20%, transparent); }
 .capital-watchlist-refresh:disabled { opacity: .45; cursor: not-allowed; }
-/* 34px = 刷新按钮的高度：与它同一行的时间按按钮高度行高居中，左列多出失败行也不受影响。 */
 .capital-watchlist-updated { font-size: 12px; line-height: 34px; color: var(--dsw-alias-label-tertiary); }
-/* flex: none：2026-10-08 起 hint 是下拉这个 flex 列的直接子元素（滚动区只剩选项那一层），
-   不钉住的话空间一紧它就会被压扁——hint 没有 overflow，压扁就是文字被裁。 */
 .capital-watchlist-hint { flex: none; padding: 8px 14px; font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-secondary); }
-/* 黄 = 动作没成。两条黄字都用 warn-label：官方"状态色用作文字"给的是 label 那一档，
-   warn-primary 压在浅底上只有 2:1，报错文字反而是最不该看不见的一行。 */
-/* 搜索失败：占下拉的 hint 位（与「搜索中…」「没有匹配的标的」同一个槽，替换而非并列）。
-   不写 padding——它骑在 .capital-watchlist-hint 的 8px 14px 上，只改颜色。 */
 .capital-watchlist-searcherror { color: var(--dsw-alias-state-warn-label); }
-/* 添加失败（list_full / ambiguous）：与输入无关，跟着搜索区坐着，改字不清它。 */
 .capital-watchlist-adderror { padding: 0 20px 10px; font-size: 12px; line-height: 18px; color: var(--dsw-alias-state-warn-label); }
-/* 整批刷新失败：红 = 数据不可信，贴在「刷新报价」下面（跟着动词走），不再居中飘到输入框下方。 */
 .capital-watchlist-notice { font-size: 12px; line-height: 18px; color: var(--dsw-alias-state-error-primary); }
 .capital-watchlist-empty { padding: 24px 20px; text-align: center; font-size: 13px; line-height: 20px; color: var(--dsw-alias-label-secondary); }
-/* 清单读取失败：占空态那一格，但颜色是"数据不可信"那一档（红）而不是空清单的次要灰。
-   写在 .capital-watchlist-empty 之后——两个类同落在这一行，靠源码序赢。 */
 .capital-watchlist-loaderror { color: var(--dsw-alias-state-error-primary); }
-/* 删除二次确认：贴在卡片内的绝对层（.dialog 的 overflow:hidden 顺带裁掉圆角外沿）。
-   常驻挂载 + 类切换，才有淡入淡出；visibility:hidden 的子节点天然退出 Tab 序。 */
 .capital-watchlist-confirm { position: absolute; inset: 0; z-index: 50; display: flex; align-items: center; justify-content: center; border-radius: 18px; background: var(--dsw-alias-bg-mask-1); opacity: 0; visibility: hidden; transition: opacity .2s var(--ds-ease-in-out), visibility .2s; }
 .capital-watchlist-confirm-open { opacity: 1; visibility: visible; }
-/* 确认盒是浮层，按官方模态卡口径画：border:0 + layer-2 + elevation-prominent，
-   不自己拿 bg-mask 当影子（浅底下 16% 描边 + 24% 黑影会糊成一团脏边）。 */
-/* 确认盒原先写死 280px：桌面端窗口拖窄时（92vw 小于约 320px）它比卡片还宽，被
-   capital-watchlist-card 的 overflow: hidden 裁掉——「取消 / 确认移除」两颗按钮直接够不着，
-   这一次删除既出不去也点不掉。跟着卡片收，280px 只是上限。 */
+/* Width follows the card, or a narrow window clips the buttons inside overflow:hidden. */
 .capital-watchlist-confirmbox { width: min(280px, calc(100% - 24px)); padding: 22px 20px 18px; border: 0; border-radius: 14px; background: var(--dsw-alias-bg-layer-2); box-shadow: var(--dsw-elevation-prominent); text-align: center; transform: scale(.95); transition: transform .2s var(--ds-ease-in-out); }
 .capital-watchlist-confirm-open .capital-watchlist-confirmbox { transform: scale(1); }
 .capital-watchlist-confirmtitle { font-size: 15px; line-height: 22px; font-weight: 600; color: var(--dsw-alias-label-primary); }
 .capital-watchlist-confirmdesc { margin-top: 8px; font-size: 13px; line-height: 1.5; color: var(--dsw-alias-label-secondary); }
 .capital-watchlist-confirmdesc strong { color: var(--dsw-alias-label-primary); font-weight: 500; }
 .capital-watchlist-confirmactions { display: flex; gap: 10px; margin-top: 20px; }
-/* 次要按钮灰底用 button-primary-dimmed（官方给"次要按钮"的实心档）：
-   interactive-bg-hover 在浅色只有 6%，两只按钮在白色确认盒上就只剩边框里的空气。 */
 .capital-watchlist-confirmbtn { flex: 1 1 0; height: 36px; border: none; border-radius: 10px; background: var(--dsw-alias-button-primary-dimmed); color: var(--dsw-alias-label-primary); font-family: inherit; font-size: 13px; line-height: 20px; font-weight: 500; cursor: pointer; }
 .capital-watchlist-confirmbtn:hover { background: var(--dsw-alias-interactive-bg-hover-accent); }
 .capital-watchlist-confirmdanger { border: 1px solid color-mix(in srgb, var(--dsw-alias-state-error-primary) 25%, transparent); background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 15%, transparent); color: var(--dsw-alias-state-error-primary); }
 .capital-watchlist-confirmdanger:hover { background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 25%, transparent); }
-/* 持仓这一簇住在「更多」菜单里（勾一下才长出比例那一行）。⛔ 这些选择器必须是**裸类**：菜单是
-   portal 到 document.body 的，".capital-watchlist-card …" 那种后代选择器够不到它，挂在那儿
-   的规则会静默不生效。颜色也一律走 --dsw-alias-*：card 上那对涨跌变量同样透不进去。
-   行的几何照官方 .item 抄（min-height 34 / padding 6px 8px / gap 6 / radius md / 13px 20px）：
-   自己发明的行高会在同一张菜单里长出三种节奏。 */
+/* Portal menu: selectors must be bare classes; card-scoped custom properties do not reach it. */
 .capital-watchlist-checkrow { box-sizing: border-box; display: flex; align-items: center; gap: 6px; width: 100%; min-height: 34px; padding: 6px 8px; border-radius: var(--dsw-radius-md); font-family: inherit; font-size: 13px; line-height: 20px; color: var(--dsw-alias-label-primary); text-align: left; }
-/* 行首图标照官方 .itemIcon 的几何（14x14、flex: none、menu-icon 色）：与「置顶」「移除」那两行
-   同一支位，图标大小一不一列才不抖。 */
 .capital-watchlist-checkicon { display: inline-flex; flex: none; width: 14px; height: 14px; align-items: center; justify-content: center; color: var(--dsw-alias-menu-icon); }
 .capital-watchlist-checklabel { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-/* 比例那一行：标题在左、−/读数/+ 在同一行的右边（2026-10-09 用户点名"和标记持仓一个级别"）。 */
 .capital-watchlist-stepper { box-sizing: border-box; display: flex; align-items: center; justify-content: space-between; gap: 10px; width: 100%; min-height: 34px; padding: 6px 8px; border-radius: var(--dsw-radius-md); font-size: 13px; line-height: 20px; color: var(--dsw-alias-label-primary); }
 .capital-watchlist-stepperlabel { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .capital-watchlist-stepperline { display: flex; align-items: center; justify-content: flex-end; gap: 8px; flex: none; }
-/* 步进键：小方键，描边与底面照搜索框那一条口径（中性描边 0.5px，状态色才 1px）。
-   半径刻意写 8px 而不是 999px / 50%：面板有一条"正圆与胶囊必须配 corner-shape: round"的
-   计数闸门，为一颗按键多配一对没有意义。 */
 .capital-watchlist-stepperbtn { flex: none; width: 26px; height: 26px; display: inline-flex; align-items: center; justify-content: center; border: 0.5px solid var(--dsw-alias-border-l1); border-radius: 8px; background: var(--dsw-alias-bg-module-platform); color: var(--dsw-alias-label-secondary); font-family: inherit; font-size: 15px; line-height: 1; cursor: pointer; }
 .capital-watchlist-stepperbtn:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover-accent); }
 .capital-watchlist-stepperbtn:disabled { opacity: .45; cursor: not-allowed; }
-/* 读数：min-width 让 0~100 / 10% / 100% 这几种写法都不把两边的键推走（数字用 tabular-nums）。
-   没填的时候显示的就是这一格的**剩余额度**（0~N），不再写"未填"（用户点名用 placeholder 提示）；
-   placeholder 降一档颜色，免得"没这个数"读起来像一个数。 */
 .capital-watchlist-stepperreadout { min-width: 46px; text-align: center; font-size: 13px; line-height: 18px; font-variant-numeric: tabular-nums; color: var(--dsw-alias-label-primary); }
 .capital-watchlist-stepperplaceholder { color: var(--dsw-alias-label-tertiary); }
-/* ⛔ 这张菜单必须**固定宽度**，不能按内容长。官方 .list 只给 min-width（收缩到内容宽），
-   而我们是 align:'end' 贴右缘开的——比例那一行一出现就把列表撑宽几十像素，左缘整块跳一下
-   （2026-10-09 实机："点击标记后整个 div 严重位移"）。同一处内容超出还会长出横向滚动条：
-   .scrollable .viewport 写了 overflow-y:auto，按 CSS 口径 overflow-x 就计算成 auto。
-   256 = 列表自身 4px padding × 2 + 最宽那一行的内容（图标行与比例行都在 205 上下），
-   中英两套语言都不截断。 */
+/* Fixed width: content-sized growth from the stepper row shifts the whole right-aligned menu. */
 .capital-watchlist-rows { width: 256px; }
-/* 行内的每一颗按钮都按 border-box 算宽：官方 .item 是 width:100% + padding 6px 8px 而**没有**
-   声明 box-sizing（这套主题没有全局 border-box 重置，只有 .list / .root 自己声明了），于是它天然
-   比列表内容盒宽 16px——那 16px 就是上面那条横向滚动条的另一半。
-   选择器根在我们自己挂在 portal 列表上的类，所以够得着（后代链没有离开这张列表）。 */
+/* Theme has no global border-box reset; the official item padding would overflow the list. */
 .capital-watchlist-rows button { box-sizing: border-box; }
 `
 
@@ -693,12 +402,8 @@ function installStyles() {
 }
 
 /**
- * 与 host 路由的唯一出口：JSON 进、JSON 出，业务失败按 code 上抛。
- *
- * 成功判据是**正文里的 `ok:true`**，不是 HTTP 状态——`{}` / 一段 HTML / 一个 200 的意外响应
- * 都不许被当成"清单是空的"（那正好是把服务故障说成"你还没有自选股"）。状态码在这里只用来
- * 补正文没给的判据：401 / 403 讲的是"这个页面已经不属于你了"，把它翻译成"行情服务暂时不可用"
- * 会把用户支去等一个根本不会恢复的错误。
+ * Success is `ok: true` in the body, not the HTTP status: 401 / 403 must surface
+ * as unauthorized instead of an empty list or a service error.
  */
 async function call(path, { query, body, signal } = {}) {
   const url = query !== undefined ? `${ROUTE}${path}?${query}` : `${ROUTE}${path}`
@@ -720,7 +425,6 @@ async function call(path, { query, body, signal } = {}) {
   const error = new Error(code)
   error.code = code
   error.candidates = payload.candidates
-  // `list_full` 带着宿主的 `limit`：那句"最多 N 条"的数字只有一个真值源（服务端常量）。
   error.limit = payload.limit
   throw error
 }
@@ -733,84 +437,42 @@ const blank = () => ({
   items: [],
   candidates: [],
   truncated: false,
-  /**
-   * 候选筛选头（`all` / `cn` / `hk` / `us`，**默认 `all`**）。住 store 而不是组件 `useState`：
-   * 两条复位路径各归各的——面板重开（`open()` 的 `...blank()`）回到「全部」；换词**不**掰回
-   * （用户筛了港，下一个词他还想看港），清空输入也留着（下拉收起时它本来看不见）。
-   */
+  /** Filter lives here so a panel reopen resets it; changing the query keeps it. */
   marketFilter: 'all',
   query: '',
-  /** 下拉是否盖在清单上：由输入打开、由选中/点到框外收起（Esc 也收，见组件的 onKeyDown）。 */
   dropdownOpen: false,
-  /**
-   * 行内「更多」菜单开在哪一行（`thscode`；null = 都关着）。开合状态住 store 而不是组件的
-   * `useState`：面板关掉再打开时，`open()` 的 `...blank()` 会把上一轮的菜单一起收走。
-   */
+  /** Menu state lives here so `open()` reset closes it. */
   rowMenu: null,
   /**
-   * 待移除的那一行（null = 确认层收起）。**必须与 `rowMenu` 住同一个地方**：它原先是组件的
-   * `useState`，而面板关闭走的是 `return null`（座位常驻，组件不卸载，2.5.3 review 里那条
-   * blocker 就是从这里来的）——确认层于是跨开合活了下来：用户点遮罩关掉面板、下次重开，
-   * 第一屏就是「确定将上一轮那只票移除吗？」，顺手一按就删掉了这次根本没打算动的标的。
+   * Must live beside `rowMenu`: closing renders null instead of unmounting, so
+   * component state would survive and reopen the confirm layer on the next panel.
    */
   pendingRemove: null,
-  /**
-   * 持仓**没有**自己的 store 格（2026-10-09 由"另开一层表单 + 一格草稿"改成菜单内勾选）：
-   * 标没标、比例多少都在那一行的 `holding` 上，步进器开在哪一行就是 `rowMenu`。
-   * 这是 2.5.3 那条 blocker（座位常驻、组件不卸载 ⇒ 表单跨开合活下来）的**结构性**解法——
-   * 没有一份"只活在表单里"的状态，就没有一份能活过关面板的草稿。
-   */
-  /** 整批共用的一次刷新时刻（底部那一行就报它）。 */
   refreshed_at: null,
-  /** 整批级失败：红字跟在「刷新报价」下面（数据不可信那一档）。 */
   error: null,
-  /**
-   * 搜索这一路失败（限流 / 服务不可用）：黄字占下拉的 hint 位。
-   * 与 `addError` **分开两个字段**是刻意的——两者清空的时机不同（见 `onQueryChange`）。
-   */
+  /** Separate from `addError`: the two clear at different times. */
   searchError: null,
-  /** 某一路检索挂了：候选照常给其余路，这一句只说挂掉的那一路（R12）。 */
   searchPartial: null,
-  /** 添加动作的失败（list_full / ambiguous）：与输入无关，显示在搜索区下方，改字不清它。 */
   addError: null,
-  /**
-   * 清单**读回来失败**（域打不开 / 登录失效 / 服务挂了）：占列表那一片的位置。
-   * 没有这一格，一次 503 就会渲染成"还没有自选股，用上面的输入框添加。"——服务端为了不
-   * 骗用户专门把域失败报成 `store_unavailable`，客户端不能把它翻译成空清单。
-   */
+  /** A 503 must not render as an empty list. */
   loadError: null,
-  /** 逐标的失败：只影响那一行。 */
   failures: {},
-  /**
-   * 输入法合成期（拼音还没上屏）。住在 store 而不是 surface 字段上，是为了让**渲染**能看见它：
-   * 合成期不许提前报「没有匹配的标的」（那是把"还没查"说成"查了，没有"，正是文件头要消掉的假话）。
-   * 同时它有了第二条复位路径（`onQueryChange` 读原生事件的 `isComposing`）——个别输入法会丢掉
-   * `compositionend`，只靠那一个事件复位就会把搜索整块闩死。
-   */
+  /** Composition must be visible to render; `isComposing` is the reset path (some IMEs drop `compositionend`). */
   composing: false,
-  /** 换了词、防抖还没到 / 请求在途：下拉此刻没有可点的候选，hint 说"搜索中"而不是"没有匹配"。 */
   pendingSearch: false,
 })
 
-/**
- * 一个会话一个 surface（座位是 session scope，`inject(sessionId)` 每会话调一次）。
- * 开合与数据全住在这一个 store 里，组件通过 `useDialog` 订阅。
- */
+/** One surface per session (session-scoped slot); open state and data live in this store. */
 class WatchlistSurface {
   constructor() {
     this.store = createSnapshotStore(blank())
     this.searchController = null
     this.timer = null
     this.pending = null
-    /** 上一次**真正发出去**的查询词（去重用；`composing` 期间的拼音片段不算发过）。 */
     this.lastQuery = null
     /**
-     * 在途的持仓写：`thscode → { seq, baseline }`。
-     *
-     * 为什么要有这一格：勾选之后用户可以连按 `+`，每一次都是一条 `/holding`，而**HTTP 回包的先后
-     * 顺序不由服务端的写锁决定**（锁排的是写入，不是响应到达）。没有这一格，早先那一次的回包会
-     * 晚到并把行改回旧比例——下一次 `+` 从那个旧值起步，用户看到的是"按了不动"。
-     * `baseline` 是最近一次**宿主确认过**的那一行，失败时只回滚这一行到它（⛔ 不复原整张数组）。
+     * Out-of-order `/holding` replies: keep only the latest `seq` and roll back one
+     * row to its last host-confirmed baseline, never the whole array.
      */
     this.holdingOps = new Map()
   }
@@ -827,7 +489,6 @@ class WatchlistSurface {
     this.store.update((draft) => Object.assign(draft, changes))
   }
 
-  /** 打开即一次数据请求：清单先出，报价同一次动作里刷一次（空清单不出网）。 */
   open() {
     this.patch({ ...blank(), open: true, loading: true })
     this.load().then(() => this.refresh(), () => this.patch({ loading: false }))
@@ -837,28 +498,25 @@ class WatchlistSurface {
     if (this.timer !== null) clearTimeout(this.timer)
     if (this.searchController !== null) this.searchController.abort()
     this.lastQuery = null
-    // 合成状态跟着一起归零：面板关在半个拼音上（用户直接点遮罩），`composing` 留在 true 的话，
-    // 下次打开时输入框里那几个字母会照常发 `input`，而搜索被一条再没人复位的状态永久闩死。
-    // `rowMenu: null` 现在也管着持仓：菜单收了，比例步进器就跟着没地方画（它住在菜单那一格里）。
+    // Reset composition too: leaving it true would permanently latch searches.
     this.patch({ open: false, rowMenu: null, composing: false, pendingSearch: false })
-    // 在途的持仓写一并作废：清单是重开的，那一次回执说的已经不是眼前这一屏了。
+    // In-flight holding replies no longer describe this screen.
     this.holdingOps.clear()
   }
 
   async load() {
     try {
       const payload = await call('/list')
-      // 整张清单换掉 = 宿主说了为准：任何在途的持仓回执都不许再落回行上（见 `holdingOps`）。
       this.holdingOps.clear()
       this.patch({ items: cleanRows(payload.items) ?? [], seeded_at: payload.seeded_at, loading: false, loadError: null })
     } catch (error) {
       this.patch({ loading: false, loadError: { code: error.code ?? 'fuyao_unavailable' } })
-      // 继续上抛：`open()` 靠这个 rejection 决定"清单都没读到，不要再花一次出网刷报价"。
+      // `open()` uses the rejection to skip the refresh when the list never loaded.
       throw error
     }
   }
 
-  /** 单闸门：开面板与手动刷新共用，重复点击不会排第二个请求。 */
+  /** Single gate shared by panel open and manual refresh. */
   refresh() {
     if (this.pending !== null) return this.pending
     this.patch({ refreshing: true })
@@ -868,26 +526,21 @@ class WatchlistSurface {
         for (const item of payload.failures ?? []) failures[item.thscode] = item.code
         const landed = cleanRows(payload.items)
         const items = landed ?? this.snapshot.items
-        // 刷新整张换掉清单（宿主的写回带着 `holding`，见 store 那条"刷新写回不许抹掉刚标的持仓"）：
-        // 在途的持仓回执就此作废——让它去改一张已经不是眼前这一屏的表，会把刚落地或刚撤销的
-        // 标记又画回来。落不下来的那一次（回包没有 items）不动这份账，屏上还是原来那张表。
+        // A landed list invalidates in-flight holding replies; no items leaves the screen alone.
         if (landed !== null) this.holdingOps.clear()
         this.patch({
           items,
-          // 整批一条都没落地时宿主回 `null`：底部那行时间讲的是"最后一次真取到数"，
-          // 跟着一次失败的点击往前走，就成了每一行都陈旧、只有页脚是新的。
+          // `null` = nothing landed; the footer keeps the last real success time.
           refreshed_at: payload.refreshed_at ?? this.snapshot.refreshed_at,
           failures,
-          // ⛔ 「其他标的仍是上一次成功快照」只在**确实还有**没被这次失败波及的行时才挂：
-          // 全批一起失败时（上游整个挂掉就是这种），满屏都标着陈旧，那句"其他"是假话，
-          // 会把"这份数据整体不可信"说成"只有几行有问题"。
+          // "Other symbols still show a snapshot" only when some row is actually unaffected.
           error: payload.error
             ? { code: payload.error.code, partial: items.length > 0 && items.some((row) => failures[row.thscode] === undefined) }
             : null,
         })
       })
       .catch((error) => {
-        // 同一条口径：这一次出网什么都没拿到，屏上还有旧快照可看才谈得上"仍是上一次成功快照"。
+        // Same rule: only claim a previous snapshot if old values are still on screen.
         this.patch({
           error: {
             code: error.code ?? 'fuyao_unavailable',
@@ -904,23 +557,14 @@ class WatchlistSurface {
   }
 
   /**
-   * 输入框每敲一下都走这里，但**敲字 ≠ 要查**——`/search` 直连上游且无缓存，一次输入
-   * 逐字母出网就是"打爆上游"的那条路（中文尤其明显）。三条闸：
-   *  1. 尾部防抖：停手 `SEARCH_DEBOUNCE_MS` 才发，中途的字符只作废上一个定时器；
-   *  2. IME 合成期不发：拼音输入法逐字母敲的是 `input` 事件，`ning` / `ningd` 那串片段
-   *     既查不出东西（每次都是"没有匹配的标的"闪一下），又不是用户要的词；
-   *  3. 同一个词不重发：清空重打、光标移位、compositionend 之后浏览器再补一次 `input`，
-   *     都不该多出一次网。
-   * 永远只有一条在途请求（`search` 里 abort 上一条）。
-   * @param isComposing 原生 `input` 事件的 `isComposing`（缺省时沿用 store 里的值）——
-   *   复位以它为准，`compositionend` 只是加速器而不是唯一路径：丢掉那个事件的输入法否则会把
-   *   搜索永久闩死（现象是输入框再也查不出东西，且没有任何地方报错）。
+   * Typing is not querying: `/search` hits upstream uncached, so three gates apply —
+   * trailing debounce, no send during IME composition, and no resend of the same
+   * term. Only one request is in flight.
    */
   onQueryChange(query, isComposing) {
     const trimmed = query.trim()
     const composing = isComposing === undefined ? this.snapshot.composing === true : isComposing === true
-    // 改字清的是"上一次搜索没成"（那一行正被新的在途请求取代）；**不清** `addError`——
-    // `list_full` 讲的是清单，跟输入框里是什么字无关。
+    // Typing clears the failed search, never `addError` (list_full is unrelated to the query).
     this.patch({ query, searchError: null, composing, dropdownOpen: trimmed.length > 0 })
     if (this.timer !== null) clearTimeout(this.timer)
     if (trimmed.length === 0) {
@@ -929,22 +573,18 @@ class WatchlistSurface {
       this.patch({ candidates: [], truncated: false, searching: false, pendingSearch: false })
       return
     }
-    // 词一换，上一个词的结果就不再是这一屏的合法候选：留在下拉里，用户点下去添加的是
-    // **和输入框不同名**的那只票（⛔ 2.5.3 review 的 blocker：清空重打时窗口很宽）。
-    // 同一个词、且它的回包已经落地才是不必重发（去重记在 `lastQuery` 上）。
+    // Old results are not candidates for the new term; a landed same-term reply is reused.
     if (trimmed === this.lastQuery && this.snapshot.pendingSearch === false) return
     this.patch({ candidates: [], truncated: false, pendingSearch: !composing })
     if (composing === true) return
     this.timer = setTimeout(() => this.search(trimmed), SEARCH_DEBOUNCE_MS)
   }
 
-  /** 合成开始：这段输入不是查询词，先把在途的防抖撤掉（上一次上屏的词已经没有意义了）。 */
   beginComposition() {
     if (this.timer !== null) clearTimeout(this.timer)
     this.patch({ composing: true })
   }
 
-  /** 上屏：这一刻才拿真正的词走一次正常路径。 */
   endComposition(query) {
     this.onQueryChange(query, false)
   }
@@ -953,35 +593,25 @@ class WatchlistSurface {
     this.patch({ dropdownOpen: false })
   }
 
-  /**
-   * 筛选头（全部 / CN / HK / US）：只换**显示**哪几行，不出网——候选是一次拿全的，
-   * 切档也不该把下拉收起（它就在下拉顶上）。
-   * 未知档名直接忽略：这一格的取值只有 `MARKET_FILTERS` 那四个，拼错的值不许让下拉变空白。
-   */
+  /** Display-only filter; unknown ids are ignored so a typo cannot blank the dropdown. */
   setMarketFilter(filter) {
     if (!MARKET_FILTERS.some((entry) => entry.id === filter)) return
     this.patch({ marketFilter: filter })
   }
 
-  /** 行内「更多」键：再点一次就收起（同一个键既开又关，不用去别处找关闭入口）。 */
   toggleRowMenu(thscode) {
     this.patch({ rowMenu: this.snapshot.rowMenu === thscode ? null : thscode })
   }
 
-  /** 官方 Menu 的 onClose（点到外面 / Escape）与选中之后都走这里。 */
   closeRowMenu() {
     if (this.snapshot.rowMenu !== null) this.patch({ rowMenu: null })
   }
 
-  /** 待移除那一行住 store（见 `blank()` 里那一格）：`open()` 的 `...blank()` 才收得走它。 */
   setPendingRemove(item) {
     this.patch({ pendingRemove: item ?? null })
   }
 
-  /**
-   * 用宿主回包那一条覆盖这一行：标记时刻归服务端（浏览器钟不比它准），名字再走一遍
-   * `cleanRows`——显示、tooltip、aria-label 与递进输入框那句话因此还是同一个名字。
-   */
+  /** Overwrite one row with the host's copy; the server owns `marked_at`; scrub the name again. */
   replaceRow(row) {
     const [clean] = cleanRows([row])
     if (clean === undefined || typeof clean?.thscode !== 'string') return
@@ -994,25 +624,21 @@ class WatchlistSurface {
     const controller = new AbortController()
     this.searchController = controller
     this.patch({ searching: true, searchError: null, searchPartial: null })
-    // 回包落地前再看一眼输入框：从发出到返回这段时间里用户可能已经改字（新词只排了个防抖
-    // 定时器，还没出网）。那一串候选属于**上一个词**，画出来就是能被点错的那一行——丢掉，
-    // 让新词的定时器自己去查。
+    // Drop results for a term the user already changed; let the new debounce run.
     const stillCurrent = () => this.snapshot.query.trim() === query
     try {
       const payload = await call('/search', { query: `q=${encodeURIComponent(query)}`, signal: controller.signal })
       if (!stillCurrent()) {
-        // 被弃掉的那一次不许留下转圈的搜索态（新词还没出网时，spinner 说的是上一个词）。
         this.patch({ searching: false })
         return
       }
       this.patch({ candidates: cleanRows(payload.items) ?? [], truncated: payload.truncated === true, searching: false, pendingSearch: false, searchPartial: Array.isArray(payload.partial) && payload.partial.length > 0 ? payload.partial : null })
     } catch (error) {
       if (error.name === 'AbortError') return
-      // 失败不记在"这个词查过了"的账上：同样几个字重打一遍还得能再出网。
+      // A failure is not "this term was checked": retyping it must search again.
       if (this.lastQuery === query) this.lastQuery = null
       if (!stillCurrent()) return
-      // 走 `searchError` 而不是 `addError`：它占下拉的 hint 位，替换掉「没有匹配的标的」——
-      // 同一屏不许一边说"没有这个票"、一边说"服务限流"（候选清空了，noHit 本来就会亮起来）。
+      // Search errors replace the no-hit hint; the same screen must not say both.
       this.patch({ candidates: [], truncated: false, searching: false, pendingSearch: false, searchError: { code: error.code ?? 'fuyao_unavailable' }, searchPartial: null })
     }
   }
@@ -1021,34 +647,23 @@ class WatchlistSurface {
     try {
       await call('/add', { body: { thscode: candidate.thscode } })
     } catch (error) {
-      // 歧义与超限是"添加"这个动作的失败：留在搜索区（黄），不去占刷新那条红字的位置。
+      // Ambiguity / cap are add failures: stay in the search area, not the refresh notice.
       this.patch({ addError: { code: error.code ?? 'fuyao_unavailable', candidates: error.candidates, limit: error.limit } })
       if (error.candidates !== undefined) this.patch({ candidates: error.candidates, truncated: false })
       return
     }
-    // ⛔ 上面那一下成功之后，**任何后续失败都不许再写成「添加失败」**（原先整段在一个
-    // try 里：`/add` 已经落库、紧接着清单读回来 503，面板就报"自选股已达上限"式的黄字，
-    // 用户照着再点一次——同一个标的被加了第二遍）。读清单的失败归 `loadError`（列表那
-    // 一片），刷报价的失败归 `error`（页脚那条红字），各自有位置，都不占添加这句话。
-    // ⛔ 成功之后**不再收下拉、不清输入**（2026-10-08 用户点名"能在下拉框里连续添加"）：
-    // 收起 = 每加一条都得重敲一遍词，"连续添加"根本无从谈起。这一行当场标 `已添加` 并随行禁用
-    // （幂等，点不进第二次），其余候选、筛选档与输入框里的词都原样留着。`lastQuery` 因此保持原值
-    // ⇒ 同一个词不会被重发（三条闸里"同一个词不重发"那条正是靠它）。
-    // ⛔ `searchError` / `searchPartial` 也**不清**：它们说的是"这次搜索有一路没参与"，下拉还开着，
-    // 把真话擦掉就是让它失效。
+    // After success, later failures must not be reported as add failures (the symbol is
+    // already stored). Keep the dropdown and query open for consecutive adds; the row is
+    // marked added and disabled, and `lastQuery` stays so the same term is not resent.
     this.patch({
       addError: null,
       candidates: this.snapshot.candidates.map((row) => (row.thscode === candidate.thscode ? { ...row, in_list: true } : row)),
     })
     await this.load().catch(() => {})
-    // 添加是一次完整动作：读完清单顺手刷一次报价，新行当场就有价。停在「未刷新」
-    // 等于把用户刚加的东西留成半成品——开面板那一步本来就是同一套 load→refresh。
+    // Adding is a full action: reload and refresh so the new row has a quote immediately.
     await this.refresh()
-    // ⛔ 上面那一次可能被单闸门折叠进了**为上一批标的**出的在途请求：它的回包里没有刚加的
-    // 这一行，于是新行停在「未刷新」、页脚却报刚刚刷过（2.5.3 review 的 blocker 3）。面板一
-    // 打开就自动刷新，清单里有 ETF 时那一批要跑几十秒，窗口很宽——用户正是在这时候点候选的。
-    // 落地后核对：这一行既没报价、又没被记失败（说明它根本没被问过），就补发一次真刷新。
-    // 仍然只在用户"添加"这一下动作里，不轮询、不自动重试。
+    // The refresh can be folded into an in-flight batch that never asked this row. If it has
+    // no quote and no recorded failure, ask once more — still only inside this user action.
     const landed = this.snapshot.items.find((item) => item.thscode === candidate.thscode)
     if (landed !== undefined && landed.quote === null && this.snapshot.failures[candidate.thscode] === undefined) {
       await this.refresh()
@@ -1060,8 +675,7 @@ class WatchlistSurface {
     this.patch({ items: before.filter((row) => row.thscode !== thscode), rowMenu: null })
     try {
       await call('/remove', { body: { thscode } })
-      // 清单腾出一格，"最多 10 条，先删一条再加"当场不再成立：成功移除顺手清掉这句。
-      // 只清 `list_full`——`ambiguous` 讲的是上一次添加的歧义，与清单空位无关。
+      // A successful removal frees a slot, so a stale `list_full` no longer applies.
       if (this.snapshot.addError?.code === 'list_full') this.patch({ addError: null })
     } catch {
       this.patch({ items: before })
@@ -1069,9 +683,8 @@ class WatchlistSurface {
   }
 
   /**
-   * 置顶：先把这一行提到第一行（乐观），再让宿主把 `pinned_at` 写进域。
-   * 失败回滚成原顺序——与 `remove` 同一条口径：面板不弹错框，行自己弹回去就是回执。
-   * 返回的 `items` 是宿主的排序真值（服务端只记时间戳，顺序由读法决定）。
+   * Pin optimistically, then let the host write `pinned_at`; failure restores only
+   * the order, never row contents changed by other actions meanwhile.
    */
   async pin(thscode) {
     const before = this.snapshot.items
@@ -1082,9 +695,7 @@ class WatchlistSurface {
       const payload = await call('/pin', { body: { thscode } })
       if (Array.isArray(payload.items)) this.patch({ items: cleanRows(payload.items) })
     } catch {
-      // ⛔ 失败只复原**顺序**，不复原每一行的内容：整张数组复原会把这一段时间里落地的其它改动
-      // （刚标上的持仓、刚加进来的行）一起倒回点击前——那些是别的动作的成功回执，域里也已经有了。
-      // 期间被移除的行不补回，末尾接上期间新到的行。
+      // Restore order only; other rows may have landed changes. Keep new rows at the end.
       const current = this.snapshot.items
       const ordered = before.map((row) => current.find((entry) => entry.thscode === row.thscode)).filter(Boolean)
       const known = new Set(ordered.map((row) => row.thscode))
@@ -1093,13 +704,8 @@ class WatchlistSurface {
   }
 
   /**
-   * 持仓这一格的**唯一**写路径：乐观改那一行 → 恰好一次 `/holding` → 用宿主那一条覆盖，
-   * 失败只把那一行弹回最近一次宿主确认的值。
-   *
-   * 两道闸都是为"连点"存在的（见 `holdingOps`）：
-   *  - 回执只认最新那一次意图（`op.seq`），晚到的旧回包直接丢弃——否则用户看到的是"按了不动"；
-   *  - 回滚逐行，不整张复原——否则一次失败的 `+` 会把**别的行**刚落地的一切一起抹掉。
-   * ⛔ 这里也不碰 `rowMenu`：改比例是"在这一行里继续操作"，收起菜单就是把用户刚点的东西拿走。
+   * Only write path for holding: optimistic row → exactly one `/holding` → replace
+   * with the host row, or roll that single row back. Never touches `rowMenu`.
    */
   async writeHolding(thscode, body, nextRow) {
     const target = this.snapshot.items.find((row) => row.thscode === thscode)
@@ -1122,16 +728,12 @@ class WatchlistSurface {
     }
   }
 
-  /**
-   * 标记持仓 = 恰好一次 `/holding`。`weightPct` 传 `null` 是"标了持仓、比例没填"，与 0 是两句话
-   * （域 schema 同一条口径：没有这个数 ≠ 这个数是零）——勾选那一刻发的就是这一档。
-   */
+  /** `null` means held without a weight; 0 is a distinct real value. */
   markHolding(thscode, weightPct) {
     return this.writeHolding(thscode, { thscode, weight_pct: weightPct },
       (row) => ({ ...row, holding: { weight_pct: weightPct, marked_at: Date.now() } }))
   }
 
-  /** 取消持仓 = 只抹那一格，**关注条目本身不动**（它不是"移除"，也不该有任何位移）。 */
   clearHolding(thscode) {
     return this.writeHolding(thscode, { thscode, clear: true }, (row) => {
       const next = { ...row }
@@ -1141,13 +743,8 @@ class WatchlistSurface {
   }
 
   /**
-   * 比例 ± 一档。⛔ 不吸附：域里存着 `37.5`（旧版自由文本填的）就 ±10 得 `47.5 / 27.5`——
-   * 把一个用户亲手写过的数掰成 10 的整数倍，等于替他说了一句他没说的话（与工具侧
-   * "自报值原样引用"同一条线）。"未填"没有数值起点：第一次 `+` 落 10，那一档的 `−` 是置灰的。
-   *
-   * 顶上封的是 `weightCeiling`（单只 100 与"120 减掉其余持仓"取小的）：面板把 `+` 置灰与这里
-   * 夹住用的是同一个减法，宿主 `/holding` 拒绝用的也是它（AGENTS.md §9.7）。这里夹住是必需的，
-   * 不只是"按钮已经灰了"：调用点还有一颗 `+` 之外的入口（键盘连按时屏幕上的额度是上一帧的）。
+   * No snapping: 37.5 ± 10 stays 47.5 / 27.5, never rounded. The ceiling is the
+   * same single-row / remaining-total rule the host enforces.
    */
   stepHolding(thscode, delta) {
     const rows = this.snapshot.items
@@ -1158,15 +755,11 @@ class WatchlistSurface {
     return this.markHolding(thscode, next)
   }
 
-  /**
-   * 留档后门：**面板上没有按钮**（用户反馈"挺那个啥的"）。真要用的时候，
-   * 从 devtools 拿到该会话的 surface 调 `await surface.copyToClipboard()`。
-   */
+  /** Dev-only escape hatch: no panel button; call `surface.copyToClipboard()` from devtools. */
   async copyToClipboard() {
     const lines = this.snapshot.items.map((row) => [
       row.thscode,
       scrubInvisible(row.name),
-      // 留档走机器可读的 `asset_type` 原值，不走界面语言的类型词：这份 TSV 是拿来归档/再处理的。
       row.asset_type,
       row.quote?.price ?? '',
       row.quote?.change_pct ?? '',
@@ -1189,17 +782,13 @@ function formatTime(value) {
   return `${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`
 }
 
-/** 类型徽标：候选行与数据行共用同一支笔（文案与配色都在这两处一次对齐）。 */
 function TypeTag({ assetType, t }) {
   return h('span', { className: `capital-watchlist-tag ${TYPE_TONES[assetType] ?? 'capital-watchlist-tag-cn'}` }, typeLabel(assetType, t))
 }
 
 /**
- * 「预测」与「复盘」共用的**形状**：`<前缀>名称 (thscode · 品种)<后缀>`。
- * 括号、空格与中点是结构，写死在这里（中英文同一形状）；句子两半住字典的
- * `<kind>PromptPrefix` / `<kind>PromptSuffix`（kind 是 `predict` / `review`），改文案去那儿改。
- * 中间那个品种词读 `KIND_LABEL_KEYS`，**不是徽标那套市场词**：Agent 靠它选端点
- * （股票 / 指数 / 场内基金是三个不同上游），市场由 thscode 自己带。
+ * Prompt shape `<prefix>name (thscode · kind)<suffix>`; kind is endpoint family.
+ * The Agent picks an endpoint from stock / index / ETF; market comes from thscode.
  */
 function promptOf(item, t, kind) {
   const name = scrubInvisible(item.name)
@@ -1207,13 +796,8 @@ function promptOf(item, t, kind) {
 }
 
 /**
- * 最新价在上、涨跌幅在下，右对齐；两位小数，红涨绿跌按 A 股习惯。
- * "这一行本次没取到数"**不是**"这一行没有数"：后端只覆写成功的记录，上一次成功的快照仍在
- * `quote` 里，所以画法是四态而不是两态——
- *  1. 在途且还没有任何值 → skeleton；
- *  2. 本次失败、从来没有过值 → 红色 `—`（数据不可信那一档）+ 原因；
- *  3. 本次失败、但手上有旧快照 → 值照画，两行降一档色，tooltip 说清是哪一刻的；
- *  4. 从没刷过 → 「未刷新」。
+ * Quote has four states: skeleton, red dash with no prior value, last good snapshot
+ * (dimmed + tooltip), or "not refreshed".
  */
 function QuoteCell({ quote, failureCode, refreshing, t }) {
   const stale = failureCode !== undefined
@@ -1229,9 +813,7 @@ function QuoteCell({ quote, failureCode, refreshing, t }) {
     }
     return h('div', { className: 'capital-watchlist-quote' }, h('div', { className: 'capital-watchlist-price' }, t('notRefreshed')))
   }
-  // 涨跌可以是"没有"（停牌 / 未开盘时上游回 null，而最新价仍然有值）。这一档**不许**画成
-  // 0.00%：0 在 A 股口径里是"今日平盘"这个真值，借用它就把一个未知说成了结论。破折号 + 次要灰，
-  // 与红/绿/平三档并列为第四档，读法上是"这个数还没出"。
+  // Missing change is missing, never 0.00% (0 is a real flat day).
   const hasPct = typeof quote.change_pct === 'number' && Number.isFinite(quote.change_pct)
   const pct = hasPct ? `${quote.change_pct > 0 ? '+' : ''}${quote.change_pct.toFixed(2)}%` : '—'
   const tone = stale
@@ -1239,10 +821,7 @@ function QuoteCell({ quote, failureCode, refreshing, t }) {
     : !hasPct
       ? 'capital-watchlist-nodata'
       : quote.change_pct > 0 ? 'capital-watchlist-up' : quote.change_pct < 0 ? 'capital-watchlist-down' : 'capital-watchlist-flat'
-  /**
-   * tooltip 的三句话按本次状态拼：失败原因 + 上一次快照时刻（陈旧行）、"暂无涨跌数据"（价有涨跌没有）、
-   * 交易所当地时间（**只有港美股那一路带 `source_time`**，A 股那一路没有这格就不画、不编一句）。
-   */
+  /** Failure reason + snapshot time, plus exchange-local time when provided. */
   const exchange = typeof quote.source_time === 'string' && quote.source_time.length > 0
     ? `${t('exchangeTime')} ${quote.source_time}`
     : ''
@@ -1258,11 +837,7 @@ function QuoteCell({ quote, failureCode, refreshing, t }) {
     h('div', { className: `capital-watchlist-change ${tone}` }, pct))
 }
 
-/**
- * 添加失败那一行的文案。只有 `list_full` 特殊：那句里的数字归宿主（`limit`），
- * 客户端不许再存一份常量副本——2.5.2 就是服务端一个 `MAX_ITEMS` + 中英文字典各写一遍"10"，
- * 这次抬到 30 时只会改红一边。没有 `limit` 的旧回包退到不带数字的那句，绝不把 `{max}` 印出来。
- */
+/** `list_full` uses the host's `limit`; never print the `{max}` placeholder. */
 function addErrorText(t, addError) {
   if (addError.code !== 'list_full') return t(`error.${addError.code}`)
   const limit = addError.limit
@@ -1271,12 +846,8 @@ function addErrorText(t, addError) {
 }
 
 /**
- * 持仓那句话：没填比例就是光秃秃两个字，填了就跟着数字。
- * 数字是**用户自报**的占比、不是这里算出来的，所以原样给——补成 `20.00%` 会像一位从市值
- * 除出来的数，而面板从来没有市值。
- *
- * 2026-10-09 起它不再是一枚徽标，而是**名称的 tooltip**（`nameTitle`）：行上改成名称标红，
- * 而红与"红涨"同色，所以这句话必须还有一条不靠颜色的通道。
+ * User-reported weight, printed as entered; no market value exists to justify
+ * reformatting. Red is not the only channel: the name tooltip repeats this.
  */
 function holdingLabel(holding, t) {
   const weight = holding?.weight_pct
@@ -1284,7 +855,6 @@ function holdingLabel(holding, t) {
   return `${t('holdingName')} ${weight}%`
 }
 
-/** 名称那一格 tooltip：`名称 代码`，标过持仓的再跟着那一句自报的标记。 */
 function nameTitle(item, t) {
   const base = `${item.name} ${item.ticker}`
   return item.holding === null || item.holding === undefined ? base : `${base} · ${holdingLabel(item.holding, t)}`
@@ -1294,16 +864,13 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
   const state = useDialog((value) => value)
   const [busy, setBusy] = useState(false)
   /**
-   * 在途的那一次「添加」落在哪一行（null = 没有）。⛔ 与 `busy` 分开：`busy` 关的是**清单那半边**
-   * （预测 / 复盘 / 更多 / 刷新按钮），候选行只许禁它自己那一条——全禁的话，"连续添加"会被每一次
-   * 在途请求打断（第二条正灰着、点不进去）。并发添加是安全的：服务端把清单读写串在一条队列上。
+   * Which row's add is in flight. Separate from `busy`: candidates disable only
+   * themselves so consecutive adds are not interrupted.
    */
   const [addingThscode, setAddingThscode] = useState(null)
   /**
-   * 待移除的那一行，走面板内的二次确认层——不是 `window.confirm`：那是宿主窗口级别的系统弹窗，
-   * 样式与语言都不归插件管，而且会把"从自选中移除"这件事从面板里搬出去。
-   * 这一格住 store 而不是 `useState`：`if (!state.open) return null` 是**收起**不是卸载
-   * （座位常驻），组件状态因此跨开合活下来——2.5.3 review 里那条 blocker 就是这么来的。
+   * In-panel confirm, not `window.confirm`; state lives in the store because closing
+   * renders null instead of unmounting.
    */
   const pendingRemove = state.pendingRemove ?? null
 
@@ -1313,10 +880,7 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
   const showDropdown = state.dropdownOpen === true
   const confirming = pendingRemove !== null
 
-  // Esc 的归属：移除确认层 > 下拉 > 整个弹窗（最后一个是官方 Modal 自己的 document 监听）。
-  // stopPropagation 让事件不再走到那一层，写法照官方 headless 对话框（directory-picker-browse）。
-  // 「更多」菜单（连带里面的比例步进）不在这一串里：官方 `Menu` 自己在 **capture 阶段**吃掉
-  // Escape 并 `preventDefault`（账本 L23 探的就是这一条），所以它收起时弹窗本体不跟着关。
+  // Esc ownership: confirm layer, then dropdown; the official Menu handles its own Escape.
   const onKeyDown = (event) => {
     if (event.key !== 'Escape') return
     if (confirming) {
@@ -1329,8 +893,7 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
       surface.hideDropdown()
     }
   }
-  // 点到框外就收起下拉：判据是"焦点离开**搜索段**"，而候选行就住在搜索段里，
-  // 所以鼠标点行的那一下（focus 收进 option）不算离开。
+  // Focus leaving the search section closes the dropdown; candidates live inside it.
   const onBlur = (event) => {
     if (!showDropdown) return
     const next = event.relatedTarget
@@ -1345,23 +908,15 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
       `${t(`error.${error.code}`)}${error.partial === true ? t('errorSuffix') : ''}`)
 
   /**
-   * 「预测」/「复盘」= 把那句话**追加**进输入框，剩下由用户看过自己发送。不 `submit()`（那等于替
-   * 用户决定发什么），也不 `setDraft()`（那会吞掉他已经敲了一半的草稿）。`insertText` 自带
-   * revision 守卫：草稿在这一下变了、或正在提交而锁住编辑器就返回 false——那时**面板不关**，
-   * 用户看得见这一行，再点一次就是。
-   * `inputActions` 是框架发给每个 session scope 座位组件的标准件（本座位正是 session scope），
-   * 不是我们自己的注入。
+   * Append to the draft instead of submitting; keep the panel open when `insertText`
+   * refuses (revision guard or locked editor).
    */
   const appendPrompt = (item, kind) => {
     if (inputActions.insertText(promptOf(item, t, kind), inputActions.captureInsertion()) !== true) return
     surface.close()
   }
 
-  /**
-   * 筛选头只筛**已经拿全**的候选（A 股 50 + 港 10 + 美 10 一次回包）：切档不出网、也不收下拉。
-   * 计数按市场算，「全部」那一档是三市之和——用户那句"怎么全是 A 股，港股美股呢"，答案就写在
-   * 这三个数字里（港 10 / 美 10，不是 0），不用他逐档点过去找。档名 `CN` / `HK` / `US` 中英文同一套。
-   */
+  // Filtering is display-only; counts show each market's real total.
   const visibleCandidates = state.marketFilter === 'all'
     ? state.candidates
     : state.candidates.filter((candidate) => marketIdOf(candidate) === state.marketFilter)
@@ -1374,7 +929,6 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
         key: entry.id,
         type: 'button',
         className: 'capital-watchlist-filterbtn',
-        // 选中态只写在 `aria-pressed` 上、样式读它：状态先进属性，读屏也听得见"已选中"。
         'aria-pressed': state.marketFilter === entry.id,
         onClick: () => surface.setMarketFilter(entry.id),
       },
@@ -1384,8 +938,7 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
   const dropdown = !showDropdown
     ? null
     : h('div', { className: 'capital-watchlist-dropdown', 'aria-label': t('title'), 'data-menu-material': 'translucent' },
-      // 筛选头**不进滚动区**：`role="listbox"` 因此跟着选项搬到里面那层（列表框里只许摆 option，
-      // 头自己是 group），滚动的也只有选项那一层——头由 CSS 钉在下拉顶部，即用户要的"锁定这个头"。
+      // Filter bar stays out of the scroll area; the listbox holds only options.
       filterBar,
       h('div', { className: 'capital-watchlist-options', role: 'listbox', 'aria-label': t('title') },
         visibleCandidates.map((candidate) => h('button', {
@@ -1393,17 +946,11 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
           type: 'button',
           role: 'option',
           className: 'capital-watchlist-option',
-          // hover 出来的是**证券全称**（2026-10-08 用户点名）：旧版这一格写的是 `添加`，那句
-          // "这个按钮能干嘛"已经由右侧那颗「添加」说了；美股长名会被 CSS 截断，全称只有这个
-          // 原生 tooltip 给得全。
+          // Native tooltip exposes the full name; CSS truncates long US names.
           title: candidate.name,
-          // ⛔ 这一格用 `aria-disabled` 而不是真 `disabled`（2026-10-08 第三轮用户点名"点一下添加、
-          // 下拉就没了"）：真 `disabled` 会让浏览器**立刻把焦点从这一行踢到 body**，搜索段的 onBlur
-          // 于是拿到 `relatedTarget: null` → 判"点到框外" → 收起下拉，连续添加被这一下打断。
-          // `aria-disabled` 不动焦点（行照样可聚焦，读屏也听得见"不可用"），"禁止点击"由下面的 guard 承担。
+          // aria-disabled, not disabled: real disabled drops focus to body and closes the dropdown.
           'aria-disabled': candidate.in_list === true || addingThscode === candidate.thscode,
           onClick: () => {
-            // 幂等 + 防在途双击：已添加的那条点多少次都不再出网，在途那条也拦掉。
             if (candidate.in_list === true || addingThscode === candidate.thscode) return
             setBusy(true)
             setAddingThscode(candidate.thscode)
@@ -1412,50 +959,35 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
         },
           h('span', { className: 'capital-watchlist-optionmain' },
             h('span', { className: 'capital-watchlist-optionname' }, candidate.name),
-            // ⛔ 第二行画**完整 canonical 代码**，不是裸码：`00700` 一次同时命中港个股与
-            // `000700.SZ` 模塑科技，搜「恒生指数」还会同时回 `HSI` / `HSIGTR` / `HSINTR` 三条真指数——
-            // 裸码并列时用户没有可核对的信息，点错就是加错票。
-            // 类型徽标挪到代码右边（`codeline` 直接复用清单第一列那个类 ⇒ 排法与清单同款，用户
-            // 2026-10-08 点名"类似自选股列表第一列的样式"），右侧因此腾出来放「添加」。
+            // Second line shows the full canonical code; a bare `00700` collides with
+            // `000700.SZ`, and HSI / HSIGTR / HSINTR are all real indices.
             h('span', { className: 'capital-watchlist-codeline' },
               h('span', { className: 'capital-watchlist-optioncode' }, candidate.thscode),
               h(TypeTag, { assetType: candidate.asset_type, t }))),
-          // 右侧那颗「添加」是**整行这个 button 的可见动词**，不是第二个可聚焦控件（button 里再
-          // 套 button 是非法 HTML）；已在清单里就换 `已添加`，随行一起禁用（点了也不会重复写库）。
-          // 两态（2026-10-08 第三轮用户点名）：**添加 = 醒目**（沿用「刷新报价」那颗 verb 按钮的配方，
-          // 整行里唯一带色的就是它 ⇒ 一眼知道点哪儿）、**已添加 = 暗**（透明底 + l1 描边 + tertiary 字，
-          // 配合整行 aria-disabled 的 opacity 一起降）。状态只写在 `data-state` 上，样式读它。
+          // The label is this button's visible verb, not a nested button; state lives on `data-state`.
           h('span', { className: 'capital-watchlist-addbtn', 'data-state': candidate.in_list === true ? 'added' : 'idle' },
             candidate.in_list === true ? t('added') : t('add')))),
-        // ⛔ "没有更多"那句住在**滚动区末尾**（2026-10-08 用户点名"不要冻结"）：它跟着内容一起滚，
-        // 滚到底才看得见——钉在浮层底部就成了一条常驻横幅，还挡着最后一行候选。
-        // 筛选档里一行都不剩时不说它（那一格由下面的 `filterNoHit` 负责）。
+        // "No more" scrolls at the end of the list; only shown when this filter has rows.
         state.truncated === true && visibleCandidates.length > 0
           ? h('div', { className: 'capital-watchlist-hint capital-watchlist-endhint' }, t('truncated'))
           : null),
-      // 下面这几句 hint **不进滚动区**：它们说的是"这一屏此刻怎么了"（正在查 / 查不到 / 有路挂了），
-      // 被内容滚走就等于没人看见——所以留在浮层里、贴在选项之后。
+      // Status hints stay outside the scroll area so they cannot scroll out of sight.
       state.composing === true
-        // ⛔ 合成期（拼音还没上屏）不许报「没有匹配的标的」：那是把"还没查"说成"查了，没有"，
-        // 用户会以为自己的输入法打错了字。这一格说的是下一步会发生什么。
+        // During composition, say what happens next; never claim "no match".
         ? h('div', { className: 'capital-watchlist-hint' }, t('composingHint'))
         : state.searching === true || state.pendingSearch === true
-          // 防抖未到 / 请求在途都算"正在查"：候选是空的，但那不是"没有匹配"（noHit 只在
-          // 当前这个词真有一次回包、且回包为空时才亮）。
+          // Debounce pending or request in flight both mean "searching", not "no match".
           ? h('div', { className: 'capital-watchlist-hint' }, t('searching'))
           : state.searchError !== null && state.searchError !== undefined
-            // **替换** noHit 而不是并排多一条：限流的时候说"没有匹配的标的"，是把服务的故障
-            // 说成用户查错了。同一个 hint 槽、同一档材质，只换颜色与 role。
+            // Replaces noHit: a service failure must not read as "you typed it wrong".
             ? h('div', { className: 'capital-watchlist-hint capital-watchlist-searcherror', role: 'alert', 'data-code': state.searchError.code }, t(`error.${state.searchError.code}`))
             : state.candidates.length === 0
               ? h('div', { className: 'capital-watchlist-hint' }, t('noHit'))
               : visibleCandidates.length === 0
-                // 筛选把候选滤空了（总数 > 0）：这句与 noHit 说的是两件事——票是有的，只是不在
-                // 这一档里。说成"没有匹配"就是把用户的筛选说成他查错了。
+                // Filtered to zero while candidates exist: a filter miss, not "not found".
                 ? h('div', { className: 'capital-watchlist-hint', 'data-filter': state.marketFilter }, t('filterNoHit'))
                 : null,
-      // 某一路挂了而其余路照常给候选：这一行说的是**那一路**（R12）。它与上面的 hint 各说
-      // 各的事——上面那句讲"这一屏有没有匹到"，这句讲"有一路今天没参与"，不互相顶替。
+      // Per-branch failure: separate from the "does this screen have a match" hint.
       ...(state.searchPartial ?? []).map((branch) => h('div', {
         key: `partial-${branch.market}`,
         className: 'capital-watchlist-hint capital-watchlist-searcherror',
@@ -1467,17 +999,11 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
   const head = state.items.length === 0
     ? null
     : h('div', { className: 'capital-watchlist-grid capital-watchlist-head' },
-      // 类型不再是独立一列（并进名称列第二行），所以表头也只剩三格。
       h('span', null, t('colName')),
-      // 表头只借报价列的右对齐，不复用数据列的类（那是 14px 与 label-primary，混用一张表头三种字号）。
       h('span', { className: 'capital-watchlist-quote' }, t('colQuote')),
-      // 「操作」只管最后一列（「预测」「复盘」与「更多」三枚），居右与它们共同那条右缘对齐。
       h('span', { className: 'capital-watchlist-headaction' }, t('colAction')))
 
-  /**
-   * 空态那一格有第三种说法：**读不到清单 ≠ 没有自选股**。服务端为了不骗用户专门把域失败
-   * 报成 `store_unavailable`，客户端不能把一次 503 渲染成"还没有自选股，用上面的输入框添加"。
-   */
+  /** A 503 is not an empty watchlist. */
   const emptyState = state.loadError !== null && state.loadError !== undefined
     ? h('p', { className: 'capital-watchlist-empty capital-watchlist-loaderror', role: 'alert', 'data-code': state.loadError.code }, t(`error.${state.loadError.code}`))
     : h('p', { className: 'capital-watchlist-empty' }, t('empty'))
@@ -1489,15 +1015,11 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
       : h('div', { className: showDropdown ? 'capital-watchlist-list capital-watchlist-list-open' : 'capital-watchlist-list' }, state.items.map((item, index) => {
         const held = item.holding !== null && item.holding !== undefined
         const weight = item.holding?.weight_pct
-        // 勾选出不出现在这一行的菜单里，归 `isHoldable` 那**一份**判定管（与宿主 `/holding` 的闸门同源）。
-        // `|| held` 是给改判前的遗留记录（或手改出来的 JSON）留的退路：只按类型画，那一格就再也
-        // 取消不掉，而主 Agent 会一直把一句用户早就不认的话当成他的仓位。
+        // `|| held` keeps legacy index holdings removable; host gate shares `isHoldable`.
         const markable = isHoldable(item) || held
-        // 这一格最多还能填到多少：单只上限与"120% 减掉其余持仓"取小的那一个（与宿主同一份判据）。
+        // Same ceiling rule as the host; unset weight has no numeric floor.
         const ceiling = weightCeiling(state.items, item.thscode)
-        // 「未填」与 0 是两句话：没填过的那一档 `−` 置灰（按它得不到"未填"，只会得到一个假的 0%）。
         const atFloor = !held || weight === null || weight === undefined || weight <= 0
-        // `+` 置灰 = 再上一档就出额度了：额度可能是单只的 100，也可能只剩 20（其余持仓占掉了 100）。
         const atCeil = (typeof weight === 'number' ? weight : 0) + HOLDING_STEP > ceiling
         return h('div', {
           key: item.thscode,
@@ -1505,19 +1027,16 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
           'data-thscode': item.thscode,
         },
           h('span', { className: 'capital-watchlist-namewrap' },
-            // 标过持仓的行：名称标红（2026-10-09 用户点名，替代原先那枚徽标）。 颜色不是唯一
-            // 通道——它与"红涨"同色，所以 `title` 里同时写着"持仓 20%"，悬停与读屏都拿得到同一句。
+            // Held rows tint the name red; title repeats the holding as the non-color channel.
             h('span', {
               className: held ? 'capital-watchlist-name capital-watchlist-name-held' : 'capital-watchlist-name',
               title: nameTitle(item, t),
             }, item.name),
-            // 第二行只有代码与市场徽标两样：币种不进面板（2026-10-07），持仓也不再在这儿占一格
-            // （那一族徽标按市场配色，且有闸门按它的节点数列档位——多一枚进去就是替它改口径）。
+            // Second line is code + market badge only; currency and holding stay out.
             h('span', { className: 'capital-watchlist-codeline' },
               h('span', { className: 'capital-watchlist-code' }, item.ticker),
               h(TypeTag, { assetType: item.asset_type, t }))),
           h(QuoteCell, { quote: item.quote, failureCode: state.failures[item.thscode], refreshing: state.refreshing, t }),
-          // 三个动作同住「操作」那一列（2026-10-01 用户点名）：图标键在前、菜单在最后，整簇贴右缘。
           h('span', { className: 'capital-watchlist-rowactions' },
             h('button', {
               type: 'button',
@@ -1535,12 +1054,7 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
               'aria-label': `${t('review')} ${item.name}`,
               onClick: () => appendPrompt(item, 'review'),
             }, h(IconListPenOutlineRegular, { size: 14 })),
-            // 行内「更多」收进官方 Menu（portal）：就地在滚动容器里画会被裁掉，见文件头。
-            // 持仓这件事**全部**发生在这一格里（2026-10-09 由"另开一层表单"改过来）：勾一下就是
-            // 持仓、再勾一下取消，勾上之后紧跟一行 `− 值 +` 按 10 个百分点调档，没有第二层弹窗。
-            // ⛔ 摆法只有一种：官方把 `children` 排在**所有** `items` 之后。置顶是一次性位移、
-            // 做完就收起，所以它住 items；勾选行、比例行与"带发丝线的移除"彼此要贴着并按这个顺序长，
-            // 就都得住 children（items 里放不进带键的行，也不能在它中间插一条分隔线）。
+            // Menu is portaled (in-place would be clipped): items = pin, children = holding + remove.
             h(Menu, {
               open: state.rowMenu === item.thscode,
               anchor: h('button', {
@@ -1554,16 +1068,10 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
                 onClick: () => surface.toggleRowMenu(item.thscode),
               }, h(IconEllipsisOutlineRegular, { size: 14 })),
               items: [
-                // 已经在第一行就没有可置顶的位移：这一条置灰，菜单不长出一堆 "取消置顶" 的反向动作。
                 { id: 'pin', label: t('pin'), icon: h(IconPinOutlineRegular, { size: 14 }), disabled: index === 0 },
               ],
               children: [
-                // 持仓那一行：图标 + 名词 + 一颗官方 `Switch`（2026-10-09 第四轮，用户点名）。
-                // ⛔ 整行**不是**按钮，标记与取消都只能碰那颗开关。上一版是"未标时整行可点、已标时
-                // 只剩圆圈可点"——两态的 DOM 形状不同，实机看就是"点一下标记，整块浮层跳了一下"。
-                // 这一行用 role="group"（`menu` 允许的合法子角色）而不是裸容器：那颗 `role="switch"`
-                // 本身不是菜单项，挂在 group 里才不冒充 menuitem。开关的视觉状态读 aria-checked
-                // （官方 Switch 自己画），我们不再画任何勾选态图标。
+                // Holding row: official Switch only; role=group keeps it from posing as a menuitem.
                 ...(markable ? [h('div', {
                   key: 'holding-check',
                   role: 'group',
@@ -1578,7 +1086,6 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
                     label: t('holdingName'),
                     onChange: (next) => (next ? surface.markHolding(item.thscode, null) : surface.clearHolding(item.thscode)),
                   }))] : []),
-                // 比例那一行只在"已标且这个类型能持有"时出现：遗留的指数持仓有取消出口，但没有调档。
                 ...(held && isHoldable(item) ? [h('div', {
                   key: 'holding-step',
                   className: 'capital-watchlist-stepper',
@@ -1594,8 +1101,7 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
                       disabled: atFloor,
                       onClick: () => surface.stepHolding(item.thscode, -HOLDING_STEP),
                     }, '−'),
-                    // role=status：读数改档时这是唯一会被播报出来的地方。没填就显示**剩余额度**
-                    // （`0~N` 是数字不是文案，所以不住在字典里），不再写"未填"那一档。
+                    // role=status announces the readout; unset shows headroom, not "unset".
                     h('span', {
                       className: typeof weight === 'number' ? 'capital-watchlist-stepperreadout' : 'capital-watchlist-stepperreadout capital-watchlist-stepperplaceholder',
                       role: 'status',
@@ -1604,16 +1110,12 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
                       type: 'button',
                       className: 'capital-watchlist-stepperbtn',
                       'aria-label': t('holdingStepUp'),
-                      // 置灰的那一颗自己说为什么点不动：这一格的上限是"单只 100"还是"只剩 20"，
-                      // 用户对着一个灰键无从猜起。挂在键上而不是读数上——读数那里是播报值的地方。
+                      // Disabled key explains the current ceiling on itself, not on the readout.
                       title: `0~${ceiling}`,
                       disabled: atCeil,
                       onClick: () => surface.stepHolding(item.thscode, HOLDING_STEP),
                     }, '+')))] : []),
-                // 移除排在最后，且带一条官方发丝线：它离持仓那一簇太近就会有点错的机会，
-                // 而这一颗是不可撤销的（清单里少一行）。
-                // ⛔ 它要点掉菜单：确认层住在卡片里（z 50），菜单是 portal 出去的（z 1100），
-                // 不收起就会压在自家确认框上面。
+                // Remove last with a separator; it must close the menu (portal z 1100 > confirm z 50).
                 h(MenuItemButton, {
                   key: 'remove',
                   danger: true,
@@ -1626,9 +1128,7 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
                 }, t('remove')),
               ],
               onSelect: (id) => {
-                // 这一路现在**只有置顶**会进来（勾选与比例两行各自带 onClick，住在 children 里）。
-                // 置顶做完就该回到清单；其余动作都不许收这张菜单——收起等于把用户刚点开的东西
-                // 从他手上拿走，而"改比例"紧接着就要再按一次 `+`。
+                // Only pin reaches this handler; closing on other actions would yank the menu away.
                 if (id !== 'pin') return
                 surface.closeRowMenu()
                 surface.pin(item.thscode)
@@ -1662,14 +1162,11 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
           },
         }, t('confirmOk')))))
 
-  // 面板里**只有一层**常驻遮罩（上面那颗移除确认）。持仓不再有自己那一层：
-  // 它整个住在「更多」菜单里，勾一下标、再勾一下取消，比例就贴在勾选行下面调。
   return h(Modal, {
     open: true,
     onClose: () => surface.close(),
     title: t('title'),
-    // headless：卡片、遮罩、Esc、焦点进出（含 data-modal-autofocus 的回焦）都是官方的，
-    // 只有默认 header/body/footer 骨架让给下面这套几何。见 CSS 顶部注释。
+    // headless: official chrome, Escape and focus handling; geometry is ours.
     headless: true,
     shortcutModal: 'watchlist',
     className: 'capital-watchlist-dialog',
@@ -1696,7 +1193,7 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
             onCompositionStart: () => surface.beginComposition(),
             onCompositionEnd: (event) => surface.endComposition(event.target.value),
           }),
-          // 有字才有清空键（空框再挂一个 X 是纯噪音）。按下不吃焦点：清完接着打字。
+          // Clear key only with text; keep focus so typing can continue.
           state.query.length > 0
             ? h('button', {
               type: 'button',
@@ -1710,17 +1207,14 @@ function WatchlistDialog({ useDialog, surface, t, inputActions }) {
         dropdown),
 
       state.addError !== null && state.addError !== undefined
-        // 超限与歧义是"添加"这个动作的失败：留在搜索区下方（黄），且**不随改字消失**——
-        // `list_full` 讲的是清单满不满，跟输入框里是什么字无关。
+        // Add failures stay in the search area and survive typing.
         ? h('p', { className: 'capital-watchlist-adderror', role: 'status', 'data-code': state.addError.code }, addErrorText(t, state.addError))
         : null,
 
       head,
       list,
 
-      // 底部一行：左列 = 「刷新报价」动词 + 它自己的整批失败行（报错跟着动词走，不再飘到输入
-      // 框下面、离按钮隔一整张表）；右列 = 整批共用的一次更新时间（逐行重复同一个时间是噪音，
-      // 顶部再放一个「刷新报价」按钮也与这行重复）。
+      // Footer: refresh verb + its batch error on the left, shared timestamp on the right.
       h('div', { className: 'capital-watchlist-footer' },
         h('div', { className: 'capital-watchlist-footcol' },
           h('button', {
@@ -1760,11 +1254,7 @@ function apply(ctx) {
     const value = row?.projectionValues?.agentPreset
     return typeof value === 'string' ? value : undefined
   }
-  /**
-   * 投影到达之前 `projectionValues` 整段缺席（实测：`byId` 行里没有这个键）。
-   * 这里对每个会话**一次性**催读 `refreshProjections`，让菜单行在投影落地后自己出现——
-   * 不是轮询，也没有定时器。
-   */
+  /** Projections can arrive late; nudge once per session, no polling or timer. */
   const nudged = new Set()
   const isCapitalSession = (sessionId) => {
     const preset = presetOf(sessionId)
@@ -1795,11 +1285,7 @@ function apply(ctx) {
     scope.effect(() => scope.commandUi.register({
       name: 'watchlist',
       label: () => t('command.label'),
-      // 行面上**不带**英文别名（2026-09-29 用户点名删掉）：菜单过滤只匹配 label / detail，命令名不参与，
-      // 所以过去把 `watchlist` 塞进 description 换的是「/watch 打得开这行」，代价是每个中文用户都看见
-      // 一行尾巴上多出的英文单词。删掉后过滤面只剩「自选股」与这句描述；typed 路径不受影响——
-      // Enter 认的是与注册名**完全相等**的 bare token（`dsh-client-ui-commands`：contributions act on the
-      // bare token only），`/watchlist`↵ 照开，`/watch`↵ 本来就不开（不是合法命令名）。
+      // No English alias in the row: filtering matches label/detail, and the bare token still works.
       description: () => t('command.description'),
       icon: IconChecklistOutlineRegular,
       available: (session) => isCapitalSession(session.sessionId),