dsh-skill-hub 0.3.7 → 0.3.8

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

@@ -1,34 +1,90 @@
 /**
- * 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.
+ *  locales 按视图拆分后的聚合入口：各域字典在 ./locales/<domain>.ts，
+ *  这里合并为面板消费的 zh/en。老 `from './locales.ts'` 写法保持可用，
+ *  HubKey 的完备性仍由 `en: Record<HubKey, string>` 在类型层兜底
+ *  （缺键即编译报错）。
  */
 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 'panel.workspacePlaceholder': "工作区路径（回车应用）";
-    readonly 'panel.workspaceHint': "填写项目路径后，面板同时显示该项目 .dsh/skills 与 .agents/skills 下的技能（只读）；留空回车恢复用户级视图。";
-    readonly 'panel.workspaceClear': "清除工作区";
+    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': "展开设置";
+    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': "读取技能正文…";
+    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': "永久删除";
     readonly 'market.addPlaceholder': "owner/repo 或 https://github.com/…";
     readonly 'market.addSource': "添加源";
     readonly 'market.noSources': "还没有市场源。从下方内置市场添加，或输入一个 GitHub 仓库。";
@@ -73,6 +129,8 @@ export declare const zh: {
     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': "该来源还没有导入本地技能。";
@@ -96,14 +154,6 @@ export declare const zh: {
     readonly 'repo.root.skills': "技能 skills";
     readonly 'repo.root.designTemplates': "模板 design-templates";
     readonly 'repo.root.generic': "{root}";
-    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': "自定义目录";
@@ -158,13 +208,6 @@ export declare const zh: {
     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': "模型可调";
@@ -172,46 +215,43 @@ export declare const zh: {
     readonly 'filter.showing': "显示 {shown}/{total}（已启用）{filtered}";
     readonly 'filter.filteredSuffix': " · 已筛选";
     readonly 'filter.shortened': "短描述 {count} 条，悬浮看全文";
-    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.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': "永久删除";
+    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）";
@@ -223,44 +263,10 @@ export declare const zh: {
     readonly 'form.success': "已创建：";
     readonly 'form.error': "创建失败：";
     readonly 'err.dismiss': "知道了";
-    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.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;
+export declare const en: Record<HubKey, string>;
 /** Template values accepted by the interpolator. */
 export type TranslateValues = Record<string, string | number>;
 /** Interpolate a {name} template with the given values. */

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

@@ -0,0 +1,12 @@
+/**
+ * MarketSourceRow — 一个已添加来源的完整行：状态徽章 + 操作按钮。
+ * B 方案：扫描主按钮 + 智能更新按钮（检查/更新二合一）+ 溢出移除。
+ * 从 MarketView.ts 原样搬出，渲染逻辑不变。
+ */
+import type { JSX } from 'react';
+import type { MarketSourceRecord } from '../../protocol.ts';
+import type { SkillHubState } from './useSkillHub.ts';
+export declare function MarketSourceRow(props: {
+    hub: SkillHubState;
+    record: MarketSourceRecord;
+}): JSX.Element;

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

@@ -3,6 +3,7 @@
  * button while not yet added) and the user's market sources (full state
  * badges + actions once added, plus custom sources), with check-all and
  * update-all actions and the repo scan result with the importable checklist.
+ * 行渲染在 MarketSourceRow，扫描卡片在 RepoScanCard，数字格式在 market-format。
  */
 import { type JSX } from 'react';
 import type { SkillHubState } from './useSkillHub.ts';

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

@@ -0,0 +1,10 @@
+/**
+ * RepoScanCard — 扫描结果归属卡片：扫描中/错误/就绪（搜索+过滤+分页+
+ * 勾选导入+进度+结果）都包在这里。搜索/过滤/分页是卡片级本地状态，
+ * 随卡片挂载而生、关闭而灭。从 MarketView.tsx 原样搬出，渲染逻辑不变。
+ */
+import { type JSX } from 'react';
+import type { SkillHubState } from './useSkillHub.ts';
+export declare function RepoScanCard(props: {
+    hub: SkillHubState;
+}): JSX.Element | null;

package/lib/types/client/panel/hooks/shared.d.ts

@@ -0,0 +1,72 @@
+/**
+ * hooks 共享层：域 hooks 之间传递的通知接口、状态机类型、轮询常量、
+ * 每日自动检查 helpers。从 useSkillHub.ts 原样搬出，行为不变。
+ */
+import type { MarketCheckResponse, MarketSourceRecord, RepoDiscoverResponse, UpdateCheckResponse } from '../../../protocol.ts';
+/**
+ * 跨域共享的通知原语：聚合根用稳定的 setState setter 实现一次，
+ * 各域 hooks 只调接口，不直接碰别人的 state。对象本身经 useMemo
+ * 常驻，域回调的 useCallback 依赖它不会失稳。
+ */
+export interface FlowNotices {
+    /** 报错条幅（覆盖旧报错）。 */
+    fail: (message: string) => void;
+    /** 清掉报错条幅。 */
+    clearFail: () => void;
+    /** 成功条幅（null = 清掉）。 */
+    succeed: (message: string | null) => void;
+    /** tag 域忙碌开关（多域共用）。 */
+    setTagBusy: (busy: boolean) => void;
+    /** 整组操作忙碌开关（toggle-batch 与全部更新共用）。 */
+    setBatchBusy: (busy: boolean) => void;
+}
+/** Catalog poll interval while the panel is mounted (the provider watcher feeds this). */
+export declare const POLL_MS = 5000;
+/** Relaxed poll for slower-changing data (stats, groups, sources, config). */
+export declare const SLOW_POLL_MS = 60000;
+/** 空统计补捞上限：冷启动全量扫描（数十 MB 会话日志）可能超过 2 分钟，72 次约 6 分钟内保持 5 秒粒度，之后交回 60 秒慢轮询。 */
+export declare const USES_CATCH_UP_MAX = 72;
+/** localStorage key of the last daily auto-check timestamp (survives sessions). */
+export declare const AUTO_CHECK_KEY = "skill-hub.last-auto-check";
+/** Daily auto-check interval: at most one network round per day. */
+export declare const AUTO_CHECK_INTERVAL_MS: number;
+/** Whether the daily auto-check should run now (first visit or ≥24h since the last). */
+export declare function shouldAutoCheck(): boolean;
+/** Record that the daily auto-check ran. */
+export declare function markAutoChecked(): void;
+/** One-shot self-update check state. */
+export type UpdateState = {
+    status: 'idle';
+} | {
+    status: 'checking';
+} | {
+    status: 'ready';
+    data: UpdateCheckResponse;
+} | {
+    status: 'error';
+    message: string;
+};
+/** Repo scanner/import state (drives the market source preview). */
+export type RepoDiscoverState = {
+    status: 'idle';
+} | {
+    status: 'scanning';
+} | {
+    status: 'ready';
+    data: RepoDiscoverResponse;
+} | {
+    status: 'error';
+    message: string;
+};
+/** Market sources list state. */
+export type MarketState = {
+    status: 'loading' | 'ready' | 'error';
+    repos: MarketSourceRecord[];
+};
+/** One market source's update-check outcome. */
+export type MarketCheckResult = MarketCheckResponse['results'][number];
+/** skillName → 调用次数/末次使用（统计域产出，目录排序消费）。 */
+export type UsesMap = ReadonlyMap<string, {
+    count: number;
+    lastUsed?: number;
+}>;

package/lib/types/client/panel/hooks/useCatalogFlow.d.ts

@@ -0,0 +1,62 @@
+/**
+ * useCatalogFlow — 目录域：catalog 加载、详情、开关（单个/禁用态/批量）、
+ * 新建、诊断修复，以及列表过滤/排序派生。跨域刷新只通过 shared 通知，
+ * 不直接碰其他域的 state。
+ */
+import { type FormEvent } from 'react';
+import type { CatalogResponse, CatalogSkill, DisabledSkill, SkillDetail, WritableRoot } from '../../../protocol.ts';
+import type { SkillHubApi } from '../../api.ts';
+import { type SortKey } from '../../grouping.ts';
+import type { FlowNotices, UsesMap } from './shared.ts';
+export declare function useCatalogFlow(api: SkillHubApi, uses: UsesMap, shared: FlowNotices, 
+/** 技能总数 >80 时折叠 personal 分组（聚合根实现，状态归它）。 */
+collapsePersonal: () => void, 
+/** 清掉来源筛选（状态归聚合根，这里只在清空筛选项时调用）。 */
+clearSourceFilter: () => void): {
+    catalog: CatalogResponse | null;
+    loading: boolean;
+    detail: SkillDetail | null;
+    detailLoading: boolean;
+    busyNames: ReadonlySet<string>;
+    search: string;
+    workspace: string;
+    showForm: boolean;
+    formName: string;
+    formDesc: string;
+    formRoot: WritableRoot;
+    formBusy: boolean;
+    formMessage: {
+        kind: "error" | "success";
+        text: string;
+    } | null;
+    fixingPaths: ReadonlySet<string>;
+    invocationFilter: "user" | "model" | "all";
+    sortKey: SortKey;
+    normalized: string;
+    actionNames: Set<string>;
+    viewNames: Set<string>;
+    filtered: CatalogSkill[];
+    sorted: CatalogSkill[];
+    shortenedCount: number;
+    setDetail: import("react").Dispatch<import("react").SetStateAction<SkillDetail | null>>;
+    setSearch: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setWorkspace: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setShowForm: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setFormName: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setFormDesc: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setFormRoot: import("react").Dispatch<import("react").SetStateAction<WritableRoot>>;
+    setFormMessage: import("react").Dispatch<import("react").SetStateAction<{
+        kind: "error" | "success";
+        text: string;
+    } | null>>;
+    setInvocationFilter: import("react").Dispatch<import("react").SetStateAction<"user" | "model" | "all">>;
+    setSortKey: import("react").Dispatch<import("react").SetStateAction<SortKey>>;
+    load: () => Promise<void>;
+    openDetail: (name: string) => Promise<void>;
+    toggle: (skill: CatalogSkill, enabled: boolean) => Promise<void>;
+    enableDisabled: (record: DisabledSkill) => Promise<void>;
+    batchToggleNames: (names: string[], enabled: boolean) => Promise<void>;
+    fixDiagnostic: (path: string) => Promise<void>;
+    create: (event: FormEvent) => Promise<void>;
+    clearListFilters: () => void;
+};

package/lib/types/client/panel/hooks/useGroupFlow.d.ts

@@ -0,0 +1,41 @@
+/**
+ * useGroupFlow — 分组域：groups 加载、tag 新建/删除/成员/重排、集合重排、
+ * 来源顶层重排、组开关与冲突解决。目录侧只消费 batchToggleNames +
+ * actionNames（聚合根传入），不碰目录 state。
+ */
+import { type FormEvent } from 'react';
+import type { GroupsResponse, SkillTag } from '../../../protocol.ts';
+import type { SkillHubApi } from '../../api.ts';
+import { type GroupSwitchState } from '../../grouping.ts';
+import type { FlowNotices } from './shared.ts';
+import type { ConflictDialogState } from '../dialogs.tsx';
+export declare function useGroupFlow(api: SkillHubApi, shared: FlowNotices, 
+/** 整组开关的执行器（目录域提供，stable）。 */
+batchToggleNames: (names: string[], enabled: boolean) => Promise<void>, 
+/** 当前启用且可写的技能名（目录域派生）。 */
+actionNames: ReadonlySet<string>): {
+    groupsState: GroupsResponse | null;
+    conflictDialog: ConflictDialogState | null;
+    editingTag: SkillTag | null;
+    editName: string;
+    membersDraft: ReadonlySet<string>;
+    newTagName: string;
+    editSearch: string;
+    setConflictDialog: import("react").Dispatch<import("react").SetStateAction<ConflictDialogState | null>>;
+    setEditingTag: import("react").Dispatch<import("react").SetStateAction<SkillTag | null>>;
+    setEditName: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setMembersDraft: import("react").Dispatch<import("react").SetStateAction<ReadonlySet<string>>>;
+    setNewTagName: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setEditSearch: import("react").Dispatch<import("react").SetStateAction<string>>;
+    loadGroups: () => Promise<void>;
+    applyTags: (tags: SkillTag[]) => void;
+    groupMap: () => Map<string, string[]>;
+    toggleGroup: (key: string, name: string, view: GroupSwitchState) => void;
+    resolveConflict: (closeAll: boolean) => Promise<void>;
+    createTag: (event: FormEvent) => Promise<void>;
+    deleteTag: (id: string) => Promise<void>;
+    saveTag: (id: string, name: string, memberNames: string[] | null) => Promise<void>;
+    reorderTags: (orderedIds: string[]) => Promise<void>;
+    reorderCollections: (orderedNames: string[]) => Promise<void>;
+    reorderSourceGroups: (orderedKeys: string[]) => Promise<void>;
+};

package/lib/types/client/panel/hooks/useMarketFlow.d.ts

@@ -0,0 +1,73 @@
+/**
+ * useMarketFlow — 市场域：市场源增删、仓库扫描、分支/版本选择、导入任务
+ * （轮询+取消）、更新检查、星标统计、版本同步、全部更新。目录/分组/来源
+ * 的刷新与来源检查经聚合根传入，不直接碰其他域的 state。
+ */
+import type { RepoImportProgressResponse, SourceCheckResult } from '../../../protocol.ts';
+import type { SkillHubApi } from '../../api.ts';
+import type { FlowNotices, MarketState, RepoDiscoverState } from './shared.ts';
+import type { BranchChoiceState, MarketSyncDialogState, VersionChoiceState } from '../dialogs.tsx';
+export declare function useMarketFlow(api: SkillHubApi, shared: FlowNotices, 
+/** 目录重载（导入/同步后刷新列表，目录域提供）。 */
+reloadCatalog: () => Promise<void>, 
+/** 分组重载（导入后刷新，分组域提供）。 */
+reloadGroups: () => Promise<void>, 
+/** 来源重载（导入/同步后刷新，来源域提供）。 */
+reloadSources: () => Promise<void>, 
+/** 来源更新检查（全部更新后重查，来源域提供）。 */
+checkSources: (repo?: string) => Promise<void>, 
+/** 各来源的上游检查结果（全部更新遍历它，来源域提供）。 */
+sourceCheck: Readonly<Record<string, SourceCheckResult>>): {
+    marketState: MarketState;
+    marketCheck: Readonly<Record<string, {
+        repo: string;
+        ref?: string;
+        latestTag?: string;
+        updateAvailable: boolean;
+        commitSha: string;
+        throttled?: boolean;
+        error?: string;
+    }>>;
+    branchChoice: BranchChoiceState | null;
+    branchBusy: boolean;
+    marketSyncDialog: MarketSyncDialogState | null;
+    syncingMarket: string | null;
+    syncBusy: boolean;
+    newSourceName: string;
+    repoDiscoverState: RepoDiscoverState;
+    scanningRepo: string | null;
+    repoSelected: ReadonlySet<string>;
+    repoImporting: boolean;
+    repoResult: RepoImportProgressResponse | null;
+    importJobId: string | null;
+    marketStats: Readonly<Record<string, {
+        stars: number;
+        downloads: number;
+    }>>;
+    versionDialog: VersionChoiceState | null;
+    versionBusy: boolean;
+    updateAllDialog: boolean;
+    setBranchChoice: import("react").Dispatch<import("react").SetStateAction<BranchChoiceState | null>>;
+    setMarketSyncDialog: import("react").Dispatch<import("react").SetStateAction<MarketSyncDialogState | null>>;
+    setNewSourceName: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setRepoSelected: import("react").Dispatch<import("react").SetStateAction<ReadonlySet<string>>>;
+    setUpdateAllDialog: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setVersionDialog: import("react").Dispatch<import("react").SetStateAction<VersionChoiceState | null>>;
+    loadMarket: () => Promise<void>;
+    addSource: (input: string) => Promise<void>;
+    addMarketSource: () => Promise<void>;
+    removeMarketSource: (repo: string) => Promise<void>;
+    scanRepo: (input: string) => Promise<void>;
+    confirmBranchChoice: () => Promise<void>;
+    openVersionDialog: (repo: string) => Promise<void>;
+    confirmVersionDialog: () => Promise<void>;
+    toggleRepoSelected: (path: string, checked: boolean) => void;
+    importRepo: () => Promise<void>;
+    cancelImport: () => Promise<void>;
+    clearScan: () => void;
+    checkMarket: () => Promise<void>;
+    loadMarketStats: () => Promise<void>;
+    syncMarketSource: (repo: string) => Promise<void>;
+    confirmMarketSync: () => Promise<void>;
+    updateAll: () => Promise<void>;
+};

package/lib/types/client/panel/hooks/useMetaFlow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * useMetaFlow — 自身更新检查 + 调用统计 + 配置：只依赖 api，
+ * 不碰其他域。补捞 effect 自包含（uses.size + loadUses）。
+ */
+import type { HubConfig } from '../../../protocol.ts';
+import type { SkillHubApi } from '../../api.ts';
+import { type UpdateState } from './shared.ts';
+export declare function useMetaFlow(api: SkillHubApi): {
+    updateState: UpdateState;
+    checkUpdate: () => Promise<void>;
+    uses: ReadonlyMap<string, {
+        count: number;
+        lastUsed?: number;
+    }>;
+    loadUses: () => Promise<void>;
+    hubConfig: HubConfig | null;
+    loadConfig: () => Promise<void>;
+};