dsh-compact-relay 0.5.1 → 0.5.3

package/lib/client.js

@@ -1129,6 +1129,11 @@ window.__ModuleLoader__.load({
       const previewRef = useRef(null);
       const previewAbortRef = useRef(null);
       const runAbortRef = useRef(null);
+      // 0.6 预览卡收藏区：只在「这张卡里点成功的收藏」记局部状态（seq → 行数据），
+      // 不引入全局星标快照、不改服务端预览数据；失败提示也留在卡内。
+      const [favoriteMarks, setFavoriteMarks] = useState({});
+      const [favoritePendingSeq, setFavoritePendingSeq] = useState(null);
+      const [favoriteError, setFavoriteError] = useState(null);
       // M6：交接单列表（菜单入口，只读）。
       const [docs, setDocs] = useState(null);
       const docsRef = useRef(null);
@@ -1752,7 +1757,7 @@ window.__ModuleLoader__.load({
           nativeRatio === null
             ? 'DSH 原生自动压缩已关闭'
             : `DSH 原生自动压缩线在 ${(nativeRatio * 100).toFixed(1)}%，到那之前先压缩或交接更稳`;
-        return `这是上下文指示灯：点它压缩旧会话、锁定重要消息、交接新会话。${nativePart}。环上的小缺口是我判断「该压缩」的位置（模型判断或到线自动出现）。重要的结论/路径先锁定，压缩时才不会被压掉（原生压缩不认锁定，真被压走会标「已失效」）。交接后会默认自动归档旧会话（侧栏收起，可取消勾选「交接后归档」；旧会话在侧栏置顶时会先问你，因为归档会取消置顶）。`;
+        return `这是上下文指示灯：点它压缩旧会话、收藏重要回复、交接新会话。${nativePart}。环上的小缺口是我判断「该压缩」的位置（模型判断或到线自动出现）。重要的结论/路径先点星收藏，压缩时会把原文写进摘要目录和快照（DSH 原生自动压缩不认收藏，被它压走的消息建议交接前留档）。交接后会默认自动归档旧会话（侧栏收起，可取消勾选「交接后归档」；旧会话在侧栏置顶时会先问你，因为归档会取消置顶）。`;
       }, [state.native]);
 
       /** 播放一次引导：呼吸光晕 + 提示。手动重播用更长时间（用户要关掉设置页才看得到）。 */
@@ -1803,19 +1808,6 @@ window.__ModuleLoader__.load({
         return () => window.removeEventListener('compact-relay:replay-onboarding', onReplay);
       }, [playOnboarding]);
 
-      // 0.5.1 批 2：原生压缩即将覆盖锁定消息 —— 事前主动提示一次（同一风险签名只弹一次）。
-      const pinRiskToastRef = useRef('');
-      useEffect(() => {
-        if (pinRisk === null) return;
-        const signature = `${state.sessionId ?? ''}:${pinRisk.seqs.join(',')}`;
-        if (signature === pinRiskToastRef.current) return;
-        pinRiskToastRef.current = signature;
-        showToast(
-          `⚠ 原生压缩预计覆盖你锁定的 ${pinRisk.count} 条消息（通常在本轮回复收尾时触发）。建议先交接（/handoff）保留原文，或解锁让压缩带走。`,
-          12000,
-        );
-      }, [pinRisk, state.sessionId, showToast]);
-
       // 0.4.2（P1）：换模型后首次发现「交接线已晚」弹一次提示（同路由不重复打扰）。
       // 只在「观察到路由变化」（localStorage 记着上一次的 provider/model）时弹；
       // 首次见到某路由不弹（不是换模型导致的），设置页有常驻提示兜底。
@@ -1878,6 +1870,9 @@ window.__ModuleLoader__.load({
         setOpen(false);
         setHandoffPreview(null);
         setPreview({ loading: true });
+        setFavoriteMarks({});
+        setFavoritePendingSeq(null);
+        setFavoriteError(null);
         const controller = typeof AbortController === 'function' ? new AbortController() : null;
         previewAbortRef.current = controller;
         try {
@@ -2173,6 +2168,52 @@ window.__ModuleLoader__.load({
         [sessionId, waitAndOpen, preview, startPreview],
       );
 
+      // 0.6 预览卡「收藏」按钮：只有用户点击才发请求（绝不自动收藏）。
+      // 走既有 action:'favorite-mark'（按 sessionId+seq，含用户发言、不需要活 agent）；
+      // 显式 active:true = 只加不切换——即使预览数据过期/重复点，也不会误删已有收藏。
+      // 成功只在本卡做局部标记（该行变「已收藏 ✓」、计数本地更新），不重拉预览、不碰压缩计划。
+      const markFavoriteFromPreview = useCallback(
+        async (item) => {
+          const seq = item !== null && typeof item === 'object' && Number.isInteger(item.seq) ? item.seq : null;
+          if (seq === null || favoritePendingSeq !== null) return;
+          if (typeof sessionId !== 'string' || sessionId.length === 0) {
+            setFavoriteError('拿不到会话 id，先等会话就绪再收藏');
+            return;
+          }
+          setFavoritePendingSeq(seq);
+          setFavoriteError(null);
+          try {
+            const res = await fetch('/api/compact-relay-action', {
+              method: 'POST',
+              headers: { 'content-type': 'application/json' },
+              body: JSON.stringify({ action: 'favorite-mark', sessionId, seq, active: true }),
+            });
+            const data = await res.json().catch(() => ({}));
+            if (data !== null && typeof data === 'object' && data.ok !== false && data.active === true) {
+              setFavoriteMarks((prev) => ({
+                ...prev,
+                [seq]: {
+                  seq,
+                  role: typeof item.role === 'string' ? item.role : '',
+                  title: typeof item.title === 'string' && item.title.length > 0 ? item.title : typeof item.snippet === 'string' ? item.snippet : '',
+                },
+              }));
+              return;
+            }
+            setFavoriteError(
+              data !== null && typeof data === 'object' && typeof data.message === 'string' && data.message.length > 0
+                ? data.message
+                : '收藏失败，请重试',
+            );
+          } catch (error) {
+            setFavoriteError('收藏失败：网络或宿主不可用');
+          } finally {
+            setFavoritePendingSeq(null);
+          }
+        },
+        [sessionId, favoritePendingSeq],
+      );
+
       const adviceText = adviseHandoff ? '建议交接' : adviseCompact ? '建议压缩' : '正常';
       // 0.3.1：模型判断的断点位置（「这里适合压缩」）；DSH 原生自动压缩线（报警最高阈值）。
       const compressHintText =
@@ -2202,9 +2243,6 @@ window.__ModuleLoader__.load({
         (compressHintText !== '' ? `｜${compressHintText}` : '') +
         (nativeLineText !== '' ? `｜${nativeLineText}` : '') +
         (handoffWarnText !== '' ? `｜${handoffWarnText}` : '') +
-        (pins.count > 0 ? `｜已锁定 ${pins.count} 条` : '') +
-        (pinStaleCount > 0 ? `｜${staleLabel}` : '') +
-        (pinRisk !== null ? `｜⚠ ${pinRiskLabel}（建议先交接或解锁）` : '') +
         (effectiveBusy ? '｜处理中…' : '');
 
       // 浮层定位：fixed（不受 composer 裁剪）+ 视口左右收边 + 上方空间不够时翻到下方。
@@ -2261,20 +2299,8 @@ window.__ModuleLoader__.load({
               h(
                 'div',
                 { style: { color: theme.subText } },
-                `已压缩 ${state.summaries} 次 · ${adviceText}${compressHintText !== '' ? ` · ${compressHintText}` : ''}${nativeLineText !== '' ? ` · ${nativeLineText}` : ''}${pins.count > 0 ? ` · 已锁定 ${pins.count} 条` : ''}${effectiveBusy ? ' · 处理中…' : ''}`,
+                `已压缩 ${state.summaries} 次 · ${adviceText}${compressHintText !== '' ? ` · ${compressHintText}` : ''}${nativeLineText !== '' ? ` · ${nativeLineText}` : ''}${effectiveBusy ? ' · 处理中…' : ''}`,
               ),
-              // 0.5.1 批 2：失效 pin 明确标出来（不假装还在、不消失）。
-              pinStaleCount > 0
-                ? h('div', { 'data-cr-pin-stale': '1', style: { marginTop: 2, color: theme.subText } }, staleLabel)
-                : null,
-              // 0.5.1 批 2：下一次原生自动压缩会覆盖锁定消息 → 事前提示（先交接/保留或解锁）。
-              pinRisk !== null
-                ? h(
-                    'div',
-                    { 'data-cr-pin-risk': '1', style: { marginTop: 2, color: palette.handoff } },
-                    `⚠ ${pinRiskLabel}：下一次原生压缩（通常在本轮回复收尾时）会压掉它们。建议先交接（/handoff）保留，或解锁让压缩带走。`,
-                  )
-                : null,
               // 0.4.2：交接线晚于原生压缩时，悬停卡里给一行显式警示（只告警，不改设置）。
               handoffWarnText !== ''
                 ? h('div', { 'data-cr-handoff-warn-text': '1', style: { marginTop: 2, color: palette.handoff } }, handoffWarnText)
@@ -2435,15 +2461,8 @@ window.__ModuleLoader__.load({
       };
 
       // 0.5.1 批 2：交接菜单项的提示（原生压缩预判风险优先于「交接线已晚」，两条都有就并排）。
-      const handoffItemNote =
-        pinRisk !== null
-          ? `⚠ ${pinRiskLabel}：建议先交接保留`
-          : handoffLate
-            ? handoffWarnText
-            : '';
-      const handoffItemTitle =
-        [pinRisk !== null ? `原生压缩会在下一次触发时（通常本轮回复收尾）压掉你锁定的 ${pinRisk.count} 条消息。先交接可保留原文；也可以解锁让压缩带走。` : '',
-         handoffLate ? handoffGuardInfo.message : ''].filter((text) => text !== '').join('\n') || undefined;
+      const handoffItemNote = handoffLate ? handoffWarnText : '';
+      const handoffItemTitle = handoffLate ? handoffGuardInfo.message : undefined;
       // undefined=宿主没上报（老版本/未知）；null=明确没有可压范围；object=可压多少。
       const rangeInfo = state.compactRange;
       // 0.3.5：有可压范围、但会话还没有活 agent（passivized live session）——preview 需要
@@ -2488,10 +2507,7 @@ window.__ModuleLoader__.load({
                 ...(rangeInfo === null
                   ? {
                       disabled: true,
-                      note:
-                        pins.count > 0
-                          ? `暂无可压内容：有 ${pins.count} 条消息被锁定保护（先点「解锁消息」）`
-                          : '暂无可压缩内容（会话太短，或近期会话需保留原文）',
+                      note: '暂无可压缩内容（会话太短，或近期会话需保留原文）',
                     }
                   : passiveRangeNote !== null
                     ? { disabled: true, title: passiveRangeNote, note: passiveRangeNote }
@@ -2503,35 +2519,6 @@ window.__ModuleLoader__.load({
                 },
               },
             ),
-            item(
-              pins.count > 0
-                ? `解锁消息（${pins.count} 条）`
-                : pinStaleCount > 0
-                  ? `解除失效锁定（${pinStaleCount} 条）`
-                  : '锁定重要消息',
-              pins.count > 0
-                ? '解除锁定，允许后续压缩合并这些消息'
-                : pinStaleCount > 0
-                  ? `${staleLabel}：原文已不在当前上下文，点此清空锁定记录`
-                  : '锁定的消息压缩时不会碰（重要结论/路径先锁住，也可 /pin list 挑一条）',
-              'pin',
-              null,
-              hasSession
-                ? {
-                    oneLine: true,
-                    right:
-                      pins.count > 0
-                        ? `已锁 ${pins.count} 条${pinStaleCount > 0 ? ` · 失效 ${pinStaleCount}` : ''}`
-                        : pinStaleCount > 0
-                          ? `失效 ${pinStaleCount} 条`
-                          : '未锁定',
-                    ...(pinRisk !== null ? { note: `⚠ ${pinRiskLabel}（建议先交接）`, title: pinRiskLabel } : {}),
-                    onClick: () => {
-                      void togglePins();
-                    },
-                  }
-                : { oneLine: true, disabled: true, right: '未就绪', note: '会话还没就绪' },
-            ),
             item(
               '交接新会话',
               '生成交接单并开新会话接着聊，旧会话保留（/handoff）',
@@ -2575,12 +2562,42 @@ window.__ModuleLoader__.load({
       const previewRange = preview?.data?.preview ?? null;
       // 0.3.1：范围太小时预览阶段就拦下（服务端已按 800 tokens 判定），不让用户白确认一次。
       const previewTooSmall = previewRange !== null && previewRange.tooSmall === true;
-      // 0.4 P1-1/P1-2：建议锁定候选 + pin 命中数（宿主已算好，客户端只渲染；不自动锁）。
-      const pinSuggest =
-        previewRange !== null && previewRange.pinSuggest !== null && typeof previewRange.pinSuggest === 'object' && Array.isArray(previewRange.pinSuggest.items)
-          ? previewRange.pinSuggest
+      // 0.6 预览卡收藏区：服务端 additive 字段 favoritePreview（老宿主没有 → 整块不渲染）。
+      // 只读渲染；「建议补」= 本段未收藏的候选（服务端已用 pinSuggest 同一套识别过滤过）。
+      const favoritePreview =
+        previewRange !== null && previewRange.favoritePreview !== null && typeof previewRange.favoritePreview === 'object'
+          ? previewRange.favoritePreview
           : null;
-      const pinHits = previewRange !== null && previewRange.pinHits !== null && typeof previewRange.pinHits === 'object' ? previewRange.pinHits : null;
+      const favoriteRowOf = (item) =>
+        item !== null && typeof item === 'object' && Number.isInteger(item.seq)
+          ? {
+              seq: item.seq,
+              role: typeof item.role === 'string' ? item.role : '',
+              title: typeof item.title === 'string' ? item.title : '',
+              reason: typeof item.reason === 'string' ? item.reason : '',
+              snippet: typeof item.snippet === 'string' ? item.snippet : '',
+            }
+          : null;
+      const favoriteBaseItems =
+        favoritePreview !== null && Array.isArray(favoritePreview.favorited)
+          ? favoritePreview.favorited.map(favoriteRowOf).filter((item) => item !== null)
+          : [];
+      const favoriteSuggestList =
+        favoritePreview !== null && Array.isArray(favoritePreview.suggest)
+          ? favoritePreview.suggest.map(favoriteRowOf).filter((item) => item !== null)
+          : [];
+      const favoriteRangeTotal =
+        favoritePreview !== null && Number.isInteger(favoritePreview.total) ? favoritePreview.total : (previewRange?.nodes ?? 0);
+      // 卡内点成功的收藏：补进「本段已收藏」列表，并从「建议补」计数里扣掉（本地即时，不重拉预览）。
+      const favoriteExtraItems = favoriteSuggestList
+        .filter((item) => favoriteMarks[item.seq] !== undefined)
+        .map((item) => ({ seq: item.seq, role: item.role, title: item.snippet }));
+      const favoriteDisplayItems = [...favoriteBaseItems, ...favoriteExtraItems];
+      const favoriteFavoritedCount =
+        (favoritePreview !== null && Number.isInteger(favoritePreview.favoritedCount)
+          ? favoritePreview.favoritedCount
+          : favoriteBaseItems.length) + favoriteExtraItems.length;
+      const favoriteSuggestRemaining = favoriteSuggestList.length - favoriteExtraItems.length;
       const confirmPanel =
         preview === null
           ? null
@@ -2630,43 +2647,139 @@ window.__ModuleLoader__.load({
                       h('br'),
                       '只估算范围和容量；摘要内容确认后才生成，不在这里展示。压缩后旧会话将替换为摘要，无法还原为原文。',
                     ),
-                    pinSuggest !== null && pinSuggest.items.length > 0
+                    favoritePreview !== null
                       ? h(
                           'div',
                           {
-                            'data-cr-pin-suggest': '1',
+                            'data-cr-favorite-preview': '1',
                             style: {
                               display: 'flex',
                               flexDirection: 'column',
-                              gap: 2,
+                              gap: 4,
                               padding: '6px 8px',
                               borderRadius: 8,
                               border: `1px solid ${theme.panelBorder}`,
                               background: theme.hover,
                             },
                           },
-                          h('div', { style: { fontSize: 11, fontWeight: 700, color: theme.panelFg } }, `建议锁定 ${pinSuggest.items.length} 条（先 /pin 再压）`),
-                          ...pinSuggest.items.map((item) =>
-                            h(
-                              'div',
-                              { key: `pin-suggest-${item.seq}`, style: { fontSize: 11, lineHeight: '16px', color: theme.subText } },
-                              `${item.role} · ${item.reason}：${item.snippet}`,
-                            ),
-                          ),
                           h(
                             'div',
-                            { style: { fontSize: 10, lineHeight: '14px', color: theme.subText } },
-                            '只建议、不自动锁定；锁定后这些消息会原样保留（/pin list 可按序号挑）。',
+                            {
+                              'data-cr-favorite-summary': '1',
+                              style: { fontSize: 11, fontWeight: 700, color: theme.panelFg },
+                            },
+                            `本段 ${favoriteRangeTotal} 条 · 已收藏 ${favoriteFavoritedCount} 条 · 建议补 ${favoriteSuggestRemaining} 条`,
                           ),
-                        )
-                      : null,
-                    pinHits !== null && pinHits.total > 0
-                      ? h(
-                          'div',
-                          { 'data-cr-pin-hits': '1', style: { fontSize: 11, lineHeight: '16px', color: theme.subText } },
-                          pinHits.inRange > 0
-                            ? `pin 命中 ${pinHits.inRange} 条：本次范围里被锁定的消息已跳过（会话共 ${pinHits.total} 条锁定）。`
-                            : `pin 命中 0 条：本次范围内没有锁定消息（会话共 ${pinHits.total} 条锁定，均在范围外）。`,
+                          favoriteDisplayItems.length > 0
+                            ? h(
+                                'div',
+                                { 'data-cr-favorite-list': '1', style: { display: 'flex', flexDirection: 'column', gap: 2 } },
+                                h('div', { style: { fontSize: 10, fontWeight: 700, color: theme.subText } }, '本段已收藏'),
+                                ...favoriteDisplayItems.map((item) =>
+                                  h(
+                                    'div',
+                                    {
+                                      key: `favorite-item-${item.seq}`,
+                                      'data-cr-favorite-item': String(item.seq),
+                                      style: {
+                                        fontSize: 11,
+                                        lineHeight: '16px',
+                                        color: theme.subText,
+                                        whiteSpace: 'normal',
+                                        wordBreak: 'break-word',
+                                      },
+                                    },
+                                    `[${item.role}] ${item.title}`,
+                                  ),
+                                ),
+                                favoriteFavoritedCount > favoriteDisplayItems.length
+                                  ? h(
+                                      'div',
+                                      { style: { fontSize: 10, lineHeight: '14px', color: theme.subText } },
+                                      `…另有 ${favoriteFavoritedCount - favoriteDisplayItems.length} 条，用 /favorite list 查看`,
+                                    )
+                                  : null,
+                              )
+                            : null,
+                          favoriteSuggestList.length > 0
+                            ? h(
+                                'div',
+                                { 'data-cr-favorite-suggest': '1', style: { display: 'flex', flexDirection: 'column', gap: 3 } },
+                                h('div', { style: { fontSize: 10, fontWeight: 700, color: theme.subText } }, '建议先收藏（本段未收藏）'),
+                                ...favoriteSuggestList.map((item) => {
+                                  const done = favoriteMarks[item.seq] !== undefined;
+                                  const pending = favoritePendingSeq === item.seq;
+                                  return h(
+                                    'div',
+                                    {
+                                      key: `favorite-suggest-${item.seq}`,
+                                      'data-cr-favorite-suggest-row': String(item.seq),
+                                      style: { display: 'flex', alignItems: 'flex-start', gap: 6 },
+                                    },
+                                    h(
+                                      'span',
+                                      {
+                                        style: {
+                                          flex: 1,
+                                          minWidth: 0,
+                                          fontSize: 11,
+                                          lineHeight: '16px',
+                                          color: theme.subText,
+                                          whiteSpace: 'normal',
+                                          wordBreak: 'break-word',
+                                        },
+                                      },
+                                      `[${item.role}] ${item.reason}：${item.snippet}`,
+                                    ),
+                                    done
+                                      ? h(
+                                          'span',
+                                          {
+                                            'data-cr-favorite-done': String(item.seq),
+                                            style: { flex: 'none', fontSize: 10, fontWeight: 600, lineHeight: '16px', color: '#2fb344' },
+                                          },
+                                          '已收藏 ✓',
+                                        )
+                                      : h(
+                                          'button',
+                                          {
+                                            type: 'button',
+                                            'data-cr-favorite-mark': String(item.seq),
+                                            disabled: favoritePendingSeq !== null,
+                                            onClick: () => {
+                                              void markFavoriteFromPreview(item);
+                                            },
+                                            style: {
+                                              flex: 'none',
+                                              border: `1px solid ${theme.panelBorder}`,
+                                              borderRadius: 6,
+                                              padding: '1px 8px',
+                                              fontSize: 10,
+                                              lineHeight: '16px',
+                                              cursor: favoritePendingSeq === null ? 'pointer' : 'default',
+                                              background: 'transparent',
+                                              color: theme.panelFg,
+                                              opacity: favoritePendingSeq === null ? 1 : 0.5,
+                                            },
+                                          },
+                                          pending ? '收藏中…' : '收藏',
+                                        ),
+                                  );
+                                }),
+                                h(
+                                  'div',
+                                  { 'data-cr-favorite-note': '1', style: { fontSize: 10, lineHeight: '14px', color: theme.subText } },
+                                  '只提示、不自动收藏；点「收藏」只写一条收藏标记，不改压缩范围。',
+                                ),
+                              )
+                            : null,
+                          favoriteError !== null
+                            ? h(
+                                'div',
+                                { 'data-cr-favorite-error': '1', style: { fontSize: 10, lineHeight: '14px', color: COLORS.error } },
+                                favoriteError,
+                              )
+                            : null,
                         )
                       : null,
                     h(
@@ -2790,7 +2903,10 @@ window.__ModuleLoader__.load({
                 ? h('div', { style: { fontSize: 11, color: theme.subText } }, '正在生成九段草稿并做就绪检查…（只预览，不写盘、不建会话）')
                 : h(
                     'div',
-                    { style: { display: 'flex', flexDirection: 'column', gap: 8, minHeight: 0 } },
+                    {
+                      'data-cr-handoff-body': '1',
+                      style: { display: 'flex', flexDirection: 'column', gap: 8, minHeight: 0, flexShrink: 0 },
+                    },
                     h(
                       'div',
                       {
@@ -2810,11 +2926,13 @@ window.__ModuleLoader__.load({
                     h(
                       'div',
                       {
+                        'data-cr-handoff-draft': '1',
                         style: {
                           fontSize: 11,
                           lineHeight: '16px',
                           overflow: 'auto',
                           maxHeight: 220,
+                          flexShrink: 0,
                           border: `1px solid ${theme.panelBorder}`,
                           borderRadius: 8,
                           padding: '6px 8px',
@@ -3435,6 +3553,34 @@ window.__ModuleLoader__.load({
       return typeof data.parentArchived === 'boolean' ? data.parentArchived : null;
     }
 
+    /**
+     * 0.5.2 L 项：宿主有没有强制归档的接缝（`readState.capabilities.forceArchive`）。
+     *
+     * 三重取值：true / false / null（老插件没有这个字段 → 不知道，仍显示入口；
+     * 调用失败会给可读错误，不静默）。false = 宿主没有 `archiveSession` → 隐藏死入口。
+     * @param {object|null|undefined} data `/api/compact-relay-state` 的响应
+     * @returns {boolean|null}
+     */
+    function relayBarForceArchiveCapabilityOf(data) {
+      if (data === null || typeof data !== 'object' || data.ok === false) return null;
+      const capabilities = data.capabilities;
+      if (capabilities === null || typeof capabilities !== 'object') return null;
+      return typeof capabilities.forceArchive === 'boolean' ? capabilities.forceArchive : null;
+    }
+
+    /**
+     * 0.5.2 L 项：链上旧会话（入站 parentId）是否在侧栏置顶（`readState.parentPinned`）。
+     *
+     * 置顶与归档互斥：宿主 `archiveSession` 在同一笔写盘里把该 id 从置顶集合移除。
+     * 强制归档的二次确认要在置顶时明确写「会同时取消置顶」，所以这里只读判断。
+     * @param {object|null|undefined} data `/api/compact-relay-state` 的响应
+     * @returns {boolean|null}
+     */
+    function relayBarParentPinnedOf(data) {
+      if (data === null || typeof data !== 'object' || data.ok === false) return null;
+      return typeof data.parentPinned === 'boolean' ? data.parentPinned : null;
+    }
+
     /**
      * 接力条摘要：新链「历史 N：原名」，旧链「交接第 N 次：原名」。
      * @param {object} chain relayBarChainOf 的结果
@@ -3620,6 +3766,15 @@ window.__ModuleLoader__.load({
       // 0.5.1 DCR-03：服务端能不能恢复归档会话（readState.capabilities.unarchive）。
       // null = 老插件没有这个字段（不知道 → 仍显示入口，恢复调用幂等）。
       const [serverUnarchive, setServerUnarchive] = useState(null);
+      // 0.5.2 L 项：服务端能不能强制归档（readState.capabilities.forceArchive）。
+      // null = 老插件没有这个字段（不知道 → 仍显示入口，失败会给可读错误）。
+      const [serverForceArchive, setServerForceArchive] = useState(null);
+      // 0.5.2 L 项：旧会话（入站 parentId）是否在侧栏置顶（readState.parentPinned）。
+      // 置顶时二次确认要提前说明「归档会同时取消置顶」。
+      const [parentPinned, setParentPinned] = useState(null);
+      // 0.5.2 L 项：强制归档面板 —— null = 关；否则
+      // {phase:'confirm'|'busy'|'error'|'done', status?, note?, message?}。
+      const [forceView, setForceView] = useState(null);
       // 0.5.1 DCR-03：打开菜单时 +1，触发一次静默刷新（别处归档/取消归档能立刻反映）。
       const [refreshKey, setRefreshKey] = useState(0);
       // 0.5.1 批 3：完整交接链（null = 没展开；点「完整交接链」后才逐级去读）。
@@ -3666,6 +3821,7 @@ window.__ModuleLoader__.load({
         setOpen(false);
         setDoc(null);
         setNotice(null);
+        setForceView(null);
       }, [abortDoc, closeChainView]);
 
       // 从交接单详情回到菜单列表：取消读取，避免「返回后又被晚到的响应撑开」。
@@ -3689,6 +3845,9 @@ window.__ModuleLoader__.load({
           setParentArchived(null);
           setNextArchived(null);
           setServerUnarchive(null);
+          setServerForceArchive(null);
+          setParentPinned(null);
+          setForceView(null);
           setOpen(false);
           setDoc(null);
           setNotice(null);
@@ -3758,6 +3917,9 @@ window.__ModuleLoader__.load({
               setParentArchived(relayBarParentArchivedOf(data));
               setNextArchived(relayBarNextArchivedOf(data));
               setServerUnarchive(relayBarUnarchiveCapabilityOf(data));
+              // 0.5.2 L 项：强制归档的能力位与旧会话置顶状态（二次确认文案用）。
+              setServerForceArchive(relayBarForceArchiveCapabilityOf(data));
+              setParentPinned(relayBarParentPinnedOf(data));
               // F3 的子会话记录不带 path（交接单路径只写在父记录里）：向父会话读回
               // 同一条链，childId 指回本会话且链号一致时才采用它的 path。只读、失败
               // 就保持「暂无交接单」；不碰宿主逻辑，也不改交接流程。
@@ -3775,6 +3937,8 @@ window.__ModuleLoader__.load({
                 setParentArchived(null);
                 setNextArchived(null);
                 setServerUnarchive(null);
+                setServerForceArchive(null);
+                setParentPinned(null);
               }
             } else schedule();
           } catch {
@@ -3864,6 +4028,8 @@ window.__ModuleLoader__.load({
         abortDoc();
         setNotice(null);
         setDoc(null);
+        // 0.5.2 L 项：重开菜单一律回到主列表（强制归档确认面板不残留、不误触）。
+        setForceView(null);
         // 每次开/关都把完整链收掉：重开菜单从主列表开始（不预加载，也不留旧会话的链）。
         closeChainView();
         // 0.5.1 DCR-03：打开菜单前刷新一次 state —— 归档集合可能在别处被改（侧栏
@@ -4373,6 +4539,96 @@ window.__ModuleLoader__.load({
       // 两个方向都没有 → 什么都不渲染（不占 composerStack 的高度）。
       if (chain === null && next === null) return null;
 
+      // ------------------------------------------------------------------
+      // 0.5.2 L 项：强制归档旧会话（显式二次确认；唯一会 stopActivity 的用户入口）
+      // ------------------------------------------------------------------
+
+      /**
+       * 打开强制归档的二次确认面板（只改本地视图，不发请求）。
+       *
+       * 默认行为不变：自动归档遇到活跃会话仍然「保留可见不归档」；只有用户在这个
+       * 确认面板里再点一次「强制归档（停止任务）」才会调用服务端。
+       * @param {string} target 旧会话 id（入站 parentId）
+       */
+      const openForceConfirm = useCallback(
+        (target) => {
+          if (typeof target !== 'string' || target.length === 0) return;
+          abortDoc();
+          setNotice(null);
+          setDoc(null);
+          closeChainView();
+          setForceView({ phase: 'confirm', target });
+        },
+        [abortDoc, closeChainView],
+      );
+
+      /**
+       * 执行强制归档：POST `action:'force-archive'`（服务端 → registry.archiveSession(id,{stopActivity:true})）。
+       *
+       * 只有用户点过确认才会走到这里。成功时复用 `handoffArchiveNoteOf` 的现有三套文案
+       * （archived / already / pinned，含「归档会取消置顶」的置顶提示）；失败时可读错误
+       * 写进面板，不静默。`pinned` 不是失败：它表示宿主里旧会话其实还置顶、需要用户
+       * 再确认一次「归档并取消置顶」，面板会给出这个出口。
+       *
+       * @param {string} target 旧会话 id（入站 parentId）
+       * @param {{confirmUnpin?:boolean}} [options] true = 用户已确认「归档会取消置顶」
+       */
+      const runForceArchive = useCallback((target, options = {}) => {
+        const confirmUnpin = options.confirmUnpin === true;
+        if (typeof target !== 'string' || target.length === 0) return Promise.resolve();
+        setNotice(null);
+        setForceView({ phase: 'busy', target, confirmUnpin });
+        return (async () => {
+          try {
+            const res = await fetch('/api/compact-relay-action', {
+              method: 'POST',
+              headers: { 'content-type': 'application/json' },
+              cache: 'no-store',
+              body: JSON.stringify({
+                action: 'force-archive',
+                sessionId: target,
+                // 二次确认的凭证：服务端没有 confirmStop:true 一律拒绝（不会静默停任务）。
+                confirmStop: true,
+                ...(confirmUnpin ? { confirmUnpin: true } : {}),
+              }),
+            });
+            const data = await res.json().catch(() => null);
+            if (!res.ok || data === null || typeof data !== 'object' || data.ok === false) {
+              const message =
+                data !== null && typeof data === 'object' && typeof data.message === 'string' && data.message.length > 0
+                  ? data.message
+                  : '强制归档接口不可用';
+              throw new Error(message);
+            }
+            // archived / already 都意味着旧会话已在归档集合里（already 幂等，没有重复停任务）。
+            if (data.status === 'archived' || data.status === 'already') setParentArchived(true);
+            setForceView({
+              phase: 'done',
+              target,
+              status: typeof data.status === 'string' ? data.status : 'archived',
+              note:
+                typeof data.note === 'string' && data.note.length > 0
+                  ? data.note
+                  : '旧会话已归档（可在新会话输入框上方「已接力自 …」→「恢复旧会话」找回）。',
+            });
+          } catch (error) {
+            setForceView({
+              phase: 'error',
+              target,
+              confirmUnpin,
+              message: '强制归档失败：' + (error && error.message ? error.message : '未知错误'),
+            });
+          }
+        })();
+      }, []);
+
+      /** 从确认/错误/结果面板回到主菜单列表（不关整个菜单，用户可继续用其他入口）。 */
+      const backFromForce = useCallback(() => {
+        setNotice(null);
+        setForceView(null);
+      }, []);
+
+
       const hasParent = chain !== null && chain.parentId !== null;
       const hasNext = next !== null && next.childId !== null;
       // 父会话侧（只有出站记录）这一行的摘要文案：它没有「已接力自」的来路。
@@ -4384,11 +4640,17 @@ window.__ModuleLoader__.load({
       // 都显示——恢复调用幂等，宁可多一个入口，也不让用户的旧会话找不回来。
       // 0.5.1 DCR-03：宿主客户端与服务端都没有恢复能力时**隐藏**入口（点了必然失败）。
       const showRestore = hasParent && parentArchived !== false && canRestore;
+      // 0.5.2 L 项：强制归档入口 —— 旧会话**还没归档**时才需要它（已归档没什么可强制的）；
+      // 服务端明确说没有 archiveSession 能力（false）时隐藏死入口；null（老插件没字段）
+      // 仍显示，失败时会给出可读错误。
+      const canForceArchive = serverForceArchive !== false;
+      const showForceArchive = hasParent && parentArchived !== true && canForceArchive;
       const vw = typeof window === 'undefined' ? 1280 : window.innerWidth;
       const vh = typeof window === 'undefined' ? 900 : window.innerHeight;
       const chainOpen = chainView !== null && doc === null;
-      const menuWidth = Math.min(doc !== null ? 420 : chainOpen ? 336 : 272, Math.max(240, vw - 16));
-      const estimatedHeight = doc !== null ? 360 : chainOpen ? 380 : 168;
+      const forceOpen = forceView !== null && doc === null && chainView === null;
+      const menuWidth = Math.min(doc !== null ? 420 : chainOpen ? 336 : forceOpen ? 320 : 272, Math.max(240, vw - 16));
+      const estimatedHeight = doc !== null ? 360 : chainOpen ? 380 : forceOpen ? 300 : 168;
       const anchorTop = anchor === null ? vh - 96 : anchor.top;
       const anchorBottom = anchor === null ? vh - 40 : anchor.bottom;
       const openUp = anchorTop >= Math.min(estimatedHeight, vh - 16) + 12;
@@ -4635,6 +4897,219 @@ window.__ModuleLoader__.load({
               ),
             );
 
+      /**
+       * 0.5.2 L 项：强制归档的二次确认 / 执行中 / 失败 / 结果面板。
+       *
+       * 破坏性后果写在标题下的第一段（「会停止旧会话上正在跑的任务」），而不是只靠
+       * 按钮文案；置顶时再补一行「归档会同时取消置顶（宿主行为）」，与交接前的置顶
+       * 确认同一口径。只有「强制归档（停止任务）」这个按钮会真的发请求。
+       */
+      const forcePanel =
+        forceView === null
+          ? null
+          : h(
+              'div',
+              {
+                role: 'dialog',
+                'aria-label': '强制归档旧会话',
+                'data-cr-force-archive': '1',
+                'data-cr-force-phase': forceView.phase,
+                'data-cr-force-target': typeof forceView.target === 'string' ? forceView.target : '',
+                style: { display: 'flex', flexDirection: 'column', minHeight: 0 },
+              },
+              h(
+                'div',
+                {
+                  style: {
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: 8,
+                    padding: '7px 10px',
+                    borderBottom: `1px solid ${theme.panelBorder}`,
+                    fontSize: 12,
+                    fontWeight: 600,
+                  },
+                },
+                h('span', { style: { flex: 1, minWidth: 0 } }, '强制归档旧会话'),
+                forceView.phase === 'busy'
+                  ? null
+                  : h(
+                      'button',
+                      {
+                        type: 'button',
+                        'data-cr-force-back': '1',
+                        onClick: backFromForce,
+                        style: { border: `1px solid ${theme.panelBorder}`, borderRadius: 6, padding: '2px 8px', fontSize: 11, cursor: 'pointer', background: 'transparent', color: theme.panelFg },
+                      },
+                      '← 返回',
+                    ),
+              ),
+              forceView.phase === 'confirm'
+                ? h(
+                    'div',
+                    {
+                      'data-cr-force-confirm': '1',
+                      style: { display: 'flex', flexDirection: 'column', gap: 8, padding: '10px 12px', fontSize: 11, lineHeight: '16px' },
+                    },
+                    h('div', { style: { fontWeight: 600, color: theme.panelFg } }, `将强制归档旧会话「${label}」。`),
+                    h(
+                      'div',
+                      {
+                        'data-cr-force-warning': '1',
+                        style: {
+                          padding: '6px 8px',
+                          borderRadius: 8,
+                          border: `1px solid ${COLORS.error}`,
+                          color: COLORS.error,
+                          background: theme.hover,
+                        },
+                      },
+                      '会停止旧会话上正在跑的任务（turn / 子代理 / 后台任务 / 定时任务），中断后无法恢复。',
+                    ),
+                    parentPinned === true
+                      ? h('div', { 'data-cr-force-pin': '1', style: { color: theme.subText } }, '旧会话已在侧栏置顶：归档会同时取消置顶（宿主行为）。')
+                      : parentPinned === null
+                        ? h('div', { 'data-cr-force-pin': '1', style: { color: theme.subText } }, '宿主没提供置顶状态：若旧会话在侧栏置顶，归档会同时取消置顶（宿主行为）。')
+                        : null,
+                    h(
+                      'div',
+                      { style: { color: theme.subText } },
+                      '这是显式操作：默认自动归档遇到活跃会话会「保留可见、不停止任务」，只有你在这里确认后才会停止旧会话上的任务。',
+                    ),
+                    h(
+                      'div',
+                      { style: { display: 'flex', justifyContent: 'flex-end', gap: 8 } },
+                      h(
+                        'button',
+                        {
+                          type: 'button',
+                          'data-cr-force-cancel': '1',
+                          onClick: backFromForce,
+                          style: { border: `1px solid ${theme.panelBorder}`, borderRadius: 7, padding: '4px 10px', fontSize: 11, cursor: 'pointer', background: 'transparent', color: theme.panelFg },
+                        },
+                        '取消',
+                      ),
+                      h(
+                        'button',
+                        {
+                          type: 'button',
+                          'data-cr-force-run': '1',
+                          onClick: () => {
+                            void runForceArchive(forceView.target, { confirmUnpin: parentPinned === true });
+                          },
+                          style: {
+                            border: 'none',
+                            borderRadius: 7,
+                            padding: '4px 10px',
+                            fontSize: 11,
+                            fontWeight: 600,
+                            cursor: 'pointer',
+                            background: COLORS.error,
+                            color: '#ffffff',
+                          },
+                        },
+                        parentPinned === true ? '强制归档并取消置顶（停止任务）' : '强制归档（停止任务）',
+                      ),
+                    ),
+                  )
+                : forceView.phase === 'busy'
+                  ? h(
+                      'div',
+                      { 'data-cr-force-busy': '1', style: { padding: '12px', fontSize: 11, lineHeight: '16px', color: theme.subText } },
+                      '正在强制归档并停止旧会话上的任务…',
+                    )
+                  : forceView.phase === 'error'
+                    ? h(
+                        'div',
+                        { 'data-cr-force-error': '1', style: { display: 'flex', flexDirection: 'column', gap: 8, padding: '10px 12px', fontSize: 11, lineHeight: '16px' } },
+                        h('div', { style: { color: COLORS.error } }, String(forceView.message)),
+                        h(
+                          'div',
+                          { style: { display: 'flex', justifyContent: 'flex-end', gap: 8 } },
+                          h(
+                            'button',
+                            {
+                              type: 'button',
+                              'data-cr-force-error-back': '1',
+                              onClick: backFromForce,
+                              style: { border: `1px solid ${theme.panelBorder}`, borderRadius: 7, padding: '4px 10px', fontSize: 11, cursor: 'pointer', background: 'transparent', color: theme.panelFg },
+                            },
+                            '返回菜单',
+                          ),
+                          h(
+                            'button',
+                            {
+                              type: 'button',
+                              'data-cr-force-retry': '1',
+                              onClick: () => {
+                                void runForceArchive(forceView.target, { confirmUnpin: forceView.confirmUnpin === true });
+                              },
+                              style: { border: `1px solid ${theme.panelBorder}`, borderRadius: 7, padding: '4px 10px', fontSize: 11, fontWeight: 600, cursor: 'pointer', background: 'transparent', color: theme.panelFg },
+                            },
+                            '重试',
+                          ),
+                        ),
+                      )
+                    : h(
+                        'div',
+                        { 'data-cr-force-done': '1', style: { display: 'flex', flexDirection: 'column', gap: 8, padding: '10px 12px', fontSize: 11, lineHeight: '16px' } },
+                        h('div', { 'data-cr-force-note': '1', style: { color: theme.panelFg } }, String(forceView.note)),
+                        // pinned = 宿主里旧会话其实还置顶（状态过期）：不静默取消置顶，
+                        // 给一个明确的二次出口，用户点了才带 confirmUnpin 重发。
+                        forceView.status === 'pinned'
+                          ? h(
+                              'div',
+                              { style: { display: 'flex', justifyContent: 'flex-end', gap: 8 } },
+                              h(
+                                'button',
+                                {
+                                  type: 'button',
+                                  'data-cr-force-close': '1',
+                                  onClick: closeMenu,
+                                  style: { border: `1px solid ${theme.panelBorder}`, borderRadius: 7, padding: '4px 10px', fontSize: 11, cursor: 'pointer', background: 'transparent', color: theme.panelFg },
+                                },
+                                '关闭',
+                              ),
+                              h(
+                                'button',
+                                {
+                                  type: 'button',
+                                  'data-cr-force-unpin': '1',
+                                  onClick: () => {
+                                    void runForceArchive(forceView.target, { confirmUnpin: true });
+                                  },
+                                  style: { border: 'none', borderRadius: 7, padding: '4px 10px', fontSize: 11, fontWeight: 600, cursor: 'pointer', background: COLORS.error, color: '#ffffff' },
+                                },
+                                '仍然归档（取消置顶）',
+                              ),
+                            )
+                          : h(
+                              'div',
+                              { style: { display: 'flex', justifyContent: 'flex-end', gap: 8 } },
+                              h(
+                                'button',
+                                {
+                                  type: 'button',
+                                  'data-cr-force-close': '1',
+                                  onClick: closeMenu,
+                                  style: { border: `1px solid ${theme.panelBorder}`, borderRadius: 7, padding: '4px 10px', fontSize: 11, cursor: 'pointer', background: 'transparent', color: theme.panelFg },
+                                },
+                                '关闭',
+                              ),
+                              h(
+                                'button',
+                                {
+                                  type: 'button',
+                                  'data-cr-force-done-back': '1',
+                                  onClick: backFromForce,
+                                  style: { border: `1px solid ${theme.panelBorder}`, borderRadius: 7, padding: '4px 10px', fontSize: 11, fontWeight: 600, cursor: 'pointer', background: 'transparent', color: theme.panelFg },
+                                },
+                                '返回菜单',
+                              ),
+                            ),
+                      ),
+            );
+
       const menu =
         open === true
           ? h(
@@ -4653,7 +5128,7 @@ window.__ModuleLoader__.load({
                   display: 'flex',
                   flexDirection: 'column',
                   overflow: 'hidden',
-                  padding: doc === null && chainView === null ? 5 : 0,
+                  padding: doc === null && chainView === null && forceView === null ? 5 : 0,
                   borderRadius: 12,
                   ...panelChrome(theme),
                   color: theme.panelFg,
@@ -4668,9 +5143,10 @@ window.__ModuleLoader__.load({
                     notice,
                   )
                 : null,
-              // 交接单面板 / 完整链面板都替换主列表；「← 返回」按来源回到链列表或主菜单。
+              // 交接单面板 / 完整链面板 / 强制归档确认面板都替换主列表；「← 返回」按来源回主菜单。
               docPanel ??
                 chainPanel ??
+                forcePanel ??
                 h(
                   'div',
                   { style: { display: 'flex', flexDirection: 'column' } },
@@ -4712,6 +5188,22 @@ window.__ModuleLoader__.load({
                         },
                       )
                     : null,
+                  hasParent && showForceArchive
+                    ? relayBarItem(
+                        '强制归档旧会话（会停止后台任务）',
+                        parentPinned === true
+                          ? '旧会话已置顶：归档会同时取消置顶；会先二次确认'
+                          : '旧会话还有任务在跑也能收起；会先二次确认',
+                        'force-archive',
+                        () => {
+                          openForceConfirm(chain.parentId);
+                        },
+                        {
+                          right: '›',
+                          title: `强制归档旧会话 ${chain.parentId}：二次确认后会停止它上面正在跑的任务再归档`,
+                        },
+                      )
+                    : null,
                   hasParent
                     ? relayBarItem('完整交接链', '一次读取整条链，回看前几次会话与交接单', 'chain', openChainList, {
                         right: '›',
@@ -4844,6 +5336,288 @@ window.__ModuleLoader__.load({
         menu,
       );
     }
+    /**
+     * 收藏星标（0.6）—— 挂在助手消息底部的动作行（conversation.chat.assistant-actions）。
+     *
+     * 数据：GET /api/compact-relay-state?sessionId=… 的 favorites.messageIds（判断是否已收藏）；
+     * 点击：POST /api/compact-relay-action { action:'favorite-toggle', messageId, sessionId }。
+     *
+     * 2026-10-29 真机 BUG：以前 state 请求不带 sessionId，宿主回「最后一个活 agent」的会话
+     * （多工作区同时开着时那是别的会话）→ 点星 POST 到错会话 → 「找不到这条消息」→ 点了没反应。
+     * 现在会话 id 只认 slot 的 session 作用域注入（register 的 inject），state 也按它请求。
+     * 另外：点失败要出声（宿主可能回「已被压缩」/「没有活动会话」），不再静默。
+     */
+    const FAVORITE_STAR_PATH = 'M12 2.8l2.82 5.72 6.31.92-4.57 4.45 1.08 6.29L12 17.2l-5.64 2.98 1.08-6.29-4.57-4.45 6.31-.92z';
+
+    // 收藏状态共享快照：几十个星标组件共用一个请求（避免每条助手消息各发一次 GET）。
+    // 30s 内复用；并发挂载共用同一个 pending Promise。快照按 sessionId 区分（切会话不会串）。
+    const FAVORITE_SNAPSHOT_TTL_MS = 30000;
+    let favoriteSnapshot = null; // { sessionId, ids, suggested, freshUntil }
+    let favoriteSnapshotPending = null;
+    let favoriteSnapshotPendingSession = null;
+    /** 点亮色（配置 colors.base.favorite；设计稿到位后改配置值即可）。 */
+    let favoriteTint = '#F5C542';
+
+    /**
+     * 推荐态样式只注入一次：金色呼吸光晕（0.5.3 UI）。
+     * 静态 1.5px 细环在长消息流里太容易漏看；改成 2.4s 呼吸 + 更亮的峰值。
+     * 系统开了「减少动态效果」就退回静态加亮版本。
+     */
+    function ensureFavoriteStyle() {
+      try {
+        if (typeof document === 'undefined' || document.head === null) return;
+        if (document.getElementById('dcr-favorite-style') !== null) return;
+        const style = document.createElement('style');
+        style.id = 'dcr-favorite-style';
+        style.textContent =
+          '@keyframes dcr-favorite-pulse {' +
+          '0%,100% { box-shadow: 0 0 0 2px rgba(245,197,66,0.78), 0 0 6px rgba(245,197,66,0.45); }' +
+          '50% { box-shadow: 0 0 0 2.5px rgba(245,197,66,0.98), 0 0 12px rgba(245,197,66,0.85); }' +
+          '}' +
+          // 与宿主助手消息动作行（._action）完全对齐：基础用 label-tertiary，
+          // hover 切 label-secondary + 交互背景（与邻座逐项相同）。
+          '.dcr-favorite-star { background: transparent; color: var(--dsw-alias-label-tertiary, currentColor); }' +
+          '.dcr-favorite-star:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,0.16)); color: var(--dsw-alias-label-secondary, currentColor); }' +
+          '@media (prefers-reduced-motion: reduce) { .dcr-favorite-star { animation: none !important; } }';
+        document.head.appendChild(style);
+      } catch (error) {
+        /* 样式注入失败不影响收藏功能 */
+      }
+    }
+    ensureFavoriteStyle();
+
+    /** 轻提示：收藏失败/被压缩时告诉用户一声（不依赖宿主 toast API）。 */
+    function favoriteNotify(text) {
+      try {
+        if (typeof document === 'undefined' || document.body === null) return;
+        const el = document.createElement('div');
+        el.textContent = text;
+        el.style.cssText =
+          'position:fixed;left:50%;bottom:32px;transform:translateX(-50%);z-index:2147483000;max-width:80vw;' +
+          'padding:8px 14px;border-radius:8px;background:rgba(30,30,30,0.92);color:#fff;font-size:13px;' +
+          'line-height:1.4;box-shadow:0 6px 24px rgba(0,0,0,0.25);pointer-events:none;';
+        document.body.appendChild(el);
+        setTimeout(() => {
+          try {
+            el.remove();
+          } catch (error) {
+            /* ignore */
+          }
+        }, 4000);
+      } catch (error) {
+        /* 提示失败不影响收藏 */
+      }
+    }
+
+    /**
+     * 收藏列表（按会话缓存）。
+     * @param {string|null} sessionId 当前会话（来自 slot 注入；拿不到就退回旧行为）
+     * @returns {Promise<string[]|null>}
+     */
+    function favoriteIdsOf(sessionId) {
+      const sid = typeof sessionId === 'string' && sessionId.length > 0 ? sessionId : null;
+      if (favoriteSnapshot !== null && favoriteSnapshot.sessionId === sid && Date.now() < favoriteSnapshot.freshUntil) {
+        return Promise.resolve(favoriteSnapshot.ids);
+      }
+      if (favoriteSnapshotPending !== null && favoriteSnapshotPendingSession === sid) return favoriteSnapshotPending;
+      favoriteSnapshotPendingSession = sid;
+      favoriteSnapshotPending = (async () => {
+        try {
+          const url =
+            sid === null ? '/api/compact-relay-state' : `/api/compact-relay-state?sessionId=${encodeURIComponent(sid)}`;
+          const res = await fetch(url);
+          const data = await res.json();
+          const fav = data !== null && typeof data === 'object' ? data.favorites : null;
+          const ids = fav !== null && typeof fav === 'object' && Array.isArray(fav.messageIds) ? fav.messageIds : [];
+          // 0.5.3 P1-6：推荐收藏建议（只点亮星标，不写收藏）。按 messageId 建索引，组件 O(1) 查。
+          const suggested = {};
+          const suggestList =
+            data !== null && typeof data === 'object' && Array.isArray(data.favoriteSuggest) ? data.favoriteSuggest : [];
+          for (const item of suggestList) {
+            if (item === null || typeof item !== 'object') continue;
+            if (typeof item.messageId !== 'string' || item.messageId.length === 0) continue;
+            suggested[item.messageId] = {
+              score: typeof item.score === 'number' ? item.score : null,
+              reason: typeof item.reason === 'string' ? item.reason : '',
+            };
+          }
+          // 只有「没带 sessionId」的兜底请求才信响应里的会话；带了就以请求的为准。
+          const effectiveSid =
+            sid !== null ? sid : data !== null && typeof data === 'object' && typeof data.sessionId === 'string' ? data.sessionId : null;
+          const color = data !== null && typeof data === 'object' && data.colors && data.colors.base ? data.colors.base.favorite : null;
+          if (typeof color === 'string' && color.length > 0) favoriteTint = color;
+          favoriteSnapshot = {
+            sessionId: effectiveSid,
+            ids: ids.slice(),
+            suggested,
+            freshUntil: Date.now() + FAVORITE_SNAPSHOT_TTL_MS,
+          };
+          return favoriteSnapshot.ids;
+        } catch (error) {
+          return null;
+        } finally {
+          favoriteSnapshotPending = null;
+          favoriteSnapshotPendingSession = null;
+        }
+      })();
+      return favoriteSnapshotPending;
+    }
+
+    // 点击后同步共享快照，避免同屏其它星标（或稍后挂载的）显示旧状态。
+    function rememberFavorite(messageId, active) {
+      if (favoriteSnapshot === null) return;
+      const ids = favoriteSnapshot.ids;
+      const index = ids.indexOf(messageId);
+      if (active && index === -1) ids.push(messageId);
+      else if (!active && index !== -1) ids.splice(index, 1);
+      // 已收藏的条目不再算「推荐」（取消收藏后本回合内也不重新点亮，等下一条回复）。
+      if (active && favoriteSnapshot.suggested !== null && typeof favoriteSnapshot.suggested === 'object') {
+        delete favoriteSnapshot.suggested[messageId];
+      }
+      favoriteSnapshot.freshUntil = Date.now() + FAVORITE_SNAPSHOT_TTL_MS;
+    }
+
+    /** 查某条消息是否有推荐（当前快照会话内）；返回 {score, reason} 或 null。 */
+    function favoriteSuggestionOf(sessionId, messageId) {
+      if (favoriteSnapshot === null || messageId === null) return null;
+      if (favoriteSnapshot.sessionId !== sessionId) return null;
+      const suggested = favoriteSnapshot.suggested;
+      if (suggested === null || typeof suggested !== 'object') return null;
+      const hit = suggested[messageId];
+      return hit !== undefined && hit !== null ? hit : null;
+    }
+
+    function FavoriteStar(props) {
+      const messageId =
+        props !== null && props !== undefined && typeof props.messageId === 'string' ? props.messageId : null;
+      const sessionId =
+        props !== null && props !== undefined && typeof props.sessionId === 'string' && props.sessionId.length > 0
+          ? props.sessionId
+          : null;
+      const [active, setActive] = useState(false);
+      const [busy, setBusy] = useState(false);
+      const [tint, setTint] = useState('#F5C542');
+      const [suggested, setSuggested] = useState(null);
+
+      useEffect(() => {
+        if (messageId === null) return undefined;
+        let cancelled = false;
+        (async () => {
+          const ids = await favoriteIdsOf(sessionId);
+          if (cancelled || ids === null) return;
+          setActive(ids.includes(messageId));
+          setSuggested(favoriteSuggestionOf(sessionId, messageId));
+          setTint(favoriteTint);
+        })();
+        return () => {
+          cancelled = true;
+        };
+      }, [messageId, sessionId]);
+
+      const toggle = useCallback(async () => {
+        if (messageId === null || busy) return undefined;
+        setBusy(true);
+        try {
+          const res = await fetch('/api/compact-relay-action', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({
+              action: 'favorite-toggle',
+              messageId,
+              ...(sessionId === null ? {} : { sessionId }),
+            }),
+          });
+          const data = await res.json();
+          if (data !== null && typeof data === 'object' && typeof data.active === 'boolean') {
+            setActive(data.active);
+            if (data.active) setSuggested(null);
+            rememberFavorite(messageId, data.active);
+            return undefined;
+          }
+          // 失败要出声：宿主回「找不到这条消息（会话可能被压缩过）」等具体原因。
+          const message =
+            data !== null && typeof data === 'object' && typeof data.message === 'string' && data.message.length > 0
+              ? data.message
+              : '收藏失败：请重试';
+          favoriteNotify(message);
+          return undefined;
+        } catch (error) {
+          favoriteNotify('收藏失败：网络或宿主不可用');
+          return undefined;
+        } finally {
+          setBusy(false);
+        }
+      }, [messageId, sessionId, busy]);
+
+      if (messageId === null) return null;
+      const isSuggested = active !== true && suggested !== null;
+      const label = active
+        ? '取消收藏'
+        : isSuggested
+          ? `推荐收藏${suggested.score !== null ? `（${suggested.score} 分）` : ''}`
+          : '收藏这条';
+      return h(
+        'button',
+        {
+          type: 'button',
+          className: 'dcr-favorite-star',
+          title: label,
+          'aria-label': label,
+          'aria-pressed': active ? 'true' : 'false',
+          onClick: toggle,
+          disabled: busy,
+          style: {
+            display: 'inline-flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            width: isSuggested ? 'auto' : '28px',
+            height: '28px',
+            gap: isSuggested ? '4px' : '0',
+            padding: isSuggested ? '6px 8px 6px 6px' : '6px',
+            margin: '0',
+            border: 'none',
+            cursor: busy ? 'default' : 'pointer',
+            ...(active || isSuggested ? { color: tint } : {}),
+            opacity: busy ? 0.5 : 1,
+            borderRadius: '8px',
+            // 推荐态：金色光晕（只点亮、不自动收藏；点击仍走同一 toggle）。
+            boxShadow: isSuggested ? '0 0 0 2px rgba(245,197,66,0.9), 0 0 8px rgba(245,197,66,0.6)' : 'none',
+            animation: isSuggested ? 'dcr-favorite-pulse 2.4s ease-in-out infinite' : 'none',
+            lineHeight: 1,
+            verticalAlign: 'middle',
+          },
+        },
+        h(
+          'svg',
+          {
+            width: 16,
+            height: 16,
+            viewBox: '0 0 24 24',
+            fill: active ? 'currentColor' : 'none',
+            stroke: 'currentColor',
+            strokeWidth: active ? 0 : 1.8,
+            strokeLinejoin: 'round',
+          },
+          h('path', { d: FAVORITE_STAR_PATH }),
+        ),
+        // 推荐态：加一个金色「推荐」小标签（用户确认要提高可见度，允许轻微打断阅读）。
+        // 标签在按钮内部 —— 点击任意位置都走同一个 toggle，不新增交互面。
+        isSuggested
+          ? h(
+              'span',
+              {
+                style: {
+                  fontSize: '11px',
+                  lineHeight: '1.5',
+                  letterSpacing: '0.02em',
+                  whiteSpace: 'nowrap',
+                },
+              },
+              '推荐',
+            )
+          : null,
+      );
+    }
 
     /** 交接结果的一行式展示（放在聊天流里的 /handoff 命令卡）。 */
     function handoffRow(text, tone, action) {
@@ -5129,6 +5903,10 @@ window.__ModuleLoader__.load({
       const [nativeBusy, setNativeBusy] = useState(false);
       /** UI-003：结果提示就地显示在开关旁（以前只写页面底部，用户看不到）。 */
       const [nativeStatus, setNativeStatus] = useState(null);
+      // 0.5.3 P1-7：推荐收藏「试算」的输入与结果（只读，不写收藏）。
+      const [trialText, setTrialText] = useState('');
+      const [trialResult, setTrialResult] = useState(null);
+      const [trialBusy, setTrialBusy] = useState(false);
       /** 作者 2026-10-20：设置页「再看一次初次引导」的就地提示。 */
       const [onboardingNotice, setOnboardingNotice] = useState(null);
       const nativeConfirmRef = useRef(null);
@@ -5296,6 +6074,11 @@ window.__ModuleLoader__.load({
 
       /** 表单与已保存快照不一致 → 有未保存修改。 */
       const dirty = form !== null && savedSnapshot !== null && JSON.stringify(form) !== savedSnapshot;
+      // 0.5.3 P1-6：推荐收藏表单（旧设置 payload 可能没有 favorite 块 → 用默认值兜底，不崩）。
+      const favoriteForm =
+        form !== null && typeof form === 'object' && form.favorite !== null && form.favorite !== undefined && typeof form.favorite === 'object'
+          ? form.favorite
+          : { enabled: true, level: 'standard', mustWords: [], muteWords: [] };
 
       /**
        * 保存设置。0.4.2：body 带上 `nativeRatio`（当前模型实际触发线），
@@ -5399,6 +6182,64 @@ window.__ModuleLoader__.load({
         [nativeBusy, load],
       );
 
+      /** 0.5.3 P1-7：词表输入（逗号/空格分隔）→ 规范化数组。 */
+      const parseFavoriteWords = (text) =>
+        String(text)
+          .split(/[,，、\s]+/)
+          .map((word) => word.trim())
+          .filter((word) => word.length > 0)
+          .slice(0, 20);
+
+      /** 0.5.3 P1-7：试算——按当前表单里的档位/词表跑一次打分，只读结果。 */
+      const runTrial = useCallback(async () => {
+        if (trialBusy) return;
+        const text = trialText.trim();
+        if (text.length === 0) {
+          setTrialResult({ error: true, text: '先粘一段文本再试算' });
+          return;
+        }
+        setTrialBusy(true);
+        setTrialResult(null);
+        try {
+          // 试算需要模型路由：先取当前活会话 id（设置页不是会话作用域）。
+          const stateRes = await fetch('/api/compact-relay-state', { cache: 'no-store' });
+          const state = await stateRes.json().catch(() => ({}));
+          const sessionId = state !== null && typeof state === 'object' && typeof state.sessionId === 'string' ? state.sessionId : '';
+          if (sessionId.length === 0) throw new Error('没有活动会话，先发一条消息唤醒 agent 再试算');
+          const res = await fetch('/api/compact-relay-action', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({
+              action: 'favorite-score-trial',
+              sessionId,
+              text,
+              level: favoriteForm.level,
+              mustWords: favoriteForm.mustWords,
+              muteWords: favoriteForm.muteWords,
+            }),
+          });
+          const data = await res.json().catch(() => ({}));
+          if (!res.ok || data.ok === false) throw new Error(data && data.message ? String(data.message) : '试算失败');
+          const scoreText = typeof data.score === 'number' ? `${data.score} 分` : '没拿到分数';
+          const verdict = data.suggest === true ? '会点亮' : '不点亮';
+          const why =
+            data.decisionReason === 'mute-word'
+              ? `（命中屏蔽词「${data.matched}」）`
+              : data.decisionReason === 'must-word'
+                ? `（命中必亮词「${data.matched}」）`
+                : data.decisionReason === 'too-short'
+                  ? '（太短）'
+                  : data.decisionReason === 'unknown-score'
+                    ? '（模型没给分）'
+                    : '';
+          setTrialResult({ text: `${scoreText} → ${verdict}${why}` });
+        } catch (error) {
+          setTrialResult({ error: true, text: error && error.message ? error.message : '试算失败' });
+        } finally {
+          setTrialBusy(false);
+        }
+      }, [trialBusy, trialText, favoriteForm]);
+
       // UI-003：确认块出现时滚进视野（以前它渲染在设置页底部以外，用户以为「点了没反应」）。
       useEffect(() => {
         if (confirmNative !== null && nativeConfirmRef.current && typeof nativeConfirmRef.current.scrollIntoView === 'function') {
@@ -5570,7 +6411,7 @@ window.__ModuleLoader__.load({
         h(
           'p',
           { style: { margin: '0 0 4px', fontSize: 12, lineHeight: '18px', color: 'var(--dsw-alias-label-secondary, rgba(127,127,127,0.95))' } },
-          '功能：看上下文容量、到线提醒并帮你压缩旧会话 / 交接新会话、锁定重要消息；边界：只动本插件的压缩与交接历史，不改模型回复，也不接管 DSH 原生自动压缩（只在本页开关、改了要重启）。',
+          '功能：看上下文容量、到线提醒并帮你压缩旧会话 / 交接新会话、收藏重要回复；边界：只动本插件的压缩与交接历史，不改模型回复，也不接管 DSH 原生自动压缩（只在本页开关、改了要重启）。',
         ),
         h('p', { style: { ...settingsHintStyle, marginBottom: 10 } }, '这里改的设置立即生效，不需要重启。阈值按窗口比例算：换不同上下文窗口的模型会自动缩放。'),
         banner,
@@ -5750,6 +6591,81 @@ window.__ModuleLoader__.load({
                 ),
               ),
         ),
+        sectionHeading('推荐收藏'),
+        h(
+          'div',
+          { style: { display: 'flex', flexDirection: 'column', paddingLeft: 16, borderLeft: '1px solid var(--dsw-alias-border-l2, rgba(127,127,127,0.2))' }, 'data-cr-group': '推荐收藏' },
+          settingsRow(
+            '推荐收藏',
+            '助手回复落地后，用一个小模型打分（0-100）；够分的星标会金色微亮，提示「这条值得收藏」。',
+            '只点亮、**绝不自动收藏**；确认仍要你点星或 /favorite mark。关掉后不再打分（也就不花这份钱）。',
+            h('label', { style: { display: 'inline-flex', alignItems: 'center', gap: 6, fontSize: 12 } },
+              h('input', {
+                type: 'checkbox', 'aria-label': '开启推荐收藏', checked: favoriteForm.enabled !== false,
+                onChange: (event) => patch(['favorite', 'enabled'], event.target.checked),
+              }),
+              '开启推荐收藏',
+            ),
+          ),
+          settingsRow(
+            '推荐档位',
+            '分高才亮：宽松 60 / 标准 75 / 严格 85。',
+            '标准档每 4 条回复亮 1 次（准确率约 76%）；严格档更少但更准（约 89%）。',
+            h('select', {
+              'aria-label': '推荐档位',
+              value: favoriteForm.level ?? 'standard',
+              style: { ...settingsInputStyle, width: 120 },
+              onChange: (event) => patch(['favorite', 'level'], event.target.value),
+            },
+              h('option', { value: 'loose' }, '宽松（60）'),
+              h('option', { value: 'standard' }, '标准（75）'),
+              h('option', { value: 'strict' }, '严格（85）'),
+            ),
+          ),
+          settingsRow(
+            '必亮词',
+            '出现这些词就直接点亮，跳过打分（模型失败也亮）。',
+            '多个词用逗号或空格分隔，最多 20 个；适合「定案」「结论」这类固定说法。',
+            h('input', {
+              type: 'text', 'aria-label': '必亮词', placeholder: '例如：定案，结论，就按这个',
+              value: (favoriteForm.mustWords ?? []).join('，'),
+              style: { ...settingsInputStyle, width: '100%' },
+              onChange: (event) => patch(['favorite', 'mustWords'], parseFavoriteWords(event.target.value)),
+            }),
+          ),
+          settingsRow(
+            '屏蔽词',
+            '出现这些词就绝不点亮（优先于必亮词和分数）。',
+            '屏蔽词优先；比如「测试」「随便试试」这类不该进收藏的说法。',
+            h('input', {
+              type: 'text', 'aria-label': '屏蔽词', placeholder: '例如：测试，随便',
+              value: (favoriteForm.muteWords ?? []).join('，'),
+              style: { ...settingsInputStyle, width: '100%' },
+              onChange: (event) => patch(['favorite', 'muteWords'], parseFavoriteWords(event.target.value)),
+            }),
+          ),
+          settingsRow(
+            '试算',
+            '粘一段助手回复原文，按上面的档位/词表跑一次真实打分（只读，不写收藏）。',
+            '试算会真的调一次小模型（约 1-2 秒、少量 token）；结果只用来调档位。',
+            h('div', { style: { display: 'flex', flexDirection: 'column', gap: 6, width: '100%' } },
+              h('textarea', {
+                'aria-label': '试算文本',
+                rows: 3,
+                placeholder: '粘贴一段助手回复原文…',
+                value: trialText,
+                style: { ...settingsInputStyle, width: '100%', boxSizing: 'border-box', resize: 'vertical', minHeight: 60 },
+                onChange: (event) => setTrialText(event.target.value),
+              }),
+              h('div', { style: { display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' } },
+                h('button', { type: 'button', style: settingsButtonStyle, disabled: trialBusy, onClick: runTrial }, trialBusy ? '试算中…' : '试算'),
+                trialResult === null
+                  ? null
+                  : h('span', { style: { ...settingsHintStyle, color: trialResult.error ? 'var(--dsw-alias-state-warning-primary, #b45309)' : undefined } }, trialResult.text),
+              ),
+            ),
+          ),
+        ),
         sectionHeading('压缩行为'),
         h(
           'div',
@@ -6193,7 +7109,7 @@ window.__ModuleLoader__.load({
           h('p', { style: settingsHintStyle }, `版本：${version || '—'}`),
           h('p', { style: settingsHintStyle, 'data-cr-ledger': '1' }, ledgerLine),
           h('p', { style: settingsHintStyle }, `设置文件：${settingsPath || '—'}`),
-          h('p', { style: { ...settingsHintStyle, marginTop: 8 } }, '输入框左侧的上下文指示灯：看容量、提醒压缩/交接、锁住重要消息；到线了用 /bc 或 /handoff，重要内容用 /pin 锁住。'),
+          h('p', { style: { ...settingsHintStyle, marginTop: 8 } }, '输入框左侧的上下文指示灯：看容量、提醒压缩/交接、收藏重要回复；到线了用 /bc 或 /handoff，重要内容用 /fin 锁住。'),
           h('p', { style: settingsHintStyle }, '遇到 bug 或想提改进：走上面「帮助」里的 GitHub Issues；也欢迎直接发邮件。'),
           h('p', { style: settingsHintStyle }, '联系方式：cfanzx@136.com（合作、安全问题，以及不便公开讨论的事项）。'),
           h('p', { style: settingsHintStyle }, 'npm 包页面：https://www.npmjs.com/package/dsh-compact-relay'),
@@ -6517,6 +7433,22 @@ window.__ModuleLoader__.load({
         }
       };
 
+      // 0.6 收藏星标：挂助手消息底部动作行（宿主只对已定稿助手消息渲染）。
+      // 会话 id 必须由 slot 的 session 作用域注入，不能靠 state 接口猜「当前会话」：
+      // 多工作区同时活着时宿主会回「最后一个活 agent」的会话（2026-10-29 真机 BUG：点星静默失败）。
+      ctx.slots.inject('conversation.chat.assistant-actions', () =>
+        ctx.slots.register(
+          {
+            name: 'conversation.chat.assistant-actions',
+            id: 'compact-relay-favorite',
+            inject: (sessionId) => ({
+              sessionId: typeof sessionId === 'string' && sessionId.length > 0 ? sessionId : undefined,
+            }),
+          },
+          FavoriteStar,
+        ),
+      );
+
       ctx.slots.inject('conversation.input.left', () =>
         ctx.slots.register(
           {