dsh-dock 0.11.5 → 0.12.0

package/features/tokenlog/view.jsx

@@ -4,7 +4,7 @@
 //  - 秒级时间范围查询 + 会话ID/提供商/模型(联动)/状态/推理强度 筛选，条件本地暂存
 //  - 9 张 KPI 卡 + 分组统计表 + 明细表（点击表头排序、会话ID点击即筛选、100 行/页上下双分页）
 //  - 状态列显示 HTTP 状态码徽章，行内【查看详情】弹窗展示完整信息；CSV 导出（中文表头，列序与明细表一致 + 合计行）
-//  - 独立的「单价设置」子弹窗：按模型配置单价（支持多段分时价）并持久化，费用按自填单价重算
+//  - 独立的「单价设置」子弹窗：按模型配置单价（多段分时价 + 日期类型/法定节假日）并持久化，费用按自填单价重算
 //  - 挂载即扫描历史+按暂存条件查询；挂载期间每 5s 静默自动刷新
 //  - 查询等待动画：点「查询」后按钮转圈扫光 + 数据区顶部「记账小队清点」banner（轮换俏皮文案，
 //    等久了换语气），旧数据压暗禁点；结果到位时闪一次「✓ 数据已更新」并让 KPI 卡回弹
@@ -396,7 +396,7 @@ const css = `
 .dtok-code.pend{color:var(--dsw-alias-label-tertiary,#94a3b8);}
 .dtok-detail-link{color:var(--dk-accent);cursor:pointer;font-size:11px;}
 .dtok-detail-link:hover{text-decoration:underline;}
-.dtok-detail{position:fixed;inset:0;z-index:10000;background:rgba(0,0,0,0.5);display:flex;align-items:center;justify-content:center;}
+.dtok-detail{position:fixed;inset:0;z-index:201;background:rgba(0,0,0,0.5);display:flex;align-items:center;justify-content:center;}
 .dtok-detail-card{background:var(--dsw-alias-bg-layer-2,#1c212b);border:1px solid var(--dsw-alias-border-l2,#3a4150);border-radius:12px;padding:20px 24px;max-width:640px;width:92%;max-height:80vh;overflow:auto;color:var(--dsw-alias-label-primary,#e8eaf0);}
 .dtok-detail-card h3{margin:0 0 12px;font-size:15px;}
 .dtok-detail-row{display:flex;gap:8px;padding:4px 0;font-size:12px;border-bottom:1px solid var(--dk-tdim);}
@@ -460,7 +460,7 @@ const css = `
 .dtok-btn.primary:not([disabled]):active{transform:none;}
 }
 /* ---- 单价设置（子弹窗） ---- */
-.dtok-pm-backdrop{position:fixed;inset:0;z-index:2100;background:rgba(15,17,21,.5);backdrop-filter:blur(3px);display:flex;align-items:center;justify-content:center;}
+.dtok-pm-backdrop{position:fixed;inset:0;z-index:201;background:rgba(15,17,21,.5);backdrop-filter:blur(3px);display:flex;align-items:center;justify-content:center;}
 .dtok-pm{box-sizing:border-box;width:min(980px,calc(100vw - 32px));height:min(760px,calc(100vh - 32px));display:flex;flex-direction:column;border-radius:14px;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-2,#1c212b);color:var(--dsw-alias-label-primary);box-shadow:0 20px 64px rgb(0 0 0 / .4);overflow:hidden;}
 .dtok-pm.max{border-radius:10px;}
 .dtok-pm-head{display:flex;align-items:center;gap:10px;padding:10px 12px;border-bottom:1px solid var(--dsw-alias-border-l1);cursor:move;user-select:none;flex:none;background:var(--dsw-alias-bg-layer-1);}
@@ -488,6 +488,9 @@ const css = `
 .dtok-pseg{display:flex;align-items:center;gap:6px;flex-wrap:wrap;margin:4px 0;}
 .dtok-pseg-name{font-size:11px;color:var(--dsw-alias-label-secondary);min-width:112px;}
 .dtok-pseg-tilde{font-size:11px;color:var(--dsw-alias-label-secondary);}
+.dtok-price select{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-border-l2);border-radius:6px;padding:4px 6px;font-size:12px;font-family:inherit;}
+.dtok-price textarea{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-border-l2);border-radius:6px;padding:6px 8px;font-size:12px;font-family:inherit;min-height:64px;resize:vertical;width:100%;box-sizing:border-box;}
+.dtok-days{font-size:11px;}
 .dtok-src{font-size:11px;color:var(--dsw-alias-label-tertiary,#94a3b8);}
 .dtok-src.custom{color:var(--dsw-alias-state-success-primary,#4ade80);}
 .dtok-src.fallback{color:var(--dk-warn);}
@@ -571,10 +574,12 @@ function Detail({ rec, onClose, rate }) {
 // 独立子弹窗（可最大化 / 拖动 / 缩放），与功能坞面板解耦，方便配置较长时段表。
 function numStr(v) { return v === undefined || v === null ? "" : String(v); }
 
-/** 时段草稿：一个 { start,end,input,output,cacheRead,cacheWrite } 的可编辑副本。 */
+/** 时段草稿：一个 { start,end,days,input,output,cacheRead,cacheWrite } 的可编辑副本。 */
 function segToDraft(s) {
+	const d = s && s.days;
 	return {
 		start: numStr(s && s.start), end: numStr(s && s.end),
+		days: d === "workday" || d === "nonworkday" ? d : "all",
 		input: numStr(s && s.input), output: numStr(s && s.output),
 		cacheRead: numStr(s && s.cacheRead), cacheWrite: numStr(s && s.cacheWrite),
 	};
@@ -641,6 +646,11 @@ function PriceModal({ onClose, onSaved }) {
 		return () => window.removeEventListener("keydown", onKey);
 	}, [onClose]);
 
+	// 遮罩关闭必须「按下也在遮罩上」。
+	// 从弹窗内按下、拖选/拖出后在遮罩松开时，click 会派发到共同祖先（遮罩），
+	// 若无此标记会把框选误判成点外部关闭（2026-09-23 用户反馈）。
+	const backdropDownRef = useRef(false);
+
 	const style = maxed
 		? { position: "fixed", left: 8, top: 8, right: 8, bottom: 8, width: "auto", height: "auto" }
 		: geom
@@ -651,7 +661,15 @@ function PriceModal({ onClose, onSaved }) {
 	// 无 document（测试沙箱）/无 createPortal 时退回就地渲染，行为不变。
 	const portalTarget = typeof document !== "undefined" && document.body ? document.body : null;
 	const overlay = (
-		<div className="dtok-pm-backdrop" onClick={onClose}>
+		<div
+			className="dtok-pm-backdrop"
+			onPointerDown={(e) => { backdropDownRef.current = e.target === e.currentTarget; }}
+			onClick={(e) => {
+				if (!backdropDownRef.current) return;
+				if (e.target !== e.currentTarget) return;
+				onClose();
+			}}
+		>
 			<div ref={dlgRef} className={"dtok-pm" + (maxed ? " max" : "")} style={style} onClick={(e) => e.stopPropagation()}>
 				<div className="dtok-pm-head" onPointerDown={(e) => startDrag(e, "move")} onDoubleClick={() => setMaxed((v) => !v)}>
 					<b>单价设置</b>
@@ -679,24 +697,27 @@ function PricingEditor({ onClose, onSaved, embedded }) {
 	const [rate, setRate] = useState("7.2");
 	const [fetchOn, setFetchOn] = useState(true);
 	const [fb, setFb] = useState({ input: "", output: "", cacheRead: "", cacheWrite: "" });
+	const [holidaysText, setHolidaysText] = useState("");
 	const [newMatch, setNewMatch] = useState("");
 	const [msg, setMsg] = useState(null);
 	const [saving, setSaving] = useState(false);
 
+	const applyCfg = (d) => {
+		setCfg(d);
+		setRate(numStr(d.usdCnyRate));
+		setFetchOn(!!d.fetchOfficial);
+		setFb({
+			input: numStr(d.fallback && d.fallback.input), output: numStr(d.fallback && d.fallback.output),
+			cacheRead: numStr(d.fallback && d.fallback.cacheRead), cacheWrite: numStr(d.fallback && d.fallback.cacheWrite),
+		});
+		setHolidaysText((d.holidays || []).join("\n"));
+		setRows((d.pricing || []).map(rowToDraft));
+	};
+
 	useEffect(() => {
 		let cancel = false;
 		rpcCall("pricing", {})
-			.then((d) => {
-				if (cancel) return;
-				setCfg(d);
-				setRate(numStr(d.usdCnyRate));
-				setFetchOn(!!d.fetchOfficial);
-				setFb({
-					input: numStr(d.fallback && d.fallback.input), output: numStr(d.fallback && d.fallback.output),
-					cacheRead: numStr(d.fallback && d.fallback.cacheRead), cacheWrite: numStr(d.fallback && d.fallback.cacheWrite),
-				});
-				setRows((d.pricing || []).map(rowToDraft));
-			})
+			.then((d) => { if (!cancel) applyCfg(d); })
 			.catch((e) => { if (!cancel) setMsg({ ok: false, text: String((e && e.message) || e) }); });
 		return () => { cancel = true; };
 	}, []);
@@ -728,12 +749,14 @@ function PricingEditor({ onClose, onSaved, embedded }) {
 			};
 			const peaks = (r.peaks || []).map((s) => ({
 				start: Number(s.start || 0), end: Number(s.end || 0),
+				days: s.days === "workday" || s.days === "nonworkday" ? s.days : "all",
 				input: Number(s.input || 0), output: Number(s.output || 0),
 				cacheRead: Number(s.cacheRead || 0), cacheWrite: Number(s.cacheWrite || 0),
 			}));
 			if (peaks.length) out.peaks = peaks;
 			return out;
 		});
+		payload.holidays = holidaysText.split(/\r?\n/).map((s) => s.trim()).filter(Boolean);
 		payload.fallback = {
 			input: Number(fb.input || 0), output: Number(fb.output || 0),
 			cacheRead: Number(fb.cacheRead || 0), cacheWrite: Number(fb.cacheWrite || 0),
@@ -741,8 +764,7 @@ function PricingEditor({ onClose, onSaved, embedded }) {
 		setSaving(true); setMsg(null);
 		rpcCall("setpricing", payload)
 			.then((d) => {
-				setCfg(d);
-				setRows((d.pricing || []).map(rowToDraft));
+				applyCfg(d);
 				setMsg({ ok: true, text: "单价已保存，费用已按新价即时重算" });
 				if (onSaved) onSaved();
 			})
@@ -765,9 +787,18 @@ function PricingEditor({ onClose, onSaved, embedded }) {
 	);
 	const segLabel = (s) => {
 		const a = numStr(s.start), b = numStr(s.end);
-		if (a === "" || b === "") return "时段";
-		return a + "~" + b + (Number(a) === Number(b) ? "（全天）" : Number(a) > Number(b) ? "（跨零点）" : "");
+		const dayTag = s.days === "workday" ? "工作日" : s.days === "nonworkday" ? "周末/节假日" : "";
+		const time = a === "" || b === "" ? "时段"
+			: a + "~" + b + (Number(a) === Number(b) ? "（全天）" : Number(a) > Number(b) ? "（跨零点）" : "");
+		return dayTag ? dayTag + " " + time : time;
 	};
+	const daysSelect = (value, onChange) => (
+		<select className="dtok-days" value={value || "all"} onChange={(e) => onChange(e.target.value)} title="该时段在哪类日期生效">
+			<option value="all">每天</option>
+			<option value="workday">仅工作日</option>
+			<option value="nonworkday">仅周末/节假日</option>
+		</select>
+	);
 
 	return (
 		<div className={embedded ? "dtok-price emb" : "dtok-price"} onClick={(e) => e.stopPropagation()}>
@@ -782,6 +813,20 @@ function PricingEditor({ onClose, onSaved, embedded }) {
 				</label>
 			</div>
 
+			<div>
+				<div className="dtok-section-title" style={{ margin: "0 0 4px" }}>法定节假日（供「仅工作日」分时段判定）</div>
+				<div className="dtok-price-field" style={{ maxWidth: 420 }}>
+					<label>每行一条：单日 2026-10-01，或区间 2026-10-01~2026-10-07（含两端）</label>
+					<textarea
+						value={holidaysText}
+						placeholder={"2026-10-01~2026-10-07\n2027-01-01"}
+						onChange={(e) => setHolidaysText(e.target.value)}
+						spellCheck={false}
+					/>
+				</div>
+				<div className="dtok-price-hint">周末（周六/周日）与这些节假日视为非工作日；标了「仅工作日」的高峰段在这些日期回落基准价（谷价）。</div>
+			</div>
+
 			<div>
 				<div className="dtok-section-title" style={{ margin: "0 0 4px" }}>按模型配置单价（{rows.length} 条）</div>
 				{onFallback.length > 0 ? (
@@ -806,12 +851,14 @@ function PricingEditor({ onClose, onSaved, embedded }) {
 							缓存写入＝未命中缓存、本次新建缓存的那部分输入（Claude 等按溢价单独收建缓存费）；DeepSeek 不收此项，填 0 即可。
 						</div>
 						<div className="dtok-price-hint" style={{ marginTop: 2 }}>
-							分时段价（可多段，命中哪段用哪段；时段外回落到基准价。start&gt;end 表示跨零点，如 23~7；start=end 表示全天）
+							分时段价（可多段，命中哪段用哪段；时段外回落到基准价。start&gt;end 表示跨零点，如 23~7；start=end 表示全天。
+							每段可选日期类型：每天 / 仅工作日（非周末且非下方节假日）/ 仅周末或节假日——如 DeepSeek「工作日 9~12、14~18 双倍，周末与节假日全天谷价」）
 						</div>
 						{r.peaks.length === 0 ? <div className="dtok-price-hint">（未设置分时段，按基准价计费）</div> : null}
 						{r.peaks.map((s, k) => (
 							<div className="dtok-pseg" key={k}>
 								<span className="dtok-pseg-name">{segLabel(s)}</span>
+								{daysSelect(s.days, (v) => patchSeg(i, k, { days: v }))}
 								{num(s.start, (v) => patchSeg(i, k, { start: v }), { width: 56 })}
 								<span className="dtok-pseg-tilde">~</span>
 								{num(s.end, (v) => patchSeg(i, k, { end: v }), { width: 56 })}
@@ -823,7 +870,7 @@ function PricingEditor({ onClose, onSaved, embedded }) {
 								<button className="dtok-btn tiny" onClick={() => delSeg(i, k)}>删除时段</button>
 							</div>
 						))}
-						<div className="dtok-price-hint" style={{ opacity: .85 }}>时段价从左到右：输入（命中）/ 输入（未命中）/ 输出 / 缓存写入</div>
+						<div className="dtok-price-hint" style={{ opacity: .85 }}>时段价从左到右：日期类型 / 起~止时 / 输入（命中）/ 输入（未命中）/ 输出 / 缓存写入</div>
 						<button className="dtok-btn tiny" onClick={() => addSeg(i)}>+ 添加时段</button>
 					</div>
 				))}
@@ -858,7 +905,7 @@ function PricingEditor({ onClose, onSaved, embedded }) {
 								{cfg.builtin.map((b) => (
 									<tr key={b.match}>
 										<td>{b.match}</td><td>{b.cacheRead}</td><td>{b.input}</td><td>{b.output}</td><td>{b.cacheWrite}</td>
-										<td>{b.peaks && b.peaks.length ? b.peaks.map((s) => s.start + "~" + s.end).join("、") + "时" : "—"}</td>
+										<td>{b.peaks && b.peaks.length ? b.peaks.map((s) => (s.days === "workday" ? "工作日" : s.days === "nonworkday" ? "周末/节假" : "") + s.start + "~" + s.end).join("、") + "时" : "—"}</td>
 									</tr>
 								))}
 							</tbody>
@@ -1361,7 +1408,7 @@ export const feature = {
 	name: "用量记录",
 	order: 110,
 	accent: "#fbbf24",
-	description: "记录全部 LLM API 调用：秒级时间筛选、Token/费用统计（可配置各模型单价，持久保存并按自填单价计费；内置峰谷计价+官网价目自动同步作兜底）、分组汇总、明细检索与 CSV 导出",
+	description: "记录全部 LLM API 调用：秒级时间筛选、Token/费用统计（可配置各模型单价，持久保存并按自填单价计费；多段分时价可限定工作日/周末节假日，内置峰谷计价+官网价目自动同步作兜底）、分组汇总、明细检索与 CSV 导出",
 	css,
 	View: TokenLogView,
 	HomeStat: TokenLogHomeStat,

package/features/visionproxy/host.js

@@ -7,7 +7,7 @@
 // 配置存自有 settings 命名空间 dsh-dock（visionProxy: enabled/provider/model），
 // 其编辑 UI 在模型设置页内（见 features/modelconfig/view.js）。
 import { BlockAssembler } from '@deepseek-ai/dsh-llm'
-import { DOCK_NS } from '../../src/host-core.js'
+import { readDockRoot } from '../../src/host-core.js'
 import { readModelDirectory } from '../modelconfig/host.js'
 
 /** 递归判断内容块里是否有图片（含 tool-result 嵌套，与官方 contentHasImage 同构）。 */
@@ -223,8 +223,7 @@ function installVisionProxy(ctx, directory) {
   const deps = {
     config: () => {
       try {
-        const settings = ctx.get('settings')
-        const v = settings && typeof settings.get === 'function' ? settings.get(DOCK_NS) : undefined
+        const v = readDockRoot(ctx)
         return v && v.visionProxy ? v.visionProxy : { enabled: false, provider: '', model: '' }
       } catch {
         return { enabled: false, provider: '', model: '' }

package/index.js

@@ -16,7 +16,7 @@
 //   - notify      任务通知：完成/异常/需确认通知 + 提示音/系统通知/钉钉飞书推送（从任务动画拆出）
 //   - runstate    运行状态：进行中任务与最近完成一览（从任务动画拆出；只读，无配置段）
 //   - mobile-relay 手机接力（未发布）：扫码反向代理接力 + 局域网电脑直连（0.0.0.0）
-import { DOCK_NS, DockConfig, sendJson, readBody, migrateNotifyConfig, migrateModelsFeatureId } from './src/host-core.js'
+import { DockConfig, sendJson, readBody, migrateNotifyConfig, migrateModelsFeatureId, migrateImportedFeatures, bindDockConfig, readDockRoot, mutateDockSection } from './src/host-core.js'
 import { feature as fModels } from './features/modelconfig/host.js'
 import { feature as fVisionProxy } from './features/visionproxy/host.js'
 import { feature as fBalance } from './features/balance/host.js'
@@ -28,7 +28,10 @@ import { feature as fMobileRelay } from './features/mobile-relay/host.js'
 
 export const name = 'dsh-dock'
 
-// 硬依赖 webServer（路由注册）+ llm（图片理解代理包装）+ settings（自有命名空间读写）。
+/** Config schema：dsh ≥ 0.1.7-alpha.1 SettingsForms 要求插件导出同名 Config，否则 mutate 报 No configurable plugin entry。 */
+export const Config = DockConfig
+
+// 硬依赖 webServer（路由注册）+ llm（图片理解代理包装）+ settings（SettingsForms 写回）。
 export const inject = ['webServer', 'llm', 'settings']
 
 /** 测试钩子：清空识别缓存（冒烟在用例间隔离；实现在 visionproxy 模块）。 */
@@ -50,7 +53,7 @@ if (typeof process !== 'undefined' && typeof process.on === 'function' && !proce
   })
 }
 
-export function apply(ctx) {
+export function apply(ctx, config) {
   // ---- 功能注册表（Host 侧）：每个条目来自对应功能模块的 feature 描述符 ----
   // defaultEnabled：与 Client 半部保持一致。已接入的功能默认打开，
   // 规划中的功能缺省 false，等实现后移除 roadmap 并打开。
@@ -65,17 +68,22 @@ export function apply(ctx) {
     fMobileRelay,
   ]
 
+  // 绑定 Config 镜像（替代已移除的 settings.get）；volatile 字段热更时重绑。
+  bindDockConfig(config)
+  ctx.on('loader/volatile-update', () => {
+    try { bindDockConfig(config) } catch { /* Config 形态异常时保持旧镜像 */ }
+  })
+
   const state = new Map()
   for (const f of FEATURES) state.set(f.id, { enabled: false, dispose: null, error: null })
 
-  /** 读宿主侧功能开关表（settings 持久化；settings 未挂载时回退 defaultEnabled）。
-   *  兼容别名：宿主侧【模型设置】功能 id 曾叫 models（与客户端 modelconfig 对不上，
-   *  开关永远推不到宿主）；迁移落盘前（异步）在这里读时兜底换算，保证启动开关表
-   *  与 /dsh-dock/features 响应第一时间就是新口径。 */
+  // 读宿主侧功能开关表（本地 Config 镜像优先；settings 未挂载时回退 defaultEnabled）。
+  // 兼容别名：宿主侧【模型设置】功能 id 曾叫 models（与客户端 modelconfig 对不上，
+  // 开关永远推不到宿主）；迁移落盘前（异步）在这里读时兜底换算，保证启动开关表
+  // 与 /dsh-dock/features 响应第一时间就是新口径。
   function persistedFeatureMap() {
     try {
-      const settings = ctx.get('settings')
-      const v = settings && typeof settings.get === 'function' ? settings.get(DOCK_NS) : null
+      const v = readDockRoot(ctx)
       if (v && typeof v === 'object' && v.features && typeof v.features === 'object') {
         const map = v.features
         if (typeof map.models === 'boolean' && typeof map.modelconfig !== 'boolean') {
@@ -115,25 +123,47 @@ export function apply(ctx) {
     }
   }
 
-  // 自有 settings 命名空间（dsh-dock）：功能开关与各功能配置的持久化；
-  // 读取走 settings.get（内存 resolved 值，写入经 settings.mutate，均热生效）。
-  // 宿主侧初始开关也在这里应用：settings 命名空间注册完成后才能读到持久化开关表
-  // （apply() 同步执行时注册尚未生效，读到的永远是空值）。
+  // 自有 Config 段（profile 条目 id dsh-dock）：功能开关与各功能配置的持久化。
+  // 读走本地镜像（apply 的 config / loader/volatile-update），写经 settings.mutate。
+  // 关键顺序：先跑完一次性迁移（可能改写 features），再应用初始开关——
+  // 否则首次启动时 bind 的还是空默认值，migrate 尚未落盘就 setEnabled，
+  // 面板显示 persisted=true 却全部「未启用」、路由 404/405（2026-09-23 事故）。
   let initialTogglesApplied = false
   ctx.inject(['settings'], (sctx) => {
-    sctx.settings.register(DOCK_NS, DockConfig, {})
-    // 一次性迁移：通知配置从 animation 段搬到 notify 段（【任务通知】独立成模块）。
-    // 必须在任何面板保存动作之前跑——animation 模块保存时整段写回，旧字段会被覆盖丢失。
-    migrateNotifyConfig(sctx)
-    // 一次性迁移：宿主侧【模型设置】功能 id models → modelconfig（开关表键名对齐客户端）。
-    migrateModelsFeatureId(sctx)
-    if (initialTogglesApplied) return
-    initialTogglesApplied = true
-    const persisted = persistedFeatureMap()
-    for (const f of FEATURES) {
-      const saved = persisted ? persisted[f.id] : undefined
-      setEnabled(f.id, typeof saved === 'boolean' ? saved : !!f.defaultEnabled)
-    }
+    // 0.1.7-alpha.1 起 settings.register 已移除——不再调用；导出 Config 即注册。
+    Promise.resolve()
+      // 通知配置从 animation 段搬到 notify 段（【任务通知】独立成模块）。
+      // 必须在任何面板保存动作之前跑——animation 模块保存时整段写回，旧字段会被覆盖丢失。
+      .then(() => migrateNotifyConfig(sctx))
+      // 宿主侧【模型设置】功能 id models → modelconfig（开关表键名对齐客户端）。
+      .then(() => migrateModelsFeatureId(sctx))
+      // settings.yaml.imported 里停住的功能开关表（Config 导出前 import 失败的那段）。
+      .then(() => migrateImportedFeatures(sctx))
+      .then(() => {
+        // 迁移可能 mutate 过 Config：刷新镜像后再读开关表。
+        try { bindDockConfig(config) } catch { /* 保持旧镜像 */ }
+        if (initialTogglesApplied) return
+        initialTogglesApplied = true
+        const persisted = persistedFeatureMap()
+        for (const f of FEATURES) {
+          const saved = persisted ? persisted[f.id] : undefined
+          setEnabled(f.id, typeof saved === 'boolean' ? saved : !!f.defaultEnabled)
+        }
+        console.log('[dsh-dock] initial toggles applied:', FEATURES
+          .filter((f) => state.get(f.id).enabled)
+          .map((f) => f.id).join(', ') || '(none)')
+      })
+      .catch((e) => {
+        console.error('[dsh-dock] settings init/migration failed:', (e && e.message) || e)
+        // 迁移失败也要尝试按当前镜像启用，避免整坞空白。
+        if (initialTogglesApplied) return
+        initialTogglesApplied = true
+        const persisted = persistedFeatureMap()
+        for (const f of FEATURES) {
+          const saved = persisted ? persisted[f.id] : undefined
+          setEnabled(f.id, typeof saved === 'boolean' ? saved : !!f.defaultEnabled)
+        }
+      })
   })
 
   // 功能开关管理路由（无条件注册）：GET 查询各功能宿主侧状态；POST 同步开关——
@@ -152,10 +182,11 @@ export function apply(ctx) {
               const enabled = !!(body && body.enabled)
               if (!state.has(id)) return sendJson(res, 404, { ok: false, error: { message: `未知功能：${id}` } })
               setEnabled(id, enabled)
-              const settings = ctx.get('settings')
-              if (settings && typeof settings.mutate === 'function') {
+              try {
                 const features = Object.assign({}, persistedFeatureMap() || {}, { [id]: enabled })
-                await settings.mutate(DOCK_NS, [{ op: 'set', path: ['features'], value: features }])
+                await mutateDockSection(ctx, ['features'], features)
+              } catch (e) {
+                console.error('[dsh-dock] feature toggle persist failed:', (e && e.message) || e)
               }
             }
             const persisted = persistedFeatureMap() || {}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-dock",
-  "version": "0.11.5",
-  "description": "DeepSeek Harness 功能坞插件（dsh-dock）：模块化功能中枢——每个功能一个 features/ 模块（可单独提取成包发布，又可经 dockBridge 装回面板）。含用量记录（LLM 调用记账/费用统计，支持各模型自定义单价与多段分时价）、模型设置、图片理解代理、模型余额、任务动画（19 种运行动画 + 桌面伙伴 3D 场景）、任务通知（完成/异常/需确认通知、提示音、系统通知、钉钉/飞书推送）、运行状态（进行中任务与最近完成一览）；侧栏入口 + 可拖拽弹窗（最大化/最小化/缩放）。",
+  "version": "0.12.0",
+  "description": "DeepSeek Harness 功能坞插件（dsh-dock）：模块化功能中枢——每个功能一个 features/ 模块（可单独提取成包发布，又可经 dockBridge 装回面板）。含用量记录（LLM 调用记账/费用统计，支持各模型自定义单价、多段分时价与周末/节假日谷价）、模型设置、图片理解代理、模型余额、任务动画（19 种运行动画 + 桌面伙伴 3D 场景）、任务通知（完成/异常/需确认通知、提示音、系统通知、钉钉/飞书推送）、运行状态（进行中任务与最近完成一览）；侧栏入口 + 可拖拽弹窗（最大化/最小化/缩放）。",
   "type": "module",
   "main": "index.js",
   "files": [
@@ -57,10 +57,12 @@
   },
   "dependencies": {
     "js-yaml": "^4.1.0",
-    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.1",
     "qrcode": "^1.5.4"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-credentials": "*",
+    "@deepseek-ai/dsh-llm": "*",
+    "@deepseek-ai/dsh-settings": "*",
+    "@deepseek-ai/schemastery": "*"
   }
-}
+}

package/src/client.jsx

@@ -30,7 +30,7 @@ import { feature as fGames } from "../features/games/view.jsx";
 import { feature as fMobileRelay } from "../features/mobile-relay/view.jsx";
 
 const name = "dsh-dock";
-const DOCK_VERSION = "0.11.3";
+const DOCK_VERSION = "0.12.0";
 
 // ---- 内置功能注册表：新功能 = features/<id>/ 加模块 + 这里 import 一行 ----
 const BUILTIN_FEATURES = [fTokenlog, fModelconfig, fHeartbeat, fTheme, fBalance, fAnimation, fNotify, fRunState, fGames, fMobileRelay];
@@ -238,6 +238,11 @@ function fullDockCss() {
 // 样式全局注入一次（入口按钮与右下角浮层挂在设置页之外，不能依赖页内 <style>）。
 // 这里用 SHELL_CSS 唯一命名，并做防御：注入永不抛错、失败只降级不打断启动；
 // 外部功能注册携带样式时可重算更新（外部样式后到）。
+//
+// ⚠️ 必须同时打 data-plugin="dsh-dock"（官方 claimStyles/removeOwnedStyles 归属协议）：
+// 只有 data-plugin-css 的无主 <style> 会被任意后 materialize 的插件 claim 走，
+// 对方卸载时 removeOwnedStyles 会连带删掉功能坞样式——表现为「开关别的插件后样式坏了、
+// 要手动刷新才正常」。见 packages/client/modules claimStyles。
 function ensureCss() {
 	if (typeof document === "undefined") return;
 	cancelInitialCssSchedule();
@@ -247,19 +252,21 @@ function ensureCss() {
 				dockCssTag = document.querySelector('style[data-plugin-css="dsh-dock"]');
 			} else {
 				dockCssTag = document.createElement("style");
-				dockCssTag.dataset.pluginCss = "dsh-dock";
 				document.head.appendChild(dockCssTag);
 			}
 		}
+		// 归属与标识：缺 data-plugin 的旧标签/被 claim 走的标签一律改回本插件
+		dockCssTag.dataset.plugin = "dsh-dock";
+		dockCssTag.dataset.pluginCss = "dsh-dock";
 		dockCssTag.textContent = fullDockCss();
 	} catch (e) {
 		console.error("[dsh-dock] ensureCss failed:", e && e.message ? e.message : String(e));
 	}
 }
-// 刷新页时宿主内容优先绘制：功能坞样式很大，首帧同步解析会让整页短暂停顿。
-// 首次注入延后到浏览器空闲期；之后的外部模块注册仍走 ensureCss() 立即更新。
+// 首次注入延后到浏览器空闲期：功能坞样式很大，首帧同步解析会让整页短暂停顿。
+// 之后的外部模块注册仍走 ensureCss() 立即更新；apply() 另有同步一击（见下）。
 function scheduleInitialCss() {
-	if (typeof document === "undefined" || initialCssSchedule || (dockCssTag && dockCssTag.isConnected)) return;
+	if (typeof document === "undefined" || initialCssSchedule || (dockCssTag && dockCssTag.isConnected && dockCssTag.dataset.plugin === "dsh-dock")) return;
 	const run = () => {
 		initialCssSchedule = null;
 		ensureCss();
@@ -649,7 +656,10 @@ const ctxRef = { current: null };
 
 export function apply(ctx) {
 	ctxRef.current = ctx;
-	scheduleInitialCss();
+	// 同步注入归属完整的样式：插件开关/HMR 重进 apply 时若只靠 idle，
+	// 窗口期内其它插件 materialize 会 claim 走无主标签（或标签已被对方删掉）。
+	// 首屏成本可接受（textContent 写入），换「开合插件样式不坏」。
+	ensureCss();
 	initFeatureState(BUILTIN_FEATURES.concat(PLANNED_FEATURES));
 	const slots = ctx.get("slots");
 	if (slots === undefined) return;