@klarkxy/dsh-model-hub 0.1.4 → 0.1.6

package/README.md

@@ -4,7 +4,7 @@
 
 [简体中文](docs/README.zh-CN.md)
 
-See and change the models used by your DeepSeek Harness plugins from one page, manage which models subagents may use, and watch which model and reasoning effort each running subagent is on.
+View and change the models your DeepSeek Harness plugins use, control which models subagents may use, and track the model and reasoning effort of each running subagent — all on one page.
 
 ## Install
 
@@ -18,16 +18,16 @@ Replace `web` with your profile name and restart the profile.
 
 Open **Plugins → Model Hub**.
 
-- **Fields**: every model setting exposed by installed plugins, such as Auto Title, Git Commit, and Safe Auto. Search by plugin, purpose, or current model, then pick a new model. Changes are saved by the plugin that owns the setting.
-- **Subagent Cast**: turn the subagent model allowlist on or off and add, replace, or remove models. When enabled with at least one model, it guides the agent to discover the models available in the current conversation and explicitly choose one when delegating. For independent reviews and alternative approaches, it encourages a different model when suitable, while allowing the same model when it fits better. You can add your own task tendencies for individual models; they remain optional hints, and no model-specific tendencies are supplied by default. Below the list, a live view shows each running subagent with the model and reasoning effort it is currently using; an effort marked as adapter default comes from the adapter rather than an explicit choice.
+- **Fields**: every model setting exposed by installed plugins, such as Auto Title, Git Commit, and Safe Auto. Search by plugin, purpose, or current model, then pick a new model. The plugin that owns the setting saves the change.
+- **Subagent Cast**: toggle the subagent model allowlist and add, replace, or remove models. When enabled with at least one model, it guides the agent to discover the models available in the current conversation and pick one explicitly when delegating. For independent reviews and alternative approaches it favors a different model when suitable, but allows the same one when it fits better. Per-model task tendencies you add are optional hints; none are supplied by default. Below the list, a live view shows each running subagent with its current model and reasoning effort; an effort marked adapter default comes from the adapter, not an explicit choice.
 
 ## Limits
 
 - Only plugins that expose model settings appear.
 - Changes made elsewhere update the page automatically. If an edit conflicts with a newer change, refresh and choose again.
-- If the model list cannot load, use **Retry**. The last available list stays visible; warnings identify providers that could not be loaded while other providers remain usable.
-- Model selection guidance requires host tools that support choosing a subagent model. Existing conversations retain their saved model lists; start a new conversation to use an updated list.
-- Guidance does not force a model choice or add extra subtasks solely for variety.
+- If the model list cannot load, use **Retry**. The last available list stays visible; warnings name providers that failed while others stay usable.
+- Selection guidance needs host tools that support choosing a subagent model. List changes apply to new conversations; existing conversations and their subagents keep their saved lists. Refreshing the settings page does not change a conversation's list. Omitting an explicit model can still inherit the parent model.
+- Guidance never forces a model choice or adds subtasks just for variety.
 - Remote subagents and finished runs have no readable route; the live list covers only live local subagents.
 - No usage statistics.
 

package/docs/README.zh-CN.md

@@ -4,7 +4,7 @@
 
 [English](../README.md)
 
-在一个页面查看并修改各个 DeepSeek Harness 插件使用的模型，管理子代理可用的模型，并查看运行中子代理当前使用的模型与思考强度。
+在一个页面查看并修改各 DeepSeek Harness 插件使用的模型，管理子代理可用的模型，并跟踪运行中子代理的模型与思考强度。
 
 ## 安装
 
@@ -18,16 +18,16 @@ dsh plugin --profile web add @klarkxy/dsh-model-hub
 
 打开「插件 → 模型枢纽」。
 
-- **字段总览**：列出已安装插件提供的模型设置，例如自动标题、Git 提交和安全自动。可以按插件、用途或当前模型搜索，再选择新模型；改动由对应插件保存。
-- **子代理阵容**：开关子代理模型白名单，添加、替换或移除模型。开启且至少有一个模型时，会引导智能体发现当前会话可用的模型，并在派发时显式选择。独立复核和方案对比会优先考虑合适的不同模型，同模型更适合时仍可使用。你可以自行填写各模型的「任务倾向」作为可选参考；插件不预置模型专用倾向。页面下方实时列出运行中的子代理及各自当前使用的模型和思考强度；标注「适配器默认」的强度来自适配器而非显式选择。
+- **字段总览**：列出已安装插件提供的模型设置，例如自动标题、Git 提交和安全自动。可按插件、用途或当前模型搜索，再选择新模型；改动由对应插件保存。
+- **子代理阵容**：开关子代理模型白名单，添加、替换或移除模型。开启且至少有一个模型时，会引导智能体发现当前会话可用的模型，并在派发时显式选择。独立复核和方案对比会优先考虑合适的不同模型，同模型更适合时仍可使用。自填的模型「任务倾向」只作可选参考，插件不预置任何倾向。列表下方实时显示运行中的子代理及其当前模型和思考强度；标注「适配器默认」的强度来自适配器，而非显式选择。
 
 ## 限制
 
-- 只显示提供了模型设置的插件。
-- 设置在别处改动时，页面会自动更新。编辑与较新的改动冲突时，请刷新后重新选择。
-- 模型列表读取失败时，点击「重试」。上次可用的列表会保留；部分提供方读取失败时会显示提示，其他提供方仍可使用。
-- 选模引导需要宿主工具支持选择子代理模型。已有会话保留各自的模型名单；修改名单后，新建会话才能使用更新后的名单。
-- 引导不强制模型选择，也不要求仅为增加模型种类而新增子任务。
+- 只显示提供模型设置的插件。
+- 别处改动设置时页面自动更新；编辑与较新的改动冲突时，刷新后重新选择。
+- 模型列表读取失败时点「重试」。上次可用的列表保留；部分提供方读取失败会显示提示，其余提供方仍可用。
+- 选模引导需要宿主工具支持选择子代理模型。名单修改对新建会话生效，已有会话及其子代理沿用原名单；刷新设置页面不会更新会话名单。不显式指定模型时仍可继承父代理模型。
+- 引导不强制选模，也不为增加模型种类而新增子任务。
 - 远程子代理和已结束的子代理没有可读取的路由；运行列表只覆盖存活的本地子代理。
 - 不提供用量统计。
 

package/lib/client.inner.cjs

@@ -197,7 +197,14 @@ function groupModelMenuChoices(choices, query) {
 }
 //#endregion
 //#region ../dsh-model-route/src/catalog-ui.tsx
-/** Also accepts a mapped state from a caller that owns broader async orchestration. */
+/**
+* Also accepts a mapped state from a caller that owns broader async orchestration.
+*
+* The dsh-ui-* classes carry the styling and resolve through the consuming
+* plugin's own officialUiCss scope (every consumer mounts its root class, so
+* e.g. `.dsh-model-hub .dsh-ui-loading` paints this); dsh-model-catalog-status
+* stays as a structural hook for tests and layout, never a colour source.
+*/
 function ModelCatalogStatus({ state, locale }) {
 	const zh = locale?.toLowerCase().startsWith("zh") === true;
 	const copy = zh ? {
@@ -213,15 +220,17 @@ function ModelCatalogStatus({ state, locale }) {
 	};
 	if (!state.loading && !state.error && state.failures.length === 0) return null;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		className: "dsh-model-catalog-status",
+		className: "dsh-model-catalog-status dsh-ui-stack",
 		lang: zh ? "zh" : "en",
 		children: [
 			state.loading ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 				role: "status",
+				className: "dsh-ui-loading",
 				children: copy.loading
 			}) : null,
 			state.error ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
 				role: "alert",
+				className: "dsh-ui-error dsh-ui-wrap",
 				children: [
 					copy.error,
 					": ",
@@ -230,20 +239,27 @@ function ModelCatalogStatus({ state, locale }) {
 			}) : null,
 			state.failures.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				role: "status",
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: copy.partial }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", { children: state.failures.map((failure, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", { children: [
-					failure.name || failure.id,
-					": ",
-					failure.message
-				] }, `${failure.id}:${index}`)) })]
+				className: "dsh-ui-meta",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: copy.partial }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
+					className: "dsh-ui-list",
+					children: state.failures.map((failure, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", { children: [
+						failure.name || failure.id,
+						": ",
+						failure.message
+					] }, `${failure.id}:${index}`))
+				})]
 			}) : null,
-			state.error || state.failures.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
-				type: "button",
-				size: "sm",
-				disabled: state.loading,
-				onClick: () => {
-					state.refresh();
-				},
-				children: copy.retry
+			state.error || state.failures.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "dsh-ui-actions",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+					type: "button",
+					size: "sm",
+					disabled: state.loading,
+					onClick: () => {
+						state.refresh();
+					},
+					children: copy.retry
+				})
 			}) : null
 		]
 	});
@@ -263,7 +279,8 @@ function ModelCatalogStatus({ state, locale }) {
 * Sticky group headings, subsequence ranking, highlight walking and focus
 * hand-back all match the host. SYNC POINT: when the host's ModelSelect or
 * ModelSelect.module.css changes, this copy must be re-transcribed; styles
-* below may only reference --dsw-* theme tokens, never literal colors.
+* below may only reference allowlisted theme tokens (the --dsw-* set plus the
+* host's --ds-* motion tokens), never literal colors.
 *
 * It statically imports the primitives, so only browser clients should load
 * this entry; host code and node tests use the core entry (`./index.ts`).
@@ -771,7 +788,8 @@ function ModelMenu(props) {
 * sticky group headings (MenuGroup's own CSS), and the l1-stroke prominent
 * elevation at portal z-index 1100. The trigger mirrors the composer's 28px
 * model pill, chevron rotating open. MenuSurface paints fill and backdrop.
-* Only --dsw-* theme tokens may appear here — a literal color is a bug.
+* Only allowlisted --dsw- and --ds- theme tokens may appear here — a literal
+* color is a bug.
 */
 const modelMenuCss = `
 .dsh-model-menu-root { min-width: 0; position: relative; display: inline-flex; }
@@ -794,12 +812,14 @@ const modelMenuCss = `
   display: flex;
 }
 .dsh-model-menu-trigger:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover); }
-.dsh-model-menu-trigger:focus-visible:not([data-selection-focus]) { box-shadow: 0 0 0 2px var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary)); }
+.dsh-model-menu-trigger:focus-visible:not([data-selection-focus]) { box-shadow: 0 0 0 var(--dsw-focus-ring-width) var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary)); }
 .dsh-model-menu-trigger:disabled { color: var(--dsw-alias-label-dimmed); cursor: default; }
 .dsh-model-menu-triggerLabel { text-overflow: ellipsis; white-space: nowrap; min-width: 0; overflow: hidden; }
 .dsh-model-menu-triggerEffort { text-overflow: ellipsis; white-space: nowrap; min-width: 0; color: var(--dsw-alias-label-caption); flex-shrink: 1000; overflow: hidden; }
-.dsh-model-menu-chevron { color: var(--dsw-alias-label-caption); flex: none; transition: transform 0.12s; }
+.dsh-model-menu-chevron { color: var(--dsw-alias-label-caption); flex: none; transition: transform var(--ds-transition-duration) var(--ds-ease-in-out); }
 .dsh-model-menu-chevronOpen { transform: rotate(180deg); }
+/* Portal overlay: the host publishes no z-index token, so the card keeps the
+ * native menu layer's 1100 verbatim. */
 .dsh-model-menu-menu {
   z-index: 1100;
   --dsw-elevation-stroke-color: var(--dsw-alias-border-l1);
@@ -825,6 +845,8 @@ const modelMenuCss = `
 .dsh-model-menu-searchWithQuery { padding-right: 34px; }
 .dsh-model-menu-searchRow .dsh-model-menu-search input { padding: 0; font-size: 12px; line-height: normal; }
 .dsh-model-menu-searchRow .dsh-model-menu-search input::placeholder { color: var(--dsw-alias-label-caption); }
+/* The clear button is a circle by geometry (border-radius: 50%), a shape the
+ * radius token scale does not describe. */
 .dsh-model-menu-searchClear {
   width: 24px;
   height: 24px;
@@ -1072,6 +1094,17 @@ ${scope} {
 /* --- Layout scaffolding. --- */
 & .dsh-ui-stack { display: flex; flex-direction: column; gap: 12px; }
 & .dsh-ui-stack-lg { display: flex; flex-direction: column; gap: 20px; }
+/* Plugin detail pages share one reading column. These are layout recipes;
+ * controls keep their own primitive styles. Form spacing follows the host's
+ * settings-form/fields.module.css and SettingsForm.module.css. */
+& .dsh-ui-page { display: flex; flex-direction: column; gap: 16px; width: 100%; max-width: 760px; min-width: 0; }
+& .dsh-ui-form { display: flex; flex-direction: column; gap: 0; min-width: 0; }
+&.dsh-ui-form > .dsh-ui-field, & .dsh-ui-form > .dsh-ui-field { padding: 12px 0; }
+& .dsh-ui-form-footer { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; padding-top: 16px; min-width: 0; }
+& .dsh-ui-fields-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px 20px; min-width: 0; margin: 0; padding: 0; border: 0; }
+@media (max-width: 560px) {
+  & .dsh-ui-fields-grid { grid-template-columns: minmax(0, 1fr); }
+}
 & .dsh-ui-row { display: flex; align-items: center; gap: 8px; min-width: 0; }
 & .dsh-ui-row-wrap { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; }
 & .dsh-ui-spacer { flex: 1; min-width: 0; }
@@ -1099,6 +1132,9 @@ ${scope} {
  * official primitive, so this only owns the vertical rhythm. --- */
 & .dsh-ui-field { display: flex; flex-direction: column; gap: 6px; min-width: 0; }
 & .dsh-ui-field + .dsh-ui-field { border-top: 0.5px solid var(--dsw-alias-border-l2); padding-top: 12px; }
+/* Grid fields share a row, so the stacked-field divider must not win later in
+ * the cascade. Reset it here, after the field recipe. */
+& .dsh-ui-fields-grid > .dsh-ui-field { padding: 0; border: 0; }
 & .dsh-ui-label { display: flex; align-items: center; gap: 6px; font-size: 13px; line-height: 20px; font-weight: 500; color: var(--dsw-alias-label-primary); }
 & .dsh-ui-label-row { display: flex; align-items: baseline; justify-content: space-between; gap: 8px; }
 & .dsh-ui-help { font-size: 12px; line-height: 1.6; color: var(--dsw-alias-label-secondary); }
@@ -1289,7 +1325,7 @@ ${scope} {
   & *, & *::before, & *::after { transition-duration: 0.01ms !important; animation-duration: 0.01ms !important; }
 }
 }
-`.replace(/^& (\.dsh-ui-[a-z0-9-]+)(?![+>~])/gm, (_match, className) => `&${className}, & ${className}`);
+`.replace(/^& (\.dsh-ui-[a-z0-9-]+)(?=\s*\{)/gm, (_match, className) => `&${className}, & ${className}`);
 }
 //#endregion
 //#region ../dsh-plugin-kit/src/contracts.ts
@@ -1660,12 +1696,12 @@ const TEXT$1 = {
 	zh: {
 		title: "子代理阵容",
 		enabledLabel: "启用子代理阵容",
-		enabledHint: "启用后，主智能体显式为子代理选择模型时须使用此列表；不指定模型时仍继承父会话。任务倾向供委派时参考。",
+		enabledHint: "此名单限制子代理的显式选模；不指定模型时仍可继承父会话。名单修改对新建会话生效，已有会话及其子代理沿用原名单。任务倾向供委派时参考。",
 		loading: "正在读取…",
 		failed: (message) => `读取失败：${message}`,
 		syncFailed: (message) => `自动同步不可用：${message}`,
 		writeFailed: (message) => `未保存：${message}。请刷新后重试。`,
-		saved: "已保存，正在刷新…",
+		saved: "已保存。名单修改对新建会话生效。",
 		savedRefreshFailed: (message) => `已保存；阵容刷新失败：${message}。请刷新以读取最新设置。`,
 		conflict: "阵容设置已在别处修改，当前输入保留。请刷新核对后重试。",
 		tendencyFailed: (message) => `任务倾向不可用：${message}。原文件已保留；修复后刷新。`,
@@ -1697,12 +1733,12 @@ const TEXT$1 = {
 	en: {
 		title: "Subagent Cast",
 		enabledLabel: "Enable subagent cast",
-		enabledHint: "When enabled, explicit model selection for a subagent must use this list; omitting a model still inherits the parent session. The main agent consults task tendencies when delegating.",
+		enabledHint: "This list limits explicit subagent model choices; omitting a model can still inherit the parent session. List changes apply to new conversations. Existing conversations and their subagents keep their saved lists. Task tendencies guide delegation.",
 		loading: "Loading…",
 		failed: (message) => `Load failed: ${message}`,
 		syncFailed: (message) => `Live sync unavailable: ${message}`,
 		writeFailed: (message) => `Not saved: ${message}. Refresh, then try again.`,
-		saved: "Saved; refreshing…",
+		saved: "Saved. List changes apply to new conversations.",
 		savedRefreshFailed: (message) => `Saved; cast refresh failed: ${message}. Refresh to read the latest settings.`,
 		conflict: "Cast settings changed elsewhere; your draft is preserved. Refresh, review, then try again.",
 		tendencyFailed: (message) => `Task tendencies unavailable: ${message}. The original file is preserved; repair it, then refresh.`,
@@ -1991,7 +2027,7 @@ function CastPage({ api, locale }) {
 		refresh: refreshNow
 	};
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		className: "cast-root dsh-ui-stack",
+		className: "cast-root dsh-model-hub dsh-ui-stack",
 		"aria-label": t("title"),
 		"aria-busy": saving !== "" || refreshing,
 		children: [
@@ -2421,7 +2457,7 @@ function HubPage({ view, api, locale, initialEntries = null, initialCatalog = nu
 		refresh: refreshNow
 	};
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
-		className: "dsh-model-hub dsh-ui-stack",
+		className: "dsh-model-hub dsh-ui-page",
 		lang: t.language,
 		"aria-label": t("title"),
 		"aria-busy": writing !== "" || refreshing,