dsh-skill-tag 0.1.4 → 0.1.6

package/README.md

@@ -57,6 +57,8 @@ office * plugin       # 只要 office 包带来的、且是插件相关
 <img src="https://raw.githubusercontent.com/aawef/dsh-skill-manager-tags/main/images/skill-to-tags.png" width="640" alt="skill 联系 tag：左列技能、右列标签勾选">
 
 左列 `技能 (105)` 每行标着它有几个标签；右边勾选**即时保存**，不用点确认。
+右列会把该技能**已有的标签排在列表最前面**（并保持它们原来的相对顺序），所以不用滚动
+去列表里找；顶部搜索框过滤之后，"已拥有优先"依然成立。
 这是配条件前最常开的一页：先看清楚"这个技能到底被哪些标签命中"。
 
 ### 图 5 · 工作区「管理标签」：左写条件，右就是下发名单
@@ -65,7 +67,8 @@ office * plugin       # 只要 office 包带来的、且是插件相关
 
 左列是标签条件，下面实时显示**解析结果**和状态「有条件筛选（严格子集）」；
 右列 `技能 (54)` 就是该工作区下发给模型的全部技能，每行可以「查看 tag」「禁用」，
-📁 直接打开技能所在文件夹。底部还能「+ 精细化添加技能」「查看被禁用的技能」。
+📁 直接打开技能所在文件夹。列表顶部的**搜索框**只过滤显示（标题会变成 `技能 (匹配/总数)`），
+不改动实际下发的技能集合。底部还能「+ 精细化添加技能」「查看被禁用的技能」。
 
 ### 图 6 · 对话「管理标签（对话）」：可以有自己的一份
 
@@ -110,15 +113,22 @@ dsh plugin --profile <your-profile> add github:aawef/dsh-skill-manager-tags
 
 > 依赖 Node ≥ 20；需要 DSH `0.2.0-rc.1` 及以上（见 `engines.dsh`）。
 >
-> 宿主的 `@deepseek-ai/cordis` 与 `@deepseek-ai/dsh-storage-domain` 都声明为
-> **peerDependency**，由 DSH 本体提供，**不要自己安装**：本插件会 `import` 它的 `defineDomain`
-> 来注册存储域，必须与宿主使用同一份模块实例，装成 `dependencies` 会把旧版本提到 profile
-> 顶层、遮蔽宿主版本，导致 `workspaceController` 等服务无法上台（详见 CHANGELOG 2026-10-21）。
+> 宿主的 `@deepseek-ai/cordis` 声明为 **peerDependency**，由 DSH 本体提供，**不要自己安装**。
+>
+> 存储域 spec 由本插件 `src/storage/domain-spec.js` 本地构造（等价于宿主的 `defineDomain` /
+> `domainTable`），运行时通过 `ctx.storageDomain.open()` 交给宿主打开，**不 import 任何宿主内核包**。
+> 这样 profile 里不会出现与宿主同名的第二份模块副本：早期版本曾 `import`
+> `@deepseek-ai/dsh-storage-domain`，宿主升级（如 `0.2.1-rc.2` → `rc.3`）时那份旧副本会被判定
+> 不兼容并拒绝加载，导致存储域整体不启动、会话与工作区列表全空（详见 CHANGELOG 2026-10-24）。
 
 ### 本地开发式安装
 
-如果你直接改源码，注意**源码目录和 profile 的 `node_modules` 里那份是两个物理文件**，
-改完必须手动复制并校验哈希：
+运行时加载的是 profile 里 `node_modules/<插件名>` 那一份，不是你的源码目录。两种接法：
+
+- **junction（推荐）**：让 `~/.dsh/profiles/web/my-plugins/<插件名>` 指向你的源码目录，
+  pnpm 会把它硬链接进 `node_modules` —— 三个路径是**同一个 inode、同一份文件**，
+  改完内容立刻生效，不需要复制；只有**新增/删除文件**才要在 profile 里重跑一次 `pnpm install`。
+- **物理拷贝**：如果当初是手动 `cp` 进去的，那就是两份独立文件，改完必须再 `cp` 一次并校验哈希：
 
 ```bash
 S=/path/to/your/dsh-skill-tag
@@ -249,7 +259,7 @@ src/storage/         storage domain schema + repository
 src/reveal.js        拉起系统文件管理器
 skills/tagging-skills/  随插件注册给宿主的一个 skill
 tools/auto-tag.mjs      一键打标签脚本（dry-run 默认）
-tests/               node:test，192 项
+tests/               node:test，194 项
 docs/                设计文档（见下）
 images/              README 用的界面截图（不进 npm 包）
 ```
@@ -271,7 +281,7 @@ images/              README 用的界面截图（不进 npm 包）
 
 ```bash
 npm install
-npm test          # 192 项
+npm test          # 194 项
 ```
 
 测试分两类，都在 `tests/` 下：

package/lib/client.js

@@ -103,6 +103,20 @@ window.__ModuleLoader__.load({
 			return out;
 		}
 
+		/**
+		 * 「技能已有的标签排前面」：稳定分区，不改变各分区内部的原有顺序。
+		 * 只排显示顺序——勾选状态与写库内容都不受影响。
+		 * @param {Array<{tagId:string}>} tags 全部标签（顺序来自服务端）
+		 * @param {Iterable<string>} ownedIds 该技能已拥有的 tagId
+		 */
+		function ownedTagsFirst(tags, ownedIds) {
+			const owned = new Set(ownedIds ?? []);
+			const yes = [];
+			const no = [];
+			for (const t of tags ?? []) (owned.has(t?.tagId) ? yes : no).push(t);
+			return [...yes, ...no];
+		}
+
 		// ── 「打开技能所在文件夹」 ────────────────────────────────────
 		// 宿主没有给插件 reveal API，服务端由 src/reveal.js 拉起文件管理器。
 		// 这里只负责：名字 → 绝对路径（扫描结果自带 path）、发请求、缺路径时
@@ -515,6 +529,9 @@ window.__ModuleLoader__.load({
 			const ownedIds = selName ? (links.find((l) => l.skillId === selName)?.tagIds ?? []) : [];
 			const owned = new Set(ownedIds);
 			const tagMatch = (t) => !state.skillTagSearch.trim() || t.name.toLowerCase().includes(state.skillTagSearch.trim().toLowerCase());
+			// 已拥有的标签排在前面（不再是纯粹按服务端返回的字母序），便于确认"这个技能到底挂了什么"
+			const tagsOrdered = ownedTagsFirst(tags, ownedIds);
+			const tagsShown = tagsOrdered.filter(tagMatch);
 
 			/** 整组覆盖该技能的标签集合（勾选/取消都走这里，立即落库） */
 			const saveTags = async (nextIds) => {
@@ -576,9 +593,9 @@ window.__ModuleLoader__.load({
 							}),
 							react.createElement("div", { key: "rows", style: { maxHeight: "360px", overflowY: "auto" } }, [
 								tags.length === 0 && react.createElement("div", { key: "e", style: { color: "#888", fontSize: "12px", padding: "6px 2px" } }, "还没有任何标签，请先在主页面新建"),
-								tags.filter(tagMatch).length === 0 && tags.length > 0 &&
+								tagsShown.length === 0 && tags.length > 0 &&
 									react.createElement("div", { key: "e2", style: { color: "#888", fontSize: "12px", padding: "6px 2px" } }, "无匹配标签"),
-								...tags.filter(tagMatch).map((t) => react.createElement("label", { key: t.tagId, style: { ...rowStyle, cursor: "pointer" } }, [
+								...tagsShown.map((t) => react.createElement("label", { key: t.tagId, style: { ...rowStyle, cursor: "pointer" } }, [
 									react.createElement("input", {
 										key: "c", type: "checkbox", checked: owned.has(t.tagId), disabled: busy,
 										onChange: () => toggleTag(t.tagId),
@@ -1126,6 +1143,8 @@ window.__ModuleLoader__.load({
 			const [pickOpen, setPickOpen] = react.useState(false);
 			const [disabledOpen, setDisabledOpen] = react.useState(false);
 			const [tagOfSkill, setTagOfSkill] = react.useState(null);
+			/** 右列技能搜索词（对话版 / 工作区版共用；只影响列表显示，不影响下发结果） */
+			const [skillSearch, setSkillSearch] = react.useState("");
 
 			const load = react.useCallback(async () => {
 				try {
@@ -1190,6 +1209,10 @@ window.__ModuleLoader__.load({
 			/** 可添加的技能：排除已有（可见）与被禁用的 */
 			const addable = (ws?.universe ?? []).filter((n) => !visibleSet.has(n) && !disabledSet.has(n));
 
+			// 右列搜索：仅过滤显示，不影响「技能 (总)」这个语义数字
+			const skillQuery = skillSearch.trim().toLowerCase();
+			const shownSkills = (view.visible ?? []).filter((n) => !skillQuery || String(n).toLowerCase().includes(skillQuery));
+
 			// 技能名 → SKILL.md 路径（服务端把扫描结果的 path 一并带回来了）
 			const catalog = ws?.catalog ?? [];
 			const pathOf = (name) => catalog.find((s) => s.name === name)?.path ?? null;
@@ -1236,11 +1259,27 @@ window.__ModuleLoader__.load({
 
 					// ── 右列：技能 ──
 					react.createElement("div", { key: "right", style: colStyle }, [
-						react.createElement("div", { key: "h", style: { fontWeight: 600, marginBottom: "8px" } }, `技能 (${(view.visible ?? []).length})`),
+						react.createElement("div", { key: "h", style: { fontWeight: 600, marginBottom: "8px" } },
+							skillQuery
+								? `技能 (${shownSkills.length}/${(view.visible ?? []).length})`
+								: `技能 (${(view.visible ?? []).length})`),
+						// 搜索框：放列表顶部，只过滤显示（不改变实际下发的技能集合）
+						react.createElement("div", { key: "search", style: { display: "flex", gap: "6px", alignItems: "center", marginBottom: "6px" } }, [
+							react.createElement("input", {
+								key: "i", style: { ...input, flex: 1, minWidth: 0 }, type: "search", placeholder: "搜索技能…",
+								value: skillSearch, onChange: (e) => setSkillSearch(e.target.value),
+							}),
+							skillSearch.trim() !== "" && react.createElement("button", {
+								key: "c", style: { ...btn, padding: "1px 7px", fontSize: "11px" },
+								onClick: () => setSkillSearch(""),
+							}, "清除"),
+						]),
 						react.createElement("div", { key: "list", style: { flex: 1, overflowY: "auto", minHeight: "80px" } }, [
 							(view.visible ?? []).length === 0 && react.createElement("div", { key: "e", style: { color: "#888", fontSize: "12px" } },
 								"没有技能。可在下方「+ 精细化添加技能」手动加入，或清空标签条件回到全部技能。"),
-							...(view.visible ?? []).map((name) => react.createElement("div", { key: name, style: { ...listRow, flexWrap: "wrap" } }, [
+							(view.visible ?? []).length > 0 && shownSkills.length === 0 && react.createElement("div", { key: "nf", style: { color: "#888", fontSize: "12px" } },
+								`没有匹配「${skillSearch.trim()}」的技能。`),
+							...shownSkills.map((name) => react.createElement("div", { key: name, style: { ...listRow, flexWrap: "wrap" } }, [
 								react.createElement("span", { key: "n", style: { flex: 1 } }, name),
 								manualSet.has(name) && react.createElement("span", { key: "m", style: { color: "#3498db", fontSize: "11px" } }, "手动"),
 								react.createElement(RevealButton, { key: "rev", skillName: name, path: pathOf(name), label: "📁" }),
@@ -1266,7 +1305,8 @@ window.__ModuleLoader__.load({
 			};
 
 			return react.createElement("div", { style: overlayStyle, onMouseDown: (e) => { if (e.target === e.currentTarget) onClose(); } },
-				react.createElement("div", { style: modalBox, onClick: (e) => e.stopPropagation() }, [
+				// 固定高度：搜索让右列行数变少时窗口不能跟着缩（否则每敲一个字母窗口就抖一下）
+				react.createElement("div", { style: { ...modalBox, height: "82vh" }, onClick: (e) => e.stopPropagation() }, [
 					react.createElement("div", { key: "head", style: { display: "flex", alignItems: "center", gap: "10px", marginBottom: "10px" } }, [
 						react.createElement("strong", { key: "t", style: { fontSize: "14px" } }, scope.title),
 						react.createElement("span", { key: "w", style: { color: "#888", fontSize: "11px", ...monoStyle } }, scope.id),
@@ -1640,7 +1680,7 @@ window.__ModuleLoader__.load({
 			skillsLinkedTo, skillsNotLinkedTo, ZONE_LABEL,
 			workspaceIdOfRowKey, isWorkspaceMenu, manage, manageSet,
 			manageScope, registerComposerEntry,
-			skillPathOf, RevealButton,
+			skillPathOf, RevealButton, ownedTagsFirst,
 		};
 		return module.exports;
 	},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-skill-tag",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "给 DSH 的技能（skill）打标签，用一条布尔表达式在「工作区 / 对话」两级选出要下发给模型的技能子集",
   "type": "module",
   "main": "lib/index.js",
@@ -52,14 +52,13 @@
     "test:unit": "node --test \"tests/*.test.mjs\""
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": ">=4.0.2 <5",
-    "@deepseek-ai/dsh-storage-domain": "0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || >=0.3.0 <1.0.0"
+    "@deepseek-ai/cordis": ">=4.0.2 <5"
   },
   "dependencies": {
     "zod": "^3.25.76"
   },
   "engines": {
     "node": ">=20",
-    "dsh": "0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || >=0.2.1 <1.0.0"
+    "dsh": ">=0.2.0-rc.1 <1.0.0"
   }
 }

package/src/storage/domain-spec.js

@@ -0,0 +1,73 @@
+// skill-tag-plugin — 本地 domain spec 构造器
+//
+// 为什么不用 @deepseek-ai/dsh-storage-domain：
+//
+// 宿主已经通过 ctx.storageDomain.open(spec) 把 domain 能力注入进来了，插件真正
+// 需要的只是把 spec 构造宿主认识的形状：
+//
+//   { name, version, tables: { <tableName>: { valueSchema } }, global?, layout?, ... }
+//
+// 而宿主的 defineDomain 只做「校验 + 原样返回」，domainTable 只做
+// `{ valueSchema: schema }`。为了这两个纯函数去 import 内核包，会让 pnpm 必须
+// 在 profile 里再装一份 @deepseek-ai/dsh-storage-domain 实体，与宿主内置的同名
+// 模块形成「同一模块两份不同版本」——宿主每次升级（rc.2 → rc.3）都会因为旧副本
+// 被运行时判定不兼容而拒绝加载该插件，导致存储域整体不启动、会话与工作区列表
+// 全空。该故障在 0.2.0-rc.2 时代已经发生过一次（见 profiles/desktop/
+// pnpm-workspace.yaml 的 historical 注释），当时的做法是挪版本号 + 人工提醒，
+// 属于在地基上缝补。
+//
+// 现在改为本地等价实现，插件对宿主内核包零 import 依赖：升级宿主不再需要同步
+// 任何版本号，也不再有双份模块。
+//
+// 校验规则与宿主保持一致（宿主 @deepseek-ai/dsh-storage 的 UNIT_NAME_RE 为
+// /^[a-z][a-z0-9_]*$/；domain 名与表名都必须匹配）。宿主在 open() 时仍会二次
+// 校验，这里的校验只是让配置错误在模块加载时就暴露。
+
+const UNIT_NAME_RE = /^[a-z][a-z0-9_]*$/;
+
+/**
+ * 声明一张表：宿主只要求 { valueSchema } 这一层包装。
+ * @param {import("zod").ZodTypeAny} schema - 行记录的 zod schema
+ */
+export function domainTable(schema) {
+	return { valueSchema: schema };
+}
+
+/**
+ * 声明一个 domain：校验后原样返回 spec（与宿主 defineDomain 行为一致）。
+ * @param {object} spec - { name, version, tables, global?, layout?, compatibleVersions?, invalidRecords? }
+ */
+export function defineDomain(spec) {
+	if (!UNIT_NAME_RE.test(spec.name)) {
+		throw new Error(`domain name '${spec.name}' must match ${UNIT_NAME_RE}`);
+	}
+	if (!Number.isInteger(spec.version) || spec.version < 0) {
+		throw new Error(`domain '${spec.name}' version must be a non-negative integer, got ${spec.version}`);
+	}
+	for (const compat of spec.compatibleVersions ?? []) {
+		if (!Number.isInteger(compat) || compat < 0 || compat >= spec.version) {
+			throw new Error(
+				`domain '${spec.name}' compatibleVersions entries must be non-negative integers below version ${spec.version}, got ${compat}`,
+			);
+		}
+	}
+	if (spec.layout !== void 0 && spec.layout !== "single" && spec.layout !== "per-record") {
+		throw new Error(`domain '${spec.name}' layout must be 'single' or 'per-record', got ${spec.layout}`);
+	}
+	if (spec.invalidRecords !== void 0 && spec.invalidRecords !== "backup-and-skip") {
+		throw new Error(`domain '${spec.name}' invalidRecords must be 'backup-and-skip' when present, got ${spec.invalidRecords}`);
+	}
+	for (const table of Object.keys(spec.tables)) {
+		if (!UNIT_NAME_RE.test(table)) {
+			throw new Error(`domain '${spec.name}' table name '${table}' must match ${UNIT_NAME_RE}`);
+		}
+	}
+	// 宿主的 global schema 不接受 null：null 是介质的「从未写入」哨兵，
+	// 存进去的 null 无法与「不存在」区分，重新打开会静默回落到 initial。
+	if (spec.global !== void 0 && spec.global.schema.safeParse(null).success) {
+		throw new Error(
+			`domain '${spec.name}' global schema must not accept null: null is the medium's "never written" sentinel`,
+		);
+	}
+	return spec;
+}

package/src/storage/schema.js

@@ -1,8 +1,11 @@
 // skill-tag-plugin — storage domain schema (spec §12: 9 entity classes)
 //
-// Backed by @deepseek-ai/dsh-storage-domain defineDomain (evidence:
-// docs/evidence/extract-dsh-storage-domain.js — zod record schemas, KvTable
-// get/put/delete/update/entries, domain/changed events, caller closes).
+// Spec 形状由本仓库 src/storage/domain-spec.js 本地构造，刻意不 import 宿主内核包
+// @deepseek-ai/dsh-storage-domain（原因见该文件头部注释）。运行时通过
+// ctx.storageDomain.open(skillTagDomain) 交给宿主打开。
+//
+// KvTable 能力（get/put/delete/update/entries、domain/changed 事件、caller closes）
+// 来自宿主注入的 domain handle，见 docs/evidence/extract-dsh-storage-domain.js。
 //
 // Entity → table mapping (§12 table, one row per entity unless noted):
 //   tags            全局标签        {tagId, name, createdAt}   key=tagId
@@ -15,7 +18,7 @@
 //  "不要求必须用四张独立数据表"; they must persist, which they do here.)
 
 import { z } from "zod";
-import { defineDomain, domainTable } from "@deepseek-ai/dsh-storage-domain";
+import { defineDomain, domainTable } from "./domain-spec.js";
 
 // ── record schemas ──────────────────────────────────────────────────────────