dsh-tiddlywiki 0.24.1 → 0.25.0

package/README.md

@@ -29,7 +29,7 @@
 | 🎨 **自定义样式** | 「自定义样式」seed：编辑器美化 / 窄屏侧栏隐藏 / menubar 加高 / 批注弹窗等 5 张通用样式表，新 wiki 也能一键初始化（可选，v0.16.22） |
 | 📝 **可配置的注入提示词** | 插件注入每个会话的「TiddlyWiki 持久知识库」提示词可在设置页配置：**默认精简版**（v0.24.0 起 ~1.9KB，只保留工具 schema 表达不了的约定——同步纪律 / 工作区标记 / 先窄后宽检索 / 时效标注 / 链接格式），可选**完整版**（额外附一份**由工具注册表实时生成**的参数索引，不会再过期）；`extra` 追加自定义规范、`override` 整段接管、可整体停用；**保存后无需重启 dsh web**（section 即时重注册，当前会话下一步即生效），设置页可**按表单当前值预览**即将注入的全文（未保存的形态切换也立刻可见，v0.21.0 / v0.22.7） |
 | 🤖 **Agent 工具** | 15 个 `tiddlywiki_*` 工具：检索（**相关度排序 + 命中处片段 + 字段过滤**）、读写、**增量追加**、批量、重命名、**软删除/回收站**、**反向链接**、**附件入库**、**知识库体检**、git 同步与冲突解决（v0.19.0；检索/最近仍在**服务端**排除二进制附件，大 wiki 上从 515MB/17s 降到 ~0.4s） |
-| 🛡️ **不会被覆盖的写入** | 所有写入路径（agent 工具 **与** 快速笔记/编辑器路由）都**先读后写**：不传 tags 就保留原有标签、自定义字段与**内容类型**（`text/css`/wikitext 等不会被重置成 Markdown，v0.20.1）；`tiddlywiki_put(..., expectedModified/expectedRevision)` 与 `tiddlywiki_delete(..., expectedModified/expectedRevision)` 乐观并发——读取后若有人（在 TW 编辑器里）改过，写入/删除被拒绝（HTTP 409）而不是静默覆盖或丢进回收站；**给了哪个令牌就必须匹配哪个**（v0.23.5：两个令牌是 AND 不是 OR——`revision` 是 TW 的内存计数器、重启会复位，旧逻辑会因此静默放行跨重启的覆盖）；`tiddlywiki_attach` 的同名标题**默认拒绝**（要覆盖必须 `force: true`）；`tiddlywiki_delete` 默认**软删除进回收站**，`tiddlywiki_trash` 可恢复（v0.19.0 / v0.19.1 / v0.19.5 / v0.23.5） |
+| 🛡️ **不会被覆盖的写入** | 所有写入路径（agent 工具 **与** 快速笔记/编辑器路由）都**先读后写**：不传 tags 就保留原有标签、自定义字段与**内容类型**（`text/css`/wikitext 等不会被重置成 Markdown，v0.20.1）；`tiddlywiki_put(..., expectedModified/expectedRevision)` 与 `tiddlywiki_delete(..., expectedModified/expectedRevision)` 乐观并发——读取后若有人（在 TW 编辑器里）改过，写入/删除被拒绝（HTTP 409）而不是静默覆盖或丢进回收站；**给了哪个令牌就必须匹配哪个**（v0.23.5：两个令牌是 AND 不是 OR——`revision` 是 TW 的内存计数器、重启会复位，旧逻辑会因此静默放行跨重启的覆盖）；`tiddlywiki_attach` 的同名标题**默认拒绝**（要覆盖必须 `force: true`）；`tiddlywiki_delete` 默认**软删除进回收站**，`tiddlywiki_trash` 可恢复（v0.19.0 / v0.19.1 / v0.19.5 / v0.23.5）。**v0.25.0**：`tiddlywiki_append` / `tiddlywiki_rename` / `tiddlywiki_batch_put`（逐条目）也支持并发令牌——它们同样是「读全文 → 整篇回写」，此前**没有令牌可传**，而注入的提示词恰恰让模型回传 `expectedModified`；`tags: []` 现在表示**清空全部标签**（此前被当成「未传」而静默保留，模型按 lint 的 junk-tags 建议去清标签时什么都不会发生）；`tiddlywiki_rename` 更新引用时若某个引用者在遍历期间被改动过，**跳过它**并在回执里报出数量，而不是覆盖它 |
 | 🏷 **工作区感知的读写** | **新建**笔记自动带 `ws/<项目名>` 标签 + `workspace` 字段（项目名取自会话工作目录，`note.workspaceMark` 可关）；`tiddlywiki_search` 因此默认**先在本项目里找、区内 0 条才自动扩大到全库**并在回执里写明实际范围，`query` 按空白切词、**全部词命中**才算（AND）。工作区只是**附加**标记，绝不改写笔记原有的标签/字段，也**只在新建时**打（v0.24.0） |
 | 🕰 **时效性内容只提示不删** | 阶段性笔记（版本记录 / 部署步骤 / 排期 / 临时方案）可声明 `valid-until`（硬过期）或 `review-after`（该复查），被取代时写 `superseded-by` + `superseded` 标签并**保留旧笔记**；`tiddlywiki_lint` 的 `stale` 检查**只报告**（含「版本号或 done 标签 + 长期未改动」的**候选**，明确标注非判定）——**淘汰永远由人决定**，插件不会自动删除或归档任何笔记（v0.24.0） |
 | 🚰 **重启不丢写入** | 停/重启 TW 只有一条路：`drainThenStop()`——**排干 syncer 队列之后才停子进程**，`/restart`、`/admin/restart`、插件/主题变更后的重启、知识库切换、`/sync`、seed 全部经它（此前其中三条直接杀进程，在一秒内点「重启 TW」会静默丢掉刚写的笔记）；排干不完整会在回包里如实报 `drained:false`，而不是假装没事（v0.24.1） |
@@ -43,9 +43,9 @@
 | 📮 **发布到微信公众号**（**可选，默认关**） | 把笔记一键发到公众号**草稿箱**（可选点发表）：TW 渲染 → 补内联样式 → 浏览器自动化复用你已登录的后台会话。**绕开官方 API 权限封锁**（2025-07 起个人主体账号的发布接口被回收），个人号可用；发表需管理员扫一次码。**需额外安装**（opencli + 浏览器扩展），插件不替你装；**关闭时完全不打扰**（不注入提示词、不写文档）。**带发布元数据**（`pub-state`/`pub-platform`/`pub-wechat-*` + `no-publish` 标签）避免重发或误发。**v0.23.3 起 TW 工具栏有「发布到公众号」按钮**（预检 + 进度轮询，只到草稿箱），也可继续用 CLI。见 [docs/wechat-publish-setup.md](docs/wechat-publish-setup.md) |
 | 🧭 **内嵌编辑器** | 中央列内嵌完整 TW 5 编辑器（同源代理，Tailscale/内网/域名/HTTPS 均可） |
 | 🗂️ **右侧边栏 Tab** | DSH 新右侧栏（rightbar）：首页「TiddlyWiki 知识库」入口一键打开，与聊天并排；链接点击可直达（v0.16.21） |
-| 🧪 **审计守门** | 第四轮审计（v0.20.0）把 CI 与 `npm run verify:*` 合成一份清单，并补上 `verify-constants`（filter 长度预算）、`/render` 403、auth 打码、notify 与草稿避让回归 |
+| 🧪 **审计守门** | 第四轮审计（v0.20.0）把 CI 与 `npm run verify:*` 合成一份清单，并补上 `verify-constants`（filter 长度预算）、`/render` 403、auth 打码、notify 与草稿避让回归。**v0.25.0 再加两道**：`verify-config-patch`（设置页补丁必须过 `normalizeConfigPatch`：范围夹取 / 类型错误 400 / `__proto__` 等危险键拒绝 / 未知键透传）与 `verify-tool-views`（源码级断言**客户端 `TOOL_VIEW_KEYS` 与 host 注册的工具名完全一致**、`TOOL_LABELS` 全覆盖、工作区前缀与 host 常量相同——此前只靠 AGENTS.md 一句「记得同步」，新增工具时卡片会静默退化成纯文本） |
 | 🧩 **Better Sidebar 共存** | 与 dsh-better-sidebar 侧边栏共存（其展开/收起按钮浮在 TW 面板之上）；**不再向该侧边栏注册 TW tab**（v0.17.0 移除了 tab 注册，避免 tab kind 冲突） |
-| 📚 **会话知识库 Tab** | 每个会话顶部汇总本会话读写过的 wiki 笔记，TW 原生渲染（host `/render` 片段管线 + 白名单净化，v0.16.19 / v0.19.1） |
+| 📚 **会话知识库 Tab** | 每个会话顶部汇总本会话读写过的 wiki 笔记，TW 原生渲染（host `/render` 片段管线 + 白名单净化，v0.16.19 / v0.19.1）。**v0.25.0 补齐**：归类含 **`append`（增量写入）/ `attach`（附件）**（此前用 append 写的笔记在这个 Tab 里**完全不可见**，而注入提示词恰好推荐 append），并新增「🗑 删除 / 回收站」一节；事件日志读不出来的会话会**在页面上明说**（不再静默吞掉、把「读不出来」显示成「没碰过笔记」）；读取改为 4 路有界并发 + 12s 墙钟预算（最坏 375s → 有界，客户端 25s abort 后不再继续压着 TW 打）；生成有 3s 单飞/复用；`$:/temp` 条目被 TW 重启清掉时自愈（**三态探测**：在 / 被清 / 状态未知——未知不计失败也不清零），另按 3 分钟节拍静默刷新，长期开着也能跟上会话 |
 | 📝 **快速笔记** | 输入框上方快捷按钮或右下角「知识库」FAB；原生编辑页或 Markdown 卡片两种模式；首页内置「快速记笔记（完整编辑器）」 |
 | 📌 **本地剪藏桥** | 可选「剪藏桥 + 书签小工具」：DSH 监听 127.0.0.1 端口接收剪藏请求（Host 校验防 rebinding），点书签弹出浮层——可改标题/编辑选中文字/**勾选图片**，一键写入知识库；文字成笔记（默认 `clip` 标签），图片由桥下载存为**二进制附件**（`type: image/*` + base64，笔记内 `[img[标题]]` 内嵌），随 wiki 自动进 git；图片下载有 **SSRF 守卫**（仅公网 http(s)、逐跳校验重定向，v0.18.0） |
 | 🔐 **写操作防跨站** | 所有写路由（笔记/上传/同步/后台/代理）拒绝跨站请求（403），仅同源的 GUI 与内嵌 TW 可写；跨站 GET 与浏览器地址栏直达不受影响（v0.18.0） |
@@ -53,6 +53,7 @@
 | 🌗 **跟随主题** | 内嵌 TW 自适应 DSH 深浅主题（纯内存切换，不进 git） |
 | 🔄 **一键同步** | FAB「同步」一键 pull→commit→push，状态点实时反映 git 状态 |
 | 💾 **数据即备份** | wiki 文件夹本身就是 git 仓库，自动 commit（60s 防抖） |
+| ⚙️ **设置页不再「假装生效」** | **v0.25.0** 把一批「保存了却不变」的项收敛掉：`git.autoCommit`/`git.debounceMs`/`git.remote` 保存后**对运行中的插件立即生效**（重建防抖提交器 + 指向新 remote；`git.branch` 只对首次初始化的仓库有意义，标签里已写明，状态行显示的是真实分支）；数值项（端口 / 就绪窗口 / 分页条数 / 防抖毫秒）带 `min`/`max` 与字段旁红字，非法值**拒绝保存**而不是静默夹取；保存被拒（409，例如配置 tiddler 残留冲突标记）时错误**持久显示**而不是一闪而过的 toast；「没有改动」不再发请求、宿主也不重写配置 tiddler（每次空点保存都给 git 造 diff / 两台机器在 `.meta` 上冲突）；插件/主题/语言的未应用勾选能活过「同步 / 重启」触发的重刷；表单有未保存内容时若配置在别处被改过，**保留你的输入**并给出显式提示而不是重建表单；微信发布的 `command`/`adapter`/`token`/`dsn` 补齐 UI（token 是密码型 + 显隐切换，掩码回填照旧） |
 
 ---
 
@@ -413,6 +414,8 @@ lib/                    # 预构建产物（发布含 lib/**，提交入库；
 
 > 最近几个主要版本的一句话记录（完整变更见 [Releases](https://github.com/bbqisbbq/dsh-tiddlywiki/releases) / git log）。
 
+- **v0.25.0**（2026-09-20）：**第五轮代码审计的修复版**（审计那天被用户判定为「本地单机可接受、不修」的只有一条：`POST /render` 的 **title 分支**可以经被渲染条目正文里的 `{{…}}` 转写把插件配置读出来——本机实测复现，`text` 分支早已 403；不修的理由是单机自用、且真正的边界本就不在这条路由（任何笔记正文的 `{{$:/plugins/dsh-tiddlywiki/config}}` 在嵌入式 TW 面板里同样会被转写渲染）。其余全部修掉，按性质分四组。**① 工具契约（数据安全）**：(a) **`tags: []` 现在真的清空标签**——此前 `normalizeTagArg()` 把空数组归一成 `undefined`（=「未传 = 保留原标签」），而 `tags` 又是 `RESERVED_TIDDLER_FIELDS` 成员（`fields.tags` 会被拒），于是**没有任何途径**把一篇笔记的标签改成空：模型照 `tiddlywiki_lint` 的 junk-tags 建议去清标签、传 `[]`，什么都不会发生，回执还把旧标签原样列出来（本机实测）。(b) `tiddlywiki_append` / `tiddlywiki_rename` / `tiddlywiki_batch_put`（逐条目 `expectedModified`）补上**乐观并发令牌**：这三条与 put/delete/attach 一样是「读全文 → 整篇回写」（append 读旧基底再加一段），而可传令牌的只有后三条 —— 注入提示词让模型回传 `expectedModified`，append 却**没有这个参数**，人类在 TW 编辑器里的并发修改会被旧基底静默回滚。(c) `tiddlywiki_rename` 更新引用时**逐个重读引用者**（列表只是快照），遍历期间被改动过的跳过并在回执里报出数量——跳过一条链接可以手工补，被覆盖掉的一段正文不可恢复。(d) `tiddlywiki_attach` 的 `noteTitle` 指向二进制附件时明确拒绝（会把 base64 写坏而回执看着正常）。(e) `tiddlywiki_lint` 的 `checks` **拼错不再谎报干净**：本机实测 `checks:["broken-link"]`（少了 s）在 2933 条笔记的知识库上**一个检查都没跑**，回执却是「扫描 2933 条文本笔记，发现 0 个问题 / 没有发现问题」；现在回执列出**实际运行**的检查、显式报出无法识别的名字，且「一个检查都没跑」不再等于「没问题」。(f) `valid-until` / `review-after` 的纯日期（`YYYY-MM-DD`）改按**当地日终**判过期，此前按 UTC 0 点算，东八区当天 08:00 就报「已过期」。**② 设置项（都是「保存了却不变」）**：`git.autoCommit`/`git.debounceMs`/`git.remote` 保存后**对运行中的插件立即生效**（`AutoCommitter` 在构造时把 enabled/debounceMs 快照进不可变 options，remote 只在启动 bootstrap 时应用——此前关掉自动提交仍会 commit、换远端仍推老地址，直到重启 dsh web）；「重启 TW」按钮的 15s 超时改为 120s（`/admin/restart` 要等 TW 就绪，软窗口默认 60s、大知识库自述 44s+，此前会弹「重启失败」而宿主其实成功）；数值项（`bridge.port` / `startup.readyTimeoutMs` / `ui.allArticles.pageSize` / `git.debounceMs`）加 `min`/`max` 与字段旁红字，非法值**拒绝保存**（宿主对越界值是静默夹取/回落，提交只会继续制造「回显 ≠ 生效」）；**空补丁不再发请求**、宿主在序列化文本逐字节相同时**跳过 PUT**（每次空点「保存配置」都会重写配置 tiddler 并刷新 `.meta` 的 `modified` → 白造 git diff、两台机器各点一次就冲突在 `.meta` 上，与 v0.24.2 刚修的 `$__language.txt.meta` 同类）；保存被拒（409，如配置 tiddler 残留冲突标记）时错误**持久显示**在配置区而不是一闪而过的 toast；微信发布的 `command`/`adapter`/`token`/`dsn` 补齐 UI（token 密码型 + 👁 显隐切换，掩码回填语义照旧）；插件/主题/语言的未应用勾选提升为页面级状态，能活过「同步 / 重启」触发的重刷；表单有未保存内容时若配置在**别处**被改过，保留你的输入并显式提示，而不是重建表单把输入清掉；首屏加「加载中…」、加载失败不再清空已填表单。宿主侧 `/admin/config` 的补丁现在必须过新的 `normalizeConfigPatch()`：**已知数值夹取到真实边界、已知布尔/字符串类型错误返回 400 并点名字段、`__proto__`/`constructor`/`prototype` 一律拒绝、未知键透传**（此前任意 JSON 都会落进配置 tiddler——数组体变成 `{"0":1,"1":2}` 这种永久垃圾键，`git.debounceMs: "abc"` 会经 `??` 进 `setTimeout` 被当 0 → 每次写入都 commit）。**③ 会话「知识库」Tab**：`NOTE_TOOL_NAMES` 补 `append`（「增量写入」）/`attach`（「附件」）/`delete`/`trash`（`restore` 计产生），新增「🗑 删除 / 回收站」一节——此前**用 append 写的笔记在这个 Tab 里完全不可见**，而注入提示词恰好推荐「纯增量内容优先用 append」，于是一整轮工作会被显示成「本会话暂时没有产生、读取或检索过任何知识库笔记」；事件日志读不出来的会话**在页面上明说**（不再静默吞掉、把「读不出来」显示成「没碰过笔记」），`counts.sessions` 只统计成功读取的会话；读日志从串行改 **4 路有界并发**、探测整段加 **12s 墙钟预算**（最坏 ~375s → 有界，客户端 25s abort 之后不再继续压着 TW 打），生成加 **3s 单飞复用**；客户端自愈改为**三态探测**（在 / 被清 / 状态未知——未知既不计失败也不清零，此前 `catch { return true }` 把「探测失败」当「一切正常」），自愈 interval 与 `phase` 解耦（进 error 态后不再永久失去重试），并新增**按 3 分钟节拍的静默刷新**（tab 长期开着也能跟上会话，不闪 loading 不砸内容）；`escapeInline()` 中和 `{}`（会话日志里出现的 `{{…}}` 会被 `/render` 转写展开）并改为**先截断再转义**（否则 `&amp;` 会被截成 `&am`）；`scanRefs` 不再把标题里的 `)`/`]` 一律截断；`TitleState.snippet` 从死字段改为真的渲染。**④ 其余**：检索卡片的范围与工具结果对齐（卡片把模型可见回执里读到的 `workspace` 回传 `/search`，v0.24.0 只改了工具侧——卡片会列出**更多**的结果且不显示范围）；`/status` 的 git 冲突内容扫描加上限（200 个文件 / 2MB，批量导入期间不再每 30s 同步读几千个文件阻塞事件循环）；`tiddlywiki_delete` 的描述写明 `$:/` 系统条目实为永久删除；`TiddlywikiConfig.note` 补上漏掉的 `workspaceMark`（三处形状 lockstep）；`tiddlywiki_attach` 有专属卡片。**守门**：新增 `scripts/verify-config-patch.mjs`（6 组纯函数断言：非对象拒绝 / 越界夹取 / 类型错误点名字段 / 危险键拒绝 / 未知键透传）与 `scripts/verify-tool-views.mjs`（5 条源码级断言：`TOOL_VIEW_KEYS` 与 host 工具名完全一致 / `TOOL_LABELS` 全覆盖 / 工作区前缀两处一致 / 搜索卡片仍回传 `workspace`），两者进 `verify:unit`；`verify-tools.mjs` +4 条真实 TW 断言（`tags:[]` 清空且「不传」仍保留 / append 令牌不匹配拒绝、匹配放行 / batch 逐条失败 / lint 未知检查名不得谎报）；`verify-write-policy.mjs` +1 条（空数组 vs 不传的语义边界）。**已反向验证的路径**：把 `normalizeTagArg` 还原成「空数组 → undefined」、把 lint 的 `checks` 还原成自由集合、把 append 的令牌检查删掉，对应断言分别变红。
+- **v0.24.2**（2026-09-20）：**修「`$:/language` 每次 dsh web 启动都被无条件重写 → 两台机器每次 pull 都冲突」**。现象：`git pull` 稳定卡在 `tiddlers/$__language.txt.meta` 上，而**正文文件根本不冲突、diff 出来只有 `created`/`modified` 两行**；本仓库的 git 历史里甚至已有一条专门清理该冲突残留的提交，而 2026-09-20 一次会话内又撞了两次。根因定位到行：启动自举应用 `uiLanguage` 时、以及设置页改动语言时，两处都**无条件 PUT** `$:/language`（正文每次都一样，但 TW 会给 `.meta` 盖新时间戳）——两台机器各自启动过就都改了同几行。现在抽出 `pinLanguageTiddler()`（`src/host/admin.ts`）：**先读，内容一致就不写**，内容不同/条目不存在才写。⚠️ 关键边界：**读失败绝不等于「内容相同」**（铁律第三条）——`client.get()` 只有 404 返回 undefined、其余抛错，抛错时**照写并记一条日志**，否则用户的语言会永久卡在错的值上且重启也修不回来。**守门**：新增 `scripts/verify-language-pin.mjs`（进 `verify:unit`）——4 条桩 client 行为断言（一致不写 / 不存在要写 / 不同要写 / 读失败照写并报警）+ 源码级断言（`index.ts` 与 `admin.ts` 除原语自身外**一处裸 PUT 都不许有**，且两处都必须经 `pinLanguageTiddler`）。**已反向验证**：还原启动路径为无条件 PUT → 红 1 条；把读失败分支改成「直接 return false」→ 红 1 条。（附带一条方法论教训：第一次做这条反向验证时**构建因我的改写而失败**，而我把构建输出丢进了 `$null`，于是守门测的是旧 `lib/`、假绿了一轮；重做时把构建输出放回台面才抓到真红。反向验证必须确认「改动真的被编译进去了」。）
 - **v0.24.1**（2026-09-20）：**修「重启/停止 TW 的四个路径里有三个没排干 syncer 队列」——一类静默丢写入的缺陷**。本仓库铁律第一条要求「重启 TW 前必须把 syncer 队列排干」，但那条规则**只写在文档里**：`POST /restart`、`POST /admin/restart`、`POST /admin/info`（改插件/主题后重启）与「知识库切换」的 `stopServer` 全都是**直接杀 TW 子进程**，而 TW 的 REST PUT 返回 204 时条目还在内存里、文件系统 syncer 要 ~250ms 后才落盘 —— 在那一秒内点「重启 TW」，刚写的笔记就随子进程一起消失（与 v0.19.0 丢 `tw-web-host`、v0.22.0 才发现 throttle 竞态同一类）。只有启动自举 / seed / `/sync` 三处走了 `flushPendingWrites`。**根因不是谁写错了某一行，而是「规则」和「代码」之间没有强制关系** —— 所以这一版不是补四个调用点，而是把不变量变成**原语**：新增 `drainThenStop()`（`src/host/seeds.ts`，**排干发生在它内部**，签名是 `{client, tiddlersDir, stop}`），四个路径全部改为经它停/重启，调用方**没法**绕过；`stop` 的返回类型放宽为 `Promise<unknown>`（`restart()` 回状态视图、`stop()` 回 void，排干都不关心）。`/restart` 与 `/admin/restart` 的回包新增 `drained`，排干不完整时如实上报而不是静默。**守门**：新增 `scripts/verify-restart-drain.mjs`（进 `verify:unit`）——① 顺序断言：`drainThenStop` 内部「排干的 await」必须早于「stop 的 await」，且排干失败必须走显式分支后**仍然 stop**（best-effort：不能因为排不干就把用户锁死在起不来的 TW 上）；② 源码级断言：`routes.ts`/`admin.ts` 里**每个** `deps.server.restart()` 都必须作为 `drainThenStop({stop: …})` 的参数出现（裸 restart 即红），`index.ts` 的 `stopServer` 必须包在它里面；③ 行为断言：用桩 client 真跑一遍，确认「写入真的落盘之后才 stop」「client 缺失（TW 没在跑）是安全 no-op」「排干失败也继续 stop 并把警告交出去」。**已反向验证**：分别把 `/sync` 路径、知识库切换还原成裸调用、并删掉 `drainThenStop` 里的 `stop`，三次都稳定变红。顺带把 `/sync` 与 seed 两条**本来就在 flush** 的路径也收敛到同一原语，从此「重启前排干」只有一个实现。
 - **v0.24.0**（2026-09-20）：**三处「Agent 读写 wiki 的规矩」按用户要求改进 + 一个 lint 误报修复**。① **新建笔记自动标工作区**：`put`/`batch_put`/`append` 新建条目时自动带上 **`ws/<项目名>` 标签 + `workspace` 字段**，项目名取自调用会话的工作目录（新 `src/host/workspace.ts` 纯函数：Windows/Unix 路径、尾斜杠、CJK、非法字符规范化；`home`/`tmp`/`desktop` 这类通用目录与**驱动器根目录**一律拒绝——后者是写这个模块的守门脚本抓出来的真缺陷：`C:\` 会被算成 `C:`，在盘根开会话时全盘笔记都挂上 `ws/C:`）。标记是**附加式**（调用方标签在前）、**仅新建**（覆盖不追打，也不会改写已有 `workspace` 字段）、`$:/` 豁免、`note.workspaceMark: false` 可关、调用方显式 `fields.workspace` 优先；`exec` 缺失 / 会话无 `cwd` / 未知会话一律**安全降级为不标记**（不猜、不抛错）。为什么标签必须带 `ws/` 前缀：裸项目名与真实业务标签撞车——作者库里 `dsh-tiddlywiki` 已挂着 2510 篇导入的书籍章节。② **检索先窄后宽 + 多词 AND**：`tiddlywiki_search` 先在工作区内查、**区内 0 条才自动扩大到全库**，回执明确写出「已在工作区 ws/X 内缩小范围」或「工作区 ws/X 内 0 条，已扩大到全库」（**「工作区内 0 条」不等于库里没有**，这是把「搜不到」错判成「不存在」的主要来源）；`query` 从**整串子串匹配**改为按空白切词、**全部词命中**才算（旧行为连 `alphaprobe betaprobe` 这种自然的双词查询都永远匹配不到）；调用方显式传 `tag`/`field`/`value` 时**不自动收窄**（显式范围不被二次猜测）。③ **过期内容淘汰策略（只提示，绝不自动删）**：阶段性笔记写 `valid-until`（硬过期）/ `review-after`（该复查），被取代时写 `superseded-by` + `superseded` 标签、**保留旧笔记**；`tiddlywiki_lint` 新增 `stale` 检查（默认开启、`staleAfterDays` 默认 180），报 `stale-expired` / `stale-review` 两类**硬判定**加一类 `stale-candidates`（带版本号或 `done` 标签且长期未改动，**明确标注「候选，非判定」**）。**淘汰只由人决定**——报告全程只读，不删不改不归档。④ **修 lint 死链误报**（v0.23.6 的内容并入本版）：死链正则 `\{\{([^}]+)\}\}` 会把 `{{{ [tag[todo]count[]] }}}` 这类**三花括号过滤器表达式**从第 1 个 `{` 开始捕获成「转写目标」并报死链（实测线上 480 条死链报告里 8 条属此类），现在用前后瞻 + 捕获内容守卫排除。**明确不改的**：≈440 条真实死链**保留不修**——多数是用户手工删掉的笔记，属预期状态（只读报告是对的，自动「修复」是错的）。**守门**：新增 `scripts/verify-workspace.mjs`（进 `verify:unit`，9 组纯函数断言，含「任何 cwd 算出的标签都不得是垃圾标签 / 含空白 / 丢前缀」这条与 `isJunkTag()` 的跨模块一致性检查，以及 `ws/` 前缀不得被「简化」掉的回归），`verify-tools.mjs` +12 条真实 TW 断言（工作区标记六种形态 + 多词 AND + 先窄后宽 + `fellBack` + `stale` 三类），`verify-prompt.mjs` +1 条「三条新治理规则必须在场」并把 slim 长度预算从 1800 调至 2100（**预算上调与新增的逐条断言绑定**：删掉任何一条规则即红）。**所有新守门都做过反向验证**：分别还原旧行为（整串子串检索 / 关掉工作区收窄 / 关掉自动标记 / 关掉 stale 检查 / 去掉驱动器根目录判定 / 从规范化字符集里删掉 `|`）后，对应断言稳定变红。slim 正文实测 1918 字符（full 2722）。