@starwish-ai/xingyuan-dsh 0.5.4 → 0.5.6

package/CHANGELOG.md

@@ -5,6 +5,206 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.6] - 2026-08-29
+
+> **Note:** this release is the follow-up to the v0.5.5 six-perspective quality
+> pass: the same six reviews re-ran against 0.5.5 and every accepted finding is
+> fixed here — one data-safety gate, honesty fixes in the growth ladder, focus
+> management on the highest-frequency action, and a batch of contrast, copy and
+> localization closures. No data format changes; existing databases and recorded
+> sessions replay as before.
+
+### Added
+- **Write-path schema gate** (`makeXingyuanStore`): the storage domain validates
+  records only when cold-opening the medium — a write path that skipped a field
+  check (e.g. an over-long task name from the model) used to persist silently and
+  then brick the next startup (`invalid-record` refuses to open, plugin dead until
+  manual surgery). Every `put`/`update`/`global.set` is now guarded by the declared
+  zod schema at the single store assembly point and rejected at write time with a
+  stable `invalid_record` code; valid records parse as identity, reads pay nothing.
+  Locked by `test/domain-guard.test.ts`.
+- **Network-failure copy**: connection-level fetch failures (dsh restarting) no
+  longer surface the browser's raw English (`Failed to fetch` / `Load failed`) in
+  the Chinese UI; they map to a localized "network request failed, retry" message.
+- **Task rows keep keyboard focus after group-migrating actions**: a successful
+  check-in moves the row between the Today page's open/done lists and destroyed the
+  pressed button, dropping focus to `<body>`; focus now falls back to the page
+  title (the same pattern as undo). The same treatment covers a check-in that
+  closes a task anywhere task rows render, and claiming a task on the Tasks page,
+  where the row moves between status groups.
+- **Memory page**: the search empty-state no longer flashes between keystrokes
+  while the debounce is pending, a settled zero-hit search now shows the "no
+  matches" copy instead of the "no memories yet" empty-library one (the server's
+  `total` is query-filtered, so the two were indistinguishable before), and the
+  key field's server minimum (2 characters) is validated inline with its guidance
+  message instead of a generic error.
+
+### Changed
+- **Level rewards describe what exists**: the growth ladder no longer promises
+  avatar frames, task templates or style gating that the product does not have
+  (coach styles were always free in Settings); rewards are now the honorary title
+  itself, capped by the Lv.10 pinnacle. Server table and both dictionaries updated
+  together (the Chinese dictionary is locked to the server table by
+  `test/growth.test.ts`).
+- **Levels read "荣誉" not "权益"** on the Growth page hero and in `get_growth_stats`
+  output, matching the honorary rewards.
+- **Today plan keeps the achieved-closing row**: checking the last opportunity day
+  closes the task, which used to remove the row from the Today page entirely (the
+  counter shrank right after checking in). A closed-achieved task with a check-in
+  on that date stays in the done group with its undo entry; cancelling the check-in
+  revives the task through the existing freshness path.
+- **Calendar hover preserves state colors**: hovering a partially/fully-completed
+  day no longer washes the semantic amber/green chip with the accent hover tint —
+  the state color is exactly what the hover was inspecting.
+- **Contrast closures**: micro-action card secondary text and skipped steps use the
+  `label-on-2` pair and a higher muted opacity so both themes stay above the
+  4.5:1 line (the same lift applies to deleted wish cards in chat); calendar/
+  check-in-cell state foreground colors moved into the theme token region as
+  paired `--xyd-on-c2` / `--xyd-on-c3` / `--xyd-on-dcell` tokens.
+- **Date validation accepts only real calendar dates**: `2026-02-30` used to pass
+  the format check (`Date.parse` rolls it over instead of returning NaN) and then
+  silently produce a task with an empty opportunity sequence — or land in the
+  check-in table as a fake day that skews the streak replay. Task due dates, wish
+  estimated dates and check-in target dates (including the any-date back-fill on
+  no-deadline tasks) now share the opportunity calculator's semantic `isIsoDate`
+  round-trip check, and the routes' duplicate implementation converges onto it.
+- **Prompt coherence**: the check-in example moved out of the "no-confirm mode"
+  section into confirm mode (check-in is a confirm-gated write) and no longer
+  demonstrates a streak number the tool does not return; list-tool outputs tell the
+  model to use bracketed IDs only for follow-up calls, not to render them to the
+  user; `generate_chart`'s `wishId` parameter names the camelCase chart keys.
+- **Memory search bar wraps** so the saved notice is not clipped off narrow panels.
+- **Copy/wording**: the Settings preference-unavailable hint no longer hardcodes a
+  stale count; the English "clear all memories" dialog is grammatical for one item;
+  the Growth page EXP/experience units are consistent in Chinese; an unknown level
+  falls back to a localized name instead of an empty label; the 404 API error and
+  the wish-not-found tool/route error carry localizable codes; the English
+  check-in grid summary is grammatical for one cell; README wording aligned with
+  the UI ("连续加成", straight quotes in English).
+
+### Fixed
+- **sqlite backend**: a corrupted table row now reports `malformed-medium` like the
+  global slot does, instead of a raw `SyntaxError` with a split troubleshooting path.
+- **Mock generator**: the detail-panel fixture in `debug/gen-mock.ts` takes an id
+  parameter so the wish/task scenarios no longer emit duplicate DOM ids.
+
+## [0.5.5] - 2026-08-28
+
+> **Note:** this release is a six-perspective quality pass (product, visual design,
+> end user, dsh-platform conformance, architecture, UX) over every interaction,
+> display and code path. It closes the failure side of the habit loop — an expired
+> task used to be indistinguishable from an achieved one and was a dead end on the
+> pages — and makes the plugin honest in English wherever it previously leaked
+> built-in Chinese vocabulary. No data format changes; existing databases and
+> recorded sessions replay as before.
+
+### Added
+- **Expired vs achieved, end to end**: task views carry `closedReason`; the Tasks
+  page splits the former "Closed" bucket into **Achieved** and **Expired** groups,
+  task rows say which one they are, and an expired task's detail panel explains the
+  state and offers an in-page **extend due date → restart** action (same store write
+  path as the chat-side `update_task`). An expired task is no longer a dead row with
+  a delete button.
+- **Confirm card language** (`xingyuan-pref.confirmLang`, default Chinese): the
+  platform does not expose UI language to host-side plugins (verified against rc.2),
+  so the in-chat confirmation card's header, buttons and question text now follow
+  this explicit setting with full English strings; the Settings page gains a
+  "Confirm card language" select with optimistic save and write verification.
+- **Built-in chart vocabulary localizes on the client**: chart cards map known
+  built-in Chinese titles, enum labels (weekdays, hour buckets, task statuses,
+  series names) and fixed subtitles to the interface language, while user data
+  (wish/task names) and unknown values replay verbatim. Coverage is locked by
+  `test/chart-labels.test.ts` against the real chart builder, so a new built-in
+  word without a mapping fails the build.
+- **Level names localize**: the Growth page renders level names and rewards from
+  the interface language by level number (server strings remain the Chinese
+  fallback); locked to the server table by the same test.
+- **Route contract compliance**: `/xingyuan` prefix registration is effect-scoped —
+  the disposer returned by `webServer.register` is no longer discarded, so hot
+  reload / re-activation can no longer die on a duplicate-prefix throw or leave a
+  stale handler serving a closed domain. A loader-level remount test with a
+  duplicate-throwing webServer stub pins this.
+- New contract tests: `style-contract` (no `color-mix(` anywhere; semi-transparent
+  colors only inside the token zone; key semantic tokens must exist in both
+  themes), `chart-labels` (built-in chart vocabulary fully covered by the
+  localization maps, and client level names locked verbatim to the server table),
+  `sqlite-backend` (version-mismatch rejection, corrupt-global rejection,
+  write → cold-read persistence), plus a tool-suite audit pinning the 10-minute
+  HITL timeout on every confirmation-waiting tool and the "use real IDs from list
+  results" note on every ID parameter.
+
+### Changed
+- **System prompts no longer assert gated behavior**: six spots claimed the system
+  "will pop a confirmation card" unconditionally — wrong when the write-confirmation
+  setting is off (tool descriptions already hedged; the prompts now hedge the same
+  way, "删除始终弹出" stays asserted since deletes always confirm).
+- **Memory overwrite asks once**: creating a memory with an existing key showed the
+  overwrite confirmation, then the server rejection re-asked the identical question;
+  the confirmed path now submits with `overwrite: true` directly.
+- **Settings tab-visibility tells the truth**: memory-mode (non-loopback) and
+  read-only states get their own notices instead of silently grey controls, and
+  writes verify post-settle snapshot like the chat-preferences controls, toasting
+  on silent revert (`scope.set()` resolves even on failure).
+- **Honest stale-data degradation**: when a refetch fails after a successful action
+  (or on focus refetch), pages keep the loaded data and show a "refresh failed,
+  data may be outdated" banner with inline retry instead of flipping to a full-page
+  error; Today's retry now reloads both endpoints at once.
+- **Motion & touch discipline**: the growth bar drops its layout-animating `height`
+  transition and the toggle knob animates `transform` only; every purely decorative
+  hover is gated behind `(hover:hover) and (pointer:fine)` so touch screens no
+  longer stick hover tints; error toasts use a dedicated assertive `role=alert`
+  container; the confirm dialog locks body scroll; after deletes/undoes destroy the
+  triggered row, focus moves to the page title instead of falling to `<body>`.
+- **Cross-tab state survives**: memory search query, calendar month offset and
+  expanded task details persist across view-tab switches via a module-scoped
+  snapshot store; view pages scroll back to top on mount.
+- **Visual tokens**: new `--xyd-label-on-2` pair fixes secondary text on secondary
+  surfaces (≈4.3:1 → ≥5:1 in both themes) across the task-card preview strip, group
+  count pills, level chips, future grid cells and the growth chart axis ticks;
+  success/warn washes, calendar state fills,
+  shadows and hero colors are explicit themed token pairs (no more shared-alpha
+  washes that vanished on dark); calendar hover wash no longer paints over the
+  picked chip; 待打卡 chips gain the inset ring their legend dot always had;
+  standalone dark "complete" chip darkens to AA contrast; 11px CJK text raises to
+  12px; month-adjacent days brighten from 1.8:1 to readable-but-dim; the mock
+  generator itself is `color-mix`-free again.
+- **Error codes completed end-to-end**: `not_claimed`, `no_opportunity_left`,
+  `no_checkins`, `title_too_long`, `name_too_long`, `once_today_only`,
+  `payload_too_large`, `bad_json_body`, `bad_coach_style`, `bad_interests` now flow
+  from store/routes to localized client strings (English users no longer receive
+  raw Chinese domain messages); HTTP status suffixes localize their brackets.
+- **Dates**: hover tooltips on the check-in grid and calendar cells localize while
+  aria keeps ISO precision; memory timestamps render as medium dates; the growth
+  chart axis uses Intl ticks (Aug 27 / 8-27); the English "Commit {date}" button
+  becomes "Early check-in · {date}" so the button itself carries check-in semantics.
+- **Writes stay in one place**: memory delete/clear and profile updates go through
+  store use cases (`deleteMemory`, `clearMemories`, `updateProfileGlobal`) shared by
+  tools and routes; profile fields clamp at the same limits on both faces (nickname
+  50 / occupation 100 / interests 20×50) — the tool path was previously unbounded
+  and injects into every system prompt turn.
+- **Batch reads honor the store contract**: wish/task list paths use
+  `freshWishes` and a single shared checkin-count index instead of per-item
+  full-table rescans for the completed-day counts; the
+  chart builder computes its checkin index only for the one chart that consumes it;
+  semantically invalid dates (`2026-13-01`) are rejected with a stable `bad_date`
+  code instead of an unlocalizable RangeError; session-log repair sweeps its
+  `.xy-repair-*` atomic-write temp files; `./types` export resolves types and
+  runtime to the same module.
+- **Copy honesty**: delete confirmations (chat and pages) now mention the
+  micro-step plan that the cascade removes; quick-create forms soft-confirm on an
+  exact duplicate name/title (the chat path dedupes via `check_similar_*`, the
+  page path previously did not); wish progress bars expose `role=progressbar`; the
+  four create tools declare the same 10-minute HITL timeout as their siblings;
+  task-related ID parameters all carry the "use real IDs from list results"
+  discipline.
+
+### Fixed
+- `start_micro_action` gates on a freshened task status, so a task that expired
+  since its last write can no longer start a breakdown.
+- `create_wish_with_tasks` no longer over-claims atomicity in its pre-validation
+  comment (task-field failures are honestly reported; the wish and created tasks
+  are kept).
+
 ## [0.5.4] - 2026-08-28
 
 > **Note:** trailing chart statistics no longer count future pre-checked days (see

package/README.en-US.md

@@ -28,7 +28,7 @@ Tools are only mounted on sessions using the XingYuan preset; other sessions are
 dsh plugin --profile web add @starwish-ai/xingyuan-dsh
 ```
 
-After starting the Web GUI, installation succeeded when「星愿」appears in the agent picker.
+After starting the Web GUI, installation succeeded when "星愿" (XingYuan) appears in the agent picker.
 
 ## Data & Backup
 
@@ -43,6 +43,7 @@ Business data lives at `~/.dsh/xingyuan/xingyuan.sqlite` and survives uninstall
 | Write confirmation | Whether create / check-in writes need confirmation (deletion always does) |
 | Memory injection limit | Max memories injected per turn |
 | Tab visibility | Three modes (follow session / always show / always hide) plus per-tab toggles; defaults to follow session |
+| Confirm card language | Language of the in-chat confirmation card (Chinese / English; the platform does not expose UI language to plugins, defaults to Chinese) |
 
 ## Development
 

package/README.md

@@ -13,7 +13,7 @@
 - **对话驱动**：自然语言创建愿望 / 任务，自动查重相似项
 - **机会日打卡**：周期任务打卡、补卡、取消、未来预勾，进度跨天恒为最新
 - **微行动拆解**：把无从下手的目标拆成 3–7 个小步，引导式逐个完成或跳过
-- **成长体系**：等级 Lv.1–Lv.10、连击加成、统计卡与近 30 天柱状图
+- **成长体系**：等级 Lv.1–Lv.10、连续加成、统计卡与近 30 天柱状图
 - **会话视图页**：今日 / 愿望 / 任务 / 日历 / 成长 / 记忆 六个标签页，页面按钮直连动作接口；
   默认仅星愿预设的会话显示，可在设置里切换「始终显示 / 始终隐藏」并按标签勾选
 - **记忆**：重要记忆自动注入上下文（上限可配），支持增删改查
@@ -44,6 +44,7 @@ dsh plugin --profile web add @starwish-ai/xingyuan-dsh
 | 写操作二次确认 | 创建 / 打卡类写操作是否确认（删除始终确认） |
 | 记忆注入上限 | 每次注入上下文的记忆条数上限 |
 | 标签页显示 | 三态模式（跟随会话 / 始终显示 / 始终隐藏）+ 六个标签逐个勾选；默认跟随会话 |
+| 确认卡语言 | 对话中确认卡的显示语言（中文 / English；平台不向插件暴露界面语言，默认中文） |
 
 ## 开发
 

package/lib/client/api.js

@@ -24,13 +24,31 @@ const ERROR_KEY = {
     already_claimed: 'err.already_claimed',
     task_closed: 'err.task_closed',
     due_past: 'err.due_past',
+    due_too_far: 'err.due_too_far',
     bad_category_name: 'err.bad_category_name',
     bad_color_key: 'err.bad_color_key',
     bad_date: 'err.bad_date',
     overwrite_required: 'err.overwrite_required',
+    not_claimed: 'err.not_claimed',
+    no_opportunity_left: 'err.no_opportunity_left',
+    no_checkins: 'err.no_checkins',
+    title_too_long: 'err.title_too_long',
+    name_too_long: 'err.name_too_long',
+    once_today_only: 'err.once_today_only',
+    payload_too_large: 'err.payload_too_large',
+    bad_json_body: 'err.bad_json_body',
+    bad_coach_style: 'err.bad_coach_style',
+    bad_interests: 'err.bad_interests',
 };
-/** 把任意抛错转成用户可读文案：ActionError 按键本地化；其余直出消息。 */
+/** 网络层失败的浏览器原文是英文技术串（Chrome "Failed to fetch"、Safari "Load failed"、
+ * Firefox "NetworkError…"、undici "fetch failed"），直出会打破本地化承诺——识别后统一
+ * 转本地化文案。仅匹配 TypeError（fetch 在请求发出前失败的规范类型）中的已知模式，
+ * 其余 TypeError（代码缺陷）仍原样抛出便于排障。 */
+const NETWORK_ERROR_PATTERN = /failed to fetch|load failed|networkerror|fetch failed/i;
+/** 把任意抛错转成用户可读文案：网络失败/ActionError 按键本地化；其余直出消息。 */
 export function describeError(e) {
+    if (e instanceof TypeError && NETWORK_ERROR_PATTERN.test(e.message))
+        return t('common.networkError');
     if (!(e instanceof ActionError))
         return e instanceof Error ? e.message : String(e);
     // 服务端新增未知 code 时回落原始消息，避免渲染 undefined 或插值崩溃
@@ -72,18 +90,20 @@ export async function getJson(path) {
     return parsePayload(response, () => t('common.requestFailed'));
 }
 async function parsePayload(response, fallback) {
+    // HTTP 层错误的状态码后缀走本地化键（zh 全角 / en 半角括号），不硬编码全角括号
+    const withStatus = (message) => `${message}${t('common.httpStatus', { status: response.status })}`;
     let payload;
     try {
         payload = await response.json();
     }
     catch {
-        throw new Error(`${fallback()}（${response.status}）`);
+        throw new Error(withStatus(fallback()));
     }
     if (!response.ok) {
         if (typeof payload.code === 'string' && payload.code !== '') {
             throw new ActionError(payload.code, payload.error ?? fallback(), payload.params);
         }
-        throw new Error(payload.error ?? `${fallback()}（${response.status}）`);
+        throw new Error(payload.error !== undefined ? withStatus(payload.error) : withStatus(fallback()));
     }
     return payload;
 }

package/lib/client/cards.js

@@ -10,6 +10,7 @@ import { postAction, ActionError, describeError } from './api.js';
 import { toast, toastError } from './ui.js';
 import { localYmd, softConfirm } from './hooks.js';
 import { useXyT, t, activeLocale } from './i18n.js';
+import { localizeChartLabel, localizeChartSeries, localizeChartSubtitle, localizeChartTitle } from './chart-labels.js';
 import { categoryVars } from '../category-color.js';
 import { cycleLabel, durationText, dateSuffix, formatMediumDate, formatShortDate } from './pages/format.js';
 function WishView(props) {
@@ -147,21 +148,23 @@ function ChartView(props) {
     const event = props.node.data.data;
     // 悬停柱下标（与成长页悬浮明细同一交互语法；null = 未悬停）
     const [hoverIdx, setHoverIdx] = useState(null);
-    return createElement('div', { className: 'xy-card xy-chart' }, createElement('div', { className: 'xy-card-head' }, createElement('span', { className: 'xy-badge xy-badge-chart' }, t('badge.chart')), createElement('span', { className: 'xy-title' }, event.title), event.subtitle !== undefined ? createElement('span', { className: 'xy-meta' }, event.subtitle) : null), 
+    const title = localizeChartTitle(event);
+    return createElement('div', { className: 'xy-card xy-chart' }, createElement('div', { className: 'xy-card-head' }, createElement('span', { className: 'xy-badge xy-badge-chart' }, t('badge.chart')), createElement('span', { className: 'xy-title' }, title), event.subtitle !== undefined ? createElement('span', { className: 'xy-meta' }, localizeChartSubtitle(event.subtitle)) : null), 
     // 快照时点标注（事件溯源：卡片=当时的事实）：无 generatedAt 的旧事件诚实降级不显示。
     // 中格式带年份——回放的旧卡可能跨年，「生成于 3月5日」须能定位到哪一年。
     // ISO → 本地日再格式化：直接 slice 会把 UTC 日期当本地日（UTC+8 零点后 8 小时内差一天）
     event.generatedAt !== undefined
         ? createElement('div', { className: 'xy-meta' }, t('chart.generatedAt', { date: formatMediumDate(localYmd(new Date(event.generatedAt))) }))
-        : null, chartBody(event, t('chart.noData'), t('chart.noSchedule'), hoverIdx, setHoverIdx));
+        : null, chartBody(event, title, t('chart.noData'), t('chart.noSchedule'), hoverIdx, setHoverIdx));
 }
-/** 图表卡主体：四类渲染路径（占比条/占比列表/热力格/柱图）颜色全部走主题变量，深浅色自适应。 */
-function chartBody(event, noDataText, noScheduleText, hoverIdx, onHover) {
+/** 图表卡主体：四类渲染路径（占比条/占比列表/热力格/柱图）颜色全部走主题变量，深浅色自适应。
+ * 标签/序列名经 chart-labels 本地化（服务端内建中文词的展示层映射，未知值原样回显）。 */
+function chartBody(event, title, noDataText, noScheduleText, hoverIdx, onHover) {
     const { chartType, data } = event;
     if (data.length === 0)
         return createElement('div', { className: 'xy-meta' }, noDataText);
     const max = Math.max(...data.filter((d) => !d.inactive).map((d) => d.value), 1);
-    const labelValue = (d) => `${d.label}${activeLocale() === 'en' ? ': ' : '：'}${d.inactive === true ? noScheduleText : d.value}`;
+    const labelValue = (d) => `${localizeChartLabel(d.label)}${activeLocale() === 'en' ? ': ' : '：'}${d.inactive === true ? noScheduleText : d.value}`;
     if (chartType === 'arcbars') {
         const ratio = Math.min(Math.max(data[0].ratio ?? 0, 0), 1);
         return createElement('div', { className: 'xy-arcwrap' }, createElement('div', { className: 'xy-arcnum' }, `${Math.round(ratio * 100)}%`), 
@@ -171,7 +174,7 @@ function chartBody(event, noDataText, noScheduleText, hoverIdx, onHover) {
     if (chartType === 'pie' || chartType === 'radar') {
         // 占比分母守卫：总和为 0 时跳过百分比（避免 NaN%）
         const sum = data.reduce((s, x) => s + x.value, 0);
-        return createElement('ul', { className: 'xy-rows' }, ...data.map((d, i) => createElement('li', { key: i, className: 'xy-row' }, createElement('span', null, d.label), createElement('span', { className: 'xy-rowval' }, `${d.value}${chartType === 'pie' && sum > 0 ? ` · ${Math.round((d.value / sum) * 100)}%` : ''}`))));
+        return createElement('ul', { className: 'xy-rows' }, ...data.map((d, i) => createElement('li', { key: i, className: 'xy-row' }, createElement('span', null, localizeChartLabel(d.label)), createElement('span', { className: 'xy-rowval' }, `${d.value}${chartType === 'pie' && sum > 0 ? ` · ${Math.round((d.value / sum) * 100)}%` : ''}`))));
     }
     if (chartType === 'heatmap') {
         return createElement('div', null, createElement('div', { className: 'xy-heat', 'aria-hidden': 'true' }, ...data.map((d, i) => createElement('span', {
@@ -181,7 +184,7 @@ function chartBody(event, noDataText, noScheduleText, hoverIdx, onHover) {
             style: { opacity: String(0.25 + 0.75 * (d.value / max)) },
         }))), 
         // 热力格纯视觉（title 不构成可访问名）：数据以屏内隐藏文本整体提供给读屏
-        createElement('span', { className: 'xy-visually-hidden' }, data.map((d) => `${d.label} ${d.value}`).join(activeLocale() === 'en' ? '; ' : '；')));
+        createElement('span', { className: 'xy-visually-hidden' }, data.map((d) => `${localizeChartLabel(d.label)} ${d.value}`).join(activeLocale() === 'en' ? '; ' : '；')));
     }
     const seriesList = [...new Set(data.map((d) => d.series).filter((s) => s !== undefined))];
     const seriesColor = (index) => index <= 0 ? 'var(--xyd-accent)' : 'var(--dsw-alias-label-secondary)';
@@ -204,7 +207,8 @@ function chartBody(event, noDataText, noScheduleText, hoverIdx, onHover) {
         return [createElement('path', {
                 key: i,
                 d: topRoundedBar(i * step + 2, height - 18 - h, Math.max(step - 4, 2), h),
-                style: { fill: seriesIdx > 0 ? seriesColor(seriesIdx) : 'var(--xyd-accent)', opacity: seriesIdx > 0 ? 0.55 : 0.85 },
+                // 次要序列 opacity 0.8：0.55 曾把次要柱对卡底压到 2.1:1（非文字 3:1 下限之下）
+                style: { fill: seriesIdx > 0 ? seriesColor(seriesIdx) : 'var(--xyd-accent)', opacity: seriesIdx > 0 ? 0.8 : 0.85 },
                 onMouseEnter: () => onHover(i),
             }, 
             // 每根柱子带 <title>：原生悬停提示；精确数值另由上方悬浮明细条实时呈现
@@ -218,9 +222,9 @@ function chartBody(event, noDataText, noScheduleText, hoverIdx, onHover) {
         .map(({ d, i }) => createElement('text', {
         key: `l${i}`, x: i * step + step / 2, y: height - 4,
         fontSize: 11, textAnchor: 'middle', style: { fill: 'var(--dsw-alias-label-secondary)' },
-    }, d.label));
+    }, localizeChartLabel(d.label)));
     const legend = seriesList.length > 1
-        ? createElement('div', { className: 'xy-chart-legend' }, ...seriesList.map((name, idx) => createElement('span', { key: name }, createElement('i', { className: 'xy-dot', style: { background: seriesColor(idx), opacity: idx > 0 ? 0.55 : 1 } }), name)))
+        ? createElement('div', { className: 'xy-chart-legend' }, ...seriesList.map((name, idx) => createElement('span', { key: name }, createElement('i', { className: 'xy-dot', style: { background: seriesColor(idx), opacity: idx > 0 ? 0.8 : 1 } }), localizeChartSeries(name))))
         : null;
     const hovered = hoverIdx !== null ? data[hoverIdx] : undefined;
     return createElement('div', null, legend, createElement('div', { onMouseLeave: () => onHover(null) }, 
@@ -229,8 +233,8 @@ function chartBody(event, noDataText, noScheduleText, hoverIdx, onHover) {
     // 图表整体作为一张图暴露给读屏；逐条数值以屏内隐藏文本补充
     createElement('svg', {
         viewBox: `0 0 ${width} ${height}`, className: 'xy-svg',
-        role: 'img', 'aria-label': event.title,
-    }, createElement('line', { x1: 0, y1: height - 18, x2: width, y2: height - 18, style: { stroke: 'var(--dsw-alias-border-l2)' } }), ...bars, ...labels)), createElement('span', { className: 'xy-visually-hidden' }, data.map((d) => `${d.label} ${d.inactive === true ? noScheduleText : d.value}`).join(activeLocale() === 'en' ? '; ' : '；')));
+        role: 'img', 'aria-label': title,
+    }, createElement('line', { x1: 0, y1: height - 18, x2: width, y2: height - 18, style: { stroke: 'var(--dsw-alias-border-l2)' } }), ...bars, ...labels)), createElement('span', { className: 'xy-visually-hidden' }, data.map((d) => `${localizeChartLabel(d.label)} ${d.inactive === true ? noScheduleText : d.value}`).join(activeLocale() === 'en' ? '; ' : '；')));
 }
 export const CARD_VIEWS = {
     WishView,

package/lib/client/chart-labels.js

@@ -0,0 +1,107 @@
+/**
+ * 图表卡词表的客户端本地化。
+ *
+ * 背景（终端用户评审 P1）：服务端 charts.ts 的内建标题/副标题/枚举标签是中文权威源，
+ * en 用户会在图表卡上直接看到「周一 / 本周 / 未分类」。事件是 whole-value 冻结快照，
+ * 历史事件只有中文标签，因此本地化放在消费端：按 chartKey 与「已知中文标签 → 键」
+ * 的映射表渲染，未知值（模型自定义标题、用户数据标签如愿望名）原样回显——诚实降级。
+ *
+ * 一致性锁定：映射表的中文键必须与 charts.ts 内建词逐字一致，由 test/chart-labels.test.ts
+ * 用真实 buildChart 输出对拍（内建词改动而映射表未跟 → 测试红）。
+ */
+import { t } from './i18n.js';
+/** 各 chartKey 的内建默认标题（与 charts.ts `params.title ?? '…'` 逐字同源）。 */
+export const CHART_DEFAULT_TITLES = {
+    checkinTrend: '打卡趋势',
+    checkinCalendar: '打卡日历',
+    taskCompletionRate: '任务完成率',
+    checkinRateTrend: '打卡完成率',
+    weekComparison: '本周打卡对比',
+    taskStatus: '任务状态分布',
+    checkinByCategory: '分类打卡分布',
+    wishCategory: '愿望分类分布',
+    checkinRanking: '打卡排行',
+    taskDistribution: '任务分布',
+    wishProgress: '愿望进度',
+    wishAchievement: '愿望达成率',
+    continuousCheckin: '连续打卡',
+    checkinTimeDistribution: '打卡时间分布',
+    weeklyActivity: '周度活跃度',
+};
+/** 已知中文枚举标签 → 本地化键（weekComparison/weeklyActivity 星期、时段桶、状态、系列名等）。
+ * 导出供 test/chart-labels.test.ts 做「服务端内建词全覆盖」对拍锁定。 */
+export const CHART_LABEL_KEYS = {
+    周一: 'chart.weekday.1',
+    周二: 'chart.weekday.2',
+    周三: 'chart.weekday.3',
+    周四: 'chart.weekday.4',
+    周五: 'chart.weekday.5',
+    周六: 'chart.weekday.6',
+    周日: 'chart.weekday.7',
+    '凌晨(0-5)': 'chart.hour.0',
+    '早晨(6-8)': 'chart.hour.1',
+    '上午(9-11)': 'chart.hour.2',
+    '中午(12-13)': 'chart.hour.3',
+    '下午(14-17)': 'chart.hour.4',
+    '傍晚(18-19)': 'chart.hour.5',
+    '夜间(20-23)': 'chart.hour.6',
+    待领取: 'task.status.pending',
+    进行中: 'task.status.in_progress',
+    已完结: 'task.status.closed',
+    未分类: 'chart.uncategorized',
+    未关联: 'chart.unlinked',
+    完成率: 'chart.label.completionRate',
+    达成率: 'chart.label.achievementRate',
+    '当前/最长': 'chart.label.currentVsBest',
+};
+export const CHART_SERIES_KEYS = {
+    本周: 'chart.series.this',
+    上周: 'chart.series.last',
+};
+/** 数据点标签本地化：已知中文枚举标签映射，其余（用户数据）原样回显。 */
+export function localizeChartLabel(label) {
+    const key = CHART_LABEL_KEYS[label];
+    return key !== undefined ? t(key) : label;
+}
+/** 分组序列名本地化（图例与柱色对应关系按原字符串分组，故仅展示层替换）。 */
+export function localizeChartSeries(series) {
+    const key = CHART_SERIES_KEYS[series];
+    return key !== undefined ? t(key) : series;
+}
+/** 标题本地化：内建默认标题按 chartKey 映射；模型自定义标题原样回显。 */
+export function localizeChartTitle(event) {
+    const key = `chart.title.${event.chartKey}`;
+    if (event.title === CHART_DEFAULT_TITLES[event.chartKey])
+        return t(key);
+    return event.title;
+}
+/** 已知中文固定副标题 → 本地化键。 */
+export const CHART_SUBTITLE_KEYS = {
+    最近一年: 'chart.subtitle.lastYear',
+    '按任务 TopN': 'chart.subtitle.byTaskTopN',
+    '按愿望 TopN': 'chart.subtitle.byWishTopN',
+    '按实际打卡时刻分桶；过滤范围为打卡日区间': 'chart.subtitle.byHourBucket',
+    '%（应打天数完成率）': 'chart.subtitle.progressPercent',
+};
+/**
+ * 副标题本地化：固定短语查表；含数字的模板（近 N 天 / A/B 天 / 当前 A 天 / 最长 B 天 /
+ * 含未领取任务）按正则重排——服务端模板变化时未知副标题原样回显（诚实降级）。
+ */
+export function localizeChartSubtitle(subtitle) {
+    const fixed = CHART_SUBTITLE_KEYS[subtitle];
+    if (fixed !== undefined)
+        return t(fixed);
+    let m = /^近 (\d+) 天$/.exec(subtitle);
+    if (m !== null)
+        return t('chart.subtitle.lastDays', { n: m[1] });
+    m = /^(\d+)\/(\d+) 天（含未领取任务）$/.exec(subtitle);
+    if (m !== null)
+        return t('chart.subtitle.daysInclPending', { done: m[1], due: m[2] });
+    m = /^(\d+)\/(\d+) 天$/.exec(subtitle);
+    if (m !== null)
+        return t('chart.subtitle.daysRatio', { done: m[1], due: m[2] });
+    m = /^当前 (\d+) 天 \/ 最长 (\d+) 天$/.exec(subtitle);
+    if (m !== null)
+        return t('chart.subtitle.streak', { current: m[1], best: m[2] });
+    return subtitle;
+}

package/lib/client/hooks.js

@@ -130,6 +130,23 @@ export function useStableScrollbar() {
         pin();
     }, [pin]);
 }
+/**
+ * 视图页挂载时把祖先滚动容器滚回顶部：标签页切换时壳的滚动容器不重挂，
+ * 长列表页留下的滚动位置会原样套在下一个（可能更短的）页面上，出现「半屏空白」。
+ */
+export function useScrollTopOnMount() {
+    useLayoutEffect(() => {
+        let el = document.querySelector('.xy-page');
+        for (let depth = 0; el !== null && depth < 16; depth += 1, el = el.parentElement) {
+            const overflowY = getComputedStyle(el).overflowY;
+            if (overflowY === 'auto' || overflowY === 'scroll') {
+                if (el.scrollTop > 0)
+                    el.scrollTop = 0;
+                break;
+            }
+        }
+    }, []);
+}
 /**
  * 写操作确认（应用内弹窗，替代原生 window.confirm）：Promise 结算；
  * 调用方以 `softConfirm(msg).then((ok) => { if (ok) … })` 表达「确认后才继续」。