dsh-per-message-model 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-per-message-model contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# dsh-per-message-model
+
+在 DSH Web GUI 主对话中，每条 assistant 回复旁显示该条回复实际使用的模型徽章，并在会话中发生模型切换时渲染嵌入消息流的切换分割线。
+
+纯展示插件：不改写、不拦截任何模型请求；不做 token 计价、余额或厂商 logo。
+
+## 效果
+
+- **消息级芯片图标**：每条已完成的 assistant 消息动作行（copy / branch 按钮之后、时间之前）显示一个小芯片图标；鼠标悬停（`title`）显示该条消息实际使用的完整 `provider / model · 思考 effort`。
+- **会话 Header**：会话动作区显示最近一条 assistant 消息的模型徽章。
+- **模型切换分割线**：当相邻 assistant 消息的 provider/model 发生变化时，在**真正切换的位置**（切换源消息之后、下一条消息之前，即消息中途切换点，而非整条消息末尾）渲染一条横贯消息流的粗分割线：`模型切换：[旧模型] → [新模型]`。文案固定中文，"模型切换："为灰色、箭头为自渲染 SVG 图片（灰色粗箭头）、两个模型名为更深更粗的黑色。分割线像模型输出一样嵌入消息流，随滚动出现/消失，不固定于视口。
+- 投影缺失时图标退化为「模型未知」（fail-soft，便于确认插件已接管）。
+
+## 数据来源（服务端投影）
+
+`lib/route-metadata.js` 注册只读 projection key `perMessageModel`，折叠会话事件：
+
+| 事件 | 字段 | 用途 |
+|---|---|---|
+| `assistant/message` | `data.message.id` / `data.message.source.{provider,model}` | 消息级 provider/model（内核强制携带，消息级最准确） |
+| `request/header` | `data.header.config.reasoningEffort` / `data.header.adapterDefaults.reasoningEffort` | 请求级 effort，滚动关联到该请求产出的全部消息 |
+
+输出 `view = { messages: { [messageId]: {...} }, current: {...}, switches: [{ fromSeq, from, toSeq, to }] }`。
+`switches` 记录相邻消息的模型切换边界（`fromSeq` = 旧模型消息 seq，`toSeq` = 新模型消息 seq）。
+客户端通过官方 `useProjection` 读取，不接触会话快照。
+
+## 挂载点（客户端，纯 additive）
+
+| 槽位 | 用途 |
+|---|---|
+| `conversation.session.header.actions` | 会话 Header 当前模型徽章 |
+| `conversation.chat.assistant-actions` | 每条 assistant 消息底部动作行芯片图标（CSS flex order 排到 branch 之后、时间之前） |
+| `conversation.chat.turnTail` | 模型切换分割线（chain 槽位，`fromSeq` 匹配旧模型消息尾部） |
+
+三者均为官方扩展点：不 shadow、不替换任何官方组件。
+
+## 开发
+
+```sh
+npm run check   # node --check 三个 lib 文件
+npm test        # node --test（projection 单测 + manifest + client 静态断言）
+```
+
+## 安装
+
+```sh
+npm pack
+dsh plugin --profile web add ./dsh-per-message-model-<version>.tgz
+# 重启 DSH 后生效
+```
+
+注意：升级版本后若 node_modules 中包文件未刷新（pnpm file: 依赖版本不变不重拷），需先 `dsh plugin remove dsh-per-message-model` 再 `add`，或手动同步 `node_modules/dsh-per-message-model/lib/*.js`。
+
+## 非目标
+
+- 不拦截/改写模型请求（纯展示）。
+- 不做 token 计价、余额、厂商 logo（dsh-token-usage / dsh-model-vendor-badge 的职责）。
+- 不动子代理会话（子代理已有 dsh-subagent-route-badges）。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-per-message-model
+      name: 'dsh-per-message-model'

package/lib/client.js

@@ -0,0 +1,286 @@
+window.__ModuleLoader__.load({
+	id: "dsh-per-message-model",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		const React = require("react");
+		const createElement = React.createElement;
+		//#region client constants
+		const NS = "dsh-per-message-model";
+		const BADGE_PREFIX = "dsh-per-message-model-";
+		const zh = {
+			"badge.unknown": "模型未知",
+			"badge.unknown.title": "模型元数据不可用（会话事件中未见对应 assistant/message）",
+			"badge.effort": "思考",
+			"badge.effort.default": "默认",
+			"badge.effort.adapterDefault": "适配器默认",
+			"badge.separator": " · "
+		};
+		const en = {
+			"badge.unknown": "model unknown",
+			"badge.unknown.title": "model metadata unavailable (no matching assistant/message seen in session events)",
+			"badge.effort": "thinking",
+			"badge.effort.default": "default",
+			"badge.effort.adapterDefault": "adapter default",
+			"badge.separator": " · "
+		};
+		//#endregion
+		//#region client icon
+		/** Compact chip icon: renders as a small model-chip glyph; the full
+		* `provider / model · 思考 effort` value lives in title/aria so hovering
+		* reveals the complete model name without a long text pill in the row. */
+		function chipIcon() {
+			return createElement("svg", {
+				width: "12",
+				height: "12",
+				viewBox: "0 0 12 12",
+				fill: "none",
+				"aria-hidden": "true",
+				style: { display: "block" }
+			}, [
+				createElement("rect", {
+					key: "body",
+					x: "1.5",
+					y: "1.5",
+					width: "9",
+					height: "9",
+					rx: "1.5",
+					stroke: "currentColor",
+					strokeWidth: "1.1"
+				}),
+				createElement("rect", {
+					key: "core",
+					x: "4",
+					y: "4",
+					width: "4",
+					height: "4",
+					rx: "0.8",
+					fill: "currentColor"
+				}),
+				createElement("path", {
+					key: "pin1",
+					d: "M6 1.5V.5M6 11.5v-1M1.5 6H.5M11.5 6h-1M3.2 1.8 2.5 1.1M9.5 10.9l-.7-.7M8.8 1.8l.7-.7M2.5 10.9l.7-.7",
+					stroke: "currentColor",
+					strokeWidth: "1",
+					strokeLinecap: "round"
+				})
+			]);
+		}
+		/**
+		* Per-message model badge as a small icon button. Missing projections
+		* degrade to the same icon with an unknown title (fail-soft, verifiable).
+		* @param value - a wire projection entry ({ provider, model, reasoningEffort, reasoningSource }).
+		* @param t - locale seat bound to this plugin's namespace.
+		*/
+		function modelBadge(value, t) {
+			const known = value !== null && typeof value === "object";
+			const provider = known && typeof value.provider === "string" ? value.provider : null;
+			const model = known && typeof value.model === "string" ? value.model : null;
+			const hasModel = provider !== null && model !== null;
+			const label = hasModel
+				? `${provider} / ${model}${t("badge.separator")}${t("badge.effort")} ${known && typeof value.reasoningEffort === "string" && value.reasoningEffort.length > 0 ? value.reasoningEffort : t("badge.effort.default")}`
+				: t("badge.unknown");
+			const title = hasModel && known && value.reasoningSource === "adapter-default"
+				? `${label}（${t("badge.effort.adapterDefault")}）`
+				: hasModel ? label : t("badge.unknown.title");
+			return createElement("span", {
+				className: BADGE_PREFIX + "icon",
+				"data-dsh-per-message-model": "true",
+				"aria-label": label,
+				title
+			}, chipIcon());
+		}
+		/** Session-header occupant: current model badge (latest folded assistant message). */
+		function SessionModelBadge({ useProjection, t }) {
+			const value = useProjection("perMessageModel");
+			const current = value === void 0 || value === null || typeof value !== "object" || value.current === void 0
+				? void 0
+				: value.current;
+			return modelBadge(current, t);
+		}
+		/** Assistant-actions occupant: per-message model icon, keyed by messageId
+		* (renders inside the official per-message action row, reordered after the
+		* branch button and before the time clock via CSS flex order). */
+		function PerMessageModelBadge({ messageId, useProjection, t }) {
+			const value = useProjection("perMessageModel");
+			const entry = value === void 0 || value === null || typeof value !== "object" || value.messages === void 0
+				? void 0
+				: value.messages[messageId];
+			return modelBadge(entry, t);
+		}
+		//#endregion
+		//#region client divider
+		/** Fixed Chinese copy for the model-switch divider (user-required). */
+		const SWITCH_COPY = "模型切换：";
+		const ASSISTANT_STEP_KEY_PREFIX = "14:assistant-step";
+		/**
+		* Build the divider DOM node (plain DOM, not React): inserted directly
+		* after the assistant message that PRECEDES a model switch, so it lands at
+		* the exact switch point mid-stream instead of the turn tail.
+		*/
+		function buildDividerNode(sw) {
+			const div = document.createElement("div");
+			div.setAttribute("data-dsh-model-switch", "true");
+			const label = document.createElement("span");
+			label.className = BADGE_PREFIX + "divider-label";
+			label.textContent = SWITCH_COPY;
+			div.appendChild(label);
+			const from = sw.from !== null && typeof sw.from === "object"
+				? `${sw.from.provider} / ${sw.from.model}`
+				: null;
+			if (from !== null) {
+				const fromEl = document.createElement("span");
+				fromEl.className = BADGE_PREFIX + "divider-model";
+				fromEl.textContent = from;
+				div.appendChild(fromEl);
+			}
+			const arrow = document.createElement("span");
+			arrow.className = BADGE_PREFIX + "divider-arrow";
+			// arrowSvg returns a React element; build the SVG DOM node instead.
+			const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
+			svg.setAttribute("width", "14");
+			svg.setAttribute("height", "12");
+			svg.setAttribute("viewBox", "0 0 14 12");
+			svg.setAttribute("fill", "none");
+			svg.setAttribute("aria-hidden", "true");
+			const path = document.createElementNS("http://www.w3.org/2000/svg", "path");
+			path.setAttribute("d", "M1 6h10.5M7.5 1.5 12 6l-4.5 4.5");
+			path.setAttribute("stroke", "currentColor");
+			path.setAttribute("stroke-width", "1.8");
+			path.setAttribute("stroke-linecap", "round");
+			path.setAttribute("stroke-linejoin", "round");
+			svg.appendChild(path);
+			arrow.appendChild(svg);
+			div.appendChild(arrow);
+			const toEl = document.createElement("span");
+			toEl.className = BADGE_PREFIX + "divider-model";
+			toEl.textContent = `${sw.to.provider} / ${sw.to.model}`;
+			div.appendChild(toEl);
+			return div;
+		}
+		/**
+		* In-stream model-switch divider. Mounted on the turnTail chain seat (the
+		* only per-message-adjacent additive seat), but instead of rendering at the
+		* turn tail it inserts the divider DOM node directly AFTER the assistant
+		* message that PRECEDES the switch (fromTurn/fromStep → the official
+		* assistant-step chat 节点 key). The divider therefore lands at the exact
+		* mid-stream switch point, scrolls with the conversation, and is never
+		* fixed to the viewport. The component reads the live projection, so the
+		* inserted node appears once the new route's message arrives.
+		* @param turn - the current turn id (owner prop).
+		*/
+		function ModelSwitchDivider({ turn, useProjection }) {
+			const value = useProjection("perMessageModel");
+			const switches = value === void 0 || value === null || typeof value !== "object" || !Array.isArray(value.switches)
+				? []
+				: value.switches;
+			// The owner prop is the full turn location object; its numeric id is
+			// exposed as `.turn` (matches the projection's fromTurn/toTurn).
+			const turnId = turn !== null && typeof turn === "object" && Number.isSafeInteger(turn.turn) ? turn.turn : null;
+			React.useEffect(() => {
+				if (typeof document === "undefined" || typeof MutationObserver === "undefined") return;
+				const inserted = [];
+				let observer = null;
+				const pending = switches.filter((sw) =>
+					sw.fromTurn === turnId &&
+					sw.fromStep !== void 0 && sw.fromStep !== null &&
+					sw.to !== null && typeof sw.to === "object" &&
+					typeof sw.to.provider === "string" && typeof sw.to.model === "string"
+				);
+				const tryInsert = () => {
+					let remaining = 0;
+					for (const sw of pending) {
+						const key = ASSISTANT_STEP_KEY_PREFIX + sw.fromTurn + ":" + sw.fromStep;
+						const anchor = document.querySelector('[data-chat-anchor-key="' + key + '"]');
+						if (anchor === null) { remaining += 1; continue; }
+						if (anchor.nextElementSibling !== null && anchor.nextElementSibling.hasAttribute("data-dsh-model-switch")) continue;
+						const node = buildDividerNode(sw);
+						anchor.insertAdjacentElement("afterend", node);
+						inserted.push(node);
+					}
+					return remaining;
+				};
+				// First pass: the anchor nodes are usually already rendered. If any
+				// are still missing (windowed/historical rendering), watch the chat
+				// flow until they appear, then insert and stop watching.
+				let remaining = tryInsert();
+				if (remaining > 0 && inserted.length === 0) {
+					observer = new MutationObserver(() => {
+						const left = tryInsert();
+						if (left === 0) {
+							observer.disconnect();
+							observer = null;
+						}
+					});
+					observer.observe(document.body, { childList: true, subtree: true });
+				}
+				return () => {
+					if (observer !== null) observer.disconnect();
+					for (const node of inserted) node.remove();
+				};
+			}, [switches, turnId]);
+			return null;
+		}
+		/**
+		* Chain selector: this occupant is the only turnTail registrant, so it is
+		* always elected; the component itself decides whether to insert anything
+		* (select cannot reach the projection store synchronously, so the reactive
+		* read lives in the component via useProjection).
+		*/
+		function selectModelSwitch() {
+			return true;
+		}
+		//#endregion
+		//#region client plugin
+		/** Required services for the additive seats. */
+		const inject = [
+			"slots",
+			"locale"
+		];
+		function apply(ctx) {
+			const badgeStyle = document.createElement("style");
+			badgeStyle.dataset.dshPerMessageModel = BADGE_PREFIX;
+			badgeStyle.textContent = [
+				// Per-message icon: small chip, full value in title/aria.
+				`[data-dsh-per-message-model]{display:inline-flex;align-items:center;justify-content:center;width:20px;height:20px;margin:0 2px;color:var(--dsw-alias-label-tertiary);border-radius:5px;cursor:default}`,
+				`[data-dsh-per-message-model]:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-base-2, var(--dsw-alias-bg-hover, rgba(128,128,128,.12)))}`,
+				// Reorder inside the official action row: copy(0) branch(0) icon(3) clock(4)
+				`[data-dsh-per-message-model]{order:3}`,
+				`div[class*="actions"]:has([data-slot="conversation.chat.assistant-actions"]) [class*="timeEnd"]{order:4}`,
+				// In-stream divider: full-width block, embeds in the message flow.
+				// Label (模型切换：) and arrow are gray; model names are darker/bolder.
+				`[data-dsh-model-switch]{display:flex;align-items:center;gap:8px;margin:2px 0 10px;padding:8px 12px;border-top:2px solid var(--dsw-alias-border-strong, var(--dsw-alias-border-l2, rgba(128,128,128,.35)));color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-base-2, transparent);border-radius:8px;font-size:12px;line-height:18px;user-select:none}`,
+				`[data-dsh-model-switch] [class*="-divider-label"]{flex:none;color:var(--dsw-alias-label-tertiary);font-weight:600}`,
+				`[data-dsh-model-switch] [class*="-divider-model"]{flex:none;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-primary);font-weight:700}`,
+				`[data-dsh-model-switch] [class*="-divider-arrow"]{flex:none;display:inline-flex;align-items:center;color:var(--dsw-alias-label-tertiary)}`
+			].join("\n");
+			document.head.appendChild(badgeStyle);
+			ctx.effect(() => () => badgeStyle.remove(), "per-message-model: css");
+			ctx.effect(() => ctx.locale.register(NS, { zh, en }), "per-message-model: dictionaries");
+			ctx.slots.inject("conversation.session.header.actions", () => ctx.slots.register({
+				name: "conversation.session.header.actions",
+				id: "dsh-per-message-model-header",
+				locale: NS,
+				order: 80
+			}, SessionModelBadge));
+			ctx.slots.inject("conversation.chat.assistant-actions", () => ctx.slots.register({
+				name: "conversation.chat.assistant-actions",
+				id: "dsh-per-message-model-badge",
+				locale: NS,
+				order: 40
+			}, PerMessageModelBadge));
+			ctx.slots.inject("conversation.chat.turnTail", () => ctx.slots.register({
+				name: "conversation.chat.turnTail",
+				id: "dsh-per-message-model-switch",
+				locale: NS,
+				order: 60,
+				select: selectModelSwitch
+			}, ModelSwitchDivider));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});

package/lib/index.js

@@ -0,0 +1,9 @@
+import { definition } from './route-metadata.js';
+
+/** Host half: a read-only projection; it never intercepts or changes requests. */
+export const inject = ['sessionProjections'];
+
+export function apply(ctx) {
+  ctx.sessionProjections.register(definition);
+}
+export { definition } from './route-metadata.js';

package/lib/route-metadata.js

@@ -0,0 +1,213 @@
+/**
+ * Per-message model projection: fold session events into a
+ * messageId -> { provider, model, reasoningEffort, reasoningSource } map,
+ * a `current` entry (the latest folded assistant message), and a `switches`
+ * list of model-switch boundaries (adjacent assistant messages whose
+ * provider/model pair changed). The same projection drives the per-message
+ * badge, the session-header badge, and the in-stream model-switch divider.
+ *
+ * Data sources (both load-bearing, enforced by dsh-session at the seed/load
+ * boundary):
+ *  - `assistant/message`: `data.message.id` (message identity) and
+ *    `data.message.source.{provider,model}` (the message-level pair; the
+ *    session kernel requires a model source with a provider/model pair on
+ *    every assistant message, so a hit is authoritative for that message).
+ *  - `request/header`: `data.header.config.{provider,model,reasoningEffort}`
+ *    plus `data.header.adapterDefaults.reasoningEffort` (adapter-default
+ *    marker). One request can produce several assistant messages, so the
+ *    latest header's effort is carried forward to every message folded after
+ *    it, until the next header supersedes it.
+ *
+ * This projection is read-only: it never intercepts, changes, or replays any
+ * model request. Clients read the wire view through `useProjection`.
+ */
+const KEY = 'perMessageModel';
+
+/** Fresh fold state: per-message entries, rolling request effort, latest entry, switches. */
+const initialState = () => ({
+  messages: {},
+  effort: null,
+  effortSource: 'unspecified',
+  last: null,
+  switches: []
+});
+
+const record = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+const text = (v) => typeof v === 'string' && v.length > 0 ? v : null;
+
+/** Resolve the current effort marker from a request header. */
+function headerEffort(header) {
+  const config = header && record(header.config) ? header.config : null;
+  if (config === null) return { effort: null, effortSource: 'unspecified' };
+  const effort = text(config.reasoningEffort);
+  const defaults = record(header.adapterDefaults) ? header.adapterDefaults : null;
+  const effortSource = effort !== null && defaults?.reasoningEffort === true
+    ? 'adapter-default'
+    : effort !== null ? 'explicit' : 'unspecified';
+  return { effort, effortSource };
+}
+
+/** Same model pair (provider+model), or either missing — treated as a switch boundary. */
+function sameRoute(a, b) {
+  if (a === null || b === null) return false;
+  return a.provider === b.provider && a.model === b.model;
+}
+
+function apply(state, event) {
+  if (!record(state) || !record(event) || typeof event.type !== 'string') return state;
+  if (event.type === 'request/header') {
+    const header = record(event.data) && record(event.data.header) ? event.data.header : null;
+    if (header === null) return state;
+    const { effort, effortSource } = headerEffort(header);
+    // Preserve message entries; only the request-level effort rolls forward.
+    return { ...state, effort, effortSource };
+  }
+  if (event.type === 'assistant/message') {
+    const data = record(event.data) ? event.data : null;
+    const message = data && record(data.message) ? data.message : null;
+    const source = message && record(message.source) ? message.source : null;
+    const id = text(message?.id);
+    const provider = text(source?.provider);
+    const model = text(source?.model);
+    if (id === null || provider === null || model === null) return state;
+    const turn = Number.isSafeInteger(data?.turn) ? data.turn : null;
+    const step = Number.isSafeInteger(data?.step) ? data.step : null;
+    const entry = {
+      provider,
+      model,
+      reasoningEffort: state.effort,
+      reasoningSource: state.effortSource,
+      turn,
+      step
+    };
+    const seq = Number.isSafeInteger(event.seq) ? event.seq : null;
+    const prev = record(state.last) ? { provider: text(state.last.provider), model: text(state.last.model) } : null;
+    let switches = state.switches;
+    if (seq !== null && !sameRoute(prev, { provider, model })) {
+      // A switch boundary: the previous assistant message (if any) ends the
+      // old route; this message begins the new route.
+      const from = prev !== null && prev.provider !== null && prev.model !== null
+        ? { provider: prev.provider, model: prev.model }
+        : null;
+      switches = [...switches, {
+        fromSeq: prev !== null && Number.isSafeInteger(state.lastSeq) ? state.lastSeq : null,
+        fromTurn: prev !== null && Number.isSafeInteger(state.lastTurn) ? state.lastTurn : null,
+        fromStep: prev !== null && Number.isSafeInteger(state.lastStep) ? state.lastStep : null,
+        from,
+        toSeq: seq,
+        toTurn: turn,
+        toStep: step,
+        to: { provider, model }
+      }];
+    }
+    return {
+      ...state,
+      messages: { ...state.messages, [id]: entry },
+      last: entry,
+      lastSeq: seq,
+      lastTurn: turn,
+      lastStep: step,
+      switches
+    };
+  }
+  return state;
+}
+
+/** Client-visible wire view: stable messageId map, latest entry, switch list. */
+function view(state) {
+  if (!record(state) || !record(state.messages)) return null;
+  const messages = {};
+  for (const [id, entry] of Object.entries(state.messages)) {
+    if (!record(entry)) continue;
+    const provider = text(entry.provider);
+    const model = text(entry.model);
+    if (provider === null || model === null) continue;
+    messages[id] = {
+      provider,
+      model,
+      reasoningEffort: text(entry.reasoningEffort),
+      reasoningSource: ['explicit', 'adapter-default', 'unspecified'].includes(entry.reasoningSource)
+        ? entry.reasoningSource
+        : 'unspecified'
+    };
+  }
+  const last = record(state.last) ? state.last : null;
+  let current = null;
+  if (last !== null) {
+    const provider = text(last.provider);
+    const model = text(last.model);
+    if (provider !== null && model !== null) {
+      current = {
+        provider,
+        model,
+        reasoningEffort: text(last.reasoningEffort),
+        reasoningSource: ['explicit', 'adapter-default', 'unspecified'].includes(last.reasoningSource)
+          ? last.reasoningSource
+          : 'unspecified'
+      };
+    }
+  }
+  const switches = Array.isArray(state.switches)
+    ? state.switches.map((s) => ({
+      fromSeq: Number.isSafeInteger(s.fromSeq) ? s.fromSeq : null,
+      fromTurn: Number.isSafeInteger(s.fromTurn) ? s.fromTurn : null,
+      fromStep: Number.isSafeInteger(s.fromStep) ? s.fromStep : null,
+      from: record(s.from) && text(s.from.provider) !== null && text(s.from.model) !== null
+        ? { provider: text(s.from.provider), model: text(s.from.model) }
+        : null,
+      toSeq: Number.isSafeInteger(s.toSeq) ? s.toSeq : null,
+      toTurn: Number.isSafeInteger(s.toTurn) ? s.toTurn : null,
+      toStep: Number.isSafeInteger(s.toStep) ? s.toStep : null,
+      to: record(s.to) && text(s.to.provider) !== null && text(s.to.model) !== null
+        ? { provider: text(s.to.provider), model: text(s.to.model) }
+        : null
+    }))
+    : [];
+  return { messages, current, switches };
+}
+
+/** Validates an already-computed view (the host calls `parse(view(state))`); never re-derives it. */
+const viewSchema = {
+  parse(value) {
+    if (value === null) return null;
+    if (!record(value) || !record(value.messages)) throw new Error('invalid per-message model metadata');
+    if (value.current !== null && !record(value.current)) throw new Error('invalid per-message model metadata');
+    if (!Array.isArray(value.switches)) throw new Error('invalid per-message model metadata');
+    for (const [id, entry] of Object.entries(value.messages)) {
+      if (typeof id !== 'string' || id.length === 0) throw new Error('invalid per-message model metadata');
+      if (!record(entry) || typeof entry.provider !== 'string' || typeof entry.model !== 'string') throw new Error('invalid per-message model metadata');
+      if (entry.reasoningEffort !== null && typeof entry.reasoningEffort !== 'string') throw new Error('invalid per-message model metadata');
+      if (!['explicit', 'adapter-default', 'unspecified'].includes(entry.reasoningSource)) throw new Error('invalid per-message model metadata');
+    }
+    if (value.current !== null) {
+      const c = value.current;
+      if (typeof c.provider !== 'string' || typeof c.model !== 'string') throw new Error('invalid per-message model metadata');
+      if (c.reasoningEffort !== null && typeof c.reasoningEffort !== 'string') throw new Error('invalid per-message model metadata');
+      if (!['explicit', 'adapter-default', 'unspecified'].includes(c.reasoningSource)) throw new Error('invalid per-message model metadata');
+    }
+    for (const s of value.switches) {
+      if (!record(s)) throw new Error('invalid per-message model metadata');
+      for (const seqField of ['fromSeq', 'toSeq']) {
+        if (s[seqField] !== null && !Number.isSafeInteger(s[seqField])) throw new Error('invalid per-message model metadata');
+      }
+      for (const posField of ['fromTurn', 'fromStep', 'toTurn', 'toStep']) {
+        if (s[posField] !== null && !Number.isSafeInteger(s[posField])) throw new Error('invalid per-message model metadata');
+      }
+      for (const side of [s.from, s.to]) {
+        if (side !== null && (!record(side) || typeof side.provider !== 'string' || typeof side.model !== 'string')) throw new Error('invalid per-message model metadata');
+      }
+    }
+    return value;
+  }
+};
+
+const definition = {
+  key: KEY,
+  stateVersion: 2,
+  stateSchema: { parse: (v) => record(v) ? v : initialState() },
+  init: initialState,
+  apply,
+  wire: { viewSchema, view }
+};
+
+export { KEY, initialState, headerEffort, apply, view, viewSchema, definition };

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "dsh-per-message-model",
+  "version": "0.1.0",
+  "description": "在 DSH 主对话每条 assistant 回复旁展示该条回复实际使用的 provider / model 徽章（可选附带 reasoning effort）",
+  "type": "module",
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./route-metadata": "./lib/route-metadata.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/*.js",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "scripts": {
+    "check": "node --check lib/index.js && node --check lib/route-metadata.js && node --check lib/client.js",
+    "test": "node --test"
+  },
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "model",
+    "badge"
+  ],
+  "license": "MIT",
+  "dsh": {
+    "plugin": true,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.1",
+    "@deepseek-ai/dsh-client-runtime": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-session-projection": ">=0.1.1-rc.2",
+    "react": ">=18.2.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}