@@ -0,0 +1,144 @@
+/**
+ * 引导步骤：**数字分身监听范围**（与学习范围分开的独立一步）。
+ *
+ * ## ★★★ 为什么它是独立一步，而不是塞在「学习范围」那一步里
+ *
+ * 用户原话：「在 onboarding 也应该加一个步骤，不和学习范围放一起」。
+ *
+ * 学习范围（`sources` 那一步）与监听范围语义**相反**：
+ * · 学习范围：往回挖多少历史、只增不减；
+ * · 监听范围：盯哪些会话的**新**消息、可随时关掉。
+ *
+ * 挤在同一步里，用户会以为是一件事的两个选项。分成两步、各有各的标题与
+ * 说明，才让"学它什么"与"让它盯什么"这两个决定被分开表达。
+ *
+ * ## ★★ 候选**只有已勾进学习范围**的会话（前置防护）
+ *
+ * 「监听了但不采集」是一个能配出来的坏状态：`admit()` 判该不该回要读历史
+ * （`message_mentions`、这个会话之前的往来），所以分身会收到消息却拿不到
+ * 任何上下文，于是不回或回得离谱 —— 而用户看不出成因。
+ *
+ * 把候选限定在"上一步已勾选的会话"，那个坏状态在引导里**配不出来**。
+ * 这也是这一步必须排在 `sources` **之后**的原因：候选来自上一步的选择。
+ *
+ * ## ★ 与 `sources-step` 的 `AttentionSection` 是同一段逻辑
+ *
+ * 它原来嵌在学习范围那一步里（作为下半块）。拆成独立步骤后，那一段挪到
+ * 这里，`sources-step` 不再引用它 —— 判据只有一份，不复制。
+ */
+import { useMemo } from "react"
+import { Button, Checkbox } from "@mycontext/design"
+import type { ChannelConversationView } from "@mycontext/ipc-contract"
+import { useChannelConversations } from "../../lib/queries.js"
+import { useDynamicTranslation } from "../../lib/use-dynamic-translation.js"
+import { StepSection } from "./step-section.js"
+import type { SourcesDraft } from "./sources-step.js"
+
+export interface AttentionStepProps {
+  value: SourcesDraft
+  onChange: (next: SourcesDraft) => void
+  /**
+   * 只列这些渠道的会话（与 `SourcesStep` 同一个判据）。
+   * 候选还要再过一道"已勾进学习范围"，见下。
+   */
+  channelFilter?: ReadonlySet<string>
+}
+
+export function AttentionStep({ value, onChange, channelFilter }: AttentionStepProps) {
+  const { t } = useDynamicTranslation("onboarding")
+  const conversations = useChannelConversations(true)
+
+  /**
+   * 候选 = **已勾进学习范围**（上一步）且属于当前渠道的会话。
+   *
+   * ★ 两道过滤：先按 `channelFilter` 收窄到已连渠道（与学习范围一致），
+   * 再取其中 `conversationIds` 里有的 —— 那是"上一步选了要学的"。
+   * 没勾进学习范围的会话不该出现在这里（见文件头的前置防护）。
+   */
+  const candidates = useMemo<readonly ChannelConversationView[]>(() => {
+    const all = conversations.data?.items ?? []
+    const inChannel =
+      channelFilter === undefined
+        ? all
+        : all.filter((item) => item.channelId === undefined || channelFilter.has(item.channelId))
+    const learned = new Set(value.conversationIds)
+    return inChannel.filter((item) => learned.has(item.externalId))
+  }, [conversations.data, channelFilter, value.conversationIds])
+
+  const chosen = new Set(value.attentionConversationIds)
+  const toggle = (externalId: string): void => {
+    const next = chosen.has(externalId)
+      ? value.attentionConversationIds.filter((id) => id !== externalId)
+      : [...value.attentionConversationIds, externalId]
+    onChange({ ...value, attentionConversationIds: next })
+  }
+
+  return (
+    <StepSection
+      title={t("attentionStep.title", { defaultValue: "数字分身监听范围" })}
+      hint={t("attentionStep.hint", {
+        defaultValue:
+          "分身只处理这些会话从现在起的新消息。与上一步的学习范围不同：它不看历史，也可以随时关掉。",
+      })}
+      action={
+        value.attentionConversationIds.length > 0 ? (
+          <span className="flex items-center gap-2">
+            <span className="typography-caption-400 text-[var(--text-base-tertiary)]">
+              {t("attentionStep.selected", {
+                defaultValue: "盯 {{count}} 个会话",
+                count: value.attentionConversationIds.length,
+              })}
+            </span>
+            <Button
+              size="sm"
+              variant="ghost"
+              onClick={() => onChange({ ...value, attentionConversationIds: [] })}
+            >
+              {t("attentionStep.clear", { defaultValue: "取消全部监听" })}
+            </Button>
+          </span>
+        ) : undefined
+      }
+    >
+      {candidates.length === 0 ? (
+        /**
+         * ★ 候选为空时说清**为什么**，而不是给一个空列表。
+         * 空列表读起来像"坏了"，而真相是"回上一步勾几个会话" ——
+         * 那是一个用户能立刻执行的动作。
+         */
+        <p className="typography-body-small-400 text-[var(--text-base-tertiary)]">
+          {t("attentionStep.empty", {
+            defaultValue:
+              "上一步还没勾选要学习的会话 —— 先选好学习范围，再从中挑出让分身盯着的那些。",
+          })}
+        </p>
+      ) : (
+        <div className="flex flex-col gap-2">
+          {/*
+            ★★ 「不勾任何一个」是一个**有意义**的选择，必须说出来。
+
+            存量行为是"名单为空 → 全部放行"（迁移期的正确一侧，见
+            `AttentionRouter.route`）。所以不勾 = 分身盯所有已学习的会话。
+            不说这句，用户以为"不勾就是不启用"，而事实相反。
+          */}
+          <p className="typography-caption-400 text-[var(--text-base-tertiary)]">
+            {t("attentionStep.emptyMeaning", {
+              defaultValue: "一个都不勾 = 分身会盯上一步所有已勾选的会话（可稍后在设置里收窄）。",
+            })}
+          </p>
+          <ul className="flex flex-col gap-1">
+            {candidates.map((item) => (
+              <li key={item.externalId}>
+                <Checkbox
+                  checked={chosen.has(item.externalId)}
+                  onChange={() => toggle(item.externalId)}
+                  label={item.title ?? item.externalId.slice(0, 8)}
+                />
+              </li>
+            ))}
+          </ul>
+        </div>
+      )}
+    </StepSection>
+  )
+}
@@ -39,6 +39,7 @@ import {
   useIngestSnapshot,
   useOnboardingSteps,
   useSaveDistillSource,
+  useSaveAttentionScope,
   usePersonaSnapshot,
   useSkipOnboarding,
   useSkipStep,
@@ -53,6 +54,7 @@ import { readPersonaIdentity } from "../persona/persona-identity.js"
 import { DistillStep } from "./distill-step.js"
 import { PersonaStep, type PersonaDraft } from "./persona-step.js"
 import { SourcesStep, type SourcesDraft } from "./sources-step.js"
+import { AttentionStep } from "./attention-step.js"
 import { ModelConfigForm } from "../settings/model-config-form.js"
 import { canRunPersona, personaCapableChannels } from "../../lib/channel-capability.js"
 import { ChannelPicker } from "../shell/channel-picker.js"
@@ -62,15 +64,17 @@ const STEP_ORDER: readonly OnboardingStepId[] = [
   "model",
   "persona",
   "sources",
+  "attention",
   "distill",
 ]
 
-/** 各步是否已实装。五步都通了（第 5 步是真进度，不是占位）。 */
+/** 各步是否已实装。 */
 const IMPLEMENTED: Record<OnboardingStepId, boolean> = {
   channel: true,
   model: true,
   persona: true,
   sources: true,
+  attention: true,
   distill: true,
 }
 
@@ -80,6 +84,19 @@ const DEFAULT_SOURCES: SourcesDraft = {
   conversationIds: [],
   // 缺省只勾**已接入**的两个：勾上未接入的等于给一个不会兑现的承诺
   enabledSources: ["chat", "minutes"],
+  /**
+   * ★★ 缺省**不勾任何监听会话**，而它的含义是"盯全部已学习的会话"。
+   *
+   * 判据在 `AttentionRouter.route()`：名单为空 → 放行（迁移期的正确一侧，
+   * 否则存量用户的分身会整个静默）。所以这个空数组不是"关掉分身"，
+   * 而是"不收窄"—— 界面上必须把这句话说出来（见 `AttentionSection` 里那段
+   * `attentionEmptyMeaning`），否则用户会以为不勾就等于不启用。
+   *
+   * ★ 为什么不缺省勾全部：那样保存时会写一份**具体的**名单进
+   * `attention_scope`，而 `enabled_at` 只能变早、名单只增 ——
+   * 等于替用户做了一个比"不收窄"更难撤回的决定。
+   */
+  attentionConversationIds: [],
 }
 
 /**
@@ -120,6 +137,8 @@ function readSources(row: OnboardingStepView | undefined): SourcesDraft {
     chatKinds?: unknown
     conversationIds?: unknown
     enabledSources?: unknown
+    /** 监听会话（v29 这一轮新加；旧 payload 里没有 → `strings()` 给空数组） */
+    attentionConversationIds?: unknown
   }
   const strings = (value: unknown): string[] =>
     Array.isArray(value) ? value.filter((item): item is string => typeof item === "string") : []
@@ -151,6 +170,12 @@ function readSources(row: OnboardingStepView | undefined): SourcesDraft {
     ),
     conversationIds: strings(record.conversationIds),
     enabledSources: strings(record.enabledSources) as DistillSourceId[],
+    /**
+     * ★ 回填监听勾选。旧的 payload 里没有这个键 → 空数组（= 不收窄），
+     * 与 `DEFAULT_SOURCES` 一致。给一个"全选"会让重进引导时凭空多出一批
+     * 监听会话，而用户没有做过那个选择。
+     */
+    attentionConversationIds: strings(record.attentionConversationIds),
   }
 }
 
@@ -185,6 +210,8 @@ export function OnboardingView() {
   const completeStep = useCompleteStep()
   const skipStep = useSkipStep()
   const saveSource = useSaveDistillSource()
+  /** 监听范围（分身盯哪些会话的新消息）。见 `advance()` 里那段顺序注释。 */
+  const saveAttention = useSaveAttentionScope()
   const complete = useCompleteOnboarding()
   const skip = useSkipOnboarding()
   /** 只为拿 `agentAvailable`（是否配了模型）—— 第 4 步要据此提前提示。 */
@@ -515,6 +542,48 @@ export function OnboardingView() {
         }
       }
       completeStep.mutate({ step: "sources", payload: sources })
+    } else if (activeId === "attention") {
+      /**
+       * ★★★ 监听范围：**独立一步**保存（不再夹在 sources 分支里）。
+       *
+       * ## 顺序仍然重要：attention 排在 sources 之后
+       *
+       * `attentionScopeSave` 会把勾中的会话**并入学习范围的白名单**
+       * （`source: 'learning'`）—— 消灭"监听了但不采集"这个坏状态（分身收到
+       * 消息却拿不到上下文，于是不回或回得离谱，而用户看不出成因）。
+       *
+       * 步骤顺序保证了 sources 的 `saveSource` 已经先跑过（上一步），
+       * 所以这里的并入不会被它覆盖。
+       *
+       * ## ★★ 空数组时**不调**这个接口
+       *
+       * 契约要求 `conversationExternalIds` 至少一个（`.min(1)`）。
+       * 语义上空 = "不收窄"（名单为空 → 路由放行全部）。调一次空的保存
+       * 既会报错，也会让人以为"存了一个空名单"（而表本就是空的）。
+       *
+       * ## ★ 按渠道分桶
+       *
+       * `attention_scope` 是 per-channel 表，勾选列表混着多个渠道。整批塞给
+       * 一个渠道 = 写进一批**不存在的 id**，路由永远命中不了且不报错。
+       */
+      if (sources.attentionConversationIds.length > 0) {
+        const channelOf = new Map(
+          (conversationList.data?.items ?? []).map((item) => [item.externalId, item.channelId]),
+        )
+        const attentionBuckets = new Map<string, string[]>()
+        for (const id of sources.attentionConversationIds) {
+          const channelId = channelOf.get(id) ?? PRIMARY_CHANNEL_ID
+          attentionBuckets.set(channelId, [...(attentionBuckets.get(channelId) ?? []), id])
+        }
+        for (const [channelId, ids] of attentionBuckets) {
+          /**
+           * ★ 不传 `enabledAt` —— 让**主进程的时钟**决定"从现在开始"
+           * （见 `attentionScopeSave` 的注释）。
+           */
+          saveAttention.mutate({ channelId, conversationExternalIds: ids })
+        }
+      }
+      completeStep.mutate({ step: "attention", payload: { ids: sources.attentionConversationIds } })
     } else if (activeId === "channel") {
       completeStep.mutate({ step: "channel" })
     } else if (activeId === "model") {
@@ -793,6 +862,19 @@ export function OnboardingView() {
               />
             ) : null}
 
+            {activeId === "attention" ? (
+              /**
+               * ★ 独立步骤：分身监听范围。候选来自上一步（sources）的勾选 ——
+               * 所以 `value` 就是同一份 `sources` 草稿（它带 `conversationIds`
+               * 与 `attentionConversationIds`）。`channelFilter` 与上一步一致。
+               */
+              <AttentionStep
+                value={sources}
+                onChange={setSources}
+                channelFilter={authorizedChannelIds}
+              />
+            ) : null}
+
             {activeId === "distill" ? (
               <DistillStep
                 rangeDays={sources.rangeDays}
 
@@ -100,6 +100,36 @@ export interface SourcesDraft {
   conversationIds: string[]
   /** 勾选了哪些资料源 */
   enabledSources: DistillSourceId[]
+  /**
+   * ── 数字分身的**监听范围** ────────────────────────────────────
+   *
+   * ## ★★★ 为什么它必须在这一步，而不是另开一步或只留在设置页
+   *
+   * 改动前监听范围**只在运行状态页能配**。于是走完引导的用户
+   * `attention_scope` 是空表 → 路由走"名单为空则放行"那一档
+   * → 分身对**所有**会话的新消息起草。那不是用户选的，是缺省值替他选的。
+   *
+   * 而它与上面的学习范围是**同一个决定的两面**（"学它什么" / "让它盯什么"），
+   * 所以放在同一步、上下两块：
+   *
+   * · 另开一步的话，用户要对着同一份会话列表勾第二遍，而两次勾选不一致时
+   *   没人知道哪个对；
+   * · 只留在设置页的话，绝大多数用户永远不会去配它。
+   *
+   * ## ★★ 与 `conversationIds`（学习范围）的三处**刻意不同**
+   *
+   * | | 学习范围 | 监听范围 |
+   * |---|---|---|
+   * | 管什么 | 往回挖多少历史 | 盯哪些会话的**新**消息 |
+   * | 时间 | `since` 往回 | `enabledAt` 从保存那刻往后 |
+   * | 能不能收回 | **不能**（图谱已消费） | **能**（不存历史，关掉无副作用） |
+   *
+   * ★ 勾这里会**自动并入**学习范围（`attentionScopeSave` 那侧做的）：
+   * 「监听了但不采集」是一个能配出来的坏状态 —— 分身收到消息却拿不到上下文
+   * （`admit()` 要读 `message_mentions` 与这个会话之前的往来），
+   * 于是它不回或回得离谱，而用户完全看不出成因。
+   */
+  attentionConversationIds: string[]
 }
 
 export interface SourcesStepProps {
@@ -490,7 +520,15 @@ export function SourcesStep({
         )}
       </StepSection>
 
-      {/* 资料源勾选 */}
+      {/*
+        ★★ 监听范围**不再**在这一步了（拆成了独立的引导步骤 `attention`）。
+
+        用户原话：「在 onboarding 也应该加一个步骤，不和学习范围放一起」。
+        它原来作为这一步的下半块 —— 而学习范围（只增不减）与监听范围
+        （可随时关掉）语义相反，同屏会让用户以为是一件事。现在它是
+        `AttentionStep`（独立组件），排在本步之后（候选来自本步的勾选）。
+      */}
+
       <StepSection
         title={t("sourcesStep.sectionSources")}
         hint={t("sourcesStep.sectionSourcesHint")}
 
@@ -51,6 +51,7 @@ import { useDynamicTranslation } from "../../lib/use-dynamic-translation.js"
 import { personaCapableChannels } from "../../lib/channel-capability.js"
 import { ChannelPicker } from "../shell/channel-picker.js"
 import { CollectionScopePanel } from "../shell/collection-scope-panel.js"
+import { AttentionScopePanel } from "../shell/attention-scope-panel.js"
 import { KlPanel } from "../shell/status-panel.js"
 import { IngestIntervalsPanel } from "./ingest-intervals-panel.js"
 
@@ -1065,9 +1066,17 @@ function ChannelsSection({
             </p>
           ) : tab === "collect" ? (
             <>
-              {/* ① 采什么 —— 按渠道 */}
+              {/* ① 学它哪些历史 —— 按渠道，只增不减 */}
               <CollectionScopePanel channelId={activeChannel.id} />
-              {/* ② 多久采一次 —— **全局**，见本组件文件头那段 */}
+              {/*
+                ② 分身盯哪些实时消息 —— **独立一张卡**，与学习范围平级。
+
+                用户原话：「不应该放在学习范围钉钉里，放在独立的…一个部分」。
+                它与学习范围语义相反（只增不减 vs 可随时关掉），塞在同一张卡里
+                会让"学历史"与"盯实时"混成一件事。`standalone` 让它自带卡壳。
+              */}
+              <AttentionScopePanel channelId={activeChannel.id} standalone />
+              {/* ③ 多久采一次 —— **全局**，见本组件文件头那段 */}
               <IngestIntervalsPanel />
               <p className="typography-caption-400 text-[var(--text-base-tertiary)]">
                 {t("channelData.intervalsGlobalNote")}