@stofone/dsh-agent-roster 0.11.1 → 0.13.0

package/CHANGELOG.md

@@ -4,6 +4,63 @@
 
 ## [Unreleased]
 
+## [0.13.0] - 2026-11-03
+
+### A tab that behaves like a marketplace, not a filter on a list
+
+0.12.0 put a search field above the tabs. That was still the wrong shape: search belonged to a page about
+collections, and browsing still meant "pick a source, then read". The panel now opens on its own **Library**
+tab — search, tags, and one list that spans this machine and every subscribed source.
+
+- `GET /plugins/dsh-agent-roster/catalog` returns every roster in view in one response: this machine plus
+  each subscribed collection, with tags, member counts, member roles and where each one lives.
+- The tag strip is a real filter: counts are computed from everything in view, multiple tags are AND, and
+  the selection never writes back to a file. The segmented control switches between **by source** (this
+  machine, then one group per collection) and **flat** (one list, source named per row).
+- Search keeps its own route and its own ranking (`lib/search.js`): two characters, 240 ms debounce, and the
+  in-flight request is aborted when you keep typing, so typing never queues requests.
+- Compiled artifacts now carry what it takes to be *found*: `source.title`, `description`, `tags`, `license`
+  and `maintainers`. A subscribed roster is one file (`dist/<id>-<ver>.json`) resolved through `files` in the
+  index — previously the artifact knew its id and version and nothing else, so remote results could only be
+  searched by id.
+- The panel's tag chips were inheriting the sidebar's full-width row form; they are now chips (own width,
+  pill border, count attached), and the narrow layout gets the same 18px gutter as the rest of the page.
+
+### Changed
+
+- The header lookup field is gone; its behaviour lives inside the Library tab. `lookup.*` strings were
+  replaced by `catalog.*` (both locales).
+- `flattenCompiledToRoster` and `rosterViewOf` now fall back to artifact metadata, so a remote roster keeps
+  its title and tags after being flattened into a v1 document.
+
+### Fixed
+
+- `GET /catalog` and search share one `gatherEntries()` path; before, each route assembled local + remote
+  entries itself, which is how a cache or concurrency fix lands in one and not the other.
+
+## [0.12.0] - 2026-11-03
+
+### The panel answers "which one", not "show me everything"
+
+Until now the panel was organised by **collection**: expand a source, then read a list. But the real
+question is almost always the opposite — "I need someone who watches data quality" — so the entry
+point is now one search field above the tabs.
+
+- `GET /plugins/dsh-agent-roster/search?q=` searches this machine and every subscribed source in one
+  request, reusing the collection cache (60s) so repeated typing does not hit the network again.
+- Ranking is explainable: every match reports `hits[{field, label, text}]` ("标签：数据质量"), and id
+  matches outrank title matches outrank tag matches outrank member roles. Multiple words are **AND**:
+  "data kubernetes" matches nothing here, instead of matching everything that has "data".
+- A result that lives in another library says so ("来自 agent-roster-collective") and can be pulled
+  from the row itself; a local one opens straight into the roster list filtered to that id.
+- `lib/search.js` is a pure function — no filesystem, no network — so the ranking is unit-tested.
+
+### Added
+
+- `lib/search.js` with `searchRosters`, `searchableFields`, `tokenize`; 6 tests.
+- `/plugins/dsh-agent-roster/search` route (local + remote, bounded source concurrency).
+- Panel lookup field, result rows with match provenance, and `lookup.*` strings in both locales.
+
 ## [0.11.1] - 2026-11-03
 
 ### Fixed
@@ -557,7 +614,9 @@
 - 工具返回值含 `undefined` 键，运行时按 `value is not lossless JSON` 整次拒绝；缺失值统一写 `null`，
   且所有返回值先过 `lib/json.js#lossless`。
 
-[Unreleased]: https://github.com/dsh-agent-roster/dsh-agent-roster/compare/v0.11.1...main
+[Unreleased]: https://github.com/dsh-agent-roster/dsh-agent-roster/compare/v0.12.0...main
+[0.13.0]: https://github.com/dsh-agent-roster/dsh-agent-roster/compare/v0.12.0...v0.13.0
+[0.12.0]: https://github.com/dsh-agent-roster/dsh-agent-roster/compare/v0.11.1...v0.12.0
 [0.11.1]: https://github.com/dsh-agent-roster/dsh-agent-roster/compare/v0.11.0...v0.11.1
 [0.11.0]: https://github.com/dsh-agent-roster/dsh-agent-roster/compare/v0.10.7...v0.11.0
 [0.10.7]: https://github.com/dsh-agent-roster/dsh-agent-roster/compare/v0.10.6...v0.10.7

package/README.md

@@ -306,6 +306,31 @@ id belongs to the team, and the plugin never writes team state. What it does own
 failure that only exists on a red card never reaches the next compile, which is exactly how a gate
 turns into decoration.
 
+## The library tab: find by capability, not by source
+
+The panel opens on **Library**, which is meant to read like a plugin marketplace: one search field, one row
+of tags, and one list that spans this machine and every subscribed source.
+
+```
+要找什么能力？例：数据质量、发版、代码评审
+```
+
+Two characters in, after a 240 ms pause, the panel asks `/search` a question. Every row says **why** it
+matched (`标签：数据质量 · 成员角色：数据质量工程师`) and where it lives (`来自 agent-roster-collective`),
+and carries the next action — open it locally, or pull that collection — inside the row.
+
+With an empty field it **browses**: `/catalog` flattens this machine and the subscribed sources in one
+response, the tag strip summarises every tag in view with its count (multiple tags are AND), and the
+segmented control switches between **by source** (this machine, then one group per collection) and **flat**
+(one list, source named per row). Tag filtering is view state only; it never writes back to a file.
+
+Multiple words are AND, not OR: `data kubernetes` returns nothing rather than every roster that merely
+mentions "data". Ranking is a pure function in `lib/search.js`, so it is unit-tested rather than eyeballed.
+
+Subscribed rosters resolve through `files` in the index, which points at a concrete compiled artifact
+(`dist/<id>-<ver>.json`). The artifact carries its own title, description, tags, licence and maintainers,
+so finding a roster from a distance costs one file — not a clone.
+
 ## Tools
 
 | Tool | Purpose |
@@ -368,7 +393,7 @@ data directory, the team state directory and the version.
 
 A badge at the top summarises how many items need attention
 
-The client plugin adds an **Agent Roster** entry to the left sidebar: one row in the `sidebar.panellist` slot plus the matching key in the `main` slot. Clicking the row opens a full-width page with three tabs — the panel is not only a viewer:
+The client plugin adds an **Agent Roster** entry to the left sidebar: one row in the `sidebar.panellist` slot plus the matching key in the `main` slot. Clicking the row opens a full-width page with five tabs — the panel is not only a viewer:
 
 | Tab | What you can do |
 |---|---|
@@ -492,7 +517,7 @@ test/             unit tests
 
 Verified on this machine:
 
-- `npm test` — 300/300 passing (format, parse, validate, registry, paths, bridge, verify buckets, digests and provenance, roster diff, capability requirements and the capability gate, library organization, registry schema, lossless JSON, write plan/apply, all routes, panel snapshot and hints, dictionary consistency, tool contracts, client loader contract, library snapshot, config view, package manifest, declared fields and captain block, schema/constant alignment, the v2 role/roster/compiled layers and their schema alignment, v1→v2 migration, run records feeding the plan, remote registry and one-click install).
+- `npm test` — 308/308 passing (format, parse, validate, registry, paths, bridge, verify buckets, digests and provenance, roster diff, capability requirements and the capability gate, library organization, registry schema, lossless JSON, write plan/apply, all routes, panel snapshot and hints, dictionary consistency, tool contracts, client loader contract, library snapshot, config view, package manifest, declared fields and captain block, schema/constant alignment, the v2 role/roster/compiled layers and their schema alignment, v1→v2 migration, run records feeding the plan, remote registry and one-click install).
 - `npm run smoke` — `apply()` registers all six tools through a real `defineTool` from a DSH bundle; `roster_list` / `roster_show` / `roster_create` / `roster_verify` / `roster_diff` execute, every output survives `lossless` checks, `path` overrides are honored, effect disposal runs cleanly. The same command then loads `client.js` against a stubbed module table and asserts the three slot registrations, style injection and effect disposal.
 - CLI: `validate --dir examples` returns exit 0 over both example libraries.
 - Installed into a real profile with the plugin manager (`plugin_manager install_bundle` against this directory → `link:` dependency + bundle entry); the profile re-reads the linked files on restart.

package/README.zh.md

@@ -292,6 +292,28 @@ node bin/cli.mjs compile --roster examples-orchestration/rosters/core-review \
 
 回执由执行施工图的队长会话写，不由插件写：任务 id 属于团队，插件从不写团队状态。插件负责的是合并——只活在红卡上的失败，下一次编译就消失了，门也就变成了装饰。
 
+## 档案库：按能力找，而不是按来源翻
+
+面板的第一个页签是**档案库**，定位接近一个插件市场：一个搜索框、一排标签、一份横跨本机与所有订阅来源的清单。
+
+```
+要找什么能力？例：数据质量、发版、代码评审
+```
+
+输入两个字以上，停顿 240 毫秒后向 `/search` 提一个问题。每一行都写清**为什么命中**
+（`标签：数据质量 · 成员角色：数据质量工程师`）与**它住在哪**（`来自 agent-roster-collective`），
+并把下一步放在行内：本机的「打开」，远端的「拉取」。
+
+不输入时是**浏览**：`/catalog` 一次把本机与订阅来源摊平返回；上方标签池汇总全库出现过的标签与计数，
+多选是「且」；右侧可以在**按来源**（本机 + 每个 collection 各一组）与**平铺**（一份清单，来源写在行内）
+之间切换。标签筛选只影响视图，不写回文件。
+
+多个词是「且」不是「或」：`data kubernetes` 一条都不返，而不是把所有提到 data 的档案都堆上来。
+排序是 `lib/search.js` 里的纯函数，所以它被单测钉住，而不是靠肉眼看着顺。
+
+订阅来源的档案在索引里由 `files` 指向具体的编译产物（`dist/<id>-<ver>.json`）。产物自带标题、描述、
+标签、许可与维护者——「从远处找一份档案」因此只需要拉一个文件，不必先克隆一个仓库。
+
 ## 工具
 
 | 工具 | 作用 |
@@ -347,10 +369,11 @@ node bin/cli.mjs compile --roster examples-orchestration/rosters/core-review \
 团队状态目录与版本号也列在同一处。导入与新建档案挪到档案页签的搜索框右侧，刷新只属于档案源页签
 （绕过一小时的缓存，直接回源读公共索引）。
 
-客户端插件在左侧全局栏新增一行 **Agent Roster** 图标（`sidebar.panellist` 列表槽），并在 `main` 槽用同一个面板 id 注册整页内容；点图标即在主区域打开，宽度与对话页一致。面板分三个页签，不只是看：
+客户端插件在左侧全局栏新增一行 **Agent Roster** 图标（`sidebar.panellist` 列表槽），并在 `main` 槽用同一个面板 id 注册整页内容；点图标即在主区域打开，宽度与对话页一致。面板分五个页签，不只是看：
 
 | 页签 | 能做什么 |
 |---|---|
+| 档案库 | 按能力找档案：搜索（横跨本机与订阅来源，命中给出处）、标签筛选、按来源聚合或平铺，行内直接打开或拉取 |
 | 档案 | 浏览每个工作区 × 每座档案库，展开成员；**新建 / 编辑 / 复制 / 删除 / 导入 / 导出**档案。编辑器有表单与源码两种模式（源码就是文件原文）；写之前由宿主校验，覆盖已有文件会留一份 `.bak` |
 | 团队 | 读一个配置好的状态目录（默认 `.agent-teams`），列出运行时真正建出来的每个团队：档案、成员档案与模型路由、每个持久化成员是否真的与其档案一致，以及该团队的任务 |
 | 档案源 | 列出订阅的公共 registry 目录，每个 collection 一个「拉取到本机」按钮；可展开先看里面有哪些档案 |
@@ -463,7 +486,7 @@ test/             单测
 
 本机已验证：
 
-- `npm test` —— 300/300 通过（格式、解析、校验、扫描、路径、桥接、核对四桶、摘要与溯源、档案差异、能力要求与能力闸门、档案库组织、索引 schema、无损 JSON、写入计划与执行、六条路由、快照与提示、两本词典一致、工具契约、客户端加载器契约、包清单、配置视图、样式 token 约束、声明层字段与队长段、schema 与常量对齐、v2 角色/组装/编译三层及其 schema 对齐、v1→v2 迁移、执行回执并入施工图）。
+- `npm test` —— 308/308 通过（格式、解析、校验、扫描、路径、桥接、核对四桶、摘要与溯源、档案差异、能力要求与能力闸门、档案库组织、索引 schema、无损 JSON、写入计划与执行、六条路由、快照与提示、两本词典一致、工具契约、客户端加载器契约、包清单、配置视图、样式 token 约束、声明层字段与队长段、schema 与常量对齐、v2 角色/组装/编译三层及其 schema 对齐、v1→v2 迁移、执行回执并入施工图）。
 - `npm run smoke` —— 用真实 DSH bundle 的 `defineTool` 注册六个工具，逐个调用：输出全部通过无损校验、`path` 覆盖生效、释放干净；同一条命令随后用桩模块表加载 `client.js`，断言三处槽位注册、样式只注入一次、effect 可回收。
 - CLI：`validate --dir examples` 对两座示例库退出码 0。
 - 用插件管理器真的装进了本机 profile（`plugin_manager install_bundle` 指向本仓库 → `link:` 依赖 + bundle 条目），重启后按链接读取本仓库文件。

package/client.js

@@ -34,6 +34,8 @@ window.__ModuleLoader__.load({
     const INSTALL_ROUTE = "/plugins/dsh-agent-roster/install";
     const COLLECTION_ROUTE = "/plugins/dsh-agent-roster/collection";
     const APPLY_ROUTE = "/plugins/dsh-agent-roster/apply";
+    const SEARCH_ROUTE = "/plugins/dsh-agent-roster/search";
+    const CATALOG_ROUTE = "/plugins/dsh-agent-roster/catalog";
 
     const EFFORTS = ["low", "medium", "high", "default"];
     const LANGUAGES = ["auto", "zh", "en"];
@@ -1272,10 +1274,289 @@ window.__ModuleLoader__.load({
     // 面板本身拿不到 ctx：这里由 apply() 把宿主服务放进来，供设置弹窗使用。
     const HOST = { form: null, openPanel: null };
 
+
+    /**
+     * 档案库：像插件市场那样，把「能用的档案」全部摊在一张表里。
+     *
+     * 本机的与订阅来源的放在一起，因为人找的是能力，不是"这东西归谁管"。两种看法：
+     * 按来源聚合（知道自己订了什么）、平铺（只想横向比较）。两种都只是**视图**，
+     * 不改变数据，也不写回任何文件。
+     *
+     * 查询走后端排序（`/search`）：前端再写一套打分，两处迟早给出不同顺序。
+     * 标签筛选是「且」，与档案页签的标签池同一语义。
+     */
+    function CatalogTab({ onOpen, onPull }) {
+      useTranslation();
+      const [mode, setMode] = useState("source");
+      const [query, setQuery] = useState("");
+      const [selected, setSelected] = useState(() => new Set());
+      const [catalog, setCatalog] = useState({ status: "loading", entries: [], counts: null });
+      const [hits, setHits] = useState(null);
+      const [pulling, setPulling] = useState("");
+      const [nonce, setNonce] = useState(0);
+
+      useEffect(() => {
+        let alive = true;
+        setCatalog((current) => ({ ...current, status: "loading" }));
+        readJson(CATALOG_ROUTE)
+          .then((result) => {
+            if (!alive) return;
+            setCatalog({
+              status: result.ok ? "ready" : "error",
+              entries: result.body?.entries ?? [],
+              counts: result.body?.counts ?? null,
+            });
+          })
+          .catch(() => {
+            if (alive) setCatalog({ status: "error", entries: [], counts: null });
+          });
+        return () => {
+          alive = false;
+        };
+      }, [nonce]);
+
+      useEffect(() => {
+        const needle = query.trim();
+        if (needle.length < 2) {
+          setHits(null);
+          return;
+        }
+        const controller = new AbortController();
+        // 停止输入之后才问：每敲一个字打一次，等于自己给自己造并发。
+        const timer = setTimeout(() => {
+          setHits((current) => ({ status: "loading", matches: current?.matches ?? [] }));
+          readJson(`${SEARCH_ROUTE}?q=${encodeURIComponent(needle)}`, { signal: controller.signal })
+            .then((result) => {
+              if (controller.signal.aborted) return;
+              setHits({ status: result.ok ? "ready" : "error", matches: result.body?.matches ?? [] });
+            })
+            .catch(() => {
+              if (!controller.signal.aborted) setHits({ status: "error", matches: [] });
+            });
+        }, 240);
+        return () => {
+          clearTimeout(timer);
+          controller.abort();
+        };
+      }, [query]);
+
+      const pool = useMemo(() => {
+        const counts = new Map();
+        for (const entry of catalog.entries) {
+          for (const tag of entry.tags ?? []) counts.set(tag, (counts.get(tag) ?? 0) + 1);
+        }
+        return [...counts.entries()].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]));
+      }, [catalog.entries]);
+
+      const entries = hits !== null && hits.status === "ready" ? hits.matches : catalog.entries;
+      const filtered = useMemo(() => {
+        return entries.filter((entry) => {
+          for (const tag of selected) if (!(entry.tags ?? []).includes(tag)) return false;
+          return true;
+        });
+      }, [entries, selected]);
+
+      const groups = useMemo(() => {
+        if (mode === "flat") return [{ key: "flat", title: "", scope: "mixed", entries: filtered }];
+        const map = new Map();
+        for (const entry of filtered) {
+          const key = entry.scope === "local" ? "__local" : `c:${entry.collectionId ?? ""}`;
+          if (!map.has(key)) {
+            map.set(key, {
+              key,
+              scope: entry.scope,
+              title: entry.scope === "local" ? t("catalog.local") : entry.collectionTitle ?? entry.collectionId ?? "",
+              entries: [],
+            });
+          }
+          map.get(key).entries.push(entry);
+        }
+        return [...map.values()];
+      }, [filtered, mode]);
+
+      function toggleTag(tag) {
+        setSelected((current) => {
+          const next = new Set(current);
+          if (next.has(tag)) next.delete(tag);
+          else next.add(tag);
+          return next;
+        });
+      }
+
+      function why(entry) {
+        if (Array.isArray(entry.hits) && entry.hits.length > 0) {
+          return entry.hits.map((hit) => `${hit.label}：${hit.text}`).join(" · ");
+        }
+        if (Array.isArray(entry.memberRoles) && entry.memberRoles.length > 0) return entry.memberRoles.join(" · ");
+        return entry.description ?? "";
+      }
+
+      function row(entry) {
+        const busy = entry.scope === "remote" && pulling !== "";
+        return h(
+          "article",
+          { key: `${entry.scope}:${entry.collectionId ?? ""}:${entry.rosterId}`, className: "rstr-row" },
+          h(
+            "div",
+            { className: "rstr-row-body" },
+            h("code", { className: "rstr-row-id", title: entry.rosterId }, entry.rosterId),
+            h(
+              "div",
+              { className: "rstr-row-text" },
+              h("h3", { className: "rstr-row-title" }, entry.title === "" ? entry.rosterId : entry.title),
+              h("p", { className: "rstr-row-desc" }, why(entry)),
+            ),
+            h(
+              "div",
+              { className: "rstr-row-stats" },
+              h("span", { className: "rstr-stat" }, t("catalog.members", { count: String(entry.members ?? 0) })),
+              h(
+                "span",
+                { className: "rstr-stat" },
+                entry.scope === "local"
+                  ? t("catalog.local")
+                  : t("catalog.remoteFrom", { collection: entry.collectionTitle ?? entry.collectionId ?? "" }),
+              ),
+            ),
+            h(
+              "div",
+              { className: "rstr-row-actions" },
+              h(
+                "button",
+                {
+                  type: "button",
+                  className: "rstr-btn rstr-btn-sm",
+                  disabled: busy,
+                  onClick: async () => {
+                    if (entry.scope === "local") {
+                      onOpen(entry.rosterId);
+                      return;
+                    }
+                    setPulling(entry.collectionId ?? "");
+                    try {
+                      await onPull(entry.collectionId);
+                      setNonce((value) => value + 1);
+                    } finally {
+                      setPulling("");
+                    }
+                  },
+                },
+                entry.scope === "local" ? t("catalog.open") : t("catalog.pull"),
+              ),
+            ),
+          ),
+        );
+      }
+
+      return h(
+        "div",
+        { className: "rstr-catalog" },
+        h(
+          "div",
+          { className: "rstr-toolbar" },
+          h("input", {
+            className: "rstr-input rstr-search",
+            value: query,
+            placeholder: t("catalog.placeholder"),
+            "aria-label": t("catalog.placeholder"),
+            onChange: (event) => setQuery(event.target.value),
+            onKeyDown: (event) => {
+              if (event.key !== "Escape") return;
+              setQuery("");
+              event.stopPropagation();
+            },
+          }),
+          h(
+            "div",
+            { className: "rstr-toolbar-actions" },
+            h(
+              "div",
+              { className: "rstr-segmented", role: "group", "aria-label": t("catalog.mode") },
+              h(
+                "button",
+                {
+                  type: "button",
+                  className: `rstr-seg${mode === "source" ? " rstr-seg-on" : ""}`,
+                  "aria-pressed": mode === "source",
+                  onClick: () => setMode("source"),
+                },
+                t("catalog.modeSource"),
+              ),
+              h(
+                "button",
+                {
+                  type: "button",
+                  className: `rstr-seg${mode === "flat" ? " rstr-seg-on" : ""}`,
+                  "aria-pressed": mode === "flat",
+                  onClick: () => setMode("flat"),
+                },
+                t("catalog.modeFlat"),
+              ),
+            ),
+            h(
+              "button",
+              { type: "button", className: "rstr-btn rstr-btn-sm", onClick: () => setNonce((value) => value + 1) },
+              t("catalog.refresh"),
+            ),
+          ),
+        ),
+        pool.length === 0
+          ? null
+          : h(
+              "div",
+              { className: "rstr-catalog-tags" },
+              pool.map(([tag, count]) =>
+                h(
+                  "button",
+                  {
+                    key: tag,
+                    type: "button",
+                    className: `rstr-tag${selected.has(tag) ? " rstr-tag-on" : ""}`,
+                    "aria-pressed": selected.has(tag),
+                    onClick: () => toggleTag(tag),
+                  },
+                  h("span", { className: "rstr-tag-name" }, tag),
+                  h("span", { className: "rstr-tag-count" }, String(count)),
+                ),
+              ),
+            ),
+        h(
+          "p",
+          { className: "rstr-results-head" },
+          hits !== null && hits.status === "loading" && query.trim() !== ""
+            ? t("catalog.searching")
+            : t("catalog.counts", {
+                shown: String(filtered.length),
+                total: String(entries.length),
+                local: String(catalog.counts?.local ?? 0),
+                remote: String(catalog.counts?.remote ?? 0),
+              }),
+        ),
+        catalog.status === "error" ? h("p", { className: "rstr-muted" }, t("catalog.failed")) : null,
+        filtered.length === 0
+          ? h("p", { className: "rstr-muted" }, t("catalog.empty"))
+          : groups.map((group) =>
+              h(
+                "div",
+                { key: group.key, className: "rstr-group" },
+                mode === "flat" || group.title === ""
+                  ? null
+                  : h(
+                      "div",
+                      { className: "rstr-group-head" },
+                      h("span", { className: "rstr-group-title" }, group.title),
+                      h("span", { className: "rstr-group-count" }, String(group.entries.length)),
+                    ),
+                group.entries.map(row),
+              ),
+            ),
+      );
+    }
+
     function Panel() {
       useTranslation();
       const library = useLibrary();
-      const [tab, setTab] = useState("rosters");
+      const [tab, setTab] = useState("catalog");
       const [query, setQuery] = useState("");
       const [selectedTags, setSelectedTags] = useState(() => new Set());
       const [settingsOpen, setSettingsOpen] = useState(false);
@@ -1432,6 +1713,7 @@ window.__ModuleLoader__.load({
         "div",
         { className: "rstr-tabs", role: "tablist" },
         [
+          ["catalog", t("panel.tabsCatalog"), null],
           ["rosters", t("panel.tabsRosters"), rosters.length],
           ["teams", t("panel.tabsTeams"), teams.length],
           ["sources", t("panel.tabsSources"), snapshot?.remote?.collections?.length ?? 0],
@@ -1449,13 +1731,44 @@ window.__ModuleLoader__.load({
               onClick: () => setTab(value),
             },
             label,
-            h("span", { className: "rstr-tab-count" }, String(count)),
+            count === null ? null : h("span", { className: "rstr-tab-count" }, String(count)),
           ),
         ),
       );
 
       let content = null;
 
+      if (tab === "catalog") {
+        content = h(CatalogTab, {
+          onOpen: (rosterId) => {
+            setTab("rosters");
+            setQuery(rosterId);
+          },
+          onPull: async (collectionId) => {
+            try {
+              const result = await readJson(INSTALL_ROUTE, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({ collection: collectionId }),
+              });
+              if (!result.ok || result.body === null) {
+                setToast(`${t("misc.failed")} (${String(result.status)})`);
+                return;
+              }
+              const summary = t("source.pulled", {
+                written: result.body.written ?? 0,
+                unchanged: result.body.unchanged ?? 0,
+                conflicts: result.body.conflicts ?? 0,
+              });
+              setToast(summary);
+              library.reload();
+            } catch {
+              setToast(t("misc.failed"));
+            }
+          },
+        });
+      }
+
       if (tab === "rosters") {
         if (rosters.length === 0) {
           // 空状态与列表共享同一条左沿：页面本身 padding 为 0，留白由各页签自己给。
@@ -2347,6 +2660,40 @@ window.__ModuleLoader__.load({
 
 /* ---- 账本（行） ------------------------------------------------------- */
 
+.rstr-catalog { display: flex; flex-direction: column; gap: 10px; padding: 16px 28px 28px; min-width: 0; }
+
+/* 标签池横着排：档案库是"逛"的地方，不该为了几个标签先把屏幕切成两栏。 */
+.rstr-catalog-tags { display: flex; flex-wrap: wrap; gap: 6px; min-width: 0; }
+/* 标签池在侧栏里是"一列可选的筛选项"，但放进档案库的顶部它就是一枚筛选标签：
+   宽度、边框、圆角都得按标签给，不能沿用侧栏那套整行铺满的形态。 */
+.rstr-catalog-tags .rstr-tag {
+  width: auto;
+  flex: 0 0 auto;
+  gap: 6px;
+  padding: 3px 10px;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 999px;
+  background: var(--dsw-alias-bg-layer-1);
+}
+.rstr-catalog-tags .rstr-tag-on {
+  border-color: color-mix(in srgb, var(--dsw-alias-state-business-primary) 55%, var(--dsw-alias-border-l2));
+  background: color-mix(in srgb, var(--dsw-alias-state-business-primary) 10%, transparent);
+  color: var(--dsw-alias-label-primary);
+}
+.rstr-catalog .rstr-search { max-width: 560px; }
+
+.rstr-group { display: flex; flex-direction: column; min-width: 0; }
+
+.rstr-group-head { display: flex; align-items: baseline; gap: 8px; padding: 10px 0 4px; border-bottom: 1px solid var(--dsw-alias-border-l2); }
+
+.rstr-group-title { font-size: 12px; font-weight: 600; letter-spacing: 0.02em; color: var(--dsw-alias-label-secondary); }
+
+.rstr-group-count { font-size: 11px; color: var(--dsw-alias-label-tertiary); font-variant-numeric: tabular-nums; }
+
+.rstr-results { display: flex; flex-direction: column; min-width: 0; padding: 0 28px 28px; border-top: 1px solid var(--dsw-alias-border-l2); }
+
+.rstr-results-head { margin: 12px 0 4px; font-size: 12px; color: var(--dsw-alias-label-secondary); }
+
 .rstr-cards { display: flex; flex-direction: column; min-width: 0; border-top: 1px solid var(--dsw-alias-border-l2); }
 
 .rstr-row {
@@ -2662,7 +3009,7 @@ window.__ModuleLoader__.load({
 /* ---- 窄面板 ----------------------------------------------------------- */
 
 @media (max-width: 860px) {
-  .rstr-head, .rstr-tabs, .rstr-rosters-main, .rstr-health, .rstr-foot { padding-left: 18px; padding-right: 18px; }
+  .rstr-head, .rstr-tabs, .rstr-rosters-main, .rstr-health, .rstr-catalog, .rstr-foot { padding-left: 18px; padding-right: 18px; }
   .rstr-banner { margin-left: 18px; margin-right: 18px; }
   .rstr-rosters { grid-template-columns: minmax(0, 1fr); }
   .rstr-tagpool {

package/examples/dist/core-review-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "core-review",
     "version": "1.0.0",
     "title": "代码审查小组",
+    "description": "一名队长加两名审查者：一人盯正确性，一人盯可维护性与边界条件。",
+    "tags": [
+      "review",
+      "example"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "STofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/examples/dist/research-0.1.0.json

@@ -4,6 +4,13 @@
     "roster": "research",
     "version": "0.1.0",
     "title": "外部调研小组",
+    "description": "一手资料收集 + 交叉复核；复核者的结论必须能被另一条独立来源支撑。",
+    "tags": [
+      "research",
+      "example"
+    ],
+    "license": null,
+    "maintainers": [],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,

package/examples-orchestration/dist/core-review-1.0.0.json

@@ -4,6 +4,15 @@
     "roster": "core-review",
     "version": "1.0.0",
     "title": "核心评审组",
+    "description": "一个小团队：队长拆任务，评审把关，修复收尾。用来演示 v2 的引用式成员与声明式编排。",
+    "tags": [
+      "review",
+      "example"
+    ],
+    "license": "MIT",
+    "maintainers": [
+      "stofone"
+    ],
     "repo": "dsh-agent-roster/dsh-agent-roster",
     "ref": "main",
     "lock": null,