dsh-global-todo 0.6.6 → 0.6.8

package/CHANGELOG.md

@@ -1,3 +1,33 @@
+## [0.6.8] — 2026-10-20
+
+Every conditional state now has a baseline image, and the harness refuses to render a blank
+one.
+
+- **Four new preview scenarios**: empty list, filter with no match, inbox, and a due reminder.
+  `tools/preview.mjs` grew a `SCENARIOS` table the fake fetch reads, so a state that used to be
+  reachable only by clicking can be rendered and photographed like any other.
+- **`npm run screenshots` writes eight images** (list, detail, selection, settings + the four
+  above). Both READMEs index them in a state table instead of embedding all eight.
+- **`npm run check:render` asserts each state's marker** (`记第一条`, `清除筛选`, the inbox
+  explanation, the reminder title), so a regression shows up as a failing check rather than a
+  silently blank picture.
+
+## [0.6.7] — 2026-10-20
+
+Copy safety, and the last orphan of the old footer.
+
+- **A test now guards the dictionaries.** `test/locale.test.mjs` reads them as source text
+  (a duplicate key is legal JavaScript and invisible at runtime) and fails on: a key defined
+  twice, a key present in one language and missing in the other, full-width punctuation inside
+  English copy, and a literal `t('…')` key that does not exist. It immediately found a real
+  duplicate — `select.clear` — the same class of bug that shipped "more fields" on the overflow
+  menu.
+- **The duplicate is fixed properly**: the selection bar clears with its own key (`清空`/`Clear`)
+  while the pick toggle and the two ask-bars share `清除`/`取消`.
+- **Keyboard shortcuts get a home.** The hints left the footer in 0.6.0 and only survived in the
+  empty state; they now open from `⋯ → Keyboard shortcuts` as a small card with `kbd` chips, and
+  Escape closes it before anything else.
+
 ## [0.6.6] — 2026-10-20
 
 Both forms now look like forms.

package/README.md

@@ -35,6 +35,17 @@ one record:
 
 ![Settings: grouped fields, hints under each label, one save row](docs/screenshots/panel-settings.png)
 
+Every state that only appears under a condition has a fixed baseline image, rendered by the same
+preview and photographed by the same tool:
+
+| State | Image |
+|---|---|
+| Empty list | [`panel-empty.png`](docs/screenshots/panel-empty.png) |
+| Filter with no match | [`panel-filtered.png`](docs/screenshots/panel-filtered.png) |
+| Inbox (awaiting confirmation) | [`panel-inbox.png`](docs/screenshots/panel-inbox.png) |
+| Due reminder | [`panel-reminders.png`](docs/screenshots/panel-reminders.png) |
+| Selection mode | [`panel-select.png`](docs/screenshots/panel-select.png) |
+
 These are produced by `npm run screenshots` (which chains `npm run preview`): the real client
 half is rendered to static HTML with no Host and no dependencies, then photographed at 1280×720
 into `docs/screenshots/`. Playwright is not a dependency — the tool borrows the copy a DSH

package/README.zh.md

@@ -32,6 +32,16 @@ DSH 自带的 `todo_write` 属于**某一个 agent 会话**：整表替换、三
 
 ![设置：分组字段、说明写在标签下方、底部一行保存](docs/screenshots/panel-settings.png)
 
+每个「只在特定情况下出现」的面板状态都有一张固定基线图，由同一套预览渲染、同一支工具拍摄，改样式时可以直接对比：
+
+| 状态 | 图片 |
+|---|---|
+| 清单为空 | [`panel-empty.png`](docs/screenshots/panel-empty.png) |
+| 筛选无结果 | [`panel-filtered.png`](docs/screenshots/panel-filtered.png) |
+| 收件箱（待确认） | [`panel-inbox.png`](docs/screenshots/panel-inbox.png) |
+| 到点提醒 | [`panel-reminders.png`](docs/screenshots/panel-reminders.png) |
+| 批量选择 | [`panel-select.png`](docs/screenshots/panel-select.png) |
+
 图都由 `npm run screenshots`（内部串起 `npm run preview`）生成：先把真实的客户端半区渲染成静态
 HTML（不依赖宿主、零依赖），再以 1280×720 拍进 `docs/screenshots/`。Playwright 不是依赖——工具
 借的是 DSH profile 里已经装好的那份，或 `DSH_PLAYWRIGHT` 指向的那份。

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 = 'ui42'
+    const UI_REV = 'ui44'
     /** Last language resolved for the shell; module-level so a fetch failure can be worded too. */
     let activeLang = 'zh'
 
@@ -106,6 +106,11 @@ window.__ModuleLoader__.load({
       'settings.cancel': '取消',
       'settings.saved': '设置已保存',
       'settings.about': '关于',
+      'action.keys': '快捷键',
+      'keys.search': '聚焦搜索',
+      'keys.new': '开始记一条',
+      'keys.save': '保存这条（在标题里）',
+      'keys.close': '收起最内层浮层',
       'group.actions': '分组操作',
       'group.capture': '从本对话抓取',
       'group.exemptOn': '本工作区免打扰',
@@ -139,7 +144,7 @@ window.__ModuleLoader__.load({
       'notice.bulkPartial': '已更新 {n} 条，跳过 {m} 条',
       'select.clear': '清除',
       'select.done': '退出选择',
-      'select.clear': '清空',
+      'select.clearAll': '清空',
       'select.hint': '先勾几条待办，再点「一键分配」：优先回到写下它的那个对话，其次同工作区的对话，都找不到才让你选。',
       'assign.working': '正在分配…',
       'assign.summary': '已分配 {n} 条（原对话 {origin} · 同工作区 {workspace} · 你选的 {chosen}）',
@@ -367,6 +372,11 @@ window.__ModuleLoader__.load({
       'settings.cancel': 'Cancel',
       'settings.saved': 'Settings saved',
       'settings.about': 'About',
+      'action.keys': 'Keyboard shortcuts',
+      'keys.search': 'Focus the search box',
+      'keys.new': 'Start a new todo',
+      'keys.save': 'Save it (from the title field)',
+      'keys.close': 'Close the innermost layer',
       'group.actions': 'Group actions',
       'group.capture': 'Collect from this conversation',
       'group.exemptOn': 'Mute this workspace',
@@ -400,6 +410,7 @@ window.__ModuleLoader__.load({
       'notice.bulkPartial': 'Updated {n}, skipped {m}',
       'select.clear': 'Clear',
       'select.done': 'Exit selection',
+      'select.clearAll': 'Clear',
       'select.hint': 'Pick a few todos, then Assign: back to the conversation that wrote each one, else a conversation in the same workspace, else you choose.',
       'assign.working': 'Assigning…',
       'assign.summary': 'Assigned {n} ({origin} to origin · {workspace} same workspace · {chosen} chosen)',
@@ -1169,6 +1180,9 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
 .gt-about-row { display: grid; grid-template-columns: 88px minmax(0, 1fr); align-items: baseline; gap: 8px; }
 .gt-settings-foot { display: flex; flex: 0 0 auto; justify-content: flex-end; gap: 8px;
   padding: 12px 16px; border-top: 1px solid var(--dsw-alias-border-l1); }
+.gt-keys { width: 320px; }
+.gt-key-row { display: flex; align-items: center; gap: 10px; }
+.gt-key-row .gt-kbd { min-width: 44px; text-align: center; }
 .gt-group-select { display: none; min-height: 28px; max-width: 150px; padding: 0 8px; font: inherit;
   font-size: 12px; color: var(--dsw-alias-label-primary); background: var(--dsw-alias-bg-layer-1);
   border: 1px solid var(--dsw-alias-border-l1); border-radius: 8px; }
@@ -2239,7 +2253,8 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       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')
+      // The static preview asks for a starting view it cannot click its way into.
+      const [filter, setFilter] = useState(typeof props.initialFilter === 'string' ? props.initialFilter : 'active')
       const [query, setQuery] = useState('')
       // Multi-select for batch assignment. A separate mode, because the round control on
       // each row already means "done".
@@ -2279,6 +2294,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
       // One settings popover: reminders and the external door both need a place a person can
       // reach without curl.
       const [settingsOpen, setSettingsOpen] = useState(initialSettingsOpen)
+      const [keysOpen, setKeysOpen] = useState(false)
       const [settingsBox, setSettingsBox] = useState(null)
       // The detail card's breakpoint follows the panel's own width, not the viewport: the
       // slot is ~265px narrower than the window, so a viewport query opens the two-column
@@ -2637,6 +2653,10 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
             (target.tagName === 'INPUT' || target.tagName === 'TEXTAREA' || target.isContentEditable === true)
           if (event.key === 'Escape') {
             if (typing && typeof target.blur === 'function') target.blur()
+            if (keysOpen) {
+              setKeysOpen(false)
+              return
+            }
             if (settingsOpen) {
               setSettingsOpen(false)
               return
@@ -2659,7 +2679,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
         }
         document.addEventListener('keydown', onKey)
         return () => document.removeEventListener('keydown', onKey)
-      }, [settingsOpen, adding])
+      }, [settingsOpen, keysOpen, adding])
 
       // The settings card floats over the list, so a click anywhere else dismisses it
       // the way every other popover on the web does.
@@ -3389,6 +3409,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                 { key: 'export', label: t('action.export'), icon: 'doc', onSelect: () => void exportJson() },
                 { key: 'import', label: t('action.import'), icon: 'plus', onSelect: () => importRef.current?.click?.() },
                 { key: 'settings', label: t('settings.title'), icon: 'gear', onSelect: () => openSettings() },
+                { key: 'keys', label: t('action.keys'), icon: 'kebab', onSelect: () => setKeysOpen(true) },
               ],
             }),
             ),
@@ -3554,6 +3575,57 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
               )
             : null,
 
+          // The keyboard hints used to sit in a footer nobody read; they belong where the
+          // other occasional things live, one menu away.
+          keysOpen
+            ? h(
+                'div',
+                {
+                  ref: settingsRef,
+                  className: 'gt-settings gt-keys',
+                  role: 'dialog',
+                  'aria-label': t('action.keys'),
+                  style:
+                    settingsBox === null
+                      ? undefined
+                      : {
+                          position: 'fixed',
+                          top: `${settingsBox.top}px`,
+                          right: `${settingsBox.right}px`,
+                          maxHeight: `calc(100dvh - ${settingsBox.top + 20}px)`,
+                          zIndex: 40,
+                        },
+                },
+                h(
+                  'div',
+                  { className: 'gt-settings-head' },
+                  h('span', { className: 'gt-settings-title' }, t('action.keys')),
+                  h(
+                    'button',
+                    { type: 'button', className: 'gt-iconbtn', title: t('action.hide'), 'aria-label': t('action.hide'), onClick: () => setKeysOpen(false) },
+                    h(Icon, { name: 'close', size: 13 }),
+                  ),
+                ),
+                h(
+                  'div',
+                  { className: 'gt-settings-body' },
+                  [
+                    ['/', t('keys.search')],
+                    ['n', t('keys.new')],
+                    ['Enter', t('keys.save')],
+                    ['Esc', t('keys.close')],
+                  ].map(([combo, sentence]) =>
+                    h(
+                      'div',
+                      { className: 'gt-key-row', key: combo },
+                      h('span', { className: 'gt-kbd' }, combo),
+                      h('span', { className: 'gt-hint' }, sentence),
+                    ),
+                  ),
+                ),
+              )
+            : null,
+
           error !== null
             ? h(
                 'div',
@@ -3949,7 +4021,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                 h(
                   'button',
                   { type: 'button', className: 'gt-btn gt-btn-quiet', onClick: () => setSelected({}) },
-                  t('select.clear'),
+                  t('select.clearAll'),
                 ),
                 h('span', { className: 'gt-spacer' }),
                 h(
@@ -4112,7 +4184,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                 h(
                   'button',
                   { type: 'button', className: 'gt-btn gt-btn-quiet', onClick: () => setAssignAsk(null) },
-                  t('select.clear'),
+                  t('action.cancel'),
                 ),
               ),
 
@@ -4138,7 +4210,7 @@ button.gt-chip[data-on="1"] { color: var(--dsw-alias-label-primary); border-colo
                 h(
                   'button',
                   { type: 'button', className: 'gt-btn gt-btn-quiet', onClick: () => setImportAsk(null) },
-                  t('select.clear'),
+                  t('action.cancel'),
                 ),
               ),
 

package/lib/index.js

@@ -36,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.6.6'
+export const VERSION = '0.6.8'
 
 /** Plugin id. Also the Loader row id in `cordis.patch.yml`. */
 export const name = 'dsh-global-todo'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-global-todo",
-  "version": "0.6.6",
+  "version": "0.6.8",
   "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",