dsh-global-todo 0.12.13 → 0.13.0

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+## [0.13.0] — 2026-10-22
+
+Batch capture now scores what it is given, and drops what is not worth a todo.
+
+- **A weight per candidate, with a floor you can tune.** `global_todo_capture` asks a model for
+  "anything worth following up" and models oblige with hedged asides. Each candidate now gets a
+  0–1 weight from named signals: a specific title, a parseable deadline, steps, an attachment, a
+  quoted original, commitment wording (记得 / 截止 / 等下周一 …) add; hesitation (可能 / 也许 /
+  看看 / 再说), a bare question, or a one-liner with nothing attached subtract. Below
+  `captureMinWeight` the entry is skipped with its weight and the signals that pulled it down.
+- **The threshold is a setting**, not a constant: `captureMinWeight` (0–1, default 0.35) lives in
+  the settings file, is validated by `POST /settings`, reported in `/health`, and editable in the
+  panel's settings dialog. A hedged one-liner scores ~0.30 and is dropped; a stated errand with
+  nothing attached yet scores ~0.40 and passes.
+- **The skip reason stays honest.** A low-weight item is reported as `权重 0.30 低于阈值 0.35，未登记`
+  together with the penalty that applied, so "why was this not recorded" has an answer.
+- **Explained where the model reads it**: the capture prompt and the tool description both say the
+  weight exists and that specificity pays.
+
 ## [0.12.13] — 2026-10-21
 
 The dedupe promise now holds for short titles (#4).

package/README.md

@@ -322,7 +322,7 @@ Your list is not touched by install or uninstall: it lives outside the plugin, a
 |---|---|
 | `global_todo_add` | Record an item — description, attachments, steps, tags, priority, due time |
 | `global_todo_note` | Append a progress note — where you are, what blocks you, who must decide |
-| `global_todo_capture` | **Record a batch**: for 「抓一下待办」 or a turn that produced several follow-ups; each entry is validated on its own |
+| `global_todo_capture` | **Record a batch**: for 「抓一下待办」 or a turn that produced several follow-ups; each entry is validated on its own, and entries scoring below `captureMinWeight` are reported as skipped with their weight instead of being registered |
 | `global_todo_list` | Query by state, tag or text; every row carries its creation time |
 | `global_todo_get` | Read one item in full, including attachments and the last hand-off |
 | `global_todo_update` | Change any field of one item, including `status` (`archived` archives without deleting); `""` clears, `[]` empties |
@@ -393,7 +393,7 @@ fence when that service is present, and by a strict loopback check otherwise.
 | POST | `/api/global-todo/link` | `{ id, add?: [...], remove?: [value \| index] }` |
 | POST | `/api/global-todo/dispatch` | `{ id, mode?: auto\|bound\|new\|current, sessionId?, dir? }` |
 | POST | `/api/global-todo/assign` | `{ ids, items?, target?, dir? }` — hand several todos over in one call; an id that matches nothing comes back instead of being sent elsewhere |
-| POST | `/api/global-todo/settings` | `{ autoCollect?, idleMinutes?, cooldownMinutes?, exemptWorkspaces? }` — the Host-side switches behind automatic collect |
+| POST | `/api/global-todo/settings` | `{ autoCollect?, idleMinutes?, cooldownMinutes?, exemptWorkspaces?, captureMinWeight? }` — the Host-side switches behind automatic collect; `captureMinWeight` (0–1, default 0.35) is the floor below which a batch-capture candidate is reported as skipped instead of registered |
 | POST | `/api/global-todo/diagnostics` | `{ scope, status?, reason?, message?, url? }` — the panel's own error report |
 
 `by` on `/update` and `/status` says whose write this is: omitted (what the panel sends) it is

package/README.zh.md

@@ -219,6 +219,7 @@ dsh plugin --profile web remove dsh-global-todo
 - **分组维度**：工具栏上有 `对话 / 时间 / 级别` 三个维度，**默认按对话**——同一个 agent 对话提交的待办会**合并成一条**（显示「N 条」，点开才展开），这样几次「抓一下待办」不会把清单糊成一片。单条的对话直接显示那一行；没有来源对话的（在面板里手加的）归到「手动添加」。`时间` 是原来的逾期 / 今天 / 接下来 / 以后 / 没有截止时间，`级别` 按高 / 一般 / 低分组。
 - **级别 P0–P3**：每条待办可设 `P0 紧急 / P1 高 / P2 常规 / P3 低`；接口两种写法都收（`priority: "P0"` 或 `"urgent"`），旧记录里的 high/normal/low 原样有效，默认 P2。行上有徽标，对话分组头显示组内**最高级别**，绿色小圆点表示该对话里还有在跑的会话。
 - **从本对话抓取**：面板上一个按钮，把「请把这段对话里需要跟进的事用 `global_todo_capture` 抓一下」注入你正在说话的那个对话——聊着聊着把该跟进的事一次变成待办，不用自己一条条敲。提示词里同样写清了「不要记什么」（会话计划、闲聊、已完成的事），否则抓取只会制造噪音。
+- **权重下限**：每条候选会被打一个 0–1 的权重（具体标题、截止时间、步骤、附件、原话、承诺措辞加分；「可能 / 也许 / 看看 / 再说」这类犹豫语、纯疑问句、没有任何补充信息的条目减分），低于设置里的 `captureMinWeight`（默认 0.35）就不登记，只在 `skipped` 里报出权重与原因。设置面板里可以直接改这个值。
 - **自动完成**：派发出去的会话**干净结束**时，宿主自己把这条待办标成完成，并附上**它最后那段回复**作为完成说明、**这一轮改动的文件**作为产出——不用等模型记得调工具。面板上完成的行显示「完成于 …」加产出芯片，展开详情有「完成记录」段（说明 + 产出路径，可点开或复制）。
   两条护栏值得知道：**只对刚派发过的会话生效**（你在那个会话里随便聊两句不会把待办完成掉），**失败 / 中断的回合不标记完成**（宁可留着未完成，也不能让一份干砸的活显示成已完成）。
   你也可以自己收尾：`global_todo_done` 支持 `summary` 与 `artifacts`，那是主路径，自动收尾只是兜底。
@@ -295,7 +296,7 @@ dsh plugin --profile web remove dsh-global-todo
 | POST | `/api/global-todo/link` | `{ id, add?: [...], remove?: [值 或 下标] }` |
 | POST | `/api/global-todo/dispatch` | `{ id, mode?: auto\|bound\|new\|current, sessionId?, dir? }` |
 | POST | `/api/global-todo/assign` | `{ ids, items?, target?, dir? }`——一次把多条交给 Agent；配不上的 id 原样报回，不擅自送到别处 |
-| POST | `/api/global-todo/settings` | `{ autoCollect?, idleMinutes?, cooldownMinutes?, exemptWorkspaces? }`——自动获取的开关与阈值 |
+| POST | `/api/global-todo/settings` | `{ autoCollect?, idleMinutes?, cooldownMinutes?, exemptWorkspaces?, captureMinWeight? }`——自动获取的开关与阈值；`captureMinWeight`（0–1，默认 0.35）是批量抓取的权重下限，低于它的候选只在 `skipped` 里报出、不登记 |
 | POST | `/api/global-todo/diagnostics` | `{ scope, status?, reason?, message?, url? }`——面板自己上报的错误 |
 
 `/update` 与 `/status` 的 `by` 说明这次写是谁做的：不传（面板就是这样）就是人在键盘前，

package/lib/client.js

@@ -93,6 +93,9 @@ window.__ModuleLoader__.load({
       'action.importHint': '从 JSON 文件导入：同 id 覆盖、新 id 追加，不删除现有待办',
       'settings.title': '设置',
       'settings.context': '上下文',
+      'settings.capture': '抓取权重',
+      'settings.captureWeight': '低于此权重不登记',
+      'settings.captureWeightHint': '批量抓取时，权重低于这个值的条目直接跳过（0–1，默认 0.35）。犹豫措辞、纯疑问句、没有任何补充信息的条目权重低。',
       'settings.reminders': '到点提醒',
       'settings.remindersEnable': '开启到点提醒',
       'settings.lead': '提前（分钟）',
@@ -393,6 +396,9 @@ window.__ModuleLoader__.load({
       'action.importHint': 'Import a JSON file: same ids are updated, new ids appended, nothing deleted',
       'settings.title': 'Settings',
       'settings.context': 'Context',
+      'settings.capture': 'Capture weight',
+      'settings.captureWeight': 'Do not register below',
+      'settings.captureWeightHint': 'Batch capture skips a candidate whose weight is below this value (0–1, default 0.35). Hedged wording, bare questions and one-liners without detail score low.',
       'settings.reminders': 'Due reminders',
       'settings.remindersEnable': 'Announce deadlines',
       'settings.lead': 'Lead time (min)',
@@ -2548,6 +2554,8 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       const [tokenDraft, setTokenDraft] = useState('')
       const [ingestDraft, setIngestDraft] = useState(false)
       const [belowDraft, setBelowDraft] = useState('0.8')
+      // Capture weight threshold: candidates the batch tool should not register at all.
+      const [minWeightDraft, setMinWeightDraft] = useState('0.35')
       const [remindersDraft, setRemindersDraft] = useState(true)
       const [leadDraft, setLeadDraft] = useState('0')
       const [notificationPerm, setNotificationPerm] = useState(
@@ -3525,6 +3533,8 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
         const current = state.health?.settings ?? {}
         setIngestDraft(current.ingest?.enabled === true)
         setBelowDraft(String(current.ingest?.confirmBelow ?? 0.8))
+        // Read from /health, which reports the value the capture tool is actually using.
+        setMinWeightDraft(String(state.health?.settings?.captureMinWeight ?? 0.35))
         setRemindersDraft(current.remindersEnabled !== false)
         setLeadDraft(String(current.reminderLeadMinutes ?? 0))
         setTokenDraft('')
@@ -3547,6 +3557,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
               reminderLeadMinutes: Number(leadDraft),
               ingestEnabled: ingestDraft,
               ingestConfirmBelow: Number(belowDraft),
+              captureMinWeight: Number(minWeightDraft),
               ...(tokenDraft.trim() === '' ? {} : { ingestToken: tokenDraft.trim() }),
             },
           })
@@ -3842,6 +3853,27 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                       }),
                     ),
                   ),
+                  h(
+                    'div',
+                    { className: 'gt-settings-group' },
+                    h('div', { className: 'gt-settings-group-title' }, t('settings.capture')),
+                    h(
+                      'div',
+                      { className: 'gt-field-row' },
+                      h('label', { className: 'gt-field-label', htmlFor: 'gt-min-weight' }, t('settings.captureWeight')),
+                      h('input', {
+                        id: 'gt-min-weight',
+                        type: 'number',
+                        min: 0,
+                        max: 1,
+                        step: 0.05,
+                        className: 'gt-input gt-input-num',
+                        value: minWeightDraft,
+                        onChange: (event) => setMinWeightDraft(event.target.value),
+                      }),
+                    ),
+                    h('div', { className: 'gt-hint' }, t('settings.captureWeightHint')),
+                  ),
                   h(
                     'div',
                     { className: 'gt-settings-group' },

package/lib/index.js

@@ -37,7 +37,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.12.13'
+export const VERSION = '0.13.0'
 
 /** Plugin id. Also the Loader row id in `cordis.patch.yml`. */
 export const name = 'dsh-global-todo'
@@ -502,7 +502,7 @@ export function apply(ctx, config) {
   ctx.inject(['tools'], (toolCtx) => {
     toolCtx.effect(() => {
       try {
-        const definitions = createTools(service, { metrics })
+        const definitions = createTools(service, { metrics, settings })
         const disposers = definitions.map((definition) => toolCtx.tools.register(definition))
         toolState.registered = definitions.map((definition) => definition.name)
         toolState.error = null

package/lib/routes.js

@@ -467,6 +467,9 @@ export function createRoutes(deps) {
           // cannot tell whether the idle gate is deployed at all.
           idleMinutes: deps.settings?.get?.().idleMinutes ?? 30,
           cooldownMinutes: deps.settings?.get?.().cooldownMinutes ?? 30,
+          // Shown and edited by the panel; the capture tool reads the same value when it
+          // decides whether a candidate is worth registering at all.
+          captureMinWeight: deps.settings?.get?.().captureMinWeight ?? 0.35,
           // 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 ?? [],
@@ -747,7 +750,7 @@ export function createRoutes(deps) {
  * @param {Record<string, unknown>} body
  */
 function assertSettingsShape(body) {
-  const known = ['autoCollect', 'idleMinutes', 'cooldownMinutes', 'exemptWorkspaces', 'ingestEnabled', 'ingestSources', 'ingestConfirmBelow', 'ingestToken', 'remindersEnabled', 'reminderLeadMinutes']
+  const known = ['autoCollect', 'idleMinutes', 'cooldownMinutes', 'exemptWorkspaces', 'ingestEnabled', 'ingestSources', 'ingestConfirmBelow', 'ingestToken', 'remindersEnabled', 'reminderLeadMinutes', 'captureMinWeight']
   for (const key of Object.keys(body)) {
     if (!known.includes(key)) {
       throw new TodoError('invalid-body', '未知的设置项 ' + key + '；可写的是 ' + known.join(' / '))
@@ -789,6 +792,7 @@ function assertSettingsRange(body) {
     cooldownMinutes: [5, 24 * 60, true],
     ingestConfirmBelow: [0, 1, false],
     reminderLeadMinutes: [0, 24 * 60, true],
+    captureMinWeight: [0, 1, false],
   }
   for (const [field, [low, high, whole]] of Object.entries(ranges)) {
     const value = body[field]

package/lib/service.js

@@ -616,6 +616,8 @@ export function createService(options) {
       '',
       '该记的：等对方回复、待确认的决定、答应别人的事、还没收尾且需要另开一个会话继续的一步。',
       '每条必要时补描述、挂上相关文档**绝对路径**或网址，并标级别（P0 紧急 / P1 高 / P2 常规 / P3 低）。',
+      '工具会给每条算一个 0–1 的权重，低于设置的 captureMinWeight 会被跳过（犹豫措辞、纯疑问句、只有一句话没有细节的条目权重低）——'
+        + '所以标题写具体、带上原话和截止时间，比多写几条更有用。',
       '',
       '**带上原话**（重要）：每条用 `evidence` 逐字引用用户说的那一句（最多 ' + LIMITS.evidence + ' 字，不要改写、不要总结）。',
       '以后看到这条待办的人，要能一眼核对「有没有听错」；没有原话的抓取，只是一条无从核对的转述。',

package/lib/settings.js

@@ -11,6 +11,7 @@
 import { chmod, readFile } from 'node:fs/promises'
 import { isAbsolutePath } from './links.js'
 import { atomicWrite } from './store.js'
+import { DEFAULT_MIN_WEIGHT, normalizeThreshold } from './weight.js'
 
 /** How many sessions the cooldown bookkeeping remembers. */
 const ASKED_LIMIT = 50
@@ -72,6 +73,14 @@ export const SETTINGS_DEFAULTS = Object.freeze({
   remindersEnabled: true,
   /** Announce this many minutes before the deadline (0 = at the deadline). */
   reminderLeadMinutes: 0,
+  /**
+   * Candidates below this weight are not registered by the batch capture tool.
+   *
+   * The tool asks a model for "anything worth following up", and models oblige with hedged
+   * asides. The threshold is the difference between a list a person reads and one they skim;
+   * 0.35 sits just above a bare, hedged one-liner and below a stated errand.
+   */
+  captureMinWeight: 0.35,
 })
 
 /**
@@ -132,6 +141,7 @@ export function normalizeSettings(raw) {
     ingestConfirmBelow: Number.isFinite(below) ? Math.min(Math.max(below, 0), 1) : SETTINGS_DEFAULTS.ingestConfirmBelow,
     remindersEnabled: source.remindersEnabled !== false,
     reminderLeadMinutes: Number.isFinite(lead) ? Math.min(Math.max(lead, 0), 24 * 60) : SETTINGS_DEFAULTS.reminderLeadMinutes,
+    captureMinWeight: normalizeThreshold(source.captureMinWeight, DEFAULT_MIN_WEIGHT),
   }
 }
 

package/lib/tools.js

@@ -14,6 +14,7 @@
  */
 
 import { CAPTURE_REASONS, findDuplicate } from './capture.js'
+import { DEFAULT_MIN_WEIGHT, scoreItem } from './weight.js'
 import { asTodoError } from './errors.js'
 import { formatLink } from './links.js'
 import { LIMITS, PRIORITIES, PRIORITY_LABELS, STATUSES } from './model.js'
@@ -326,6 +327,12 @@ function originOf(exec) {
  */
 export function createTools(service, options = {}) {
   const now = options.now ?? (() => Date.now())
+  // Read lazily: the settings object is created before the tools and its value can change
+  // at runtime, so a captured snapshot at mount would freeze the threshold.
+  const captureMinWeight = () => {
+    const value = options.settings?.get?.()?.captureMinWeight
+    return typeof value === 'number' && Number.isFinite(value) ? value : DEFAULT_MIN_WEIGHT
+  }
   // Optional counters for /health; when absent the definitions ship untouched.
   const metrics = options.metrics
 
@@ -376,7 +383,9 @@ export function createTools(service, options = {}) {
         '把一次工作里攒下的多件事**一次性**记进全局待办（批量抓取）。'
         + '两种时机用它：用户说「抓一下待办 / 整理一下要跟进的」，你扫一遍最近的对话把该跟进的事提出来；'
         + '或者你自己在一轮里发现好几件需要跨会话跟进的事。'
-        + '逐条校验：某条不合法只跳过那一条并在 skipped 里说明原因，其余照常写入，不用整批重来。',
+        + '逐条校验：某条不合法只跳过那一条并在 skipped 里说明原因，其余照常写入，不用整批重来。'
+        + '低于权重阈值（设置里的 captureMinWeight，默认 0.35）的条目不会登记，skipped 里会给出权重——'
+        + '犹豫语（可能/也许/看看/再说）、纯疑问句、没有任何补充信息的条目会被判低。',
       parameters: {
         type: 'object',
         properties: {
@@ -443,7 +452,19 @@ export function createTools(service, options = {}) {
           existing = []
         }
         const nowMs = now()
+        // The weight gate comes first: a hedged aside is not worth a dedupe lookup, and the
+        // skip reason should say what it was missing rather than "duplicate".
+        const threshold = captureMinWeight()
         for (const item of items) {
+          const { weight, signals } = scoreItem(item)
+          if (weight < threshold) {
+            const why = signals.filter((signal) => signal.delta < 0).map((signal) => signal.note).join('、')
+            skipped.push({
+              title: String(item?.title ?? '(无标题)'),
+              error: `权重 ${weight.toFixed(2)} 低于阈值 ${threshold}，未登记${why === '' ? '' : `（${why}）`}`,
+            })
+            continue
+          }
           const verdict = findDuplicate({ title: item?.title, existing, now: nowMs })
           if (verdict.duplicate === true) {
             skipped.push({

package/lib/weight.js

@@ -0,0 +1,87 @@
+/**
+ * How much a captured candidate looks like a real todo.
+ *
+ * The batch capture tool is asked for "anything worth following up", and models oblige:
+ * they return hedged observations ("maybe look at the log later"), questions, and the
+ * occasional aside. Rather than trusting the model's own ordering, each candidate gets a
+ * small, explicit weight from signals a person would recognise, and anything below the
+ * configured threshold is reported as skipped instead of filling the list.
+ *
+ * The score is deliberately explainable: every contribution is named, so the skip reason
+ * can say *why* something was left out rather than "low quality".
+ *
+ * @module dsh-global-todo/weight
+ */
+
+/** A phrase that reads like a commitment rather than an observation. */
+const COMMITMENT = ['记得', '别忘', '回头', '下周', '明天', '后天', '截止', 'deadline', '要交', '待确认', '等回复', '跟进', '安排', '发我', '确认一下', '记得要', '别忘了']
+
+/** A phrase that reads like thinking aloud. */
+const HESITATION = ['可能', '也许', '考虑', '有空', '再说', '看看', '随便', '或许', '不确定', 'optional']
+
+/** Default threshold; a bare one-line observation scores below it. */
+export const DEFAULT_MIN_WEIGHT = 0.35
+
+const clamp01 = (value) => Math.min(1, Math.max(0, value))
+
+/**
+ * @param {unknown} item - a candidate as the capture tool receives it
+ * @param {{ now?: number }} [options]
+ * @returns {{ weight: number, signals: { id: string, delta: number, note: string }[] }}
+ */
+export function scoreItem(item, options = {}) {
+  const signals = []
+  const add = (id, delta, note) => signals.push({ id, delta, note })
+  if (item === null || typeof item !== 'object' || Array.isArray(item)) {
+    return { weight: 0, signals: [{ id: 'shape', delta: 0, note: '不是对象' }] }
+  }
+  const title = typeof item.title === 'string' ? item.title.trim() : ''
+  const description = typeof item.description === 'string' ? item.description.trim() : ''
+  const text = `${title} ${description}`
+  const length = [...title].length
+
+  // The title says how specific the errand is. A one-character title cannot.
+  if (length >= 10) add('specific', 0.15, '标题足够具体')
+  else if (length >= 6) add('specific', 0.1, '标题较具体')
+  else if (length >= 3) add('specific', 0.05, '标题偏短')
+  else add('tiny', -0.15, '标题几乎没有信息')
+
+  const due = typeof item.dueAt === 'string' && Number.isFinite(Date.parse(item.dueAt))
+  if (due) add('due', 0.2, '有可解析的截止时间')
+
+  if (Array.isArray(item.steps) && item.steps.length > 0) add('steps', 0.15, '已经拆成步骤')
+  if (Array.isArray(item.links) && item.links.length > 0) add('links', 0.1, '挂了文档或地址')
+  if (typeof item.evidence === 'string' && item.evidence.trim() !== '') add('evidence', 0.1, '引用了原话')
+  if (item.priority === 'urgent') add('priority', 0.15, '标了 P0')
+  else if (item.priority === 'high') add('priority', 0.1, '标了 P1')
+
+  const hesitation = HESITATION.find((word) => text.includes(word))
+  if (hesitation !== undefined) add('hesitation', -0.2, `含犹豫语「${hesitation}」`)
+  // A hedged sentence does not also earn the commitment bonus: 「回头再说吧，有空看看」 contains
+  // 「回头」, and crediting it for that is exactly how an aside becomes a todo.
+  const commitment = hesitation === undefined ? COMMITMENT.find((word) => text.includes(word)) : undefined
+  if (commitment !== undefined) add('commitment', 0.15, `含承诺语「${commitment}」`)
+
+  if (/[？?]\s*$/.test(title)) add('question', -0.15, '标题是疑问句')
+
+  // A naked one-liner with nothing attached is the shape of an aside.
+  if (description === '' && !due && !(Array.isArray(item.steps) && item.steps.length > 0) && !(Array.isArray(item.links) && item.links.length > 0)) {
+    add('naked', -0.1, '没有任何补充信息')
+  }
+
+  // The base is what a bare, plausible errand scores: specific enough to state, with nothing
+  // attached yet. Everything above or below that is a named signal.
+  const weight = clamp01(Math.round((0.45 + signals.reduce((sum, signal) => sum + signal.delta, 0)) * 100) / 100)
+  return { weight, signals }
+}
+
+/**
+ * @param {unknown} weight
+ * @param {number} [fallback]
+ * @returns {number} a threshold in 0..1
+ */
+export function normalizeThreshold(weight, fallback = DEFAULT_MIN_WEIGHT) {
+  const value = Number(weight)
+  if (!Number.isFinite(value)) return fallback
+  return clamp01(Math.round(value * 100) / 100)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-global-todo",
-  "version": "0.12.13",
+  "version": "0.13.0",
   "icon": "./docs/icon.svg",
   "description": "Cross-session todo list for DeepSeek Harness: one JSON file a person and an agent both write to, with step plans that ship as a numbered hand-off, session read-back, and a human confirmation before an agent's \"done\" counts.",
   "type": "module",