dsh-tiddlywiki 0.28.5 → 0.28.7

package/README.md

@@ -67,6 +67,8 @@ dsh plugin --profile web add dsh-tiddlywiki
 
 ## 🕘 版本记录
 
+- **v0.28.7**（2026-09-28）：**会话知识库选择器改成与「快速笔记」同一行 + 单库专属配置项不再在多库下出现**（两条都是作者报障）。① **选择器"没和对话框对齐"** —— 上次的修法方向就错了：`conversation.input.dock` 是**竖向 flex 列，一个条目独占一整行**，选择器和快速笔记是**两个条目**时永远是上下两行，怎么调内边距都不可能并排。现在选择器不再是独立条目，而是由快速笔记条目通过 `scope` 参数渲染在**自己这一行里**（按钮前面），整行统一与输入框右缘对齐，一行只测一次。顺手修掉合并时的一处遗留：选择器组件里还留着上一版的 `alignDockEntry` 自测，并入同一行后会把右内边距补两遍——已移除（`wiki-scope` 也从客户端 slot 表里消失，回归由 `verify-wiki-focus.mjs` 断言"input.dock 只能有一个条目"守住）。② **「侧边栏 TW 入口显示名称」在多库下不该出现** —— 多库时侧边栏是每个库各占一行、各用自己 `wikis.json` 里的显示名，`ui.sidebarLabel` 只喂单库那一行，所以多库下它是个**改了不生效的假配置项**。现在该字段只在单库模式渲染（多库时换成一行说明"去知识库列表改各自的显示名"）；模式探测失败**回落成单库**（保守：宁可多给一个真能用的字段，也不要因为一次请求失败把设置项藏了），并反向断言不许写成 `!== 'single'`（那会把未知模式误判成多库）。两条守门断言都做了反向验证。
+- **v0.28.6**（2026-09-28）：**修两个多库界面的真机报障**。① **「插件管理 / 主题管理 / 语言包 / 初始化」看起来是混在一起管理的** —— 宿主侧一直是 per-request 解析目标库的（`deps.server(req)`/`config(req)`/`getClient(req)`），缺的是**客户端那一半**：设置页只有 `state`/`config`/`prompt` 三处带上了 `?wiki=`，而**插件信息与初始化 seed 的调用没带**，于是它们永远落在默认库上，「切了库、面板内容却没变」。现在 7 个 per-wiki 端点全部经 `withWiki()`，并有守门逐个断言（去掉任一处的作用域 → 红）。单库（未选库）时 `withWiki` 原样返回 URL，现有用户逐字不变。② **左侧入口点一个却三个都高亮** —— 我上一版把「面板是共享的」错解成「所有行一起高亮」，但面板一次只显示一个库（当前焦点库）。现在只有那一行点亮，并订阅焦点变化重算；单库默认行在面板打开时仍正常高亮。两条守门断言都做了反向验证。
 - **v0.28.5**（2026-09-28）：**修「多库模式下侧边栏多出一个没有库名的 `TiddlyWiki` 入口」**（作者报障）。根因是**同一个 CSS 陷阱踩了第 12 次**：`hidden` 属性在 CSS 里只是 `display:none`，而 `.dsh-tw-entry` 有显式 `display:flex` —— **显式 display 盖掉了 hidden**，于是那行让位给每库入口的默认行照样渲染。这次不再给它单独补一条规则，而是**收敃成一条全局兜底** `[hidden] { display: none !important; }`，并删掉本仓库历史上为此在不同元素上各补的 **12 条逐元素规则**（面板 iframe / 错误块 / 快速笔记 / FAB 菜单与提示 / 右侧栏 / 目标库下拉 / 草稿栏 / 最近列表…）。守门同时改为断言「全局兜底存在 + 不允许再出现逐元素版本」，并反向验证（把全局规则改成挂在类名下 → 红）。
 - **v0.28.4**（2026-09-28）：**每库自定义图标 + 修「右键菜单切库后选中项不更新」**。① **右侧「知识库」菜单的选中项停在旧值** —— 根因是选中标记（`●`/`○`）只在**菜单构建时**算了一次，之后无论怎么切都不重画；现在改为从当前焦点重算，并在 `setFocusWiki` 订阅里即时重画、每次打开菜单前再兜一次（切库也可能来自侧边栏入口或快速笔记卡片）。② **每个库的入口图标可自定义**：`wikis.json` 的条目新增可选 `icon` 字段，值可以是内置图形名（book / briefcase / home / notebook / flask / globe / star / archive，各是一枚继承 `currentColor` 的手写 16×16 线性 SVG，两套主题下都对）或**一个短 emoji**（📚 / 💼 / 🏠 …，用来一眼区分四五个库，不用下载任何资源）。设置页「知识库列表」每行多了图标下拉（当前值若不在候选里会保留，不会被抹掉）。校验口径：名字或 ≤8 字符的可打印短串，超长与控制字符一律拒绝；空值 = 清除自定义回落默认。**emoji 用 `textContent` 渲染而不是 `innerHTML`** —— 这个值来自用户可编辑的文件，绝不能变成注入点。缺省不设 = 内置默认图标，升级用户看到的一模一样。
 - **v0.28.3**（2026-09-28）：**修三个真机报障 + 插件说明补「多库 / 升级」两节**（作者拆库实测中发现）。① 单库模式下快速笔记露出一个没有选项的下拉 —— 根因是 **CSS `hidden` 只是 `display:none`，被显式 `display` 盖掉**（修法：显式 `[hidden]{display:none}` + 组件兜底）。② 会话级选择器没和输入框对齐 —— **对齐规则原本只写在 quick-note 条目内部**，已抽成 `client/dock-align.ts` 两处共用。③ 左侧入口按库显示：多库时每个在运行的库一个入口行、用各自显示名，点该行先切焦点库再开面板。④ 插件说明新增「多知识库」与「从旧版本升级上来」两节：明确升级后**不会自动变成多库**、`wikis.json` 在哪、旧指针文件何时还权威。守门扩到 19 条（含反向验证）。

package/docs/CHANGELOG.md

@@ -4,6 +4,8 @@
 
 > 最近几个主要版本的一句话记录（完整变更见 [Releases](https://github.com/bbqisbbq/dsh-tiddlywiki/releases) / git log）。
 
+- **v0.28.7**（2026-09-28）：**会话知识库选择器改成与「快速笔记」同一行 + 单库专属配置项不再在多库下出现**（两条都是作者报障）。① **选择器"没和对话框对齐"** —— 上次的修法方向就错了：`conversation.input.dock` 是**竖向 flex 列，一个条目独占一整行**，选择器和快速笔记是**两个条目**时永远是上下两行，怎么调内边距都不可能并排。现在选择器不再是独立条目，而是由快速笔记条目通过 `scope` 参数渲染在**自己这一行里**（按钮前面），整行统一与输入框右缘对齐，一行只测一次。顺手修掉合并时的一处遗留：选择器组件里还留着上一版的 `alignDockEntry` 自测，并入同一行后会把右内边距补两遍——已移除（`wiki-scope` 也从客户端 slot 表里消失，回归由 `verify-wiki-focus.mjs` 断言"input.dock 只能有一个条目"守住）。② **「侧边栏 TW 入口显示名称」在多库下不该出现** —— 多库时侧边栏是每个库各占一行、各用自己 `wikis.json` 里的显示名，`ui.sidebarLabel` 只喂单库那一行，所以多库下它是个**改了不生效的假配置项**。现在该字段只在单库模式渲染（多库时换成一行说明"去知识库列表改各自的显示名"）；模式探测失败**回落成单库**（保守：宁可多给一个真能用的字段，也不要因为一次请求失败把设置项藏了），并反向断言不许写成 `!== 'single'`（那会把未知模式误判成多库）。两条守门断言都做了反向验证。
+- **v0.28.6**（2026-09-28）：**修两个多库界面的真机报障**。① **「插件管理 / 主题管理 / 语言包 / 初始化」看起来是混在一起管理的** —— 宿主侧一直是 per-request 解析目标库的（`deps.server(req)`/`config(req)`/`getClient(req)`），缺的是**客户端那一半**：设置页只有 `state`/`config`/`prompt` 三处带上了 `?wiki=`，而**插件信息与初始化 seed 的调用没带**，于是它们永远落在默认库上，「切了库、面板内容却没变」。现在 7 个 per-wiki 端点全部经 `withWiki()`，并有守门逐个断言（去掉任一处的作用域 → 红）。单库（未选库）时 `withWiki` 原样返回 URL，现有用户逐字不变。② **左侧入口点一个却三个都高亮** —— 我上一版把「面板是共享的」错解成「所有行一起高亮」，但面板一次只显示一个库（当前焦点库）。现在只有那一行点亮，并订阅焦点变化重算；单库默认行在面板打开时仍正常高亮。两条守门断言都做了反向验证。
 - **v0.28.5**（2026-09-28）：**修「多库模式下侧边栏多出一个没有库名的 `TiddlyWiki` 入口」**（作者报障）。根因是**同一个 CSS 陷阱踩了第 12 次**：`hidden` 属性在 CSS 里只是 `display:none`，而 `.dsh-tw-entry` 有显式 `display:flex` —— **显式 display 盖掉了 hidden**，于是那行让位给每库入口的默认行照样渲染。这次不再给它单独补一条规则，而是**收敃成一条全局兜底** `[hidden] { display: none !important; }`，并删掉本仓库历史上为此在不同元素上各补的 **12 条逐元素规则**（面板 iframe / 错误块 / 快速笔记 / FAB 菜单与提示 / 右侧栏 / 目标库下拉 / 草稿栏 / 最近列表…）。守门同时改为断言「全局兜底存在 + 不允许再出现逐元素版本」，并反向验证（把全局规则改成挂在类名下 → 红）。
 - **v0.28.4**（2026-09-28）：**每库自定义图标 + 修「右键菜单切库后选中项不更新」**。① **右侧「知识库」菜单的选中项停在旧值** —— 根因是选中标记（`●`/`○`）只在**菜单构建时**算了一次，之后无论怎么切都不重画；现在改为从当前焦点重算，并在 `setFocusWiki` 订阅里即时重画、每次打开菜单前再兜一次（切库也可能来自侧边栏入口或快速笔记卡片）。② **每个库的入口图标可自定义**：`wikis.json` 的条目新增可选 `icon` 字段，值可以是内置图形名（book / briefcase / home / notebook / flask / globe / star / archive，各是一枚继承 `currentColor` 的手写 16×16 线性 SVG，两套主题下都对）或**一个短 emoji**（📚 / 💼 / 🏠 …，用来一眼区分四五个库，不用下载任何资源）。设置页「知识库列表」每行多了图标下拉（当前值若不在候选里会保留，不会被抹掉）。校验口径：名字或 ≤8 字符的可打印短串，超长与控制字符一律拒绝；空值 = 清除自定义回落默认。**emoji 用 `textContent` 渲染而不是 `innerHTML`** —— 这个值来自用户可编辑的文件，绝不能变成注入点。缺省不设 = 内置默认图标，升级用户看到的一模一样。
 - **v0.28.3**（2026-09-28）：**修三个真机报障 + 插件说明补「多库 / 升级」两节**（作者拆库实测中发现）。① **单库模式下快速笔记露出一个没有选项的「写入」下拉** —— 根因是 **CSS 的 `hidden` 属性只是 `display:none`，任何显式 `display` 都能盖掉它**：我给 `.dsh-tw-note-wiki` 写了 `display:inline-flex`，于是 `hidden` 失效，那个空下拉照常渲染。修法两层：CSS 显式加 `[hidden]{display:none}`（且必须写在设 `display` 的那条**之后**，同优先级靠后者生效）+ 组件侧兜底（单库时 `disabled` 并直接 `display:none`）。② **会话级知识库选择器没有和输入框对齐** —— 根因是**规则只写在了一个使用者的内部**：找 composer 输入卡片、按差值补 `paddingRight` 的整套测量逻辑原本长在 `quick-note-dock.ts` 里，第二个 dock 条目加进来时没人知道要对齐。已抽成 `client/dock-align.ts`（`alignDockEntry`）两处共用，并守门断言「条目内不得再自带测量实现」。③ **左侧入口按库显示** —— 多库时每个**在运行**的库一个入口行、用各自的显示名；点该行**先切焦点库再开面板**（否则点 A 打开 B）；当前焦点库有左侧标线。单库安装仍走原来那一行 + `ui.sidebarLabel`，逐字不变。④ **插件说明新增两节**：升级用户最大的困惑是"装完了不知道有这个东西"，所以明确写了——升级后**不会自动变成多库**、行为与升级前一致；想用多库去哪点；`wikis.json` 在哪；旧 `location.json` 在哪些模式下还权威；每个库要有自己的 `tiddlywiki.info`。守门 `verify-wiki-focus` 扩到 19 条（`hidden` 那条已反向验证）。

package/docs/usage.md

@@ -59,7 +59,7 @@
 ### 🧑‍💻 界面操作
 
 - **📤 发送给 Agent**：TW 工具栏按钮（首次启动自动写入 wiki，ONE-SHOT）。弹层可选**附加说明**（位于消息末尾）、**工作模式**（Agent 预设）、**权限**（权限预设），按工作区分组选会话或新建。消息自带待办说明。
-- **🧭 中央列编辑器**：侧边栏「TiddlyWiki」开关（显示名可改 `ui.sidebarLabel`，保存后即时生效，v0.22.8）。
+- **🧭 中央列编辑器**：侧边栏「TiddlyWiki」开关（显示名可改 `ui.sidebarLabel`，保存后即时生效，v0.22.8）。**多库模式下没有这个配置项**（v0.28.7）：侧边栏变成每个知识库各占一行、各用自己在「知识库列表」里配的**显示名**，统一名称已无意义，所以设置页只在单库模式渲染该字段。
 - **🗂️ 右侧边栏 Tab**（v0.16.21）：DSH 新右侧栏展开后，首页会出现「**TiddlyWiki 知识库**」入口盒，点击即在右侧栏以 tab 形式打开完整 TW 编辑器——**与聊天并排**，适合边聊边查/边记。由 `ui.showRightbarTab` 控制（默认开）；老版本 DSH（无右侧栏）自动跳过。
 - **🧩 Better Sidebar 共存**：装了 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 时，插件只做 UI 共存（中央 TW 面板的 z-index 自动压在其侧边栏展开/收起按钮之下，按钮始终可点）。**v0.17.0 起不再向 dsh-better-sidebar 注册「TiddlyWiki 知识库」tab**（旧版可用 `ui.showBetterSidebarTab` 关闭）——该 tab 的 kind 会与其它注册方冲突报 `tab kind "dsh-tiddlywiki" is already registered`。右侧边栏入口请用上面的 **右侧边栏 Tab**（DSH 原生 rightbar）。
 - **📝 快速笔记**：输入框上方快捷按钮（`ui.showQuickNoteDock`）或 FAB；`ui.quickNoteMode` 选打开方式——**native**（默认，直达 TW 原生编辑页，草稿自动续写）或 **card**（CodeMirror 6 Markdown 高亮、文件上传、多选 tag、草稿自动保存、「🕘 最近」载入、Ctrl+Enter 保存）。**v0.22.6**：原生编辑弹窗里用 TW 的「🗑 删除」把笔记删掉后不会再变成打不开的白板——再点一次「快速笔记」就会重新载入编辑器；card 模式底部操作条改成「按钮文字永不折行、放不下时整组换行」，窄卡片里不再把「✏️ 在 TW 中编辑」压成两行。
@@ -212,7 +212,7 @@ seed 是把「wiki 里预置内容」随插件分发的机制：**ONE-SHOT（只
       showQuickNote: true              # FAB 里显示快速笔记入口
       showQuickNoteDock: true          # 输入框上方快捷按钮
       quickNoteMode: "native"          # native=TW 原生编辑页 / card=Markdown 卡片
-      sidebarLabel: "TiddlyWiki"       # 侧边栏入口显示名
+      sidebarLabel: "TiddlyWiki"       # 侧边栏入口显示名（仅单库模式；多库下每库各用自己 wikis.json 的 label）
       showPanelStatus: true
       showSyncButton: true
       followDshTheme: true             # 跟随 DSH 深浅主题