@fonlan/dsh-task-kanban 0.2.0 → 0.2.1

package/lib/index.js

@@ -3,7 +3,8 @@ import { settingsNamespace } from "@deepseek-ai/dsh-settings";
 import { randomUUID } from "node:crypto";
 import { appendFile, mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { createUserMessage } from "@deepseek-ai/dsh-llm";
+import { ReasoningEffortId, createUserMessage } from "@deepseek-ai/dsh-llm";
+import { installModelSelection } from "@deepseek-ai/dsh-agent";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { isSkillName, isUserInvocable, renderSkillContent } from "@deepseek-ai/dsh-skill";
@@ -12,12 +13,32 @@ import { defineTool } from "@deepseek-ai/dsh-tools";
 const KANBAN_SETTINGS_NS = settingsNamespace("task-kanban");
 const KanbanSettingsSchema = z.object({
 	maxParallelWorkers: z.natural().min(1).default(1),
-	defaultModel: z.string().default("")
+	refinementModel: z.string().default(""),
+	refinementProvider: z.string().default(""),
+	refinementReasoningEffort: z.string().default(""),
+	refinementPreset: z.string().default(""),
+	phaseModel: z.string().default(""),
+	phaseProvider: z.string().default(""),
+	phaseReasoningEffort: z.string().default(""),
+	phasePreset: z.string().default("")
 });
+const EMPTY_DEFAULTS = {
+	model: "",
+	provider: "",
+	reasoningEffort: "",
+	preset: ""
+};
 function registerSettings(ctx) {
 	let current = {
 		maxParallelWorkers: 1,
-		defaultModel: ""
+		refinementModel: "",
+		refinementProvider: "",
+		refinementReasoningEffort: "",
+		refinementPreset: "",
+		phaseModel: "",
+		phaseProvider: "",
+		phaseReasoningEffort: "",
+		phasePreset: ""
 	};
 	let service;
 	ctx.inject(["settings"], (sctx) => {
@@ -30,6 +51,24 @@ function registerSettings(ctx) {
 	});
 	return {
 		get: () => current,
+		sessionDefaults: (kind) => {
+			const s = current;
+			switch (kind) {
+				case "refine": return {
+					model: s.refinementModel,
+					provider: s.refinementProvider,
+					reasoningEffort: s.refinementReasoningEffort,
+					preset: s.refinementPreset
+				};
+				case "phase": return {
+					model: s.phaseModel,
+					provider: s.phaseProvider,
+					reasoningEffort: s.phaseReasoningEffort,
+					preset: s.phasePreset
+				};
+				case "merge": return EMPTY_DEFAULTS;
+			}
+		},
 		defaultModelRoute: () => {
 			if (service === void 0) return {};
 			try {
@@ -976,7 +1015,7 @@ var KanbanRunner = class {
 	async runRefinement(cardId, wsPath) {
 		const card = await this.store.get(wsPath, cardId);
 		if (card === void 0) return;
-		const route = await this.modelRoute(cardId, wsPath);
+		const route = await this.modelRoute(cardId, wsPath, "refine");
 		const sessionId = this.newSessionId();
 		this.sessionCards.set(sessionId, cardId);
 		await this.store.mutate(cardId, (c) => {
@@ -985,7 +1024,7 @@ var KanbanRunner = class {
 			c.sessions.refinement.push(sessionId);
 		}, wsPath);
 		try {
-			const handle = await this.createAgent(sessionId, wsPath, route);
+			const handle = await this.createAgent(sessionId, wsPath, route, "refine");
 			this.keepHandle(cardId, handle);
 			await this.attachRefinementSession(wsPath, sessionId);
 			const skill = card.skill !== void 0 ? await loadCardSkill(this.ctx, card.skill, wsPath, handle.agent) : void 0;
@@ -1089,19 +1128,47 @@ var KanbanRunner = class {
 			dispose
 		};
 	}
-	async createAgent(sessionId, cwd, route) {
+	/**
+	* Create one kanban session agent. `kind` decides the per-session preset:
+	* refine/phase use their settings default (falling back to the roster's
+	* default preset when unset), merge keeps the historical 'standard' preset.
+	* When the kind defaults configure a reasoning effort, an
+	* `installModelSelection` ref couples the provider/model + effort into every
+	* prompt assembly and model request. Without a configured effort no
+	* selection is installed: `agentOptions` carries the route and the loop
+	* materializes the model's own default effort — the historical behavior.
+	*/
+	async createAgent(sessionId, cwd, route, kind) {
 		const agentOptions = route.provider !== void 0 && route.model !== void 0 && route.model !== "" ? {
 			provider: route.provider,
 			model: route.model
 		} : void 0;
+		const selectionRef = {
+			current: route.provider !== void 0 && route.model !== void 0 && route.model !== "" ? {
+				provider: route.provider,
+				model: route.model,
+				...route.reasoningEffort !== void 0 && route.reasoningEffort !== "" ? { reasoningEffort: ReasoningEffortId(route.reasoningEffort) } : {}
+			} : void 0,
+			assembled: void 0
+		};
+		let presetId;
+		const presets = this.ctx.get("agentPresets");
+		if (presets !== void 0) {
+			const requested = kind === "merge" ? "standard" : this.settings.sessionDefaults(kind).preset;
+			presetId = (await presets.resolve(requested === "" ? void 0 : requested)).id;
+		}
 		return this.ctx.agents.create({
 			sessionId,
-			meta: { cwd },
+			meta: {
+				cwd,
+				...presetId !== void 0 ? { agentPreset: presetId } : {}
+			},
 			...agentOptions !== void 0 ? { agentOptions } : {},
 			setup: async (agentCtx) => {
 				const agentPresets = agentCtx.get("agentPresets");
-				if (agentPresets !== void 0) await agentPresets.mount(agentCtx, "standard");
+				if (agentPresets !== void 0) await agentPresets.mount(agentCtx, presetId);
 				else throw new Error("@fonlan/dsh-task-kanban: agent-presets service is not mounted");
+				if (selectionRef.current !== void 0 && selectionRef.current.reasoningEffort !== void 0) installModelSelection(agentCtx, selectionRef);
 			}
 		});
 	}
@@ -1133,8 +1200,15 @@ var KanbanRunner = class {
 			if (candidate !== void 0 && typeof candidate.resolveByPath === "function") return candidate;
 		}
 	}
-	/** Resolve the provider+model route for an agent (both are required). */
-	async modelRoute(cardId, wsPath) {
+	/**
+	* Resolve the provider+model route for an agent (both are required), plus
+	* the per-kind reasoning effort. Precedence per kind:
+	*   1. the card's explicit model (chosen at creation) — wins for every kind;
+	*   2. the session-kind defaults (refine/phase settings);
+	*   3. the host `agent-default-model` route.
+	* Merge sessions skip step 2 (no per-type defaults for them).
+	*/
+	async modelRoute(cardId, wsPath, kind) {
 		const card = await this.store.get(wsPath, cardId);
 		if (card === void 0) return {};
 		if (card.model !== "" && card.provider !== void 0 && card.provider !== "") return {
@@ -1148,14 +1222,12 @@ var KanbanRunner = class {
 				model: card.model
 			} : { model: card.model };
 		}
-		const userDefault = this.settings.get().defaultModel;
-		if (userDefault !== "") {
-			const fallback = this.settings.defaultModelRoute();
-			return fallback.provider !== void 0 ? {
-				provider: fallback.provider,
-				model: userDefault
-			} : { model: userDefault };
-		}
+		const kindDefaults = this.settings.sessionDefaults(kind);
+		if (kindDefaults.model !== "") return {
+			...kindDefaults.provider !== "" ? { provider: kindDefaults.provider } : {},
+			model: kindDefaults.model,
+			...kindDefaults.reasoningEffort !== "" ? { reasoningEffort: kindDefaults.reasoningEffort } : {}
+		};
 		return this.settings.defaultModelRoute();
 	}
 	async runCard(wsPath, card, entry) {
@@ -1252,9 +1324,9 @@ var KanbanRunner = class {
 				startedAt: Date.now()
 			});
 		}, wsPath);
-		const route = await this.modelRoute(cardId, wsPath);
+		const route = await this.modelRoute(cardId, wsPath, "phase");
 		try {
-			const handle = await this.createAgent(sessionId, workdir, route);
+			const handle = await this.createAgent(sessionId, workdir, route, "phase");
 			this.keepHandle(cardId, handle);
 			entry.cancel = () => handle.agent.cancel({ kind: "user" });
 			handle.agent.followup(this.asUserMessage(phasePrompt({
@@ -1546,9 +1618,9 @@ var KanbanRunner = class {
 		await this.store.mutate(cardId, (c) => {
 			c.sessions.merge.push(sessionId);
 		}, wsPath);
-		const route = await this.modelRoute(cardId, wsPath);
+		const route = await this.modelRoute(cardId, wsPath, "merge");
 		try {
-			const handle = await this.createAgent(sessionId, workdir, route);
+			const handle = await this.createAgent(sessionId, workdir, route, "merge");
 			this.keepHandle(cardId, handle);
 			handle.agent.followup(this.asUserMessage(mergePrompt(workdir, conflicts)));
 			await handle.agent.whenIdle();
@@ -1605,6 +1677,28 @@ async function listModels(ctx) {
 	} catch {}
 	return out;
 }
+/**
+* Resolve the adapter-owned reasoning efforts of one exact provider/model
+* route. On-demand (one model at a time) so the settings picker can offer the
+* levels the selected model actually supports; failures yield an empty list.
+*/
+async function reasoningOptions(ctx, provider, model) {
+	const llm = ctx.get("llm");
+	if (llm === void 0) return { efforts: [] };
+	try {
+		const info = await llm.resolveModelInfo(provider, model);
+		return {
+			efforts: (info.reasoning?.efforts ?? []).map((e) => ({
+				id: String(e.id),
+				name: e.name,
+				...e.description !== void 0 ? { description: e.description } : {}
+			})),
+			...info.reasoning?.defaultEffort !== void 0 ? { defaultEffort: String(info.reasoning.defaultEffort) } : {}
+		};
+	} catch {
+		return { efforts: [] };
+	}
+}
 //#endregion
 //#region src/server/rpc.ts
 const API_PREFIX = "/plugins/@fonlan/dsh-task-kanban/api";
@@ -1737,14 +1831,37 @@ function registerApiRoutes(ctx, runner, settings) {
 	route("retry", async (p) => runner.retryTask(requireString(p.cardId, "cardId")));
 	route("remove", async (p) => runner.deleteTask(requireString(p.cardId, "cardId")));
 	route("settings.get", async () => settings.get());
+	/** Every settings field the client may write (per-session-type defaults included). */
+	const SETTING_STRING_FIELDS = [
+		"refinementModel",
+		"refinementProvider",
+		"refinementReasoningEffort",
+		"refinementPreset",
+		"phaseModel",
+		"phaseProvider",
+		"phaseReasoningEffort",
+		"phasePreset"
+	];
 	route("settings.set", async (p) => {
 		const patch = {};
 		if (typeof p.maxParallelWorkers === "number") patch.maxParallelWorkers = p.maxParallelWorkers;
-		if (typeof p.defaultModel === "string") patch.defaultModel = p.defaultModel;
+		for (const key of SETTING_STRING_FIELDS) if (typeof p[key] === "string") patch[key] = p[key];
 		await settings.update(patch);
 		return settings.get();
 	});
 	route("models.list", async () => listModels(ctx));
+	route("presets.list", async () => {
+		const presets = ctx.get("agentPresets");
+		if (presets === void 0) return [];
+		return (await presets.list()).map((r) => ({
+			id: r.id,
+			name: r.name,
+			description: r.description
+		}));
+	});
+	route("reasoning.options", async (p) => {
+		return reasoningOptions(ctx, requireString(p.provider, "provider"), requireString(p.model, "model"));
+	});
 	return () => {
 		for (const d of disposers) d();
 	};

package/lib/types/server/models.d.ts

@@ -2,3 +2,19 @@ import type { Context } from '@deepseek-ai/cordis';
 import type { ModelOption } from '../shared/card.js';
 /** Available models from every registered LLM provider (advisory catalog). */
 export declare function listModels(ctx: Context): Promise<ModelOption[]>;
+/** One selectable reasoning effort of a model (display vocabulary for the settings picker). */
+export interface ReasoningEffortOption {
+    id: string;
+    name: string;
+    description?: string;
+}
+export interface ReasoningOptions {
+    efforts: ReasoningEffortOption[];
+    defaultEffort?: string;
+}
+/**
+ * Resolve the adapter-owned reasoning efforts of one exact provider/model
+ * route. On-demand (one model at a time) so the settings picker can offer the
+ * levels the selected model actually supports; failures yield an empty list.
+ */
+export declare function reasoningOptions(ctx: Context, provider: string, model: string): Promise<ReasoningOptions>;

package/lib/types/server/runner.d.ts

@@ -103,6 +103,16 @@ export declare class KanbanRunner implements KanbanToolResolver {
      * resolve it — only real human replies drive the interactive refinement.
      */
     private waitForUserReply;
+    /**
+     * Create one kanban session agent. `kind` decides the per-session preset:
+     * refine/phase use their settings default (falling back to the roster's
+     * default preset when unset), merge keeps the historical 'standard' preset.
+     * When the kind defaults configure a reasoning effort, an
+     * `installModelSelection` ref couples the provider/model + effort into every
+     * prompt assembly and model request. Without a configured effort no
+     * selection is installed: `agentOptions` carries the route and the loop
+     * materializes the model's own default effort — the historical behavior.
+     */
     private createAgent;
     private keepHandle;
     /**
@@ -114,7 +124,14 @@ export declare class KanbanRunner implements KanbanToolResolver {
     private attachRefinementSession;
     /** The host workspace registry, whichever service name carries it. */
     private attachRegistry;
-    /** Resolve the provider+model route for an agent (both are required). */
+    /**
+     * Resolve the provider+model route for an agent (both are required), plus
+     * the per-kind reasoning effort. Precedence per kind:
+     *   1. the card's explicit model (chosen at creation) — wins for every kind;
+     *   2. the session-kind defaults (refine/phase settings);
+     *   3. the host `agent-default-model` route.
+     * Merge sessions skip step 2 (no per-type defaults for them).
+     */
     private modelRoute;
     private runCard;
     private runPhase;

package/lib/types/server/settings.d.ts

@@ -1,20 +1,42 @@
 /**
- * User-facing plugin settings (global parallel worker count, default model),
- * persisted through the settings service namespace `task-kanban`. The DSH
- * settings service requires a lowercase kebab-case namespace
- * (/^[a-z][a-z0-9-]*$/), so the scoped package name cannot be used here.
+ * User-facing plugin settings (global parallel worker count, per-session-type
+ * model/effort/preset defaults), persisted through the settings service
+ * namespace `task-kanban`. The DSH settings service requires a lowercase
+ * kebab-case namespace (/^[a-z][a-z0-9-]*$/), so the scoped package name
+ * cannot be used here.
  */
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
-import type { KanbanSettingsShape } from '../shared/card.js';
+import type { KanbanSessionKind, KanbanSettingsShape } from '../shared/card.js';
 export declare const KANBAN_SETTINGS_NS: import("@deepseek-ai/dsh-settings").SettingsNamespace;
 export declare const KanbanSettingsSchema: z<Schemastery.ObjectS<{
     maxParallelWorkers: z<number, number>;
-    defaultModel: z<string, string>;
+    refinementModel: z<string, string>;
+    refinementProvider: z<string, string>;
+    refinementReasoningEffort: z<string, string>;
+    refinementPreset: z<string, string>;
+    phaseModel: z<string, string>;
+    phaseProvider: z<string, string>;
+    phaseReasoningEffort: z<string, string>;
+    phasePreset: z<string, string>;
 }>, Schemastery.ObjectT<{
     maxParallelWorkers: z<number, number>;
-    defaultModel: z<string, string>;
+    refinementModel: z<string, string>;
+    refinementProvider: z<string, string>;
+    refinementReasoningEffort: z<string, string>;
+    refinementPreset: z<string, string>;
+    phaseModel: z<string, string>;
+    phaseProvider: z<string, string>;
+    phaseReasoningEffort: z<string, string>;
+    phasePreset: z<string, string>;
 }>>;
+/** The per-session-type default slice a session kind resolves. */
+export interface KanbanSessionDefaults {
+    model: string;
+    provider: string;
+    reasoningEffort: string;
+    preset: string;
+}
 export interface KanbanSettingsFace {
     get(): KanbanSettingsShape;
     update(patch: Partial<KanbanSettingsShape>): Promise<void>;
@@ -23,5 +45,11 @@ export interface KanbanSettingsFace {
         provider?: string;
         model?: string;
     };
+    /**
+     * The configured model/effort/preset defaults for one session kind.
+     * `merge` sessions deliberately carry no per-type defaults: they keep the
+     * legacy resolution chain (card model → host default).
+     */
+    sessionDefaults(kind: KanbanSessionKind): KanbanSessionDefaults;
 }
 export declare function registerSettings(ctx: Context): KanbanSettingsFace;

package/lib/types/shared/card.d.ts

@@ -82,7 +82,18 @@ export interface ModelOption {
     id: string;
     name?: string;
 }
+/** Which kanban session kind a per-type default applies to. */
+export type KanbanSessionKind = 'refine' | 'phase' | 'merge';
 export interface KanbanSettingsShape {
     maxParallelWorkers: number;
-    defaultModel: string;
+    /** Requirement-refinement session defaults. */
+    refinementModel: string;
+    refinementProvider: string;
+    refinementReasoningEffort: string;
+    refinementPreset: string;
+    /** Phase implementation session defaults. */
+    phaseModel: string;
+    phaseProvider: string;
+    phaseReasoningEffort: string;
+    phasePreset: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonlan/dsh-task-kanban",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "DSH web plugin: a task kanban that refines requirements into phased plans, auto-executes them in git worktrees (one session per phase), and auto-merges into the main branch on completion.",
   "license": "MIT",
   "repository": {
@@ -44,6 +44,7 @@
   },
   "scripts": {
     "build": "rm -rf lib && tsc -p tsconfig.build.json && tsdown",
+    "prepare": "npm run build",
     "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.client.json",
     "bundle": "tsdown",
     "watch": "tsdown --watch",
@@ -64,6 +65,7 @@
         "@deepseek-ai/dsh-client-ui-layout",
         "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins",
         "@deepseek-ai/dsh-client-web-react"
       ]
     }
@@ -82,6 +84,7 @@
     "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.0-rc.6",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
@@ -104,6 +107,7 @@
     "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-layout": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.0-rc.6",
     "vitest": "^3.2.0"
   },
   "packageManager": "pnpm@11.21.0"

package/src/client/api.ts

@@ -69,6 +69,21 @@ export async function gatewaySkillList(sessionId: string): Promise<SkillOption[]
   return parsed.result.value?.skills ?? []
 }
 
+/** One row of the host `agentPresets.list()` roster. */
+export interface PresetOption {
+  id: string
+  name?: string
+  description?: string
+}
+
+/** Reasoning efforts of one provider/model route (`reasoning.options`). */
+export interface ReasoningOptions {
+  efforts: Array<{ id: string; name: string; description?: string }>
+  defaultEffort?: string
+  /** Client-side marker: the fetch failed; the stored effort must be kept. */
+  failed?: boolean
+}
+
 export const api = {
   list: (workspacePath: string) => call<KanbanCard[]>('list', { workspacePath }),
   create: (workspacePath: string, requirement: string, model: string, provider?: string, skill?: string) =>
@@ -80,4 +95,7 @@ export const api = {
   settingsGet: () => call<KanbanSettingsShape>('settings.get'),
   settingsSet: (patch: Partial<KanbanSettingsShape>) => call<KanbanSettingsShape>('settings.set', patch),
   models: () => call<ModelOption[]>('models.list'),
-}
+  presets: () => call<PresetOption[]>('presets.list'),
+  reasoningOptions: (provider: string, model: string) =>
+    call<ReasoningOptions>('reasoning.options', { provider, model }),
+}

package/src/client/board.css

@@ -41,9 +41,9 @@
   flex: 0 1 auto;
   padding: 6px 10px;
   border-radius: 6px;
-  border: 1px solid rgba(128, 128, 128, 0.35);
-  background: rgba(128, 128, 128, 0.12);
-  color: inherit;
+  border: 1px solid var(--dsw-alias-border-l2-darkmode-thin, var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.35)));
+  background: var(--dsw-specific-input-major, var(--dsw-alias-bg-layer-1, rgba(128, 128, 128, 0.12)));
+  color: var(--dsw-alias-label-primary, inherit);
   font-size: 14px;
 }
 .kb-btn {
@@ -272,17 +272,23 @@
   text-overflow: ellipsis;
 }
 .kb-field-row { display: flex; align-items: center; gap: 10px; justify-content: space-between; }
+/* Field labels in a row never wrap; selects get the remaining fixed width. */
+.kb-field-row > span { white-space: nowrap; flex-shrink: 0; margin-bottom: 0; }
 .kb-input {
   width: 100%;
   box-sizing: border-box;
   padding: 7px 10px;
   border-radius: 6px;
-  border: 1px solid rgba(128, 128, 128, 0.35);
-  background: rgba(128, 128, 128, 0.1);
-  color: inherit;
+  /* Form controls follow the shell theme: DSH's input surface token plus a
+     theme-tuned border; the fallbacks cover shells without these tokens. */
+  border: 1px solid var(--dsw-alias-border-l2-darkmode-thin, var(--dsw-alias-border-l2, rgba(128, 128, 128, 0.35)));
+  background: var(--dsw-specific-input-major, var(--dsw-alias-bg-layer-1, rgba(128, 128, 128, 0.1)));
+  color: var(--dsw-alias-label-primary, inherit);
   font-size: 13px;
 }
 .kb-input-number { width: 90px; }
+/* All settings selects share one width so the column looks even. */
+.kb-settings select.kb-input { width: 200px; flex: 0 0 200px; }
 .kb-textarea { min-height: 110px; resize: vertical; font-family: inherit; }
 .kb-modal-actions { display: flex; justify-content: flex-end; gap: 8px; margin-top: 14px; }
 .kb-detail-section { margin-bottom: 12px; }
@@ -350,6 +356,55 @@
 .kb-session-links { display: flex; flex-wrap: wrap; gap: 6px; align-items: center; }
 .kb-settings { display: flex; flex-direction: column; gap: 12px; max-width: 420px; }
 .kb-settings-saved { font-size: 12px; color: #4ade80; }
+.kb-settings-group { border-top: 1px solid rgba(128, 128, 128, 0.22); padding-top: 12px; }
+.kb-settings-group-title { font-size: 12px; font-weight: 600; opacity: 0.9; margin-bottom: 10px; }
+/* Settings card (设置 → 插件配置): mirrors the built-in plugin cards
+   (dsh-client-ui-settings-plugins PluginCard) — same surface, border, head
+   layout, and disclosure chevron, spelled with kb-settings-card prefixed
+   classes. The prefix deliberately does NOT reuse the board's `.kb-card*`
+   classes: the board card carries its own padding/cursor/user-select, and
+   sharing the root class would leak those onto the settings card. */
+.kb-settings-card {
+  border: 1px solid var(--dsw-alias-border-l2);
+  background: var(--dsw-alias-bg-layer-3);
+  border-radius: 12px;
+  list-style: none;
+  transition: border-color .16s, background .16s;
+}
+.kb-settings-card:hover { border-color: var(--dsw-alias-label-dimmed); }
+.kb-settings-card[data-open] {
+  background: var(--dsw-alias-bg-layer-2);
+  border-color: var(--dsw-alias-label-dimmed);
+}
+.kb-settings-card-head {
+  appearance: none;
+  width: 100%;
+  font: inherit;
+  color: inherit;
+  text-align: left;
+  cursor: pointer;
+  background: transparent;
+  border: 0;
+  border-radius: 12px;
+  align-items: center;
+  gap: 12px;
+  padding: 14px 16px;
+  display: flex;
+}
+.kb-settings-card-head:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary); outline-offset: -2px; }
+.kb-settings-card-headText { flex-direction: column; flex: 1; gap: 4px; min-width: 0; display: flex; }
+.kb-settings-card-title { color: var(--dsw-alias-label-primary); font-size: 15px; font-weight: 600; line-height: 1.4; }
+.kb-settings-card-sub { color: var(--dsw-alias-label-tertiary); font-size: 13px; line-height: 1.5; }
+.kb-settings-card-chevron {
+  color: var(--dsw-alias-label-tertiary);
+  flex: none;
+  transition: transform .16s;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.kb-settings-card-chevron[data-open] { transform: rotate(180deg); }
+.kb-settings-card-body { border-top: 1px solid var(--dsw-alias-border-l2); margin: 0 16px; padding: 12px 0 8px; }
 .kb-footer-action {
   display: inline-flex;
   align-items: center;

package/src/client/board.tsx

@@ -326,13 +326,6 @@ function NewTaskModal({ t, workspaces, selectedPath, sessionId, onClose, onCreat
     api.models()
       .then((list) => { if (alive) setModels(list) })
       .catch(() => { if (alive) setModels([]) })
-    api.settingsGet()
-      .then((s) => {
-        if (alive && s.defaultModel !== '') {
-          setModel(s.defaultModel)
-        }
-      })
-      .catch(() => undefined)
     return () => { alive = false }
   }, [])
 

package/src/client/index.tsx

@@ -2,9 +2,9 @@ import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
 import type {} from '@deepseek-ai/dsh-client-locale/client'
 import type {} from '@deepseek-ai/dsh-client-ui-sidebar/client'
 import type {} from '@deepseek-ai/dsh-client-ui-layout/client'
-import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
+import type {} from '@deepseek-ai/dsh-client-ui-settings-plugins/client'
 import { BoardRoot } from './board'
-import { KanbanFooterButton, KanbanSettingsSection } from './sections'
+import { KanbanFooterButton, KanbanSettingsCard } from './sections'
 import { LOCALE_NS, zh, en } from './locales'
 import { setClient, setBoardRoot, bindSessionNavigation } from './kanban-state'
 
@@ -35,13 +35,15 @@ export function apply(ctx: ClientContext): void {
     }, KanbanFooterButton as never),
   )
 
-  ctx.slots.inject('settings.section', () =>
+  // The plugin's own Settings Card (设置 → 插件配置) rides the `task-kanban`
+  // settings namespace: registering into the keyed `settings.plugin.item` slot
+  // with the namespace string makes the configurable-plugins tab dispatch the
+  // card next to the built-in ones (bash / agent loop / web search).
+  ctx.slots.inject('settings.plugin.item', () =>
     ctx.slots.register({
-      name: 'settings.section',
-      id: 'task-kanban',
-      order: 200,
-      label: () => t('settingsTitle'),
+      name: 'settings.plugin.item',
+      key: 'task-kanban',
       locale: LOCALE_NS,
-    }, KanbanSettingsSection as never),
+    }, KanbanSettingsCard as never),
   )
-}
+}

package/src/client/locales.ts

@@ -52,8 +52,15 @@ export const zh = {
   noWorkspace: '没有可用工作区，请先在侧边栏添加',
   refresh: '刷新',
   settingsTitle: '任务看板',
+  settingsDescription: '全局并行 worker 数与各会话类型的默认模型、推理强度、Agent 预设',
+  settingsExpand: '展开设置',
+  settingsCollapse: '收起设置',
   maxParallelWorkers: '全局并行 worker 数',
-  defaultModel: '默认模型',
+  settingsRefineGroup: '细化需求会话默认',
+  settingsPhaseGroup: 'Phase 实现会话默认',
+  reasoningEffort: '推理强度',
+  agentPreset: 'Agent 预设',
+  defaultOption: '（默认）',
   saved: '已保存',
   loadError: '加载任务失败',
   noPlan: '该卡片还没有实现计划，请先点击"添加并细化"',
@@ -120,8 +127,15 @@ export const en = {
   noWorkspace: 'No workspaces available — add one in the sidebar first',
   refresh: 'Refresh',
   settingsTitle: 'Task Kanban',
+  settingsDescription: 'Global parallel workers and per-session-type defaults for model, reasoning effort, and agent preset',
+  settingsExpand: 'Show settings',
+  settingsCollapse: 'Hide settings',
   maxParallelWorkers: 'Global parallel workers',
-  defaultModel: 'Default model',
+  settingsRefineGroup: 'Refinement session defaults',
+  settingsPhaseGroup: 'Phase implementation defaults',
+  reasoningEffort: 'Reasoning effort',
+  agentPreset: 'Agent preset',
+  defaultOption: '(default)',
   saved: 'Saved',
   loadError: 'Failed to load tasks',
   noPlan: 'This card has no plan yet — click "Add & Refine" first',