dsh-tiddlywiki 0.33.1 → 0.33.2

package/docs/CHANGELOG.md

@@ -4,6 +4,12 @@
 
 > 最近几个主要版本的一句话记录（完整变更见 [Releases](https://github.com/bbqisbbq/dsh-tiddlywiki/releases) / git log）。
 
+- **v0.33.2**（2026-10-26）：**`.tid` 预览仍不生效 —— 这次是"服务还没出现就放弃"**。
+v0.33.1 修好了 `key` 配对，但用户实测仍是纯文本，且 devtools 里 `[class*="dsh-tw-tid"]` 数量为 0（正文组件压根没渲染）。
+根因在插件的**加载顺序**：`documentPreviews` 是另一个插件（宿主的 `dsh-client-ui-sidebar-documentpreview`）用 `ctx.reflect.provide(...)` 提供的，本插件若先加载，`ctx.get(...)` 那一瞬间拿到 `undefined`，v0.32/0.33.0/0.33.1 就**静默 return** 了 —— 界面上看不出差别（宿主用内置纯文本兜底），console 里也一条日志都没有，等于把失败藏起来。
+现在改成**短轮询等它出现**（250ms × 40 ≈ 10s），并给每一步补 `[dsh-tiddlywiki]` 前缀的诊断日志：`ctx.get`/`ctx.slots` 是否存在、第几次尝试注册上元数据、正文是否注册进 keyed 子槽、等不到时的 warn。正文外壳加 `data-dsh-tw-tid` 标记，devtools 里一条 `document.querySelectorAll('[data-dsh-tw-tid]').length` 就能判定我们的组件到底有没有渲染。
+守门同步改判据：不再钉"查一次就返回"，改钉 `setTimeout(attempt, 250)` 的轮询、`getter('documentPreviews')` 的取值形态、以及"服务始终没出现"那条可诊断 warn —— 静默跳过从这一版起是**被测出来的**行为，不再是遗漏。
+
 - **v0.33.1**（2026-10-26）：**`.tid` 预览改为真正生效**（v0.32.0 那一版静默失效：打开 `.tid` 仍显示纯文本）。
 根因是宿主契约里我读错的一处：DSH 的文件预览分「元数据 + keyed 正文」两半，**正文按 `key` 配对** ——
 宿主自己写的是 `ctx.slots.register({ name: sidebar.right.tab.document, key: BODY_ID }, Body)`，而 v0.32.0 写成了 `id:`。

package/lib/client.js

@@ -962,7 +962,7 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
 `),n=t.indexOf(`
 
 `),r=n<0?t:t.slice(0,n),i=n<0?``:t.slice(n+2),a=[],o,s=r.trim().length>0;for(let e of r.split(`
-`)){if(e.trim().length===0)continue;let t=/^([^\s:][^:]*):\s?(.*)$/.exec(e);if(t===null){s=!1;continue}let n=(t[1]??``).trim(),r=(t[2]??``).trim();n.length!==0&&(n===`title`?o=r:a.push([n,r]))}return n<0&&(!s||o===void 0&&a.length===0)?{fields:[],text:t}:{...o===void 0?{}:{title:o},fields:a,text:i}}function FS(e){let t=e?.content;if(typeof t==`string`)return t;if(typeof t!=`object`||!t)return``;let n=t;if(typeof n.text==`string`)return n.text;let r=n.pages,i=[];if(Array.isArray(r)){for(let e of r)if(typeof e==`object`&&e){let t=e;i.push({offset:typeof t.offset==`number`?t.offset:0,text:typeof t.text==`string`?t.text:``})}}else if(typeof r==`object`&&r){for(let[e,t]of Object.entries(r))if(typeof t==`object`&&t){let n=t;i.push({offset:Number(e)||0,text:typeof n.text==`string`?n.text:``})}}return i.sort((e,t)=>e.offset-t.offset).map(e=>e.text).join(``)}async function IS(e,t){try{let n=await fetch(De(ne,t),{method:`POST`,headers:{"content-type":`application/json`,"x-requested-with":`TiddlyWiki`},body:JSON.stringify({text:e}),signal:AbortSignal.timeout(15e3)});if(!n.ok)return null;let r=await n.text();return r.trim().length>0?r:null}catch{return null}}function LS(){return function(e){let t=FS(e),n=c.useMemo(()=>PS(t),[t]),[r,i]=c.useState(null),[a,o]=c.useState(!1);c.useEffect(()=>{let e=!0;return o(!1),n.text.trim().length===0?(i(null),()=>{e=!1}):(IS(n.text).then(t=>{e&&(t===null?(o(!0),i(null)):i(t))}),()=>{e=!1})},[n.text]);let s=[];n.title!==void 0&&n.title.length>0&&s.push(c.createElement(`div`,{key:`title`,className:`dsh-tw-tid-title`},`📄 ${n.title}`)),n.fields.length>0&&s.push(c.createElement(`div`,{key:`fields`,className:`dsh-tw-tid-fields`},n.fields.map(([e,t])=>c.createElement(`span`,{key:e,className:`dsh-tw-tid-field`},`${e}: ${t.length>60?`${t.slice(0,60)}…`:t}`))));let l;return l=t.trim().length===0?c.createElement(`div`,{className:`dsh-tw-tid-empty`},S(`frame.tidPreviewWaiting`)):n.text.trim().length===0?c.createElement(`div`,{className:`dsh-tw-tid-empty`},S(`frame.tidPreviewNoBody`)):r===null?c.createElement(`div`,{className:`dsh-tw-tid-raw`},a?c.createElement(`div`,{className:`dsh-tw-tid-note`},S(`frame.tidPreviewFallback`)):null,c.createElement(`pre`,null,n.text)):c.createElement(`div`,{className:`dsh-tw-tid-body`,dangerouslySetInnerHTML:{__html:r}}),c.createElement(`div`,{className:`dsh-tw-tid-preview`},...s,l)}}function RS(e){let t=[],n=e.get?.(`documentPreviews`);if(n===void 0)return t;try{t.push(n.register({id:jS,extensions:[...MS],priority:`external`,title:()=>S(`frame.tidPreviewTitle`),loading:`text-pages`,wrap:!1}))}catch(e){return console.warn(`[dsh-tiddlywiki] tid preview registration failed:`,e),t}let r=e.slots;if(r===void 0){for(let e of t.splice(0))e();return t}let i=r.inject(NS,()=>r.register({name:NS,key:jS},LS()));return i!==void 0&&t.push(i),t}const zS=[`slots`];function BS(e){try{let t=[],n=!1,r=()=>{n=!0;for(let e of t.splice(0))e()},i=(e,t)=>{try{t()}catch(t){console.error(`[dsh-tiddlywiki] ${e} failed:`,t)}};i(`styles`,()=>t.push(T()));let a=new ee,o,s;if(i(`quick-note widget`,()=>{o=Ub(),t.push(()=>o?.dispose())}),i(`sync controller`,()=>{s=Kb(),t.push(()=>s?.dispose())}),i(`sidebar entry`,()=>t.push(st(a))),i(`center panel`,()=>t.push(tn(a))),o!==void 0&&s!==void 0){let e=o,n=s;i(`knowledge FAB`,()=>t.push(Xb(a,e,n)))}i(`editor popup`,()=>t.push(mn)),e.slots!==void 0&&Le().then(r=>{if(n)return;let a=o;r.showQuickNoteDock&&a!==void 0&&i(`quick-note dock`,()=>{let n=e.slots?.inject(`conversation.input.dock`,()=>e.slots?.register({name:`conversation.input.dock`,id:`quick-note`,order:8,label:S(`chrome.dockQuickNote`)},Qb(a)));n!==void 0&&t.push(n)}),i(`wiki scope seat`,()=>{let n=e.slots?.inject(`conversation.input.left`,()=>e.slots?.register({name:`conversation.input.left`,id:`wiki-scope`,order:9,label:S(`chrome.scopeSlotLabel`)},ox()));n!==void 0&&t.push(n)}),i(`session summary tab`,()=>{let n=dx(e.slots,r);n!==void 0&&t.push(n)})}).catch(e=>{console.error(`[dsh-tiddlywiki] ui config load failed:`,e)}),i(`rightbar mount`,()=>{let r,i=a=>{let o=e.get?.(`sidebarRightTabs`);if(o===void 0){a<6&&!n&&(r=window.setTimeout(()=>i(a+1),500*(a+1)));return}Le().then(r=>{if(n||!r.showRightbarTab)return;let i=AS(o,e.slots);i!==void 0&&t.push(i)}).catch(e=>{console.error(`[dsh-tiddlywiki] rightbar config load failed:`,e)})};t.push(()=>{r!==void 0&&window.clearTimeout(r)}),i(0)}),i(`tool views`,()=>{e.slots!==void 0&&t.push(...TS(e.slots))}),i(`wiki link interceptor`,()=>t.push(bS())),i(`tid preview`,()=>t.push(...RS(e))),i(`locale registration`,()=>t.push(...p(e.get))),i(`settings section`,()=>{let n=e.slots?.inject(`settings.section`,()=>e.slots?.register({name:`settings.section`,id:`dsh-tiddlywiki`,order:50,label:S(`frame.settingsSection`)},Vx));n!==void 0&&t.push(n)}),e.effect===void 0?window.addEventListener(`pagehide`,r,{once:!0}):e.effect(()=>r,`dsh-tiddlywiki: client mount`)}catch(e){console.error(`[dsh-tiddlywiki] client half failed to start:`,e)}}exports.apply=BS,exports.inject=zS,exports.name=`dsh-tiddlywiki/client`;
+`)){if(e.trim().length===0)continue;let t=/^([^\s:][^:]*):\s?(.*)$/.exec(e);if(t===null){s=!1;continue}let n=(t[1]??``).trim(),r=(t[2]??``).trim();n.length!==0&&(n===`title`?o=r:a.push([n,r]))}return n<0&&(!s||o===void 0&&a.length===0)?{fields:[],text:t}:{...o===void 0?{}:{title:o},fields:a,text:i}}function FS(e){let t=e?.content;if(typeof t==`string`)return t;if(typeof t!=`object`||!t)return``;let n=t;if(typeof n.text==`string`)return n.text;let r=n.pages,i=[];if(Array.isArray(r)){for(let e of r)if(typeof e==`object`&&e){let t=e;i.push({offset:typeof t.offset==`number`?t.offset:0,text:typeof t.text==`string`?t.text:``})}}else if(typeof r==`object`&&r){for(let[e,t]of Object.entries(r))if(typeof t==`object`&&t){let n=t;i.push({offset:Number(e)||0,text:typeof n.text==`string`?n.text:``})}}return i.sort((e,t)=>e.offset-t.offset).map(e=>e.text).join(``)}async function IS(e,t){try{let n=await fetch(De(ne,t),{method:`POST`,headers:{"content-type":`application/json`,"x-requested-with":`TiddlyWiki`},body:JSON.stringify({text:e}),signal:AbortSignal.timeout(15e3)});if(!n.ok)return null;let r=await n.text();return r.trim().length>0?r:null}catch{return null}}function LS(){return function(e){let t=FS(e),n=c.useMemo(()=>PS(t),[t]),[r,i]=c.useState(null),[a,o]=c.useState(!1);c.useEffect(()=>{let e=!0;return o(!1),n.text.trim().length===0?(i(null),()=>{e=!1}):(IS(n.text).then(t=>{e&&(t===null?(o(!0),i(null)):i(t))}),()=>{e=!1})},[n.text]);let s=[];n.title!==void 0&&n.title.length>0&&s.push(c.createElement(`div`,{key:`title`,className:`dsh-tw-tid-title`},`📄 ${n.title}`)),n.fields.length>0&&s.push(c.createElement(`div`,{key:`fields`,className:`dsh-tw-tid-fields`},n.fields.map(([e,t])=>c.createElement(`span`,{key:e,className:`dsh-tw-tid-field`},`${e}: ${t.length>60?`${t.slice(0,60)}…`:t}`))));let l;return l=t.trim().length===0?c.createElement(`div`,{className:`dsh-tw-tid-empty`},S(`frame.tidPreviewWaiting`)):n.text.trim().length===0?c.createElement(`div`,{className:`dsh-tw-tid-empty`},S(`frame.tidPreviewNoBody`)):r===null?c.createElement(`div`,{className:`dsh-tw-tid-raw`},a?c.createElement(`div`,{className:`dsh-tw-tid-note`},S(`frame.tidPreviewFallback`)):null,c.createElement(`pre`,null,n.text)):c.createElement(`div`,{className:`dsh-tw-tid-body`,dangerouslySetInnerHTML:{__html:r}}),c.createElement(`div`,{className:`dsh-tw-tid-preview`,"data-dsh-tw-tid":jS},...s,l)}}function RS(e){let t=[],n=typeof e.get==`function`?e.get.bind(e):void 0;if(console.info(`[dsh-tiddlywiki] tid preview: ctx.get=`+(n===void 0?`missing`:`present`)+`, ctx.slots=`+(e.slots===void 0?`missing`:`present`)),n===void 0)return t;let r=0,i,a=!1,o=()=>{if(a)return;r+=1;let s=n(`documentPreviews`);if(s==null){if(r>=40){console.warn(`[dsh-tiddlywiki] tid preview: documentPreviews never appeared after `+r+` attempts; .tid files will fall back to the builtin plain-text preview`);return}i=setTimeout(o,250);return}a=!0;try{t.push(s.register({id:jS,extensions:[...MS],priority:`external`,title:()=>S(`frame.tidPreviewTitle`),loading:`text-pages`,wrap:!1})),console.info(`[dsh-tiddlywiki] tid preview: metadata registered on attempt `+r+` (id=dsh-tiddlywiki-tid, suffixes=`+MS.join(`/`)+`)`)}catch(e){console.warn(`[dsh-tiddlywiki] tid preview registration failed:`,e);return}let c=e.slots;if(c===void 0){console.warn(`[dsh-tiddlywiki] tid preview: no ctx.slots; rolling back the metadata registration`);for(let e of t.splice(0))e();return}let l=c.inject(NS,()=>c.register({name:NS,key:jS},LS()));l===void 0?console.warn(`[dsh-tiddlywiki] tid preview: body registration failed (slot sidebar.right.tab.document)`):(t.push(l),console.info(`[dsh-tiddlywiki] tid preview: body registered into sidebar.right.tab.document with key=dsh-tiddlywiki-tid`))};return o(),[()=>{a=!0,i!==void 0&&clearTimeout(i);for(let e of t.splice(0))e()}]}const zS=[`slots`];function BS(e){try{let t=[],n=!1,r=()=>{n=!0;for(let e of t.splice(0))e()},i=(e,t)=>{try{t()}catch(t){console.error(`[dsh-tiddlywiki] ${e} failed:`,t)}};i(`styles`,()=>t.push(T()));let a=new ee,o,s;if(i(`quick-note widget`,()=>{o=Ub(),t.push(()=>o?.dispose())}),i(`sync controller`,()=>{s=Kb(),t.push(()=>s?.dispose())}),i(`sidebar entry`,()=>t.push(st(a))),i(`center panel`,()=>t.push(tn(a))),o!==void 0&&s!==void 0){let e=o,n=s;i(`knowledge FAB`,()=>t.push(Xb(a,e,n)))}i(`editor popup`,()=>t.push(mn)),e.slots!==void 0&&Le().then(r=>{if(n)return;let a=o;r.showQuickNoteDock&&a!==void 0&&i(`quick-note dock`,()=>{let n=e.slots?.inject(`conversation.input.dock`,()=>e.slots?.register({name:`conversation.input.dock`,id:`quick-note`,order:8,label:S(`chrome.dockQuickNote`)},Qb(a)));n!==void 0&&t.push(n)}),i(`wiki scope seat`,()=>{let n=e.slots?.inject(`conversation.input.left`,()=>e.slots?.register({name:`conversation.input.left`,id:`wiki-scope`,order:9,label:S(`chrome.scopeSlotLabel`)},ox()));n!==void 0&&t.push(n)}),i(`session summary tab`,()=>{let n=dx(e.slots,r);n!==void 0&&t.push(n)})}).catch(e=>{console.error(`[dsh-tiddlywiki] ui config load failed:`,e)}),i(`rightbar mount`,()=>{let r,i=a=>{let o=e.get?.(`sidebarRightTabs`);if(o===void 0){a<6&&!n&&(r=window.setTimeout(()=>i(a+1),500*(a+1)));return}Le().then(r=>{if(n||!r.showRightbarTab)return;let i=AS(o,e.slots);i!==void 0&&t.push(i)}).catch(e=>{console.error(`[dsh-tiddlywiki] rightbar config load failed:`,e)})};t.push(()=>{r!==void 0&&window.clearTimeout(r)}),i(0)}),i(`tool views`,()=>{e.slots!==void 0&&t.push(...TS(e.slots))}),i(`wiki link interceptor`,()=>t.push(bS())),i(`tid preview`,()=>t.push(...RS(e))),i(`locale registration`,()=>t.push(...p(e.get))),i(`settings section`,()=>{let n=e.slots?.inject(`settings.section`,()=>e.slots?.register({name:`settings.section`,id:`dsh-tiddlywiki`,order:50,label:S(`frame.settingsSection`)},Vx));n!==void 0&&t.push(n)}),e.effect===void 0?window.addEventListener(`pagehide`,r,{once:!0}):e.effect(()=>r,`dsh-tiddlywiki: client mount`)}catch(e){console.error(`[dsh-tiddlywiki] client half failed to start:`,e)}}exports.apply=BS,exports.inject=zS,exports.name=`dsh-tiddlywiki/client`;
 		return module.exports;
 	}
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-tiddlywiki",
   "description": "把 TiddlyWiki 5 变成你和 Agent 共用的本地文档中心（纯文本 + git）：你在 DSH 界面里阅读、写作、记日记，Agent 用 16 个 tiddlywiki_* 工具读写同一批笔记；每条笔记都是你能读、能改、能审计、能随时带走的文件——不是自动记忆插件，不做后台抓取。可选一键发布到微信公众号草稿箱。 Turn TiddlyWiki 5 into a document center you and your agent share, in plain text under git — a knowledge base you can read, edit, audit and take with you, not an auto-memory plugin. Mounts via the official dsh plugin system; no DSH source changes.",
-  "version": "0.33.1",
+  "version": "0.33.2",
   "type": "module",
   "keywords": [
     "dsh",

package/src/client/tid-preview.ts

@@ -148,7 +148,7 @@ export function createTidPreviewBody(): (props: unknown) => React.ReactElement {
       )
     }
 
-    return React.createElement('div', { className: 'dsh-tw-tid-preview' }, ...head, body)
+    return React.createElement('div', { className: 'dsh-tw-tid-preview', 'data-dsh-tw-tid': TID_PREVIEW_ID }, ...head, body)
   }
 }
 
@@ -187,40 +187,85 @@ interface PreviewCtx {
 /**
  * 注册 `.tid` 预览（元数据 + 正文**成对**）。
  *
- * 宿主没有 `documentPreviews` 服务时**什么都不做**（老版本 DSH 不受影响）。
- * 任何一步抛错都只记日志并回滚已注册的那一半 —— 单边注册会让宿主按 id 找不到正文。
+ * 为什么要「等」而不是查一次：`documentPreviews` 是**另一个插件**（宿主的
+ * `dsh-client-ui-sidebar-documentpreview`）用 `ctx.reflect.provide('documentPreviews', …)`
+ * 提供的。如果本插件先加载，`ctx.get('documentPreviews')` 那一刻还是 `undefined` ——
+ * v0.32/0.33.0 就是在这里**静默放弃**的（用户看到的仍是内置纯文本，console 里
+ * 一条日志都没有，排查成本极高）。现在改成**短轮询**（250ms × 40 ≈ 10s）：
+ * 服务一出现就注册；始终没出现才记一条 warn 说明原因。
+ *
+ * 诊断日志都带 `[dsh-tiddlywiki]` 前缀，方便在 devtools 里一眼认出是我们的。
  */
 export function registerTidPreview(ctx: PreviewCtx): Array<() => void> {
   const disposers: Array<() => void> = []
-  const previews = ctx.get?.('documentPreviews') as DocumentPreviewsFace | undefined
-  if (previews === undefined) return disposers
-  try {
-    disposers.push(
-      previews.register({
-        id: TID_PREVIEW_ID,
-        extensions: [...TID_EXTENSIONS],
-        // 外部实现压过宿主的纯文本兜底（宿主按 `priority === 'builtin'` 分档）。
-        priority: 'external',
-        // 宿主自己传的是函数（`) => t('viewer.text')`），语言切换时能重取。
-        title: () => t('frame.tidPreviewTitle'),
-        loading: 'text-pages',
-        wrap: false,
-      }),
-    )
-  } catch (err) {
-    // 开发者日志，不是用户文案（与仓库其它模块的 console.warn 同一性质）。
-    console.warn('[dsh-tiddlywiki] tid preview registration failed:', err)
+  const getter = typeof ctx.get === 'function' ? ctx.get.bind(ctx) : undefined
+  console.info('[dsh-tiddlywiki] tid preview: ctx.get=' + (getter === undefined ? 'missing' : 'present') + ', ctx.slots=' + (ctx.slots === undefined ? 'missing' : 'present'))
+  if (getter === undefined) {
+    // 没有服务读取器 ⇒ 这个宿主版本给不了 documentPreviews，按设计跳过。
     return disposers
   }
-  const slots = ctx.slots
-  if (slots === undefined) {
-    // 元数据已注册但没有正文 → 宿主会拿不到渲染器，宁可整体撤回。
-    for (const dispose of disposers.splice(0)) dispose()
-    return disposers
+
+  let attempts = 0
+  let timer: ReturnType<typeof setTimeout> | undefined
+  let done = false
+
+  const attempt = (): void => {
+    if (done) return
+    attempts += 1
+    const previews = getter('documentPreviews') as DocumentPreviewsFace | undefined
+    if (previews === undefined || previews === null) {
+      if (attempts >= 40) {
+        // 开发者日志（客户端守门禁止中文字面量，故一律英文）
+        console.warn('[dsh-tiddlywiki] tid preview: documentPreviews never appeared after ' + attempts + ' attempts; .tid files will fall back to the builtin plain-text preview')
+        return
+      }
+      timer = setTimeout(attempt, 250)
+      return
+    }
+    done = true
+    try {
+      disposers.push(
+        previews.register({
+          id: TID_PREVIEW_ID,
+          extensions: [...TID_EXTENSIONS],
+          // 外部实现压过宿主的纯文本兜底（宿主按 `priority === 'builtin'` 分档）。
+          priority: 'external',
+          // 宿主自己传的是函数（`) => t('viewer.text')`），语言切换时能重取。
+          title: () => t('frame.tidPreviewTitle'),
+          loading: 'text-pages',
+          wrap: false,
+        }),
+      )
+      console.info('[dsh-tiddlywiki] tid preview: metadata registered on attempt ' + attempts + ' (id=' + TID_PREVIEW_ID + ', suffixes=' + TID_EXTENSIONS.join('/') + ')')
+    } catch (err) {
+      // 开发者日志，不是用户文案（与仓库其它模块的 console.warn 同一性质）。
+      console.warn('[dsh-tiddlywiki] tid preview registration failed:', err)
+      return
+    }
+    const slots = ctx.slots
+    if (slots === undefined) {
+      // 元数据已注册但没有正文 → 宿主会拿不到渲染器，宁可整体撤回。
+      console.warn('[dsh-tiddlywiki] tid preview: no ctx.slots; rolling back the metadata registration')
+      for (const dispose of disposers.splice(0)) dispose()
+      return
+    }
+    const bodyDispose = slots.inject(TID_PREVIEW_SLOT, () =>
+      slots.register({ name: TID_PREVIEW_SLOT, key: TID_PREVIEW_ID }, createTidPreviewBody()),
+    )
+    if (bodyDispose === undefined) console.warn('[dsh-tiddlywiki] tid preview: body registration failed (slot ' + TID_PREVIEW_SLOT + ')')
+    else {
+      disposers.push(bodyDispose)
+      console.info('[dsh-tiddlywiki] tid preview: body registered into ' + TID_PREVIEW_SLOT + ' with key=' + TID_PREVIEW_ID)
+    }
   }
-  const bodyDispose = slots.inject(TID_PREVIEW_SLOT, () =>
-    slots.register({ name: TID_PREVIEW_SLOT, key: TID_PREVIEW_ID }, createTidPreviewBody()),
-  )
-  if (bodyDispose !== undefined) disposers.push(bodyDispose)
-  return disposers
+
+  attempt()
+  // 清理：停掉还在等服务的定时器 + 回收已注册的两半。
+  return [
+    () => {
+      done = true
+      if (timer !== undefined) clearTimeout(timer)
+      for (const dispose of disposers.splice(0)) dispose()
+    },
+  ]
 }