dsh-brief-sidebar 0.9.1 → 0.9.2

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-external/dsh-brief-sidebar",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "main": "./lib/index.mjs",
   "description": "会话简报侧栏页（brief）：把会话的 todo 列表（`todos` 投影的进展看板）、产物列表（`dshSummaryDeliverables` 投影的实时产出文件）与记忆槽位（`memorySlots` 投影，来自 dsh-prime-memory，开关可关）一起渲染成右侧栏的一个「概要」tab，并遮蔽 DSH 官方那条 composer 上方的 todo 面板。只读展示，不做写回。",
   "engines": {

package/lib/client.js

@@ -689,10 +689,13 @@ window.__ModuleLoader__.load({
 				"recall.noBody": "（本帧没有这条记忆的全文）",
 				"section.skillUsage": "技能引用",
 				"skillUsage.empty": "本会话还没载入过技能",
-				"skillUsage.emptyHint": "模型用 skill 工具载入技能后，技能名会实时出现在这里。",
+				"skillUsage.emptyHint": "模型用 skill 工具载入、或你直接点用某个技能后，技能名会实时出现在这里。",
 				"skillUsage.uses": "{count} 次",
 				"skillUsage.count": "载入 {count} 次 · {total} 个技能",
 				"skillUsage.latestTag": "本轮",
+				"skillUsage.invokedGroup": "已引用 · {count}",
+				"skillUsage.availableGroup": "本会话可用 · {count}",
+				"skillUsage.availableCapped": "（可用清单共 {count} 条，列表已截断）",
 				"settings.title": "概要侧栏",
 				"settings.desc": "右侧栏概要 tab 的分区开关（只读展示）。",
 				"settings.memorySlots": "记忆槽位分区",
@@ -746,10 +749,13 @@ window.__ModuleLoader__.load({
 				"recall.noBody": "(this frame carries no full body for this record)",
 				"section.skillUsage": "Skill references",
 				"skillUsage.empty": "No skills loaded in this session",
-				"skillUsage.emptyHint": "Skills appear here as soon as the model loads one with the skill tool.",
+				"skillUsage.emptyHint": "Skills show up here once the model loads one with the `skill` tool, or you invoke one directly.",
 				"skillUsage.uses": "{count}x",
 				"skillUsage.count": "{count} loads - {total} skills",
 				"skillUsage.latestTag": "this turn",
+				"skillUsage.invokedGroup": "Referenced · {count}",
+				"skillUsage.availableGroup": "Available this session · {count}",
+				"skillUsage.availableCapped": "({count} skills in the catalog; the list is capped)",
 				"settings.title": "Brief sidebar",
 				"settings.desc": "Section switches for the summary tab in the right sidebar (read-only views).",
 				"settings.memorySlots": "Memory slots section",
@@ -803,10 +809,13 @@ window.__ModuleLoader__.load({
 				"recall.noBody": "このフレームには全文が含まれていない",
 				"section.skillUsage": "スキル参照",
 				"skillUsage.empty": "このセッションではスキルを読み込んでいません",
-				"skillUsage.emptyHint": "モデルが skill ツールでスキルを読み込むと、ここにリアルタイムで表示されます。",
+				"skillUsage.emptyHint": "モデルが skill ツールで読み込むか、あなたがスキルを直接起動すると、ここにリアルタイムで表示されます。",
 				"skillUsage.uses": "{count} 回",
 				"skillUsage.count": "読み込み {count} 回 · スキル {total} 件",
 				"skillUsage.latestTag": "このターン",
+				"skillUsage.invokedGroup": "参照済み · {count}",
+				"skillUsage.availableGroup": "このセッションで利用可能 · {count}",
+				"skillUsage.availableCapped": "（カタログは全 {count} 件、一覧は上限で省略）",
 				"settings.title": "概要サイドバー",
 				"settings.desc": "右サイドバー概要タブのセクション表示切り替え（読み取り専用）。",
 				"settings.memorySlots": "メモリスロットセクション",
@@ -860,10 +869,13 @@ window.__ModuleLoader__.load({
 				"recall.noBody": "이 프레임에는 이 기록의 전문이 없습니다",
 				"section.skillUsage": "스킬 참조",
 				"skillUsage.empty": "이 세션에서 스킬을 불러오지 않았습니다",
-				"skillUsage.emptyHint": "모델이 skill 도구로 스킬을 불러오면 여기에 즉시 표시됩니다.",
+				"skillUsage.emptyHint": "모델이 skill 도구로 불러오거나 당신이 스킬을 직접 실행하면 여기에 실시간으로 나타납니다.",
 				"skillUsage.uses": "{count}회",
 				"skillUsage.count": "불러오기 {count}회 · 스킬 {total}개",
 				"skillUsage.latestTag": "이 턴",
+				"skillUsage.invokedGroup": "참조됨 · {count}",
+				"skillUsage.availableGroup": "이 세션에서 사용 가능 · {count}",
+				"skillUsage.availableCapped": "(카탈로그 전체 {count}개, 목록은 잘림)",
 				"settings.title": "요약 사이드바",
 				"settings.desc": "오른쪽 사이드바 요약 탭의 섹션 표시 전환(읽기 전용).",
 				"settings.memorySlots": "메모리 슬롯 섹션",
@@ -917,10 +929,13 @@ window.__ModuleLoader__.load({
 				"recall.noBody": "(aucun texte complet pour cette entrée dans cette trame)",
 				"section.skillUsage": "Références de compétences",
 				"skillUsage.empty": "Aucune compétence chargée dans cette session",
-				"skillUsage.emptyHint": "Les compétences apparaissent ici dès que le modèle en charge une avec l’outil skill.",
+				"skillUsage.emptyHint": "Les compétences apparaissent ici dès que le modèle en charge une via l’outil `skill`, ou quand vous en lancez une directement.",
 				"skillUsage.uses": "{count}×",
 				"skillUsage.count": "{count} chargements · {total} compétences",
 				"skillUsage.latestTag": "ce tour",
+				"skillUsage.invokedGroup": "Référencées · {count}",
+				"skillUsage.availableGroup": "Disponibles dans cette session · {count}",
+				"skillUsage.availableCapped": "({count} compétences au catalogue ; la liste est tronquée)",
 				"settings.title": "Barre latérale Résumé",
 				"settings.desc": "Interrupteurs des sections de l’onglet Résumé de la barre latérale (lecture seule).",
 				"settings.memorySlots": "Section des emplacements mémoire",
@@ -974,10 +989,13 @@ window.__ModuleLoader__.load({
 				"recall.noBody": "(dieser Rahmen enthält keinen vollständigen Text für diesen Eintrag)",
 				"section.skillUsage": "Skill-Referenzen",
 				"skillUsage.empty": "In dieser Sitzung wurden keine Skills geladen",
-				"skillUsage.emptyHint": "Skills erscheinen hier, sobald das Modell einen über das skill-Werkzeug lädt.",
+				"skillUsage.emptyHint": "Skills erscheinen hier, sobald das Modell einen über das `skill`-Tool lädt oder du einen direkt aufrufst.",
 				"skillUsage.uses": "{count}x",
 				"skillUsage.count": "{count} Ladungen · {total} Skills",
 				"skillUsage.latestTag": "diese Runde",
+				"skillUsage.invokedGroup": "Referenziert · {count}",
+				"skillUsage.availableGroup": "In dieser Sitzung verfügbar · {count}",
+				"skillUsage.availableCapped": "({count} Skills im Katalog; die Liste ist gekürzt)",
 				"settings.title": "Übersicht-Seitenleiste",
 				"settings.desc": "Schalter für die Abschnitte des Übersicht-Tabs in der rechten Seitenleiste (schreibgeschützt).",
 				"settings.memorySlots": "Speicherplätze-Abschnitt",
@@ -1031,10 +1049,13 @@ window.__ModuleLoader__.load({
 				"recall.noBody": "(questo frame non contiene il testo completo di questa voce)",
 				"section.skillUsage": "Riferimenti alle skill",
 				"skillUsage.empty": "Nessuna skill caricata in questa sessione",
-				"skillUsage.emptyHint": "Le skill compaiono qui quando il modello ne carica una con il tool skill.",
+				"skillUsage.emptyHint": "Le skill compaiono qui quando il modello ne carica una con il tool `skill` o quando ne avvii una direttamente.",
 				"skillUsage.uses": "{count}x",
 				"skillUsage.count": "{count} caricamenti · {total} skill",
 				"skillUsage.latestTag": "questo giro",
+				"skillUsage.invokedGroup": "Referenziate · {count}",
+				"skillUsage.availableGroup": "Disponibili in questa sessione · {count}",
+				"skillUsage.availableCapped": "({count} skill nel catalogo; l’elenco è troncato)",
 				"settings.title": "Barra laterale Riepilogo",
 				"settings.desc": "Interruttori delle sezioni della scheda Riepilogo nella barra laterale destra (sola lettura).",
 				"settings.memorySlots": "Sezione slot di memoria",
@@ -1088,10 +1109,13 @@ window.__ModuleLoader__.load({
 				"recall.noBody": "В этом кадре нет полного текста этой записи",
 				"section.skillUsage": "Отсылки к скиллам",
 				"skillUsage.empty": "В этой сессии скиллы не загружались",
-				"skillUsage.emptyHint": "Скиллы появятся здесь, как только модель загрузит их через инструмент skill.",
+				"skillUsage.emptyHint": "Навыки появятся здесь, когда модель загрузит их через инструмент `skill` или вы вызовете навык напрямую.",
 				"skillUsage.uses": "{count} раз",
 				"skillUsage.count": "Загрузок: {count} · скиллов: {total}",
 				"skillUsage.latestTag": "этот ход",
+				"skillUsage.invokedGroup": "Использованы · {count}",
+				"skillUsage.availableGroup": "Доступны в этой сессии · {count}",
+				"skillUsage.availableCapped": "({count} навыков в каталоге; список усечён)",
 				"settings.title": "Боковая панель «Сводка»",
 				"settings.desc": "Переключатели разделов вкладки «Сводка» на правой панели (только чтение).",
 				"settings.memorySlots": "Раздел слотов памяти",
@@ -1145,10 +1169,13 @@ window.__ModuleLoader__.load({
 				"recall.noBody": "(este fotograma no trae el texto completo de este registro)",
 				"section.skillUsage": "Referencias de skills",
 				"skillUsage.empty": "Esta sesión no ha cargado ningún skill",
-				"skillUsage.emptyHint": "Los skills aparecerán aquí en cuanto el modelo cargue uno con la herramienta skill.",
+				"skillUsage.emptyHint": "Las skills aparecen aquí cuando el modelo carga una con la herramienta `skill` o cuando invocas una directamente.",
 				"skillUsage.uses": "{count}x",
 				"skillUsage.count": "{count} cargas · {total} skills",
 				"skillUsage.latestTag": "este turno",
+				"skillUsage.invokedGroup": "Referenciadas · {count}",
+				"skillUsage.availableGroup": "Disponibles en esta sesión · {count}",
+				"skillUsage.availableCapped": "({count} skills en el catálogo; la lista está truncada)",
 				"settings.title": "Barra lateral Resumen",
 				"settings.desc": "Interruptores de las secciones de la pestaña Resumen en la barra lateral derecha (solo lectura).",
 				"settings.memorySlots": "Sección de ranuras de memoria",
@@ -1362,6 +1389,18 @@ window.__ModuleLoader__.load({
 			};
 		}
 		/**
+		* The available-skill list of a frame, or `[]` when the frame carries none.
+		*
+		* Absent-by-age is the important case: a host half older than this reader
+		* publishes no `available` field at all, and that must NOT void the whole view
+		* — the session's references are still true. Only a drifted (non-array) value
+		* reads as "nothing known", never as "nothing available".
+		*/
+		function readAvailable(value) {
+			if (!Array.isArray(value)) return [];
+			return value.filter((n) => typeof n === "string" && n.length > 0);
+		}
+		/**
 		* Narrow a raw projection value into a skill-usage view.
 		*
 		* @param value - the raw `unknown` snapshot of the `dshSummarySkillUsage` face.
@@ -1377,14 +1416,33 @@ window.__ModuleLoader__.load({
 				const narrowed = readEntry(entry);
 				if (narrowed !== void 0) session.push(narrowed);
 			}
+			const available = readAvailable(raw["available"]);
+			const availableCount = available.length === 0 ? 0 : isCounter$2(raw["availableCount"]) ? raw["availableCount"] : available.length;
 			return {
 				latest: readLatest(raw["latest"]),
 				session,
 				sessionTotal: raw["sessionTotal"],
-				callTotal: raw["callTotal"]
+				callTotal: raw["callTotal"],
+				available,
+				availableCount
 			};
 		}
 		/**
+		* The available list minus the names already shown as referenced.
+		*
+		* One skill must not occupy a row in both groups: the reference row is the
+		* stronger fact, and a duplicate under "available" would read as "the model
+		* had a choice it didn't make".
+		*
+		* @param available - the session's current catalog names, in catalog order.
+		* @param referenced - names the fold counted as loaded or invoked.
+		* @returns the remaining catalog names, order preserved.
+		*/
+		function availableExcept(available, referenced) {
+			const seen = new Set(referenced);
+			return available.filter((name) => !seen.has(name));
+		}
+		/**
 		* Fill both placeholders of a template. `expandCount` only speaks `{count}`, and
 		* this section's footer carries a second number on purpose: the capped list
 		* needs the truthful distinct total next to the load count.
@@ -1404,15 +1462,23 @@ window.__ModuleLoader__.load({
 		* part of the summary tab.
 		*
 		* Where `MemoryRecallSection` answers "what memories did the model see", this
-		* answers "which instruction packs did it pull" — the skills this session
-		* loaded through the host's `skill` tool, with how often and when.
+		* answers "which instruction packs entered the context, and which ones were on
+		* the menu". Two groups, deliberately not merged:
+		*
+		* - **已引用** — the skill's instructions reached the conversation, either
+		*   because the model called the `skill` tool or because the user invoked it
+		*   directly (the host then injects `<skill_content>` and tells the model not
+		*   to call the tool — reading only the tool would miss over half of those
+		*   sessions, measured on 250 real ones).
+		* - **本会话可用** — the session's current catalog. Available is NOT used: the
+		*   model may never touch any of these, so it is collapsed behind a counted
+		*   toggle and never mixed into the reference rows.
 		*
 		* Like the deliverables section this is an OPTIONAL capability on both sides:
 		* no projection registry (or a host half that never registered the unit) means
 		* the client reads capability absence and the section hides. No settings switch
 		* gates it either — the list is a read-only fact about the session, not a
-		* preference, and a section that only ever shows what already happened costs
-		* nothing to leave on.
+		* preference.
 		*
 		* Two contracts this row honours, both learned on the recall section:
 		* - **no native `title` attribute** — it paints an unskinable tooltip that
@@ -1487,24 +1553,40 @@ window.__ModuleLoader__.load({
 		*/
 		function SkillUsageSection(props) {
 			const { t, ctx, scope } = props;
+			const [availableOpen, setAvailableOpen] = (0, react.useState)(false);
 			const view = readSkillUsage(useProjectionValue(ctx, scope?.sessionId, SKILL_USAGE_KEY));
 			if (view === void 0) return null;
-			if (view.session.length === 0) return (0, react.createElement)("div", {
-				style: SECTION_STYLE$2,
-				"data-dsh-brief-sidebar": "skill-usage-section"
-			}, (0, react.createElement)("div", { style: HEADER_STYLE$3 }, t("section.skillUsage")), (0, react.createElement)("div", { style: EMPTY_STYLE$2 }, (0, react.createElement)("div", { style: {
-				marginBottom: 6,
-				color: "var(--dsw-alias-label-secondary)"
-			} }, t("skillUsage.empty")), (0, react.createElement)("div", null, t("skillUsage.emptyHint"))));
+			const referenced = view.session.map((entry) => entry.name);
+			const rest = availableExcept(view.available, referenced);
 			const latestNames = view.latest?.names ?? [];
 			return (0, react.createElement)("div", {
 				style: SECTION_STYLE$2,
 				"data-dsh-brief-sidebar": "skill-usage-section"
-			}, (0, react.createElement)("div", { style: HEADER_STYLE$3 }, t("section.skillUsage")), (0, react.createElement)("ul", { style: LIST_STYLE$2 }, view.session.map((entry) => (0, react.createElement)("li", {
+			}, (0, react.createElement)("div", { style: HEADER_STYLE$3 }, t("section.skillUsage")), view.session.length === 0 && (0, react.createElement)("div", { style: EMPTY_STYLE$2 }, (0, react.createElement)("div", { style: {
+				marginBottom: 6,
+				color: "var(--dsw-alias-label-secondary)"
+			} }, t("skillUsage.empty")), (0, react.createElement)("div", null, t("skillUsage.emptyHint"))), view.session.length > 0 && (0, react.createElement)(GroupHeader, {
+				text: expandCount(t("skillUsage.invokedGroup"), view.session.length),
+				marker: "skill-usage-invoked-group"
+			}), (0, react.createElement)("ul", { style: LIST_STYLE$2 }, view.session.map((entry) => (0, react.createElement)("li", {
 				key: entry.name,
 				style: ROW_STYLE$3,
 				"data-dsh-brief-sidebar": "skill-usage-row"
-			}, (0, react.createElement)("span", { style: NAME_STYLE$1 }, entry.name), (0, react.createElement)("span", { style: COUNT_STYLE }, expandPair(t("skillUsage.uses"), entry.count, entry.count)), latestNames.includes(entry.name) && (0, react.createElement)("span", { style: TAG_STYLE }, t("skillUsage.latestTag"))))), (0, react.createElement)("div", { style: FOOTER_STYLE$2 }, expandPair(t("skillUsage.count"), view.callTotal, view.sessionTotal)));
+			}, (0, react.createElement)("span", { style: NAME_STYLE$1 }, entry.name), (0, react.createElement)("span", { style: COUNT_STYLE }, expandPair(t("skillUsage.uses"), entry.count, entry.count)), latestNames.includes(entry.name) && (0, react.createElement)("span", { style: TAG_STYLE }, t("skillUsage.latestTag"))))), rest.length > 0 && (0, react.createElement)(FoldToggle, {
+				label: expandCount(t("skillUsage.availableGroup"), rest.length),
+				open: availableOpen,
+				marker: "skill-usage-available-toggle",
+				onToggle: () => {
+					setAvailableOpen((current) => !current);
+				}
+			}), rest.length > 0 && view.availableCount > view.available.length && (0, react.createElement)(GroupCaption, {
+				text: expandCount(t("skillUsage.availableCapped"), view.availableCount),
+				marker: "skill-usage-available-capped"
+			}), availableOpen && (0, react.createElement)("ul", { style: LIST_STYLE$2 }, rest.map((name) => (0, react.createElement)("li", {
+				key: name,
+				style: ROW_STYLE$3,
+				"data-dsh-brief-sidebar": "skill-usage-available-row"
+			}, (0, react.createElement)("span", { style: NAME_STYLE$1 }, name)))), view.session.length > 0 && (0, react.createElement)("div", { style: FOOTER_STYLE$2 }, expandPair(t("skillUsage.count"), view.callTotal, view.sessionTotal)));
 		}
 		//#endregion
 		//#region src/client/summary/memory-slots.ts