dsh-tiddlywiki 0.28.0 → 0.28.2

package/README.md

@@ -67,6 +67,8 @@ dsh plugin --profile web add dsh-tiddlywiki
 
 ## 🕘 版本记录
 
+- **v0.28.2**（2026-09-28）：**设置页去掉重复的「知识库位置」**（作者反馈：多库配置做完后它重复且逻辑冲突）。这一块的语义是「把**唯一的那个库**换到别处」——写的是 wiki 之外的指针文件 `location.json`，措辞也是单库时代的（"切换到这个位置" / "恢复为配置默认"）。现在**按模式二选一**：**单库模式**保留它（那里它是唯一正确入口）；**多库模式整块不渲染**，某个库换目录收到「知识库列表」那一行的**「改目录」**（默认库经 `/admin/wiki/switch` → 改清单 + farm 收敛 + 校验；非默认库直接 `update`）。宿主接口**没有**冲突也**没有**改动：`/admin/wiki/switch|reset` 从 v0.28.0 起就按模式分派。守门：`verify-wiki-focus` 新增"多库模式下不得渲染该块"的断言；farm-boot 补上 location 面接线（22 条），保证藏了界面之后**接口仍按模式正确分派**。
+- **v0.28.1**（2026-09-28）：**修「拆库 skill 在 wiki 启动慢 / 起不来时永远装不上」+ 快速笔记的目标库可切换（R7）**。① **真实事故**（作者升级 0.28.0 后重启宿主时发现，测试没拦住）：技能安装写在了 `farm.startAll()` **之后**，而那个 wiki 很大、启动要几十秒 —— 于是"技能装没装"取决于"wiki 起得快不快"；更糟的是 wiki 若因配置问题**永远起不来**，技能就永远不装，而它跟 wiki 毫无关系（只往 `$DSH_HOME/skills/` 写一个文件）。已挪到启动任务**最前面**并新增**顺序守门**（`verify-skill-install` 断言安装早于 `startAll()`，已反向验证）。② 快速笔记卡片新增「写入」目标库：**默认跟随你在 GUI 里看的那个库**（焦点库），卡片内可临时改、改过后不再被焦点带走。要点是**整张卡片一起换库**：标签建议 / 最近 / 草稿读取 / 附件上传 / 保存 / 随后弹出的 TW 编辑器必须落在同一个库 —— 只改保存那一处会产出"标签列表来自 A、笔记写进 B"，比不做还糟（弹窗那条另有一条守门：写入 A、编辑器打开 B（空白）是典型的"看起来成功了"的失败）。目标库没在运行时卡片**先讲清楚**，而不是让你写完一段再失败。单库安装不显示选择器、请求 URL 逐字不变。
 - **v0.28.0**（2026-09-28）：**多知识库**——同一进程内可同时运行多个 TiddlyWiki，每个库独立配置、独立 git、按会话选择作用域，且可对 Agent **彻底隐身**。起因是作者自己的库：`书籍` 语料 2468 条与日常笔记挤在一个 800MB 仓库里，Agent 检索/lint/backlink 每天在约 30 倍于工作集的内容上跑。拆库需要**同时在线**——只切换位置的话，你切到语料库翻资料时 Agent 也跟着切过去了。要点：① 三个模块各司其职（`wiki-registry` 清单/模式/动作、`wiki-instance` 单库运行时、`wiki-farm` 谁该在跑 + 会话作用域）；② 模式开关 `wikis.json` 的 `mode`（缺省 `single`，升级用户逐字不变）；③ 路由按库定向 `/tw/<id>/…`（每个库 seed 自己的同源基址——不区分 id 就会「页面显示 A、读写落在 B」），裸 `/tw/` 仍是默认库别名，为此引入**保留 id 名单**；④ **git 按仓库重构**：多库可共用一个仓库，`git add -A` 只允许一个 committer，pull 后只重启受影响的库；⑤ Agent 侧：会话单选作用域 + `agentVisible`，工具回执在可见库多于一个时**标明库名**，注入提示词**按会话求值**并读作用域库的 `prompt.*`；两条刻意拒绝（隐身库→忽略；没在跑→报错而非静默换库）；⑥ GUI：输入框上方的会话选择器、FAB 的知识库分组、设置页「知识库列表」与**显式配置作用域**；⑦ **拆库引导** `docs/wiki-split.md` + 随包 skill（安装时只覆盖带标记的文件）。新增 6 个守门脚本（共约 96 条断言，含**真起两个 TW 子进程**与**真 git 仓库**两类集成验证），全部反向验证；4 个既有守门跟着间接层更新。**未做**：per-wiki 认证（`auth.*` 仍全局）、快速笔记目标切换策略。
 - **v0.27.3**（2026-09-28）：**修 v0.27.1 拆文档时打断的 6 个相对链接**（`docs/` 内的链接仍按仓库根写成 `docs/xxx.md`，从 `docs/` 内部点击打不开）；新增守门 `scripts/verify-doc-links.mjs`（校验 README + `docs/**` 的全部相对链接，已挂进 `verify:static`，让这类错误下次发不出来）；**修 CI 偶发假红**：`verify-wiki-switch` 的回滚断言会抢在 TW 载入 store 之前读取，改为 15s 有界轮询后再断言。**无运行时行为改动。**
 - **v0.27.2**（2026-09-28）：修本页一处**指向不存在内容的死链**（"不适合"那段曾让人去看 `docs/features.md` 末尾的说明，那里并没有）。纯文案，无代码改动。

package/docs/CHANGELOG.md

@@ -4,6 +4,8 @@
 
 > 最近几个主要版本的一句话记录（完整变更见 [Releases](https://github.com/bbqisbbq/dsh-tiddlywiki/releases) / git log）。
 
+- **v0.28.2**（2026-09-28）：**设置页去掉重复的「知识库位置」**（作者反馈：多库配置做完后它重复且逻辑冲突）。这一块的语义是「把**唯一的那个库**换到别处」——写的是 wiki 之外的指针文件 `location.json`，措辞也是单库时代的（"切换到这个位置" / "恢复为配置默认"）。现在**按模式二选一**：**单库模式**保留它（那里它是唯一正确入口）；**多库模式整块不渲染**，某个库换目录收到「知识库列表」那一行的**「改目录」**（默认库经 `/admin/wiki/switch` → 改清单 + farm 收敛 + 校验；非默认库直接 `update`）。宿主接口**没有**冲突也**没有**改动：`/admin/wiki/switch|reset` 从 v0.28.0 起就按模式分派。守门：`verify-wiki-focus` 新增"多库模式下不得渲染该块"的断言；farm-boot 补上 location 面接线（22 条），保证藏了界面之后**接口仍按模式正确分派**。
+- **v0.28.1**（2026-09-28）：**修「拆库 skill 在 wiki 启动慢 / 起不来时永远装不上」+ 快速笔记的目标库可切换（R7）**。① **真实事故**（作者升级 0.28.0 后重启宿主时发现，测试没拦住）：技能安装写在了 `farm.startAll()` **之后**，而作者的知识库很大、TW 冷启动要几十秒 —— 于是"技能装没装"取决于"wiki 起得快不快"；更糟的是 wiki 若因配置问题**永远起不来**，技能就永远不装，而它跟 wiki 毫无关系（只往 `$DSH_HOME/skills/` 写一个文件）。已挪到启动任务**最前面**，并新增**顺序守门**：`verify-skill-install` 断言 `installSplitSkill()` 出现在 `farm.startAll()` 之前（已反向验证：在安装前插一次 startAll → 该条红）。② **R7 快速笔记目标**：卡片新增「写入」目标库，**默认跟随 GUI 的焦点库**（你在看哪个库，快速笔记就进哪个库），卡片内可临时改且改过之后不再被焦点带走。设计的核心是**整张卡片一起换库** —— 标签建议（memo 以 URL 为键，换库自动重读）/ 最近列表 / 草稿读取 / 附件上传 / 保存 / 随后弹出的 TW 编辑器，六处全部经 `withWikiQuery()`（`?wiki=<id>`）与 `twProxyFor()` 定向；只改保存那一处会产出"标签列表来自 A、笔记写进 B"，比不做还糟。目标库没在运行时卡片会**先讲清楚**（"先在右下角「知识库」菜单里打开它"），而不是让用户写完一段再失败；这里刻意**不自动启动** —— 启动是「知识库」菜单的职责，保存路由顺手 spawn 进程不该由一次误点触发。单库安装不显示选择器、请求 URL 逐字不变。守门 `verify-wiki-focus` 扩到 16 条（含 `withWikiQuery` 的四条纯逻辑断言与"整张卡片同库"的源码级断言，已反向验证）；`verify-tw-origin` 的弹窗接线断言跟着间接层更新（保留强度）。
 - **v0.28.0**（2026-09-28）：**多知识库**——同一进程内可同时运行多个 TiddlyWiki，每个库独立配置、独立 git，Agent 侧按**会话**选择作用域，且每个库可对 Agent **彻底隐身**。起因是作者自己的库：`书籍` 语料 2468 条与日常笔记挤在一个 800MB 仓库里，Agent 的检索 / lint / backlink 每天在约 **30 倍于工作集**的内容上跑（「先窄后宽」是缓解不是解法）。而拆库必须**同时在线**——只切换位置的话，你切到语料库翻资料时 Agent 也跟着切过去了。**① 三个模块各司其职**：`host/wiki-registry.ts`（清单 / 模式 / 动作规则，纯函数）、`host/wiki-instance.ts`（**一个**库的运行时：TW 子进程 + REST 客户端 + 配置覆盖层 + fs 监听 + 自身自举）、`host/wiki-farm.ts`（**谁该在跑**：reconcile 规则 + 会话作用域解析）；`apply()` 从"抱着一个实例"变成"驱动一个农场"。**② 模式开关**：`wikis.json` 的 `mode: 'single' | 'multi'`，**缺省 `single`** —— 升级用户的行为逐字不变（位置仍由旧指针文件 > cordis 默认决定，registry 此时只记住模式与候选列表）。**③ 路由按库定向**：`/tw/<id>/…`，且每个库把自己那份同源代理基址 seed 进**各自的** `$:/config/tiddlyweb/host`（TW 用它拼**所有** API URL；不区分 id 就会出现"页面显示 A、每次读写落在 B"）；裸 `/tw/` 保留为默认库别名（旧链接 / 书签 / 已 seed 的值都不失效）。为此引入**保留 id 名单**（`status`/`files`/`recipes`/`render`… 与 TW 自己的根路径撞名时无法区分，一律拒绝注册）。非代理路由统一吃 `?wiki=<id>`。**④ git 按仓库重构**：多个库可以共用**一个**仓库（按文件夹物理划分）。`git add -A` 在子目录执行也作用于整个工作树，所以自动提交必须**按仓库**去重（`host/repo-committers.ts`，提交在仓库根执行；`dir → repo` 只缓存**肯定**结果——否定结果缓存会让全新安装的自动提交永久静默失效）；`pull()` 回传改动路径，**只重启内容真的变了的库**（"这次 pull 改了东西"与"这个库快照过期了"是两个问题）。**⑤ Agent 侧**：会话级作用域（`$DSH_HOME/dsh-tiddlywiki/sessions.json`，单选，软失败——读不到就只是"没选过"）+ `agentVisible`（**彻底隐身**：不进选择器、不进提示词、工具不可达）。工具按会话路由，且**可见库多于一个时每条回执都标明库名**（一处包装实现，不是改 15 个 render）；注入提示词改为**按会话求值**（`PromptSection.text` 支持函数，DSH 每次装配传入该会话的 agent）并读**作用域那个库**的 `prompt.*`——单库安装的 slim 仍是 1918 字符，逐字节不变。**两条刻意的拒绝**：作用域指向隐身库 → 忽略（隐身是硬边界，过期选择不能绕过它）；指向可见但**没在跑**的库 → **报错并带上库名**，绝不静默落到别的库（静默换库 = 笔记进了用户没指定的知识库而且看起来一切正常，这是本功能唯一真正危险的失败方式）。**⑥ GUI**：`/status` 回传知识库名册；输入框上方的**会话选择器**（只在可见库多于一个时存在）；右下角「知识库」菜单的知识库分组（点开一个没在跑的库会**显式 POST** 启动它——代理路由绝不在 GET 里 spawn 子进程）；设置页新增「知识库列表」（模式切换、增删改、启停、设为默认、可见性、开局自启、新增；「移出列表」明确写着**不删目录**）与**显式配置作用域**（每个库的配置在它自己的 tiddler 里，不说清就会出现"改了但不生效"）。**⑦ 拆库引导**：`docs/wiki-split.md`（人读 + 顶部一整段**可直接复制给 Agent** 的话）+ 随包 skill `skills/wiki-split/SKILL.md`（启动时装到 `$DSH_HOME/skills/`；**只覆盖带标记的文件**，用户自己写的 skill 一个字节都不碰）。**守门**：新增 6 个脚本——`verify-wiki-registry`（18 条）、`verify-wiki-farm`（12 条，注入假实例钉死 reconcile）、`verify-wiki-farm-boot`（**22 条，真起两个 TW 子进程**）、`verify-session-scope`（13 条）、`verify-repo-keying`（11 条，**真 git 仓库**）、`verify-skill-install`（7 条）、`verify-wiki-focus`（13 条，真读 client 源码），**全部反向验证过**；另有 5 个既有守门（drain / language-pin / frame-guards / ready-policy / tw-origin / conflict-config）跟着间接层更新，同样保留强度并反向验证。**未做**：per-wiki `auth.*`（仍是全局）、快速笔记目标切换（目前写默认库也显示默认库，一致但不是最终形态）。
 - **v0.27.0**（2026-09-28）：**重新定位：从「AI 记忆工具」改写成「你和 Agent 共用的本地文档中心」——纯元数据 + 文档发布，运行时行为零变化。** 触发原因：生态里「记忆 / 知识库」这一格已挤进 30+ 个插件（最大的 `MemOS` 已 11,603★），而本插件真正的差异从来不是「更自动的记忆」，而是**人机共用同一份纯文本文件**：人能读、能改、能审计、能随时带走，Agent 用同一套工具读写它。本次把这件事搬上门口那块招牌：① `package.json` 的 `description` 由英文功能清单改为双语定位，并明确写出**不是自动记忆插件、不做后台抓取**，`keywords` 补 `knowledge-management` / `local-first` / `journal` / `publishing` / `wechat`；② GitHub topics 同步补位，便于目录站归类；③ 修正 README 一处过时数字（「Agent 用 10 个工具」→ 15 个）。**无代码改动**——「装完空手能用」（自动建库 + 起步 seed + 快速开始 7 步）自 v0.22.0 起就已具备，本次只是把它讲清楚。
 - **v0.26.7**（2026-09-26）：**修「DSH 桌面版里 TW 面板没有『添加条目』按钮」——嵌入式 TW 被渲染在自定义 scheme 上，于是它根本没有同步器**。现象（用户报障，桌面版）：TW 面板能看能搜，但页面控件里 **添加条目 / 添加日志 / 添加图片 / 导入 / 条目管理器** 整排不见，单条笔记的 **编辑 / 克隆 / 删除** 也不见，像装了个只读版 TW。**根因不在本插件，而在 TW 内核的一处协议判定 + 桌面版新增的渲染 scheme**：TiddlyWiki 自己的 TiddlyWeb sync adaptor 只在**文档协议以 `http` 开头**时才导出自己（`plugins/tiddlywiki/tiddlyweb/tiddlywebadaptor.js`：`if($tw.browser && document.location.protocol.substr(0,4) === "http")`）；而桌面版用自定义 scheme `dsh-app:` 渲染界面（已在本机运行中的 Electron 渲染进程命令行里核实 `--standard-schemes=dsh-app --secure-schemes=dsh-app …`），于是 iframe 里的 TW **没有 syncadaptor → 没有 `$tw.syncer`**：`$:/status/IsReadOnly` 永远没人写，TW 自己的只读样式表 `$:/plugins/tiddlywiki/tiddlyweb/readonly`（`<$reveal … default="yes">`，**状态未知即当只读**）就把那批按钮 `display:none` 掉；同时 saver 退化成本地 `dirtyTracking`，**在那儿做的编辑根本存不回 wiki**。实测复现（不依赖桌面版）：把同一份 wiki 页面用 `file://` 打开（同样非 http），＋ 同样消失——所以这不是「按钮坏了」，而是「这个文档里 TW 没有同步器」。**修复思路：让嵌入式 TW 跑在真正的 http origin 上**。① 宿主 `/status` / `/edit` / `/session/summary` 在原有相对字段旁，新增**绝对孪生字段** `twProxyAbsolute` / `twUrlAbsolute`（`absoluteHostBase()`，由请求 `Host` 头推导；脏头一律拒绝 `/^[A-Za-z0-9.\-[\]:]+$/`，避免把路径/凭据拼进回给浏览器的 URL）；② 客户端新增 `resolveTwUrl()`（`endpoints.ts`）——**页面本身是 http(s) 时继续走相对路径**（loopback / 局域网 / Tailscale / 域名 / HTTPS 行为一字不变，绝不把 https 页面改源），**只有页面不是 http(s) 时**才改用宿主回环 http 基址，于是桌面版 iframe 里 TW 的协议变成 `http:`，sync adaptor 正常加载、同步器回来、按钮与保存一起复原；③ 随之而来的跨源：桌面版下 TW frame 与宿主页面不同源，`tw-frame.ts` 的 hash 导航把「读跨源 `$tw` 抛 SecurityError」包进 try/catch 并直接走整页兜底（不再冒泡、链接不丢），`theme-sync` 本就是 best-effort 跨源静默。守门：新增 `scripts/verify-tw-origin.mjs`（7 条：Host 头推导 / 脏头拒绝 / http(s) 忽略绝对基址 / `dsh-app:`+`file:` 采用绝对基址 / 老服务端不回归 / 两处接线断言 / 跨源兜底源码断言），`verify-frame-surface` 再增 2 条行为单测（`dsh-app:` 页面必须把 frame 指到宿主 http 基址、且 http 页面仍用同源相对地址；跨源 frame 读 `$tw` 抛错时必须整页兜底）。**注意**：这修的是「TW 被非 http(s) 文档嵌入」；「在浏览器里直连 TW 子端口（`http://127.0.0.1:<port>/`）」是另一回事——那样 TW 的 API 基址会被指到 DSH 代理前缀而 404，同样显示成只读，请一律用 DSH 同源入口（面板 / 右侧栏知识库 tab / `<DSH origin>/dsh-tiddlywiki/tw/`）。

package/docs/features.md

@@ -5,7 +5,7 @@
 | 能力 | 说明 |
 |---|---|
 | 🏠 **文档中心起步包** | 首次安装自动 seed：插件说明 + 「示例与文档」（主题汇总模板 / 教程 / 三个示例主题页），首页「📚 插件文档」栏一键查阅；**同名 tiddler 已存在一律安全跳过，绝不覆盖你的数据**（v0.16.22）；插件说明里的**工具清单由工具注册表实时生成**，不会再写着「10 个工具」却已经 15 个（v0.22.0） |
-| 🗂 **多知识库（v0.28.0）** | **多个 TiddlyWiki 同时在线**，每个库独立配置、独立 git 仓库（或共用仓库按文件夹物理划分 —— 「工作 + 个人」同仓、「书籍」独立仓，两种拓扑都支持）。开关是 `wikis.json` 的 `mode`，**缺省 `single`**：升级用户的行为逐字不变（位置仍由旧指针文件 > cordis 默认决定）。每个库有自己的编辑器与入口（右下角「知识库」菜单的分组、每个库自己的 `/tw/<id>/` 同源基址），设置页「知识库列表」负责增删改 / 启停 / 设为默认 / 开局自启 / 对 Agent 可见性；「移出列表」明确**不会删除目录**。 |
+| 🗂 **多知识库（v0.28.0）** | **多个 TiddlyWiki 同时在线**，每个库独立配置、独立 git 仓库（或共用仓库按文件夹物理划分 —— 「工作 + 个人」同仓、「书籍」独立仓，两种拓扑都支持）。开关是 `wikis.json` 的 `mode`，**缺省 `single`**：升级用户的行为逐字不变（位置仍由旧指针文件 > cordis 默认决定）。每个库有自己的编辑器与入口（右下角「知识库」菜单的分组、每个库自己的 `/tw/<id>/` 同源基址），设置页「知识库列表」负责增删改 / 启停 / 设为默认 / 开局自启 / 对 Agent 可见性；「移出列表」明确**不会删除目录**。快速笔记卡片也能选目标库（默认跟随你在 GUI 里看的那个库；**整张卡片一起换库**：标签建议 / 最近 / 附件 / 保存 / 弹窗编辑器同库）。 |
 | 🔒 **对 Agent 的可见性（v0.28.0）** | 每个库可设「对 Agent 隐身」= **彻底不可达**：不进会话选择器、不进注入提示词、`tiddlywiki_*` 工具永不触及（人在 GUI 里照常用它）。会话级作用域**单选**（输入框上方的选择器，选择存在 `$DSH_HOME/dsh-tiddlywiki/sessions.json` 并跨重启存活），工具按会话路由，**可见库多于一个时每条回执都标明库名**，注入提示词按会话求值并读**该库自己**的 `prompt.*`。两条刻意的拒绝：作用域指向隐身库 → 忽略（隐身是硬边界）；指向可见但**没在跑**的库 → **报错并带上库名**，绝不静默落到别的库 —— 静默换库会让笔记落进你没指定过的库，而且看起来一切正常。 |
 | 🧩 **拆库引导（v0.28.0）** | 想把现有库按用途拆开（语料/归档 vs 工作集）时有一份现成流程：[docs/wiki-split.md](wiki-split.md) 顶部是**一整段可直接复制给 Agent 的话**；Agent 会先只读体检、再问五个问题（每个都给默认建议）、出方案表格等你确认，然后备份 → `git mv` 保历史 → 登记进插件 → 校验，**旧库一个都不删**。随包 skill `dsh-tiddlywiki-wiki-split` 会在启动时装进 `$DSH_HOME/skills/`（**只覆盖带标记的文件**，你自己写的 skill 不被碰），也可以直接说「用拆库 skill 帮我拆」。 |
 | 📍 **知识库位置可切换** | 设置页「知识库位置」可把插件切换到**任意本地文件夹**（不用改 cordis 配置、不用重装）：就地停/起 TW 子进程，目标目录没有 `tiddlywiki.info` 时自动 `--init server` 建一个全新知识库；选择记在 `$DSH_HOME/dsh-tiddlywiki/location.json`——一个**在 wiki 之外**的指针文件（所以切到新 wiki 后仍记得「我用的是哪个」），「恢复为配置默认」一键清除；**切换失败自动回滚**到原知识库并如实告知（v0.22.0）。⚠️ 它一次只有一个库在线；要**多库同时在线**见上面的「多知识库」（v0.28.0） |

package/docs/usage.md

@@ -95,6 +95,7 @@
 - **git 按仓库生效**：多个库可以共用**一个**仓库（例如「工作」+「个人」放在 `D:/notes/` 下的两个子
   目录），也可以各自独立仓库。共用仓库时**只有一个自动提交者**（`git add -A` 会作用于整个工作树），
   `git.*` 以该仓库下**列表里第一个库**为准、配置不一致时打印警告；pull 之后**只重启内容真的变了的库**。
+- **快速笔记的目标库**：卡片里有一个「写入」下拉，**默认跟随你在 GUI 里看的那个库**（右下角菜单切换焦点库，它就跟着变）；在里面手动选过之后，这张卡片就不再被焦点带走。改目标库是**整张卡片一起换**——标签建议、最近列表、附件上传、保存、以及随后弹出的 TW 编辑器都会落到同一个库。目标库没在运行时卡片会先提示你，而不是等你写完再失败。
 - **「移出列表」不删目录**：只是让插件不再管理它，内容原样保留。
 - **清单文件**：`$DSH_HOME/dsh-tiddlywiki/wikis.json`（在每本 wiki 之外，所以它不会随某个库被搬走）。
   手写时注意：`id` 只能用小写字母/数字加 `._-`，且不能是 `status`/`files`/`recipes`/`render` 这类与 TW