dsh-global-todo 0.12.1 → 0.12.3

package/CHANGELOG.md

@@ -1,3 +1,30 @@
+## [0.12.3] — 2026-10-21
+
+A desktop report explained, and the packaging contract behind it guarded.
+
+- **`docs/FAQ.md` §15** answers `Plugin metadata … ENOENT … \locale`: the Host resolves
+  `<pkg>/locale/en.json` through the `exports` wildcard (which Node resolves **without** checking
+  the file), then scans that directory. A hand-copied `plugins-local` folder that kept `lib/`,
+  `package.json` and the patch but dropped `locale/` therefore reports this — while the plugin
+  itself still loads. The entry gives both fixes (install from npm, or copy `locale/` and
+  `docs/icon.svg` into the local folder) and says the metadata is read once at startup.
+- **`test/manifest.test.mjs` now asserts the contract**: the `./locale/*.json` export exists and
+  `locale` is in `files`. Drop either and the plugins page silently loses its title, description
+  and icon — the exact failure that shipped as a user-visible error.
+
+## [0.12.2] — 2026-10-21
+
+The description reached the last two places it was still thin.
+
+- **The panel's own subtitle** (under the title, always visible) now names what the list does
+  rather than just what it is: `跨会话一份清单：你和 Agent 都能加，也能带着步骤交给对话继续干`.
+- **The landing page copy** matches the plugin page and the store: hero lede, the meta
+  description, `og:description` and `twitter:description` all say the same three things — one
+  shared file, steps travel with the hand-off, and done needs your confirmation.
+- **`docs/og.png` re-rendered** with the new sentence, so a shared link and the page agree.
+- Screenshots and `tour.gif` regenerated: the old frames still carried the previous subtitle.
+  The captioned demo video was not rebuilt — that needs the capture harness against a live panel.
+
 ## [0.12.1] — 2026-10-21
 
 The plugin now says what it does — in the two places people read before installing.

package/docs/FAQ.md

@@ -157,3 +157,34 @@ rm -r "$DSH_HOME/global-todo"
 失败一定带原因，也记在详情的「最近派发」里；不会静默什么都不做。
 
 
+## 15. 桌面端报 `Plugin metadata … ENOENT … \locale` 是什么？
+
+**插件本身已经加载了，这是「显示文字」取不到**，不影响面板和工具。宿主读插件页标题/描述的顺序是：
+先解析 `<包>/locale/en.json`（走 `exports` 里的 `./locale/*.json`），解析成功后**扫这个目录**，
+把 `zh.json`/`en.json` 逐个读进来。目录不存在，扫描就抛 ENOENT，于是元信息报错。
+
+也就是说：**你那份本地插件目录缺 `locale/` 文件夹**。常见于把仓库文件夹手动复制到
+`%USERPROFILE%\.dsh\plugins-local\` 时只拷了 `lib`、`package.json`、`cordis.patch.yml`。
+
+修法二选一：
+
+1. **推荐**：别用本地目录，直接装 npm 包（包里有 `locale/en.json`、`locale/zh.json`）：
+
+   ```powershell
+   dsh plugin add dsh-global-todo
+   ```
+
+2. 保留本地目录，把缺的补齐（`$src` 换成仓库或 npm 包里那份）：
+
+   ```powershell
+   $dst = "$env:USERPROFILE\.dsh\plugins-local\全局待办插件"
+   $src = "C:\path\to\dsh-global-todo"
+   New-Item -ItemType Directory -Force "$dst\locale" | Out-Null
+   Copy-Item "$src\locale\*.json" "$dst\locale\" -Force
+   Copy-Item "$src\docs\icon.svg" "$dst\docs\" -Force   # 图标同理会报错
+   ```
+
+   然后重启宿主（插件元信息在启动时读一次）。
+
+为什么会这么脆：`exports` 的 `./locale/*.json` 是**通配映射**，Node 解析它时不检查文件是否存在，
+所以宿主以为文件在、去扫目录，才发现没有。完整安装不会触发；只有手工拷半份才会。

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 = 'ui52'
+    const UI_REV = 'ui53'
     /** Last language resolved for the shell; module-level so a fetch failure can be worded too. */
     let activeLang = 'zh'
 
@@ -59,7 +59,7 @@ window.__ModuleLoader__.load({
     const zh = {
       'entry.label': '待办',
       'panel.title': '全局待办',
-      'panel.subtitle': '跨会话一份清单，人和 Agent 都能加',
+      'panel.subtitle': '跨会话一份清单：你和 Agent 都能加，也能带着步骤交给对话继续干',
       'action.refresh': '刷新',
       'action.retry': '重试',
       'action.add': '添加',
@@ -356,7 +356,7 @@ window.__ModuleLoader__.load({
     const en = {
       'entry.label': 'Todos',
       'panel.title': 'Global todos',
-      'panel.subtitle': 'One list across sessions, written by you and the agent',
+      'panel.subtitle': 'One list across sessions - you and the agent write it, and hand items on with their steps',
       'action.refresh': 'Refresh',
       'action.retry': 'Retry',
       'action.add': 'Add',

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.12.1'
+export const VERSION = '0.12.3'
 
 /** 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.12.1",
+  "version": "0.12.3",
   "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",