dsh-global-todo 0.3.2 → 0.4.0

package/lib/client.js

@@ -50,7 +50,9 @@ window.__ModuleLoader__.load({
      * different mechanisms (restart vs. hot reload), so "which one am I looking
      * at" needs an answer that the bundle itself carries.
      */
-    const UI_REV = 'ui23'
+    const UI_REV = 'ui24'
+    /** Last language resolved for the shell; module-level so a fetch failure can be worded too. */
+    let activeLang = 'zh'
 
     // ------------------------------------------------------------------ 文案
 
@@ -79,6 +81,7 @@ window.__ModuleLoader__.load({
       'action.addLink': '挂上',
       'action.open': '打开',
       'action.copy': '复制路径',
+      'action.copyPathHint': '（点击复制路径）',
       'action.copied': '已复制',
       'action.undo': '撤销',
       'action.export': '导出',
@@ -109,6 +112,18 @@ window.__ModuleLoader__.load({
       'assign.failed': '{n} 条没分出去：{detail}',
       'autoCollect.label': '自动获取',
       'autoCollect.hint': '开启后：某个对话**安静满 {n} 分钟**（期间没有任何新发言）才自动问它一次「有没有要跟进的事」；你一边说话它一边计时重置，所以工作时不会被打扰。它问过之后，**只有你在那个对话里再说一句话**才会重新问——不会追着自己的提问反复问。关掉就完全靠你和 Agent 手动记。',
+      'autoCollect.last': '最近一次判定：{reason}（等待 {waiting} · 到点 {due}）',
+      'autoCollect.reason.off': '开关关着',
+      'autoCollect.reason.no-session': '没有会话',
+      'autoCollect.reason.no-activity': '不知道安静了多久',
+      'autoCollect.reason.exempt-workspace': '该工作区已豁免',
+      'autoCollect.reason.unknown-dir': '不知道工作目录（保守不问）',
+      'autoCollect.reason.retry-wait': '上次失败，等重试',
+      'autoCollect.reason.awaiting-human': '问过，等你说话',
+      'autoCollect.reason.not-idle-yet': '还没安静够',
+      'autoCollect.reason.cooldown': '冷却中',
+      'autoCollect.reason.ok': '可以问',
+      'autoCollect.reason.turn': '轮次没有干净结束（{kind}）',
       'notice.autoCollectOn': '已开启自动获取：一次人为发言最多自动问一次',
       'notice.autoCollectOff': '已关闭自动获取',
       'action.exempt': '豁免',
@@ -158,6 +173,7 @@ window.__ModuleLoader__.load({
       'filter.doing': '进行中',
       'filter.done': '已完成',
       'filter.overdue': '逾期',
+      'filter.label': '筛选',
       'field.title': '要做什么？回车即存',
       'field.description': '描述：验收标准、已知的坑…',
       'field.links': '相关文档与地址，一行一个（/绝对路径 或 https://…）',
@@ -176,7 +192,6 @@ window.__ModuleLoader__.load({
       'group.time': '时间',
       'group.level': '级别',
       'group.manual': '手动添加',
-      'group.conversation': '对话',
       'group.other': '其他',
       'group.items': '{n} 条',
       'group.thisConversation': '本对话',
@@ -199,6 +214,7 @@ window.__ModuleLoader__.load({
       'meta.session.live': '会话在跑',
       'meta.session.bound': '已绑定会话',
       'meta.session.noDir': '会话无工作目录',
+      'meta.session.noDirHint': '这个会话没有工作目录，agent 在里面做不了事；用「派发：开新会话」重派一次',
       'meta.dispatchFailed': '上次派发失败',
       'detail.description': '描述',
       'detail.noDescription': '没有描述。',
@@ -225,6 +241,8 @@ window.__ModuleLoader__.load({
       'meta.completed': '完成于 {when}',
       'detail.edit': '编辑',
       'error.prefix': '出错了',
+      'error.notJson': 'HTTP {status}：响应不是 JSON',
+      'boundary.error': '全局待办面板出错了：{message}',
       'counts.active': '未完成 {n}',
       'counts.overdue': '逾期 {n}',
       'counts.done': '已完成 {n}',
@@ -232,6 +250,7 @@ window.__ModuleLoader__.load({
       'loading': '载入中…',
       'deleted': '已删除「{title}」',
       'hint.keys': '快捷键：/ 搜索 · n 新建 · Esc 收起',
+      'list.truncated': '只显示前 {shown} 条，共 {matched} 条；用搜索或筛选缩小范围',
       'justNow': '刚刚',
       'minutesAgo': '{n} 分钟前',
       'hoursAgo': '{n} 小时前',
@@ -263,6 +282,7 @@ window.__ModuleLoader__.load({
       'action.addLink': 'Attach',
       'action.open': 'Open',
       'action.copy': 'Copy path',
+      'action.copyPathHint': ' (click to copy path)',
       'action.copied': 'Copied',
       'action.undo': 'Undo',
       'action.export': 'Export',
@@ -293,6 +313,18 @@ window.__ModuleLoader__.load({
       'assign.failed': '{n} could not be assigned: {detail}',
       'autoCollect.label': 'Auto-collect',
       'autoCollect.hint': 'When on: a conversation is asked once whether anything needs following up, but only after it has been **quiet for {n} minutes** — every new message restarts that clock, so a session you are working in is never interrupted. Once it has asked, only **you writing in that conversation** arms it again, so the question can never chase its own answer.',
+      'autoCollect.last': 'Last decision: {reason} (waiting {waiting}, due {due})',
+      'autoCollect.reason.off': 'the switch is off',
+      'autoCollect.reason.no-session': 'no conversation',
+      'autoCollect.reason.no-activity': 'the quiet time is unknown',
+      'autoCollect.reason.exempt-workspace': 'that workspace is exempt',
+      'autoCollect.reason.unknown-dir': 'the working directory is unknown (stays quiet)',
+      'autoCollect.reason.retry-wait': 'the last attempt failed; waiting to retry',
+      'autoCollect.reason.awaiting-human': 'asked; waiting for you to speak',
+      'autoCollect.reason.not-idle-yet': 'not quiet for long enough yet',
+      'autoCollect.reason.cooldown': 'cooling down',
+      'autoCollect.reason.ok': 'ready to ask',
+      'autoCollect.reason.turn': 'the turn did not end cleanly ({kind})',
       'notice.autoCollectOn': 'Auto-collect on: at most one question per message from you',
       'notice.autoCollectOff': 'Auto-collect off',
       'action.exempt': 'Exempt',
@@ -336,7 +368,7 @@ window.__ModuleLoader__.load({
       'dir.fromSession': '(from this conversation)',
       'dir.picked': '(chosen)',
       'meta.origin': 'from {dir}',
-      'meta.completed': '完成于 {when}',
+      'meta.completed': 'Completed {when}',
       'action.save': 'Save',
       'action.cancel': 'Cancel',
       'filter.all': 'All',
@@ -344,6 +376,7 @@ window.__ModuleLoader__.load({
       'filter.doing': 'Doing',
       'filter.done': 'Done',
       'filter.overdue': 'Overdue',
+      'filter.label': 'Filters',
       'field.title': 'What needs doing? Enter to save',
       'field.description': 'Description: acceptance, known traps…',
       'field.links': 'Documents and links, one per line (/abs/path or https://…)',
@@ -383,6 +416,7 @@ window.__ModuleLoader__.load({
       'meta.session.live': 'session running',
       'meta.session.bound': 'session bound',
       'meta.session.noDir': 'session has no directory',
+      'meta.session.noDirHint': 'This conversation has no working directory, so an agent cannot do anything in it; hand it off again with a new conversation.',
       'meta.dispatchFailed': 'last hand-off failed',
       'detail.description': 'Description',
       'detail.noDescription': 'No description.',
@@ -392,6 +426,8 @@ window.__ModuleLoader__.load({
       'detail.lastDispatch': 'Last hand-off',
       'detail.edit': 'Edit',
       'error.prefix': 'Error',
+      'error.notJson': 'HTTP {status}: the response was not JSON',
+      'boundary.error': 'The todo panel crashed: {message}',
       'counts.active': 'Open {n}',
       'counts.overdue': 'Overdue {n}',
       'counts.done': 'Done {n}',
@@ -399,10 +435,27 @@ window.__ModuleLoader__.load({
       'loading': 'Loading…',
       'deleted': 'Deleted “{title}”',
       'hint.keys': 'Keys: / search · n new · Esc collapse',
+      'list.truncated': 'Showing the first {shown} of {matched}; narrow the search or filter to see the rest',
       'justNow': 'just now',
       'minutesAgo': '{n} min ago',
       'hoursAgo': '{n} h ago',
       'daysAgo': '{n} d ago',
+      'group.conversation': 'Conversation',
+      'detail.completion': 'Completion',
+      'detail.notes': 'Progress notes',
+      'note.placeholder': 'Add a note: where this stands, what is blocking it, who needs to act',
+      'note.add': 'Add note',
+      'note.by.agent': 'Agent',
+      'note.by.human': 'You',
+      'note.none': 'No notes yet.',
+      'note.count': '{n} notes',
+      'note.latest': 'Latest: {text}',
+      'link.missing': 'File is gone (moved or deleted)',
+      'search.hint': 'Supports tag:release / is:overdue / has:link / level:p0, space-separated',
+      'completion.by.agent': 'Finished by the agent',
+      'completion.by.human': 'Finished by you',
+      'completion.auto': 'Recorded automatically when the session finished',
+      'completion.none': 'No closing summary',
     }
 
     const DICTS = { zh, en }
@@ -429,7 +482,10 @@ window.__ModuleLoader__.load({
     function resolveLang(ctx) {
       try {
         const snapshot = ctx.locale?.getLocale?.() ?? ctx.locale?.getSnapshot?.()
-        const raw = snapshot?.locale ?? snapshot?.id ?? snapshot?.language ?? snapshot?.current ?? ''
+        // LocaleSnapshot is { active, locales, revision }. The older guess looked for
+        // locale/id/language/current, so switching the language in settings never reached
+        // this panel; keep the fallbacks for a host that still answers another shape.
+        const raw = snapshot?.active ?? snapshot?.locale ?? snapshot?.id ?? snapshot?.language ?? snapshot?.current ?? ''
         const text = typeof raw === 'string' ? raw.toLowerCase() : ''
         if (text.startsWith('zh')) return 'zh'
         if (text.startsWith('en')) return 'en'
@@ -651,7 +707,7 @@ window.__ModuleLoader__.load({
         payload = await response.json()
       } catch {
         reportFailure('call', { status: response.status, reason: 'not-json', message: path })
-        throw new ApiError('internal', `HTTP ${response.status}（响应不是 JSON）`)
+        throw new ApiError('internal', translate(activeLang, 'error.notJson', { status: response.status }))
       }
       if (payload?.ok === true) return payload.data
       reportFailure('call', {
@@ -1263,6 +1319,10 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       const onPick = typeof props.onPick === 'function' ? props.onPick : () => {}
       // The note box belongs to the row that is open, so its draft lives here.
       const [noteDraft, setNoteDraft] = useState('')
+      // Opening a row near the bottom of a long list put the editor below the
+      // viewport; the click looked like it did nothing. Bring the row into view
+      // when it opens, without yanking the page when it closes.
+      const rootRef = useRef(null)
       const [linkValue, setLinkValue] = useState('')
       const [linkTitle, setLinkTitle] = useState('')
       const [draft, setDraft] = useState({
@@ -1282,6 +1342,12 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
         })
       }, [todo.id, todo.updatedAt, todo.title, todo.description, todo.dueAt, todo.priority])
 
+      useEffect(() => {
+        if (!open) return
+        const node = rootRef.current
+        if (node !== null && typeof node.scrollIntoView === 'function') node.scrollIntoView({ block: 'nearest' })
+      }, [open])
+
       const dirty =
         draft.title !== todo.title ||
         draft.description !== todo.description ||
@@ -1340,7 +1406,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
               key: 'session',
               className: stranded ? 'gt-chip-warn' : todo.sessionAlive === true ? 'gt-chip-ok' : '',
               title: stranded
-                ? '这个会话没有工作目录，agent 在里面做不了事；用「派发：开新会话」重派一次'
+                ? t('meta.session.noDirHint')
                 : (todo.sessionDir ?? ''),
             },
             stranded ? t('meta.session.noDir') : todo.sessionAlive === true ? t('meta.session.live') : t('meta.session.bound'),
@@ -1366,6 +1432,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       return h(
         'div',
         {
+          ref: rootRef,
           className: 'gt-item',
           'data-status': todo.status,
           'data-overdue': overdue ? '1' : '0',
@@ -1444,7 +1511,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                             title:
                               link.missing === true
                                 ? `${link.value} —— ${t('link.missing')}`
-                                : `${link.value}（点击复制路径）`,
+                                : `${link.value}${t('action.copyPathHint')}`,
                             onClick: () => copy(link.value),
                           },
                           h(Icon, { name: 'doc', size: 11 }),
@@ -1487,7 +1554,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                             key: `art:${index}:${link.value}`,
                             type: 'button',
                             className: 'gt-chip gt-chip-ok',
-                            title: `${link.value}（点击复制路径）`,
+                            title: `${link.value}${t('action.copyPathHint')}`,
                             onClick: () => copy(link.value),
                           },
                           h(Icon, { name: 'check', size: 11 }),
@@ -1843,7 +1910,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       const { ctx, lang } = props
       const t = useCallback((key, params) => translate(lang, key, params), [lang])
 
-      const [state, setState] = useState({ todos: [], counts: null, health: null })
+      const [state, setState] = useState({ todos: [], counts: null, health: null, matched: 0, truncated: false })
       const [loading, setLoading] = useState(true)
       const [error, setError] = useState(null)
       const [filter, setFilter] = useState('active')
@@ -2030,7 +2097,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       // say so, rather than silently displaying a different conversation as selected.
       const pinnedEntry =
         targetValue !== '' && targetValue !== 'auto' && targetValue !== 'new' && !targetValue.startsWith('new:') && !listedIds.has(targetValue)
-          ? [{ id: targetValue, title: `${sessionTitles[targetValue] ?? targetValue}（${t('target.archived')}）` }]
+          ? [{ id: targetValue, title: `${sessionTitles[targetValue] ?? targetValue} · ${t('target.archived')}` }]
           : []
       const conversations = [...pinnedEntry, ...labelled]
       const mounted = useRef(true)
@@ -2045,7 +2112,13 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
           try {
             const data = await call('list', { query: { status, ...(search.trim() === '' ? {} : { query: search.trim() }) } })
             if (!mounted.current) return
-            setState((current) => ({ ...current, todos: data.todos, counts: data.counts }))
+            setState((current) => ({
+              ...current,
+              todos: data.todos,
+              counts: data.counts,
+              matched: Number.isInteger(data.matched) ? data.matched : data.todos.length,
+              truncated: data.truncated === true,
+            }))
             setError(null)
           } catch (failure) {
             if (!mounted.current) return
@@ -2238,6 +2311,30 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       // The two toggles belong with the other "how this panel behaves" controls, not in
       // the title row.
       const settingsOn = state.health?.settings?.autoCollect === true
+      // The Host already knows why it stayed quiet; the switch's tooltip is the cheapest
+      // place to show it, and "nothing ever happens" stops being a mystery.
+      const autoCollectLast = state.health?.autoCollect?.lastDecision ?? null
+      const autoCollectWaiting = Number(state.health?.autoCollect?.waiting) || 0
+      const autoCollectDue = Number(state.health?.autoCollect?.due) || 0
+      /** Turn a reason code into the sentence a person can read. */
+      const reasonText = (code) => {
+        const text = typeof code === 'string' ? code : ''
+        const known = [
+          'off',
+          'no-session',
+          'no-activity',
+          'exempt-workspace',
+          'unknown-dir',
+          'retry-wait',
+          'awaiting-human',
+          'not-idle-yet',
+          'cooldown',
+          'ok',
+        ]
+        if (known.includes(text)) return t(`autoCollect.reason.${text}`)
+        if (text.startsWith('turn-')) return t('autoCollect.reason.turn', { kind: text.slice(5) })
+        return text
+      }
       const togglesNodes = [
         h(
           'button',
@@ -2263,7 +2360,15 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
             className: 'gt-tab',
             'data-on': settingsOn ? '1' : '0',
             'aria-pressed': settingsOn,
-            title: t('autoCollect.hint', { n: Number(state.health?.settings?.cooldownMinutes) || 30 }),
+            title:
+              t('autoCollect.hint', { n: Number(state.health?.settings?.idleMinutes) || 30 })
+              + (autoCollectLast === null
+                ? ''
+                : `\n${t('autoCollect.last', {
+                    reason: reasonText(autoCollectLast.reason),
+                    waiting: autoCollectWaiting,
+                    due: autoCollectDue,
+                  })}`),
             onClick: () => void toggleAutoCollect(!settingsOn),
           },
           t('autoCollect.label'),
@@ -2271,7 +2376,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       ]
 
       const autoCollectOn = settingsOn
-      const autoCollectCooldown = Number(state.health?.settings?.cooldownMinutes) || 30
+      const autoCollectIdle = Number(state.health?.settings?.idleMinutes) || 30
 
       /** The switch is Host state: flipping it here writes through `/settings`. */
       const toggleAutoCollect = async (next) => {
@@ -2291,7 +2396,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
           }))
           setError(null)
           setNotice({
-            text: next ? t('notice.autoCollectOn', { n: autoCollectCooldown }) : t('notice.autoCollectOff'),
+            text: next ? t('notice.autoCollectOn', { n: autoCollectIdle }) : t('notice.autoCollectOff'),
             sessionId: '',
           })
           setTimeout(() => setNotice(null), 6000)
@@ -2670,7 +2775,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
             ? h(
                 'div',
                 { className: 'gt-banner', role: 'alert' },
-                `${t('error.prefix')}：${error.message}（${error.reason ?? 'internal'}）`,
+                `${t('error.prefix')}: ${error.message} (${error.reason ?? 'internal'})`,
                 h('button', { type: 'button', className: 'gt-btn', onClick: () => void reload() }, t('action.retry')),
               )
             : null,
@@ -3043,7 +3148,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
               ? h(
                   'div',
                   { className: 'gt-empty' },
-                  h('div', { className: 'gt-empty-title' }, filter === 'active' ? t('empty.none') : t('empty.filtered')),
+                  h('div', { className: 'gt-empty-title' }, (state.counts?.total ?? 0) === 0 && query.trim() === '' ? t('empty.none') : t('empty.filtered')),
                   h('div', { className: 'gt-sub' }, t('hint.keys')),
                 )
               : h(
@@ -3142,6 +3247,14 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                   }),
                 ),
 
+          state.truncated === true
+            ? h(
+                'div',
+                { className: 'gt-sub gt-truncated' },
+                t('list.truncated', { shown: state.todos.length, matched: state.matched }),
+              )
+            : null,
+
           h(
             'div',
             { className: 'gt-foot' },
@@ -3259,6 +3372,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
      */
     function withLocale(ctx, Component) {
       return function LocaleBound(props) {
+        activeLang = resolveLang(ctx)
         const [, bump] = useState(0)
         useEffect(() => {
           const locale = ctx.locale
@@ -3323,6 +3437,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
         const { error } = this.state
         if (error !== null) {
           const message = error?.message ?? String(error)
+          const lang = this.props.componentProps?.lang ?? activeLang
           return h(
             'div',
             { className: 'gt-root' },
@@ -3332,8 +3447,8 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
               h(
                 'div',
                 { className: 'gt-banner', role: 'alert' },
-                `全局待办面板出错了：${message}`,
-                h('button', { type: 'button', className: 'gt-btn', onClick: this.retry }, '重试'),
+                translate(lang, 'boundary.error', { message }),
+                h('button', { type: 'button', className: 'gt-btn', onClick: this.retry }, translate(lang, 'action.retry')),
               ),
             ),
           )
@@ -3345,7 +3460,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
     // ------------------------------------------------------------------ apply
 
     return {
-      inject: ['sessions', 'uiWorkspace', 'workspaces', 'slots', 'locale'],
+      inject: ['sessions', 'uiWorkspace', 'slots', 'locale'],
 
       apply(ctx) {
         ctx.effect(() => ctx.locale.register(LOCALE_NS, DICTS), `${LOCALE_NS}: dictionaries`)

package/lib/index.js

@@ -25,7 +25,7 @@ import path from 'node:path'
 
 import { createCompletionWatcher } from './completion.js'
 import { createDispatcher } from './dispatch.js'
-import { createSettings, dueAutoCollect, idleSessions } from './settings.js'
+import { createSettings, explainAutoCollect, idleSessions, retryDelayMs } from './settings.js'
 import { createDiagnostics } from './diagnostics.js'
 import { createMetrics } from './metrics.js'
 import { LIMITS } from './model.js'
@@ -35,7 +35,7 @@ import { createStore, resolveStorePath } from './store.js'
 import { createTools } from './tools.js'
 
 /** Must equal `package.json`'s version; `npm run check` enforces that. */
-export const VERSION = '0.3.2'
+export const VERSION = '0.4.0'
 
 /** Plugin id. Also the Loader row id in `cordis.patch.yml`. */
 export const name = 'dsh-global-todo'
@@ -47,6 +47,10 @@ export const DEFAULTS = Object.freeze({
   activityLimit: LIMITS.activity,
   requireExistingFiles: true,
   guidance: true,
+  // Starting point for the built-in folder browser when the shell has no picker.
+  // Documented here because a patch override replaces `config` wholesale and has
+  // to restate every key it wants to keep.
+  browseRoot: '',
 })
 
 /**
@@ -169,6 +173,35 @@ export function apply(ctx, config) {
   // clock, so a session in use is never asked.
   const collectPending = {}
   const collectActivity = {}
+  // Sessions whose question failed: when the next attempt is allowed, and how many
+  // attempts have failed. Two maps because the decision layer takes timestamps only.
+  const collectRetry = {}
+  const collectAttempts = {}
+  const ASK_TIMEOUT_MS = 10_000
+  const ASK_MAX_ATTEMPTS = 3
+
+  /**
+   * Bound a promise the plugin does not control.
+   *
+   * `requestCapture` may wait on `agents.resume`, and a resume that never settles left
+   * `asking` true forever — which silences the feature for every conversation, not just
+   * the broken one.
+   */
+  const withinMs = (promise, ms) =>
+    new Promise((resolve, reject) => {
+      const timer = setTimeout(() => reject(new Error(`等待 ${Math.round(ms / 1000)} 秒没有结果`)), ms)
+      if (typeof timer.unref === 'function') timer.unref()
+      promise.then(
+        (value) => {
+          clearTimeout(timer)
+          resolve(value)
+        },
+        (error) => {
+          clearTimeout(timer)
+          reject(error)
+        },
+      )
+    })
   // When a *person* last wrote in each conversation. The question we send is a message in
   // the conversation too, and re-arming on it is exactly the loop this exists to break — so
   // only `source.kind === 'user'` counts as somebody having answered.
@@ -177,24 +210,46 @@ export function apply(ctx, config) {
   // The live lookup below is only a fallback for a conversation that has not been seen yet.
   const collectDir = {}
 
-  const askSession = (sessionId) => {
+  const askSession = async (sessionId) => {
+    if (autoCollectState.asking === true) return
     autoCollectState.asking = true
-    // Book the cooldown *before* asking: a failed question must not loop.
-    void settings
-      .rememberAsked(sessionId, Date.now())
-      .then(() => dispatcher.requestCapture({ sessionId, authoritative: true }))
-      .then((result) => {
-        autoCollectState.lastAsk = { at: Date.now(), sessionId: result?.sessionId ?? sessionId }
-        autoCollectState.error = null
-      })
-      .catch((error) => {
-        autoCollectState.error = String(error?.message ?? error)
-        logger?.warn?.(`dsh-global-todo: 自动抓取失败（${autoCollectState.error}）`)
-      })
-      .finally(() => {
-        autoCollectState.asking = false
+    autoCollectState.stats.asked += 1
+    try {
+      // Book first: a question that fails must not be repeated in a burst. The booking is
+      // released below when the question did not arrive, because a failure is not an answer.
+      await settings.rememberAsked(sessionId, Date.now())
+      const result = await withinMs(dispatcher.requestCapture({ sessionId, authoritative: true }), ASK_TIMEOUT_MS)
+      autoCollectState.lastAsk = { at: Date.now(), sessionId: result?.sessionId ?? sessionId }
+      autoCollectState.error = null
+      autoCollectState.stats.succeeded += 1
+      autoCollectState.lastRetry = null
+      delete collectRetry[sessionId]
+      delete collectAttempts[sessionId]
+      delete collectPending[sessionId]
+    } catch (error) {
+      const message = String(error?.message ?? error)
+      const attempts = (collectAttempts[sessionId] ?? 0) + 1
+      autoCollectState.error = message
+      autoCollectState.stats.failed += 1
+      // A failure is not an answer: leaving the booking behind made `awaiting-human` keep
+      // the conversation quiet until a person happened to speak again.
+      await settings.forgetAsked(sessionId).catch(() => {})
+      if (attempts >= ASK_MAX_ATTEMPTS) {
+        delete collectRetry[sessionId]
+        delete collectAttempts[sessionId]
         delete collectPending[sessionId]
-      })
+        autoCollectState.stats.dropped += 1
+        autoCollectState.lastDrop = { at: Date.now(), sessionId, attempts, error: message }
+      } else {
+        const at = Date.now()
+        collectAttempts[sessionId] = attempts
+        collectRetry[sessionId] = at + retryDelayMs(attempts)
+        autoCollectState.lastRetry = { at, sessionId, attempts, nextAt: collectRetry[sessionId] }
+      }
+      logger?.warn?.(`dsh-global-todo: 自动抓取失败（${message}），第 ${attempts} 次`)
+    } finally {
+      autoCollectState.asking = false
+    }
   }
 
   ctx.effect(() => {
@@ -266,10 +321,14 @@ export function apply(ctx, config) {
         // With the switch off there is nothing to ask for either, so the candidates are
         // dropped rather than left to fire in a burst the moment it is switched on.
         if (current.autoCollect !== true) {
-          for (const sessionId of idle) delete collectPending[sessionId]
+          for (const sessionId of idle) {
+            delete collectPending[sessionId]
+            // A retry belongs to a candidate; with the switch off there is nothing to retry.
+            delete collectRetry[sessionId]
+            delete collectAttempts[sessionId]
+          }
         }
         autoCollectState.waiting = Object.keys(collectPending).length
-        if (current.autoCollect !== true || autoCollectState.asking === true) return
         // An exemption is keyed on the working directory. What the conversation's own events
         // reported wins, because an unloaded conversation is the normal state of one that has
         // gone quiet; the agents service is only the fallback, and it answers '' for a session
@@ -278,18 +337,30 @@ export function apply(ctx, config) {
         for (const sessionId of Object.keys(collectPending)) {
           dirAt[sessionId] = collectDir[sessionId] ?? dispatcher.sessionDir(sessionId)
         }
-        const due = dueAutoCollect({
+        const decisions = explainAutoCollect({
           pending: collectPending,
           activityAt: collectActivity,
           humanAt: collectHuman,
           dirAt,
+          retryAt: collectRetry,
           settings: current,
           recentSessionId: recentSession.id,
-          now: Date.now(),
+          now,
         })
+        const due = decisions.filter((decision) => decision.ask)
         autoCollectState.waiting = Object.keys(collectPending).length
+        autoCollectState.due = due.length
+        // The reason used to be computed and dropped on the floor; keep the list so /health
+        // can answer "why was this conversation not asked?".
+        autoCollectState.decisions = decisions.slice(0, 20)
+        const shown = due[0] ?? decisions[0]
+        autoCollectState.lastDecision =
+          shown === undefined
+            ? null
+            : { at: now, sessionId: shown.sessionId, ask: shown.ask === true, reason: shown.reason, idleMs: shown.idleMs }
+        if (current.autoCollect !== true || autoCollectState.asking === true) return
         if (due.length === 0) return
-        askSession(due[0].sessionId)
+        void askSession(due[0].sessionId)
       } catch (error) {
         autoCollectState.error = String(error?.message ?? error)
       }
@@ -322,7 +393,20 @@ export function apply(ctx, config) {
   const diagnostics = createDiagnostics({ file: path.join(path.dirname(file), 'client-errors.log'), logger })
   const settingsFile = path.join(path.dirname(file), 'settings.json')
   const settings = createSettings({ file: settingsFile, logger })
-  const autoCollectState = { enabled: false, asking: false, lastAsk: null, error: null }
+  const autoCollectState = {
+    enabled: false,
+    asking: false,
+    lastAsk: null,
+    error: null,
+    waiting: 0,
+    due: 0,
+    decisions: [],
+    lastDecision: null,
+    lastRetry: null,
+    lastDrop: null,
+    // In-memory on purpose: it describes this process, not the list. Restarting resets it.
+    stats: { asked: 0, succeeded: 0, failed: 0, dropped: 0 },
+  }
   ctx.effect(() => {
     void settings.load().then((loaded) => {
       autoCollectState.enabled = loaded.autoCollect === true

package/lib/routes.js

@@ -358,6 +358,10 @@ export function createRoutes(deps) {
       // Counted once: the size feeds the metrics snapshot and the counts the panel
       // reads are the same numbers, so /health cannot contradict itself.
       const counts = await service.stats()
+      // Where the automatic-collect switch came from. `false` because nobody turned it on
+      // and `false` because the file is unreadable look identical from the panel, and the
+      // second one used to be invisible everywhere.
+      const settingsInfo = deps.settings?.info?.() ?? { file: '', at: 0, source: 'default', error: null }
       return {
         plugin: 'dsh-global-todo',
         version,
@@ -403,6 +407,11 @@ export function createRoutes(deps) {
           // The exempted workspaces, so the panel can show which conversations are out of
           // scope instead of leaving the person to guess why nothing was ever asked.
           exemptWorkspaces: deps.settings?.get?.().exemptWorkspaces ?? [],
+          // Reported so "off" can be told apart from "the file did not load".
+          file: settingsInfo.file,
+          loadedAt: settingsInfo.at,
+          loadSource: settingsInfo.source,
+          loadError: settingsInfo.error,
         },
         autoCollect: {
           // Derived from the setting, not from a copy kept elsewhere: two sources for one
@@ -411,6 +420,17 @@ export function createRoutes(deps) {
           asking: deps.autoCollect?.asking === true,
           lastAsk: deps.autoCollect?.lastAsk ?? null,
           error: deps.autoCollect?.error ?? null,
+          // Why a conversation was or was not asked. The decision used to keep the reason
+          // in a local and drop it, so this question had no answer even in the Host.
+          waiting: deps.autoCollect?.waiting ?? 0,
+          due: deps.autoCollect?.due ?? 0,
+          lastDecision: deps.autoCollect?.lastDecision ?? null,
+          decisions: deps.autoCollect?.decisions ?? [],
+          stats: deps.autoCollect?.stats ?? { asked: 0, succeeded: 0, failed: 0, dropped: 0 },
+          // Set after a failed question, so a retry in flight is visible rather than
+          // looking like the feature silently stopped.
+          lastRetry: deps.autoCollect?.lastRetry ?? null,
+          lastDrop: deps.autoCollect?.lastDrop ?? null,
         },
         // 「交给 Agent」 resolves its target from the conversation the user last
         // wrote in, so whether that feed attached is worth reporting too.