@starwish-ai/xingyuan-dsh 0.5.5 → 0.5.7

package/CHANGELOG.md

@@ -5,6 +5,200 @@ 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.7] - 2026-08-29
+
+> **Note:** this release is the third six-perspective quality pass (product,
+> design, end-user, dsh-plugin engineering, architecture, UX). It closes the
+> last honesty gap in the write paths, makes tab switching lossless for
+> in-progress input, hardens the opportunity-date calculator against a
+> process-hanging edge case, and lands the accessibility/contrast leftovers.
+> No data format changes; existing databases and recorded sessions replay as before.
+
+### Added
+- **Draft snapshots across tab switches**: typing a memory (up to 1000 chars)
+  or filling the quick-create forms used to be silently lost when switching
+  conversation view tabs (pages unmount on switch). Form drafts now survive tab
+  switches and panel collapse; successful saves clear them.
+- **Instant growth feedback on check-in**: the check-in tool reply appends the
+  current level and experience progress, closing the "check in → grow" loop at
+  the moment of the action instead of deferring it to the Growth page.
+- **Non-preset session hint on the chat-directed pages**: in "always show" mode the six tabs
+  render in every session, but wishes/tasks/memory empty states directed users
+  to a chat that has no XingYuan tools there. The Today page's "preset not
+  enabled" hint row now also renders on the other three pages.
+- **HTTP shell tests**: route dispatch (status-code mapping, the 64 KB limit,
+  JSON parsing, the `ToolError.code` passthrough that powers client-side error
+  localization) had zero coverage; locked with mocked `IncomingMessage`/
+  `ServerResponse` in `test/routes-shell.test.ts`.
+
+### Changed
+- **Claiming an overdue unclaimed task is rejected, not silently closed**
+  (`claim_expired`): the old flow claimed it and immediately expired-closed it
+  while the tool reply asserted "claimed, now in progress" and the page toast
+  said "go check in" — both false, and the task-line button kept offering an
+  action that always fails. The row shows a guidance hint instead, the chat
+  task card hides its claim button for the same state, and the detail panel's
+  revive row (extend due date) now also covers overdue-unclaimed tasks.
+- **The early check-in confirms no longer assert a falsehood**: the task-row,
+  card and detail dialogs said "today is not a check-in day" — false when today
+  was already checked in (the natural path: check in via chat, then tap the
+  button on the updated card); the calendar dialog said "{date} is not a
+  check-in day" for a day the panel only lists because it IS one. All four now
+  state only what is true: the target day is after today, and an early check-in
+  commits to finishing that day.
+- **Growth-ladder and completed rows dim by text color, not row opacity**:
+  whole-row `opacity` (0.65-0.78) blended 12 px text below the WCAG AA 4.5:1
+  line (≈2.6-3.1:1 measured in both themes); the hierarchy now comes from the
+  secondary text color (4.76/5.15:1) while transparency stays on decorative
+  elements only.
+- **Danger icon buttons share one quiet tier**: the memory-row delete joined
+  the wish-card delete at 0.78 idle opacity with hover/focus restore (long
+  lists stop glowing red; non-text contrast ≥3:1, the stale "≥4.5:1" comment
+  corrected to the non-text standard).
+- **Growth chart stops squeezing its columns on narrow panels**: below the
+  520 px breakpoint the 30 daily columns scroll horizontally at a minimum
+  width (~13 px per column, up from ~10 px) instead of being flex-crushed;
+  a deliberate trade-off against the 24 px touch-target ideal, whose full
+  width would make the chart scroll several screens.
+- **HITL confirm sorts callers by whether any confirm UI exists**: callers
+  with no confirm UI at all (`NO_PROVIDER`, `CALLER_NOT_LIVE` — both raised
+  before `NO_PROVIDER` in rc.2) are allowed, as before for headless; a
+  delegated caller (`DELEGATED_CALLER`, e.g. a session-spawned subagent) is
+  now failed closed with actionable guidance ("confirm in the main
+  conversation, then run it there") instead of the raw platform error —
+  keeping the always-on delete confirmation intact on delegated paths.
+  Recorded in the engineering doc's HITL contract section.
+- **weekly/monthly expectation management**: tool descriptions and the task
+  guide now state that opportunity days run from the claim date (every 7 days /
+  monthly by claim date) and never bind to a weekday — the model must say so
+  instead of silently accepting "every Wednesday" requests. Recorded in Known
+  Limitations.
+- **The recommendation tool states its ordering**: `get_recommended_tasks` is
+  a fixed "top 5 by historical check-in count" ranking, not curation;
+  description and reply now say so.
+- **Dedup guidance covers paraphrase**: the wish/task guides instruct the model
+  to sweep the existing list semantically when substring dedup finds no hit but
+  the request is loosely phrased.
+- **Prompt/UI drift sync**: the Tasks page has four status groups (not three)
+  and two more settings entries (confirm-card language, tab visibility) — the
+  capabilities section now matches what users see.
+- **Copy/wording**: user-facing strings unify "机会日" to "打卡日" (the check-in
+  tool guidance already used the plain term; leftover error strings swept
+  too); the bare-wish card points to the
+  chat path for task suggestions; the task-created toast explains "claim it to
+  start checking in"; five English strings polished ("To check in", "entries",
+  "Check-ins · last 30 days", "saved when you leave the field", the grid
+  summary).
+
+### Fixed
+- **Opportunity-date loops can no longer hang the process**: termination used
+  ISO string comparison, which silently assumes four-digit years — a sequence
+  crossing 9999-12-31 (only reachable via hand-edited sqlite) compared
+  `'10000-xx' <= '9999-xx'` as true forever, hanging daily/weekly/monthly in an
+  allocating loop. Termination is now numeric (UTC day numbers; the monthly
+  branch via `Date.UTC`, since `Date.parse('10000-…')` returns `NaN`). Locked
+  by termination tests including the year-boundary crossing.
+- **Toast glyph semantics & screen readers**: the info glyph was "★" — the star
+  is the high-importance memory marker (`.xy-star-hi`); info is now "i", and
+  toast glyphs are `aria-hidden` so decorative symbols are not announced inside
+  the live region.
+- **Centered header baselines**: the `.xy-meta` top margin leaked into centered
+  card/page heads, sinking secondary text by 2 px; the treatment the detail
+  area already had now covers the heads too.
+- **Focus management**: closing the category rename editor returns focus (to
+  the row's rename button, or the page title when the row was rebuilt by a
+  rename); finishing the last "load more" page moves focus to the "all shown"
+  line and announces it (`role="status"`).
+- **Docs**: reference links pointed at the nonexistent `main` branch of the
+  upstream repository (the default branch is `master`) and at a cookbook page
+  that does not exist (the conversation-node contract lives in
+  `subsystems/conversation`); a dsh upgrade checklist now records the two
+  patch-DSL hazards (schedule insert id collision, storage-domain whole-line
+  replacement).
+
+## [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

@@ -22,6 +22,7 @@ const ERROR_KEY = {
     already_checked: 'err.already_checked',
     not_opportunity_day: 'err.not_opportunity_day',
     already_claimed: 'err.already_claimed',
+    claim_expired: 'err.claim_expired',
     task_closed: 'err.task_closed',
     due_past: 'err.due_past',
     due_too_far: 'err.due_too_far',
@@ -40,8 +41,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/cards.js

@@ -93,7 +93,10 @@ function TaskView(props) {
         perform();
     };
     const deleted = event.op === 'deleted';
-    const showClaim = !deleted && phase === 'idle' && task.status === 'pending';
+    // 截止日已过的待领取任务写路径拒绝领取（store.claim_expired）：卡片按钮同口径隐藏，
+    // 避免点按必失败（卡片是快照，today 取渲染当时——与写路径校验同一新鲜口径）
+    const claimExpired = task.status === 'pending' && task.dueDate !== undefined && task.dueDate < localYmd(new Date());
+    const showClaim = !deleted && phase === 'idle' && task.status === 'pending' && !claimExpired;
     const showCheckIn = !deleted && phase !== 'done' && (task.status === 'in_progress' || phase === 'claimed');
     const preview = event.opportunityPreview.length > 0
         ? t('task.upcoming', { dates: event.opportunityPreview.map((date) => formatShortDate(date)).join(activeLocale() === 'en' ? ', ' : '、') })

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} 次',
@@ -58,7 +59,7 @@ export const ZH_DICT = {
     // --- 愿望卡 / 愿望页 ---
     'wish.progress': '进度 {percent}%',
     'wish.eta': '预计完成 {date}',
-    'wish.noTasks': '暂无下属任务',
+    'wish.noTasks': '暂无下属任务——在对话里告诉我，让我为它推荐打卡任务',
     'wish.pageTitle': '我的愿望',
     'wish.summary': '{active} 个进行中{achieved}', 'wish.achievedSuffix': ' · {n} 个已达成',
     'wish.sectionAchieved': '已达成',
@@ -77,6 +78,7 @@ export const ZH_DICT = {
     'task.group.pending': '待领取',
     'task.group.achieved': '已达成',
     'task.group.expired': '已过期',
+    'task.claimExpiredHint': '该任务截止日已过，无法领取——可展开详情延长截止日重新开始',
     'task.expiredHint': '截止日已过——在下方延长截止日即可重新开始，也可以在对话里让我处理。',
     'task.pageTitle': '全部任务',
     'task.totalCount': '共 {n} 个',
@@ -106,17 +108,17 @@ export const ZH_DICT = {
     'toast.undone': '打卡已撤销',
     'toast.undoneAt': '已撤销{date}的打卡',
     'toast.wishCreated': '已创建愿望「{title}」',
-    'toast.taskCreated': '已创建任务「{name}」',
+    'toast.taskCreated': '已创建任务「{name}」，领取后开始打卡',
     'toast.deleted': '已删除「{name}」',
     'toast.categoryRenamed': '分类已改名为「{name}」',
     'toast.categoryColored': '「{name}」配色已更新',
     'toast.categoryColorReset': '「{name}」配色已重置，跟随愿望默认色',
     'toast.categoryDeleted': '已清除「{name}」的自定义颜色',
     // --- 确认弹窗 ---
-    'confirm.futureCheckin': '「{name}」今天不是打卡日，提前打卡{date}表示承诺当天完成。确认？',
+    'confirm.futureCheckin': '「{name}」的打卡日 {date} 在今天之后，提前打卡表示承诺当天完成。确认？',
     'confirm.undoToday': '确定撤销「{name}」今天的打卡吗？进度将回退。',
     'confirm.undoAt': '确定撤销「{name}」在{date}的打卡吗？进度将回退。',
-    'confirm.futureAt': '「{name}」{date}不是打卡日，提前打卡表示承诺当天完成。确认？',
+    'confirm.futureAt': '「{name}」的打卡日 {date} 在今天之后，提前打卡表示承诺当天完成。确认？',
     'confirm.deleteTask': '确定删除任务「{name}」吗？其打卡记录与微行动拆解将一并删除，不可恢复。',
     'confirm.deleteWish': '确定删除愿望「{name}」吗？下属任务、打卡记录与微行动拆解将一并删除，不可恢复。',
     'confirm.renameCategory': '把分类「{old}」下的全部愿望改名为「{new}」吗？（共 {count} 个）', 'confirm.deleteEmptyCategory': '删除空分类「{name}」的自定义颜色吗？',
@@ -158,9 +160,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 +183,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 +220,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 +262,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': '当前设置为只读，无法保存修改。',
@@ -354,7 +357,7 @@ export const ZH_DICT = {
     'detail.grid.checked': '{date} 已打卡',
     'detail.grid.missed': '{date} 未打卡',
     'detail.grid.future': '{date} 待打卡',
-    'detail.next.title': '接下来的机会日：{dates}',
+    'detail.next.title': '接下来的打卡日：{dates}',
     'detail.revive.label': '延长截止日（重新开始）',
     'detail.revive.action': '延长并重新开始',
     'detail.revive.done': '截止日已延长，任务重新开始',
@@ -423,8 +426,9 @@ export const ZH_DICT = {
     'err.missing_field': '缺少必填字段：{field}',
     'err.not_found': '目标不存在或已被删除',
     'err.already_checked': '该日期已打卡；如需修改，请先撤销当日打卡',
-    'err.not_opportunity_day': '该日期不是机会日；可在日历页选择最近的机会日',
+    'err.not_opportunity_day': '该日期不是打卡日；可在日历页选择最近的打卡日',
     'err.already_claimed': '该任务已领取过',
+    'err.claim_expired': '该任务截止日已过，无法领取——请先延长截止日使任务重新开始',
     'err.task_closed': '任务已完结，无法再打卡',
     'err.due_past': '截止日期不能早于今天',
     'err.due_too_far': '截止日期不能超过今天起 10 年',
@@ -433,7 +437,7 @@ export const ZH_DICT = {
     'err.bad_date': '日期格式或取值不合法（yyyy-MM-dd，且不得早于今天）',
     'err.overwrite_required': '已存在同名记录，需确认覆盖',
     'err.not_claimed': '任务尚未领取，请先领取',
-    'err.no_opportunity_left': '没有可勾选的打卡日：机会日已全部完成或截止',
+    'err.no_opportunity_left': '没有可勾选的打卡日：应打卡的日期已全部完成或截止',
     'err.no_checkins': '该任务暂无打卡记录',
     'err.title_too_long': '标题不能超过 50 字符',
     'err.name_too_long': '任务名不能超过 100 字符',
@@ -461,6 +465,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',
@@ -475,7 +480,7 @@ const EN_DICT = {
     'state.done': 'Done',
     'wish.progress': 'Progress {percent}%',
     'wish.eta': 'Target date {date}',
-    'wish.noTasks': 'No tasks yet',
+    'wish.noTasks': 'No tasks yet — tell me in chat and I will suggest check-in tasks for it',
     'wish.pageTitle': 'My Wishes',
     'wish.summary': '{active} in progress{achieved}',
     'wish.achievedSuffix': ' · {n} achieved',
@@ -494,6 +499,7 @@ const EN_DICT = {
     'task.group.pending': 'Unclaimed',
     'task.group.achieved': 'Achieved',
     'task.group.expired': 'Expired',
+    'task.claimExpiredHint': 'Past its due date and unclaimed — open the task detail to extend the due date and restart it',
     'task.expiredHint': 'The due date has passed — extend it below to restart the task, or just ask me in chat.',
     'task.pageTitle': 'All Tasks',
     'task.totalCount': '{n} in total',
@@ -521,16 +527,16 @@ const EN_DICT = {
     'toast.undone': 'Check-in reverted',
     'toast.undoneAt': 'Reverted the check-in on {date}',
     'toast.wishCreated': 'Wish “{title}” created',
-    'toast.taskCreated': 'Task “{name}” created',
+    'toast.taskCreated': 'Task “{name}” created — claim it to start checking in',
     'toast.deleted': '“{name}” deleted',
     'toast.categoryRenamed': 'Category renamed to “{name}”',
     'toast.categoryColored': 'Color updated for “{name}”',
     'toast.categoryColorReset': 'Color of “{name}” reset to follow wish colors',
     'toast.categoryDeleted': 'Custom color of “{name}” cleared',
-    'confirm.futureCheckin': '“{name}” is not due today. Checking in early for {date} means committing to finish it that day. Continue?',
+    'confirm.futureCheckin': 'The check-in day {date} for “{name}” is after today. Checking in early means committing to finish it that day. Continue?',
     'confirm.undoToday': "Undo today’s check-in for “{name}”? Progress will roll back.",
     'confirm.undoAt': 'Undo the check-in of “{name}” on {date}? Progress will roll back.',
-    'confirm.futureAt': '{date} is not the due day of “{name}”. Checking in early means committing to finish it that day. Continue?',
+    'confirm.futureAt': 'The check-in day {date} for “{name}” is after today. Checking in early means committing to finish it that day. Continue?',
     'confirm.deleteTask': 'Delete task “{name}”? Its check-ins and micro-step plan will be removed too. This cannot be undone.',
     'confirm.deleteWish': 'Delete wish “{name}”? Its tasks, check-ins and micro-step plans will be removed too. This cannot be undone.',
     'confirm.renameCategory': 'Rename category “{old}” to “{new}” everywhere? ({count} affected)',
@@ -581,7 +587,7 @@ const EN_DICT = {
     'growth.stat.taskTotal': 'Tasks created',
     'growth.stat.taskDone': 'Tasks achieved',
     'growth.stat.none': 'None',
-    'growth.chart.title': 'Last 30 days',
+    'growth.chart.title': 'Check-ins · last 30 days',
     'growth.chart.empty': 'No data yet. Your trend chart grows after the first check-in.',
     'growth.chart.hint': 'Blue = checked in, striped = missed gap, green = full day. Hover or focus a bar for daily details.',
     'growth.chart.tooltip': '{date}: checked {checked}/{total}',
@@ -591,23 +597,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)',
@@ -618,7 +624,7 @@ const EN_DICT = {
     'memory.importanceLabel': 'Importance: {level}',
     'memory.add': '+ Add',
     'memory.saveEdit': 'Save changes',
-    'memory.capNote': '{total} in total, showing the latest {shown}; narrow down with search.',
+    'memory.capNote': '{total} in total, showing the latest {shown} entries; narrow down with search.',
     'memory.more': 'Load more',
     'memory.loadedAll': 'All {n} shown',
     'memory.empty.title': 'No memories yet',
@@ -627,9 +633,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,14 +674,14 @@ 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.',
     'settings.pref.confirmWrites': 'Confirm write actions',
     'settings.pref.confirmWritesHint': 'Show an in-app confirmation before creating wishes/tasks, checking in or canceling (deletes always confirm). Turn off to execute directly.',
     'settings.pref.memoryLimit': 'Memory injection limit',
-    'settings.pref.memoryLimitHint': 'Max memories auto-injected per chat (5-200, default 40); saved on blur.',
+    'settings.pref.memoryLimitHint': 'Max memories auto-injected per chat (5-200, default 40); saved when you leave the field.',
     'settings.pref.limitInvalid': 'Enter an integer between 5 and 200',
     'settings.pref.writeFailed': 'The change did not save; please try again.',
     'settings.pref.confirmLang': 'Confirm card language',
@@ -749,10 +756,10 @@ 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} shown: {checked} checked, {missed} missed, {future} to check in',
     'detail.legend.checked': 'Checked in',
     'detail.legend.missed': 'Missed',
-    'detail.legend.future': 'Pending today',
+    'detail.legend.future': 'To check in',
     'detail.grid.checked': '{date} checked in',
     'detail.grid.missed': '{date} missed',
     'detail.grid.future': '{date} pending check-in',
@@ -820,8 +827,9 @@ const EN_DICT = {
     'err.missing_field': 'Missing required field: {field}',
     'err.not_found': 'Not found, or already deleted',
     'err.already_checked': 'Already checked in on this date — undo it first to change',
-    'err.not_opportunity_day': 'Not an opportunity day — pick the nearest one in the Calendar tab',
+    'err.not_opportunity_day': 'Not a check-in day — pick the nearest one in the Calendar tab',
     'err.already_claimed': 'Already claimed',
+    'err.claim_expired': 'This task is past its due date — extend the due date first to restart it',
     'err.task_closed': 'Task is closed and cannot be checked in',
     'err.due_past': 'Due date cannot be before today',
     'err.due_too_far': 'Due date cannot be more than 10 years ahead',
@@ -830,7 +838,7 @@ const EN_DICT = {
     'err.bad_date': 'Invalid date (yyyy-MM-dd, not before today)',
     'err.overwrite_required': 'Already exists; confirmation required to overwrite',
     'err.not_claimed': 'Task must be claimed first',
-    'err.no_opportunity_left': 'No check-in day left to tick — all opportunity days are done or past the deadline',
+    'err.no_opportunity_left': 'No check-in day left to tick — all scheduled days are done or past the deadline',
     'err.no_checkins': 'No check-in records for this task',
     'err.title_too_long': 'Title exceeds 50 characters',
     'err.name_too_long': 'Task name exceeds 100 characters',
@@ -905,7 +913,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/categories.js

@@ -7,7 +7,7 @@ import { createElement, useEffect, useRef, useState } from 'react';
 import { getJson, postAction, describeError } from '../api.js';
 import { useXyT } from '../i18n.js';
 import { softConfirm, softConfirmDanger, useActionGuard } from '../hooks.js';
-import { toast } from '../ui.js';
+import { toast, focusPageTitle } from '../ui.js';
 import { categoryVars } from '../../category-color.js';
 import { SwatchRow } from './color-swatch.js';
 import { countKey } from './format.js';
@@ -82,6 +82,29 @@ export function CategoryManager(props) {
     const [renaming, setRenaming] = useState(undefined);
     const [coloring, setColoring] = useState(undefined);
     const { busy, guard } = useActionGuard();
+    // 改名编辑器随关闭（提交/取消/Esc）整体卸载，焦点会落空：记下触发行内「改名」
+    // 按钮，关闭后焦点归还。仅在「打开→关闭」迁移时执行（面板挂载的那次 effect
+    // 不动焦点——否则每次打开面板焦点就被拽到页面标题）；改名成功后行按新名
+    // re-key、旧触发按钮随之销毁，且 effect 执行时 reload 数据未回、旧按钮还在
+    // DOM（归还焦点会在 re-key 中落空到 body）——成功路径显式清空触发引用，令
+    // effect 直接走页面标题兜底
+    const renameTriggerRef = useRef(null);
+    const renameOpenRef = useRef(false);
+    useEffect(() => {
+        if (renaming !== undefined) {
+            renameOpenRef.current = true;
+            return;
+        }
+        if (!renameOpenRef.current)
+            return;
+        renameOpenRef.current = false;
+        const trigger = renameTriggerRef.current;
+        renameTriggerRef.current = null;
+        if (trigger !== null && document.contains(trigger))
+            trigger.focus();
+        else
+            focusPageTitle();
+    }, [renaming]);
     const load = () => {
         setError(undefined);
         getJson('/xingyuan/api/categories')
@@ -94,6 +117,7 @@ export function CategoryManager(props) {
     const commitRename = (oldName, newName) => {
         guard(() => postAction('category-rename', { oldName, newName }).then(() => {
             toast(t('toast.categoryRenamed', { name: newName }), 'ok');
+            renameTriggerRef.current = null;
             setRenaming(undefined);
             reload();
         }));
@@ -114,7 +138,11 @@ export function CategoryManager(props) {
             }, row.name), createElement('span', { className: 'xy-meta xy-catcount' }, t(countKey(row.wishCount, 'catmgr.countOne', 'catmgr.count'), { n: row.wishCount })), createElement('span', { className: 'xy-catops' }, createElement('button', {
                 className: 'xy-btn',
                 disabled: busy,
-                onClick: () => { setRenaming(row.name); setColoring(undefined); },
+                onClick: (e) => {
+                    renameTriggerRef.current = e.currentTarget;
+                    setRenaming(row.name);
+                    setColoring(undefined);
+                },
             }, t('catmgr.rename')), createElement('button', {
                 className: 'xy-btn',
                 disabled: busy,