dsh-skill-hub 0.3.6 → 0.3.7

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

@@ -64,12 +64,22 @@ export declare const zh: {
     readonly 'market.branchTitle': "选择分支";
     readonly 'market.branchHint': "该仓库没有正式发布，选择要跟踪的分支（默认为 main）：";
     readonly 'market.branchConfirm': "确定";
+    readonly 'market.versionTitle': "切换跟踪版本";
+    readonly 'market.versionText': "选择 {repo} 要跟踪的版本，切换后建议重新扫描并同步已装技能";
+    readonly 'market.versionCurrent': "当前 {ref}";
+    readonly 'market.versionReleases': "发布版";
+    readonly 'market.versionBranches': "分支";
+    readonly 'market.versionCustom': "自定义（tag / 分支 / commit）";
+    readonly 'market.versionConfirm': "切换到 {ref}";
+    readonly 'market.versionHint': "点击切换跟踪版本";
+    readonly 'market.unpinned': "未定版";
     readonly 'market.syncTitle': "同步本地技能";
     readonly 'market.syncText': "市场源已对齐到 {ref}，要同步更新以下本地技能吗？";
     readonly 'market.syncNone': "该来源还没有导入本地技能。";
     readonly 'market.syncCancel': "跳过";
     readonly 'market.removeHint': "移除源不影响已安装的技能。";
     readonly 'repo.ready': "发现 {count} 个可导入技能";
+    readonly 'repo.truncated': "⚠ 仓库过大，仅展示部分技能（GitHub 截断），可缩小仓库或指定子目录";
     readonly 'repo.empty': "没有找到可导入技能。";
     readonly 'repo.selectAll': "全选";
     readonly 'repo.clearAll': "清空";
@@ -142,6 +152,26 @@ export declare const zh: {
     readonly 'row.enable': "启用";
     readonly 'row.delete': "移入回收站";
     readonly 'row.open': "查看 {name} 详情（回车）";
+    readonly 'row.duplicate': "重名";
+    readonly 'row.duplicateHint': "同名技能存在多个来源，当前显示为优先级最高的版本";
+    readonly 'row.copy': "复制";
+    readonly 'row.copyMention': "复制 $mention";
+    readonly 'row.copied': "已复制";
+    readonly 'row.copyPath': "复制路径";
+    readonly 'detail.copyMention': "复制 $mention";
+    readonly 'detail.copyPath': "复制路径";
+    readonly 'detail.copied': "已复制";
+    readonly 'diag.fix': "修复";
+    readonly 'diag.fixing': "修复中…";
+    readonly 'diag.fixed': "已修复";
+    readonly 'diag.fixConfirm': "用自动修复重写以下文件的 frontmatter？建议先备份：{path}";
+    readonly 'filter.invocation': "调用";
+    readonly 'filter.invocationAll': "全部调用";
+    readonly 'filter.modelOnly': "模型可调";
+    readonly 'filter.userOnly': "用户可调";
+    readonly 'filter.showing': "显示 {shown}/{total}（已启用）{filtered}";
+    readonly 'filter.filteredSuffix': " · 已筛选";
+    readonly 'filter.shortened': "短描述 {count} 条，悬浮看全文";
     readonly 'delete.confirmTitle': "移入回收站？";
     readonly 'delete.confirmText': "确定把「{name}」移入回收站吗？可随时恢复。";
     readonly 'delete.confirm': "移入回收站";

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

@@ -9,4 +9,6 @@ export declare function DisabledRow(props: {
     record: DisabledSkill;
     busy: boolean;
     onEnable: () => void;
+    duplicate?: boolean;
+    onOpen?: () => void;
 }): JSX.Element;

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

@@ -4,7 +4,7 @@
  * 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 JSX } from 'react';
 import type { GroupsResponse, HubConfig, SkillDetail, SourceCheckResult, SourcesResponse } from '../../protocol.ts';
 export interface SkillDetailViewProps {
     detail: SkillDetail;
@@ -20,6 +20,10 @@ export interface SkillDetailViewProps {
     checkingSource: string | null;
     syncingSource: string | null;
     loading: boolean;
+    /** Whether the skill is currently hub-disabled (served from the .disabled file). */
+    disabled?: boolean;
+    /** Re-enable a hub-disabled skill. */
+    onEnable?: () => void;
     onBack: () => void;
     /** Check one source repo for upstream updates. */
     onCheck: (repo: string) => void;

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

@@ -27,6 +27,16 @@ export interface BranchChoiceState {
     branches: string[];
     selected: string;
 }
+/** Version picker for a market source: releases + branches + custom ref. */
+export interface VersionChoiceState {
+    repo: string;
+    current?: string;
+    releases: string[];
+    branches: string[];
+    selected: string;
+    custom: string;
+    loading: boolean;
+}
 /** Post-sync skill update dialog: which tracked skills to refresh. */
 export interface MarketSyncDialogState {
     repo: string;
@@ -63,6 +73,15 @@ export declare function BranchChoiceDialog(props: {
     onCancel: () => void;
     onConfirm: () => void;
 }): JSX.Element;
+/** Version picker: switch a market source's tracked ref (release / branch / custom). */
+export declare function VersionChoiceDialog(props: {
+    choice: VersionChoiceState;
+    busy: boolean;
+    onSelect: (ref: string) => void;
+    onCustom: (custom: string) => void;
+    onCancel: () => void;
+    onConfirm: () => void;
+}): JSX.Element;
 /** Post-sync selection: which tracked skills to batch-update to the new version. */
 export declare function MarketSyncDialog(props: {
     dialog: MarketSyncDialogState;

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

@@ -9,7 +9,7 @@ import { type FormEvent } from 'react';
 import type { CatalogResponse, CatalogSkill, DisabledSkill, GroupsResponse, HubConfig, MarketSourceRecord, RepoDiscoverResponse, RepoImportProgressResponse, SkillDetail, SkillTag, SourceCheckResult, SourcesResponse, UpdateCheckResponse, WritableRoot } from '../../protocol.ts';
 import type { SkillHubApi } from '../api.ts';
 import { type SortKey, type GroupSwitchState } from '../grouping.ts';
-import type { BranchChoiceState, ConfirmDialogState, ConflictDialogState, MarketSyncDialogState } from './dialogs.tsx';
+import type { BranchChoiceState, ConfirmDialogState, ConflictDialogState, MarketSyncDialogState, VersionChoiceState } from './dialogs.tsx';
 /** One-shot self-update check state. */
 type UpdateState = {
     status: 'idle';
@@ -76,6 +76,7 @@ export declare function useSkillHub(api: SkillHubApi): {
     tab: "sources" | "scenes" | "market";
     skillView: "flat" | "groups";
     sourceFilter: string;
+    invocationFilter: "user" | "model" | "all";
     sortKey: SortKey;
     marketState: MarketState;
     marketCheck: Readonly<Record<string, {
@@ -117,6 +118,8 @@ export declare function useSkillHub(api: SkillHubApi): {
     subdividedProjects: ReadonlySet<string>;
     showLegend: boolean;
     editMode: boolean;
+    versionDialog: VersionChoiceState | null;
+    versionBusy: boolean;
     actionNames: Set<string>;
     viewNames: Set<string>;
     normalized: string;
@@ -124,6 +127,7 @@ export declare function useSkillHub(api: SkillHubApi): {
     sourceOptions: string[];
     filtered: CatalogSkill[];
     sorted: CatalogSkill[];
+    shortenedCount: number;
     setLoadError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     setSuccessBanner: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     setSearch: import("react").Dispatch<import("react").SetStateAction<string>>;
@@ -141,6 +145,7 @@ export declare function useSkillHub(api: SkillHubApi): {
     setTab: import("react").Dispatch<import("react").SetStateAction<"sources" | "scenes" | "market">>;
     setSkillView: import("react").Dispatch<import("react").SetStateAction<"flat" | "groups">>;
     setSourceFilter: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setInvocationFilter: import("react").Dispatch<import("react").SetStateAction<"user" | "model" | "all">>;
     setSortKey: import("react").Dispatch<import("react").SetStateAction<SortKey>>;
     setBranchChoice: import("react").Dispatch<import("react").SetStateAction<BranchChoiceState | null>>;
     setMarketSyncDialog: import("react").Dispatch<import("react").SetStateAction<MarketSyncDialogState | null>>;
@@ -161,6 +166,7 @@ export declare function useSkillHub(api: SkillHubApi): {
     setEditSearch: import("react").Dispatch<import("react").SetStateAction<string>>;
     setShowLegend: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     setEditMode: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setVersionDialog: import("react").Dispatch<import("react").SetStateAction<VersionChoiceState | null>>;
     toggleGroupCollapse: (key: string) => void;
     toggleSubdivide: (key: string) => void;
     checkUpdate: () => Promise<void>;
@@ -177,6 +183,11 @@ export declare function useSkillHub(api: SkillHubApi): {
     requestDelete: (repo: string, skills: string[]) => void;
     restoreTrash: (name: string) => Promise<void>;
     clearTrash: () => Promise<void>;
+    fixingPaths: ReadonlySet<string>;
+    fixDiagnostic: (path: string) => Promise<void>;
+    clearListFilters: () => void;
+    openVersionDialog: (repo: string) => Promise<void>;
+    confirmVersionDialog: () => Promise<void>;
     requestDeleteSkill: (name: string) => void;
     runDeleteSkill: () => Promise<void>;
     requestDeleteGroup: (name: string, skillNames: string[]) => void;

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

@@ -30,23 +30,6 @@ export interface PluginSettingsCardProps {
  * @returns the card, or nothing while the namespace is still loading.
  */
 export declare function PluginSettingsCard(props: PluginSettingsCardProps): ReactElement | null;
-/** One staged boolean field: 继承 / 开 / 关. */
-export interface BooleanFieldProps {
-    id: string;
-    label: string;
-    hint: string;
-    inheritLabel: string;
-    onLabel: string;
-    offLabel: string;
-    overriddenLabel: string;
-    resetLabel: string;
-    disabled: boolean;
-    text: string;
-    overridden: boolean;
-    onEdit: (text: string) => void;
-    onReset: () => void;
-}
-export declare function BooleanField(props: BooleanFieldProps): ReactElement;
 /**
  * A compact sliding switch for the card's master enable/disable control.
  * An empty text value means the field inherits its default; the switch still

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

@@ -98,7 +98,6 @@ export declare class CardForm {
     private specOf;
     private sectionValue;
     private baseValue;
-    private userLayer;
     private stored;
     private publish;
 }

package/lib/types/protocol.d.ts

@@ -38,6 +38,8 @@ export declare const SKILL_HUB_API: {
     readonly sourceDelete: "/api/skill-hub/sources/delete";
     readonly sourceRestore: "/api/skill-hub/sources/restore";
     readonly sourceTrashClear: "/api/skill-hub/sources/trash/clear";
+    readonly diagnosticFix: "/api/skill-hub/diagnostic/fix";
+    readonly marketSourceVersions: "/api/skill-hub/market/source/versions";
 };
 /** User-level roots the hub may write to (matches dsh-skill-filesystem ranks 400/500). */
 export type WritableRoot = 'user-dsh' | 'user-agents';
@@ -67,6 +69,13 @@ export interface CatalogSkill {
     workspace?: string;
     /** 工作区显示标题（来自 workspace.json；无则回退为路径）。 */
     workspaceTitle?: string;
+    /** UI metadata from agents/openai.yaml (mirrors codex SkillInterface). */
+    displayName?: string;
+    shortDescription?: string;
+    brandColor?: string;
+    iconSmall?: string;
+    iconLarge?: string;
+    defaultPrompt?: string;
 }
 /** One disabled skill tracked by the hub sidecar (SKILL.md renamed away). */
 export interface DisabledSkill {
@@ -82,6 +91,16 @@ export interface DiagnosticEntry {
     path: string;
     root: string;
     reason: string;
+    /** Whether this diagnostic can be auto-fixed (e.g. unquoted colon). */
+    fixable?: boolean;
+}
+/** POST /api/skill-hub/diagnostic/fix — repair a fixable diagnostic in place. */
+export interface DiagnosticFixRequest {
+    path: string;
+}
+export interface DiagnosticFixResponse {
+    ok: true;
+    path: string;
 }
 /** GET /api/skill-hub/catalog */
 export interface CatalogResponse {
@@ -96,6 +115,8 @@ export interface CatalogResponse {
     disabled: DisabledSkill[];
     /** Files in the writable roots the provider ignores, with reasons. */
     diagnostics: DiagnosticEntry[];
+    /** Skill names that appeared in multiple roots (first wins, others hidden). Mirrors codex name_counts. */
+    duplicateNames?: string[];
 }
 /** GET /api/skill-hub/skill */
 export interface SkillDetail {
@@ -112,6 +133,12 @@ export interface SkillDetail {
     updatedAt?: number;
     /** Markdown instruction body. */
     content: string;
+    displayName?: string;
+    shortDescription?: string;
+    brandColor?: string;
+    iconSmall?: string;
+    iconLarge?: string;
+    defaultPrompt?: string;
 }
 export interface SkillDetailResponse {
     ok: true;
@@ -342,6 +369,17 @@ export interface MarketSourceRefRequest {
     /** Release tag or branch name chosen for the repo. */
     ref: string;
 }
+/** GET /api/skill-hub/market/source/versions?repo= — releases + branches for the version picker. */
+export interface MarketSourceVersionsResponse {
+    ok: true;
+    repo: string;
+    /** Currently pinned ref, when one is recorded. */
+    current?: string;
+    /** Release tags, newest first (drafts excluded). */
+    releases: string[];
+    /** Branch names, default branch first. */
+    branches: string[];
+}
 /** GET /api/skill-hub/market/check — update check over market sources. */
 export interface MarketCheckResponse {
     ok: true;
@@ -404,6 +442,8 @@ export interface RepoDiscoverResponse {
     /** Branch names to choose from when ref is null (default branch first). */
     branches?: string[];
     entries: RepoSkillEntry[];
+    /** GitHub truncated the tree; discovery is partial (mirrors codex walk_truncated). */
+    truncated?: boolean;
 }
 /** POST /api/skill-hub/repo/import — install selected repo skills. */
 export interface RepoImportRequest {
@@ -461,23 +501,6 @@ export interface RepoImportCancelResponse {
     jobId: string;
     status: 'cancelled' | 'done';
 }
-/** @deprecated 旧同步响应，保留供类型兼容，实际已由 Progress 代替 */
-export interface RepoImportLegacyResponse {
-    ok: true;
-    imported: Array<{
-        name: string;
-        origin: string;
-        path: string;
-    }>;
-    skipped: Array<{
-        name: string;
-        reason: 'exists';
-    }>;
-    failed: Array<{
-        name: string;
-        error: string;
-    }>;
-}
 /** GET /api/skill-hub/update — check the plugin's own latest GitHub release. */
 export interface UpdateCheckResponse {
     ok: true;

package/lib/types/repo.d.ts

@@ -36,6 +36,7 @@ export declare class RepoFetchError extends Error {
 export declare function setGithubToken(token: string | undefined): void;
 /** Authorization header for api.github.com / raw.githubusercontent.com calls. */
 export declare function githubAuthHeaders(): Record<string, string>;
+export declare function clearEtagCache(): void;
 /**
  * Build a RepoFetchError; when the response shows an exhausted rate limit,
  * report the reset time instead of a bare HTTP status.
@@ -48,15 +49,10 @@ export declare function repoSlug(ref: RepoRef): string;
  * Only github.com URLs are accepted in v1.
  */
 export declare function normalizeRepoInput(input: string): RepoRef | null;
-/**
- * Load repo metadata and the recursive git tree at the given ref. The meta
- * request always resolves the default branch (used when ref is absent); the
- * tree is fetched at `ref ?? default_branch` so an explicit branch/tag scans
- * the exact same content a later download would fetch.
- */
 export declare function loadRepoTree(repo: string, ref?: string, fetchImpl?: typeof fetch): Promise<{
     ref: string;
     tree: RepoTreeItem[];
+    truncated: boolean;
 }>;
 /** Collect every file inside a skill directory, including SKILL.md itself. */
 export declare function collectRepoSkillFiles(tree: readonly RepoTreeItem[], dir: string): RepoFile[];
@@ -94,6 +90,8 @@ export declare function cleanupLeftoverImportDirs(targetRoot: string): Promise<n
  * repo has no releases (GitHub's /releases/latest skips prereleases/drafts).
  */
 export declare function getLatestReleaseTag(repo: string, fetchImpl?: typeof fetch): Promise<string | undefined>;
+/** Release tags of a repo, newest first (skips drafts, keeps prereleases). */
+export declare function listRepoReleases(repo: string, fetchImpl?: typeof fetch): Promise<string[]>;
 /** Branch names of a repo, default branch first (one GitHub API request). */
 export declare function listRepoBranches(repo: string, fetchImpl?: typeof fetch): Promise<string[]>;
 /**

package/lib/types/skillfs.d.ts

@@ -65,6 +65,10 @@ export declare function parseFrontmatter(text: string): {
 } | {
     error: string;
 };
+/** Try to repair a SKILL.md's frontmatter in place (unquoted colon etc.). Returns the new file text or null when not fixable. */
+export declare function repairFrontmatterFileText(text: string): string | null;
+/** Repair one file on disk when its frontmatter is auto-fixable. Returns the new text. */
+export declare function fixDiagnosticFile(path: string, home?: string): Promise<string>;
 /** One discoverable skill file in a scanned root. */
 export interface SkillEntry {
     /** Absolute path of the discovery file (SKILL.md or the flat .md). */
@@ -81,6 +85,15 @@ export interface SkillEntry {
 export declare function scanRoot(base: string): Promise<SkillEntry[]>;
 /** Scan one writable root. */
 export declare function listSkillEntries(root: WritableRoot, home?: string): Promise<SkillEntry[]>;
+/** Read UI metadata from `agents/openai.yaml` beside a directory skill (mirrors codex SkillInterface). */
+export declare function readSkillInterface(directory: string): Promise<{
+    displayName?: string;
+    shortDescription?: string;
+    brandColor?: string;
+    iconSmall?: string;
+    iconLarge?: string;
+    defaultPrompt?: string;
+} | undefined>;
 /**
  * Walk up from cwd (max 32 levels) for a project marker (.dsh or .git);
  * falls back to cwd itself. The provider roots project skills here.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-skill-hub",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "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": {
@@ -65,7 +65,8 @@
         "0.1.1-rc.2",
         "0.1.2-alpha.2",
         "0.1.2-alpha.3",
-        "0.1.2-alpha.4"
+        "0.1.2-alpha.4",
+        "0.1.2-alpha.5"
       ]
     },
     "capability": {
@@ -87,19 +88,19 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1 || ^4.0.2",
-    "@deepseek-ai/dsh-client-connection": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
-    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
-    "@deepseek-ai/dsh-client-store": ">=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-input-trigger": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
-    "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
-    "@deepseek-ai/dsh-session": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
-    "@deepseek-ai/dsh-session-query": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
-    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
-    "@deepseek-ai/dsh-skill": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
-    "@deepseek-ai/dsh-system-prompt": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0",
+    "@deepseek-ai/dsh-client-connection": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
+    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
+    "@deepseek-ai/dsh-client-store": ">=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-input-trigger": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
+    "@deepseek-ai/dsh-session": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
+    "@deepseek-ai/dsh-session-query": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
+    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
+    "@deepseek-ai/dsh-skill": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
+    "@deepseek-ai/dsh-system-prompt": ">=0.1.0-rc.7 <0.2.0-0 || >=0.1.1-rc.2 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.2-alpha.3 <0.2.0-0 || >=0.1.2-alpha.4 <0.2.0-0 || >=0.1.2-alpha.5 <0.2.0-0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
@@ -113,19 +114,19 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-session-query": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-skill": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-session-query": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-skill": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.5",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",

package/src/client/SkillHubSettingsCard.tsx

@@ -14,8 +14,6 @@ import { ColorField, NumberField, PluginSettingsCard, SwitchField } from './sett
 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.
-export { DEFAULT_DOT_MODEL_COLOR, DEFAULT_DOT_USER_COLOR }
 
 /** The card's projected state. */
 export interface SkillHubSettingsState extends CardShell {

package/src/client/api.ts

@@ -19,6 +19,7 @@ import {
   type MarketSourceRequest,
   type MarketSourceResponse,
   type MarketSourcesResponse,
+  type MarketSourceVersionsResponse,
   type MarketSyncResponse,
   type RepoDiscoverResponse,
   type RepoImportCancelResponse,
@@ -193,6 +194,13 @@ export class SkillHubApi {
     return readJson<MarketSyncResponse>(response)
   }
 
+  /** Releases + branches of a market source for the version picker. */
+  async marketSourceVersions(repo: string): Promise<MarketSourceVersionsResponse> {
+    const url = SKILL_HUB_API.marketSourceVersions + '?repo=' + encodeURIComponent(repo)
+    const response = await fetchWithTimeout(url)
+    return readJson<MarketSourceVersionsResponse>(response)
+  }
+
   /** Pin a market source to an explicit ref (branch picker). */
   async setMarketSourceRef(repo: string, ref: string): Promise<MarketSourcesResponse> {
     const response = await fetchWithTimeout(SKILL_HUB_API.marketSourceRef, {
@@ -387,4 +395,14 @@ export class SkillHubApi {
     const response = await fetchWithTimeout(SKILL_HUB_API.sourceTrashClear, { method: 'POST' })
     return readJson<SourceTrashClearResponse>(response)
   }
+
+  /** Auto-fix a fixable diagnostic (e.g. unquoted colon). */
+  async fixDiagnostic(path: string): Promise<import('../protocol.ts').DiagnosticFixResponse> {
+    const response = await fetchWithTimeout(SKILL_HUB_API.diagnosticFix, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ path } satisfies import('../protocol.ts').DiagnosticFixRequest),
+    })
+    return readJson<import('../protocol.ts').DiagnosticFixResponse>(response)
+  }
 }

package/src/client/helpers.ts

@@ -21,3 +21,43 @@ export function errorMessage(error: unknown): string {
   return String(error)
 }
 
+/**
+ * Whether a displayName is worth showing beside the kebab-case name.
+ * Pure case/punctuation variants (e.g. "Code Review" vs "code-review") are redundant.
+ */
+export function isDisplayNameDistinct(name: string, displayName: string | undefined): displayName is string {
+  if (displayName === undefined) return false
+  const normalize = (s: string): string => s.toLowerCase().replace(/[^a-z0-9\u4e00-\u9fff]+/g, '')
+  return normalize(displayName) !== normalize(name)
+}
+
+/**
+ * Copy text to the clipboard. Uses the async API with a positioned-textarea
+ * fallback for insecure contexts. Resolves true only when the copy succeeded.
+ */
+export async function copyTextToClipboard(text: string): Promise<boolean> {
+  if (navigator.clipboard?.writeText !== undefined) {
+    try {
+      await navigator.clipboard.writeText(text)
+      return true
+    } catch {
+      // Fall through to the legacy path below.
+    }
+  }
+  try {
+    const ta = document.createElement('textarea')
+    ta.value = text
+    ta.setAttribute('readonly', '')
+    ta.style.position = 'fixed'
+    ta.style.top = '0'
+    ta.style.opacity = '0'
+    document.body.appendChild(ta)
+    ta.select()
+    const ok = document.execCommand('copy')
+    ta.remove()
+    return ok
+  } catch {
+    return false
+  }
+}
+