dsh-tiddlywiki 0.3.0 → 0.3.1

package/package.json

@@ -1,79 +1,79 @@
-{
-  "name": "dsh-tiddlywiki",
-  "description": "TiddlyWiki 5 as the DSH persistent knowledge base: tiddlywiki_* agent tools (search/get/put/delete + git sync), a full TiddlyWiki editor embedded in the GUI center column, a floating quick-note widget in the chat area, and git-based sync with auto-commit. Mounts via the official dsh plugin system — no DSH source changes.",
-  "version": "0.3.0",
-  "type": "module",
-  "keywords": [
-    "dsh",
-    "dsh-plugin",
-    "tiddlywiki",
-    "knowledge-base",
-    "note-taking",
-    "notes",
-    "wiki",
-    "git-sync",
-    "agent-tools",
-    "plugin"
-  ],
-  "author": {
-    "name": "bbqisbbq",
-    "url": "https://github.com/bbqisbbq"
-  },
-  "main": "lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./client": "./lib/client.js",
-    "./package.json": "./package.json"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "slots"
-      ],
-      "platform": "web"
-    }
-  },
-  "files": [
-    "lib/**/*.js",
-    "lib/**/*.js.map",
-    "src",
-    "cordis.patch.yml",
-    "LICENSE",
-    "README.md"
-  ],
-  "license": "MIT",
-  "homepage": "https://github.com/bbqisbbq/dsh-tiddlywiki#readme",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/bbqisbbq/dsh-tiddlywiki.git"
-  },
-  "bugs": {
-    "url": "https://github.com/bbqisbbq/dsh-tiddlywiki/issues"
-  },
-  "engines": {
-    "node": ">=22"
-  },
-  "dependencies": {
-    "tiddlywiki": "^5.4.1"
-  },
-  "devDependencies": {
-    "@types/node": "^22.20.1",
-    "@types/react": "^19.1.0",
-    "react": "^19.1.0",
-    "tsdown": "0.22.2",
-    "tsx": "^4.19.2",
-    "typescript": "~5.7.2",
-    "unrun": "*"
-  },
-  "scripts": {
-    "build": "node scripts/clean-lib.mjs && npm run build:host && npm run build:client",
-    "build:host": "tsdown -c tsdown.host.config.ts",
-    "build:client": "tsdown -c tsdown.client.config.ts && node scripts/wrap-client.mjs",
-    "watch": "tsdown -c tsdown.host.config.ts --watch",
-    "typecheck": "tsc --noEmit",
-    "selftest": "node scripts/selftest.mjs"
-  }
-}
+{
+  "name": "dsh-tiddlywiki",
+  "description": "TiddlyWiki 5 as the DSH persistent knowledge base: tiddlywiki_* agent tools (search/get/put/delete + git sync), a full TiddlyWiki editor embedded in the GUI center column, a floating quick-note widget in the chat area, and git-based sync with auto-commit. Mounts via the official dsh plugin system — no DSH source changes.",
+  "version": "0.3.1",
+  "type": "module",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "tiddlywiki",
+    "knowledge-base",
+    "note-taking",
+    "notes",
+    "wiki",
+    "git-sync",
+    "agent-tools",
+    "plugin"
+  ],
+  "author": {
+    "name": "bbqisbbq",
+    "url": "https://github.com/bbqisbbq"
+  },
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "slots"
+      ],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.js.map",
+    "src",
+    "cordis.patch.yml",
+    "LICENSE",
+    "README.md"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/bbqisbbq/dsh-tiddlywiki#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bbqisbbq/dsh-tiddlywiki.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bbqisbbq/dsh-tiddlywiki/issues"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "tiddlywiki": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "@types/react": "^19.1.0",
+    "react": "^19.1.0",
+    "tsdown": "0.22.2",
+    "tsx": "^4.19.2",
+    "typescript": "~5.7.2",
+    "unrun": "*"
+  },
+  "scripts": {
+    "build": "node scripts/clean-lib.mjs && npm run build:host && npm run build:client",
+    "build:host": "tsdown -c tsdown.host.config.ts",
+    "build:client": "tsdown -c tsdown.client.config.ts && node scripts/wrap-client.mjs",
+    "watch": "tsdown -c tsdown.host.config.ts --watch",
+    "typecheck": "tsc --noEmit",
+    "selftest": "node scripts/selftest.mjs"
+  }
+}

package/src/client/styles.ts

@@ -95,9 +95,12 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
 
 /* ── floating quick-note widget ────────────────────────────────
    Positioned ABOVE the shutdown launcher FAB (fixed right:24 bottom:24,
-   z-index 900, 46px) and BELOW its confirm overlay (z-index 1000). */
+   z-index 900, 46px) and BELOW its confirm overlay (z-index 1000).
+   Interactive overlays (the open card, the native-editor popup) sit ABOVE the
+   passive FAB column (sync/status, z-index 950) so those FABs never cover the
+   card's own bottom-right buttons. */
 .dsh-tw-note {
-  position: fixed; right: 24px; bottom: 88px; z-index: 950;
+  position: fixed; right: 24px; bottom: 88px; z-index: 980;
   display: flex; flex-direction: column; align-items: flex-end; gap: 10px;
   font-family: inherit;
 }
@@ -108,11 +111,18 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
   border-radius: 14px; box-shadow: var(--dsw-shadow-lv3, 0 8px 30px rgba(0,0,0,.22));
   padding: 12px; display: flex; flex-direction: column; gap: 10px;
   font-size: 13px;
+  backdrop-filter: blur(14px); -webkit-backdrop-filter: blur(14px);
+  animation: dsh-tw-note-in 180ms ease;
 }
 .dsh-tw-note-card[hidden] { display: none; }
+@keyframes dsh-tw-note-in {
+  from { opacity: 0; transform: translateY(8px) scale(.98); }
+  to { opacity: 1; transform: translateY(0) scale(1); }
+}
 .dsh-tw-note-head {
   display: flex; align-items: center; gap: 8px;
-  font-size: 12px; font-weight: 600; color: var(--dsw-alias-label-primary, #222);
+  font-size: 12px; font-weight: 600; letter-spacing: .2px;
+  color: var(--dsw-alias-label-primary, #222);
 }
 .dsh-tw-note-head .dsh-tw-note-label { margin-right: auto; display: flex; align-items: center; gap: 6px; }
 .dsh-tw-note-close {
@@ -196,23 +206,26 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
   border: 1px solid var(--dsw-alias-border-l2, rgba(0,0,0,.18));
   background: var(--dsw-alias-bg-layer-2, #fff); color: var(--dsw-alias-label-primary, #222);
   font: inherit; font-size: 12px; padding: 6px 10px; border-radius: 8px; cursor: pointer;
-  transition: filter 120ms ease;
+  transition: filter 120ms ease, transform 80ms ease;
 }
 .dsh-tw-note-upload:hover { filter: brightness(.96); }
+.dsh-tw-note-upload:active { transform: scale(.96); }
 .dsh-tw-note-save {
   border: 1px solid transparent; background: var(--dsw-alias-brand-primary, #3e63dd); color: #fff;
   font: inherit; font-size: 12px; padding: 6px 16px; border-radius: 8px; cursor: pointer;
-  transition: filter 120ms ease;
+  transition: filter 120ms ease, transform 80ms ease;
 }
 .dsh-tw-note-save:hover:not(:disabled) { filter: brightness(1.08); }
+.dsh-tw-note-save:active:not(:disabled) { transform: scale(.96); }
 .dsh-tw-note-save:disabled { opacity: .55; cursor: default; }
 .dsh-tw-note-edit {
   border: 1px solid var(--dsw-alias-border-l2, rgba(0,0,0,.18));
   background: var(--dsw-alias-bg-layer-2, #fff); color: var(--dsw-alias-label-primary, #222);
   font: inherit; font-size: 12px; padding: 6px 10px; border-radius: 8px; cursor: pointer;
-  transition: filter 120ms ease;
+  transition: filter 120ms ease, transform 80ms ease;
 }
 .dsh-tw-note-edit:hover:not(:disabled) { filter: brightness(.96); }
+.dsh-tw-note-edit:active:not(:disabled) { transform: scale(.96); }
 .dsh-tw-note-edit:disabled { opacity: .55; cursor: default; }
 /* ── Multi-tag chip editor (quick-note tags) ─────────────────────────────── */
 .dsh-tw-note-tags { position: relative; flex: 1; min-width: 0; display: flex; flex-direction: column; gap: 4px; }
@@ -250,7 +263,7 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
   background: var(--dsw-alias-bg-layer-2, #fff); color: var(--dsw-alias-label-primary, #222);
   border: 1px solid var(--dsw-alias-border-l2, rgba(0,0,0,.2));
   border-radius: 12px; box-shadow: 0 14px 44px rgba(0,0,0,.3);
-  z-index: 980; font-family: inherit; font-size: 13px;
+  z-index: 990; font-family: inherit; font-size: 13px;
 }
 .dsh-tw-editor-bar {
   display: flex; align-items: center; gap: 8px; flex: 0 0 auto;

package/src/host/routes.ts

@@ -33,6 +33,11 @@ const MAX_PROXY_BODY_BYTES = 16 * 1024 * 1024
 /** Max uploaded file body. */
 const MAX_UPLOAD_BYTES = 64 * 1024 * 1024
 
+/** Tiddler type for quick-notes: Markdown, so the uploaded images/links and
+ *  any Markdown in the note actually render in TW (a type-less tiddler is
+ *  treated as plain wiki text and shows raw `![..]`/`[..]` instead). */
+const NOTE_TYPE = 'text/markdown'
+
 /** Structural webserver face (a subset of dsh-host-webserver). */
 export interface WebServerFace {
   register(route: { kind: 'exact' | 'prefix'; path: string; handler: (req: IncomingMessage, res: ServerResponse) => void }): () => void
@@ -125,10 +130,13 @@ function timestampTitle(date = new Date()): string {
 
 /**
  * Open a tiddler in TW's NATIVE editor: save the tiddler (when text is
- * non-empty), reuse or create a DRAFT tiddler carrying `draft.of`/`draft.title`
- * (TW's story view renders drafts with the EditTemplate — list.js:
- * `isDraft && editTemplate`), and return the draft title so the client can
- * navigate the panel iframe to `#<draftTitle>`.
+ * non-empty) as Markdown, reuse or create a DRAFT tiddler carrying
+ * `draft.of`/`draft.title` (TW's story view renders drafts with the
+ * EditTemplate — list.js: `isDraft && editTemplate`), and return the draft
+ * title so the client can navigate the panel iframe to `#<draftTitle>`.
+ * The draft carries the same `text/markdown` type as the note so saving it in
+ * TW keeps Markdown (a draft without a matching type would overwrite the
+ * note's type back to plain wiki text).
  */
 export async function openInTwEditor(
   client: TiddlyWebClient,
@@ -137,7 +145,7 @@ export async function openInTwEditor(
   tags: string[],
 ): Promise<{ title: string; draftTitle: string }> {
   if (text.trim().length > 0) {
-    await client.put({ title, text, tags })
+    await client.put({ title, text, tags, type: NOTE_TYPE })
   }
   // Draft content: the provided text, else the existing tiddler's content.
   let draftText = text
@@ -159,7 +167,7 @@ export async function openInTwEditor(
     /* fall back to a fresh draft */
   }
   if (draftTitle === undefined) draftTitle = `Draft of "${title}" ${Date.now()}`
-  await client.put({ title: draftTitle, text: draftText, 'draft.of': title, 'draft.title': title, type: 'text/vnd.tiddlywiki' })
+  await client.put({ title: draftTitle, text: draftText, 'draft.of': title, 'draft.title': title, type: NOTE_TYPE })
   return { title, draftTitle }
 }
 
@@ -206,9 +214,9 @@ export function registerRoutes(ctx: { webServer: WebServerFace }, deps: RouteDep
       }
       const title = typeof body.title === 'string' && body.title.trim().length > 0 ? body.title.trim() : timestampTitle()
       const tags = resolveTags(body, deps.noteDefaults().tag)
-      await client.put({ title, text, tags })
+      await client.put({ title, text, tags, type: NOTE_TYPE })
       deps.autoCommit()
-      json(res, { ok: true, title, tag: tags.join(' '), tags, text })
+      json(res, { ok: true, title, tag: tags.join(' '), tags, text, type: NOTE_TYPE })
     } catch (err) {
       json(res, { ok: false, error: err instanceof Error ? err.message : String(err) }, 500)
     }

package/src/index.ts

@@ -152,7 +152,9 @@ const PROMPT_TEXT = `## TiddlyWiki 持久知识库
 2. 收工 commit + push：\`tiddlywiki_git_sync action=sync\`（pull → commit → push）。
 3. 插件会自动防抖 commit（默认 60s），手动同步用上面的工具。
 
-把 wiki 当作长期记忆与知识沉淀的地方：会议纪要、决策记录、调研笔记、随手的想法都可存成独立 tiddler（tag 建议用 inbox/meeting/decision 等便于检索）。`
+把 wiki 当作长期记忆与知识沉淀的地方：会议纪要、决策记录、调研笔记、随手的想法都可存成独立 tiddler（tag 建议用 inbox/meeting/decision 等便于检索）。
+
+用本插件自动创建笔记时，除了业务性 tag 外，请把「当前工作区（项目）的名字」也作为标签之一加上去（例如 \`tiddlywiki_put\` 的 tags 里带上当前 workspace 名），这样笔记能按项目归集、检索。`
 
 /**
  * Mount the host half.