dsh-worktodo 0.1.3 → 0.2.0

package/src/parse-due.mjs

@@ -0,0 +1,170 @@
+/**
+ * 自然语言日期解析：从一句人话里认出「截止日期 / 时间」，并把认出来的词从标题里摘掉。
+ *
+ * 设计原则（保守优先）：
+ *   1. 只认**明确的日期词**，宁可漏也不误吞（"买3个苹果" 里的 3 不能变成"3 天后"）；
+ *   2. 出现多个星期几时取**最后**一个（"周一例会改到周三" → 周三）；
+ *   3. 结果的每一处都能追溯到原文片段（matched），人类侧据此显示"从标题识别"并可撤销；
+ *   4. 与 `normalizeDue` 的既有说法保持兼容（今天/明天/昨天/+3d/本周）。
+ *
+ * 人类面板与 worktodo_* 工具共用这一份实现（本文件零依赖，可直接被打进客户端 bundle），
+ * 避免两边理解不一致。
+ */
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+/** 本地时区的 YYYY-MM-DD（与 records.mjs 的 dayKey 同语义）。 */
+function dayKey(stamp) {
+  const d = new Date(stamp);
+  const pad = (n) => String(n).padStart(2, '0');
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+}
+
+/** 所在周的周一（本地时区，与 records.mjs 的 weekStartKey 同语义）。 */
+function weekStartKey(stamp) {
+  const d = new Date(stamp);
+  const day = (d.getDay() + 6) % 7; // 周一=0
+  const monday = new Date(d.getFullYear(), d.getMonth(), d.getDate() - day);
+  return dayKey(monday.getTime());
+}
+
+
+const CN_NUM = { 零: 0, 一: 1, 两: 2, 二: 2, 三: 3, 四: 4, 五: 5, 六: 6, 七: 7, 八: 8, 九: 9, 十: 10 };
+const WEEKDAY = { 一: 1, 二: 2, 三: 3, 四: 4, 五: 5, 六: 6, 日: 7, 天: 7 };
+const PERIOD_HOUR = { 今早: 9, 早上: 9, 早晨: 9, 上午: 9, 中午: 12, 下午: 15, 傍晚: 18, 今晚: 20, 明晚: 20, 晚上: 20, 晚: 20, 夜里: 21 };
+
+const toCnNumber = (raw) => {
+  if (/^\d+$/.test(raw)) return Number(raw);
+  if (raw === '十') return 10;
+  if (raw.startsWith('十')) return 10 + (CN_NUM[raw[1]] ?? 0);
+  if (raw.includes('十')) {
+    const [a, b] = raw.split('十');
+    return (CN_NUM[a] ?? 1) * 10 + (CN_NUM[b] ?? 0);
+  }
+  return CN_NUM[raw] ?? null;
+};
+
+/**
+ * @param {string} text 用户输入
+ * @param {number} [now] 基准时刻
+ * @returns {{title:string, due:string|null, dueTime:string|null, matched:string[]}}
+ */
+export function parseNaturalDue(text, now = Date.now()) {
+  const source = typeof text === 'string' ? text : '';
+  const spans = []; // {start, end, kind:'date'|'time'}
+  let due = null;
+  let dueTime = null;
+  let hourFromPeriod = null; // 「今晚」这类只给时段，兜底时间
+
+  const today = dayKey(now);
+  const todayStart = new Date(`${today}T00:00:00`).getTime();
+
+  // ---------- 1) 绝对日期：2026-10-20 / 10月20日 / 10/20 ----------
+  let m = /(\d{4})[-/年](\d{1,2})[-/月](\d{1,2})日?/.exec(source);
+  if (m) {
+    due = dayKey(new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3])).getTime());
+    spans.push({ start: m.index, end: m.index + m[0].length, kind: 'date' });
+  } else {
+    m = /(\d{1,2})月(\d{1,2})日?/.exec(source);
+    if (m) {
+      // 省略年份：取「最近一次」（已过去就顺延到明年）
+      let year = new Date(now).getFullYear();
+      let candidate = dayKey(new Date(year, Number(m[1]) - 1, Number(m[2])).getTime());
+      if (candidate < today) candidate = dayKey(new Date(year + 1, Number(m[1]) - 1, Number(m[2])).getTime());
+      due = candidate;
+      spans.push({ start: m.index, end: m.index + m[0].length, kind: 'date' });
+    }
+  }
+
+  // ---------- 2) 星期：周X / 星期X / 礼拜X / 下周一（多个取最后一个） ----------
+  const weekRe = /(下下|下个|下|本|这)?(?:周|星期|礼拜)([一二三四五六日天1-7])/g;
+  for (let w = weekRe.exec(source); w; w = weekRe.exec(source)) {
+    const offsetWeeks = w[1] === '下' || w[1] === '下个' ? 1 : w[1] === '下下' ? 2 : 0;
+    const target = WEEKDAY[w[2]] ?? Number(w[2]);
+    const thisWeekStart = new Date(`${weekStartKey(now)}T00:00:00`).getTime();
+    let stamp = thisWeekStart + (target - 1) * DAY_MS + offsetWeeks * 7 * DAY_MS;
+    if (offsetWeeks === 0 && stamp < todayStart) stamp += 7 * DAY_MS; // 已过则算下周
+    const candidate = dayKey(stamp);
+    // 后面的星期几覆盖前面的（"改到周三"的语义）
+    if (due === null || spans.some((s) => s.kind === 'date' && s.weekday)) {
+      spans.filter((s) => s.weekday).forEach((s) => { s.dropped = true; });
+    }
+    due = candidate;
+    spans.push({ start: w.index, end: w.index + w[0].length, kind: 'date', weekday: true });
+  }
+
+  // ---------- 3) 相对天数：今天/明天/后天/大后天/3天后/+3d ----------
+  if (due === null) {
+    const relWords = { 今天: 0, 今日: 0, 明天: 1, 明日: 1, 后天: 2, 大后天: 3, 昨天: -1, 昨: -1 };
+    for (const [word, offset] of Object.entries(relWords)) {
+      const at = source.indexOf(word);
+      if (at !== -1) {
+        due = dayKey(now + offset * DAY_MS);
+        spans.push({ start: at, end: at + word.length, kind: 'date' });
+        break;
+      }
+    }
+  }
+  if (due === null) {
+    const plus = /\+(\d{1,3})\s*d(?:ay)?s?/.exec(source);
+    const cn = /([0-9零一两二三四五六七八九十]+)\s*天\s*(?:后|以后|之后)/.exec(source);
+    if (plus) {
+      due = dayKey(now + Number(plus[1]) * DAY_MS);
+      spans.push({ start: plus.index, end: plus.index + plus[0].length, kind: 'date' });
+    } else if (cn) {
+      const n = toCnNumber(cn[1]);
+      if (n !== null) {
+        due = dayKey(now + n * DAY_MS);
+        spans.push({ start: cn.index, end: cn.index + cn[0].length, kind: 'date' });
+      }
+    }
+  }
+
+  // ---------- 4) 时段词：今晚 / 明早 / 下午 / 早上 ----------
+  const periodRe = /(今晚|明晚|明早|早上|早晨|上午|中午|下午|傍晚|晚上|夜里)/;
+  const period = periodRe.exec(source);
+  if (period) {
+    hourFromPeriod = PERIOD_HOUR[period[1]] ?? null;
+    if (due === null) {
+      if (period[1] === '今晚' || period[1] === '明晚') due = dayKey(now + (period[1] === '明晚' ? 1 : 0) * DAY_MS);
+      if (period[1] === '明早') due = dayKey(now + DAY_MS);
+    }
+    spans.push({ start: period.index, end: period.index + period[1].length, kind: 'time' });
+  }
+
+  // ---------- 5) 具体时间：下午3点 / 3点半 / 15:00 / 上午10点 ----------
+  const hm = /(\d{1,2})[:：](\d{2})/.exec(source);
+  const cnHour = /([0-9零一两二三四五六七八九十]+)\s*[点时](半|[0-9零一两二三四五六七八九十]{1,3}分)?/.exec(source);
+  if (hm) {
+    const h = Number(hm[1]);
+    if (h <= 23 && Number(hm[2]) <= 59) dueTime = `${String(h).padStart(2, '0')}:${hm[2]}`;
+    spans.push({ start: hm.index, end: hm.index + hm[0].length, kind: 'time' });
+  } else if (cnHour) {
+    let h = toCnNumber(cnHour[1]);
+    if (h !== null && h <= 23) {
+      if (h <= 12 && hourFromPeriod !== null && hourFromPeriod >= 12) h = h === 12 ? 12 : h + 12; // 下午3点 → 15
+      const minute = cnHour[2] === '半' ? 30 : cnHour[2] ? (toCnNumber(cnHour[2].replace('分', '')) ?? 0) : 0;
+      if (minute <= 59) dueTime = `${String(h).padStart(2, '0')}:${String(minute).padStart(2, '0')}`;
+      spans.push({ start: cnHour.index, end: cnHour.index + cnHour[0].length, kind: 'time' });
+    }
+  } else if (hourFromPeriod !== null) {
+    dueTime = `${String(hourFromPeriod).padStart(2, '0')}:00`; // 只有时段词 → 用该时段默认钟点
+  }
+
+  // 只认到时间、没认到日期 → 今天（用户决定④）
+  if (dueTime && !due) due = today;
+
+  // ---------- 6) 摘除：把认出来的片段从标题里去掉 ----------
+  const kept = spans.filter((s) => !s.dropped).sort((a, b) => a.start - b.start);
+  let title = source;
+  for (const span of [...kept].reverse()) {
+    title = title.slice(0, span.start) + ' ' + title.slice(span.end);
+  }
+  title = title.replace(/\s+/g, ' ').trim();
+
+  return {
+    title: title || source.trim(),
+    due,
+    dueTime,
+    matched: kept.map((s) => source.slice(s.start, s.end)),
+  };
+}

package/src/records.mjs

@@ -16,7 +16,7 @@
 /** 状态：与官方 todo_write 同名同义，便于互相提升。 */
 export const STATUSES = ['pending', 'in_progress', 'completed'];
 /** 优先级：只留三档，避免用户在选择上犹豫。 */
-export const PRIORITIES = ['high', 'normal', 'low'];
+export const PRIORITIES = ['high', 'normal', 'low', 'none'];
 /** 来源：人加的 / agent 加的 / 从会话 todos 提升的。 */
 export const SOURCES = ['human', 'agent', 'session'];
 
@@ -147,6 +147,7 @@ export function normalizePriority(value) {
     p0: 'high', urgent: 'high', high: 'high', 高: 'high', 紧急: 'high', 重要: 'high',
     p1: 'normal', normal: 'normal', medium: 'normal', mid: 'normal', 中: 'normal', 普通: 'normal',
     p2: 'low', low: 'low', 低: 'low', 次要: 'low',
+    none: 'none', no: 'none', 无: 'none', 不设: 'none', 无优先级: 'none',
   };
   const resolved = alias[raw];
   if (!resolved) throw new WorkTodoError('bad-priority', `优先级只能是 ${PRIORITIES.join(' / ')}，收到 ${JSON.stringify(value)}`);
@@ -202,6 +203,25 @@ export function normalizeDue(value, now = Date.now()) {
  * @param {number} now
  * @returns {string}
  */
+/**
+ * 截止时间（可选，只有配了截止日期才有意义）：接受 "14:30" / "9:05" / "1430" / "14"。
+ * 空值（undefined/null/''/none）返回 null；写坏了抛错，别悄悄丢掉用户填的时间。
+ * @param {unknown} value
+ * @returns {string|null} HH:MM
+ */
+export function normalizeDueTime(value) {
+  if (value === undefined || value === null || value === '') return null;
+  if (typeof value !== 'string') throw new WorkTodoError('bad-due-time', '截止时间必须是文本');
+  const raw = value.trim().toLowerCase();
+  if (!raw || raw === 'none' || raw === 'null' || raw === 'clear') return null;
+  const m = /^(\d{1,2})(?::?(\d{2}))?$/.exec(raw);
+  if (!m) throw new WorkTodoError('bad-due-time', '截止时间要写成 HH:MM（例如 14:30）');
+  const hour = Number(m[1]);
+  const minute = m[2] === undefined ? 0 : Number(m[2]);
+  if (hour > 23 || minute > 59) throw new WorkTodoError('bad-due-time', '截止时间超出范围（00:00–23:59）');
+  return `${String(hour).padStart(2, '0')}:${String(minute).padStart(2, '0')}`;
+}
+
 export function newId(now = Date.now(), rand = Math.random) {
   const t = Math.floor(now).toString(36);
   const r = Math.floor(rand() * 36 ** 4).toString(36).padStart(4, '0');
@@ -220,13 +240,16 @@ export function newId(now = Date.now(), rand = Math.random) {
 export function createRecord(input = {}, { now = Date.now(), source = 'human', id } = {}) {
   if (!SOURCES.includes(source)) throw new WorkTodoError('bad-source', `来源只能是 ${SOURCES.join(' / ')}`);
   const status = normalizeStatus(input.status) ?? 'pending';
+  const due = normalizeDue(input.due, now);
   const record = {
     id: id ?? newId(now),
     title: normalizeTitle(input.title),
     notes: normalizeNotes(input.notes),
     status,
-    priority: normalizePriority(input.priority) ?? 'normal',
-    due: normalizeDue(input.due, now),
+    priority: normalizePriority(input.priority) ?? 'none',
+    due,
+    // 没有截止日期就没有截止时间（避免出现「有时间没日期」的怪状态）
+    dueTime: due ? normalizeDueTime(input.dueTime) : null,
     project: normalizeProject(input.project),
     order: null,
     source,
@@ -254,7 +277,16 @@ export function patchRecord(record, patch = {}, now = Date.now()) {
   if (take('notes')) { next.notes = normalizeNotes(patch.notes); touched = true; }
   if (take('project')) { next.project = normalizeProject(patch.project); touched = true; }
   if (take('priority')) { next.priority = normalizePriority(patch.priority) ?? next.priority; touched = true; }
-  if (take('due')) { next.due = normalizeDue(patch.due, now); touched = true; }
+  if (take('due')) {
+    next.due = normalizeDue(patch.due, now);
+    if (!next.due) next.dueTime = null; // 清掉日期时时间一并清掉
+    touched = true;
+  }
+  if (take('dueTime')) {
+    // 只给时间不给日期是无效的：没有日期就存 null
+    next.dueTime = next.due ? normalizeDueTime(patch.dueTime) : null;
+    touched = true;
+  }
 
   const status = normalizeStatus(patch.status);
   if (status && status !== next.status) {
@@ -306,7 +338,8 @@ export function resolveRef(records, ref) {
  * ------------------------------------------------------------------ */
 
 /** 优先级权重，用于排序（高的在前）。 */
-const PRIORITY_WEIGHT = { high: 0, normal: 1, low: 2 };
+// 「无」排在最后（未定优先级的不该挡在已定优先级的前面），但仍排在「已完成」之前
+const PRIORITY_WEIGHT = { high: 0, normal: 1, low: 2, none: 3 };
 
 /**
  * 视图排序：未完成在前；同组内 优先级 → 截止日期（无日期排最后）→ 创建时间。
@@ -330,6 +363,11 @@ export function sortForView(records, mode = 'priority') {
     const pb = PRIORITY_WEIGHT[b.priority] ?? 1;
     if (pa !== pb) return pa - pb;
     if (a.due && b.due && a.due !== b.due) return a.due < b.due ? -1 : 1;
+    if (a.due === b.due) {
+      const ta = a.dueTime ?? '99:99'; // 同一天：有时间的在前，没时间的垫后
+      const tb = b.dueTime ?? '99:99';
+      if (ta !== tb) return ta < tb ? -1 : 1;
+    }
     if (a.due && !b.due) return -1;
     if (!a.due && b.due) return 1;
     return a.createdAt - b.createdAt;
@@ -489,7 +527,7 @@ export function filterRecords(records, filter = 'open', now = Date.now()) {
  * ------------------------------------------------------------------ */
 
 /** 优先级在文本里的记号：让模型一眼看出轻重，且不占多少 token。 */
-const PRIORITY_MARK = { high: '!', normal: '', low: '·' };
+const PRIORITY_MARK = { high: '!', normal: '', low: '·', none: '' };
 
 /**
  * 把一条记录渲染成单行文本，例如：
@@ -503,10 +541,11 @@ export function formatLine(record, now = Date.now()) {
   const box = record.status === 'completed' ? '[x]' : record.status === 'in_progress' ? '[~]' : '[ ]';
   const bits = [];
   if (record.priority === 'high') bits.push('高');
+  else if (record.priority === 'normal') bits.push('中');
   else if (record.priority === 'low') bits.push('低');
   if (record.due) {
     const overdue = record.status !== 'completed' && record.due < today;
-    bits.push(`${overdue ? '已逾期 ' : '截止 '}${record.due}`);
+    bits.push(`${overdue ? '已逾期 ' : '截止 '}${record.due}${record.dueTime ? ` ${record.dueTime}` : ''}`);
   }
   if (record.project) bits.push(`#${record.project}`);
   const suffix = bits.length ? `  (${bits.join(', ')})` : '';

package/src/schema.mjs

@@ -19,6 +19,7 @@ import {
   dayKey,
   newId,
   normalizeDue,
+  normalizeDueTime,
   normalizePriority,
   normalizeStatus,
 } from './records.mjs';
@@ -63,7 +64,7 @@ export function repairRecord(raw) {
   const id = typeof raw.id === 'string' && raw.id.trim() ? raw.id.trim() : newId();
   // 状态/优先级/日期都过一遍同义词归一：手改成 done / 高 / 2026/10/20 也要能懂
   const status = STATUSES.includes(raw.status) ? raw.status : coerce(() => normalizeStatus(raw.status), 'pending');
-  const priority = PRIORITIES.includes(raw.priority) ? raw.priority : coerce(() => normalizePriority(raw.priority), 'normal');
+  const priority = PRIORITIES.includes(raw.priority) ? raw.priority : coerce(() => normalizePriority(raw.priority), 'none');
   const source = SOURCES.includes(raw.source) ? raw.source : 'human';
   const createdAt = Number.isFinite(raw.createdAt) ? Number(raw.createdAt) : Date.now();
   const updatedAt = Number.isFinite(raw.updatedAt) ? Number(raw.updatedAt) : createdAt;
@@ -81,6 +82,10 @@ export function repairRecord(raw) {
     priority,
     // 相对日期（today/+3d）按「读到的这一刻」折算：手改文件的人想的当然是今天
     due: typeof raw.due === 'string' ? coerce(() => normalizeDue(raw.due, Date.now()), null) : null,
+    // 时间只在有日期时保留（同 createRecord/patchRecord 的约定）
+    dueTime: typeof raw.dueTime === 'string' && typeof raw.due === 'string'
+      ? coerce(() => normalizeDueTime(raw.dueTime), null)
+      : null,
     project: typeof raw.project === 'string' && raw.project.trim() ? raw.project.trim() : null,
     order,
     source,

package/src/store.mjs

@@ -209,7 +209,10 @@ export async function openWorkTodoStore({ ctx, config = {}, logger } = {}) {
 
   // ctx.get 对未提供的服务返回 undefined，不抛错；storage 服务可能晚于本插件注册，
   // 但 dsh-base 的层序在 profile 组合之前，所以这里探测到不存在时才回退。
-  const storageDomain = explicitPath ? undefined : ctx?.get?.('storageDomain') ?? ctx?.storageDomain;
+  // ⚠️ 只用 ctx.get 探测，**绝不**退回 `ctx.storageDomain`：直接访问未在 inject 里声明的服务
+  // 会被 cordis 守卫抛错（"cannot get property … without inject"），而那个异常会让整个插件挂载失败——
+  // 实测插件「时好时坏」就是这里（服务尚未注册时 ctx.get 返回 undefined，兜底访问随即抛错）
+  const storageDomain = explicitPath ? undefined : ctx?.get?.('storageDomain');
 
   if (storageDomain && typeof storageDomain.open === 'function') {
     try {

package/src/tools.mjs

@@ -1,3 +1,5 @@
+import { parseNaturalDue } from './parse-due.mjs';
+
 /**
  * 面向模型的 worktodo_* 工具。
  *
@@ -90,6 +92,7 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
     parameters: {
       title: { type: 'string', required: true, description: '待办内容，一句简短的祈使句，例如「把 v0.1.0 发到 npm」。' },
       due: { type: 'string', description: '截止日期：YYYY-MM-DD / today / tomorrow / +3d。省略表示没有截止日期。' },
+      dueTime: { type: 'string', description: '截止时间 HH:MM（可选，只有给了 due 才有意义；例如 14:30）。' },
       priority: { type: 'string', enum: ['high', 'normal', 'low'], description: '优先级，默认 normal。真正卡住别人的事才给 high。' },
       project: { type: 'string', description: '项目或领域标签，例如 dsh-worktodo。省略表示不归类。' },
       notes: { type: 'string', description: '补充说明：背景、链接、验收标准。默认空。' },
@@ -103,6 +106,7 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
           id: { type: 'string', required: true },
           title: { type: 'string', required: true },
           due: { type: 'string' },
+          dueTime: { type: 'string' },
           priority: { type: 'string', required: true },
           project: { type: 'string' },
           status: { type: 'string', required: true },
@@ -111,15 +115,16 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
       },
       render: (_args, value) => [{
         type: 'text',
-        text: `已记入工作待办：${value.title}（${value.id}${value.due ? `，截止 ${value.due}` : ''}）`
+        text: `已记入工作待办：${value.title}（${value.id}${value.due ? `，截止 ${value.due}${value.dueTime ? ` ${value.dueTime}` : ''}` : ''}）`
           + (value.stats ? `｜当前未完成 ${value.stats.open} 条，逾期 ${value.stats.overdue} 条` : ''),
       }],
     },
     execute(args) {
-      return service.create(args, { source: 'agent' }).then(unwrap).then((result) => withStats(compact({
+      return service.create(withParsedDue(args), { source: 'agent' }).then(unwrap).then((result) => withStats(compact({
         id: result.todo.id,
         title: result.todo.title,
         due: result.todo.due ?? undefined,
+        dueTime: result.todo.dueTime ?? undefined,
         priority: result.todo.priority,
         project: result.todo.project ?? undefined,
         status: result.todo.status,
@@ -145,6 +150,7 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
           properties: {
             title: { type: 'string', required: true, description: '待办内容（一句简短的祈使句）。' },
             due: { type: 'string', description: '截止日期：YYYY-MM-DD / today / tomorrow / +3d。' },
+            dueTime: { type: 'string', description: '截止时间 HH:MM（可选）。' },
             priority: { type: 'string', enum: ['high', 'normal', 'low'], description: '默认 normal。' },
             project: { type: 'string', description: '项目或领域标签。' },
             notes: { type: 'string', description: '背景、链接、验收标准。' },
@@ -169,6 +175,7 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
                 id: { type: 'string', required: true },
                 title: { type: 'string', required: true },
                 due: { type: 'string' },
+                dueTime: { type: 'string' },
                 priority: { type: 'string', required: true },
                 project: { type: 'string' },
                 status: { type: 'string', required: true },
@@ -204,11 +211,12 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
       const items = Array.isArray(args.items) ? args.items : [];
       for (const [index, item] of items.entries()) {
         try {
-          const result = unwrap(await service.create(item ?? {}, { source: 'agent' }));
+          const result = unwrap(await service.create(withParsedDue(item ?? {}), { source: 'agent' }));
           created.push(compact({
             id: result.todo.id,
             title: result.todo.title,
             due: result.todo.due ?? undefined,
+            dueTime: result.todo.dueTime ?? undefined,
             priority: result.todo.priority,
             project: result.todo.project ?? undefined,
             status: result.todo.status,
@@ -261,7 +269,7 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
         lines: result.todos.length
           ? result.todos.map((t) => {
             const box = t.status === 'completed' ? '[x]' : t.status === 'in_progress' ? '[~]' : '[ ]';
-            const bits = [t.priority === 'high' ? '高' : t.priority === 'low' ? '低' : null, t.due ? `${t.due}${t.due < result.today && t.status !== 'completed' ? '(逾期)' : ''}` : null, t.project ? `#${t.project}` : null].filter(Boolean);
+            const bits = [t.priority === 'high' ? '高' : t.priority === 'low' ? '低' : null, t.due ? `${t.due}${t.dueTime ? ` ${t.dueTime}` : ''}${t.due < result.today && t.status !== 'completed' ? '(逾期)' : ''}` : null, t.project ? `#${t.project}` : null].filter(Boolean);
             return `${box} ${t.id}  ${t.title}${bits.length ? `  (${bits.join(', ')})` : ''}`;
           }).join('\n')
           : '（没有符合条件的待办）',
@@ -282,7 +290,8 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
     parameters: {
       ref: { type: 'string', required: true, description: '待办的 id（推荐）或标题。' },
       title: { type: 'string', description: '新标题。' },
-      due: { type: 'string', description: '新截止日期；传 none 清空。' },
+      due: { type: 'string', description: '新截止日期；传 none 清空（清空日期会一并清掉时间）。' },
+      dueTime: { type: 'string', description: '新截止时间 HH:MM；传 none 清空。' },
       priority: { type: 'string', enum: ['high', 'normal', 'low'] },
       project: { type: 'string', description: '新项目标签；传 none 清空。' },
       notes: { type: 'string', description: '新备注。' },
@@ -447,4 +456,23 @@ export async function registerWorkTodoTools({ ctx, service, logger }) {
       }
     },
   };
+}/**
+ * 让工具也能"说人话"：标题里写了「明天下午三点」这类说法时，交给与面板**同一份**解析器
+ * （`src/parse-due.mjs`）。显式传了 `due` 就以显式为准，绝不被标题覆盖。
+ * @param {object} input
+ * @returns {object} 落库用的参数（标题里的日期词会被摘掉）
+ */
+export function withParsedDue(input = {}) {
+  const explicit = input.due !== undefined && input.due !== null && input.due !== '';
+  if (explicit) return input;
+  const parsed = parseNaturalDue(String(input.title ?? ''), Date.now());
+  if (!parsed.matched.length) return input;
+  return {
+    ...input,
+    title: parsed.title,
+    due: parsed.due ?? undefined,
+    dueTime: input.dueTime ?? parsed.dueTime ?? undefined,
+  };
 }
+
+