@starwish-ai/xingyuan-dsh 0.5.3 → 0.5.5

package/CHANGELOG.md

@@ -5,6 +5,217 @@ 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.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
+> *Changed*). Chart cards generated by this version carry a "generated on" stamp so a
+> stale card is distinguishable from current data; cards written by earlier versions
+> replay unchanged, without the stamp.
+
+**Charts and records now tell the truth about time.** Future pre-checked days were
+counted by every trailing statistic as if they had already happened — a "how is this
+week going" chart could be inflated by check-ins for days that have not occurred, and a
+task's check-in grid could end up showing nothing but future days while today's check-in
+was invisible. Undoing a check-in said "revert today's?" while actually reverting a
+future pre-check, because the pages let the server fall back to "most recent record".
+
+### Added
+- **Chart snapshot stamp**: chart events carry `generatedAt` and the card renders a
+  localized "generated on" date; cards generated by older versions replay without it
+  (the field is optional and degrades honestly).
+- **"No schedule" ≠ 0%**: in the daily completion-rate trend, days with no scheduled
+  opportunity render as an empty slot labelled "no schedule" (tooltip and screen reader
+  alike) instead of a 0% data point.
+- The completion-rate chart annotates its subtitle with "including unclaimed tasks"
+  when pending tasks count toward the total, so the denominator is never a mystery.
+- **Startup consistency sweep** (`src/consistency-sweep.ts`): check-ins whose task no
+  longer exists, tasks whose wish was deleted out from under them, and dangling
+  micro-action states are cleaned once per launch through the same cascade the delete
+  tools use. Idempotent, runs after activation without blocking it, and pinned by
+  `test/integrity.test.ts`.
+- **Task-detail grid window**: the check-in grid shows the last 28 opportunity days up
+  to today, plus every checked day — future pre-checks stay visible (they are standing
+  commitments), and check-ins outside the opportunity series (deadline-free tasks) make
+  the grid their check-in history. Today is never squeezed out of the window, however
+  many future days are pre-checked; unchecked future days remain in the "upcoming"
+  preview line.
+- **gzip content negotiation** for the standalone pages (`/xingyuan/today`, `/calendar`,
+  `/growth`) per RFC 9110 §12.5.3: absent header accepts any coding, an empty value or
+  an explicit opt-out gets plaintext, `Vary: Accept-Encoding` is always sent, and the
+  compressed template is cached per body.
+- **Request timeout**: client fetches abort after 15 s with a localized message instead
+  of hanging forever.
+- **Focus refetch**: page data refetches when the window regains focus if older than
+  60 s, and always when the local day has changed — overnight sessions no longer show
+  yesterday's "today".
+- **Undo readability**: the detail panel's undo button announces the exact day it will
+  revert (screen-reader label), and its visibility no longer requires today to be the
+  checked day — a pre-check can be undone right where it was made.
+
+### Fixed
+- **The cancel dialog said "today" while a different day was reverted.** The today page
+  and the task detail panel posted the cancel without a date and the server falls back
+  to the most recent check-in — which a future pre-check satisfies. Every page now sends
+  the explicit date; the dialog, the toast and the reverted record all name the same day.
+- `weekComparison` folded future pre-checks into weekday buckets as if they were in the
+  current week; the week window is now a closed interval from last Monday to today.
+- Wish progress **rounded** instead of flooring: 249/250 displayed as 100% and could
+  archive the wish one day early.
+- Checking in an expired (closed) task failed with a generic error; it now explains that
+  the deadline must be extended to revive the task before further check-ins.
+- Concurrent writes to the global document (coach style, profile, category colors,
+  micro-action state) could lose updates under interleaving; all writers now serialize
+  through one promise chain, a failed writer no longer poisons the chain, and no-op
+  mutations skip the write entirely.
+- The memory page could deadlock with a perpetual "loading more" spinner when an
+  in-flight request was superseded by a newer one (the reset ran on only one of two
+  completion paths).
+- The calendar's post-action detail refetch swallowed failures; the panel now shows an
+  error state with a retry button instead of silently keeping stale content.
+- A deadline-free one-shot task disappeared from the today page the moment it was
+  checked; the completed row now stays revocable for the rest of the day (it never
+  reappears the next day).
+- `/xingyuan/api/day` and `/xingyuan/api/range` answered a malformed `date` with an
+  empty day list or an unlabelled `RangeError`; both now reject with a structured
+  `bad_date` error, consistent with the POST action surface.
+- Creating a task with a name over 100 characters through a page action failed with a
+  bare validation message; the error now states the limit and the actual length.
+- The claim button in the calendar is gated to the picked day being today, matching the
+  server-side anchor semantics.
+- Display dates across cards, toasts and pages are localized (ISO strings remain only in
+  confirm-dialog copy and screen-reader strings, per the documented convention).
+- The standalone growth page used `color-mix()`, which some shells render as an invalid
+  declaration; the darker tone is now precomputed in JS.
+
+### Changed
+- Trailing chart statistics (trend, daily rate, week comparison, by-category, ranking,
+  time-of-day, weekday activity) only count check-ins up to today; the calendar heatmap
+  deliberately keeps future pre-checks visible. Chart cards are snapshots of their
+  generation time — the coach guide tells the model to regenerate for current data.
+- `cancel_check_in_task` parameter guidance now instructs the model to pass the date
+  whenever the user names a day (including "today"), so the "most recent" fallback is a
+  deliberate choice rather than an accident.
+- zh copy no longer pads localized dates with spaces ("已撤销 8月29日 的打卡" →
+  "已撤销8月29日的打卡"), and the grid legend says "待打卡" where it previously said
+  "未来机会日" for what is now only ever today's pending slot.
+
 ## [0.5.3] - 2026-08-28
 
 > **Note:** this is a patch release but it carries one breaking change — the `xingyuan`

package/README.en-US.md

@@ -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

@@ -44,6 +44,7 @@ dsh plugin --profile web add @starwish-ai/xingyuan-dsh
 | 写操作二次确认 | 创建 / 打卡类写操作是否确认（删除始终确认） |
 | 记忆注入上限 | 每次注入上下文的记忆条数上限 |
 | 标签页显示 | 三态模式（跟随会话 / 始终显示 / 始终隐藏）+ 六个标签逐个勾选；默认跟随会话 |
+| 确认卡语言 | 对话中确认卡的显示语言（中文 / English；平台不向插件暴露界面语言，默认中文） |
 
 ## 开发
 

package/lib/client/api.js

@@ -24,10 +24,21 @@ 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 按键本地化；其余直出消息。 */
 export function describeError(e) {
@@ -40,8 +51,27 @@ export function describeError(e) {
 export async function postAction(path, body) {
     return postJson(`/xingyuan/api/action/${path}`, body);
 }
+/** 请求超时：手动 AbortController——AbortSignal.timeout 为 Baseline 2024 "Newly available"，
+ * 不满足 dsh 壳的保守浏览器矩阵（同 color-mix 禁令的判断口径），不用。 */
+const REQUEST_TIMEOUT_MS = 15_000;
+async function fetchWithTimeout(path, init) {
+    const controller = new AbortController();
+    const timer = window.setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    try {
+        return await fetch(path, { ...init, signal: controller.signal });
+    }
+    catch (e) {
+        // 超时中止统一转本地化文案；真实网络错误原样抛出（保留连接拒绝等语义）
+        if (e instanceof DOMException && e.name === 'AbortError')
+            throw new Error(t('common.requestTimeout'));
+        throw e;
+    }
+    finally {
+        window.clearTimeout(timer);
+    }
+}
 export async function postJson(path, body) {
-    const response = await fetch(path, {
+    const response = await fetchWithTimeout(path, {
         method: 'POST',
         headers: { 'content-type': 'application/json' },
         body: JSON.stringify(body),
@@ -49,22 +79,24 @@ export async function postJson(path, body) {
     return parsePayload(response, () => t('common.actionFailed'));
 }
 export async function getJson(path) {
-    const response = await fetch(path, { headers: { accept: 'application/json' } });
+    const response = await fetchWithTimeout(path, { headers: { accept: 'application/json' } });
     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,8 +10,9 @@ 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 } from './pages/format.js';
+import { cycleLabel, durationText, dateSuffix, formatMediumDate, formatShortDate } from './pages/format.js';
 function WishView(props) {
     const t = useXyT();
     const wish = props.node.data.data;
@@ -95,7 +96,7 @@ function TaskView(props) {
     const showClaim = !deleted && phase === 'idle' && task.status === 'pending';
     const showCheckIn = !deleted && phase !== 'done' && (task.status === 'in_progress' || phase === 'claimed');
     const preview = event.opportunityPreview.length > 0
-        ? t('task.upcoming', { dates: event.opportunityPreview.join(activeLocale() === 'en' ? ', ' : '、') })
+        ? t('task.upcoming', { dates: event.opportunityPreview.map((date) => formatShortDate(date)).join(activeLocale() === 'en' ? ', ' : '、') })
         : undefined;
     return createElement('div', { className: `xy-card ${deleted ? 'xy-deleted' : ''}` }, createElement('div', { className: 'xy-card-head' }, createElement('span', { className: 'xy-badge xy-badge-task' }, t('badge.task')), createElement('span', { className: 'xy-title' }, deleted ? t('state.deleted', { title: task.name }) : task.name), !deleted && phase === 'done'
         ? createElement('span', { className: 'xy-meta xy-actioned' }, 
@@ -105,7 +106,7 @@ function TaskView(props) {
         ? createElement('button', { className: 'xy-btn xy-btn-inline', disabled: busy, onClick: () => run('claim') }, t('action.claim'))
         : null, showCheckIn
         ? createElement('button', { className: 'xy-btn xy-btn-primary xy-btn-inline', disabled: busy, onClick: () => run('checkin') }, t('action.checkin'))
-        : null), createElement('div', { className: 'xy-meta' }, `${cycleLabel(task.checkInCycle)}${task.dueDate !== undefined ? ` · ${t('task.due', { date: task.dueDate })}` : ''} · ${durationText(task.completedDays, task.requiredDays)}`), deleted === false && preview !== undefined
+        : null), createElement('div', { className: 'xy-meta' }, `${cycleLabel(task.checkInCycle)}${task.dueDate !== undefined ? ` · ${t('task.due', { date: formatShortDate(task.dueDate) })}` : ''} · ${durationText(task.completedDays, task.requiredDays)}`), deleted === false && preview !== undefined
         ? createElement('div', { className: 'xy-preview' }, preview)
         : null);
 }
@@ -139,23 +140,31 @@ function CheckinView(props) {
     const event = props.node.data.data;
     const cancelled = event.op === 'cancelled';
     return createElement('div', { className: 'xy-card xy-checkin' }, createElement('div', { className: 'xy-card-head' }, createElement('span', { className: `xy-glyph ${cancelled ? 'xy-glyph-back' : 'xy-glyph-ok'}`, 'aria-hidden': 'true' }, cancelled ? '↩' : '✓'), createElement('span', { className: 'xy-title' }, cancelled
-        ? t('checkin.cancelled', { task: event.taskName, date: event.date })
-        : t('checkin.success', { task: event.taskName }))), createElement('div', { className: 'xy-meta' }, `${event.date}${event.wishName !== undefined ? ` · ${event.wishName}` : ''} · ${durationText(event.completedDays, event.requiredDays)}`));
+        ? t('checkin.cancelled', { task: event.taskName, date: formatShortDate(event.date) })
+        : t('checkin.success', { task: event.taskName }))), createElement('div', { className: 'xy-meta' }, `${formatShortDate(event.date)}${event.wishName !== undefined ? ` · ${event.wishName}` : ''} · ${durationText(event.completedDays, event.requiredDays)}`));
 }
 function ChartView(props) {
     const t = useXyT();
     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), chartBody(event, t('chart.noData'), hoverIdx, setHoverIdx));
+    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, title, t('chart.noData'), t('chart.noSchedule'), hoverIdx, setHoverIdx));
 }
-/** 图表卡主体：四类渲染路径（占比条/占比列表/热力格/柱图）颜色全部走主题变量，深浅色自适应。 */
-function chartBody(event, noDataText, 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.map((d) => d.value), 1);
-    const labelValue = (d) => `${d.label}${activeLocale() === 'en' ? ': ' : '：'}${d.value}`;
+    const max = Math.max(...data.filter((d) => !d.inactive).map((d) => d.value), 1);
+    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)}%`), 
@@ -165,7 +174,7 @@ function chartBody(event, noDataText, 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', {
@@ -175,7 +184,7 @@ function chartBody(event, noDataText, 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)';
@@ -187,19 +196,23 @@ function chartBody(event, noDataText, hoverIdx, onHover) {
         const r = Math.min(2, h, w / 2);
         return `M${x},${y + h}L${x},${y + r}Q${x},${y} ${x + r},${y}L${x + w - r},${y}Q${x + w},${y} ${x + w},${y + r}L${x + w},${y + h}Z`;
     };
-    const bars = data.map((d, i) => {
+    const bars = data.flatMap((d, i) => {
+        // 无安排日不画柱（缺失≠0）：空槽由下标占位保留，柱序与日期轴不塌缩
+        if (d.inactive === true)
+            return [];
         // 微值可见性下限：有值但按比例不足 2px 的柱给 2px，避免「有数据却看不见」
         const rawH = Math.round((d.value / max) * (height - 24));
         const h = d.value > 0 ? Math.max(rawH, 2) : rawH;
         const seriesIdx = d.series !== undefined ? seriesList.indexOf(d.series) : -1;
-        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 },
-            onMouseEnter: () => onHover(i),
-        }, 
-        // 每根柱子带 <title>：原生悬停提示；精确数值另由上方悬浮明细条实时呈现
-        createElement('title', null, labelValue(d)));
+        return [createElement('path', {
+                key: i,
+                d: topRoundedBar(i * step + 2, height - 18 - h, Math.max(step - 4, 2), h),
+                // 次要序列 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>：原生悬停提示；精确数值另由上方悬浮明细条实时呈现
+            createElement('title', null, labelValue(d)))];
     });
     // 标签用原始下标定位：indexOf 会把重复标签（如分组系列的「周一」×2）全部钉到首个位置
     const labelStep = data.length <= 10 ? 1 : Math.ceil(data.length / 8);
@@ -209,9 +222,9 @@ function chartBody(event, noDataText, 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) }, 
@@ -220,8 +233,8 @@ function chartBody(event, noDataText, 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.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;
+}