dsh-skill-hub 0.2.4 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-skill-hub",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "In-GUI skill hub for DeepSeek Harness (dsh): browse the full local skill catalog from the official ctx.skills registry (every root + third-party providers), toggle skills on/off, inspect bodies, surface frontmatter diagnostics, and scaffold new skills — plus a codex-style skill market (built-in catalog, upstream update checks, one-click update-all) with tracked source sync. The full manager beyond the read-only dsh-skill-manager browser.",
   "type": "module",
   "engines": {

package/src/client/SkillHubSettingsCard.tsx

@@ -9,8 +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 { ColorField, PluginSettingsCard, SwitchField } from './settings-card.tsx'
-import { booleanField, CardForm, colorField, type CardShell, type FieldState, type FormScope } from './settings-form.ts'
+import { ColorField, NumberField, PluginSettingsCard, SwitchField } from './settings-card.tsx'
+import { booleanField, CardForm, colorField, numberField, type CardShell, type FieldState, type FormScope } from './settings-form.ts'
 // Single source for the TS-side dot defaults (the panel CSS mirrors these).
 import { DEFAULT_DOT_MODEL_COLOR, DEFAULT_DOT_USER_COLOR } from './panel/format.ts'
 // Re-export for any consumer that imported them from the card before the move.
@@ -25,6 +25,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. */
@@ -50,7 +52,7 @@ export class SkillHubSettingsCardController {
 
   /** @param scope - the hub settings scope the card edits (FormScope-compatible). */
   constructor(scope: FormScope) {
-    this.form = new CardForm(scope, [booleanField('enabled'), booleanField('announceToAgent'), colorField('dotModelColor'), colorField('dotUserColor'), booleanField('showUseCount'), booleanField('showUseTime'), booleanField('showGroupSummary')])
+    this.form = new CardForm(scope, [booleanField('enabled'), booleanField('announceToAgent'), colorField('dotModelColor'), colorField('dotUserColor'), booleanField('showUseCount'), booleanField('showUseTime'), booleanField('showGroupSummary'), numberField('statsWindowDays', { min: 0, max: 3650 }), numberField('statsScanMinutes', { min: 1, max: 1440 })])
     this.store = this.form.bind(() => this.projection())
   }
 
@@ -64,6 +66,8 @@ export class SkillHubSettingsCardController {
       showUseCount: this.form.field('showUseCount'),
       showUseTime: this.form.field('showUseTime'),
       showGroupSummary: this.form.field('showGroupSummary'),
+      statsWindowDays: this.form.field('statsWindowDays'),
+      statsScanMinutes: this.form.field('statsScanMinutes'),
     }
   }
 
@@ -164,6 +168,30 @@ export function SkillHubSettingsCard(props: SkillHubSettingsCardProps): ReactEle
         onEdit={(text) => { props.edit('showGroupSummary', text) }}
         onReset={() => { props.resetField('showGroupSummary') }}
       />
+      <NumberField
+        id='skill-hub-stats-window-days'
+        label={t('settings.statsWindowDays')}
+        hint={t('settings.statsWindowDaysHint')}
+        inheritLabel={t('settings.inherit')}
+        {...fieldProps}
+        text={state.statsWindowDays.text}
+        overridden={state.statsWindowDays.overridden}
+        invalid={state.statsWindowDays.invalid}
+        onEdit={(text) => { props.edit('statsWindowDays', text) }}
+        onReset={() => { props.resetField('statsWindowDays') }}
+      />
+      <NumberField
+        id='skill-hub-stats-scan-minutes'
+        label={t('settings.statsScanMinutes')}
+        hint={t('settings.statsScanMinutesHint')}
+        inheritLabel={t('settings.inherit')}
+        {...fieldProps}
+        text={state.statsScanMinutes.text}
+        overridden={state.statsScanMinutes.overridden}
+        invalid={state.statsScanMinutes.invalid}
+        onEdit={(text) => { props.edit('statsScanMinutes', text) }}
+        onReset={() => { props.resetField('statsScanMinutes') }}
+      />
     </PluginSettingsCard>
   )
 }

package/src/client/locales.ts

@@ -197,6 +197,10 @@ export const zh = {
   'settings.showUseTimeHint': '在技能名行右侧显示相对时间（如「3 天前」）。',
   'settings.showGroupSummary': '显示分组汇总',
   'settings.showGroupSummaryHint': '在分组标题后汇总调用次数与最近调用时间。',
+  'settings.statsWindowDays': '统计窗口（天）',
+  'settings.statsWindowDaysHint': '只统计最近 N 天的使用次数，默认 14 天；0 = 全部历史。改动立即生效。',
+  'settings.statsScanMinutes': '自动统计间隔（分钟）',
+  'settings.statsScanMinutesHint': '后台扫描会话日志的间隔，最小 1 分钟；扫描耗时会自动拉长间隔。',
   'settings.inherit': '继承',
   'settings.on': '开',
   'settings.off': '关',
@@ -406,6 +410,10 @@ export const en: Record<HubKey, string> = {
   'settings.showUseTimeHint': 'Show relative last-used time on the name row (e.g. "3 d ago").',
   'settings.showGroupSummary': 'Show group summaries',
   'settings.showGroupSummaryHint': 'Summarize invocation count and last-used time after group titles.',
+  'settings.statsWindowDays': 'Stats window (days)',
+  'settings.statsWindowDaysHint': 'Count only usage within the last N days (default 14); 0 = full history. Changes apply immediately.',
+  'settings.statsScanMinutes': 'Auto stats interval (minutes)',
+  'settings.statsScanMinutesHint': 'How often the background session-log scan runs (min 1); heavy scans automatically stretch it.',
   'settings.inherit': 'Inherit',
   'settings.on': 'On',
   'settings.off': 'Off',

package/src/client/panel/SkillHubPanel.tsx

@@ -119,7 +119,7 @@ export function SkillHubPanel(props: SkillHubPanelProps): React.JSX.Element {
   return (
     <div className={css.panel}>
       <div className={css.header}>
-        <h2 className={css.title}><IconSkillOutline16 size={16} className={css.titleIcon} /> {tt('panel.title')}</h2>
+        <h2 className={css.title}><IconSkillOutline16 size={16} className={css.titleIcon} /> {tt('panel.title')}{catalog !== null ? <span className={css.pluginVersion}>v{catalog.pluginVersion}</span> : null}</h2>
         {catalog !== null
           ? <span className={css.headerCount}>
               {tt('panel.count', { count: catalog.skills.length + catalog.disabled.length })}

package/src/client/panel/panel.module.css

@@ -120,6 +120,7 @@
 
 /* Reduced header: title + quiet count on one line, controls on the next. */
 .headerCount { font-size: 12px; opacity: .5; margin-left: 2px; white-space: nowrap; }
+.pluginVersion { font-size: 12px; font-weight: 500; opacity: .45; margin-left: 6px; white-space: nowrap; font-variant-numeric: tabular-nums; }
 .subbar { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
 .legendToggle { flex: none; width: 22px; height: 22px; border-radius: 50%; border: none; background: rgba(128,128,128,.14); color: inherit; font-size: 12px; line-height: 1; cursor: pointer; opacity: .55; transition: opacity .15s ease, background .15s ease; }
 .legendToggle:hover { opacity: 1; }

package/src/client/settings-card.tsx

@@ -236,3 +236,51 @@ export function ColorField(props: ColorFieldProps): ReactElement {
     </div>
   )
 }
+
+/** 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 function NumberField(props: NumberFieldProps): ReactElement {
+  return (
+    <div className={css.field}>
+      <div className={css.head}>
+        <label className={css.label} htmlFor={props.id}>{props.label}</label>
+        {props.overridden ? (
+          <span className={css.badges}>
+            <span className={css.badge}>{props.overriddenLabel}</span>
+            <button type='button' className={css.reset} disabled={props.disabled} onClick={props.onReset}>
+              {props.resetLabel}
+            </button>
+          </span>
+        ) : null}
+      </div>
+      <input
+        id={props.id}
+        type='text'
+        inputMode='numeric'
+        className={css.input}
+        value={props.text}
+        disabled={props.disabled}
+        placeholder={props.inheritLabel}
+        aria-invalid={props.invalid === true}
+        onChange={(event) => { props.onEdit(event.target.value) }}
+      />
+      <p className={css.hint}>{props.hint}</p>
+    </div>
+  )
+}

package/src/client/settings-form.ts

@@ -49,6 +49,27 @@ export 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 function numberField(field: string, options: { min?: number; max?: number; integer?: boolean } = {}): FieldSpec {
+  const min = options.min ?? Number.NEGATIVE_INFINITY
+  const max = options.max ?? Number.POSITIVE_INFINITY
+  const integer = options.integer ?? true
+  return {
+    field,
+    format: (value) => (typeof value === 'number' && Number.isFinite(value) ? String(value) : ''),
+    parse: (text) => {
+      const trimmed = text.trim()
+      if (!/^-?\d+(\.\d+)?$/.test(trimmed)) return undefined
+      const parsed = integer ? Math.trunc(Number(trimmed)) : Number(trimmed)
+      if (!Number.isFinite(parsed) || parsed < min || parsed > max) return undefined
+      return { kind: 'set', value: parsed }
+    },
+  }
+}
+
 /** Card-level state the chrome renders. */
 export interface CardShell {
   available: boolean

package/src/index.ts

@@ -40,6 +40,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 const Config: z<Config> = z.object({
@@ -48,6 +52,8 @@ export const Config: z<Config> = z.object({
   showUseCount: z.boolean().default(HUB_CONFIG_DEFAULTS.showUseCount),
   showUseTime: z.boolean().default(HUB_CONFIG_DEFAULTS.showUseTime),
   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),
 })
 
 /**
@@ -68,6 +74,8 @@ export const HubSettingsSchema: z<HubSettingsValue> = z.object({
   showGroupSummary: z.boolean().default(HUB_CONFIG_DEFAULTS.showGroupSummary),
   dotModelColor: 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. */
@@ -126,7 +134,7 @@ export function apply(ctx: Context, config?: Config): void {
   // surfaces once the namespace commits.
   const updateConfig = async (patch: Partial<HubConfig>): Promise<HubConfig> => {
     const user: Record<string, unknown> = { ...saved() }
-    for (const [key, value] of Object.entries(patch) as Array<[keyof HubConfig, boolean | string | undefined]>) {
+    for (const [key, value] of Object.entries(patch) as Array<[keyof HubConfig, boolean | string | number | undefined]>) {
       if (value === undefined) delete user[key]
       else user[key] = value
     }
@@ -222,7 +230,30 @@ export function apply(ctx: Context, config?: Config): void {
   // stats wiring — no sessionQuery service ever mounted means none of this
   // runs).
   ctx.inject(['sessionQuery'], (sctx) => {
-    stats = createSkillStatsReader(sctx.sessionQuery)
-    sync()
+    // 恢复 sidecar 里的增量扫描检查点后再建 reader（异步、不阻塞注入回调）：
+    // 重启后无需重新解压全部历史日志；检查点只在全量对账后落盘（约每天一次，
+    // 或统计窗口配置变化后的下一次扫描）。扫描间隔与滚动窗口都从设置命名空间
+    // 实时读取——卡片里改完即生效，无需重启。
+    void (async () => {
+      const saved = await store.getSkillStatsState().catch(() => undefined)
+      const scanMinutes = (): number => {
+        const value = current().statsScanMinutes
+        return typeof value === 'number' && value >= 1 ? Math.floor(value) : HUB_CONFIG_DEFAULTS.statsScanMinutes
+      }
+      const windowDays = (): number => {
+        const value = current().statsWindowDays
+        return typeof value === 'number' && value >= 0 ? Math.floor(value) : HUB_CONFIG_DEFAULTS.statsWindowDays
+      }
+      stats = createSkillStatsReader(sctx.sessionQuery, () => scanMinutes() * 60_000, {
+        checkpoint: saved,
+        windowDays,
+        onCheckpoint: (next) => {
+          void store.saveSkillStatsState(next).catch((error) => {
+            ctx.logger.warn('[dsh-skill-hub] persisting skill-stats checkpoint failed', error)
+          })
+        },
+      })
+      sync()
+    })()
   })
 }

package/src/protocol.ts

@@ -88,6 +88,8 @@ export interface DiagnosticEntry {
 /** GET /api/skill-hub/catalog */
 export interface CatalogResponse {
   ok: true
+  /** 已安装插件自身的版本号（package.json version），面板标题旁显示。 */
+  pluginVersion: string
   /** Whether discovery completed within a stable catalog revision. */
   complete: boolean
   /** Sorted winning summaries of every enabled skill (all roots + providers). */
@@ -196,6 +198,25 @@ export interface StatsResponse {
   stats: SkillStat[]
 }
 
+/**
+ * Persisted incremental-scan checkpoint for the usage statistics (sidecar
+ * `skillStats` field). Sessions created before `frozenBefore` are treated as
+ * finalized: their per-session counts live in `frozenSessions` (only sessions
+ * with at least one invocation are kept) and they are not re-read on
+ * incremental scans. A daily full reconciliation rebuilds the cache and
+ * advances the watermark, so a resumed old session is eventually re-counted.
+ */
+export interface SkillStatsCheckpoint {
+  /** The rolling-window configuration this checkpoint was built for (0 = all history). */
+  windowDays: number
+  /** Watermark: every session with header.createdAt < this value is frozen. */
+  frozenBefore: number
+  /** Per-session counts of finalized sessions, keyed by session id. */
+  frozenSessions: Record<string, { createdAt: number; counts: Record<string, { count: number; lastUsed: number }> }>
+  /** Epoch ms of the last full reconciliation (drives the daily cadence). */
+  lastFullReconcile: number
+}
+
 /** JSON error body shared by every route. */
 export interface ErrorResponse {
   error: string
@@ -217,6 +238,10 @@ export interface HubConfig {
   showUseTime?: boolean
   /** Show group-header usage summaries (count + last used). Default true. */
   showGroupSummary?: boolean
+  /** 统计滚动窗口天数：只统计最近 N 天的使用；0 = 全部历史。默认 0。 */
+  statsWindowDays?: number
+  /** 自动统计扫描间隔（分钟，最小 1）。默认 5。 */
+  statsScanMinutes?: number
 }
 
 /**
@@ -235,6 +260,10 @@ export type HubSettingsValue = {
   dotModelColor?: string
   /** User-invocable dot color (#rrggbb); absent means the panel default. */
   dotUserColor?: string
+  /** 统计滚动窗口天数（0 = 全部历史）。 */
+  statsWindowDays?: number
+  /** 自动统计扫描间隔（分钟）。 */
+  statsScanMinutes?: number
 }
 
 /**
@@ -248,28 +277,41 @@ export const HUB_CONFIG_DEFAULTS = {
   showUseCount: true,
   showUseTime: true,
   showGroupSummary: true,
+  statsWindowDays: 14,
+  statsScanMinutes: 5,
 } as const
 
 /**
  * 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).
  */
 export function resolveHubConfig(saved: Partial<HubConfig>, base: Partial<HubConfig> = {}): HubConfig {
   const dotModelColor = saved.dotModelColor !== undefined ? saved.dotModelColor : base.dotModelColor
   const dotUserColor = saved.dotUserColor !== undefined ? 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 !== undefined ? { dotModelColor } : {}),
     ...(dotUserColor !== undefined ? { dotUserColor } : {}),
   }
 }
 
+/** Clamp a numeric override into a valid value; undefined/invalid stays undefined. */
+function clampNumber(value: unknown, min: number): number | undefined {
+  if (typeof value !== 'number' || !Number.isFinite(value) || value < min) return undefined
+  return Math.floor(value)
+}
+
 /** HEX color validation shared by host routes and the settings card. */
 export const HEX_COLOR_RE = /^#[0-9a-f]{6}$/i
 
@@ -298,6 +340,10 @@ export interface ConfigRequest {
   dotModelColor?: string | null
   /** Set the dot color; null clears the saved override so it re-inherits the default. */
   dotUserColor?: string | null
+  /** 统计滚动窗口天数（0 = 全部历史）；null 清除覆盖回默认。 */
+  statsWindowDays?: number | null
+  /** 自动统计扫描间隔（分钟）；null 清除覆盖回默认。 */
+  statsScanMinutes?: number | null
 }
 
 /** One market source: a tracked upstream repo plus its pinned version. */

package/src/routes.test.ts

@@ -127,6 +127,8 @@ describe('skill-hub routes', () => {
     expect(body.skills[1].writable).toBe(false)
     expect(body.diagnostics).toHaveLength(1)
     expect(body.diagnostics[0].reason).toBe('missing YAML frontmatter (--- block)')
+    // 面板标题旁的插件版本徽标数据源：随 catalog 附带当前安装版本。
+    expect(body.pluginVersion).toMatch(/^\d+\.\d+\.\d+$/)
   })
 
   it('forwards the cwd query to the registry snapshot', async () => {
@@ -394,7 +396,7 @@ describe('skill-hub routes', () => {
     expect(res.status).toBe(200)
     const body = res.json() as ConfigResponse
     expect(body.ok).toBe(true)
-    expect(body.config).toEqual({ enabled: false, announceToAgent: true, showUseCount: true, showUseTime: true, showGroupSummary: true })
+    expect(body.config).toEqual({ enabled: false, announceToAgent: true, showUseCount: true, showUseTime: true, showGroupSummary: true, statsWindowDays: 14, statsScanMinutes: 5 })
     expect(body.saved).toEqual({ enabled: false })
   })
 

package/src/routes.ts

@@ -85,7 +85,7 @@ import {
   resolveHubConfig,
 } from './protocol.ts'
 import { clearTrash, createSkill, disableSkill, enableSkill, restoreSkill, rootOfPath, rootPath, scanDiagnostics, trashSkill } from './skillfs.ts'
-import { checkLatestRelease } from './update.ts'
+import { checkLatestRelease, CURRENT_VERSION } from './update.ts'
 import { dshHome, StoreError, type SkillHubStore } from './store.ts'
 import type { SkillStatsReader } from './stats.ts'
 
@@ -410,7 +410,7 @@ async function buildCatalog(deps: SkillHubRouteDeps, cwd?: string): Promise<Cata
     ...(await scanDiagnostics('user-dsh', home)),
     ...(await scanDiagnostics('user-agents', home)),
   ]
-  return { ok: true, complete, skills, disabled, diagnostics }
+  return { ok: true, pluginVersion: CURRENT_VERSION, complete, skills, disabled, diagnostics }
 }
 
 /** Map a loaded definition onto the wire shape. */