dsh-skill-hub 0.2.0 → 0.2.2

package/lib/index.js

@@ -1,4 +1,5 @@
 import { createRequire } from "node:module";
+import { settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "schemastery";
 import { mkdir, mkdtemp, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
 import { basename, dirname, join, resolve } from "node:path";
@@ -842,7 +843,7 @@ async function findProjectRoot(cwd) {
 }
 /**
 * Scan one writable root for files the provider ignores, so the GUI can
-* show why a skill never appears (the zcode-style diagnostics lesson: a
+* show why a skill never appears — a
 * missing frontmatter must be visible, not silent). .disabled files belong
 * to the hub and are skipped.
 */
@@ -1493,7 +1494,7 @@ function repoSkillEntry(name, root, repo) {
 //#endregion
 //#region src/update.ts
 /**
-* Self-update check for dsh-skill-hub, mirroring cc-switch's behavior:
+* Self-update check for dsh-skill-hub
 * query GitHub's latest release and compare it to the installed version.
 *
 * This stays dependency-free: Node's global fetch is used and the version
@@ -1794,13 +1795,72 @@ async function knownSkillNames(deps) {
 	for (const disabled of await deps.store.listDisabled()) names.add(disabled.name);
 	return names;
 }
-/** Build the full catalog response (shared by catalog/toggle/create handlers). */
+/**
+* 读取 dsh 的已知工作区清单（~/.dsh/storages/workspace.json 的
+* tables.workspaces 表）。面板默认视图据此合并所有工作区的项目技能；
+* 文件缺失/损坏时返回空清单（回退为仅用户级视图）。
+*/
+async function workspaceEntries(home) {
+	try {
+		const raw = await readFile(join(home, "storages", "workspace.json"), "utf8");
+		const parsed = JSON.parse(raw);
+		const tables = typeof parsed === "object" && parsed !== null ? parsed.tables : void 0;
+		const workspaces = tables !== void 0 && typeof tables === "object" ? tables.workspaces : void 0;
+		const entries = [];
+		if (workspaces !== void 0 && typeof workspaces === "object") for (const record of Object.values(workspaces)) {
+			const entry = record;
+			if (entry !== null && typeof entry === "object" && typeof entry.path === "string" && entry.path !== "") entries.push({
+				path: entry.path,
+				title: typeof entry.title === "string" && entry.title !== "" ? entry.title : entry.path
+			});
+		}
+		return entries;
+	} catch {
+		return [];
+	}
+}
+/** 项目技能来源（workspace 字段只对它们设置）。 */
+function isProjectSource(source) {
+	return source === "project-dsh" || source === "project-agents";
+}
+/**
+* Build the full catalog response (shared by catalog/toggle/create handlers).
+* 显式 cwd 只看该工作区；否则合并所有已知工作区（workspace.json）的项目技能
+* + 用户级技能，同名技能先到先得；没有任何工作区时回退为仅用户级视图。
+*/
 async function buildCatalog(deps, cwd) {
-	const lookup = cwd !== void 0 ? { cwd } : void 0;
-	const snapshot = await deps.skills.snapshot(lookup);
 	const home = homeOf(deps);
+	let workspaces;
+	if (cwd !== void 0 && cwd !== "") workspaces = [{
+		path: cwd,
+		title: cwd
+	}];
+	else {
+		workspaces = await workspaceEntries(home);
+		if (workspaces.length === 0) workspaces = [{
+			path: "",
+			title: ""
+		}];
+	}
+	const byName = /* @__PURE__ */ new Map();
+	let complete = true;
+	for (const ws of workspaces) {
+		const lookup = ws.path !== "" ? { cwd: ws.path } : void 0;
+		const snapshot = await deps.skills.snapshot(lookup);
+		if (!snapshot.complete) complete = false;
+		for (const skill of snapshot.skills) {
+			if (byName.has(skill.name)) continue;
+			byName.set(skill.name, {
+				skill,
+				...isProjectSource(skill.source) && ws.path !== "" ? {
+					workspace: ws.path,
+					workspaceTitle: ws.title
+				} : {}
+			});
+		}
+	}
 	const timesByName = /* @__PURE__ */ new Map();
-	await Promise.all(snapshot.skills.map(async (skill) => {
+	await Promise.all([...byName.values()].map(async ({ skill }) => {
 		if (!isWritableSource(skill.source)) return;
 		const base = rootPath(skill.source, home);
 		for (const candidate of [
@@ -1816,7 +1876,7 @@ async function buildCatalog(deps, cwd) {
 			return;
 		} catch {}
 	}));
-	const skills = snapshot.skills.map((skill) => {
+	const skills = [...byName.values()].map(({ skill, workspace, workspaceTitle }) => {
 		const row = {
 			name: skill.name,
 			description: skill.description,
@@ -1826,7 +1886,12 @@ async function buildCatalog(deps, cwd) {
 				userInvocable: skill.invocation.userInvocable
 			},
 			provider: skill.provider,
-			writable: isWritableSource(skill.source)
+			writable: isWritableSource(skill.source),
+			source: skill.source,
+			...workspace !== void 0 ? {
+				workspace,
+				workspaceTitle: workspaceTitle ?? workspace
+			} : {}
 		};
 		const times = timesByName.get(skill.name);
 		if (times !== void 0) {
@@ -1839,7 +1904,7 @@ async function buildCatalog(deps, cwd) {
 	const diagnostics = [...await scanDiagnostics("user-dsh", home), ...await scanDiagnostics("user-agents", home)];
 	return {
 		ok: true,
-		complete: snapshot.complete,
+		complete,
 		skills,
 		disabled,
 		diagnostics
@@ -1944,7 +2009,15 @@ function makeRoutes(deps) {
 					return;
 				}
 				const cwd = queryParam(url, "cwd");
-				const skill = await deps.skills.get(name, cwd !== void 0 ? { cwd } : void 0);
+				let skill;
+				if (cwd !== void 0 && cwd !== "") skill = await deps.skills.get(name, { cwd });
+				else {
+					for (const ws of await workspaceEntries(homeOf(deps))) {
+						skill = await deps.skills.get(name, { cwd: ws.path });
+						if (skill !== void 0) break;
+					}
+					if (skill === void 0) skill = await deps.skills.get(name);
+				}
 				if (skill === void 0) {
 					writeError(res, 404, "skill not found: " + name);
 					return;
@@ -3025,7 +3098,8 @@ const name = "skill-hub";
 const inject = [
 	"webServer",
 	"skills",
-	"systemPrompt"
+	"systemPrompt",
+	"settings"
 ];
 const Config = z.object({
 	announceToAgent: z.boolean().default(HUB_CONFIG_DEFAULTS.announceToAgent),
@@ -3034,32 +3108,52 @@ const Config = z.object({
 	showUseTime: z.boolean().default(HUB_CONFIG_DEFAULTS.showUseTime),
 	showGroupSummary: z.boolean().default(HUB_CONFIG_DEFAULTS.showGroupSummary)
 });
+/**
+* Settings namespace hosting the hub's runtime config. Since dsh rc.7 the
+* host serves every registered settings namespace to the web client (the
+* dsh-host-apiproxy allowlist is gone), so the browser card and the settings
+* page edit this namespace through the official settings transport, and the
+* plugin consumes the same resolved value — one source of truth.
+*/
+const CONFIG_NAMESPACE = settingsNamespace("dsh-skill-hub");
+/** Schema of the hub's settings namespace: the card's fields (booleans + optional dot colors). */
+const HubSettingsSchema = z.object({
+	enabled: z.boolean().default(HUB_CONFIG_DEFAULTS.enabled),
+	announceToAgent: z.boolean().default(HUB_CONFIG_DEFAULTS.announceToAgent),
+	showUseCount: z.boolean().default(HUB_CONFIG_DEFAULTS.showUseCount),
+	showUseTime: z.boolean().default(HUB_CONFIG_DEFAULTS.showUseTime),
+	showGroupSummary: z.boolean().default(HUB_CONFIG_DEFAULTS.showGroupSummary),
+	dotModelColor: z.string().pattern(HEX_COLOR_RE),
+	dotUserColor: z.string().pattern(HEX_COLOR_RE)
+});
 /** Order of the announcement section within the tool-guidance band. */
 const SECTION_ORDER = 152;
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
 const SKILL_HUB_GUIDANCE = ["本机已安装 dsh-skill-hub 插件（DSH Web GUI 技能中枢）：设置 →「技能」分区为管理主页；设置 → 插件列表中有本插件的配置卡片（启用/公告开关）。能力：完整本地技能目录（项目/自定义/用户/内置全部来源，走官方 ctx.skills 注册表，含第三方 provider）；按来源与自定义分组浏览，分组/来源头部的滑动开关可一键启用/禁用整组（跨组冲突时询问）；市场：内置市场目录（精选仓库一键添加）加自定义仓库源，扫描后勾选安装，每个市场源行显示已装/可更新/上游已删数量，支持「检查全部」与「全部更新」；来源跟踪：从 GitHub 仓库（市场源或直接地址）导入的技能记录上游 repo/commit 快照，可检查更新、选择同步、上游删除时跟进删除（移入回收站可恢复，恢复后保留来源与场景归属）；个人技能（无来源记录）不跟踪；调用次数与最近使用时间统计；查看技能正文；发现诊断；新建技能向导（写入 ~/.dsh/skills 或 ~/.agents/skills）。限制：仅用户级技能（user-dsh/user-agents 根目录）可写，项目/内置/运行时技能只读展示；路由仅回环可访问。用户提到「技能管理 / 技能列表 / 技能开关 / 技能同步 / 技能市场 / 更新技能 / 新建技能」时即指本插件，请据此协作。", "The dsh-skill-hub plugin is installed (the DSH Web GUI skill hub): Settings → \"Skills\" is the management page; Settings → Plugins lists this plugin's configuration card (enable / announcement toggles). Capabilities: full local skill catalog (project / custom / user / bundled roots via the official ctx.skills registry, including third-party providers); browsing by source and custom groups, each group header carrying a sliding switch to enable/disable the whole group in one click (cross-group conflicts prompt the user); market: a built-in catalog of curated repos (one-click add) plus custom repo sources, scan-and-install import, per-source installed / updatable / deleted-upstream badges with \"check all\" and \"update all\" actions; upstream source tracking: skills imported from GitHub repos (market sources or direct URLs) record the repo/commit snapshot, support update checks, selective sync, and follow-up deletion when the upstream removes a skill (moves it into a restorable trash; restoring keeps the source and scene membership); personal skills (no source record) are never tracked; invocation counts and last-used times; skill body inspection; discovery diagnostics; new-skill wizard (writes to ~/.dsh/skills or ~/.agents/skills). Limits: only user-level skills (user-dsh/user-agents roots) are writable; project/bundled/runtime skills are read-only; routes are loopback-only. When the user mentions \"skill management / skill list / skill toggle / skill sync / skill market / update skills / new skill\", this plugin is what they mean — collaborate accordingly."].join("\n\n");
 /**
 * Mount the skill hub routes and announcement.
-* @param ctx - host plugin context carrying webServer/skills/systemPrompt.
+* @param ctx - host plugin context carrying webServer/skills/systemPrompt/settings.
 * @param config - resolved plugin config (schema defaults applied by the loader).
 */
 function apply(ctx, config) {
 	const base = config ?? {};
-	let current = () => resolveHubConfig({}, base);
-	let savedState = {};
+	const settingsScope = ctx.settings.register(CONFIG_NAMESPACE, HubSettingsSchema, { base });
+	const current = () => settingsScope.get();
 	const store = new SkillHubStore();
 	let disposeRoutes;
 	let disposeSection;
 	let disposeProvider;
 	let providerControl;
 	let stats;
+	const saved = () => {
+		return ctx.settings.describe().find((entry) => entry.ns === CONFIG_NAMESPACE)?.user ?? {};
+	};
 	const updateConfig = async (patch) => {
-		await store.setConfig(patch);
-		savedState = await store.getConfig();
-		const next = resolveHubConfig(savedState, base);
-		current = () => next;
-		sync();
-		return next;
+		const user = { ...saved() };
+		for (const [key, value] of Object.entries(patch)) if (value === void 0) delete user[key];
+		else user[key] = value;
+		await settingsScope.replace(user);
+		return settingsScope.get();
 	};
 	const sync = () => {
 		if (disposeSection !== void 0) {
@@ -3096,7 +3190,7 @@ function apply(ctx, config) {
 				},
 				stats,
 				config: current,
-				saved: () => savedState,
+				saved,
 				updateConfig
 			}).map((route) => ctx.webServer.register(route));
 			return () => {
@@ -3105,15 +3199,21 @@ function apply(ctx, config) {
 		}, "dsh-skill-hub: routes");
 	};
 	sync();
-	store.getConfig().then((saved) => {
-		savedState = saved;
-		current = () => resolveHubConfig(saved, base);
+	ctx.effect(() => settingsScope.watch(() => {
 		sync();
-	});
+	}), "dsh-skill-hub: settings config watch");
+	(async () => {
+		const legacy = await store.getConfig();
+		if (Object.keys(legacy).length > 0 && Object.keys(saved()).length === 0) try {
+			await settingsScope.update(legacy);
+		} catch (error) {
+			ctx.logger.warn("[dsh-skill-hub] sidecar config migration into the settings namespace failed", error);
+		}
+	})();
 	ctx.inject(["sessionQuery"], (sctx) => {
 		stats = createSkillStatsReader(sctx.sessionQuery);
 		sync();
 	});
 }
 //#endregion
-export { Config, SKILL_HUB_GUIDANCE, apply, inject, name };
+export { CONFIG_NAMESPACE, Config, HubSettingsSchema, SKILL_HUB_GUIDANCE, apply, inject, name };

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

@@ -1,14 +1,20 @@
 /**
- * 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).
+ * The dsh-skill-hub plugin settings card: bridges the hub's settings
+ * namespace (bound through the official settings transport) onto the
+ * family-style staged card form (enabled master switch + agent announcement).
+ * Registered into the official `settings.plugin.item` slot keyed by that
+ * namespace, so the plugin shows up in Settings → 插件 on dsh rc.7+.
  */
 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';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { type CardShell, type FieldState, 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";
 /** The card's projected state. */
 export interface SkillHubSettingsState extends CardShell {
     enabled: FieldState;
@@ -19,31 +25,31 @@ export interface SkillHubSettingsState extends CardShell {
     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;
+/** The business face the card's slot registration injects. */
+export interface SkillHubSettingsCardFace {
+    hooks: {
+        /** The card's snapshot store (projected form state). */
+        skillHubSettingsCard: SnapshotStore<SkillHubSettingsState>;
+    };
     save: () => void;
     discard: () => void;
     edit: (field: string, text: string) => void;
     resetField: (field: string) => void;
 }
+/** Props the slot renderer binds (locale copy + injected form actions). */
+export type SkillHubSettingsCardProps = PropsRuntime<'settings.plugin.item'> & PropsLocale<'dsh-skill-hub'> & InjectFace<SkillHubSettingsCardFace>;
 /** 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). */
+    /** @param scope - the hub settings scope the card edits (FormScope-compatible). */
     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']>;
+    inject(): SkillHubSettingsCardFace;
 }
 /**
  * Render the dsh-skill-hub card.

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

@@ -9,8 +9,14 @@ export declare class SkillHubApiError extends Error {
 }
 /** The browser half's only data entry point. */
 export declare class SkillHubApi {
-    catalog(): Promise<CatalogResponse>;
-    skill(name: string): Promise<SkillDetail>;
+    /** Catalog lookup options (cwd selects a workspace's project skills). */
+    catalog(options?: {
+        cwd?: string;
+    }): Promise<CatalogResponse>;
+    /** One skill's detail (cwd selects a workspace's project skills). */
+    skill(name: string, options?: {
+        cwd?: 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. */
@@ -19,7 +25,7 @@ export declare class SkillHubApi {
     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). */
+    /** The user's added market sources. */
     market(): Promise<MarketSourcesResponse>;
     /** Add a market source repo; resolves with the fresh list. */
     addMarketSource(repo: string): Promise<MarketSourcesResponse>;

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

@@ -40,11 +40,14 @@ export declare function conflictsOnClose(members: readonly string[], enabledName
 }>): string[];
 /** Origin-repo filter value: skills with no source record (private skills). */
 export declare const PRIVATE_SOURCE = "private";
+/** 项目级技能来源（它们有 workspace 归属，不属于「个人」组）。 */
+export declare function isProjectSource(source: string): boolean;
 /**
  * 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.
+ * 项目级技能（有 workspace 归属）永远不算「个人」。
  */
 export declare function filterBySource(skills: readonly CatalogSkill[], source: string, origins: Readonly<Record<string, string>>): CatalogSkill[];
 /** Catalog sort keys offered by the filter bar. */

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

@@ -5,11 +5,11 @@
  * 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;
+ *    插件 → 可配置插件列表), keyed by the hub's settings namespace and bound
+ *    through the official settings transport (dsh rc.7 serves every
+ *    registered namespace to the web client, and the tab dispatches cards by
+ *    namespace) — the family-bucket card pattern (PluginSettingsCard +
+ *    CardForm vendored from dsh-task-board);
  *  - a top-level Settings section (Settings → 技能) hosting the skill hub
  *    panel: catalog, search, enable/disable, diagnostics, new-skill form.
  *
@@ -29,7 +29,13 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
         'dsh-skill-hub': HubKey;
     }
 }
-/** Required services (fiber inject waiting — the runtime must be up first). */
+/**
+ * Required services (fiber inject waiting — the runtime must be up first).
+ * `connection`/`remote` are the settings transport's own prerequisites
+ * (`ctx.settingsScope.bind` resolves them on the caller's fiber), and
+ * `settingsScope` is the namespace-scope binder itself; mirror the official
+ * settings-plugins inject list.
+ */
 export declare const inject: string[];
 /** Type-only surface (export discipline: no value exports beyond the plugin contract). */
 export type { SkillHubPanelProps } from './panel/SkillHubPanel.tsx';

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

@@ -26,19 +26,19 @@ export declare const zh: {
     readonly 'panel.emptyAll': "本地还没有技能。点击「新建技能」创建第一个。";
     readonly 'panel.loading': "读取中…";
     readonly 'panel.incomplete': "（目录可能不完整）";
-    readonly 'market.addHint': "像 codex 一样添加仓库源：输入 owner/repo 或 GitHub 链接，扫描其中的技能并一键导入；导入后自动跟踪上游更新。";
+    readonly 'panel.workspacePlaceholder': "工作区路径（回车应用）";
+    readonly 'panel.workspaceHint': "填写项目路径后，面板同时显示该项目 .dsh/skills 与 .agents/skills 下的技能（只读）；留空回车恢复用户级视图。";
+    readonly 'panel.workspaceClear': "清除工作区";
     readonly 'market.addPlaceholder': "owner/repo 或 https://github.com/…";
     readonly 'market.addSource': "添加源";
     readonly 'market.noSources': "还没有市场源。从下方内置市场添加，或输入一个 GitHub 仓库。";
-    readonly 'market.catalogTitle': "内置市场";
+    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.added': "已添加";
     readonly 'market.add': "添加";
-    readonly 'market.mySources': "我的市场源";
     readonly 'market.installed': "已装 {count}";
     readonly 'market.updatable': "可更新 {count}";
     readonly 'market.deletedUpstream': "上游已删 {count}";
@@ -103,6 +103,9 @@ export declare const zh: {
     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': "保留开启";
@@ -129,6 +132,7 @@ export declare const zh: {
     readonly 'row.disable': "禁用";
     readonly 'row.enable': "启用";
     readonly 'row.delete': "移入回收站";
+    readonly 'row.open': "查看 {name} 详情（回车）";
     readonly 'delete.confirmTitle': "移入回收站？";
     readonly 'delete.confirmText': "确定把「{name}」移入回收站吗？可随时恢复。";
     readonly 'delete.confirm': "移入回收站";

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

@@ -1,6 +1,6 @@
 /**
  * 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).
+ * users can browse and install without knowing repo URLs.
  * Only the repo slug lives here; adding goes through the normal
  * market-source route and records upstream tracking like any manual source.
  */

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

@@ -1,10 +1,10 @@
 /**
- * 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.
+ * Market tab: one unified market list — built-in catalog entries (add
+ * 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.
  */
-import type { JSX } from 'react';
+import { type JSX } from 'react';
 import type { SkillHubState } from './useSkillHub.ts';
 export declare function MarketView(props: {
     hub: SkillHubState;

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

@@ -2,7 +2,7 @@
  * 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,
+ * restorable trash), 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

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

@@ -1,7 +1,9 @@
 /**
- * Sources tab: the flat skill list or the grouped view (one card per
- * upstream collection with check/sync/follow-delete actions and the
- * tri-state switch, plus the uncategorized "personal" card).
+ * Sources tab: the flat skill list or the grouped view — a project-level
+ * three-tier tree (workspaces from workspace.json, each optionally split by
+ * .dsh/.agents), one card per upstream collection with check/sync/
+ * follow-delete actions and the tri-state switch, plus the uncategorized
+ * "personal" card (project skills never count as personal).
  */
 import type { JSX } from 'react';
 import type { SkillHubState } from './useSkillHub.ts';

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

@@ -53,6 +53,7 @@ export declare function useSkillHub(api: SkillHubApi): {
     repoImporting: boolean;
     repoResult: RepoImportResponse | null;
     search: string;
+    workspace: string;
     detail: SkillDetail | null;
     detailLoading: boolean;
     busyNames: ReadonlySet<string>;
@@ -108,6 +109,7 @@ export declare function useSkillHub(api: SkillHubApi): {
     tagBusy: boolean;
     editSearch: string;
     collapsedGroups: ReadonlySet<string>;
+    subdividedProjects: ReadonlySet<string>;
     showLegend: boolean;
     actionNames: Set<string>;
     viewNames: Set<string>;
@@ -119,6 +121,7 @@ export declare function useSkillHub(api: SkillHubApi): {
     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>>;
+    setWorkspace: import("react").Dispatch<import("react").SetStateAction<string>>;
     setDetail: import("react").Dispatch<import("react").SetStateAction<SkillDetail | null>>;
     setShowForm: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     setFormName: import("react").Dispatch<import("react").SetStateAction<string>>;
@@ -148,6 +151,7 @@ export declare function useSkillHub(api: SkillHubApi): {
     setEditSearch: import("react").Dispatch<import("react").SetStateAction<string>>;
     setShowLegend: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     toggleGroupCollapse: (key: string) => void;
+    toggleSubdivide: (key: string) => void;
     checkUpdate: () => Promise<void>;
     loadMarket: () => Promise<void>;
     openDetail: (name: string) => Promise<void>;

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

@@ -6,15 +6,16 @@
  * plugin should show no trace of it.
  */
 import { type ReactElement } from 'react';
+import type { HubKey } from './locales.ts';
 import type { CardShell } from './settings-form.ts';
 /** Card-level chrome props. */
 export interface PluginSettingsCardProps {
-    /** Locale translator for the owning plugin's namespace. */
-    t: (key: string) => string;
+    /** Locale translator for the owning plugin's namespace (its own key domain). */
+    t: (key: HubKey) => string;
     /** Locale key of the card title. */
-    titleKey: string;
+    titleKey: HubKey;
     /** Locale key of the card description. */
-    descriptionKey: string;
+    descriptionKey: HubKey;
     /** The form shell state. */
     state: CardShell;
     onSave: () => void;

package/lib/types/index.d.ts

@@ -8,6 +8,7 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import z from 'schemastery';
+import { type HubSettingsValue } from './protocol.ts';
 /** Stable cordis plugin name (matches cordis.patch.yml insert id). */
 export declare const name = "skill-hub";
 /** Services required before the skill-hub surfaces can mount. */
@@ -26,11 +27,21 @@ export interface Config {
     showGroupSummary?: boolean;
 }
 export declare const Config: z<Config>;
+/**
+ * Settings namespace hosting the hub's runtime config. Since dsh rc.7 the
+ * host serves every registered settings namespace to the web client (the
+ * dsh-host-apiproxy allowlist is gone), so the browser card and the settings
+ * page edit this namespace through the official settings transport, and the
+ * plugin consumes the same resolved value — one source of truth.
+ */
+export declare const CONFIG_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+/** Schema of the hub's settings namespace: the card's fields (booleans + optional dot colors). */
+export declare const HubSettingsSchema: z<HubSettingsValue>;
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
 export declare const SKILL_HUB_GUIDANCE: string;
 /**
  * Mount the skill hub routes and announcement.
- * @param ctx - host plugin context carrying webServer/skills/systemPrompt.
+ * @param ctx - host plugin context carrying webServer/skills/systemPrompt/settings.
  * @param config - resolved plugin config (schema defaults applied by the loader).
  */
 export declare function apply(ctx: Context, config?: Config): void;

package/lib/types/protocol.d.ts

@@ -52,10 +52,16 @@ export interface CatalogSkill {
     provider: string;
     /** Whether the hub may toggle this skill (user-level filesystem skills only). */
     writable: boolean;
+    /** 技能来源标识（user-dsh/user-agents/project-dsh/project-agents/...）。 */
+    source: string;
     /** SKILL.md creation time (epoch ms); used for "added" sorting. Absent when unknown. */
     addedAt?: number;
     /** SKILL.md last-modified time (epoch ms); used for "updated" display. Absent when unknown. */
     updatedAt?: number;
+    /** 项目技能的所属工作区路径（仅 project-dsh/project-agents 来源携带）。 */
+    workspace?: string;
+    /** 工作区显示标题（来自 workspace.json；无则回退为路径）。 */
+    workspaceTitle?: string;
 }
 /** One disabled skill tracked by the hub sidecar (SKILL.md renamed away). */
 export interface DisabledSkill {
@@ -194,6 +200,23 @@ export interface HubConfig {
     /** Show group-header usage summaries (count + last used). Default true. */
     showGroupSummary?: boolean;
 }
+/**
+ * The resolved shape of the hub's settings namespace (schema defaults, then
+ * the composition base, then the user layer). Kept as a type alias so the
+ * browser-side settings scope snapshot is index-compatible with the card
+ * form's record shape.
+ */
+export type HubSettingsValue = {
+    enabled: boolean;
+    announceToAgent: boolean;
+    showUseCount: boolean;
+    showUseTime: boolean;
+    showGroupSummary: boolean;
+    /** Model-invocable dot color (#rrggbb); absent means the panel default. */
+    dotModelColor?: string;
+    /** User-invocable dot color (#rrggbb); absent means the panel default. */
+    dotUserColor?: string;
+};
 /**
  * Hub config defaults — the single source every layer reads: the cordis
  * schema (index.ts), the host's saved-override merge, and the routes'

package/lib/types/skillfs.d.ts

@@ -88,7 +88,7 @@ export declare function listSkillEntries(root: WritableRoot, home?: string): Pro
 export declare function findProjectRoot(cwd: string): Promise<string>;
 /**
  * Scan one writable root for files the provider ignores, so the GUI can
- * show why a skill never appears (the zcode-style diagnostics lesson: a
+ * show why a skill never appears — a
  * missing frontmatter must be visible, not silent). .disabled files belong
  * to the hub and are skipped.
  */

package/lib/types/update.d.ts

@@ -1,5 +1,5 @@
 /**
- * Self-update check for dsh-skill-hub, mirroring cc-switch's behavior:
+ * Self-update check for dsh-skill-hub
  * query GitHub's latest release and compare it to the installed version.
  *
  * This stays dependency-free: Node's global fetch is used and the version