dsh-global-todo 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.2] — 2026-10-19
+
+Three things the leaders in this category do that we did not.
+
+- **Deadlines now say something.** A 30-second host sweep finds active records whose `dueAt` has
+  passed and that were not announced yet; the panel shows a due bar, clicking an item opens it,
+  and acknowledging clears it. The announced set lives in memory, so a restart re-announces an
+  unacknowledged deadline once — the offline catch-up a reminder should have. A postponed
+  deadline is a new reminder; an announced one stays quiet.
+- **Readable numbers: `#42`.** Records get a stable, human-facing sequence number assigned on
+  create and backfilled in creation order for legacy files; deleting #1 does not renumber #2. It
+  shows in the panel meta, in tool output and in the list line, so "把 #42 交给 Agent" means the
+  same thing to both sides.
+- **Import previews before writing.** The panel runs a dry run first and shows 新增/更新 counts
+  with a confirm button; a wrong file can no longer overwrite by mis-click. The preview is also
+  available as `dryRun` on the route.
+## [0.5.1] — 2026-10-19
+
+The last two loose ends from the D4 audit.
+
+- **The idle window is editable where the switch is.** It was already in the settings file and
+  the API; now the panel has a number field next to 自动获取, writing on blur so typing 1 on the
+  way to 120 does not save 1.
+- **The inbox can be worked in batches.** In the inbox view, the selection bar offers 确认
+  (removes the inbox mark) and 丢弃 (archives and removes it) instead of complete/archive, which
+  do not mean anything for records nobody has confirmed yet.
 ## [0.5.0] — 2026-10-19
 
 The last two pieces of the automatic-capture plan: an external door, and somewhere for its

package/README.md

@@ -244,7 +244,8 @@ fence when that service is present, and by a strict loopback check otherwise.
 | GET | `/api/global-todo/dirs` | `path?` — list subdirectories for the panel's built-in folder picker (the shell's own picker is preferred when mounted) |
 | GET | `/api/global-todo/get` | `id` |
 | GET | `/api/global-todo/export` | — (the store's own JSON document, for backup or migration) |
-| POST | `/api/global-todo/import` | `{ doc, mode?: replace\|merge }` — `replace` is an exact round trip, `merge` updates by id and appends (what the panel sends) |
+| POST | `/api/global-todo/import` | `{ doc, mode?: replace\|merge, dryRun? }` — `replace` is an exact round trip, `merge` updates by id and appends (what the panel sends); `dryRun` returns `wouldCreate` / `wouldUpdate` and writes nothing |
+| POST | `/api/global-todo/reminders/ack` | `{ ids }` — stop listing these passed deadlines as due |
 | POST | `/api/global-todo/capture` | `{ sessionId? }` — ask the current conversation to collect its follow-ups |
 | POST | `/api/global-todo/bulk` | `{ ids, status?, addTags?, removeTags? }` — one change across a selection; a stale id lands in `unmatched` instead of failing the batch |
 | POST | `/api/global-todo/ingest` | `{ items: [{ title, source: { kind }, confidence }], dryRun? }` with `Authorization: Bearer <settings.ingestToken>` — external items; below `ingestConfirmBelow` they wait in the inbox |

package/README.zh.md

@@ -140,7 +140,8 @@ dsh plugin --profile web remove dsh-global-todo
 | GET | `/api/global-todo/dirs` | `path?`——列子目录，供面板内置的目录浏览器使用（宿主自己的选择器在时会优先） |
 | GET | `/api/global-todo/get` | `id` |
 | GET | `/api/global-todo/export` | ——（存储用的那份 JSON 文档，用于备份或迁移） |
-| POST | `/api/global-todo/import` | `{ doc, mode?: replace\|merge }`——`replace` 是无损往返，`merge` 同 id 覆盖、新 id 追加（面板用的是这个） |
+| POST | `/api/global-todo/import` | `{ doc, mode?: replace\|merge, dryRun? }`——`replace` 是无损往返，`merge` 同 id 覆盖、新 id 追加（面板用的是这个）；`dryRun` 只返回 `wouldCreate` / `wouldUpdate`，不落盘 |
+| POST | `/api/global-todo/reminders/ack` | `{ ids }`——这些已到期的提醒不再列出来 |
 | POST | `/api/global-todo/note` | `{ id, text }`（追加进展记录） |
 | POST | `/api/global-todo/capture` | `{ sessionId? }`（请当前对话把要跟进的事抓进清单） |
 | POST | `/api/global-todo/bulk` | `{ ids, status?, addTags?, removeTags? }`——一次改一整批；失效的 id 进 `unmatched`，不会让整批失败 |

package/lib/client.js

@@ -50,7 +50,7 @@ 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 = 'ui31'
+    const UI_REV = 'ui33'
     /** Last language resolved for the shell; module-level so a fetch failure can be worded too. */
     let activeLang = 'zh'
 
@@ -119,6 +119,7 @@ window.__ModuleLoader__.load({
       'assign.ask': '这 {n} 条找不到原对话，也没有同工作区的对话：选一个目标一起分配。',
       'assign.failed': '{n} 条没分出去：{detail}',
       'autoCollect.label': '自动获取',
+      'autoCollect.idle': '安静窗口（分钟）',
       'autoCollect.hint': '开启后：某个对话**安静满 {n} 分钟**（期间没有任何新发言）才自动问它一次「有没有要跟进的事」；你一边说话它一边计时重置，所以工作时不会被打扰。它问过之后，**只有你在那个对话里再说一句话**才会重新问——不会追着自己的提问反复问。关掉就完全靠你和 Agent 手动记。',
       'autoCollect.last': '最近一次判定：{reason}（等待 {waiting} · 到点 {due}）',
       'autoCollect.reason.off': '开关关着',
@@ -135,6 +136,11 @@ window.__ModuleLoader__.load({
       'notice.autoCollectOn': '已开启自动获取：一次人为发言最多自动问一次',
       'notice.autoCollectOff': '已关闭自动获取',
       'notice.externalChange': '清单在别处被改过，已载入最新内容',
+      'reminder.title': '到点提醒（{n}）',
+      'reminder.dismiss': '知道了',
+      'import.preview': '将导入 {total} 条：新增 {create}、更新 {update}',
+      'import.confirm': '导入',
+      'meta.seqHint': '给人看的编号',
       'action.exempt': '豁免',
       'action.exemptOn': '已豁免',
       'action.exemptHint': '这个工作区里的对话永不自动获取（再点一下取消）',
@@ -334,6 +340,7 @@ window.__ModuleLoader__.load({
       'assign.ask': '{n} of them have no origin and no same-workspace conversation: pick one target for those.',
       'assign.failed': '{n} could not be assigned: {detail}',
       'autoCollect.label': 'Auto-collect',
+      'autoCollect.idle': 'Idle window (minutes)',
       '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',
@@ -350,6 +357,11 @@ window.__ModuleLoader__.load({
       'notice.autoCollectOn': 'Auto-collect on: at most one question per message from you',
       'notice.autoCollectOff': 'Auto-collect off',
       'notice.externalChange': 'The list changed somewhere else; the latest content is loaded',
+      'reminder.title': 'Due now ({n})',
+      'reminder.dismiss': 'Dismiss',
+      'import.preview': 'Will import {total}: {create} new, {update} updated',
+      'import.confirm': 'Import',
+      'meta.seqHint': 'Human-facing number',
       'action.exempt': 'Exempt',
       'action.exemptOn': 'Exempted',
       'action.exemptHint': 'Never auto-collect in this workspace (click again to undo)',
@@ -992,6 +1004,16 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
   border: 1px solid var(--dsw-alias-brand-primary); border-radius: 9px; background: var(--dsw-alias-bg-layer-1); font-size: 12.5px; }
 .gt-item-body { flex: 1; display: flex; flex-direction: column; gap: 5px; min-width: 0; }
 .gt-item-title { font-weight: 600; font-size: 13.5px; word-break: break-word; line-height: 1.45; }
+.gt-input-xs { width: 68px; padding: 3px 6px; font-size: 12px; }
+.gt-seq { font-variant-numeric: tabular-nums; color: var(--dsw-alias-label-secondary); }
+.gt-reminders { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; padding: 8px 10px;
+  border: 1px solid var(--dsw-alias-state-warn-primary); border-radius: 10px;
+  background: var(--dsw-alias-bg-layer-1); font-size: 12.5px; }
+.gt-reminders-title { color: var(--dsw-alias-state-warn-primary); font-weight: 600; }
+.gt-reminder-item { border: 1px solid var(--dsw-alias-border-l1); background: var(--dsw-alias-bg-layer-2);
+  color: var(--dsw-alias-label-primary); font: inherit; font-size: 12.5px; padding: 3px 8px;
+  border-radius: 999px; cursor: pointer; max-width: 260px; overflow: hidden; text-overflow: ellipsis;
+  white-space: nowrap; }
 .gt-inbox { margin-left: 6px; padding: 1px 6px; border-radius: 999px; font-size: 10.5px; font-weight: 600;
   color: var(--dsw-alias-state-warn-primary); border: 1px solid var(--dsw-alias-state-warn-primary);
   vertical-align: 1px; }
@@ -1409,6 +1431,9 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
         draft.due !== toLocalInput(todo.dueAt)
 
       const meta = []
+      if (Number.isInteger(todo.seq) && todo.seq > 0) {
+        meta.push(h('span', { key: 'seq', className: 'gt-seq', title: t('meta.seqHint') }, `#${todo.seq}`))
+      }
       meta.push(
         h('span', { key: 'added', title: new Date(todo.createdAt).toLocaleString() }, `${t('meta.added')} ${absoluteTime(todo.createdAt)}（${ageText(lang, todo.createdAt, now)}）`),
       )
@@ -2014,6 +2039,9 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       const [bulkTag, setBulkTag] = useState('')
       const [assignBusy, setAssignBusy] = useState(false)
       const [assignAsk, setAssignAsk] = useState(null)
+      // A picked file is previewed first: a merge is not undoable, and "did I pick the right
+      // export" is exactly the kind of question a dry run answers before anything changes.
+      const [importAsk, setImportAsk] = useState(null)
       const [groupMode, setGroupMode] = useState(() => readStoredGroupMode())
       // A notice may carry an action: after a hand-off the useful next step is
       // to go and look at the conversation the work is actually in.
@@ -2501,6 +2529,23 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
           },
           t('autoCollect.label'),
         ),
+        // The idle window is a number, not a switch: expose it where the switch lives and
+        // write on blur, so typing "1" on the way to "120" does not save 1.
+        h('input', {
+          key: 'idle',
+          type: 'number',
+          min: 5,
+          max: 1440,
+          className: 'gt-input gt-input-xs',
+          defaultValue: Number(state.health?.settings?.idleMinutes) || 30,
+          title: t('autoCollect.idle'),
+          'aria-label': t('autoCollect.idle'),
+          onBlur: (event) => {
+            const next = Number(event.target.value)
+            if (!Number.isInteger(next) || next < 5 || next > 1440) return
+            void call('settings', { method: 'POST', body: { idleMinutes: next } }).then(() => refreshHealth())
+          },
+        }),
       ]
 
       const autoCollectOn = settingsOn
@@ -2660,17 +2705,31 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
           } catch {
             throw new Error(t('import.badJson'))
           }
-          const data = await call('import', { method: 'POST', body: { doc: parsed, mode: 'merge' } })
+          const preview = await call('import', { method: 'POST', body: { doc: parsed, mode: 'merge', dryRun: true } })
+          setError(null)
+          setImportAsk({ doc: parsed, summary: preview })
+        } catch (failure) {
+          reportFailure('import', { message: failure?.message })
+          setError(failure)
+        } finally {
+          if (input !== undefined && input !== null) input.value = ''
+        }
+      }
+
+      /** The bar from the dry run: this is the step that actually writes. */
+      const confirmImport = async () => {
+        if (importAsk === null) return
+        try {
+          const data = await call('import', { method: 'POST', body: { doc: importAsk.doc, mode: 'merge' } })
           setError(null)
           setNotice({ text: t('notice.imported', { n: data?.imported ?? 0, total: data?.total ?? 0 }), sessionId: '' })
           setTimeout(() => setNotice(null), 6000)
+          setImportAsk(null)
           void reload()
           void refreshHealth()
         } catch (failure) {
           reportFailure('import', { message: failure?.message })
           setError(failure)
-        } finally {
-          if (input !== undefined && input !== null) input.value = ''
         }
       }
 
@@ -2804,6 +2863,17 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
         return undefined
       }
 
+      /** Acknowledge reminders so the host stops listing them. */
+      const ackReminders = async (ids) => {
+        try {
+          await call('reminders/ack', { method: 'POST', body: { ids } })
+          await refreshHealth()
+        } catch (failure) {
+          reportFailure('reminders', { message: failure?.message })
+          setError(failure)
+        }
+      }
+
       /** Apply one change to the whole selection; a stale id is reported, not fatal. */
       const runBulk = async (change) => {
         const ids = Object.keys(selected)
@@ -2830,6 +2900,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       }
 
       const counts = state.counts ?? { total: 0, open: 0, doing: 0, done: 0, cancelled: 0, archived: 0, overdue: 0, inbox: 0 }
+      const remindersDue = Array.isArray(state.health?.reminders?.due) ? state.health.reminders.due : []
       const groups = useMemo(
         () => groupTodos(state.todos, Date.now(), groupMode, sessionTitles, t),
         [state.todos, groupMode, sessionTitles, lang],
@@ -3299,6 +3370,32 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                   },
                   t('select.archive'),
                 ),
+                // In the inbox view the useful batch actions are confirm and discard, not
+                // complete: nothing here is done yet.
+                filter === 'inbox'
+                  ? h(
+                      'button',
+                      {
+                        type: 'button',
+                        className: 'gt-btn gt-btn-quiet',
+                        disabled: Object.keys(selected).length === 0,
+                        onClick: () => void runBulk({ removeTags: ['inbox'] }),
+                      },
+                      t('action.confirm'),
+                    )
+                  : null,
+                filter === 'inbox'
+                  ? h(
+                      'button',
+                      {
+                        type: 'button',
+                        className: 'gt-btn gt-btn-quiet',
+                        disabled: Object.keys(selected).length === 0,
+                        onClick: () => void runBulk({ status: 'archived', removeTags: ['inbox'] }),
+                      },
+                      t('action.discard'),
+                    )
+                  : null,
                 h('input', {
                   className: 'gt-input gt-bulk-tag',
                   value: bulkTag,
@@ -3341,6 +3438,37 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
               )
             : null,
 
+          // Deadlines that passed. The host announces each one once; acknowledging here is
+          // what stops it listing them on the next poll.
+          remindersDue.length === 0
+            ? null
+            : h(
+                'div',
+                { className: 'gt-reminders', role: 'status' },
+                h('span', { className: 'gt-reminders-title' }, t('reminder.title', { n: remindersDue.length })),
+                ...remindersDue.slice(0, 3).map((item) =>
+                  h(
+                    'button',
+                    {
+                      key: item.id,
+                      type: 'button',
+                      className: 'gt-reminder-item',
+                      title: item.title,
+                      onClick: () => {
+                        void ackReminders([item.id])
+                        setExpandedId(item.id)
+                      },
+                    },
+                    `${item.seq > 0 ? `#${item.seq} ` : ''}${item.title}`,
+                  ),
+                ),
+                h(
+                  'button',
+                  { type: 'button', className: 'gt-btn gt-btn-quiet', onClick: () => void ackReminders(remindersDue.map((item) => item.id)) },
+                  t('reminder.dismiss'),
+                ),
+              ),
+
           // Nothing could be worked out for these: the user picks one target for them
           // rather than having them sent somewhere nobody chose.
           assignAsk === null
@@ -3366,6 +3494,32 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                 ),
               ),
 
+          importAsk === null
+            ? null
+            : h(
+                'div',
+                { className: 'gt-selectbar' },
+                h(
+                  'span',
+                  null,
+                  t('import.preview', {
+                    total: importAsk.summary?.wouldImport ?? 0,
+                    create: importAsk.summary?.wouldCreate ?? 0,
+                    update: importAsk.summary?.wouldUpdate ?? 0,
+                  }),
+                ),
+                h(
+                  'button',
+                  { type: 'button', className: 'gt-btn gt-btn-brand', onClick: () => void confirmImport() },
+                  t('import.confirm'),
+                ),
+                h(
+                  'button',
+                  { type: 'button', className: 'gt-btn gt-btn-quiet', onClick: () => setImportAsk(null) },
+                  t('select.clear'),
+                ),
+              ),
+
           loading && state.todos.length === 0
             ? h('div', { className: 'gt-empty' }, t('loading'))
             : state.todos.length === 0

package/lib/index.js

@@ -28,6 +28,7 @@ import { createDispatcher } from './dispatch.js'
 import { createSettings, explainAutoCollect, idleSessions, retryDelayMs } from './settings.js'
 import { createDiagnostics } from './diagnostics.js'
 import { createMetrics } from './metrics.js'
+import { dueReminders } from './reminders.js'
 import { LIMITS } from './model.js'
 import { ROUTE_BASE, createRoutes } from './routes.js'
 import { createService } from './service.js'
@@ -35,7 +36,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.5.0'
+export const VERSION = '0.5.2'
 
 /** Plugin id. Also the Loader row id in `cordis.patch.yml`. */
 export const name = 'dsh-global-todo'
@@ -410,6 +411,29 @@ 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 })
+  // Deadlines that have passed and were not announced yet. In memory on purpose: a restart
+  // re-announces an unacknowledged deadline once, which is the offline catch-up a reminder
+  // is supposed to have.
+  const reminderState = { due: [], reminded: {} }
+  ctx.effect(() => {
+    const tick = async () => {
+      try {
+        const { todos } = await service.list({ status: 'active' })
+        const due = dueReminders(todos, { now: Date.now(), reminded: reminderState.reminded })
+        if (due.length === 0) return
+        for (const item of due) reminderState.reminded[item.id] = item.dueAt
+        const known = new Set(reminderState.due.map((item) => item.id))
+        reminderState.due = [...reminderState.due, ...due.filter((item) => !known.has(item.id))]
+      } catch (error) {
+        logger?.warn?.(`dsh-global-todo: reminder sweep failed: ${error?.message ?? error}`)
+      }
+    }
+    void tick()
+    if (typeof setInterval !== 'function') return () => {}
+    const timer = setInterval(() => void tick(), 30_000)
+    if (typeof timer.unref === 'function') timer.unref()
+    return () => clearInterval(timer)
+  }, 'dsh-global-todo: due reminders')
   const autoCollectState = {
     enabled: false,
     asking: false,
@@ -488,6 +512,7 @@ export function apply(ctx, config) {
         target: recentSession,
         settings,
         autoCollect: autoCollectState,
+        reminders: reminderState,
         version: VERSION,
       })
       const disposers = routes.map((definition) => webCtx.webServer.register(definition))

package/lib/model.js

@@ -278,6 +278,9 @@ export function normalizeStored(raw, options = {}) {
 
   const todo = {
     id,
+    // Human-facing number ("把 #42 交给 Agent"). Assigned by the store from creation
+    // order; 0 means "not assigned yet" and is filled in on the next read.
+    seq: Number.isInteger(raw.seq) && raw.seq > 0 ? raw.seq : 0,
     title,
     description: typeof raw.description === 'string' ? raw.description : '',
     status: STATUSES.includes(raw.status) ? raw.status : 'open',

package/lib/reminders.js

@@ -0,0 +1,37 @@
+/**
+ * Due reminders.
+ *
+ * The list already knows `dueAt`; what it never did was say anything when one passed. The rule
+ * is kept pure so the timer can be tested without waiting: a record is due when it is still
+ * active, its deadline is in the past, and this exact deadline has not been announced yet.
+ * Keying on `id → dueAt` means postponing a reminder makes it due again, while an announced one
+ * stays quiet across ticks and restarts (the map lives with the process).
+ *
+ * @module dsh-global-todo/reminders
+ */
+
+/**
+ * @param {object[]} todos
+ * @param {{ now?: number, reminded?: Record<string, string|null> }} [options]
+ * @returns {{ id: string, seq: number, title: string, dueAt: string }[]}
+ */
+export function dueReminders(todos, options = {}) {
+  const now = Number.isFinite(options.now) ? options.now : Date.now()
+  const reminded = options.reminded !== null && typeof options.reminded === 'object' ? options.reminded : {}
+  const due = []
+  for (const todo of Array.isArray(todos) ? todos : []) {
+    if (todo === null || typeof todo !== 'object') continue
+    if (todo.status !== 'open' && todo.status !== 'doing') continue
+    if (todo.dueAt === null || todo.dueAt === undefined || typeof todo.dueAt !== 'string') continue
+    const at = Date.parse(todo.dueAt)
+    if (!Number.isFinite(at) || at > now) continue
+    if (reminded[todo.id] === todo.dueAt) continue
+    due.push({
+      id: todo.id,
+      seq: Number.isInteger(todo.seq) ? todo.seq : 0,
+      title: typeof todo.title === 'string' ? todo.title : '',
+      dueAt: todo.dueAt,
+    })
+  }
+  return due
+}

package/lib/routes.js

@@ -354,7 +354,7 @@ export function createRoutes(deps) {
      */
     exact('POST', `${ROUTE_BASE}/import`, async (request) => {
       const body = await readJsonBody(request)
-      return service.importDocument(body.doc ?? body, { mode: body.mode })
+      return service.importDocument(body.doc ?? body, { mode: body.mode, dryRun: body.dryRun === true })
     }),
 
     exact('GET', `${ROUTE_BASE}/health`, async () => {
@@ -443,6 +443,9 @@ export function createRoutes(deps) {
           lastRetry: deps.autoCollect?.lastRetry ?? null,
           lastDrop: deps.autoCollect?.lastDrop ?? null,
         },
+        // Deadlines that passed and have not been acknowledged. In memory: the host
+        // announces once, the panel acknowledges, a restart re-announces unacknowledged ones.
+        reminders: { due: deps.reminders?.due ?? [] },
         // 「交给 Agent」 resolves its target from the conversation the user last
         // wrote in, so whether that feed attached is worth reporting too.
         target: {
@@ -480,6 +483,18 @@ export function createRoutes(deps) {
       }
     }),
 
+    exact('POST', `${ROUTE_BASE}/reminders/ack`, async (request) => {
+      const body = await readJsonBody(request)
+      const ids = new Set(
+        Array.isArray(body.ids) ? body.ids.filter((id) => typeof id === 'string' && id !== '') : [],
+      )
+      const state = deps.reminders
+      if (state !== undefined && state !== null && Array.isArray(state.due)) {
+        state.due = state.due.filter((item) => !ids.has(item.id))
+      }
+      return { cleared: ids.size }
+    }),
+
     exact('POST', `${ROUTE_BASE}/ingest`, async (request) => {
       const settings = deps.settings?.get?.()
       if (settings?.ingestEnabled !== true) {

package/lib/service.js

@@ -277,6 +277,9 @@ export function createService(options) {
         usedIds: doc.todos.map((candidate) => candidate.id),
         ...(context.origin === undefined ? {} : { origin: context.origin }),
       })
+      // Stable, human-facing number: the store fills gaps on read, the service assigns the
+      // next one on create so "#42" keeps meaning #42.
+      todo.seq = doc.todos.reduce((max, candidate) => Math.max(max, candidate.seq ?? 0), 0) + 1
       doc.todos.push(todo)
       metrics?.recordList?.('created', doc.todos.length)
       logger?.debug?.(`dsh-global-todo: created ${todo.id}`)
@@ -610,6 +613,19 @@ export function createService(options) {
       seen.add(todo.id)
       records.push(todo)
     }
+    if (context.dryRun === true) {
+      const existing = await store.all()
+      const known = new Set(existing.map((todo) => todo.id))
+      const wouldCreate = records.filter((record) => !known.has(record.id)).length
+      return {
+        mode,
+        dryRun: true,
+        wouldImport: records.length,
+        wouldCreate,
+        wouldUpdate: records.length - wouldCreate,
+        total: mode === 'merge' ? existing.length + wouldCreate : records.length,
+      }
+    }
     return store.update((existing) => {
       const todos = mode === 'merge' ? mergeById(existing.todos, records) : records
       metrics?.recordList?.('imports', todos.length)

package/lib/store.js

@@ -64,7 +64,26 @@ function salvage(value, activityLimit) {
     seen.add(todo.id)
     todos.push(todo)
   }
-  return { version: Number.isInteger(doc.version) ? doc.version : SCHEMA_VERSION, todos }
+  return { version: Number.isInteger(doc.version) ? doc.version : SCHEMA_VERSION, todos: assignSequence(todos) }
+}
+
+/**
+ * Give every record its human-facing number.
+ *
+ * Existing numbers are kept so "把 #42 交给 Agent" stays true after other records are
+ * deleted; records without one are numbered in creation order, and the next write
+ * persists them. A file that never gets written again keeps deriving the same numbers.
+ *
+ * @param {object[]} todos
+ * @returns {object[]}
+ */
+function assignSequence(todos) {
+  let max = 0
+  for (const todo of todos) if (Number.isInteger(todo.seq) && todo.seq > max) max = todo.seq
+  const missing = todos.filter((todo) => !Number.isInteger(todo.seq) || todo.seq <= 0)
+  missing.sort((left, right) => left.createdAt - right.createdAt || left.id.localeCompare(right.id))
+  for (const todo of missing) todo.seq = ++max
+  return todos
 }
 
 /**

package/lib/tools.js

@@ -85,6 +85,7 @@ const COMPLETION_SHAPE = {
 const TODO_SHAPE = {  type: 'object',
   properties: {
     id: { type: 'string' },
+    seq: { type: 'integer', description: '给人看的编号（#42）；0 表示尚未分配' },
     title: { type: 'string' },
     description: { type: 'string' },
     status: { type: 'string', enum: [...STATUSES] },
@@ -144,6 +145,7 @@ export function presentTodo(todo, now = Date.now()) {
   const due = todo.dueAt === null ? Number.POSITIVE_INFINITY : Date.parse(todo.dueAt)
   return {
     id: todo.id,
+    seq: todo.seq ?? 0,
     title: todo.title,
     description: todo.description,
     status: todo.status,
@@ -181,7 +183,8 @@ export function presentTodo(todo, now = Date.now()) {
  */
 export function todoLine(todo) {
   const mark = todo.status === 'done' ? 'x' : todo.status === 'doing' ? '~' : todo.status === 'cancelled' ? '-' : ' '
-  const parts = [`- [${mark}] ${todo.title}  id=${todo.id}`, `加入于 ${new Date(todo.createdAt).toISOString()}`]
+  const label = Number.isInteger(todo.seq) && todo.seq > 0 ? `#${todo.seq} ` : ''
+  const parts = [`- [${mark}] ${label}${todo.title}  id=${todo.id}`, `加入于 ${new Date(todo.createdAt).toISOString()}`]
   if (todo.priority !== 'normal') parts.push(PRIORITY_LABELS[todo.priority] ?? todo.priority)
   if (todo.dueAt !== null) parts.push(`截止 ${todo.dueAt}`)
   if (todo.tags.length > 0) parts.push(todo.tags.map((tag) => `#${tag}`).join(' '))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-global-todo",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "icon": "./docs/icon.svg",
   "description": "Global, cross-session todos for DeepSeek Harness: one list owned by the human and the agent together, with creation time, attached documents and links, and one-click hand-off to an agent session. 全局待办：跨会话一份清单，记录加入时间，可挂文档与地址，可一键交给 Agent 继续干。",
   "type": "module",