@starwish-ai/xingyuan-dsh 0.5.5 → 0.5.6

package/CHANGELOG.md

@@ -5,6 +5,89 @@ 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,

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
 

package/README.md

@@ -13,7 +13,7 @@
 - **对话驱动**：自然语言创建愿望 / 任务，自动查重相似项
 - **机会日打卡**：周期任务打卡、补卡、取消、未来预勾，进度跨天恒为最新
 - **微行动拆解**：把无从下手的目标拆成 3–7 个小步，引导式逐个完成或跳过
-- **成长体系**：等级 Lv.1–Lv.10、连击加成、统计卡与近 30 天柱状图
+- **成长体系**：等级 Lv.1–Lv.10、连续加成、统计卡与近 30 天柱状图
 - **会话视图页**：今日 / 愿望 / 任务 / 日历 / 成长 / 记忆 六个标签页，页面按钮直连动作接口；
   默认仅星愿预设的会话显示，可在设置里切换「始终显示 / 始终隐藏」并按标签勾选
 - **记忆**：重要记忆自动注入上下文（上限可配），支持增删改查

package/lib/client/api.js

@@ -40,8 +40,15 @@ const ERROR_KEY = {
     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 或插值崩溃

package/lib/client/i18n.js

@@ -42,6 +42,7 @@ export const ZH_DICT = {
     'common.requestFailed': '请求失败',
     'common.actionFailed': '操作失败',
     'common.requestTimeout': '请求超时，请重试',
+    'common.networkError': '网络连接失败，请确认星愿服务已启动后重试',
     'common.dayUnit': '{n} 天',
     'common.countUnit': '{n} 次',
     'common.countUnitOne': '{n} 次',
@@ -158,9 +159,9 @@ export const ZH_DICT = {
     'growth.levelLabel': '当前等级',
     'growth.levelFallback': '初心者',
     'growth.maxed': '已满级',
-    'growth.expFormat': '{cur} / {next} EXP',
+    'growth.expFormat': '{cur} / {next} 经验',
     'growth.levelRequire': '需要 {exp} 经验',
-    'growth.rewardPrefix': '当前等级权益：{reward}',
+    'growth.rewardPrefix': '当前等级荣誉：{reward}',
     'growth.stat.checkinDays': '累计打卡天数',
     'growth.stat.streak': '连续坚持',
     'growth.stat.maxStreak': '最长连续坚持',
@@ -181,23 +182,23 @@ export const ZH_DICT = {
     'growth.lv.1.name': '初心者',
     'growth.lv.1.reward': '开启星愿之旅',
     'growth.lv.2.name': '探索者',
-    'growth.lv.2.reward': '解锁更多 AI 对话功能',
+    'growth.lv.2.reward': '晋升「探索者」称号',
     'growth.lv.3.name': '实践者',
-    'growth.lv.3.reward': '获得专属头像框',
+    'growth.lv.3.reward': '晋升「实践者」称号',
     'growth.lv.4.name': '坚持者',
-    'growth.lv.4.reward': '解锁高级教练风格',
+    'growth.lv.4.reward': '晋升「坚持者」称号',
     'growth.lv.5.name': '奋斗者',
-    'growth.lv.5.reward': '获得专属徽章',
+    'growth.lv.5.reward': '晋升「奋斗者」称号',
     'growth.lv.6.name': '进取者',
-    'growth.lv.6.reward': '解锁更多任务模板',
+    'growth.lv.6.reward': '晋升「进取者」称号',
     'growth.lv.7.name': '成就者',
-    'growth.lv.7.reward': '获得专属称号',
+    'growth.lv.7.reward': '晋升「成就者」称号',
     'growth.lv.8.name': '卓越者',
-    'growth.lv.8.reward': '解锁全部教练风格',
+    'growth.lv.8.reward': '晋升「卓越者」称号',
     'growth.lv.9.name': '领航者',
-    'growth.lv.9.reward': '获得限定头像框',
+    'growth.lv.9.reward': '晋升「领航者」称号',
     'growth.lv.10.name': '星愿大师',
-    'growth.lv.10.reward': '解锁全部特权，成为星愿大师',
+    'growth.lv.10.reward': '晋升「星愿大师」——星愿之旅的最高荣誉',
     // --- 记忆页 ---
     'memory.pageTitle': '记忆',
     'memory.summary': '共 {total} 条 · 对话时按上限自动注入',
@@ -218,6 +219,7 @@ export const ZH_DICT = {
     'memory.footNote': '删除与清空不可恢复；注入条数上限在 设置 → 星愿 调整。',
     'memory.clearAll': '清空全部记忆',
     'memory.needKeyAndValue': '键名和内容都要填写。',
+    'memory.keyTooShort': '键名至少需要 2 个字符。',
     'memory.overwriteAsk': '「{key}」已存在，覆盖原内容吗？',
     'memory.confirmDelete': '删除记忆「{key}：{value}」？删除后不可恢复。',
     'memory.confirmClear': '清空全部 {total} 条记忆？此操作不可恢复！',
@@ -259,7 +261,7 @@ export const ZH_DICT = {
     'settings.profile.saved': '画像已保存',
     'settings.profile.sharedHint': '与对话侧共享同一份档案；对话里说「叫我小星」也会更新。',
     'settings.pref.title': '对话偏好',
-    'settings.pref.unavailable': '当前连接不支持持久化偏好（远程或临时模式），以下两项不可用。',
+    'settings.pref.unavailable': '当前连接不支持持久化偏好（远程或临时模式），以下选项不可用。',
     'settings.pref.loading': '偏好加载中…',
     'settings.pref.notRegistered': '偏好暂不可用（组件未就绪），请稍后重试。',
     'settings.pref.readOnly': '当前设置为只读，无法保存修改。',
@@ -461,6 +463,7 @@ const EN_DICT = {
     'common.requestFailed': 'Request failed',
     'common.actionFailed': 'Action failed',
     'common.requestTimeout': 'Request timed out, please retry',
+    'common.networkError': 'Network request failed. Make sure the XingYuan service is running, then try again',
     'common.dayUnit': '{n} days',
     'common.countUnit': '{n} times',
     'common.countUnitOne': '{n} time',
@@ -591,23 +594,23 @@ const EN_DICT = {
     'growth.lv.1.name': 'Novice',
     'growth.lv.1.reward': 'Begin your journey',
     'growth.lv.2.name': 'Explorer',
-    'growth.lv.2.reward': 'Unlock more AI chat features',
+    'growth.lv.2.reward': 'Earn the “Explorer” title',
     'growth.lv.3.name': 'Practitioner',
-    'growth.lv.3.reward': 'Earn an exclusive avatar frame',
+    'growth.lv.3.reward': 'Earn the “Practitioner” title',
     'growth.lv.4.name': 'Perseverer',
-    'growth.lv.4.reward': 'Unlock advanced coach styles',
+    'growth.lv.4.reward': 'Earn the “Perseverer” title',
     'growth.lv.5.name': 'Striver',
-    'growth.lv.5.reward': 'Earn an exclusive badge',
+    'growth.lv.5.reward': 'Earn the “Striver” title',
     'growth.lv.6.name': 'Go-getter',
-    'growth.lv.6.reward': 'Unlock more task templates',
+    'growth.lv.6.reward': 'Earn the “Go-getter” title',
     'growth.lv.7.name': 'Achiever',
-    'growth.lv.7.reward': 'Earn an exclusive title',
+    'growth.lv.7.reward': 'Earn the “Achiever” title',
     'growth.lv.8.name': 'Paragon',
-    'growth.lv.8.reward': 'Unlock all coach styles',
+    'growth.lv.8.reward': 'Earn the “Paragon” title',
     'growth.lv.9.name': 'Pathfinder',
-    'growth.lv.9.reward': 'Earn a limited avatar frame',
+    'growth.lv.9.reward': 'Earn the “Pathfinder” title',
     'growth.lv.10.name': 'XingYuan Master',
-    'growth.lv.10.reward': 'Unlock all perks and become a XingYuan Master',
+    'growth.lv.10.reward': 'Earn the “XingYuan Master” title — the highest honor of the journey',
     'memory.pageTitle': 'Memories',
     'memory.summary': '{total} in total · auto-injected up to the limit during chats',
     'memory.editing': 'Editing “{key}” (key is fixed)',
@@ -627,9 +630,10 @@ const EN_DICT = {
     'memory.footNote': 'Deletions are permanent; adjust the injection limit under Settings → XingYuan.',
     'memory.clearAll': 'Clear all memories',
     'memory.needKeyAndValue': 'Both key and content are required.',
+    'memory.keyTooShort': 'Key must be at least 2 characters.',
     'memory.overwriteAsk': '“{key}” already exists. Overwrite it?',
     'memory.confirmDelete': 'Delete memory “{key}: {value}”? This cannot be undone.',
-    'memory.confirmClear': 'Clear all {total} memories? This cannot be undone!',
+    'memory.confirmClear': 'Clear all memories ({total})? This cannot be undone!',
     'memory.savedNew': 'Added “{key}”',
     'memory.savedOverwrite': 'Saved “{key}”',
     'memory.deletedOne': '“{key}” deleted',
@@ -667,7 +671,7 @@ const EN_DICT = {
     'settings.profile.saved': 'Profile saved',
     'settings.profile.sharedHint': 'Shared with the chat side; saying “call me Star” in chat updates it too.',
     'settings.pref.title': 'Chat preferences',
-    'settings.pref.unavailable': 'This connection cannot persist preferences (remote or temporary mode); the two options below are disabled.',
+    'settings.pref.unavailable': 'This connection cannot persist preferences (remote or temporary mode); the options below are disabled.',
     'settings.pref.loading': 'Loading preferences…',
     'settings.pref.notRegistered': 'Preferences are unavailable right now (component not ready); please retry later.',
     'settings.pref.readOnly': 'Settings are read-only; changes cannot be saved.',
@@ -749,7 +753,7 @@ const EN_DICT = {
     'chart.subtitle.daysRatio': '{done}/{due} days',
     'chart.subtitle.streak': 'Current {current}d / best {best}d',
     'detail.grid.title': 'Check-in record',
-    'detail.grid.summary': 'Last {total} cells: {checked} checked, {missed} missed, {future} pending',
+    'detail.grid.summary': 'Last {total} cell(s): {checked} checked, {missed} missed, {future} pending',
     'detail.legend.checked': 'Checked in',
     'detail.legend.missed': 'Missed',
     'detail.legend.future': 'Pending today',
@@ -905,7 +909,12 @@ export function useXyT() {
     return xyTranslateStable;
 }
 const xyTranslateStable = (key, params) => t(key, params);
-/** 当前语言（供调试/埋点类场景；无 face 时返回 'zh' 兜底口径）。 */
+/** 当前语言（供调试/埋点类场景；无 face 时返回 'zh' 兜底口径）。
+ * 平台事实（rc.2 实测）：宿主发布的 LocaleFace 契约（dsh-client-ui-slots
+ * renderer.d.ts）只声明 getSnapshot(): { revision } 与 bind(ns)，快照的 `active`
+ * 字段不在类型面内但运行时存在——本函数依赖它做语言判定，读取处已做 unknown
+ * 收窄，字段缺席时静默回落 zh（en 用户会看到英文正文配中文日期，而非崩溃）。
+ * 上游若把 active 纳入正式契约，此处无需改动。 */
 export function activeLocale() {
     if (localeFace === undefined)
         return 'zh';

package/lib/client/pages/growth.js

@@ -32,8 +32,9 @@ function levelRewardKey(level) {
 }
 function localLevelName(level, fallback) {
     const dict = translate(levelNameKey(level));
-    // 键缺词时 t() 回落键名本身——zh 词表覆盖 1-10，命中即用；否则用服务端原文
-    return dict !== levelNameKey(level) ? dict : fallback ?? '';
+    // 键缺词时 t() 回落键名本身——zh 词表覆盖 1-10，命中即用；否则用服务端原文；
+    // 两者皆缺（未知等级且服务端未带名）落到词典兜底键，读屏不再得到空等级名
+    return dict !== levelNameKey(level) ? dict : (fallback ?? translate('growth.levelFallback'));
 }
 function localLevelReward(level, fallback) {
     const dict = translate(levelRewardKey(level));

package/lib/client/pages/memory.js

@@ -178,6 +178,12 @@ export function MemoryPage() {
             setFormError(t('memory.needKeyAndValue'));
             return;
         }
+        // 与服务端 schema 同口径（min 2）：在错误发生的位置就地引导，而非让服务端
+        // 的 missing_field 被客户端按 code 覆盖成通用文案
+        if (key.length < 2) {
+            setFormError(t('memory.keyTooShort'));
+            return;
+        }
         setFormError(undefined);
         const knownExists = editingKey !== undefined || allItems.some((m) => m.key === key);
         if (knownExists && editingKey === undefined) {
@@ -260,10 +266,18 @@ export function MemoryPage() {
         value: query, onChange: (e) => setQuery(e.target.value),
     }), notice !== undefined ? createElement('span', { className: 'xy-saved', role: 'status' }, notice) : null), data.total > allItems.length
         ? createElement('div', { className: 'xy-meta xy-memcap' }, t('memory.capNote', { total: data.total, shown: allItems.length }))
-        : null, data.total === 0
-        ? createElement(PageEmpty, { title: t('memory.empty.title'), hint: t('memory.empty.hint') })
+        : null, data.total === 0 && debounced.trim() === ''
+        ? // 真·空库。服务端 total 本身按关键词过滤，settle 后零命中搜索的 total 也是
+            // 0——不以「无搜索词」为前提区分的话，零命中会错用「还没有任何记忆」文案
+            createElement(PageEmpty, { title: t('memory.empty.title'), hint: t('memory.empty.hint') })
         : filtered.length === 0
-            ? createElement(PageEmpty, { title: t('memory.searchEmpty.title') })
+            ? // 空态仅在防抖 settle 后判定：本地过滤用逐键 query、数据按防抖词取回，
+                // 输入中渲染空白（null = 卸载该节点，无行可显示时不闪空态文案）。
+                // 已知残余：debounce settle → 新数据落地之间旧数据按新词过滤为空时，
+                // 仍可能短暂显示一次空态（数据载荷不带检索词，无法精确判定，量级可接受）
+                query.trim() === debounced.trim()
+                    ? createElement(PageEmpty, { title: t('memory.searchEmpty.title') })
+                    : null
             : // 列表收进单张分组卡：分隔线行替代逐行描边盒子，长列表不再满屏边框噪音
                 createElement('section', { className: 'xy-group' }, createElement('ul', { className: 'xy-grouplist' }, rows)), hasMore
         ? createElement('div', { className: 'xy-memfoot' }, createElement('button', { className: 'xy-btn', disabled: loadingMore || busy, onClick: loadMore }, loadingMore ? `${t('common.loading')}…` : t('memory.more')), loadError !== undefined ? createElement('span', { className: 'xy-field-err' }, loadError) : null)

package/lib/client/pages/task-line.js

@@ -1,25 +1,40 @@
 /** 任务行（愿望页/任务页共用）：状态元信息 + 领取/打卡内联动作。 */
 import { createElement } from 'react';
 import { postAction } from '../api.js';
-import { toast } from '../ui.js';
+import { focusPageTitle, toast } from '../ui.js';
 import { useXyT } from '../i18n.js';
 import { softConfirm, useActionGuard } from '../hooks.js';
 import { cycleLabel, durationText, closedStatusLabel, dateSuffix, formatShortDate } from './format.js';
 export function TaskLine(props) {
     const t = useXyT();
-    const { task, today, onChanged, trailing } = props;
+    const { task, today, onChanged, trailing, focusAfterClaim } = props;
     const { busy, guard } = useActionGuard();
     const act = (action, body, doneText) => {
-        guard(() => postAction(action, body).then((payload) => {
-            if (doneText !== undefined)
-                toast(doneText(payload), 'ok');
-            return Promise.resolve(onChanged()).then(() => undefined);
-        }));
+        // 返回动作 promise（闭包捕获，与今日页同款）供调用方接续焦点移交
+        let run;
+        guard(() => {
+            run = postAction(action, body).then((payload) => {
+                if (doneText !== undefined)
+                    toast(doneText(payload), 'ok');
+                return Promise.resolve(onChanged()).then(() => undefined);
+            });
+            return run;
+        });
+        return run ?? Promise.resolve();
     };
     // 未来机会日：预勾 = 承诺当天完成（与对话侧确认语义一致），按钮如实标注并二次确认
     const futureDate = task.nextOpportunityDate !== undefined && task.nextOpportunityDate > today ? task.nextOpportunityDate : undefined;
     const checkIn = () => {
-        const submit = () => act('checkin', { taskId: task.taskId }, (p) => t('toast.checkinOk') + dateSuffix(typeof p.date === 'string' ? String(p.date) : undefined));
+        const submit = () => {
+            // 一次打卡使任务完结时（任务页跨状态分组 / 愿望卡行迁入已完成），原按钮随
+            // DOM 销毁、焦点落空——交给页面标题兜底；未完结的行原地复用 DOM，无需移动焦点
+            // 镜像 isTaskDone 口径：requiredDays=0（无截止日不限次）任务永不关闭，
+            // 打卡后行原地复用 DOM，不该把焦点拽离
+            const closes = task.requiredDays > 0 && task.completedDays + 1 >= task.requiredDays;
+            void act('checkin', { taskId: task.taskId }, (p) => t('toast.checkinOk') + dateSuffix(typeof p.date === 'string' ? String(p.date) : undefined))
+                .then(() => { if (closes)
+                focusPageTitle(); }, () => { });
+        };
         if (futureDate === undefined) {
             submit();
             return;
@@ -35,7 +50,11 @@ export function TaskLine(props) {
         + `${task.dueDate !== undefined ? ` · ${t('task.due', { date: formatShortDate(task.dueDate) })}` : ''}`), createElement('div', { style: { display: 'flex', gap: '6px', alignItems: 'center', flexWrap: 'wrap' } }, task.status === 'pending'
         ? createElement('button', {
             className: 'xy-btn', disabled: busy,
-            onClick: () => act('claim', { taskId: task.taskId }, () => t('toast.claimed', { name: task.name })),
+            onClick: () => {
+                void act('claim', { taskId: task.taskId }, () => t('toast.claimed', { name: task.name }))
+                    .then(() => { if (focusAfterClaim)
+                    focusPageTitle(); }, () => { });
+            },
         }, t('action.claim'))
         : task.status === 'in_progress'
             ? createElement('button', { className: 'xy-btn xy-btn-primary', disabled: busy, onClick: checkIn }, futureDate !== undefined ? t('action.checkinFuture', { date: formatShortDate(futureDate) }) : t('action.checkin'))

package/lib/client/pages/tasks.js

@@ -46,6 +46,8 @@ export function TasksPage() {
         task,
         today: data.today,
         onChanged: page.reload,
+        // 任务页按状态分桶：领取使行迁移组别，领取后焦点交页面标题兜底
+        focusAfterClaim: true,
         trailing: createElement(DetailToggle, {
             open: expanded.has(task.taskId),
             onToggle: () => toggleDetail(task.taskId),

package/lib/client/pages/today.js

@@ -56,7 +56,12 @@ export function TodayPage() {
             // planForDay 保证展示行必为未打卡的进行中任务，canCheckIn 恒 true——
             // 不再有「disabled 但无解释」的死分支；disabled 仅服务动作在途的 busy 窗口
             disabled: busy || !task.canCheckIn,
-            onClick: () => act('checkin', { taskId: task.taskId }, (p) => t('toast.checkinOk') + dateSuffix(typeof p.date === 'string' ? String(p.date) : undefined)),
+            onClick: () => {
+                void act('checkin', { taskId: task.taskId }, (p) => t('toast.checkinOk') + dateSuffix(typeof p.date === 'string' ? String(p.date) : undefined))
+                    // 行随刷新从「待完成」组迁入「已完成」组、原按钮销毁，焦点交给页面
+                    // 标题兜底（与下方撤销路径同款；领取行留在同一列表内不迁移，无需兜底）
+                    .then(focusPageTitle, () => { });
+            },
         }, t('action.checkin'))
         : createElement('button', {
             className: 'xy-btn', disabled: busy,

package/lib/client/styles.js

@@ -56,6 +56,10 @@ export const STYLE_TEXT = `
   --xyd-c3-soft-dot:rgba(16,185,129,.30);
   --xyd-dcell-checked:rgba(56,217,169,.42);
   --xyd-dcell-checked-dot:rgba(56,217,169,.55);
+  /* 上述成对底色的前景伙伴（同使用点收进令牌区，漂移即红） */
+  --xyd-on-c2:#7c4a03;
+  --xyd-on-c3:#065f46;
+  --xyd-on-dcell:#0b3d26;
   /* 阴影对（卡片悬停/toast/弹窗/英雄卡）：深浅各自配档，禁止正文区裸写 rgba */
   --xyd-shadow-card:0 2px 10px rgba(15,23,42,.07);
   --xyd-shadow-toast:0 8px 24px -8px rgba(15,23,42,.2),0 2px 8px -2px rgba(15,23,42,.1);
@@ -102,6 +106,9 @@ body[data-ds-dark-theme]{
   --xyd-c3-soft-dot:rgba(52,211,153,.30);
   --xyd-dcell-checked:rgba(46,160,105,.32);
   --xyd-dcell-checked-dot:rgba(46,160,105,.45);
+  --xyd-on-c2:#ffd9a8;
+  --xyd-on-c3:#a7f3c9;
+  --xyd-on-dcell:#a7f3c9;
   --xyd-shadow-card:0 2px 10px rgba(0,0,0,.32);
   --xyd-shadow-toast:0 8px 24px -8px rgba(0,0,0,.5),0 2px 8px -2px rgba(0,0,0,.35);
   --xyd-shadow-modal:0 24px 48px -16px rgba(0,0,0,.55),0 4px 12px -4px rgba(0,0,0,.4);
@@ -129,7 +136,7 @@ body[data-ds-dark-theme] .xy-badge-cat{background:hsl(var(--cat-h,275) calc(var(
 .xy-badge-chart{background:var(--xyd-ok-badge)}
 .xy-badge-micro{background:var(--xyd-warn-soft)}
 .xy-title{min-width:0;font-weight:600;color:var(--dsw-alias-label-primary);overflow-wrap:anywhere}
-.xy-deleted{opacity:.55}
+.xy-deleted{opacity:.65}
 .xy-deleted .xy-title{text-decoration:line-through}
 .xy-meta{color:var(--dsw-alias-label-secondary);font-size:12px;margin-top:4px;overflow-wrap:anywhere}
 /* 次级面板底上的次要文字用专用对（壳通用次要色对 layer-2 仅 ≈4.3:1，双主题同病） */
@@ -146,9 +153,12 @@ body[data-ds-dark-theme] .xy-badge-cat{background:hsl(var(--cat-h,275) calc(var(
 .xy-microstep{display:flex;align-items:flex-start;gap:8px;padding:7px 10px;border:1px solid var(--dsw-alias-border-l1);border-radius:var(--xyd-r-inner);background:var(--dsw-alias-bg-layer-2)}
 .xy-microstep.xy-done{opacity:.74}
 .xy-microstep.xy-done .xy-microsteptext{text-decoration:line-through}
-.xy-microstep.xy-skipped{opacity:.58}
+.xy-microstep.xy-skipped{opacity:.65}
 .xy-microstepnum{flex:none;width:20px;height:20px;border-radius:50%;background:var(--xyd-accent);color:var(--xyd-on-accent);display:inline-flex;align-items:center;justify-content:center;font-size:11px;font-weight:700;margin-top:1px}
 .xy-microsteptext{font-size:13px;display:flex;flex-direction:column;min-width:0}
+/* 卡内步骤说明/状态词的背景是 layer-2：次要文字用 label-on-2 专用对（壳通用
+   * 次要色对 layer-2 仅 ≈4.3:1，双主题同病——与 xy-preview 同一治理线） */
+.xy-microstep .xy-meta{color:var(--xyd-label-on-2)}
 .xy-microstate{margin-left:auto;flex:none}
 
 /* 图表卡 */
@@ -356,14 +366,15 @@ body[data-ds-dark-theme] .xy-badge-cat{background:hsl(var(--cat-h,275) calc(var(
  * （c1 底色对卡底仅 ≈1.1:1，图例点有描边而圆章没有——两侧观感不一致） */
 .xy-c1 .xy-daynum{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);box-shadow:inset 0 0 0 1px var(--dsw-alias-border-l2)}
 /* 部分完成 / 全部完成 = 柔和语义底，字色按主题配对保证 ≥4.5:1 */
-.xy-c2 .xy-daynum{background:var(--xyd-c2-soft);color:#7c4a03}
-.xy-c3 .xy-daynum{background:var(--xyd-c3-soft);color:#065f46}
-body[data-ds-dark-theme] .xy-c2 .xy-daynum{color:#ffd9a8}
-body[data-ds-dark-theme] .xy-c3 .xy-daynum{color:#a7f3c9}
-/* hover 晕底排除已选中格：specificity 高于 .xy-picked 单类选择器，
- * 不排除的话悬停在已选日上会用晕底盖掉选中实底（视觉上「取消选中」） */
+.xy-c2 .xy-daynum{background:var(--xyd-c2-soft);color:var(--xyd-on-c2)}
+.xy-c3 .xy-daynum{background:var(--xyd-c3-soft);color:var(--xyd-on-c3)}
+body[data-ds-dark-theme] .xy-c2 .xy-daynum{color:var(--xyd-on-c2)}
+body[data-ds-dark-theme] .xy-c3 .xy-daynum{color:var(--xyd-on-c3)}
+/* hover 晕底排除已选中格与语义状态格：specificity 高于单类选择器，不排除的话
+ * 悬停在已选日上会用晕底盖掉选中实底（视觉上「取消选中」）；c2/c3 同理——
+ * 状态底色正是用户悬停核对的那个信息，不能在悬停瞬间被晕底抹掉 */
 @media (hover:hover) and (pointer:fine){
-  .xy-cell:not(.xy-outside):not(.xy-picked):hover .xy-daynum{background:var(--xyd-accent-soft)}
+  .xy-cell:not(.xy-outside):not(.xy-picked):not(.xy-c2):not(.xy-c3):hover .xy-daynum{background:var(--xyd-accent-soft)}
 }
 /* 今日 = accent 环包圆章：不覆盖状态底色（「今天该打卡」的提示不能被吃掉） */
 .xy-today .xy-daynum{box-shadow:0 0 0 2px var(--xyd-accent)}
@@ -450,7 +461,7 @@ button.xy-growth-col.xy-hover{box-shadow:inset 0 0 0 2px var(--xyd-accent-ring)}
 .xy-compose select.xy-input{width:auto}
 .xy-editing{display:flex;align-items:center;gap:10px;margin-top:12px;padding:7px 10px;border:1px dashed var(--dsw-alias-border-l2);border-radius:var(--xyd-r-inner)}
 .xy-memactions{display:flex;gap:6px;flex:none}
-.xy-membar{display:flex;align-items:center;gap:10px;margin-top:14px}
+.xy-membar{display:flex;align-items:center;gap:10px;margin-top:14px;flex-wrap:wrap}
 .xy-membar .xy-input-search{width:min(250px,100%)}
 .xy-memcap{margin-top:6px}
 /* 超长记忆值 3 行截断（≤1000 字符记录不再撑出数屏高行；完整值在删除确认弹窗可见） */
@@ -495,8 +506,8 @@ button.xy-growth-col.xy-hover{box-shadow:inset 0 0 0 2px var(--xyd-accent-ring)}
 .xy-dcell-blank{visibility:hidden}
 /* 今日格 = accent 环包底色：与日历页圆章的 today 环同一语法 */
 .xy-dcell.xy-dcell-today{box-shadow:0 0 0 2px var(--xyd-accent)}
-.xy-dcell-checked{background:var(--xyd-dcell-checked);color:#0b3d26}
-body[data-ds-dark-theme] .xy-dcell-checked{color:#a7f3c9}
+.xy-dcell-checked{background:var(--xyd-dcell-checked);color:var(--xyd-on-dcell)}
+body[data-ds-dark-theme] .xy-dcell-checked{color:var(--xyd-on-dcell)}
 .xy-dcell-missed{background:transparent;border:1px dashed var(--dsw-alias-border-l3);color:var(--dsw-alias-label-secondary)}
 .xy-dcell-future{background:var(--dsw-alias-bg-layer-2);color:var(--xyd-label-on-2);border:1px solid var(--dsw-alias-border-l1)}
 /* 图例复用 xy-dot 时借格子的语义底色（同色系小尺寸） */