dsh-skill-hub 0.2.2 → 0.2.5

package/lib/index.js

@@ -53,27 +53,39 @@ const HUB_CONFIG_DEFAULTS = {
 	announceToAgent: true,
 	showUseCount: true,
 	showUseTime: true,
-	showGroupSummary: true
+	showGroupSummary: true,
+	statsWindowDays: 14,
+	statsScanMinutes: 5
 };
 /**
 * Resolve the effective hub config: saved sidecar overrides win over the
 * cordis composition entry (the web card owns runtime config), missing
 * booleans fall back to HUB_CONFIG_DEFAULTS, and dot colors pass through
-* (saved first, then base) only when set.
+* (saved first, then base) only when set. Numeric stats knobs are clamped to
+* their sane ranges (window ≥ 0, scan interval ≥ 1 minute).
 */
 function resolveHubConfig(saved, base = {}) {
 	const dotModelColor = saved.dotModelColor !== void 0 ? saved.dotModelColor : base.dotModelColor;
 	const dotUserColor = saved.dotUserColor !== void 0 ? saved.dotUserColor : base.dotUserColor;
+	const windowDays = clampNumber(saved.statsWindowDays ?? base.statsWindowDays, 0) ?? HUB_CONFIG_DEFAULTS.statsWindowDays;
+	const scanMinutes = clampNumber(saved.statsScanMinutes ?? base.statsScanMinutes, 1) ?? HUB_CONFIG_DEFAULTS.statsScanMinutes;
 	return {
 		enabled: saved.enabled ?? base.enabled ?? HUB_CONFIG_DEFAULTS.enabled,
 		announceToAgent: saved.announceToAgent ?? base.announceToAgent ?? HUB_CONFIG_DEFAULTS.announceToAgent,
 		showUseCount: saved.showUseCount ?? base.showUseCount ?? HUB_CONFIG_DEFAULTS.showUseCount,
 		showUseTime: saved.showUseTime ?? base.showUseTime ?? HUB_CONFIG_DEFAULTS.showUseTime,
 		showGroupSummary: saved.showGroupSummary ?? base.showGroupSummary ?? HUB_CONFIG_DEFAULTS.showGroupSummary,
+		statsWindowDays: windowDays,
+		statsScanMinutes: scanMinutes,
 		...dotModelColor !== void 0 ? { dotModelColor } : {},
 		...dotUserColor !== void 0 ? { dotUserColor } : {}
 	};
 }
+/** Clamp a numeric override into a valid value; undefined/invalid stays undefined. */
+function clampNumber(value, min) {
+	if (typeof value !== "number" || !Number.isFinite(value) || value < min) return void 0;
+	return Math.floor(value);
+}
 /** HEX color validation shared by host routes and the settings card. */
 const HEX_COLOR_RE = /^#[0-9a-f]{6}$/i;
 //#endregion
@@ -129,7 +141,7 @@ function migrateStore(parsed) {
 	if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return null;
 	const record = parsed;
 	const version = typeof record.version === "number" ? record.version : 0;
-	if (version > 3) return null;
+	if (version > 4) return null;
 	const disabled = Array.isArray(record.disabled) ? record.disabled : [];
 	const config = typeof record.config === "object" && record.config !== null && !Array.isArray(record.config) ? record.config : void 0;
 	const tags = Array.isArray(record.tags) ? record.tags : void 0;
@@ -153,13 +165,14 @@ function migrateStore(parsed) {
 		}));
 	}
 	return {
-		version: 3,
+		version: 4,
 		disabled,
 		...config !== void 0 ? { config } : {},
 		...tags !== void 0 ? { tags } : {},
 		...sources !== void 0 ? { sources } : {},
 		...marketSources !== void 0 ? { marketSources } : {},
-		...trash !== void 0 ? { trash } : {}
+		...trash !== void 0 ? { trash } : {},
+		...record.skillStats !== void 0 ? { skillStats: record.skillStats } : {}
 	};
 }
 /** Sidecar state owner. */
@@ -171,6 +184,7 @@ var SkillHubStore = class {
 	sourcesByRepo = /* @__PURE__ */ new Map();
 	marketSources = [];
 	trashByName = /* @__PURE__ */ new Map();
+	skillStats = void 0;
 	loaded = false;
 	/** Serializes persist runs: concurrent mutators must not let an earlier
 	*  snapshot overwrite a later one (rename is atomic, ordering is not). */
@@ -250,6 +264,28 @@ var SkillHubStore = class {
 						});
 					}
 				}
+				const savedStats = migrated.skillStats;
+				if (savedStats !== null && typeof savedStats === "object" && typeof savedStats.frozenBefore === "number" && typeof savedStats.lastFullReconcile === "number" && typeof savedStats.windowDays === "number" && typeof savedStats.frozenSessions === "object" && savedStats.frozenSessions !== null) {
+					const sessions = {};
+					for (const [id, entry] of Object.entries(savedStats.frozenSessions)) {
+						if (entry === null || typeof entry !== "object" || typeof entry.createdAt !== "number" || typeof entry.counts !== "object" || entry.counts === null) continue;
+						const counts = {};
+						for (const [name, stat] of Object.entries(entry.counts)) if (stat !== null && typeof stat === "object" && typeof stat.count === "number" && typeof stat.lastUsed === "number") counts[name] = {
+							count: stat.count,
+							lastUsed: stat.lastUsed
+						};
+						sessions[id] = {
+							createdAt: entry.createdAt,
+							counts
+						};
+					}
+					this.skillStats = {
+						windowDays: savedStats.windowDays,
+						frozenBefore: savedStats.frozenBefore,
+						frozenSessions: sessions,
+						lastFullReconcile: savedStats.lastFullReconcile
+					};
+				}
 			}
 		} catch (error) {
 			if (error.code !== "ENOENT") console.warn("[dsh-skill-hub] sidecar state unreadable, starting empty:", error instanceof Error ? error.message : error);
@@ -594,16 +630,36 @@ var SkillHubStore = class {
 		if (!this.trashByName.delete(name)) return;
 		await this.persist();
 	}
+	/** The persisted usage-statistics checkpoint (undefined until first saved). */
+	async getSkillStatsState() {
+		await this.ensureLoaded();
+		return this.skillStats !== void 0 ? {
+			...this.skillStats,
+			frozenSessions: { ...this.skillStats.frozenSessions }
+		} : void 0;
+	}
+	/** Persist a usage-statistics checkpoint (written at most ~once a day, on full reconciliations). */
+	async saveSkillStatsState(state) {
+		await this.ensureLoaded();
+		this.skillStats = {
+			windowDays: state.windowDays,
+			frozenBefore: state.frozenBefore,
+			frozenSessions: { ...state.frozenSessions },
+			lastFullReconcile: state.lastFullReconcile
+		};
+		await this.persist();
+	}
 	persist() {
 		const run = this.writeChain.then(async () => {
 			const payload = {
-				version: 3,
+				version: 4,
 				disabled: [...this.entries.values()],
 				config: this.config,
 				...this.tagsById.size > 0 ? { tags: [...this.tagsById.values()] } : {},
 				...this.sourcesByRepo.size > 0 ? { sources: [...this.sourcesByRepo.values()] } : {},
 				...this.marketSources.length > 0 ? { marketSources: [...this.marketSources] } : {},
-				...this.trashByName.size > 0 ? { trash: [...this.trashByName.values()] } : {}
+				...this.trashByName.size > 0 ? { trash: [...this.trashByName.values()] } : {},
+				...this.skillStats !== void 0 ? { skillStats: this.skillStats } : {}
 			};
 			const tmp = this.file + ".tmp";
 			await mkdir(dirname(this.file), { recursive: true });
@@ -1904,6 +1960,7 @@ async function buildCatalog(deps, cwd) {
 	const diagnostics = [...await scanDiagnostics("user-dsh", home), ...await scanDiagnostics("user-agents", home)];
 	return {
 		ok: true,
+		pluginVersion: CURRENT_VERSION,
 		complete,
 		skills,
 		disabled,
@@ -3011,6 +3068,9 @@ function makeRoutes(deps) {
 }
 //#endregion
 //#region src/stats.ts
+/** Fallback freeze horizon when no rolling window is configured (14 days). */
+const STATS_FREEZE_AFTER_MS = 336 * 60 * 60 * 1e3;
+const DAY_MS = 1440 * 60 * 1e3;
 /** Collect per-skill invocation counts and last-used times from one session. */
 function countSkillInvocations(events) {
 	const stats = /* @__PURE__ */ new Map();
@@ -3041,31 +3101,100 @@ function countSkillInvocations(events) {
 	}
 	return stats;
 }
-/** Scan every session and total per-skill counts, keeping the latest lastUsed. */
-async function readSkillStats(query) {
-	const totals = /* @__PURE__ */ new Map();
+function isFrozen(record, watermark) {
+	const created = record.header.createdAt;
+	return typeof created === "number" && created > 0 && created < watermark;
+}
+function mergeInto(totals, counted) {
+	for (const [name, stat] of counted) {
+		const total = totals[name];
+		if (total === void 0) totals[name] = { ...stat };
+		else {
+			total.count += stat.count;
+			if (stat.lastUsed > total.lastUsed) total.lastUsed = stat.lastUsed;
+		}
+	}
+}
+function toSorted(totals) {
+	return Object.entries(totals).map(([name, stat]) => ({
+		name,
+		count: stat.count,
+		lastUsed: stat.lastUsed
+	})).sort((x, y) => x.name.localeCompare(y.name));
+}
+/** Effective freeze watermark for the configured rolling window (0 = all history → freeze horizon). */
+function watermarkFor(windowDays, nowMs) {
+	return windowDays > 0 ? nowMs - windowDays * DAY_MS : nowMs - STATS_FREEZE_AFTER_MS;
+}
+/**
+* Whether a session's usage counts toward the configured window. With no
+* window (0) everything counts — full history; with a window, only sessions
+* created inside it do. Distinct from the freeze watermark, which is purely a
+* re-read optimization.
+*/
+function inWindow(createdAt, windowDays, nowMs) {
+	if (windowDays <= 0) return true;
+	return typeof createdAt === "number" && createdAt > 0 && createdAt >= nowMs - windowDays * DAY_MS;
+}
+/**
+* One pass over the corpus. Runs either a full reconciliation (rebuilds the
+* per-session cache and advances the watermark — mutates the checkpoint) or a
+* cheap incremental scan (re-reads everything at or after the watermark and
+* merges over the cached sessions — leaves the checkpoint untouched). Totals
+* always apply the CURRENT window filter over the cached sessions, so a
+* window shrink takes effect immediately even before the next reconciliation.
+*/
+async function scan(query, checkpoint, nowMs, windowDays) {
 	const sessions = await query.listSessions();
+	const cutoff = watermarkFor(windowDays, nowMs);
+	if (nowMs - checkpoint.lastFullReconcile >= 864e5 || checkpoint.windowDays !== windowDays) {
+		const cache = {};
+		const totals = {};
+		for (const record of sessions) {
+			let counted;
+			try {
+				counted = countSkillInvocations((await query.readSession(record.header.id)).events);
+			} catch {
+				continue;
+			}
+			const created = record.header.createdAt;
+			if (isFrozen(record, cutoff) && counted.size > 0 && typeof created === "number") cache[record.header.id] = {
+				createdAt: created,
+				counts: Object.fromEntries(counted)
+			};
+			if (inWindow(created, windowDays, nowMs)) mergeInto(totals, counted);
+		}
+		checkpoint.frozenSessions = cache;
+		checkpoint.frozenBefore = cutoff;
+		checkpoint.windowDays = windowDays;
+		checkpoint.lastFullReconcile = nowMs;
+		return {
+			stats: toSorted(totals),
+			mutated: true
+		};
+	}
+	const recent = {};
 	for (const record of sessions) {
-		let snapshot;
+		if (isFrozen(record, checkpoint.frozenBefore)) continue;
 		try {
-			snapshot = await query.readSession(record.header.id);
+			mergeInto(recent, countSkillInvocations((await query.readSession(record.header.id)).events));
 		} catch {
 			continue;
 		}
-		for (const [name, stat] of countSkillInvocations(snapshot.events)) {
-			const total = totals.get(name);
-			if (total === void 0) totals.set(name, { ...stat });
-			else {
-				total.count += stat.count;
-				if (stat.lastUsed > total.lastUsed) total.lastUsed = stat.lastUsed;
-			}
+	}
+	const totals = {};
+	for (const [id, entry] of Object.entries(checkpoint.frozenSessions)) {
+		if (!inWindow(entry.createdAt, windowDays, nowMs)) {
+			delete checkpoint.frozenSessions[id];
+			continue;
 		}
+		mergeInto(totals, new Map(Object.entries(entry.counts)));
 	}
-	return [...totals.entries()].map(([name, stat]) => ({
-		name,
-		count: stat.count,
-		lastUsed: stat.lastUsed
-	})).sort((a, b) => a.name.localeCompare(b.name));
+	mergeInto(totals, new Map(Object.entries(recent)));
+	return {
+		stats: toSorted(totals),
+		mutated: false
+	};
 }
 /**
 * Wrap a query in a stale-while-revalidate cache: responses never wait for a
@@ -3074,19 +3203,44 @@ async function readSkillStats(query) {
 * single background rescan refreshes them — the panel's next poll picks the
 * fresh numbers. A full scan decompresses every session log and can take
 * seconds, so it must never sit on the request path.
+*
+* Two scaling mechanisms keep this sane as history grows:
+*  - the rescan is incremental (per-session checkpoint, see module doc);
+*  - the effective TTL adapts to the measured scan duration, so a heavier
+*    corpus automatically lowers the rescan cadence instead of burning CPU
+*    on every poll interval.
 */
-function createSkillStatsReader(query, ttlMs = 3e5) {
+function createSkillStatsReader(query, ttlMs = 3e5, options = {}) {
+	const checkpoint = options.checkpoint ?? {
+		windowDays: 0,
+		frozenBefore: 0,
+		frozenSessions: {},
+		lastFullReconcile: 0
+	};
+	const now = options.now ?? (() => Date.now());
 	let cached;
 	let cachedAt = 0;
 	let refreshing = null;
+	let lastScanDurationMs = 0;
 	return async () => {
-		if (cached !== void 0 && Date.now() - cachedAt < ttlMs) return cached;
-		if (refreshing === null) refreshing = readSkillStats(query).then((stats) => {
-			cached = stats;
-			cachedAt = Date.now();
-		}).catch(() => {}).finally(() => {
-			refreshing = null;
-		});
+		const startedAt = now();
+		const base = typeof ttlMs === "function" ? ttlMs() : ttlMs;
+		const ttl = Math.max(base, lastScanDurationMs * 3);
+		if (cached !== void 0 && startedAt - cachedAt < ttl) return cached;
+		if (refreshing === null) {
+			const windowDays = options.windowDays?.() ?? 0;
+			refreshing = scan(query, checkpoint, startedAt, windowDays).then(({ stats, mutated }) => {
+				cached = stats;
+				cachedAt = now();
+				lastScanDurationMs = Math.max(0, cachedAt - startedAt);
+				if (mutated) options.onCheckpoint?.({
+					...checkpoint,
+					frozenSessions: { ...checkpoint.frozenSessions }
+				});
+			}).catch(() => {}).finally(() => {
+				refreshing = null;
+			});
+		}
 		return cached ?? [];
 	};
 }
@@ -3106,7 +3260,9 @@ const Config = z.object({
 	enabled: z.boolean().default(HUB_CONFIG_DEFAULTS.enabled),
 	showUseCount: z.boolean().default(HUB_CONFIG_DEFAULTS.showUseCount),
 	showUseTime: z.boolean().default(HUB_CONFIG_DEFAULTS.showUseTime),
-	showGroupSummary: z.boolean().default(HUB_CONFIG_DEFAULTS.showGroupSummary)
+	showGroupSummary: z.boolean().default(HUB_CONFIG_DEFAULTS.showGroupSummary),
+	statsWindowDays: z.number().min(0).max(3650).default(HUB_CONFIG_DEFAULTS.statsWindowDays),
+	statsScanMinutes: z.number().min(1).max(1440).default(HUB_CONFIG_DEFAULTS.statsScanMinutes)
 });
 /**
 * Settings namespace hosting the hub's runtime config. Since dsh rc.7 the
@@ -3124,7 +3280,9 @@ const HubSettingsSchema = z.object({
 	showUseTime: z.boolean().default(HUB_CONFIG_DEFAULTS.showUseTime),
 	showGroupSummary: z.boolean().default(HUB_CONFIG_DEFAULTS.showGroupSummary),
 	dotModelColor: z.string().pattern(HEX_COLOR_RE),
-	dotUserColor: z.string().pattern(HEX_COLOR_RE)
+	dotUserColor: z.string().pattern(HEX_COLOR_RE),
+	statsWindowDays: z.number().min(0).max(3650).default(HUB_CONFIG_DEFAULTS.statsWindowDays),
+	statsScanMinutes: z.number().min(1).max(1440).default(HUB_CONFIG_DEFAULTS.statsScanMinutes)
 });
 /** Order of the announcement section within the tool-guidance band. */
 const SECTION_ORDER = 152;
@@ -3211,8 +3369,27 @@ function apply(ctx, config) {
 		}
 	})();
 	ctx.inject(["sessionQuery"], (sctx) => {
-		stats = createSkillStatsReader(sctx.sessionQuery);
-		sync();
+		(async () => {
+			const saved = await store.getSkillStatsState().catch(() => void 0);
+			const scanMinutes = () => {
+				const value = current().statsScanMinutes;
+				return typeof value === "number" && value >= 1 ? Math.floor(value) : HUB_CONFIG_DEFAULTS.statsScanMinutes;
+			};
+			const windowDays = () => {
+				const value = current().statsWindowDays;
+				return typeof value === "number" && value >= 0 ? Math.floor(value) : HUB_CONFIG_DEFAULTS.statsWindowDays;
+			};
+			stats = createSkillStatsReader(sctx.sessionQuery, () => scanMinutes() * 6e4, {
+				checkpoint: saved,
+				windowDays,
+				onCheckpoint: (next) => {
+					store.saveSkillStatsState(next).catch((error) => {
+						ctx.logger.warn("[dsh-skill-hub] persisting skill-stats checkpoint failed", error);
+					});
+				}
+			});
+			sync();
+		})();
 	});
 }
 //#endregion

package/lib/types/client/SkillHubSettingsCard.d.ts

@@ -9,12 +9,8 @@ import type { ReactElement } from 'react';
 import type { SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { type CardShell, type FieldState, type FormScope } from './settings-form.ts';
-/** Model-invocable dot color default. Single source for the TS side; the
- *  panel's CSS mirrors it via --hub-model (panel.module.css). */
-export declare const DEFAULT_DOT_MODEL_COLOR = "#2f81f7";
-/** User-invocable dot color default. Single source for the TS side; the
- *  panel's CSS mirrors it via --hub-user (panel.module.css). */
-export declare const DEFAULT_DOT_USER_COLOR = "#3fb950";
+import { DEFAULT_DOT_MODEL_COLOR, DEFAULT_DOT_USER_COLOR } from './panel/format.ts';
+export { DEFAULT_DOT_MODEL_COLOR, DEFAULT_DOT_USER_COLOR };
 /** The card's projected state. */
 export interface SkillHubSettingsState extends CardShell {
     enabled: FieldState;
@@ -24,6 +20,8 @@ export interface SkillHubSettingsState extends CardShell {
     showUseCount: FieldState;
     showUseTime: FieldState;
     showGroupSummary: FieldState;
+    statsWindowDays: FieldState;
+    statsScanMinutes: FieldState;
 }
 /** The business face the card's slot registration injects. */
 export interface SkillHubSettingsCardFace {

package/lib/types/client/icons.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Vendored UI icons for dsh-skill-hub.
+ *
+ * These were originally imported from `@deepseek-ai/dsh-client-ui-primitives`.
+ * That package is still published for the rc.7/rc.2 SDK families, but newer dsh
+ * web builds no longer expose it as a standalone plugin module — they keep a
+ * static compatibility module instead. Vendoring the few tiny outline icons the
+ * hub uses makes the browser half self-contained and equally compatible with
+ * older and newer dsh hosts.
+ *
+ * SVG paths are copied verbatim from dsh-client-ui-primitives (MIT licensed)
+ * so the visuals remain pixel-identical to the dsh icon family.
+ */
+import type { JSX } from 'react';
+/** Props understood by the dsh icon family: size + optional className. */
+export interface IconProps {
+    size?: number;
+    className?: string;
+}
+/** ic_ds_chevron_down_outline_14 */
+export declare function IconChevronDownOutline14({ size, className }: IconProps): JSX.Element;
+/** ic_ds_trash_outline_16 */
+export declare function IconTrashOutline16({ size, className }: IconProps): JSX.Element;
+/** ic_ds_skill_outline_16 */
+export declare function IconSkillOutline16({ size, className }: IconProps): JSX.Element;

package/lib/types/client/locales.d.ts

@@ -18,7 +18,7 @@ export declare const zh: {
     readonly 'panel.search': "搜索技能…";
     readonly 'legend.model': "模型可调 — Agent 可自动调用";
     readonly 'legend.user': "用户可调 — 仅显式点名时触发";
-    readonly 'legend.hint': "圆点标在技能名旁；无圆点表示该技能不可被调用。";
+    readonly 'legend.hint': "每个技能最多一个圆点；无圆点 = 不可被调用。";
     readonly 'panel.enabled': "已启用";
     readonly 'panel.disabled': "已禁用";
     readonly 'panel.diagnostics': "发现诊断";
@@ -187,15 +187,19 @@ export declare const zh: {
     readonly 'settings.announceToAgent': "向 Agent 公告";
     readonly 'settings.announceToAgentHint': "在系统提示中加入本插件说明，用户提到技能管理时 Agent 知道如何协作。";
     readonly 'settings.dotModelColor': "模型可调圆点颜色";
-    readonly 'settings.dotModelColorHint': "技能名旁蓝色圆点的颜色（#rrggbb）。";
+    readonly 'settings.dotModelColorHint': "技能行/聊天 / 菜单中「模型可调」蓝色圆点的颜色（#rrggbb）。";
     readonly 'settings.dotUserColor': "用户可调圆点颜色";
-    readonly 'settings.dotUserColorHint': "技能名旁绿色圆点的颜色（#rrggbb）。";
+    readonly 'settings.dotUserColorHint': "技能行/聊天 / 菜单中「仅用户可调」绿色圆点的颜色（#rrggbb）。";
     readonly 'settings.showUseCount': "显示调用次数";
     readonly 'settings.showUseCountHint': "在技能名旁显示琥珀色调用次数。";
     readonly 'settings.showUseTime': "显示最近调用时间";
     readonly 'settings.showUseTimeHint': "在技能名行右侧显示相对时间（如「3 天前」）。";
     readonly 'settings.showGroupSummary': "显示分组汇总";
     readonly 'settings.showGroupSummaryHint': "在分组标题后汇总调用次数与最近调用时间。";
+    readonly 'settings.statsWindowDays': "统计窗口（天）";
+    readonly 'settings.statsWindowDaysHint': "只统计最近 N 天的使用次数，默认 14 天；0 = 全部历史。改动立即生效。";
+    readonly 'settings.statsScanMinutes': "自动统计间隔（分钟）";
+    readonly 'settings.statsScanMinutesHint': "后台扫描会话日志的间隔，最小 1 分钟；扫描耗时会自动拉长间隔。";
     readonly 'settings.inherit': "继承";
     readonly 'settings.on': "开";
     readonly 'settings.off': "关";

package/lib/types/client/panel/format.d.ts

@@ -2,8 +2,18 @@
  * Shared display helpers for the panel views (skill rows, detail view, and
  * dialogs): dot color styling, relative/absolute time text, and commit-SHA
  * shortening. Kept in one place so the views render identically.
+ *
+ * The invocation-status dot defaults live here (not in the settings card) so
+ * both the panel legend and the chat `/` skill menu draw from one source and
+ * so this primitives-free module stays unit-testable.
  */
 import type { CSSProperties } from 'react';
+/** Model-invocable dot color default. Single source for the TS side; the
+ *  panel's CSS mirrors it via --hub-model (panel.module.css). */
+export declare const DEFAULT_DOT_MODEL_COLOR = "#2f81f7";
+/** User-invocable dot color default. Single source for the TS side; the
+ *  panel's CSS mirrors it via --hub-user (panel.module.css). */
+export declare const DEFAULT_DOT_USER_COLOR = "#3fb950";
 /** Dot inline style from the user-chosen color (undefined keeps the CSS default). */
 export declare function dotStyle(color: string | undefined): CSSProperties | undefined;
 /** Localized relative-time text for a Unix-ms timestamp. */

package/lib/types/client/settings-card.d.ts

@@ -80,3 +80,21 @@ export interface ColorFieldProps {
     onReset: () => void;
 }
 export declare function ColorField(props: ColorFieldProps): ReactElement;
+/** One staged numeric field: a numeric draft text input with inherit/reset semantics. */
+export interface NumberFieldProps {
+    id: string;
+    label: string;
+    hint: string;
+    /** Placeholder shown while the field inherits its default. */
+    inheritLabel: string;
+    overriddenLabel: string;
+    resetLabel: string;
+    disabled: boolean;
+    /** Effective number when overridden; empty string means inherit. */
+    text: string;
+    overridden: boolean;
+    invalid?: boolean;
+    onEdit: (text: string) => void;
+    onReset: () => void;
+}
+export declare function NumberField(props: NumberFieldProps): ReactElement;

package/lib/types/client/settings-form.d.ts

@@ -23,6 +23,15 @@ export interface FieldSpec {
 export declare function booleanField(field: string): FieldSpec;
 /** A #rrggbb color field, edited through hex draft text. */
 export declare function colorField(field: string): FieldSpec;
+/**
+ * A numeric field with range clamping. Integer by default: a fractional draft
+ * is truncated so "5.5 分钟" cannot sneak past an integer-only schema.
+ */
+export declare function numberField(field: string, options?: {
+    min?: number;
+    max?: number;
+    integer?: boolean;
+}): FieldSpec;
 /** Card-level state the chrome renders. */
 export interface CardShell {
     available: boolean;

package/lib/types/client/slash-dots.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Slash-menu skill dots: puts the invocation-status dot (model-callable blue /
+ * user-only green) in front of every skill candidate in the chat `/` menu.
+ *
+ * Mechanism (mirrors how dsh-at-file fills the menu icon slot): the candidate
+ * menu's rows already render an optional `icon` slot (`MenuView` renders
+ * `item.icon` in a 16×16 leading span when it's defined), but the core `/skill`
+ * source (`dsh-client-ui-skill`) returns candidates without `icon`. This module
+ * wraps that source's `candidates` and stamps each row with a colored dot,
+ * reusing the same settings (dotModelColor / dotUserColor) and the same
+ * `modelInvocable` classification the panel legend uses — so the chat menu and
+ * the Settings → 技能 panel stay in sync, and editing the color updates both.
+ *
+ * The skill source is registered by the core plugin under the `name` "skill"
+ * on the `/` trigger; re-registering the same name would throw, so this wraps
+ * the already-registered source object instead (found through the runtime
+ * source registry, which the frozen contract exposes only as `registerSource`
+ * / `sessionOf` — the lookup below is defensive: it never throws).
+ */
+import type { ClientContext, SettingsScope } from '@deepseek-ai/dsh-client-runtime/client';
+import type { InputTriggerServiceContract, InputTriggerSource } from '@deepseek-ai/dsh-client-ui-input-trigger/client';
+import type { HubSettingsValue } from '../protocol.ts';
+import type { SkillHubApi } from './api.ts';
+/**
+ * Find the core `/skill` source through the runtime registry, or undefined.
+ * The lookup never throws: a missing/reshaped registry just means no dots. Exported
+ * for unit tests; the apply path only calls it indirectly through setupSkillSlashDots.
+ * @param service - the ctx.inputTriggers service face.
+ * @returns the registered skill source, or undefined.
+ */
+export declare function findSkillSource(service: InputTriggerServiceContract): InputTriggerSource | undefined;
+/**
+ * Clear the modelInvocable cache. Called on connection/reset so a fresh
+ * catalog wins after reconnect; exported for deterministic unit tests.
+ */
+export declare function resetModelCache(): void;
+/**
+ * Wrap the core skill source so every menu row carries the invocation dot.
+ * Exported for unit tests; production wiring goes through setupSkillSlashDots.
+ * @param source - the registered `/skill` source.
+ * @param api - hub browser API for the modelInvocable lookup.
+ * @param scope - hub settings scope for the dot colors.
+ * @returns a disposer restoring the original candidates.
+ */
+export declare function wrapSkillSource(source: InputTriggerSource, api: SkillHubApi, scope: SettingsScope<HubSettingsValue>): () => void;
+/**
+ * Mount the slash-menu dots on the registered `/skill` source. Idempotent and
+ * defensive: if the core source isn't registered yet (or the registry shape
+ * changes), it retries briefly and then gives up silently — the chat keeps
+ * working, it simply shows no dots. The returned disposer restores the
+ * original candidates and clears the model cache.
+ * @param ctx - the client root context (inputTriggers + events).
+ * @param api - hub browser API.
+ * @param scope - hub settings scope for dot colors.
+ * @returns a cleanup function for `ctx.effect`.
+ */
+export declare function setupSkillSlashDots(ctx: ClientContext, api: SkillHubApi, scope: SettingsScope<HubSettingsValue>): () => void;

package/lib/types/index.d.ts

@@ -25,6 +25,10 @@ export interface Config {
     showUseTime?: boolean;
     /** Show group-header usage summaries (count + last used). Default true. */
     showGroupSummary?: boolean;
+    /** 统计滚动窗口天数：只统计最近 N 天的使用；0 = 全部历史。默认 0。 */
+    statsWindowDays?: number;
+    /** 自动统计扫描间隔（分钟，最小 1）。默认 5。 */
+    statsScanMinutes?: number;
 }
 export declare const Config: z<Config>;
 /**