dsh-skill-hub 0.0.1 → 0.2.0

package/lib/invariant.js

@@ -0,0 +1,6 @@
+//#region src/invariant.ts
+/** Invariant companion plugin (no assertions — nothing to check at runtime). */
+/** Provides no assertions: the skill-hub owns no cross-package runtime invariants. */
+function apply() {}
+//#endregion
+export { apply };

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

@@ -0,0 +1,53 @@
+/**
+ * The dsh-skill-hub plugin settings card: bridges the hub's own config route
+ * (ApiConfigScope → /api/skill-hub/config) onto the family-style staged card
+ * form (enabled master switch + agent announcement). Registered into the
+ * official `settings.plugin.item` slot so the plugin shows up in Settings →
+ * 插件. The scope is a FormScope, so the card never touches the settings
+ * service (the host refuses third-party namespaces).
+ */
+import type { ReactElement } from 'react';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import { CardForm, type CardShell, type FieldState, type FormScope } from './settings-form.ts';
+/** The card's projected state. */
+export interface SkillHubSettingsState extends CardShell {
+    enabled: FieldState;
+    announceToAgent: FieldState;
+    dotModelColor: FieldState;
+    dotUserColor: FieldState;
+    showUseCount: FieldState;
+    showUseTime: FieldState;
+    showGroupSummary: FieldState;
+}
+/** Props the slot renderer receives (locale copy + injected form actions). */
+export interface SkillHubSettingsCardProps {
+    t: (key: string) => string;
+    useSkillHubSettingsCard: <T>(selector: (snapshot: SkillHubSettingsState) => T) => T;
+    save: () => void;
+    discard: () => void;
+    edit: (field: string, text: string) => void;
+    resetField: (field: string) => void;
+}
+/** Bridges the hub's config scope onto the card's staged form. */
+export declare class SkillHubSettingsCardController {
+    private readonly form;
+    private readonly store;
+    /** @param scope - the hub config scope the card edits (ApiConfigScope). */
+    constructor(scope: FormScope);
+    private projection;
+    /**
+     * Build the face the card's slot registration injects.
+     * @returns the card's snapshot hook and its form actions.
+     */
+    inject(): {
+        hooks: {
+            skillHubSettingsCard: SnapshotStore<SkillHubSettingsState>;
+        };
+    } & ReturnType<CardForm['actions']>;
+}
+/**
+ * Render the dsh-skill-hub card.
+ * @param props - locale copy, the card snapshot, and its form actions.
+ * @returns the card.
+ */
+export declare function SkillHubSettingsCard(props: SkillHubSettingsCardProps): ReactElement;

package/lib/types/client/api-config-scope.d.ts

@@ -0,0 +1,48 @@
+/**
+ * ApiConfigScope — a FormScope-compatible view over the hub's own config
+ * route (/api/skill-hub/config). The host's settings service refuses to
+ * expose third-party namespaces to the web client (dsh-host-apiproxy's
+ * allowlist), so the settings card talks to this plugin-owned route instead
+ * of the settings transport.
+ *
+ * The scope mirrors the settings-scope contract the vendored CardForm
+ * consumes: `value` is the effective config, `base` the built-in defaults,
+ * and `user` the raw saved overrides (a field's presence there marks it
+ * overridden). Writes go straight through saveConfig and re-seed the
+ * snapshot from the route's response, so the card's save-verification
+ * (user layer equals the written value) sees the persisted state.
+ */
+import type { SkillHubApi } from './api.ts';
+import 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";
+/** FormScope-compatible reactive config handle (see module doc). */
+export declare class ApiConfigScope implements FormScope {
+    private readonly api;
+    private status;
+    private value;
+    private saved;
+    private readonly listeners;
+    /** @param api - the browser-half API client (shared with the skill panel). */
+    constructor(api: SkillHubApi);
+    private load;
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): {
+        status: string;
+        writable: boolean;
+        value?: Record<string, unknown>;
+        base?: unknown;
+        user?: unknown;
+    };
+    /** Write one field through the config route and adopt the persisted state. */
+    set(field: string, value: unknown): Promise<void>;
+    /** Clear one field's override so it re-inherits the default. */
+    unset(field: string): Promise<void>;
+    /** Persist a patch, then re-seed from the route's fresh response. */
+    private apply;
+    private publish;
+}

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

@@ -0,0 +1,64 @@
+/**
+ * Browser-side API client for the /api/skill-hub route family. The only
+ * data access path the panel uses — plain fetch, same origin.
+ */
+import { type CatalogResponse, type ConfigRequest, type ConfigResponse, type CreateRequest, type CreateResponse, type MarketCheckResponse, type MarketSourcesResponse, type MarketSyncResponse, type RepoDiscoverResponse, type RepoImportResponse, type SkillDetail, type SkillDeleteResponse, type SourceCheckResponse, type SourceDeleteResponse, type SourceRestoreResponse, type SourceTrashClearResponse, type SourcesResponse, type SourceSyncResponse, type StatsResponse, type ToggleBatchResponse, type UpdateCheckResponse } from '../protocol.ts';
+/** Error carrying the route's JSON error message. */
+export declare class SkillHubApiError extends Error {
+    constructor(message: string);
+}
+/** The browser half's only data entry point. */
+export declare class SkillHubApi {
+    catalog(): Promise<CatalogResponse>;
+    skill(name: string): Promise<SkillDetail>;
+    /** Move one writable skill into the restorable trash. */
+    deleteSkill(name: string): Promise<SkillDeleteResponse>;
+    /** Toggle one skill; resolves with the fresh catalog from the route. */
+    toggle(name: string, enabled: boolean): Promise<CatalogResponse>;
+    create(payload: CreateRequest): Promise<CreateResponse>;
+    stats(): Promise<StatsResponse>;
+    /** Toggle a whole group in one write; resolves with the fresh catalog + failures. */
+    toggleBatch(names: string[], enabled: boolean): Promise<ToggleBatchResponse>;
+    /** The user's added market sources (codex-style repo slugs). */
+    market(): Promise<MarketSourcesResponse>;
+    /** Add a market source repo; resolves with the fresh list. */
+    addMarketSource(repo: string): Promise<MarketSourcesResponse>;
+    /** Remove a market source repo; resolves with the fresh list. */
+    removeMarketSource(repo: string): Promise<MarketSourcesResponse>;
+    /** Check every market source for updates (throttled server-side). */
+    marketCheck(): Promise<MarketCheckResponse>;
+    /** Align a market source to its pinned ref; resolves with tracked skills. */
+    marketSync(repo: string): Promise<MarketSyncResponse>;
+    /** Pin a market source to an explicit ref (branch picker). */
+    setMarketSourceRef(repo: string, ref: string): Promise<MarketSourcesResponse>;
+    /** Check the hub's own latest GitHub release. */
+    updateCheck(): Promise<UpdateCheckResponse>;
+    /** Discover importable skills in a GitHub repo. */
+    repoDiscover(repo: string): Promise<RepoDiscoverResponse>;
+    /** Install selected repo skills into the user-dsh root (records the source). */
+    repoImport(repo: string, paths: string[], ref?: string): Promise<RepoImportResponse>;
+    /** Read the hub's runtime config (effective values + saved overrides). */
+    config(): Promise<ConfigResponse>;
+    /** Patch the hub's runtime config (null clears a saved override). */
+    saveConfig(patch: ConfigRequest): Promise<ConfigResponse>;
+    /** 用户 tag 分组 + 系统集合组 + origin 映射。 */
+    groups(): Promise<import('../protocol.ts').GroupsResponse>;
+    /** 新建（无 id）或重命名（带 id）一个 tag 分组；返回全部 tag。 */
+    saveTag(payload: import('../protocol.ts').TagSaveRequest): Promise<import('../protocol.ts').SkillTag[]>;
+    /** 删除一个 tag 分组；返回全部 tag。 */
+    deleteTag(id: string): Promise<import('../protocol.ts').SkillTag[]>;
+    /** 直接设置某 tag 的完整成员列表；返回全部 tag。 */
+    setTagMembers(id: string, skillNames: string[]): Promise<import('../protocol.ts').SkillTag[]>;
+    /** 来源列表 + 派生 origin 映射 + 集合组 + 回收站。 */
+    sources(): Promise<SourcesResponse>;
+    /** 检查指定（或全部）来源的上游更新。 */
+    checkSources(repo?: string): Promise<SourceCheckResponse>;
+    /** 同步一个来源的所选（或全部）技能到上游最新版本。 */
+    syncSource(repo: string, skills?: string[]): Promise<SourceSyncResponse>;
+    /** 跟进上游删除：把所选技能移入回收站。 */
+    confirmDeleteSource(repo: string, skills: string[]): Promise<SourceDeleteResponse>;
+    /** 从回收站恢复一个技能。 */
+    restoreSource(name: string): Promise<SourceRestoreResponse>;
+    /** Permanently delete every skill currently in the trash. */
+    clearTrash(): Promise<SourceTrashClearResponse>;
+}

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

@@ -0,0 +1,64 @@
+/**
+ * Pure grouping helpers for the skill-hub panel (no React/DOM deps, so the
+ * merge/classify/filter logic stays unit-testable).
+ *
+ * The "分组" view unifies two ways a skill can belong to a group:
+ *  - user tags (sidecar SkillTag)
+ *  - origin collections (sidecar sources → backend-aggregated CollectionGroup)
+ *
+ * Switch semantics: a skill's enabled state is global (the file is renamed
+ * once), so a group switch is derived from its members' actual states:
+ * all members enabled → 'on', all disabled → 'off', otherwise 'mixed'.
+ * Closing a group whose member is enabled in another group is a conflict the
+ * GUI resolves with a dialog; the helpers below compute both sides.
+ */
+import type { CatalogSkill, CollectionGroup, SkillTag } from '../protocol.ts';
+/** Grouped switch state derived from member enablement. */
+export type GroupSwitchState = 'on' | 'off' | 'mixed';
+/** The derived switch view of one group. */
+export interface GroupSwitchView {
+    state: GroupSwitchState;
+    /** Writable members currently enabled. */
+    enabled: string[];
+    /** Writable members currently disabled. */
+    disabled: string[];
+}
+/**
+ * Derive a group switch view from its member names and the set of currently
+ * enabled skill names (catalog.skills). Members not in the enabled set count
+ * as disabled (catalog.disabled or absent read-only rows).
+ */
+export declare function groupSwitchView(members: readonly string[], enabledNames: ReadonlySet<string>): GroupSwitchView;
+/** Names of every group a skill belongs to (tags + collections). */
+export declare function groupNamesOf(name: string, tags: readonly SkillTag[], collections: readonly CollectionGroup[]): string[];
+/**
+ * Members of a group that are currently enabled AND also belong to at least
+ * one other group — the set a "close" action must ask about.
+ */
+export declare function conflictsOnClose(members: readonly string[], enabledNames: ReadonlySet<string>, otherGroups: ReadonlyArray<{
+    members: readonly string[];
+}>): string[];
+/** Origin-repo filter value: skills with no source record (private skills). */
+export declare const PRIVATE_SOURCE = "private";
+/**
+ * Apply the origin filter ('all' or a specific origin repo; skills without a
+ * source record count as PRIVATE_SOURCE). The origins map is the store's
+ * skillName → repo derivation, so filtering follows the tracked source
+ * records instead of the filesystem root a skill happens to live under.
+ */
+export declare function filterBySource(skills: readonly CatalogSkill[], source: string, origins: Readonly<Record<string, string>>): CatalogSkill[];
+/** Catalog sort keys offered by the filter bar. */
+export type SortKey = 'name' | 'added' | 'uses';
+/**
+ * Sort a skill list in place-safe copy order: name ascending, added
+ * descending (newest first, unknown addedAt last), or uses descending
+ * (most-called first). Unknown values always trail.
+ */
+export declare function sortSkills(skills: readonly CatalogSkill[], key: SortKey, getUses?: (name: string) => number | undefined): CatalogSkill[];
+/** Localized relative-time tuple; the caller resolves it via tt(). */
+export interface RelativeTime {
+    key: 'time.justNow' | 'time.minutesAgo' | 'time.hoursAgo' | 'time.daysAgo' | 'time.weeksAgo';
+    value?: number;
+}
+/** Format an epoch-ms timestamp as a short relative time bucket. */
+export declare function formatRelativeTime(ms: number, now?: number): RelativeTime;

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

@@ -0,0 +1,11 @@
+/**
+ * Shared panel helpers: the active-dictionary pick (document-language
+ * based, family precedent) plus a small error-message extractor.
+ */
+import { type HubKey, type TranslateValues } from './locales.ts';
+/** Active dictionary, picked by the document language at call time. */
+export declare function dictionary(): Record<string, string>;
+/** Translate a key with optional {name} template params (current language). */
+export declare function tt(key: HubKey, values?: TranslateValues): string;
+/** Human-readable error text from an unknown thrown value. */
+export declare function errorMessage(error: unknown): string;

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

@@ -0,0 +1,42 @@
+/**
+ * Browser-half entry for the dsh-skill-hub plugin — runs inside the dsh
+ * web GUI.
+ *
+ * Registers the dsh-skill-hub locale dictionaries and mounts two Settings
+ * surfaces, both through official slots (no DOM injection):
+ *  - a plugin-management card in the `settings.plugin.item` slot (Settings →
+ *    插件 → 可配置插件列表), bound to the hub's own /api/skill-hub/config
+ *    route via ApiConfigScope — the family-bucket card pattern
+ *    (PluginSettingsCard + CardForm vendored from dsh-task-board). The host's
+ *    settings service refuses third-party namespaces, so the card never
+ *    touches the settings transport;
+ *  - a top-level Settings section (Settings → 技能) hosting the skill hub
+ *    panel: catalog, search, enable/disable, diagnostics, new-skill form.
+ *
+ * Failure policy: mounting problems are logged, never thrown — the web
+ * shell fails the whole boot when a plugin apply throws, and an external
+ * plugin must not take the GUI down.
+ *
+ * Export discipline (packages/client rule): the /client surface carries
+ * what cordis loading needs plus types only — all value exports stay
+ * internal.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type HubKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** dsh-skill-hub surface copy. */
+        'dsh-skill-hub': HubKey;
+    }
+}
+/** Required services (fiber inject waiting — the runtime must be up first). */
+export declare const inject: string[];
+/** Type-only surface (export discipline: no value exports beyond the plugin contract). */
+export type { SkillHubPanelProps } from './panel/SkillHubPanel.tsx';
+export type { SkillHubSettingsState } from './SkillHubSettingsCard.tsx';
+export type { HubKey } from './locales.ts';
+/**
+ * Mount the settings card and the skill hub section.
+ * @param ctx - client root context (slots, locale).
+ */
+export declare function apply(ctx: ClientContext): void;

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

@@ -0,0 +1,216 @@
+/**
+ * dsh-skill-hub surface copy (zh/en). The dictionary type is re-exported
+ * so the LocaleNamespaceMap module augmentation in client/index.ts can
+ * reference it without a value import.
+ */
+export declare const zh: {
+    readonly 'entry.label': "技能";
+    readonly 'entry.tooltip': "技能中枢：浏览、分组与同步管理本地技能";
+    readonly 'view.sources': "来源";
+    readonly 'view.scenes': "场景";
+    readonly 'view.market': "市场";
+    readonly 'view.flat': "平铺";
+    readonly 'view.grouped': "分组";
+    readonly 'panel.title': "技能中枢";
+    readonly 'panel.count': "共 {count} 个技能";
+    readonly 'panel.disabledCount': "已禁用 {count}";
+    readonly 'panel.new': "新建技能";
+    readonly 'panel.search': "搜索技能…";
+    readonly 'legend.model': "模型可调 — Agent 可自动调用";
+    readonly 'legend.user': "用户可调 — 仅显式点名时触发";
+    readonly 'legend.hint': "圆点标在技能名旁；无圆点表示该技能不可被调用。";
+    readonly 'panel.enabled': "已启用";
+    readonly 'panel.disabled': "已禁用";
+    readonly 'panel.diagnostics': "发现诊断";
+    readonly 'panel.empty': "没有匹配的技能。";
+    readonly 'panel.emptyAll': "本地还没有技能。点击「新建技能」创建第一个。";
+    readonly 'panel.loading': "读取中…";
+    readonly 'panel.incomplete': "（目录可能不完整）";
+    readonly 'market.addHint': "像 codex 一样添加仓库源：输入 owner/repo 或 GitHub 链接，扫描其中的技能并一键导入；导入后自动跟踪上游更新。";
+    readonly 'market.addPlaceholder': "owner/repo 或 https://github.com/…";
+    readonly 'market.addSource': "添加源";
+    readonly 'market.noSources': "还没有市场源。从下方内置市场添加，或输入一个 GitHub 仓库。";
+    readonly 'market.catalogTitle': "内置市场";
+    readonly 'market.catalogHint': "精选技能仓库，添加后即可扫描安装，并持续检查更新。";
+    readonly 'market.catalog.anthropics': "Anthropic 官方技能合集（Claude Skills）";
+    readonly 'market.catalog.superpowers': "Superpowers 社区技能合集";
+    readonly 'market.catalog.mattpocock': "Matt Pocock 技能集";
+    readonly 'market.catalog.openDesign': "设计技能合集（design-templates）";
+    readonly 'market.added': "已添加";
+    readonly 'market.add': "添加";
+    readonly 'market.mySources': "我的市场源";
+    readonly 'market.installed': "已装 {count}";
+    readonly 'market.updatable': "可更新 {count}";
+    readonly 'market.deletedUpstream': "上游已删 {count}";
+    readonly 'market.checkAll': "检查全部";
+    readonly 'market.updateAll': "全部更新";
+    readonly 'market.updateAllConfirmTitle': "批量更新全部技能？";
+    readonly 'market.updateAllConfirmText': "将把以下来源的可更新技能更新到上游最新版本（覆盖本地修改）：";
+    readonly 'market.updateAllItem': "{repo}（{count} 个技能）";
+    readonly 'market.updateAllDone': "已更新 {count} 个来源";
+    readonly 'market.deleteSource': "移除源";
+    readonly 'market.scan': "扫描";
+    readonly 'market.scanning': "扫描中…";
+    readonly 'market.check': "检查";
+    readonly 'market.sync': "同步";
+    readonly 'market.syncing': "同步中…";
+    readonly 'market.updated': "有更新";
+    readonly 'market.newRelease': "新版本 v{version}";
+    readonly 'market.branchTitle': "选择分支";
+    readonly 'market.branchHint': "该仓库没有正式发布，选择要跟踪的分支（默认为 main）：";
+    readonly 'market.branchConfirm': "确定";
+    readonly 'market.syncTitle': "同步本地技能";
+    readonly 'market.syncText': "市场源已对齐到 {ref}，要同步更新以下本地技能吗？";
+    readonly 'market.syncNone': "该来源还没有导入本地技能。";
+    readonly 'market.syncCancel': "跳过";
+    readonly 'market.removeHint': "移除源不影响已安装的技能。";
+    readonly 'repo.ready': "发现 {count} 个可导入技能";
+    readonly 'repo.empty': "没有找到可导入技能。";
+    readonly 'repo.selectAll': "全选";
+    readonly 'repo.clearAll': "清空";
+    readonly 'repo.import': "导入所选 ({count})";
+    readonly 'repo.importing': "导入中…";
+    readonly 'repo.existing': "已存在";
+    readonly 'repo.files': "{count} 个文件 · {size}";
+    readonly 'repo.imported': "导入成功 {count} 个";
+    readonly 'repo.skippedExisting': "跳过已存在 {count} 个";
+    readonly 'repo.failed': "失败 {count} 个";
+    readonly 'repo.root.skills': "技能 skills";
+    readonly 'repo.root.designTemplates': "模板 design-templates";
+    readonly 'update.check': "检查更新";
+    readonly 'update.checking': "检查中…";
+    readonly 'update.upToDate': "已是最新版本 v{version}";
+    readonly 'update.available': "发现新版本 v{version}（当前 v{current}）";
+    readonly 'update.newVersion': "新版本 v{version}";
+    readonly 'update.viewRelease': "查看发布";
+    readonly 'update.error': "检查更新失败：{error}";
+    readonly 'update.unavailable': "暂无可用的发布版本";
+    readonly 'group.project-dsh': "项目 .dsh/skills";
+    readonly 'group.project-agents': "项目 .agents/skills";
+    readonly 'group.custom': "自定义目录";
+    readonly 'group.runtime': "运行时";
+    readonly 'group.user-dsh': "用户 ~/.dsh/skills";
+    readonly 'group.user-agents': "用户 ~/.agents/skills";
+    readonly 'group.bundled': "内置";
+    readonly 'group.other': "其他来源";
+    readonly 'groups.new': "新建场景";
+    readonly 'groups.namePlaceholder': "场景名";
+    readonly 'groups.edit': "编辑";
+    readonly 'groups.rename': "保存名称";
+    readonly 'groups.delete': "删除场景";
+    readonly 'groups.saveMembers': "保存成员";
+    readonly 'groups.membersHint': "勾选技能加入此场景（含已禁用）。";
+    readonly 'groups.empty': "还没有场景。先新建一个，再把技能归类。";
+    readonly 'groups.noCollections': "暂无来源组。从市场导入技能后自动按来源聚合。";
+    readonly 'groups.personal': "个人";
+    readonly 'groups.noWritable': "该组没有可写技能（只读技能无法由中枢开关）";
+    readonly 'groups.closeAll': "全部关闭";
+    readonly 'groups.keepOn': "保留开启";
+    readonly 'groups.conflictTitle': "关闭此组？";
+    readonly 'groups.conflictText': "以下技能也在其他组中开启，关闭它们会影响那些组：";
+    readonly 'filter.allSources': "全部来源";
+    readonly 'filter.private': "个人";
+    readonly 'sort.name': "按名称";
+    readonly 'sort.added': "按添加时间";
+    readonly 'sort.uses': "按调用次数";
+    readonly 'time.justNow': "刚刚";
+    readonly 'time.minutesAgo': "{value} 分钟前";
+    readonly 'time.hoursAgo': "{value} 小时前";
+    readonly 'time.daysAgo': "{value} 天前";
+    readonly 'time.weeksAgo': "{value} 周前";
+    readonly 'badge.source.project-dsh': "项目 .dsh";
+    readonly 'badge.source.project-agents': "项目 .agents";
+    readonly 'badge.source.custom': "自定义";
+    readonly 'badge.source.runtime': "运行时";
+    readonly 'badge.source.user-dsh': "用户 .dsh";
+    readonly 'badge.source.user-agents': "用户 .agents";
+    readonly 'badge.source.bundled': "内置";
+    readonly 'row.readonly': "只读";
+    readonly 'row.disable': "禁用";
+    readonly 'row.enable': "启用";
+    readonly 'row.delete': "移入回收站";
+    readonly 'delete.confirmTitle': "移入回收站？";
+    readonly 'delete.confirmText': "确定把「{name}」移入回收站吗？可随时恢复。";
+    readonly 'delete.confirm': "移入回收站";
+    readonly 'detail.back': "返回列表";
+    readonly 'detail.provider': "提供者";
+    readonly 'detail.addedAt': "添加时间";
+    readonly 'detail.updatedAt': "更新时间";
+    readonly 'detail.path': "路径";
+    readonly 'detail.whenToUse': "适用场景";
+    readonly 'detail.uses': "调用次数";
+    readonly 'detail.groups': "所属场景";
+    readonly 'detail.loading': "读取技能正文…";
+    readonly 'source.private': "个人技能（未绑定上游，不检查更新）";
+    readonly 'source.commit': "已同步版本";
+    readonly 'source.unverified': "尚未核对上游";
+    readonly 'source.check': "检查更新";
+    readonly 'source.checkHint': "点击检查上游更新";
+    readonly 'source.checking': "检查中…";
+    readonly 'source.upToDate': "已是最新";
+    readonly 'source.updated': "有更新 {count} 个";
+    readonly 'source.deleted': "上游已删除 {count} 个";
+    readonly 'source.error': "检查失败";
+    readonly 'source.throttled': "刚刚检查过";
+    readonly 'source.sync': "同步";
+    readonly 'source.syncing': "同步中…";
+    readonly 'source.syncConfirmTitle': "同步技能？";
+    readonly 'source.syncConfirmText': "将用上游最新版本覆盖本地对以下技能的所有修改：";
+    readonly 'source.followDelete': "跟进删除";
+    readonly 'source.deleteConfirmTitle': "跟进上游删除？";
+    readonly 'source.deleteConfirmText': "以下技能已从上游仓库移除，本地目录将移入回收站（可恢复）：";
+    readonly 'source.trash': "回收站";
+    readonly 'source.restore': "恢复";
+    readonly 'source.clearTrash': "清空回收站";
+    readonly 'source.clearTrashConfirmTitle': "清空回收站？";
+    readonly 'source.clearTrashConfirmText': "回收站里的技能会被永久删除，无法恢复。此操作不可撤销。";
+    readonly 'source.clearTrashConfirm': "永久删除";
+    readonly 'form.capabilityHint': "能力怎么选：重复方法 → 技能；外部系统 → MCP；长期资料 → 知识库。";
+    readonly 'form.descPlaceholder': "一句话说明用途（含触发词），Agent 靠它自动激活技能";
+    readonly 'form.name': "技能名（kebab-case，如 code-review）";
+    readonly 'form.desc': "描述（一句话路由说明）";
+    readonly 'form.root': "目标目录";
+    readonly 'form.submit': "创建";
+    readonly 'form.cancel': "取消";
+    readonly 'form.busy': "创建中…";
+    readonly 'form.success': "已创建：";
+    readonly 'form.error': "创建失败：";
+    readonly 'err.dismiss': "知道了";
+    readonly 'settings.title': "Skill Hub";
+    readonly 'settings.description': "管理 dsh 本地技能目录：浏览、分组、来源同步与新建。";
+    readonly 'settings.enabled': "启用插件";
+    readonly 'settings.enabledHint': "关闭后技能中枢的路由、入口与公告全部下线。";
+    readonly 'settings.announceToAgent': "向 Agent 公告";
+    readonly 'settings.announceToAgentHint': "在系统提示中加入本插件说明，用户提到技能管理时 Agent 知道如何协作。";
+    readonly 'settings.dotModelColor': "模型可调圆点颜色";
+    readonly 'settings.dotModelColorHint': "技能名旁蓝色圆点的颜色（#rrggbb）。";
+    readonly 'settings.dotUserColor': "用户可调圆点颜色";
+    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.inherit': "继承";
+    readonly 'settings.on': "开";
+    readonly 'settings.off': "关";
+    readonly 'settings.overridden': "已覆盖";
+    readonly 'settings.reset': "恢复默认";
+    readonly 'settings.unsaved': "未保存";
+    readonly 'settings.save': "保存";
+    readonly 'settings.saving': "保存中…";
+    readonly 'settings.discard': "放弃修改";
+    readonly 'settings.saveFailed': "本部署没有接受这些值，已保留供你修改。";
+    readonly 'settings.readOnly': "本部署的设置为只读。";
+    readonly 'settings.notExposed': "本部署没有挂载该设置命名空间。";
+    readonly 'settings.collapse': "收起设置";
+    readonly 'settings.expand': "展开设置";
+};
+export declare const en: Record<HubKey, string>;
+/** Union of every translatable key (the namespace's registered dictionary type). */
+export type HubKey = keyof typeof zh;
+/** Template values accepted by the interpolator. */
+export type TranslateValues = Record<string, string | number>;
+/** Interpolate a {name} template with the given values. */
+export declare function t(dict: Record<string, string>, key: HubKey, values?: TranslateValues): string;

package/lib/types/client/market-catalog.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Built-in market catalog: well-known skill repos shown on the market tab so
+ * users can browse and install without knowing repo URLs (cc-switch-style).
+ * Only the repo slug lives here; adding goes through the normal
+ * market-source route and records upstream tracking like any manual source.
+ */
+import type { HubKey } from './locales.ts';
+export interface MarketCatalogEntry {
+    repo: string;
+    /** locales.ts key for the one-line description. */
+    descriptionKey: HubKey;
+}
+/** 默认市场目录：精选技能仓库（顺序即展示顺序）。 */
+export declare const MARKET_CATALOG: readonly MarketCatalogEntry[];

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

@@ -0,0 +1,12 @@
+/**
+ * One disabled skill row (name + description + root badge + enable switch).
+ * Shared by the source-group lists, the scene-group lists, and the bottom
+ * disabled section.
+ */
+import type { JSX } from 'react';
+import type { DisabledSkill } from '../../protocol.ts';
+export declare function DisabledRow(props: {
+    record: DisabledSkill;
+    busy: boolean;
+    onEnable: () => void;
+}): JSX.Element;

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

@@ -0,0 +1,10 @@
+/**
+ * Group-header usage summary: total invocation count chip + the group's most
+ * recent last-used time. Honours the showGroupSummary config switch.
+ */
+import type { JSX } from 'react';
+import type { SkillHubState } from './useSkillHub.ts';
+export declare function GroupSummary(props: {
+    members: readonly string[];
+    hub: SkillHubState;
+}): JSX.Element;

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

@@ -0,0 +1,11 @@
+/**
+ * Market tab: the built-in market catalog (one-click add), the user's market
+ * sources with aggregated per-repo state (installed / updatable / deleted
+ * upstream), check-all and update-all actions, and the repo scan result with
+ * the importable skill checklist.
+ */
+import type { JSX } from 'react';
+import type { SkillHubState } from './useSkillHub.ts';
+export declare function MarketView(props: {
+    hub: SkillHubState;
+}): JSX.Element;

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

@@ -0,0 +1,11 @@
+/**
+ * Scenes tab: user tag groups (one card per scene with the tri-state switch
+ * and edit entry) plus the new-scene form. Scenes are the user's own
+ * enable/disable units (e.g. a Godot scene vs a Java scene); upstream repos
+ * are managed in the sources tab.
+ */
+import type { JSX } from 'react';
+import type { SkillHubState } from './useSkillHub.ts';
+export declare function ScenesView(props: {
+    hub: SkillHubState;
+}): JSX.Element;

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

@@ -0,0 +1,31 @@
+/**
+ * Full-page skill detail view: metadata, upstream source card with
+ * check/sync/follow-delete actions, and the raw SKILL.md body. Pure
+ * presentation — every state value and action arrives as a prop, so the
+ * panel stays the single owner of state.
+ */
+import type { JSX } from 'react';
+import type { GroupsResponse, HubConfig, SkillDetail, SourceCheckResult, SourcesResponse } from '../../protocol.ts';
+export interface SkillDetailViewProps {
+    detail: SkillDetail;
+    hubConfig: HubConfig | null;
+    /** skillName → usage stat (count + last used). */
+    uses: ReadonlyMap<string, {
+        count: number;
+        lastUsed?: number;
+    }>;
+    groupsState: GroupsResponse | null;
+    sourcesState: SourcesResponse | null;
+    sourceCheck: Readonly<Record<string, SourceCheckResult>>;
+    checkingSource: string | null;
+    syncingSource: string | null;
+    loading: boolean;
+    onBack: () => void;
+    /** Check one source repo for upstream updates. */
+    onCheck: (repo: string) => void;
+    /** Request syncing the skill (overwrites local edits; opens a confirm). */
+    onSync: (repo: string, skills: string[]) => void;
+    /** Request following the upstream deletion (moves into the trash). */
+    onFollowDelete: (repo: string, skills: string[]) => void;
+}
+export declare function SkillDetailView(props: SkillDetailViewProps): JSX.Element;

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

@@ -0,0 +1,18 @@
+/**
+ * The skill hub panel: catalog grouped by tags + source collections, search
+ * and filter in one row, per-group tri-state switches with conflict dialogs,
+ * upstream source tracking (check / sync / follow upstream deletion into a
+ * restorable trash), codex-style market sources, disabled re-enable,
+ * detail inspection, and the new-skill scaffold form.
+ *
+ * Thin shell: state and flows live in useSkillHub, the tab contents live in
+ * SourcesView / ScenesView / MarketView, and the dialog family lives in
+ * dialogs.tsx. This component owns only the shared chrome (header, banners,
+ * filter bar, shared sections) and the view routing — and holds no hooks,
+ * so the detail / tag-editor early returns are safe.
+ */
+import type { SkillHubApi } from '../api.ts';
+export interface SkillHubPanelProps {
+    api: SkillHubApi;
+}
+export declare function SkillHubPanel(props: SkillHubPanelProps): React.JSX.Element;

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

@@ -0,0 +1,11 @@
+/**
+ * One enabled skill row: name + invocation dots + usage meta, delete and
+ * disable actions. Shared by the flat list and both grouped views.
+ */
+import type { JSX } from 'react';
+import type { CatalogSkill } from '../../protocol.ts';
+import type { SkillHubState } from './useSkillHub.ts';
+export declare function SkillRow(props: {
+    skill: CatalogSkill;
+    hub: SkillHubState;
+}): JSX.Element;