dsh-skill-hub 0.3.7 → 0.3.8

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

@@ -20,6 +20,7 @@ export interface SkillHubSettingsState extends CardShell {
     showGroupSummary: FieldState;
     statsWindowDays: FieldState;
     statsScanMinutes: FieldState;
+    githubToken: FieldState;
 }
 /** The business face the card's slot registration injects. */
 export interface SkillHubSettingsCardFace {

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

@@ -2,13 +2,17 @@
  * 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 CollectionGroup, type ConfigRequest, type ConfigResponse, type CreateRequest, type CreateResponse, type MarketCheckResponse, type MarketSourcesResponse, type MarketSourceVersionsResponse, type MarketSyncResponse, type RepoDiscoverResponse, type RepoImportCancelResponse, type RepoImportProgressResponse, type RepoImportResponse, type SkillDetail, type SkillDeleteResponse, type SkillTag, type SourceCheckResponse, type SourceDeleteResponse, type SourceRestoreResponse, type SourceTrashClearResponse, type SourcesResponse, type SourceSyncResponse, type StatsResponse, type ToggleBatchResponse, type UpdateCheckResponse } from '../protocol.ts';
+import { type CatalogResponse, type CollectionGroup, type ConfigRequest, type ConfigResponse, type CreateRequest, type CreateResponse, type DiagnosticFixResponse, type GroupsResponse, type MarketCheckResponse, type MarketSourcesResponse, type MarketSourceVersionsResponse, type MarketStatsResponse, type MarketSyncResponse, type RepoDiscoverResponse, type RepoImportCancelResponse, type RepoImportProgressResponse, type RepoImportResponse, type SkillDetail, type SkillDeleteResponse, type SkillTag, type SourceCheckResponse, type SourceDeleteResponse, type SourceRestoreResponse, type SourceTrashClearResponse, type SourcesResponse, type SourceSyncResponse, type StatsResponse, type TagSaveRequest, 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 {
+    /** One GET round trip (query already encoded by the caller). */
+    private get;
+    /** One POST round trip (body omitted for routes that take none). */
+    private post;
     /** Catalog lookup options (cwd selects a workspace's project skills). */
     catalog(options?: {
         cwd?: string;
@@ -31,6 +35,8 @@ export declare class SkillHubApi {
     addMarketSource(repo: string): Promise<MarketSourcesResponse>;
     /** Remove a market source repo; resolves with the fresh list. */
     removeMarketSource(repo: string): Promise<MarketSourcesResponse>;
+    /** Stars + downloads per market source (hourly server-side cache; refresh=1 refetches stale entries). */
+    marketStats(refresh?: boolean): Promise<MarketStatsResponse>;
     /** Check every market source for updates (throttled server-side). */
     marketCheck(): Promise<MarketCheckResponse>;
     /** Align a market source to its pinned ref; resolves with tracked skills. */
@@ -54,13 +60,13 @@ export declare class SkillHubApi {
     /** Patch the hub's runtime config (null clears a saved override). */
     saveConfig(patch: ConfigRequest): Promise<ConfigResponse>;
     /** 用户 tag 分组 + 系统集合组 + origin 映射。 */
-    groups(): Promise<import('../protocol.ts').GroupsResponse>;
+    groups(): Promise<GroupsResponse>;
     /** 新建（无 id）或重命名（带 id）一个 tag 分组；返回全部 tag。 */
-    saveTag(payload: import('../protocol.ts').TagSaveRequest): Promise<import('../protocol.ts').SkillTag[]>;
+    saveTag(payload: TagSaveRequest): Promise<SkillTag[]>;
     /** 删除一个 tag 分组；返回全部 tag。 */
-    deleteTag(id: string): Promise<import('../protocol.ts').SkillTag[]>;
+    deleteTag(id: string): Promise<SkillTag[]>;
     /** 直接设置某 tag 的完整成员列表；返回全部 tag。 */
-    setTagMembers(id: string, skillNames: string[]): Promise<import('../protocol.ts').SkillTag[]>;
+    setTagMembers(id: string, skillNames: string[]): Promise<SkillTag[]>;
     /** 拖拽重排场景分组 */
     reorderTags(orderedIds: string[]): Promise<SkillTag[]>;
     /** 拖拽重排来源集合 */
@@ -80,5 +86,5 @@ export declare class SkillHubApi {
     /** Permanently delete every skill currently in the trash. */
     clearTrash(): Promise<SourceTrashClearResponse>;
     /** Auto-fix a fixable diagnostic (e.g. unquoted colon). */
-    fixDiagnostic(path: string): Promise<import('../protocol.ts').DiagnosticFixResponse>;
+    fixDiagnostic(path: string): Promise<DiagnosticFixResponse>;
 }

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

@@ -3,7 +3,6 @@
  * 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;

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

@@ -0,0 +1,52 @@
+/** 面板框架与通用：入口/视图切换/面板/图例/报错/更新检查/新建表单/诊断修复。从 locales.ts 按前缀拆出，键集合不变。 */
+export declare const zhCommon: {
+    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 'panel.workspacePlaceholder': "工作区路径（回车应用）";
+    readonly 'panel.workspaceHint': "填写项目路径后，面板同时显示该项目 .dsh/skills 与 .agents/skills 下的技能（只读）；留空回车恢复用户级视图。";
+    readonly 'panel.workspaceClear': "清除工作区";
+    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 'diag.fix': "修复";
+    readonly 'diag.fixing': "修复中…";
+    readonly 'diag.fixed': "已修复";
+    readonly 'diag.fixConfirm': "用自动修复重写以下文件的 frontmatter？建议先备份：{path}";
+    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': "知道了";
+};
+export declare const enCommon: Record<keyof typeof zhCommon, string>;

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

@@ -0,0 +1,16 @@
+/** 技能详情。从 locales.ts 按前缀拆出，键集合不变。 */
+export declare const zhDetail: {
+    readonly 'detail.copyMention': "复制 $mention";
+    readonly 'detail.copyPath': "复制路径";
+    readonly 'detail.copied': "已复制";
+    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': "读取技能正文…";
+};
+export declare const enDetail: Record<keyof typeof zhDetail, string>;

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

@@ -0,0 +1,73 @@
+/** 市场与仓库扫描导入。从 locales.ts 按前缀拆出，键集合不变。 */
+export declare const zhMarket: {
+    readonly 'market.addPlaceholder': "owner/repo 或 https://github.com/…";
+    readonly 'market.addSource': "添加源";
+    readonly 'market.noSources': "还没有市场源。从下方内置市场添加，或输入一个 GitHub 仓库。";
+    readonly 'market.title': "市场";
+    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.add': "添加";
+    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.checkUpdate': "检查更新";
+    readonly 'market.checking': "检查中…";
+    readonly 'market.upToDate': "已是最新";
+    readonly 'market.update': "更新";
+    readonly 'market.updateCount': "更新 {count} 个";
+    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.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.starsHint': "GitHub 星标 {count} 个";
+    readonly 'market.downloadsHint': "发布附件累计下载 {count} 次";
+    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': "清空";
+    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.cancel': "取消";
+    readonly 'repo.cancelled': "已取消 · 已导入 {imported}/{total} 已保留，临时文件已清理";
+    readonly 'repo.importingCurrent': "正在导入: {name} ({done}/{total})";
+    readonly 'repo.root.skills': "技能 skills";
+    readonly 'repo.root.designTemplates': "模板 design-templates";
+    readonly 'repo.root.generic': "{root}";
+};
+export declare const enMarket: Record<keyof typeof zhMarket, string>;

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

@@ -0,0 +1,41 @@
+/** 设置卡。从 locales.ts 按前缀拆出，键集合不变。 */
+export declare const zhSettings: {
+    readonly 'settings.title': "技能中枢";
+    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.statsWindowDays': "统计窗口（天）";
+    readonly 'settings.statsWindowDaysHint': "只统计最近 N 天的使用次数，默认 14 天；0 = 全部历史。改动立即生效。";
+    readonly 'settings.statsScanMinutes': "自动统计间隔（分钟）";
+    readonly 'settings.statsScanMinutesHint': "后台扫描会话日志的间隔，最小 1 分钟；扫描耗时会自动拉长间隔。";
+    readonly 'settings.githubToken': "GitHub Token";
+    readonly 'settings.githubTokenHint': "市场/来源走 GitHub API，匿名每小时 60 次，填 token 后 5000 次。细粒度 token 无需任何权限。明文存本地设置，仅回环可读；留空即匿名（或跟随 GITHUB_TOKEN 环境变量）。";
+    readonly 'settings.githubTokenPlaceholder': "ghp_… / github_pat_…（留空为匿名）";
+    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 enSettings: Record<keyof typeof zhSettings, string>;

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

@@ -0,0 +1,65 @@
+/** 技能浏览：行徽章/分组/场景/过滤排序/相对时间。从 locales.ts 按前缀拆出，键集合不变。 */
+export declare const zhSkills: {
+    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.project': "项目级";
+    readonly 'groups.subdivide': "细分";
+    readonly 'groups.merge': "合并";
+    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 'row.open': "查看 {name} 详情（回车）";
+    readonly 'row.duplicate': "重名";
+    readonly 'row.duplicateHint': "同名技能存在多个来源，当前显示为优先级最高的版本";
+    readonly 'row.copy': "复制";
+    readonly 'row.copyMention': "复制 $mention";
+    readonly 'row.copied': "已复制";
+    readonly 'row.copyPath': "复制路径";
+    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} 条，悬浮看全文";
+};
+export declare const enSkills: Record<keyof typeof zhSkills, string>;

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

@@ -0,0 +1,35 @@
+/** 来源跟踪与回收站（含删除确认）。从 locales.ts 按前缀拆出，键集合不变。 */
+export declare const zhSources: {
+    readonly 'delete.confirmTitle': "移入回收站？";
+    readonly 'delete.confirmText': "确定把「{name}」移入回收站吗？可随时恢复。";
+    readonly 'delete.confirm': "移入回收站";
+    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.deleteGroup': "删除整组";
+    readonly 'source.deleteGroupHint': "删除该分组下的全部 {count} 个技能";
+    readonly 'source.deleteGroupTitle': "删除整组？";
+    readonly 'source.deleteGroupText': "将把分组“{name}”下的全部 {count} 个技能移入回收站（可恢复），只读技能会跳过：";
+    readonly 'source.trash': "回收站";
+    readonly 'source.restore': "恢复";
+    readonly 'source.clearTrash': "清空回收站";
+    readonly 'source.clearTrashConfirmTitle': "清空回收站？";
+    readonly 'source.clearTrashConfirmText': "回收站里的技能会被永久删除，无法恢复。此操作不可撤销。";
+    readonly 'source.clearTrashConfirm': "永久删除";
+};
+export declare const enSources: Record<keyof typeof zhSources, string>;