@starwish-ai/xingyuan-dsh 0.5.8 → 0.6.0

package/CHANGELOG.md

@@ -5,6 +5,84 @@ 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.6.0] - 2026-09-05
+
+> **Note:** behavioral revision — long-term ratios (wish progress, progress charts) join
+> the commitment semantics: unclaimed tasks no longer count in the denominator, and
+> achievement additionally requires zero unclaimed tasks. No data format change; upgrades
+> from 0.5.x are seamless — the switch can only raise progress, and every newly-qualifying
+> wish carries unclaimed candidates that the achievement gate holds back (nothing archives
+> by accident).
+
+### Added
+- **Achievement gate and the "wrapping up" state**: a wish achieves only at 100% progress
+  with no unclaimed tasks (single formula `wishProgressFromAgg` shared by the write path and
+  the read side). Full progress with unclaimed tasks parks the wish at "wrapping up" — the
+  bar is full, the wish is not archived — and the card shows the pending count with the
+  guidance line "claim to continue, or delete to achieve". The call is always the user's:
+  the assistant never claims or deletes on its own to force achievement.
+- **Gate flips always reach the model**: check-in / claim / update / cancel / delete / create
+  (including batches) compare before/after wish views and, on achieve / wrap-up / rollback,
+  say so in the tool reply and re-emit the wish event, so chat card, reply and wishes page
+  stay in sync. Count drift without a flip also re-emits (the "N to claim" badge never
+  freezes).
+- **Single-source display bits**: `pendingCount` / `settled` / `planning` / `achieved` are
+  produced by `freshWishes` and delivered via `/api/wishes` and `xingyuan/wish` events;
+  replays of older events degrade honestly to a plain progress display.
+- **Wording standard**: all user-facing and verbatim-relay surfaces (i18n, tool replies,
+  prompt guides, standalone pages) say "待领取的任务" / "待收尾" — no internal jargon.
+  Locked by a banned-word test (`test/prompts.test.ts`) and a shared guidance-line constant.
+
+### Changed
+- `wishProgress` and `taskCompletionRate` now divide by claimed-task days only; the
+  subtitle is fixed to "已领取任务" (the conditional "含未领取任务" wording is gone —
+  one metric, one meaning).
+- Growth-page achievement counts and the `wishAchievement` chart consume the derived
+  achieved bit instead of `progress >= 100`, matching the wish card exactly.
+- The session-opening overview reads fresh derived views (not the stored `archived` bit)
+  and distinguishes "all wishes achieved" from "no wishes yet".
+
+### Fixed
+- Creating a bare wish showed "进度 0%" on the chat card while the wishes page said
+  "计划中" (the create event dropped the derived bits).
+- Claiming a standalone task (no parent wish) claimed its days were folded into "wish
+  progress".
+- Batch-delete replies glued the achievement guidance onto the summary line; batch paths
+  no longer re-scan the task table per wish on the after side.
+
+## [0.5.9] - 2026-09-04
+
+> **Note:** this release migrates the plugin to DeepSeek Harness `0.1.2-rc.1`
+> (the host is still a technical preview and broke APIs on this bump). No data
+> format changes: existing databases, settings and recorded sessions replay as
+> before. On older hosts (`0.1.1-rc.2`) this version no longer loads — pin
+> `0.5.8` if you must stay on the previous harness.
+
+### Changed
+- **Settings namespaces now install through the service face**
+  (`ctx.inject(['settings'], (inv) => inv.settings.installSection(...))`):
+  `dsh-settings` removed the standalone `installSettingsSection` /
+  `settingsNamespace` helpers, so `xingyuan-pref` and `xingyuan-ui` register
+  via the new API and are no longer imported at runtime. The persistence
+  guarantee is unchanged — namespaces stay on the bundle-resident layer.
+- **Client half re-wired to the reshaped browser packages**:
+  `@deepseek-ai/dsh-client-runtime` is gone; `ClientContext` is now plain
+  Cordis `Context`. The `ChatNodeDataMap` declaration merge moved to
+  `@deepseek-ai/dsh-client-ui-chat/client`, `ConversationStepDataMap` stays in
+  `dsh-client-ui-conversation/client`, event-card definitions register through
+  `ctx.uiConversation.events`, and the slot service is provided by
+  `dsh-client-ui-renderer`. `dsh.client.inject` was rewritten to the new
+  package-row semantics (baseline modules are seeded by the shell and need no
+  declaration).
+- **Session-preset detection for tab visibility** now reads
+  `projectionValues.agentPreset` from the sessions list row — the
+  `SessionSummary.agentPreset` field was removed upstream in
+  `0.1.2-rc.1` (this was silently hiding all Xingyuan view tabs after the
+  host bump; same data source the official preset label uses).
+- **Peer dependency ranges** bumped to `^0.1.2-rc.1` (Cordis `^4.0.2`);
+  AGENTS.md records the migration facts and the new troubleshooting rows
+  (`cannot get property without inject`, missing view tabs).
+
 ## [0.5.8] - 2026-09-04
 
 > **Note:** this release is the fourth six-perspective quality pass. It finishes

package/README.en-US.md

@@ -12,6 +12,7 @@ XingYuan is a wish & habit-building companion, shipped as a DeepSeek Harness plu
 
 - **Conversation-driven**: create wishes / tasks in natural language with duplicate detection
 - **Opportunity-day check-ins**: check-in, make-up, cancel, and future pre-checks; progress always recomputed against today
+- **Commitment-based progress**: only claimed tasks count; a wish achieves when everything committed is done and nothing is left to claim — full progress with unclaimed tasks leaves it "wrapping up" for your call (claim to continue, or delete to achieve), never nagging, never deciding for you
 - **Micro-actions**: break an overwhelming goal into 3–7 tiny steps and walk through them guided
 - **Growth system**: levels Lv.1–Lv.10, streak bonuses, stat cards, 30-day bar chart
 - **Session view tabs**: Today / Wishes / Tasks / Calendar / Growth / Memory — buttons call action endpoints directly; shown only in XingYuan-preset sessions by default, switchable to always show/hide and per-tab in Settings

package/README.md

@@ -12,6 +12,8 @@
 
 - **对话驱动**：自然语言创建愿望 / 任务，自动查重相似项
 - **机会日打卡**：周期任务打卡、补卡、取消、未来预勾，进度跨天恒为最新
+- **承诺口径进度**：只有领取的任务算进度；达成 = 承诺全部完成且没有待领取的任务——
+  做完但有没领的，愿望停在「待收尾」等你决定（领了继续，或删掉就达成），不催也不代劳
 - **微行动拆解**：把无从下手的目标拆成 3–7 个小步，引导式逐个完成或跳过
 - **成长体系**：等级 Lv.1–Lv.10、连续加成、统计卡与近 30 天柱状图
 - **会话视图页**：今日 / 愿望 / 任务 / 日历 / 成长 / 记忆 六个标签页，页面按钮直连动作接口；

package/lib/client/cards.js

@@ -22,9 +22,11 @@ function WishView(props) {
         style: categoryVars(wish.wish.colorKey, wish.wish.categoryName),
     }, t('badge.wish')), createElement('span', { className: 'xy-title' }, deleted ? t('state.deleted', { title: wish.wish.title }) : wish.wish.title)), 
     // 已删除卡不再渲染活体进度（删除态 × 进度百分比自相矛盾）
+    // 三态位（achieved/planning/settled/pendingCount）来自事件载荷（wishProgressFromAgg 派生），
+    // 与愿望页/工具回包同一称呼；旧事件无这些位则如实降级为纯「进度 X%」显示（不重建谓词，§5.2 规则 7）
     createElement('div', { className: 'xy-meta' }, deleted
         ? wish.wish.categoryName
-        : `${wish.wish.categoryName} · ${t('wish.progress', { percent: wish.wish.progress })}`));
+        : `${wish.wish.categoryName} · ${wish.wish.achieved ? t('wish.achieved') : wish.wish.planning ? t('wish.planning') : t('wish.progress', { percent: wish.wish.progress })}${wish.wish.pendingCount ? ` · ${t('wish.pendingCount', { n: wish.wish.pendingCount })}` : ''}${wish.wish.settled ? ` · ${t('wish.settled')}` : ''}`));
 }
 function TaskView(props) {
     const t = useXyT();

package/lib/client/chart-labels.js

@@ -81,12 +81,11 @@ export const CHART_SUBTITLE_KEYS = {
     '按任务 TopN': 'chart.subtitle.byTaskTopN',
     '按愿望 TopN': 'chart.subtitle.byWishTopN',
     '按实际打卡时刻分桶；过滤范围为打卡日区间': 'chart.subtitle.byHourBucket',
-    '%（应打天数完成率）': 'chart.subtitle.progressPercent',
-    '%（应打天数完成率，含未领取任务）': 'chart.subtitle.progressPercentPending',
+    '%（已领取任务完成率）': 'chart.subtitle.claimedPercent',
 };
 /**
  * 副标题本地化：固定短语查表；含数字的模板（近 N 天 / A/B 天 / 当前 A 天 / 最长 B 天 /
- * 含未领取任务）按正则重排——服务端模板变化时未知副标题原样回显（诚实降级）。
+ * 已领取任务口径）按正则重排——服务端模板变化时未知副标题原样回显（诚实降级）。
  */
 export function localizeChartSubtitle(subtitle) {
     const fixed = CHART_SUBTITLE_KEYS[subtitle];
@@ -95,9 +94,9 @@ export function localizeChartSubtitle(subtitle) {
     let m = /^近 (\d+) 天$/.exec(subtitle);
     if (m !== null)
         return t('chart.subtitle.lastDays', { n: m[1] });
-    m = /^(\d+)\/(\d+) 天（含未领取任务）$/.exec(subtitle);
+    m = /^(\d+)\/(\d+) 天（已领取任务）$/.exec(subtitle);
     if (m !== null)
-        return t('chart.subtitle.daysInclPending', { done: m[1], due: m[2] });
+        return t('chart.subtitle.daysClaimed', { 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] });

package/lib/client/i18n.js

@@ -58,11 +58,18 @@ export const ZH_DICT = {
     'state.done': '已完成',
     // --- 愿望卡 / 愿望页 ---
     'wish.progress': '进度 {percent}%',
-    'wish.progressHasPending': '含未领取任务',
+    'wish.planning': '计划中',
+    'wish.achieved': '已达成 🎉',
+    'wish.pendingCount': '{n} 个任务待领取',
+    'wish.settled': '待收尾',
+    'wish.settleHint': '答应自己的都做完了——待领取的领了继续，或删掉就达成',
     'wish.eta': '预计完成 {date}',
     'wish.noTasks': '暂无下属任务——在对话里告诉我，让我为它推荐打卡任务',
     'wish.pageTitle': '我的愿望',
-    'wish.summary': '{active} 个进行中{achieved}', 'wish.achievedSuffix': ' · {n} 个已达成',
+    'wish.summary': '{active} 个进行中{planning}{settled}{achieved}',
+    'wish.planningSuffix': ' · {n} 个计划中',
+    'wish.settledSuffix': ' · {n} 个待收尾',
+    'wish.achievedSuffix': ' · {n} 个已达成',
     'wish.sectionAchieved': '已达成',
     'wish.empty.title': '还没有愿望',
     'wish.empty.hint': '告诉我想实现什么，我来帮你拆解成可坚持的计划。',
@@ -343,10 +350,9 @@ export const ZH_DICT = {
     'chart.subtitle.byTaskTopN': '按任务 TopN',
     'chart.subtitle.byWishTopN': '按愿望 TopN',
     'chart.subtitle.byHourBucket': '按实际打卡时刻分桶；过滤范围为打卡日区间',
-    'chart.subtitle.progressPercent': '%（应打天数完成率）',
-    'chart.subtitle.progressPercentPending': '%（应打天数完成率，含未领取任务）',
+    'chart.subtitle.claimedPercent': '%（已领取任务完成率）',
     'chart.subtitle.lastDays': '近 {n} 天',
-    'chart.subtitle.daysInclPending': '{done}/{due} 天（含未领取任务）',
+    'chart.subtitle.daysClaimed': '{done}/{due} 天（已领取任务）',
     'chart.subtitle.daysRatio': '{done}/{due} 天',
     'chart.subtitle.streak': '当前 {current} 天 / 最长 {best} 天',
     // --- 详情聚合视图 ---
@@ -480,11 +486,17 @@ const EN_DICT = {
     'state.deleted': 'Deleted “{title}”',
     'state.done': 'Done',
     'wish.progress': 'Progress {percent}%',
-    'wish.progressHasPending': 'includes unclaimed tasks',
+    'wish.planning': 'Planning',
+    'wish.achieved': 'Achieved 🎉',
+    'wish.pendingCount': '{n} to claim',
+    'wish.settled': 'Wrapping up',
+    'wish.settleHint': 'Everything you committed to is done — claim the rest to keep going, or delete them to achieve the wish',
     'wish.eta': 'Target date {date}',
     '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.summary': '{active} in progress{planning}{settled}{achieved}',
+    'wish.planningSuffix': ' · {n} planning',
+    'wish.settledSuffix': ' · {n} wrapping up',
     'wish.achievedSuffix': ' · {n} achieved',
     'wish.sectionAchieved': 'Achieved',
     'wish.empty.title': 'No wishes yet',
@@ -751,10 +763,9 @@ const EN_DICT = {
     'chart.subtitle.byTaskTopN': 'By task (top N)',
     'chart.subtitle.byWishTopN': 'By wish (top N)',
     'chart.subtitle.byHourBucket': 'Bucketed by actual check-in time; filtered to the check-in date range',
-    'chart.subtitle.progressPercent': '% of scheduled-day completion',
-    'chart.subtitle.progressPercentPending': '% of scheduled-day completion (incl. unclaimed)',
+    'chart.subtitle.claimedPercent': '% of committed-task completion',
     'chart.subtitle.lastDays': 'Last {n} days',
-    'chart.subtitle.daysInclPending': '{done}/{due} days (incl. unclaimed)',
+    'chart.subtitle.daysClaimed': '{done}/{due} days (claimed tasks)',
     'chart.subtitle.daysRatio': '{done}/{due} days',
     'chart.subtitle.streak': 'Current {current}d / best {best}d',
     'detail.grid.title': 'Check-in record',

package/lib/client/index.js

@@ -4,7 +4,7 @@ import { STYLE_TEXT } from './styles.js';
 import { CARD_VIEWS } from './cards.js';
 import { installTabVisibility } from './tab-visibility.js';
 import { SettingsSection } from './pages/settings.js';
-export const inject = ['slots', 'settingsScope', 'conversationEvents'];
+export const inject = ['slots', 'settingsScope', 'uiConversation'];
 /** 事件类型 → 渲染 kind。 */
 const KIND_BY_EVENT = {
     'xingyuan/wish': 'xy-wish',
@@ -59,11 +59,12 @@ export function apply(ctx) {
         disposeToasts();
         disposeConfirms();
     });
-    ctx.conversationEvents.register(definition('xy-wish'));
-    ctx.conversationEvents.register(definition('xy-task'));
-    ctx.conversationEvents.register(definition('xy-checkin'));
-    ctx.conversationEvents.register(definition('xy-chart'));
-    ctx.conversationEvents.register(definition('xy-micro'));
+    // dsh 0.1.2：事件 Definition 注册收进 uiConversation 服务的 events 子注册表。
+    ctx.uiConversation.events.register(definition('xy-wish'));
+    ctx.uiConversation.events.register(definition('xy-task'));
+    ctx.uiConversation.events.register(definition('xy-checkin'));
+    ctx.uiConversation.events.register(definition('xy-chart'));
+    ctx.uiConversation.events.register(definition('xy-micro'));
     // 卡片注册不声明 locale：t 席位由组件内 useXyT() 取代（键受查 + 订阅刷新），
     // 避免 'conversation' 窄域 t 与本插件命名空间的类型冲突。
     ctx.slots.inject('conversation.chat.node', () => [

package/lib/client/pages/wishes.js

@@ -39,8 +39,12 @@ export function WishesPage() {
     const data = page.data;
     if (data === undefined)
         return createElement(PageSkeleton);
-    const active = data.wishes.filter((w) => !w.archived);
+    // 页头四态计数：进行中/计划中/待收尾/已达成各计各的，与卡头徽章同一称呼
+    // （消灭「摘要算进行中、卡上写计划中」的并见歧义）；全部取服务端派生位，展示层不重建谓词
     const achieved = data.wishes.filter((w) => w.archived);
+    const settledCount = data.wishes.filter((w) => w.settled).length;
+    const planningCount = data.wishes.filter((w) => !w.archived && w.planning).length;
+    const active = data.wishes.filter((w) => !w.archived);
     /** 删除愿望（级联下属任务与打卡记录，服务端同一写路径）：确认后直连动作并整页刷新。
      * 行移除后触发按钮销毁、焦点落空——刷新完成后把焦点交给页面标题兜底。 */
     const removeWish = (wish) => {
@@ -70,37 +74,45 @@ export function WishesPage() {
             ? [line, createElement(TaskDetailPanel, { key: `d-${task.taskId}`, id: `xy-task-detail-${task.taskId}`, taskId: task.taskId, today: data.today, onChanged: page.reload })]
             : [line];
     });
-    const card = (wish) => createElement('div', { key: wish.wishId, className: 'xy-wishcard' }, createElement('div', { className: 'xy-card-head' }, createElement('span', {
-        className: 'xy-badge xy-badge-cat',
-        style: categoryVars(wish.colorKey, wish.categoryName),
-    }, wish.categoryName), createElement('span', { className: 'xy-title' }, wish.title), 
-    // 长期尺度 = 计划口径（分母含未领取任务的应打天数，§5.2 规则 7）：愿望含未领取
-    // 任务时必须呈现「含未领取任务」标注，避免把计划分母误读为承诺分母
-    createElement('span', { className: 'xy-progress-num' }, t('wish.progress', { percent: wish.progress }), wish.tasks.some((task) => task.status === 'pending')
-        ? createElement('span', { className: 'xy-meta' }, ` · ${t('wish.progressHasPending')}`)
-        : null), createElement('button', {
-        className: 'xy-btn xy-btn-danger xy-btn-icon',
-        disabled: deleting,
-        'aria-label': t('common.delete') + ' · ' + wish.title,
-        title: t('common.delete'),
-        onClick: () => removeWish(wish),
-    }, createElement(IconTrash))), wish.description !== undefined ? createElement('div', { className: 'xy-meta' }, wish.description) : null, wish.estimatedCompletionDate !== undefined
-        ? createElement('div', { className: 'xy-meta' }, t('wish.eta', { date: formatMediumDate(wish.estimatedCompletionDate) }))
-        : null, 
-    // 与今日页 hero 进度条同一语义语法：读屏可感知进度（role+valuenow），不只是一根哑条
-    createElement('div', {
-        className: 'xy-bar',
-        role: 'progressbar',
-        'aria-valuemin': 0,
-        'aria-valuemax': 100,
-        'aria-valuenow': wish.progress,
-        'aria-label': t('wish.progress', { percent: wish.progress })
-            + (wish.tasks.some((task) => task.status === 'pending') ? ` · ${t('wish.progressHasPending')}` : ''),
-    }, createElement('div', { className: 'xy-bar-fill', style: { transform: `scaleX(${Math.min(wish.progress, 100) / 100})` } })), wish.tasks.length > 0
-        ? createElement('div', { className: 'xy-wishtasks' }, ...wishTasks(wish))
-        : createElement('div', { className: 'xy-meta' }, t('wish.noTasks')));
+    const card = (wish) => {
+        // 承诺口径（§5.2 规则 7）：进度分母只计已领取任务。展示三态：
+        // 计划中（无已领取任务）/ 进行中（正常百分比）/ 待结算（满进度而有候选——不归档，附收尾指引）。
+        // settled/pendingCount/planning 直取服务端 wishProgressFromAgg 派生位（随 /api/wishes 下发），
+        // 展示层禁止重建 `progress>=100 && 有候选` 闸门或 planning 谓词（单一判定源，防与工具回包分叉）
+        const { pendingCount, settled, planning } = wish;
+        const progressLabel = planning ? t('wish.planning') : t('wish.progress', { percent: wish.progress });
+        const pendingMeta = pendingCount > 0 ? ` · ${t('wish.pendingCount', { n: pendingCount })}` : '';
+        return createElement('div', { key: wish.wishId, className: 'xy-wishcard' }, createElement('div', { className: 'xy-card-head' }, createElement('span', {
+            className: 'xy-badge xy-badge-cat',
+            style: categoryVars(wish.colorKey, wish.categoryName),
+        }, wish.categoryName), createElement('span', { className: 'xy-title' }, wish.title), createElement('span', { className: 'xy-progress-num' }, progressLabel, pendingCount > 0
+            ? createElement('span', { className: 'xy-meta' }, pendingMeta)
+            : null), createElement('button', {
+            className: 'xy-btn xy-btn-danger xy-btn-icon',
+            disabled: deleting,
+            'aria-label': t('common.delete') + ' · ' + wish.title,
+            title: t('common.delete'),
+            onClick: () => removeWish(wish),
+        }, createElement(IconTrash))), wish.description !== undefined ? createElement('div', { className: 'xy-meta' }, wish.description) : null, wish.estimatedCompletionDate !== undefined
+            ? createElement('div', { className: 'xy-meta' }, t('wish.eta', { date: formatMediumDate(wish.estimatedCompletionDate) }))
+            : null, 
+        // 与今日页 hero 进度条同一语义语法：读屏可感知进度（role+valuenow），不只是一根哑条
+        createElement('div', {
+            className: 'xy-bar',
+            role: 'progressbar',
+            'aria-valuemin': 0,
+            'aria-valuemax': 100,
+            'aria-valuenow': wish.progress,
+            'aria-label': progressLabel + pendingMeta,
+        }, createElement('div', { className: 'xy-bar-fill', style: { transform: `scaleX(${Math.min(wish.progress, 100) / 100})` } })), settled ? createElement('div', { className: 'xy-meta' }, t('wish.settleHint')) : null, wish.tasks.length > 0
+            ? createElement('div', { className: 'xy-wishtasks' }, ...wishTasks(wish))
+            : createElement('div', { className: 'xy-meta' }, t('wish.noTasks')));
+    };
     return createElement('div', { className: 'xy-page', ref: stabilize }, page.error !== undefined ? createElement(StaleBanner, { onRetry: () => void page.reload() }) : null, showNoPresetHint ? createElement('p', { className: 'xy-hint' }, t('today.noPresetHint')) : null, createElement('div', { className: 'xy-page-head' }, createElement('h2', { className: 'xy-page-title' }, t('wish.pageTitle')), createElement('span', { className: 'xy-meta' }, t('wish.summary', {
-        active: active.length,
+        // 四态计数各计各的（进行中扣除计划中与待收尾，不相套）；列表渲染仍归未完成组（未完成≠进行中计数）
+        active: active.length - settledCount - planningCount,
+        planning: planningCount > 0 ? t('wish.planningSuffix', { n: planningCount }) : '',
+        settled: settledCount > 0 ? t('wish.settledSuffix', { n: settledCount }) : '',
         achieved: achieved.length > 0 ? t('wish.achievedSuffix', { n: achieved.length }) : '',
     })), 
     // 动作组整体右置（单一 margin-left:auto），避免多按钮各自 auto margin 平分剩余空间

package/lib/client/tab-visibility.js

@@ -33,7 +33,7 @@ export function installTabVisibility(ctx) {
         const hidden = value?.hiddenTabs ?? TAB_VISIBILITY_DEFAULTS.hiddenTabs;
         const list = sessions?.list?.getSnapshot();
         const row = list?.current !== undefined ? list.byId[list.current] : undefined;
-        const isXingyuan = row?.agentPreset === 'xingyuan';
+        const isXingyuan = row?.projectionValues?.agentPreset === 'xingyuan';
         // 「始终显示 × 非星愿会话」的今日页轻提示（Q4=b 结论），其余模式不提示
         setTodayHint(mode === 'show' && !isXingyuan);
         const visible = new Set(visibleTabIds(mode, hidden, isXingyuan));

package/lib/client.js

@@ -61,11 +61,17 @@ const ZH_DICT = {
 	"state.deleted": "已删除「{title}」",
 	"state.done": "已完成",
 	"wish.progress": "进度 {percent}%",
-	"wish.progressHasPending": "含未领取任务",
+	"wish.planning": "计划中",
+	"wish.achieved": "已达成 🎉",
+	"wish.pendingCount": "{n} 个任务待领取",
+	"wish.settled": "待收尾",
+	"wish.settleHint": "答应自己的都做完了——待领取的领了继续，或删掉就达成",
 	"wish.eta": "预计完成 {date}",
 	"wish.noTasks": "暂无下属任务——在对话里告诉我，让我为它推荐打卡任务",
 	"wish.pageTitle": "我的愿望",
-	"wish.summary": "{active} 个进行中{achieved}",
+	"wish.summary": "{active} 个进行中{planning}{settled}{achieved}",
+	"wish.planningSuffix": " · {n} 个计划中",
+	"wish.settledSuffix": " · {n} 个待收尾",
 	"wish.achievedSuffix": " · {n} 个已达成",
 	"wish.sectionAchieved": "已达成",
 	"wish.empty.title": "还没有愿望",
@@ -332,10 +338,9 @@ const ZH_DICT = {
 	"chart.subtitle.byTaskTopN": "按任务 TopN",
 	"chart.subtitle.byWishTopN": "按愿望 TopN",
 	"chart.subtitle.byHourBucket": "按实际打卡时刻分桶；过滤范围为打卡日区间",
-	"chart.subtitle.progressPercent": "%（应打天数完成率）",
-	"chart.subtitle.progressPercentPending": "%（应打天数完成率，含未领取任务）",
+	"chart.subtitle.claimedPercent": "%（已领取任务完成率）",
 	"chart.subtitle.lastDays": "近 {n} 天",
-	"chart.subtitle.daysInclPending": "{done}/{due} 天（含未领取任务）",
+	"chart.subtitle.daysClaimed": "{done}/{due} 天（已领取任务）",
 	"chart.subtitle.daysRatio": "{done}/{due} 天",
 	"chart.subtitle.streak": "当前 {current} 天 / 最长 {best} 天",
 	"detail.grid.title": "打卡记录",
@@ -462,11 +467,17 @@ const EN_DICT = {
 	"state.deleted": "Deleted “{title}”",
 	"state.done": "Done",
 	"wish.progress": "Progress {percent}%",
-	"wish.progressHasPending": "includes unclaimed tasks",
+	"wish.planning": "Planning",
+	"wish.achieved": "Achieved 🎉",
+	"wish.pendingCount": "{n} to claim",
+	"wish.settled": "Wrapping up",
+	"wish.settleHint": "Everything you committed to is done — claim the rest to keep going, or delete them to achieve the wish",
 	"wish.eta": "Target date {date}",
 	"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.summary": "{active} in progress{planning}{settled}{achieved}",
+	"wish.planningSuffix": " · {n} planning",
+	"wish.settledSuffix": " · {n} wrapping up",
 	"wish.achievedSuffix": " · {n} achieved",
 	"wish.sectionAchieved": "Achieved",
 	"wish.empty.title": "No wishes yet",
@@ -733,10 +744,9 @@ const EN_DICT = {
 	"chart.subtitle.byTaskTopN": "By task (top N)",
 	"chart.subtitle.byWishTopN": "By wish (top N)",
 	"chart.subtitle.byHourBucket": "Bucketed by actual check-in time; filtered to the check-in date range",
-	"chart.subtitle.progressPercent": "% of scheduled-day completion",
-	"chart.subtitle.progressPercentPending": "% of scheduled-day completion (incl. unclaimed)",
+	"chart.subtitle.claimedPercent": "% of committed-task completion",
 	"chart.subtitle.lastDays": "Last {n} days",
-	"chart.subtitle.daysInclPending": "{done}/{due} days (incl. unclaimed)",
+	"chart.subtitle.daysClaimed": "{done}/{due} days (claimed tasks)",
 	"chart.subtitle.daysRatio": "{done}/{due} days",
 	"chart.subtitle.streak": "Current {current}d / best {best}d",
 	"detail.grid.title": "Check-in record",
@@ -2107,20 +2117,19 @@ const CHART_SUBTITLE_KEYS = {
 	"按任务 TopN": "chart.subtitle.byTaskTopN",
 	"按愿望 TopN": "chart.subtitle.byWishTopN",
 	"按实际打卡时刻分桶；过滤范围为打卡日区间": "chart.subtitle.byHourBucket",
-	"%（应打天数完成率）": "chart.subtitle.progressPercent",
-	"%（应打天数完成率，含未领取任务）": "chart.subtitle.progressPercentPending"
+	"%（已领取任务完成率）": "chart.subtitle.claimedPercent"
 };
 /**
 * 副标题本地化：固定短语查表；含数字的模板（近 N 天 / A/B 天 / 当前 A 天 / 最长 B 天 /
-* 含未领取任务）按正则重排——服务端模板变化时未知副标题原样回显（诚实降级）。
+* 已领取任务口径）按正则重排——服务端模板变化时未知副标题原样回显（诚实降级）。
 */
 function localizeChartSubtitle(subtitle) {
 	const fixed = CHART_SUBTITLE_KEYS[subtitle];
 	if (fixed !== void 0) 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", {
+	m = /^(\d+)\/(\d+) 天（已领取任务）$/.exec(subtitle);
+	if (m !== null) return t("chart.subtitle.daysClaimed", {
 		done: m[1],
 		due: m[2]
 	});
@@ -2392,7 +2401,7 @@ function WishView(props) {
 	return (0, react.createElement)("div", { className: `xy-card ${deleted ? "xy-deleted" : ""}` }, (0, react.createElement)("div", { className: "xy-card-head" }, (0, react.createElement)("span", {
 		className: "xy-badge xy-badge-cat",
 		style: categoryVars(wish.wish.colorKey, wish.wish.categoryName)
-	}, t("badge.wish")), (0, react.createElement)("span", { className: "xy-title" }, deleted ? t("state.deleted", { title: wish.wish.title }) : wish.wish.title)), (0, react.createElement)("div", { className: "xy-meta" }, deleted ? wish.wish.categoryName : `${wish.wish.categoryName} · ${t("wish.progress", { percent: wish.wish.progress })}`));
+	}, t("badge.wish")), (0, react.createElement)("span", { className: "xy-title" }, deleted ? t("state.deleted", { title: wish.wish.title }) : wish.wish.title)), (0, react.createElement)("div", { className: "xy-meta" }, deleted ? wish.wish.categoryName : `${wish.wish.categoryName} · ${wish.wish.achieved ? t("wish.achieved") : wish.wish.planning ? t("wish.planning") : t("wish.progress", { percent: wish.wish.progress })}${wish.wish.pendingCount ? ` · ${t("wish.pendingCount", { n: wish.wish.pendingCount })}` : ""}${wish.wish.settled ? ` · ${t("wish.settled")}` : ""}`));
 }
 function TaskView(props) {
 	const t = useXyT();
@@ -3660,8 +3669,10 @@ function WishesPage() {
 	});
 	const data = page.data;
 	if (data === void 0) return (0, react.createElement)(PageSkeleton);
-	const active = data.wishes.filter((w) => !w.archived);
 	const achieved = data.wishes.filter((w) => w.archived);
+	const settledCount = data.wishes.filter((w) => w.settled).length;
+	const planningCount = data.wishes.filter((w) => !w.archived && w.planning).length;
+	const active = data.wishes.filter((w) => !w.archived);
 	/** 删除愿望（级联下属任务与打卡记录，服务端同一写路径）：确认后直连动作并整页刷新。
 	* 行移除后触发按钮销毁、焦点落空——刷新完成后把焦点交给页面标题兜底。 */
 	const removeWish = (wish) => {
@@ -3696,34 +3707,41 @@ function WishesPage() {
 			onChanged: page.reload
 		})] : [line];
 	});
-	const card = (wish) => (0, react.createElement)("div", {
-		key: wish.wishId,
-		className: "xy-wishcard"
-	}, (0, react.createElement)("div", { className: "xy-card-head" }, (0, react.createElement)("span", {
-		className: "xy-badge xy-badge-cat",
-		style: categoryVars(wish.colorKey, wish.categoryName)
-	}, wish.categoryName), (0, react.createElement)("span", { className: "xy-title" }, wish.title), (0, react.createElement)("span", { className: "xy-progress-num" }, t("wish.progress", { percent: wish.progress }), wish.tasks.some((task) => task.status === "pending") ? (0, react.createElement)("span", { className: "xy-meta" }, ` · ${t("wish.progressHasPending")}`) : null), (0, react.createElement)("button", {
-		className: "xy-btn xy-btn-danger xy-btn-icon",
-		disabled: deleting,
-		"aria-label": t("common.delete") + " · " + wish.title,
-		title: t("common.delete"),
-		onClick: () => removeWish(wish)
-	}, (0, react.createElement)(IconTrash))), wish.description !== void 0 ? (0, react.createElement)("div", { className: "xy-meta" }, wish.description) : null, wish.estimatedCompletionDate !== void 0 ? (0, react.createElement)("div", { className: "xy-meta" }, t("wish.eta", { date: formatMediumDate(wish.estimatedCompletionDate) })) : null, (0, react.createElement)("div", {
-		className: "xy-bar",
-		role: "progressbar",
-		"aria-valuemin": 0,
-		"aria-valuemax": 100,
-		"aria-valuenow": wish.progress,
-		"aria-label": t("wish.progress", { percent: wish.progress }) + (wish.tasks.some((task) => task.status === "pending") ? ` · ${t("wish.progressHasPending")}` : "")
-	}, (0, react.createElement)("div", {
-		className: "xy-bar-fill",
-		style: { transform: `scaleX(${Math.min(wish.progress, 100) / 100})` }
-	})), wish.tasks.length > 0 ? (0, react.createElement)("div", { className: "xy-wishtasks" }, ...wishTasks(wish)) : (0, react.createElement)("div", { className: "xy-meta" }, t("wish.noTasks")));
+	const card = (wish) => {
+		const { pendingCount, settled, planning } = wish;
+		const progressLabel = planning ? t("wish.planning") : t("wish.progress", { percent: wish.progress });
+		const pendingMeta = pendingCount > 0 ? ` · ${t("wish.pendingCount", { n: pendingCount })}` : "";
+		return (0, react.createElement)("div", {
+			key: wish.wishId,
+			className: "xy-wishcard"
+		}, (0, react.createElement)("div", { className: "xy-card-head" }, (0, react.createElement)("span", {
+			className: "xy-badge xy-badge-cat",
+			style: categoryVars(wish.colorKey, wish.categoryName)
+		}, wish.categoryName), (0, react.createElement)("span", { className: "xy-title" }, wish.title), (0, react.createElement)("span", { className: "xy-progress-num" }, progressLabel, pendingCount > 0 ? (0, react.createElement)("span", { className: "xy-meta" }, pendingMeta) : null), (0, react.createElement)("button", {
+			className: "xy-btn xy-btn-danger xy-btn-icon",
+			disabled: deleting,
+			"aria-label": t("common.delete") + " · " + wish.title,
+			title: t("common.delete"),
+			onClick: () => removeWish(wish)
+		}, (0, react.createElement)(IconTrash))), wish.description !== void 0 ? (0, react.createElement)("div", { className: "xy-meta" }, wish.description) : null, wish.estimatedCompletionDate !== void 0 ? (0, react.createElement)("div", { className: "xy-meta" }, t("wish.eta", { date: formatMediumDate(wish.estimatedCompletionDate) })) : null, (0, react.createElement)("div", {
+			className: "xy-bar",
+			role: "progressbar",
+			"aria-valuemin": 0,
+			"aria-valuemax": 100,
+			"aria-valuenow": wish.progress,
+			"aria-label": progressLabel + pendingMeta
+		}, (0, react.createElement)("div", {
+			className: "xy-bar-fill",
+			style: { transform: `scaleX(${Math.min(wish.progress, 100) / 100})` }
+		})), settled ? (0, react.createElement)("div", { className: "xy-meta" }, t("wish.settleHint")) : null, wish.tasks.length > 0 ? (0, react.createElement)("div", { className: "xy-wishtasks" }, ...wishTasks(wish)) : (0, react.createElement)("div", { className: "xy-meta" }, t("wish.noTasks")));
+	};
 	return (0, react.createElement)("div", {
 		className: "xy-page",
 		ref: stabilize
 	}, page.error !== void 0 ? (0, react.createElement)(StaleBanner, { onRetry: () => void page.reload() }) : null, showNoPresetHint ? (0, react.createElement)("p", { className: "xy-hint" }, t("today.noPresetHint")) : null, (0, react.createElement)("div", { className: "xy-page-head" }, (0, react.createElement)("h2", { className: "xy-page-title" }, t("wish.pageTitle")), (0, react.createElement)("span", { className: "xy-meta" }, t("wish.summary", {
-		active: active.length,
+		active: active.length - settledCount - planningCount,
+		planning: planningCount > 0 ? t("wish.planningSuffix", { n: planningCount }) : "",
+		settled: settledCount > 0 ? t("wish.settledSuffix", { n: settledCount }) : "",
 		achieved: achieved.length > 0 ? t("wish.achievedSuffix", { n: achieved.length }) : ""
 	})), (0, react.createElement)("div", { className: "xy-page-actions" }, (0, react.createElement)("button", {
 		className: "xy-btn",
@@ -4732,7 +4750,7 @@ function installTabVisibility(ctx) {
 		const mode = value?.tabVisibilityMode ?? TAB_VISIBILITY_DEFAULTS.tabVisibilityMode;
 		const hidden = value?.hiddenTabs ?? TAB_VISIBILITY_DEFAULTS.hiddenTabs;
 		const list = sessions?.list?.getSnapshot();
-		const isXingyuan = (list?.current !== void 0 ? list.byId[list.current] : void 0)?.agentPreset === "xingyuan";
+		const isXingyuan = (list?.current !== void 0 ? list.byId[list.current] : void 0)?.projectionValues?.agentPreset === "xingyuan";
 		setTodayHint(mode === "show" && !isXingyuan);
 		const visible = new Set(visibleTabIds(mode, hidden, isXingyuan));
 		for (const entry of TAB_ENTRIES) {
@@ -5151,7 +5169,7 @@ function SettingsSection(props) {
 const inject = [
 	"slots",
 	"settingsScope",
-	"conversationEvents"
+	"uiConversation"
 ];
 /** 事件类型 → 渲染 kind。 */
 const KIND_BY_EVENT = {
@@ -5205,11 +5223,11 @@ function apply(ctx) {
 		disposeToasts();
 		disposeConfirms();
 	});
-	ctx.conversationEvents.register(definition("xy-wish"));
-	ctx.conversationEvents.register(definition("xy-task"));
-	ctx.conversationEvents.register(definition("xy-checkin"));
-	ctx.conversationEvents.register(definition("xy-chart"));
-	ctx.conversationEvents.register(definition("xy-micro"));
+	ctx.uiConversation.events.register(definition("xy-wish"));
+	ctx.uiConversation.events.register(definition("xy-task"));
+	ctx.uiConversation.events.register(definition("xy-checkin"));
+	ctx.uiConversation.events.register(definition("xy-chart"));
+	ctx.uiConversation.events.register(definition("xy-micro"));
 	ctx.slots.inject("conversation.chat.node", () => [
 		ctx.slots.register({
 			name: "conversation.chat.node",

package/lib/growth.js

@@ -117,7 +117,9 @@ export function resolveLevel(totalExperience) {
 export function growthSummary(store, today = todayIso()) {
     // 单遍任务索引批量新鲜化（freshWishes），替代逐愿望嵌套全表扫描 O(W×T)
     const wishes = freshWishes(store);
-    const completedWishes = wishes.filter((wish) => wish.progress >= 100).length;
+    // 达成口径与愿望卡一致（freshWishes 派生的 archived 谓词）：承诺全部完成且无未处理候选——
+    // 禁止在此重复写 progress >= 100 谓词（候选拦达成会漏掉，见 §5.2 规则 7）
+    const completedWishes = wishes.filter((wish) => wish.archived).length;
     let totalTasks = 0;
     let completedTasks = 0;
     for (const [, task] of store.domain.table('tasks').entries()) {

package/lib/pref-settings.js

@@ -1,8 +1,7 @@
 import z from '@deepseek-ai/schemastery';
-import { installSettingsSection, settingsNamespace } from '@deepseek-ai/dsh-settings';
 import { CONFIRM_LANGS, MEMORY_LIMIT_MAX, MEMORY_LIMIT_MIN, PREF_DEFAULTS, } from './pref-policy.js';
-/** 对话偏好命名空间（client 半侧 settingsScope 同名配对，勿改）。 */
-export const PREF_NS = settingsNamespace('xingyuan-pref');
+/** 对话偏好命名空间（client 半侧 settingsScope 同名配对，勿改；小写连字符文法由新 API 类型校验）。 */
+export const PREF_NS = 'xingyuan-pref';
 /** 配置 schema（默认值写进 schema；step(1) 让服务端也拒绝小数，防手改文档/RPC 直写）。 */
 export const PrefSettingsSchema = z.object({
     confirmWrites: z.boolean().default(PREF_DEFAULTS.confirmWrites),
@@ -20,10 +19,15 @@ export const PrefSettingsSchema = z.object({
 export function installPrefSettings(ctx) {
     // 闭包局部，非模块级单例（AGENTS.md §8：不做任何跨重载的模块级单例状态）
     let read = () => PREF_DEFAULTS;
-    installSettingsSection(ctx, PREF_NS, PrefSettingsSchema, PREF_DEFAULTS, {
-        setSource: (current) => { read = current; },
-        // 消费方（工具/提示词）每次执行即时读 thunk，无需在此重建任何东西
-        onChange: () => { },
+    // 回调形参 inv 才是声明了 settings 依赖的上下文：cordis 4.0.2 起，
+    // 未在当前 fiber 声明的服务属性不得访问（外层 ctx 直接读 ctx.settings 会
+    // 抛 "cannot get property without inject"），注册归属（owner）仍传插件 fiber。
+    ctx.inject(['settings'], (inv) => {
+        inv.settings.installSection(ctx, PREF_NS, PrefSettingsSchema, PREF_DEFAULTS, {
+            setSource: (current) => { read = current; },
+            // 消费方（工具/提示词）每次执行即时读 thunk，无需在此重建任何东西
+            onChange: () => { },
+        });
     });
     return () => read();
 }