@dingpenghui/dsh-conversation-language 0.0.0-stage → 3.2.2

package/README.md

@@ -1,3 +1,175 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# dsh-conversation-language
+
+DSH 插件：对话语言切换器
+
+## 功能
+
+允许在中文和英文之间切换对话语言。切换后 AI 将使用对应语言进行思考和回复。
+
+### 特性
+
+- 🖱️ 点击插件名即可打开**详情页**（含语言选择表单与保存/恢复默认按钮），通用设置不再出现重复入口
+- 🔄 动态更新 Persona（系统提示），无需重启即可生效
+- 💾 设置通过 profile 的 Cordis patch 持久化（当前 profile 的 `cordis.patch.yml`）
+- 🎨 匹配 DSH 原生界面样式
+
+## 安装
+
+> ⚠️ **安装完成后必须重启 DeepSeek Harness**，插件才能生效。
+
+### 方式一：使用 dsh 命令（推荐）
+
+```bash
+# 先 cd 到插件目录
+cd /path/to/dsh-conversation-language
+dsh plugin --profile web add .
+```
+
+### 方式二：手动安装
+
+1. 克隆插件到 plugins 目录：
+```bash
+git clone https://github.com/Dingpenghui-good/dsh-conversation-language.git ~/.dsh/plugins/dsh-conversation-language
+# Windows: git clone https://github.com/Dingpenghui-good/dsh-conversation-language.git %USERPROFILE%\.dsh\plugins\dsh-conversation-language
+```
+
+2. 添加到 `~/.dsh/profiles/web/package.json`：
+```json
+{
+  "dependencies": {
+    "@dingpenghui/dsh-conversation-language": "link:C:/Users/<你的用户名>/.dsh/plugins/dsh-conversation-language"
+  },
+  "dsh": {
+    "profile": {
+      "bundles": [
+        // ... 其他 bundles
+        "@dingpenghui/dsh-conversation-language"
+      ]
+    }
+  }
+}
+```
+
+3. 运行安装：
+```bash
+cd ~/.dsh/profiles/web
+pnpm install
+```
+
+4. **重启 DeepSeek Harness**。
+
+## 配置
+
+### 方式一：通过插件详情页
+
+重启 DSH 后，打开 **插件 → @dingpenghui/dsh-conversation-language**，在详情页的语言选择表单中切换并保存。
+
+### 方式二：直接修改 profile patch
+
+编辑当前 profile 的 `cordis.patch.yml`（Windows：`%USERPROFILE%\.dsh\profiles\web\cordis.patch.yml`）：
+
+```yaml
+- id: tool-conversation-language
+  config:
+    conversationLanguage: en   # 或 zh
+```
+
+然后重启 DSH。
+
+> 2.0.0 起设置不再写入 `~/.dsh/settings.yaml`：新架构中每个插件 entry 的
+> `Config` schema 由 settings 框架投影，写入目标是当前 profile 的 Cordis patch。
+
+## 使用
+
+切换语言后，AI 将自动以对应语言进行思考和回复，并让所有面向用户可见的文本保持同一语言——
+包括工具调用的参数值（`pwsh`/`bash` 卡片上显示的 `description`、`todo_write` 的 `content`、
+`subagent` 的 `description`、任务与作业名称等）。也可通过 `get_conversation_language` Tool
+查询当前设置。
+
+## 技术说明
+
+| 项目 | 值 |
+|------|-----|
+| Settings Namespace | `tool-conversation-language`（= profile entry id） |
+| Schema | `{ conversationLanguage: 'zh' \| 'en' }`（volatile，默认 `zh`） |
+| 默认值 | `zh` (中文) |
+| Persona Override | `system-prompt/assemble` waterfall 拦截，按语言在 persona section 追加指令 |
+| Tool 注册 | `get_conversation_language` — 查询当前语言设置 |
+
+### 架构（DSH 0.2.0-rc.1+，v3.2.0）
+
+- **宿主侧**（`src/index.ts`）：声明 `Config` schema（`z.union(['zh','en']).volatile().default('zh')`），
+  settings 框架按 entry id 自动注册命名空间；`system-prompt/assemble` 拦截器在每次组装时
+  通过 `ctx.settings.describe()` 读取实时值，语言切换无需重启。`apply` 注入
+  `['systemPrompt', 'tools']`——settings 服务缺失时回退默认 `zh`。
+- **客户端侧**（`src/client/`）：
+  - **详情页**（唯一入口）：`configForms.whileServed([NS], …)` 守卫注册
+    `plugins.bundle.config`（key = 包名）与 `plugins.row.config`（key = `<包名>#<row-id>`）
+    两个 slot，渲染 `PluginDetailPage`（摘要行 / 语言表单 + 保存 / 恢复默认）。
+    表单走 `SettingsFormModel`（staged form）+ `SettingsForm`，
+    在 0.1.7 表面下这两个 slot 名不存在时 `slots.inject` 静默 no-op，不抛异常。
+  - v3.2.0 起移除了通用设置行（`settings.general.item`），语言设置仅在插件详情页提供，
+    避免同一功能在两个入口重复出现。
+  - 共享常量（namespace、语言类型）位于 `src/shared.ts`，保证客户端 bundle 不 value-import
+    任何宿主侧包（客户端 bundle purity gate）。
+
+### 插件结构
+
+```
+dsh-conversation-language/
+├── src/
+│   ├── index.ts                    # Host 层：Config schema + persona 拦截 + tool
+│   ├── shared.ts                   # 共享常量（namespace / 语言类型）
+│   ├── client/
+│   │   ├── index.ts                # Client 层：UI 注册（configForms + slots）
+│   │   ├── PluginDetailPage.tsx    # React 组件（详情页：表单 + 保存/恢复）
+│   │   ├── PluginDetailPage.module.css
+│   │   └── plugin-detail-controller.ts # 详情页 staged-form 控制器（SettingsFormModel 桥接）
+│   └── locales/
+│       └── index.ts                # 国际化字典（zh / en）
+├── lib/                            # 构建产物（tsdown 生成，安装时必须存在）
+├── cordis.patch.yml                # Cordis bundle patch（entry id = settings namespace）
+├── build-and-verify.mjs            # 一键构建 + 全量验证流水线
+├── runtime-verify.mjs              # 宿主侧运行时回归
+├── client-verify-0.1.7.mjs        # 0.1.7-alpha.2 回归验证
+├── contract-test.mjs               # 0.2.0-rc.1 客户端契约模拟验证
+├── package.json
+└── README.md
+```
+
+## 兼容性
+
+| DSH 版本 | 插件版本 | 说明 |
+|----------|---------|------|
+| 0.1.2-rc.1 | ≤ 1.4.0 | 旧的单一 `deployment:persona` section（`PERSONA_SECTION`） |
+| 0.1.5-rc.1 | ≥ 1.5.0 | persona 拆分为 prefix/suffix；宿主侧 settings 采用旧的 `settings.register()` 命名空间模式 |
+| 0.1.7-alpha.2+ | ≥ 2.0.0 | settings 框架重构为 plugin entry `Config` schema + `describe()/update()/mutate()`；客户端 `settingsScope` 服务移除，改用 `configForms` |
+| **0.2.0-rc.1** | **≥ 3.1.0** | 宿主侧改用 `settings` service（`describe()` + `mutate()`）；客户端注册 `plugins.bundle.config` / `plugins.row.config` slot 实现详情页；`SettingsFormModel`（staged form）+ `SettingsForm` 渲染保存/恢复默认；0.1.7 表面下 slot 降级静默 no-op |
+| **0.2.0-rc.1** | **≥ 3.2.0** | 移除通用设置行（`settings.general.item`），语言设置仅在插件详情页提供（唯一入口） |
+
+## 开发
+
+```bash
+cd dsh-conversation-language
+pnpm install
+pnpm run build   # 构建产物到 lib/；安装前必须执行此步
+```
+
+升级 DSH 大版本后，可对当前 node_modules 中的 `@deepseek-ai/*` 版本做回归：
+
+```bash
+node runtime-verify.mjs        # 宿主侧：tool 注册/执行、system-prompt/assemble 拦截
+node client-verify-0.1.7.mjs   # 0.1.7 回归：CJS 包装 / purity gate / slot 降级
+node contract-test.mjs         # 0.2.0-rc.1 契约：apply(ctx) 注册行 + whileServed 详情页 + 词典 + 写回
+node build-and-verify.mjs      # 一键流水线：tsdown build + tsc + 上述全部验证
+```
+
+> ⚠️ **必须执行构建**，插件运行时依赖 `lib/` 下的构建产物，不能直接使用源码。
+>
+> 请使用 **pnpm** 安装依赖：`@deepseek-ai/dsh-*@0.1.7-alpha.2` 等预发布版本在 npm 注册表中
+> 处于「已发布但不可被 npm 解析」状态，`npm install` 会以 `ETARGET` 失败；pnpm 可以正常
+> 解析并安装这些版本。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,12 @@
+# 对话语言切换插件配置
+# 安装方式: dsh plugin --profile web add <path-to-plugin>
+#
+# The row id IS the settings namespace: the settings framework keys every
+# descriptor by the entry's id, and the client addresses the form through
+# `configForms.get('tool-conversation-language')`. The schema default
+# (conversationLanguage: 'zh') materializes when the row ships no config.
+- insert:
+    - id: tool-conversation-language
+      name: '@dingpenghui/dsh-conversation-language'
+      config:
+        conversationLanguage: 'zh'

package/lib/client.js

@@ -0,0 +1,252 @@
+window.__ModuleLoader__.load({
+	id: "@dingpenghui/dsh-conversation-language",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/client/plugin-detail-controller.ts
+		/** 语言字段的 format/parse 规范：只接受 'zh' / 'en'，空串清除回继承层。 */
+		function languageFieldSpec() {
+			const accepted = ["zh", "en"];
+			return {
+				field: "conversationLanguage",
+				format: (value) => typeof value === "string" ? value : "",
+				parse: (text) => {
+					const trimmed = text.trim();
+					if (accepted.includes(trimmed)) return {
+						kind: "set",
+						value: trimmed
+					};
+					if (trimmed === "") return { kind: "clear" };
+				}
+			};
+		}
+		/**
+		* 把命名空间的 `ConfigForm` 适配为 `SettingsFormModel` 需要的
+		* `SettingsFormScope`：两者读快照形状一致，只有 `mutate` 操作类型不同
+		* （`SettingsFormPathOp` vs `SettingsPathOpView`），页面只做读与原子写，
+		* 故按结构复用。
+		*/
+		function asFormScope(scope) {
+			return {
+				getSnapshot: () => {
+					const s = scope.getSnapshot();
+					return {
+						status: s.status,
+						value: s.value,
+						base: s.base,
+						user: s.user,
+						writable: s.writable,
+						revision: s.revision
+					};
+				},
+				subscribe: (listener) => scope.subscribe(listener),
+				mutate: (ops, expectedRevision) => scope.mutate(ops, expectedRevision)
+			};
+		}
+		/** 把一个宿主 settings 命名空间桥接到详情页的 staged form。 */
+		var ConversationLanguagePageController = class {
+			form;
+			store;
+			/** @param scope - 共享配置表单（命名空间的 ConfigForm）。 */
+			constructor(scope) {
+				this.form = new _deepseek_ai_dsh_client_ui_primitives.SettingsFormModel(asFormScope(scope), [languageFieldSpec()]);
+				this.store = this.form.bind(() => this.projection());
+			}
+			projection() {
+				return {
+					...this.form.shell(),
+					conversationLanguage: this.form.field("conversationLanguage")
+				};
+			}
+			/**
+			* 构建详情页 slot 注册注入的面。
+			* @returns 页面快照与表单动作。
+			*/
+			inject() {
+				return {
+					hooks: { conversationLanguagePage: this.store },
+					...this.form.actions()
+				};
+			}
+			/** 释放表单订阅。 */
+			dispose() {
+				this.form.dispose();
+			}
+		};
+		//#endregion
+		//#region \0dsh-css:E:\dsh-workspace\dsh-conversation-language\src\client\PluginDetailPage.module.css.mjs
+		const css = ".hZ1jBa_page{flex-direction:column;gap:16px;padding-bottom:16px;display:flex}.hZ1jBa_field{border-bottom:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:8px;padding:16px 0;display:flex}.hZ1jBa_fieldText{flex-direction:column;gap:4px;display:flex}.hZ1jBa_title{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:400;line-height:22px}.hZ1jBa_hint{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:400;line-height:18px}.hZ1jBa_control{width:100%}";
+		const tagId = "@dingpenghui/dsh-conversation-language/PluginDetailPage.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@dingpenghui/dsh-conversation-language";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var PluginDetailPage_module_css_default = {
+			"title": "hZ1jBa_title",
+			"page": "hZ1jBa_page",
+			"field": "hZ1jBa_field",
+			"fieldText": "hZ1jBa_fieldText",
+			"control": "hZ1jBa_control",
+			"hint": "hZ1jBa_hint"
+		};
+		//#endregion
+		//#region src/client/plugin-detail-page.tsx
+		/** 语言选项（与宿主 schema 的枚举一致）。 */
+		const LANGUAGE_OPTIONS = [{
+			value: "zh",
+			label: "中文"
+		}, {
+			value: "en",
+			label: "English"
+		}];
+		/** 从 locale 字典派生 SettingsForm 的标签文案。 */
+		function formLabels(t) {
+			return {
+				unavailable: t("form.unavailable"),
+				readOnly: t("form.readOnly"),
+				saveFailed: t("form.saveFailed"),
+				save: t("form.save"),
+				saving: t("form.saving")
+			};
+		}
+		/**
+		* 渲染详情页：一行摘要（`view: 'summary'`）或语言选择表单（`view: 'page'`）。
+		* @param props - 视图、locale 文案、表单快照与动作。
+		* @returns 摘要文字，或带保存控件的语言表单。
+		*/
+		function ConversationLanguageDetailPage(props) {
+			const { t } = props;
+			const state = props.useConversationLanguagePage((snapshot) => snapshot);
+			if (props.view === "summary") return t("description");
+			const disabled = !state.writable;
+			const selectedValue = state.conversationLanguage.text === "en" ? "en" : "zh";
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.SettingsForm, {
+				labels: formLabels(t),
+				state,
+				onSave: props.save,
+				onDiscard: props.discard,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: PluginDetailPage_module_css_default.page,
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: PluginDetailPage_module_css_default.field,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: PluginDetailPage_module_css_default.fieldText,
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: PluginDetailPage_module_css_default.title,
+								children: t("page.label")
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: PluginDetailPage_module_css_default.hint,
+								children: t("page.hint")
+							})]
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.SegmentedControl, {
+							id: "conversation-language",
+							value: selectedValue,
+							options: LANGUAGE_OPTIONS,
+							onChange: (next) => {
+								props.edit("conversationLanguage", next);
+							},
+							label: t("page.label"),
+							disabled,
+							className: PluginDetailPage_module_css_default.control
+						})]
+					})
+				})
+			});
+		}
+		//#endregion
+		//#region src/locales/index.ts
+		/** Localization dictionaries (detail page only) */
+		const zh = {
+			"title": "对话语言",
+			"description": "选择 AI 思考与回复使用的语言，保存后下一轮模型步骤即时生效。",
+			"page.label": "对话语言",
+			"page.hint": "选择 AI 思考与回复使用的语言，保存后下一轮模型步骤即时生效。",
+			"form.unavailable": "该插件当前未加载，暂时无法配置。",
+			"form.readOnly": "本部署的设置为只读。",
+			"form.saveFailed": "保存未被接受，已保留供你修改。",
+			"form.save": "保存",
+			"form.saving": "保存中…",
+			"form.overridden": "已覆盖",
+			"form.reset": "恢复默认",
+			"form.invalid": "无效值"
+		};
+		const en = {
+			"title": "Conversation Language",
+			"description": "Choose the language the AI thinks and replies in. Takes effect on the next model step after saving.",
+			"page.label": "Conversation language",
+			"page.hint": "Choose the language the AI thinks and replies in. Takes effect on the next model step after saving.",
+			"form.unavailable": "This plugin is not loaded, so it cannot be configured right now.",
+			"form.readOnly": "This deployment stores settings read-only.",
+			"form.saveFailed": "The deployment did not accept these values; they were left for you to correct.",
+			"form.save": "Save",
+			"form.saving": "Saving…",
+			"form.overridden": "Overridden",
+			"form.reset": "Reset to default",
+			"form.invalid": "Invalid value"
+		};
+		//#endregion
+		//#region src/shared.ts
+		/**
+		* Shared constants usable by both the Host bundle and the Client bundle.
+		* The client reads the settings namespace through this barrel so it never
+		* value-imports a Host-only package such as `@deepseek-ai/dsh-system-prompt`.
+		*/
+		/** The settings namespace is the profile entry id of this plugin row. */
+		const CONVERSATION_LANGUAGE_NAMESPACE = "tool-conversation-language";
+		/** npm 包名：`plugins.bundle.config` slot 的 key。 */
+		const PLUGIN_PACKAGE_NAME = "@dingpenghui/dsh-conversation-language";
+		/** `plugins.row.config` slot 的 key：`<package>#<row id>`。 */
+		const PLUGIN_ROW_CONFIG_KEY = `${PLUGIN_PACKAGE_NAME}#${CONVERSATION_LANGUAGE_NAMESPACE}`;
+		//#endregion
+		//#region src/client/index.ts
+		const DICT_NS = "settings.conversation-language";
+		const inject = [
+			"slots",
+			"locale",
+			"configForms",
+			"connection"
+		];
+		function apply(ctx) {
+			const slots = ctx.get("slots");
+			const locale = ctx.get("locale");
+			ctx.effect(() => locale.register(DICT_NS, {
+				zh,
+				en
+			}), "conversation-language: dictionaries");
+			const detailPage = new ConversationLanguagePageController(ctx.get("configForms").get(CONVERSATION_LANGUAGE_NAMESPACE));
+			ctx.effect(() => () => {
+				detailPage.dispose();
+			}, "conversation-language: detail form subscriptions");
+			ctx.effect(() => ctx.get("configForms").whileServed([CONVERSATION_LANGUAGE_NAMESPACE], () => {
+				const bundleDisposer = slots.inject("plugins.bundle.config", () => slots.register({
+					name: "plugins.bundle.config",
+					key: PLUGIN_PACKAGE_NAME,
+					locale: DICT_NS,
+					inject: () => detailPage.inject()
+				}, ConversationLanguageDetailPage));
+				const rowDisposer = slots.inject("plugins.row.config", () => slots.register({
+					name: "plugins.row.config",
+					key: PLUGIN_ROW_CONFIG_KEY,
+					locale: DICT_NS,
+					inject: () => detailPage.inject()
+				}, ConversationLanguageDetailPage));
+				return () => {
+					rowDisposer();
+					bundleDisposer();
+				};
+			}), "conversation-language: detail page");
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":["SettingsFormModel","SettingsForm","css","SegmentedControl","zhDict","enDict"],"sources":["../src/client/plugin-detail-controller.ts","../src/client/plugin-detail-page.tsx","../src/locales/index.ts","../src/shared.ts","../src/client/index.ts"],"sourcesContent":["/**\r\n * 对话语言插件详情页的 staged form：把宿主 settings 命名空间桥接到\r\n * 插件详情页（plugins.bundle.config / plugins.row.config）的保存控件。\r\n * 参照 ui-settings-shell 的 ShellCardController 模式。\r\n */\r\nimport type { SnapshotStore } from '@deepseek-ai/dsh-client-store'\r\nimport {\r\n  SettingsFormModel,\r\n  type SettingsFieldState,\r\n  type SettingsFormActions,\r\n  type SettingsFormScope,\r\n  type SettingsFormShell,\r\n} from '@deepseek-ai/dsh-client-ui-primitives'\r\nimport type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client'\r\nimport type { ConversationLanguage } from '../shared.ts'\r\n\r\n/** 详情页编辑的字段 —— 命名空间 schema 的子集。 */\r\nexport interface ConversationLanguageSettings {\r\n  /** 对话语言。 */\r\n  conversationLanguage?: ConversationLanguage\r\n}\r\n\r\n/** 详情页渲染的表单状态。 */\r\nexport interface ConversationLanguagePageState extends SettingsFormShell {\r\n  conversationLanguage: SettingsFieldState\r\n}\r\n\r\n/** 注册侧注入给详情页组件的面。 */\r\nexport interface ConversationLanguagePageFace extends SettingsFormActions {\r\n  hooks: {\r\n    /** 页面快照，渲染器绑定为 useConversationLanguagePage。 */\r\n    conversationLanguagePage: SnapshotStore<ConversationLanguagePageState>\r\n  }\r\n}\r\n\r\n/** 语言字段的 format/parse 规范：只接受 'zh' / 'en'，空串清除回继承层。 */\r\nfunction languageFieldSpec() {\r\n  const accepted: readonly string[] = ['zh', 'en']\r\n  return {\r\n    field: 'conversationLanguage',\r\n    format: (value: unknown) => (typeof value === 'string' ? value : ''),\r\n    parse: (text: string) => {\r\n      const trimmed = text.trim()\r\n      if (accepted.includes(trimmed)) return { kind: 'set' as const, value: trimmed }\r\n      if (trimmed === '') return { kind: 'clear' as const }\r\n      return undefined\r\n    },\r\n  }\r\n}\r\n\r\n/**\r\n * 把命名空间的 `ConfigForm` 适配为 `SettingsFormModel` 需要的\r\n * `SettingsFormScope`：两者读快照形状一致，只有 `mutate` 操作类型不同\r\n * （`SettingsFormPathOp` vs `SettingsPathOpView`），页面只做读与原子写，\r\n * 故按结构复用。\r\n */\r\nfunction asFormScope(\r\n  scope: ConfigForm<ConversationLanguageSettings>\r\n): SettingsFormScope<ConversationLanguageSettings> {\r\n  return {\r\n    getSnapshot: () => {\r\n      const s = scope.getSnapshot()\r\n      return {\r\n        status: s.status,\r\n        value: s.value,\r\n        base: s.base,\r\n        user: s.user,\r\n        writable: s.writable,\r\n        revision: s.revision,\r\n      }\r\n    },\r\n    subscribe: (listener) => scope.subscribe(listener),\r\n    mutate: (ops, expectedRevision) => scope.mutate(ops as never, expectedRevision),\r\n  }\r\n}\r\n\r\n/** 把一个宿主 settings 命名空间桥接到详情页的 staged form。 */\r\nexport class ConversationLanguagePageController {\r\n  private readonly form: SettingsFormModel<ConversationLanguageSettings>\r\n  private readonly store: SnapshotStore<ConversationLanguagePageState>\r\n\r\n  /** @param scope - 共享配置表单（命名空间的 ConfigForm）。 */\r\n  constructor(scope: ConfigForm<ConversationLanguageSettings>) {\r\n    this.form = new SettingsFormModel(asFormScope(scope), [languageFieldSpec()])\r\n    this.store = this.form.bind(() => this.projection())\r\n  }\r\n\r\n  private projection(): ConversationLanguagePageState {\r\n    return {\r\n      ...this.form.shell(),\r\n      conversationLanguage: this.form.field('conversationLanguage'),\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 构建详情页 slot 注册注入的面。\r\n   * @returns 页面快照与表单动作。\r\n   */\r\n  inject(): ConversationLanguagePageFace {\r\n    return { hooks: { conversationLanguagePage: this.store }, ...this.form.actions() }\r\n  }\r\n\r\n  /** 释放表单订阅。 */\r\n  dispose(): void {\r\n    this.form.dispose()\r\n  }\r\n}\r\n","/**\r\n * 对话语言插件详情页：点击插件列表中的插件名字后打开的画面。\r\n * 参照 ui-settings-shell 的 ShellCard 模式：一行摘要（`view: 'summary'`）\r\n * 或语言选择表单（`view: 'page'`），表单带保存控件。\r\n */\r\nimport type { PropsLocale, PropsRuntime, InjectFace, TranslateNS } from '@deepseek-ai/dsh-client-ui-slots'\r\nimport { SegmentedControl, SettingsForm } from '@deepseek-ai/dsh-client-ui-primitives'\r\nimport type { SegmentedControlOption } from '@deepseek-ai/dsh-client-ui-primitives'\r\nimport type { ConversationLanguagePageFace } from './plugin-detail-controller.ts'\r\nimport type { ConversationLanguage } from '../shared.ts'\r\nimport css from './PluginDetailPage.module.css'\r\n\r\n/** 渲染器为详情页绑定的 props。 */\r\nexport type ConversationLanguageDetailPageProps =\r\n  & PropsRuntime<'plugins.bundle.config'>\r\n  & PropsLocale<'settings.conversation-language'>\r\n  & InjectFace<ConversationLanguagePageFace>\r\n\r\n/** 语言选项（与宿主 schema 的枚举一致）。 */\r\nconst LANGUAGE_OPTIONS: readonly SegmentedControlOption<ConversationLanguage>[] = [\r\n  { value: 'zh', label: '中文' },\r\n  { value: 'en', label: 'English' },\r\n]\r\n\r\n/** 从 locale 字典派生 SettingsForm 的标签文案。 */\r\nfunction formLabels(t: TranslateNS<'settings.conversation-language'>) {\r\n  return {\r\n    unavailable: t('form.unavailable'),\r\n    readOnly: t('form.readOnly'),\r\n    saveFailed: t('form.saveFailed'),\r\n    save: t('form.save'),\r\n    saving: t('form.saving'),\r\n  }\r\n}\r\n\r\n/**\r\n * 渲染详情页：一行摘要（`view: 'summary'`）或语言选择表单（`view: 'page'`）。\r\n * @param props - 视图、locale 文案、表单快照与动作。\r\n * @returns 摘要文字，或带保存控件的语言表单。\r\n */\r\nexport function ConversationLanguageDetailPage(props: ConversationLanguageDetailPageProps) {\r\n  const { t } = props\r\n  const state = props.useConversationLanguagePage((snapshot) => snapshot)\r\n\r\n  if (props.view === 'summary') {\r\n    return t('description')\r\n  }\r\n\r\n  const disabled = !state.writable\r\n  const language = state.conversationLanguage\r\n  // 文本稿映射到分段控件：'zh'/'en' 显示选中；空稿（清除/默认）回落到 'zh' 显示。\r\n  const selectedValue = language.text === 'en' ? 'en' : 'zh'\r\n\r\n  return (\r\n    <SettingsForm labels={formLabels(t)} state={state} onSave={props.save} onDiscard={props.discard}>\r\n      <div className={css.page}>\r\n        <div className={css.field}>\r\n          <div className={css.fieldText}>\r\n            <div className={css.title}>{t('page.label')}</div>\r\n            <div className={css.hint}>{t('page.hint')}</div>\r\n          </div>\r\n          <SegmentedControl\r\n            id=\"conversation-language\"\r\n            value={selectedValue}\r\n            options={LANGUAGE_OPTIONS}\r\n            onChange={(next) => {\r\n              props.edit('conversationLanguage', next)\r\n            }}\r\n            label={t('page.label')}\r\n            disabled={disabled}\r\n            className={css.control}\r\n          />\r\n        </div>\r\n      </div>\r\n    </SettingsForm>\r\n  )\r\n}\r\n","/** Localization dictionaries (detail page only) */\r\nexport const zh = {\r\n  \"title\": \"对话语言\",\r\n  \"description\": \"选择 AI 思考与回复使用的语言，保存后下一轮模型步骤即时生效。\",\r\n  \"page.label\": \"对话语言\",\r\n  \"page.hint\": \"选择 AI 思考与回复使用的语言，保存后下一轮模型步骤即时生效。\",\r\n  \"form.unavailable\": \"该插件当前未加载，暂时无法配置。\",\r\n  \"form.readOnly\": \"本部署的设置为只读。\",\r\n  \"form.saveFailed\": \"保存未被接受，已保留供你修改。\",\r\n  \"form.save\": \"保存\",\r\n  \"form.saving\": \"保存中…\",\r\n  \"form.overridden\": \"已覆盖\",\r\n  \"form.reset\": \"恢复默认\",\r\n  \"form.invalid\": \"无效值\",\r\n} as const\r\n\r\nexport const en = {\r\n  \"title\": \"Conversation Language\",\r\n  \"description\": \"Choose the language the AI thinks and replies in. Takes effect on the next model step after saving.\",\r\n  \"page.label\": \"Conversation language\",\r\n  \"page.hint\": \"Choose the language the AI thinks and replies in. Takes effect on the next model step after saving.\",\r\n  \"form.unavailable\": \"This plugin is not loaded, so it cannot be configured right now.\",\r\n  \"form.readOnly\": \"This deployment stores settings read-only.\",\r\n  \"form.saveFailed\": \"The deployment did not accept these values; they were left for you to correct.\",\r\n  \"form.save\": \"Save\",\r\n  \"form.saving\": \"Saving…\",\r\n  \"form.overridden\": \"Overridden\",\r\n  \"form.reset\": \"Reset to default\",\r\n  \"form.invalid\": \"Invalid value\",\r\n} as const\r\n","/**\r\n * Shared constants usable by both the Host bundle and the Client bundle.\r\n * The client reads the settings namespace through this barrel so it never\r\n * value-imports a Host-only package such as `@deepseek-ai/dsh-system-prompt`.\r\n */\r\n\r\n/** The settings namespace is the profile entry id of this plugin row. */\r\nexport const CONVERSATION_LANGUAGE_NAMESPACE = 'tool-conversation-language'\r\n\r\n/** 对话语言: 'zh' (中文) 或 'en' (英文), 默认 'zh' */\r\nexport type ConversationLanguage = 'zh' | 'en'\r\n\r\n/** npm 包名：`plugins.bundle.config` slot 的 key。 */\r\nexport const PLUGIN_PACKAGE_NAME = '@dingpenghui/dsh-conversation-language'\r\n\r\n/** `plugins.row.config` slot 的 key：`<package>#<row id>`。 */\r\nexport const PLUGIN_ROW_CONFIG_KEY = `${PLUGIN_PACKAGE_NAME}#${CONVERSATION_LANGUAGE_NAMESPACE}`\r\n","/**\r\n * Client-side entry for the conversation language switcher plugin.\r\n * Registers a plugin detail page (the screen opened when clicking the plugin's\r\n * name in the Plugins list) through the Plugins page's `plugins.bundle.config`\r\n * and `plugins.row.config` slots.\r\n *\r\n * Architecture (DSH 0.2.0-rc.1): the detail page binds to the\r\n * Host's settings form through `ctx.configForms.get(CONVERSATION_LANGUAGE_NAMESPACE)`\r\n * — the settings framework mirrors the Host descriptor into the browser and\r\n * queues writes against the active profile's Cordis patch. Detail-page\r\n * registration follows the `ui-settings-shell` pattern:\r\n * `ctx.configForms.whileServed([NS], …)` + `ctx.slots.inject(...)`, so a\r\n * deployment that never composed the owner shows no trace of the page.\r\n *\r\n * The language switcher is reachable only from the plugin detail page —\r\n * we no longer register a row into the General Settings section\r\n * (`settings.general.item`); the plugin list page is the single entry point.\r\n */\r\nimport type { Context as ClientContext } from '@deepseek-ai/cordis'\r\n// Type-only: pulls the SlotRegistry service merge (ctx.slots).\r\nimport type {} from '@deepseek-ai/dsh-client-ui-renderer/client'\r\n// Type-only: the Plugins page slot contract (plugins.bundle.config /\r\n// plugins.row.config); the owner's SlotMap merge, never a runtime import.\r\nimport type {} from '@deepseek-ai/dsh-client-ui-plugin-manager/client'\r\n// Type-only: pulls the ctx.locale merge.\r\nimport type {} from '@deepseek-ai/dsh-client-locale/client'\r\n// Type-only: the ctx.configForms Context merge and the settings slot types.\r\n// Cross-plugin collaboration goes through the service, never a value import\r\n// (client bundle purity gate).\r\nimport type {} from '@deepseek-ai/dsh-client-ui-settings/client'\r\n\r\nimport { ConversationLanguagePageController } from './plugin-detail-controller.ts'\r\nimport type { ConversationLanguageSettings } from './plugin-detail-controller.ts'\r\nimport { ConversationLanguageDetailPage } from './plugin-detail-page.tsx'\r\nimport { zh as zhDict, en as enDict } from '../locales/index.ts'\r\n// Shared barrel: keeps this bundle free of Host-only package value imports.\r\nimport {\r\n  CONVERSATION_LANGUAGE_NAMESPACE,\r\n  PLUGIN_PACKAGE_NAME,\r\n  PLUGIN_ROW_CONFIG_KEY,\r\n} from '../shared.ts'\r\n\r\nconst DICT_NS = 'settings.conversation-language'\r\n\r\nexport const inject = ['slots', 'locale', 'configForms', 'connection'] as const\r\n\r\nexport function apply(ctx: ClientContext): void {\r\n  const slots = ctx.get('slots')!\r\n  const locale = ctx.get('locale')!\r\n\r\n  // Register locale dictionaries\r\n  ctx.effect(() => locale.register(DICT_NS, { zh: zhDict, en: enDict }), 'conversation-language: dictionaries')\r\n\r\n  // 详情页:把语言选择表单挂到插件详情页。\r\n  // 参照 ui-settings-shell:whileServed 保证部署从未组合宿主侧的\r\n  // 命名空间时,页面不留任何痕迹;注册随 served 变化自动增删。\r\n  const detailPage = new ConversationLanguagePageController(\r\n    ctx.get('configForms')!.get<ConversationLanguageSettings>(CONVERSATION_LANGUAGE_NAMESPACE)\r\n  )\r\n  ctx.effect(() => () => {\r\n    detailPage.dispose()\r\n  }, 'conversation-language: detail form subscriptions')\r\n\r\n  ctx.effect(() => ctx.get('configForms')!.whileServed([CONVERSATION_LANGUAGE_NAMESPACE], () => {\r\n    // Bundle 详情页(点击插件名字打开的画面):描述与行之间的配置区块。\r\n    const bundleDisposer = slots.inject('plugins.bundle.config', () => slots.register({\r\n      name: 'plugins.bundle.config',\r\n      key: PLUGIN_PACKAGE_NAME,\r\n      locale: DICT_NS,\r\n      inject: () => detailPage.inject(),\r\n    }, ConversationLanguageDetailPage))\r\n    // 行详情页(行上\"配置\"控件打开的画面):`<package>#<row id>` key。\r\n    const rowDisposer = slots.inject('plugins.row.config', () => slots.register({\r\n      name: 'plugins.row.config',\r\n      key: PLUGIN_ROW_CONFIG_KEY,\r\n      locale: DICT_NS,\r\n      inject: () => detailPage.inject(),\r\n    }, ConversationLanguageDetailPage))\r\n    return () => {\r\n      rowDisposer()\r\n      bundleDisposer()\r\n    }\r\n  }), 'conversation-language: detail page')\r\n}\r\n"],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,40 @@
+import z from "@deepseek-ai/schemastery";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/shared.d.ts
+/**
+ * Shared constants usable by both the Host bundle and the Client bundle.
+ * The client reads the settings namespace through this barrel so it never
+ * value-imports a Host-only package such as `@deepseek-ai/dsh-system-prompt`.
+ */
+/** The settings namespace is the profile entry id of this plugin row. */
+declare const CONVERSATION_LANGUAGE_NAMESPACE = "tool-conversation-language";
+/** 对话语言: 'zh' (中文) 或 'en' (英文), 默认 'zh' */
+type ConversationLanguage = 'zh' | 'en';
+//#endregion
+//#region src/index.d.ts
+/** Plugin config: the language the conversation runs in. */
+interface Config {
+  /**
+   * Conversation language the model thinks and replies in. Volatile: the
+   * settings UI writes it through the active profile's Cordis patch.
+   */
+  conversationLanguage: 'zh' | 'en';
+}
+/** Runtime schema for the conversation-language row. */
+declare const Config: z<Schemastery.ObjectS<NoInfer<{
+  conversationLanguage: z<"zh" | "en", "zh" | "en", "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+  conversationLanguage: z<"zh" | "en", "zh" | "en", "volatile-defined">;
+}>>, "plain">;
+declare const name = "conversation-language";
+declare const inject: readonly ["systemPrompt", "tools"];
+/**
+ * Register the tool and the `system-prompt/assemble` waterfall interception.
+ * The language is read from the settings framework on every assembly so a
+ * switch takes effect on the very next model step without a remount.
+ * @param ctx - the plugin context carrying the settings, systemPrompt, and tools services.
+ */
+declare function apply(ctx: Context): void;
+//#endregion
+export { CONVERSATION_LANGUAGE_NAMESPACE, Config, type ConversationLanguage, apply, inject, name };
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/shared.ts","../src/index.ts"],"mappings":";;;;;;;;;cAOa;;KAGD;;;;UCuBK;;;;;EAKf;;;cAIW,QAAM,EAAA,YAAA,QAAA;;;;;cAyBN;cACA;;;;;;;iBAQG,MAAM,KAAK"}

package/lib/index.js

@@ -0,0 +1,88 @@
+import { PERSONA_PREFIX_SECTION, PERSONA_SUFFIX_SECTION } from "@deepseek-ai/dsh-system-prompt";
+import z from "@deepseek-ai/schemastery";
+import { defineTool } from "@deepseek-ai/dsh-tools";
+//#region src/shared.ts
+/**
+* Shared constants usable by both the Host bundle and the Client bundle.
+* The client reads the settings namespace through this barrel so it never
+* value-imports a Host-only package such as `@deepseek-ai/dsh-system-prompt`.
+*/
+/** The settings namespace is the profile entry id of this plugin row. */
+const CONVERSATION_LANGUAGE_NAMESPACE = "tool-conversation-language";
+//#endregion
+//#region src/index.ts
+/** Runtime schema for the conversation-language row. */
+const Config = z.object({ conversationLanguage: z.union([z.const("zh"), z.const("en")]).volatile().default("zh") });
+const LANGUAGE_SUFFIX_ZH = `
+
+【语言指令】
+当前对话语言为「中文」。你必须：
+1. 所有思考过程使用中文
+2. 所有回复内容使用中文
+3. 所有面向用户可见的文本都必须使用中文，包括工具调用的参数值：pwsh/bash 的 description、todo_write 的 content、subagent 的 description、任务与作业的名称等，都要用中文书写；不要沿用工具 schema 里的英文示例措辞（例如 "List files in current directory"）
+4. 如果思考中使用了英文，立即纠正回中文`;
+const LANGUAGE_SUFFIX_EN = `
+
+[Language Instruction]
+The current conversation language is "English". You MUST:
+1. Use English for all thinking processes
+2. Use English for all response content
+3. Use English for every user-visible string, including tool-call argument values: the description argument of pwsh/bash, todo_write content, subagent descriptions, and job or task titles. Do not reuse the English wording of a tool schema's examples.
+4. If you accidentally think in another language, immediately correct back to English`;
+const name = "conversation-language";
+const inject = ["systemPrompt", "tools"];
+/**
+* Register the tool and the `system-prompt/assemble` waterfall interception.
+* The language is read from the settings framework on every assembly so a
+* switch takes effect on the very next model step without a remount.
+* @param ctx - the plugin context carrying the settings, systemPrompt, and tools services.
+*/
+function apply(ctx) {
+	const settings = ctx.get("settings");
+	/** Read the live conversation language from the settings framework. */
+	const getLanguage = () => {
+		if (settings === void 0) return "zh";
+		return (settings.describe().find((row) => row.ns === "tool-conversation-language")?.value)?.conversationLanguage ?? "zh";
+	};
+	ctx.on("system-prompt/assemble", async (assembly, context, next) => {
+		const lang = getLanguage();
+		const personaSection = assembly.sections.find((s) => s.name === PERSONA_PREFIX_SECTION) ?? assembly.sections.find((s) => s.name === PERSONA_SUFFIX_SECTION);
+		if (personaSection) personaSection.text += lang === "en" ? LANGUAGE_SUFFIX_EN : LANGUAGE_SUFFIX_ZH;
+		for (const tool of assembly.tools) if (lang === "zh" && !String(tool.description).startsWith("[中文思考]")) tool.description = `[中文思考] ${tool.description}`;
+		else if (lang === "en" && !String(tool.description).startsWith("[English Thinking]")) tool.description = `[English Thinking] ${tool.description}`;
+		return next();
+	});
+	ctx.tools.register(defineTool({
+		name: "get_conversation_language",
+		description: "获取当前对话语言设置",
+		parameters: {},
+		output: {
+			schema: {
+				type: "object",
+				properties: {
+					language: {
+						type: "string",
+						enum: ["zh", "en"]
+					},
+					label: { type: "string" }
+				},
+				additionalProperties: false
+			},
+			render: (_args, value) => [{
+				type: "text",
+				text: `当前对话语言：${value.label} (${value.language})`
+			}]
+		},
+		execute: async () => {
+			const lang = getLanguage();
+			return {
+				language: lang,
+				label: lang === "zh" ? "中文" : "English"
+			};
+		}
+	}));
+}
+//#endregion
+export { CONVERSATION_LANGUAGE_NAMESPACE, Config, apply, inject, name };
+
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/shared.ts","../src/index.ts"],"sourcesContent":["/**\r\n * Shared constants usable by both the Host bundle and the Client bundle.\r\n * The client reads the settings namespace through this barrel so it never\r\n * value-imports a Host-only package such as `@deepseek-ai/dsh-system-prompt`.\r\n */\r\n\r\n/** The settings namespace is the profile entry id of this plugin row. */\r\nexport const CONVERSATION_LANGUAGE_NAMESPACE = 'tool-conversation-language'\r\n\r\n/** 对话语言: 'zh' (中文) 或 'en' (英文), 默认 'zh' */\r\nexport type ConversationLanguage = 'zh' | 'en'\r\n\r\n/** npm 包名：`plugins.bundle.config` slot 的 key。 */\r\nexport const PLUGIN_PACKAGE_NAME = '@dingpenghui/dsh-conversation-language'\r\n\r\n/** `plugins.row.config` slot 的 key：`<package>#<row id>`。 */\r\nexport const PLUGIN_ROW_CONFIG_KEY = `${PLUGIN_PACKAGE_NAME}#${CONVERSATION_LANGUAGE_NAMESPACE}`\r\n","/**\r\n * Conversation Language Switcher Plugin for DeepSeek Harness\r\n *\r\n * Provides a setting in General Settings to switch conversation language\r\n * between Chinese and English. Uses closed-over state + waterfall interception\r\n * to maximize language consistency across all scenarios (simple Q&A, tool calls,\r\n * skill analysis, etc.).\r\n *\r\n * Install: dsh plugin --profile web add <path-to-plugin>\r\n *\r\n * Architecture (DSH 0.1.7-alpha.2+):\r\n * - Host half declares a `Config` schema with a volatile `conversationLanguage`\r\n *   field; the settings framework projects it to the browser and persists it\r\n *   through the active profile's Cordis patch.\r\n * - The `system-prompt/assemble` waterfall reads the live settings value on\r\n *   every assembly, so language switches take effect without a restart.\r\n */\r\n\r\nimport type { Context } from '@deepseek-ai/cordis'\r\nimport type { AssembleContext, PromptAssembly } from '@deepseek-ai/dsh-system-prompt'\r\nimport { PERSONA_PREFIX_SECTION, PERSONA_SUFFIX_SECTION } from '@deepseek-ai/dsh-system-prompt'\r\nimport z from '@deepseek-ai/schemastery'\r\nimport { defineTool } from '@deepseek-ai/dsh-tools'\r\n// Ensure module augmentation for systemPrompt service and system-prompt/assemble event is visible\r\nimport type {} from '@deepseek-ai/dsh-system-prompt'\r\n// Pull the SettingsForms Context merge (ctx.settings) into this program.\r\nimport type {} from '@deepseek-ai/dsh-settings'\r\nimport { CONVERSATION_LANGUAGE_NAMESPACE, type ConversationLanguage } from './shared.ts'\r\n\r\nexport { CONVERSATION_LANGUAGE_NAMESPACE }\r\nexport type { ConversationLanguage }\r\n\r\n/** Plugin config: the language the conversation runs in. */\r\nexport interface Config {\r\n  /**\r\n   * Conversation language the model thinks and replies in. Volatile: the\r\n   * settings UI writes it through the active profile's Cordis patch.\r\n   */\r\n  conversationLanguage: 'zh' | 'en'\r\n}\r\n\r\n/** Runtime schema for the conversation-language row. */\r\nexport const Config = z.object({\r\n  conversationLanguage: z.union([z.const('zh'), z.const('en')]).volatile().default('zh'),\r\n})\r\n\r\n// Persona templates — append language instruction to whatever preset persona\r\n// the current session uses. The base persona is detected from the assembly at\r\n// runtime; we only inject the language section.\r\nconst LANGUAGE_SUFFIX_ZH = `\r\n\r\n【语言指令】\r\n当前对话语言为「中文」。你必须：\r\n1. 所有思考过程使用中文\r\n2. 所有回复内容使用中文\r\n3. 所有面向用户可见的文本都必须使用中文，包括工具调用的参数值：pwsh/bash 的 description、todo_write 的 content、subagent 的 description、任务与作业的名称等，都要用中文书写；不要沿用工具 schema 里的英文示例措辞（例如 \"List files in current directory\"）\r\n4. 如果思考中使用了英文，立即纠正回中文`\r\n\r\nconst LANGUAGE_SUFFIX_EN = `\r\n\r\n[Language Instruction]\r\nThe current conversation language is \"English\". You MUST:\r\n1. Use English for all thinking processes\r\n2. Use English for all response content\r\n3. Use English for every user-visible string, including tool-call argument values: the description argument of pwsh/bash, todo_write content, subagent descriptions, and job or task titles. Do not reuse the English wording of a tool schema's examples.\r\n4. If you accidentally think in another language, immediately correct back to English`\r\n\r\nexport const name = 'conversation-language'\r\nexport const inject = ['systemPrompt', 'tools'] as const\r\n\r\n/**\r\n * Register the tool and the `system-prompt/assemble` waterfall interception.\r\n * The language is read from the settings framework on every assembly so a\r\n * switch takes effect on the very next model step without a remount.\r\n * @param ctx - the plugin context carrying the settings, systemPrompt, and tools services.\r\n */\r\nexport function apply(ctx: Context): void {\r\n  const settings = ctx.get('settings')\r\n\r\n  /** Read the live conversation language from the settings framework. */\r\n  const getLanguage = (): ConversationLanguage => {\r\n    if (settings === undefined) return 'zh'\r\n    const descriptor = settings.describe().find(row => row.ns === CONVERSATION_LANGUAGE_NAMESPACE)\r\n    const value = descriptor?.value as { conversationLanguage?: ConversationLanguage } | undefined\r\n    return value?.conversationLanguage ?? 'zh'\r\n  }\r\n\r\n  // 使用 system-prompt/assemble waterfall 拦截\r\n  // 动态读取当前 preset 的 persona，追加语言部分\r\n  ctx.on('system-prompt/assemble', async (assembly: PromptAssembly, context: AssembleContext, next: () => Promise<PromptAssembly>) => {\r\n    const lang = getLanguage()\r\n\r\n    // 查找当前 preset 的 persona section\r\n    // DSH 0.1.5+ 将 persona 拆分为 prefix（order 0，preset 影子）与 suffix\r\n    // （order 10200）两个 section；优先追加到 prefix（与原 0.1.2 的\r\n    // 'deployment:persona' 位置一致），prefix 缺失时回退到 suffix。\r\n    const personaSection =\r\n      assembly.sections.find(s => s.name === PERSONA_PREFIX_SECTION)\r\n      ?? assembly.sections.find(s => s.name === PERSONA_SUFFIX_SECTION)\r\n    if (personaSection) {\r\n      // 在 persona 末尾追加语言指令\r\n      personaSection.text += lang === 'en' ? LANGUAGE_SUFFIX_EN : LANGUAGE_SUFFIX_ZH\r\n    }\r\n\r\n    // 向 tool schemas 添加语言前缀\r\n    for (const tool of assembly.tools) {\r\n      if (lang === 'zh' && !String(tool.description).startsWith('[中文思考]')) {\r\n        tool.description = `[中文思考] ${tool.description}`\r\n      } else if (lang === 'en' && !String(tool.description).startsWith('[English Thinking]')) {\r\n        tool.description = `[English Thinking] ${tool.description}`\r\n      }\r\n    }\r\n\r\n    return next()\r\n  })\r\n\r\n  // Register tool to query the current language\r\n  ctx.tools.register(defineTool({\r\n    name: 'get_conversation_language',\r\n    description: '获取当前对话语言设置',\r\n    parameters: {},\r\n    output: {\r\n      schema: {\r\n        type: 'object',\r\n        properties: {\r\n          language: { type: 'string', enum: ['zh', 'en'] },\r\n          label: { type: 'string' },\r\n        },\r\n        additionalProperties: false,\r\n      },\r\n      render: (_args, value) => [{\r\n        type: 'text',\r\n        text: `当前对话语言：${value.label} (${value.language})`,\r\n      }],\r\n    },\r\n    execute: async () => {\r\n      const lang = getLanguage()\r\n      return {\r\n        language: lang,\r\n        label: lang === 'zh' ? '中文' : 'English',\r\n      }\r\n    },\r\n  }))\r\n}\r\n"],"mappings":";;;;;;;;;;AAOA,MAAa,kCAAkC;;;;ACmC/C,MAAa,SAAS,EAAE,OAAO,EAC7B,sBAAsB,EAAE,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,IAAI,EACvF,CAAC;AAKD,MAAM,qBAAqB;;;;;;;;AAS3B,MAAM,qBAAqB;;;;;;;;AAS3B,MAAa,OAAO;AACpB,MAAa,SAAS,CAAC,gBAAgB,OAAO;;;;;;;AAQ9C,SAAgB,MAAM,KAAoB;CACxC,MAAM,WAAW,IAAI,IAAI,UAAU;;CAGnC,MAAM,oBAA0C;EAC9C,IAAI,aAAa,KAAA,GAAW,OAAO;EAGnC,QAFmB,SAAS,SAAS,CAAC,CAAC,MAAK,QAAO,IAAI,OAAA,4BAChC,CAAC,EAAE,MAAA,EACZ,wBAAwB;CACxC;CAIA,IAAI,GAAG,0BAA0B,OAAO,UAA0B,SAA0B,SAAwC;EAClI,MAAM,OAAO,YAAY;EAMzB,MAAM,iBACJ,SAAS,SAAS,MAAK,MAAK,EAAE,SAAS,sBAAsB,KAC1D,SAAS,SAAS,MAAK,MAAK,EAAE,SAAS,sBAAsB;EAClE,IAAI,gBAEF,eAAe,QAAQ,SAAS,OAAO,qBAAqB;EAI9D,KAAK,MAAM,QAAQ,SAAS,OAC1B,IAAI,SAAS,QAAQ,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC,WAAW,QAAQ,GAChE,KAAK,cAAc,UAAU,KAAK;OAC7B,IAAI,SAAS,QAAQ,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC,WAAW,oBAAoB,GACnF,KAAK,cAAc,sBAAsB,KAAK;EAIlD,OAAO,KAAK;CACd,CAAC;CAGD,IAAI,MAAM,SAAS,WAAW;EAC5B,MAAM;EACN,aAAa;EACb,YAAY,CAAC;EACb,QAAQ;GACN,QAAQ;IACN,MAAM;IACN,YAAY;KACV,UAAU;MAAE,MAAM;MAAU,MAAM,CAAC,MAAM,IAAI;KAAE;KAC/C,OAAO,EAAE,MAAM,SAAS;IAC1B;IACA,sBAAsB;GACxB;GACA,SAAS,OAAO,UAAU,CAAC;IACzB,MAAM;IACN,MAAM,UAAU,MAAM,MAAM,IAAI,MAAM,SAAS;GACjD,CAAC;EACH;EACA,SAAS,YAAY;GACnB,MAAM,OAAO,YAAY;GACzB,OAAO;IACL,UAAU;IACV,OAAO,SAAS,OAAO,OAAO;GAChC;EACF;CACF,CAAC,CAAC;AACJ"}

package/package.json

@@ -1,6 +1,81 @@
-{
-  "name": "@dingpenghui/dsh-conversation-language",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "@dingpenghui/dsh-conversation-language",
+  "version": "3.2.2",
+  "description": "DSH plugin for switching conversation language between Chinese and English",
+  "type": "module",
+  "main": "./lib/index.js",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-primitives",
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-plugin-manager",
+        "@deepseek-ai/dsh-client-store"
+      ],
+      "platform": "web"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Dingpenghui-good/dsh-conversation-language.git"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "conversation",
+    "language",
+    "cordis"
+  ],
+  "author": "Dingpenghui-good",
+  "files": [
+    "lib",
+    "src",
+    "package.json",
+    "README.md",
+    "cordis.patch.yml"
+  ],
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch"
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-store": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.2.0-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.4",
+    "@types/react": "^18.3.12",
+    "react": "^18.2.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
+    "lightningcss": "^1.29.2",
+    "tsdown": "^0.22.14",
+    "typescript": "^5.9.3"
+  }
+}

package/src/client/PluginDetailPage.module.css

@@ -0,0 +1,40 @@
+/* 对话语言插件详情页样式（对齐 ui-settings-shell 的 SettingsForm 布局） */
+
+.page {
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+  padding-bottom: 16px;
+}
+
+.field {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 16px 0;
+  border-bottom: 1px solid var(--dsw-alias-border-l2);
+}
+
+.fieldText {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.title {
+  font-size: 14px;
+  font-weight: 400;
+  line-height: 22px;
+  color: var(--dsw-alias-label-primary);
+}
+
+.hint {
+  font-size: 12px;
+  font-weight: 400;
+  line-height: 18px;
+  color: var(--dsw-alias-label-secondary);
+}
+
+.control {
+  width: 100%;
+}

package/src/client/index.ts

@@ -0,0 +1,84 @@
+/**
+ * Client-side entry for the conversation language switcher plugin.
+ * Registers a plugin detail page (the screen opened when clicking the plugin's
+ * name in the Plugins list) through the Plugins page's `plugins.bundle.config`
+ * and `plugins.row.config` slots.
+ *
+ * Architecture (DSH 0.2.0-rc.1): the detail page binds to the
+ * Host's settings form through `ctx.configForms.get(CONVERSATION_LANGUAGE_NAMESPACE)`
+ * — the settings framework mirrors the Host descriptor into the browser and
+ * queues writes against the active profile's Cordis patch. Detail-page
+ * registration follows the `ui-settings-shell` pattern:
+ * `ctx.configForms.whileServed([NS], …)` + `ctx.slots.inject(...)`, so a
+ * deployment that never composed the owner shows no trace of the page.
+ *
+ * The language switcher is reachable only from the plugin detail page —
+ * we no longer register a row into the General Settings section
+ * (`settings.general.item`); the plugin list page is the single entry point.
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis'
+// Type-only: pulls the SlotRegistry service merge (ctx.slots).
+import type {} from '@deepseek-ai/dsh-client-ui-renderer/client'
+// Type-only: the Plugins page slot contract (plugins.bundle.config /
+// plugins.row.config); the owner's SlotMap merge, never a runtime import.
+import type {} from '@deepseek-ai/dsh-client-ui-plugin-manager/client'
+// Type-only: pulls the ctx.locale merge.
+import type {} from '@deepseek-ai/dsh-client-locale/client'
+// Type-only: the ctx.configForms Context merge and the settings slot types.
+// Cross-plugin collaboration goes through the service, never a value import
+// (client bundle purity gate).
+import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
+
+import { ConversationLanguagePageController } from './plugin-detail-controller.ts'
+import type { ConversationLanguageSettings } from './plugin-detail-controller.ts'
+import { ConversationLanguageDetailPage } from './plugin-detail-page.tsx'
+import { zh as zhDict, en as enDict } from '../locales/index.ts'
+// Shared barrel: keeps this bundle free of Host-only package value imports.
+import {
+  CONVERSATION_LANGUAGE_NAMESPACE,
+  PLUGIN_PACKAGE_NAME,
+  PLUGIN_ROW_CONFIG_KEY,
+} from '../shared.ts'
+
+const DICT_NS = 'settings.conversation-language'
+
+export const inject = ['slots', 'locale', 'configForms', 'connection'] as const
+
+export function apply(ctx: ClientContext): void {
+  const slots = ctx.get('slots')!
+  const locale = ctx.get('locale')!
+
+  // Register locale dictionaries
+  ctx.effect(() => locale.register(DICT_NS, { zh: zhDict, en: enDict }), 'conversation-language: dictionaries')
+
+  // 详情页:把语言选择表单挂到插件详情页。
+  // 参照 ui-settings-shell:whileServed 保证部署从未组合宿主侧的
+  // 命名空间时,页面不留任何痕迹;注册随 served 变化自动增删。
+  const detailPage = new ConversationLanguagePageController(
+    ctx.get('configForms')!.get<ConversationLanguageSettings>(CONVERSATION_LANGUAGE_NAMESPACE)
+  )
+  ctx.effect(() => () => {
+    detailPage.dispose()
+  }, 'conversation-language: detail form subscriptions')
+
+  ctx.effect(() => ctx.get('configForms')!.whileServed([CONVERSATION_LANGUAGE_NAMESPACE], () => {
+    // Bundle 详情页(点击插件名字打开的画面):描述与行之间的配置区块。
+    const bundleDisposer = slots.inject('plugins.bundle.config', () => slots.register({
+      name: 'plugins.bundle.config',
+      key: PLUGIN_PACKAGE_NAME,
+      locale: DICT_NS,
+      inject: () => detailPage.inject(),
+    }, ConversationLanguageDetailPage))
+    // 行详情页(行上"配置"控件打开的画面):`<package>#<row id>` key。
+    const rowDisposer = slots.inject('plugins.row.config', () => slots.register({
+      name: 'plugins.row.config',
+      key: PLUGIN_ROW_CONFIG_KEY,
+      locale: DICT_NS,
+      inject: () => detailPage.inject(),
+    }, ConversationLanguageDetailPage))
+    return () => {
+      rowDisposer()
+      bundleDisposer()
+    }
+  }), 'conversation-language: detail page')
+}

package/src/client/plugin-detail-controller.ts

@@ -0,0 +1,107 @@
+/**
+ * 对话语言插件详情页的 staged form：把宿主 settings 命名空间桥接到
+ * 插件详情页（plugins.bundle.config / plugins.row.config）的保存控件。
+ * 参照 ui-settings-shell 的 ShellCardController 模式。
+ */
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store'
+import {
+  SettingsFormModel,
+  type SettingsFieldState,
+  type SettingsFormActions,
+  type SettingsFormScope,
+  type SettingsFormShell,
+} from '@deepseek-ai/dsh-client-ui-primitives'
+import type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client'
+import type { ConversationLanguage } from '../shared.ts'
+
+/** 详情页编辑的字段 —— 命名空间 schema 的子集。 */
+export interface ConversationLanguageSettings {
+  /** 对话语言。 */
+  conversationLanguage?: ConversationLanguage
+}
+
+/** 详情页渲染的表单状态。 */
+export interface ConversationLanguagePageState extends SettingsFormShell {
+  conversationLanguage: SettingsFieldState
+}
+
+/** 注册侧注入给详情页组件的面。 */
+export interface ConversationLanguagePageFace extends SettingsFormActions {
+  hooks: {
+    /** 页面快照，渲染器绑定为 useConversationLanguagePage。 */
+    conversationLanguagePage: SnapshotStore<ConversationLanguagePageState>
+  }
+}
+
+/** 语言字段的 format/parse 规范：只接受 'zh' / 'en'，空串清除回继承层。 */
+function languageFieldSpec() {
+  const accepted: readonly string[] = ['zh', 'en']
+  return {
+    field: 'conversationLanguage',
+    format: (value: unknown) => (typeof value === 'string' ? value : ''),
+    parse: (text: string) => {
+      const trimmed = text.trim()
+      if (accepted.includes(trimmed)) return { kind: 'set' as const, value: trimmed }
+      if (trimmed === '') return { kind: 'clear' as const }
+      return undefined
+    },
+  }
+}
+
+/**
+ * 把命名空间的 `ConfigForm` 适配为 `SettingsFormModel` 需要的
+ * `SettingsFormScope`：两者读快照形状一致，只有 `mutate` 操作类型不同
+ * （`SettingsFormPathOp` vs `SettingsPathOpView`），页面只做读与原子写，
+ * 故按结构复用。
+ */
+function asFormScope(
+  scope: ConfigForm<ConversationLanguageSettings>
+): SettingsFormScope<ConversationLanguageSettings> {
+  return {
+    getSnapshot: () => {
+      const s = scope.getSnapshot()
+      return {
+        status: s.status,
+        value: s.value,
+        base: s.base,
+        user: s.user,
+        writable: s.writable,
+        revision: s.revision,
+      }
+    },
+    subscribe: (listener) => scope.subscribe(listener),
+    mutate: (ops, expectedRevision) => scope.mutate(ops as never, expectedRevision),
+  }
+}
+
+/** 把一个宿主 settings 命名空间桥接到详情页的 staged form。 */
+export class ConversationLanguagePageController {
+  private readonly form: SettingsFormModel<ConversationLanguageSettings>
+  private readonly store: SnapshotStore<ConversationLanguagePageState>
+
+  /** @param scope - 共享配置表单（命名空间的 ConfigForm）。 */
+  constructor(scope: ConfigForm<ConversationLanguageSettings>) {
+    this.form = new SettingsFormModel(asFormScope(scope), [languageFieldSpec()])
+    this.store = this.form.bind(() => this.projection())
+  }
+
+  private projection(): ConversationLanguagePageState {
+    return {
+      ...this.form.shell(),
+      conversationLanguage: this.form.field('conversationLanguage'),
+    }
+  }
+
+  /**
+   * 构建详情页 slot 注册注入的面。
+   * @returns 页面快照与表单动作。
+   */
+  inject(): ConversationLanguagePageFace {
+    return { hooks: { conversationLanguagePage: this.store }, ...this.form.actions() }
+  }
+
+  /** 释放表单订阅。 */
+  dispose(): void {
+    this.form.dispose()
+  }
+}

package/src/client/plugin-detail-page.tsx

@@ -0,0 +1,77 @@
+/**
+ * 对话语言插件详情页：点击插件列表中的插件名字后打开的画面。
+ * 参照 ui-settings-shell 的 ShellCard 模式：一行摘要（`view: 'summary'`）
+ * 或语言选择表单（`view: 'page'`），表单带保存控件。
+ */
+import type { PropsLocale, PropsRuntime, InjectFace, TranslateNS } from '@deepseek-ai/dsh-client-ui-slots'
+import { SegmentedControl, SettingsForm } from '@deepseek-ai/dsh-client-ui-primitives'
+import type { SegmentedControlOption } from '@deepseek-ai/dsh-client-ui-primitives'
+import type { ConversationLanguagePageFace } from './plugin-detail-controller.ts'
+import type { ConversationLanguage } from '../shared.ts'
+import css from './PluginDetailPage.module.css'
+
+/** 渲染器为详情页绑定的 props。 */
+export type ConversationLanguageDetailPageProps =
+  & PropsRuntime<'plugins.bundle.config'>
+  & PropsLocale<'settings.conversation-language'>
+  & InjectFace<ConversationLanguagePageFace>
+
+/** 语言选项（与宿主 schema 的枚举一致）。 */
+const LANGUAGE_OPTIONS: readonly SegmentedControlOption<ConversationLanguage>[] = [
+  { value: 'zh', label: '中文' },
+  { value: 'en', label: 'English' },
+]
+
+/** 从 locale 字典派生 SettingsForm 的标签文案。 */
+function formLabels(t: TranslateNS<'settings.conversation-language'>) {
+  return {
+    unavailable: t('form.unavailable'),
+    readOnly: t('form.readOnly'),
+    saveFailed: t('form.saveFailed'),
+    save: t('form.save'),
+    saving: t('form.saving'),
+  }
+}
+
+/**
+ * 渲染详情页：一行摘要（`view: 'summary'`）或语言选择表单（`view: 'page'`）。
+ * @param props - 视图、locale 文案、表单快照与动作。
+ * @returns 摘要文字，或带保存控件的语言表单。
+ */
+export function ConversationLanguageDetailPage(props: ConversationLanguageDetailPageProps) {
+  const { t } = props
+  const state = props.useConversationLanguagePage((snapshot) => snapshot)
+
+  if (props.view === 'summary') {
+    return t('description')
+  }
+
+  const disabled = !state.writable
+  const language = state.conversationLanguage
+  // 文本稿映射到分段控件：'zh'/'en' 显示选中；空稿（清除/默认）回落到 'zh' 显示。
+  const selectedValue = language.text === 'en' ? 'en' : 'zh'
+
+  return (
+    <SettingsForm labels={formLabels(t)} state={state} onSave={props.save} onDiscard={props.discard}>
+      <div className={css.page}>
+        <div className={css.field}>
+          <div className={css.fieldText}>
+            <div className={css.title}>{t('page.label')}</div>
+            <div className={css.hint}>{t('page.hint')}</div>
+          </div>
+          <SegmentedControl
+            id="conversation-language"
+            value={selectedValue}
+            options={LANGUAGE_OPTIONS}
+            onChange={(next) => {
+              props.edit('conversationLanguage', next)
+            }}
+            label={t('page.label')}
+            disabled={disabled}
+            className={css.control}
+          />
+        </div>
+      </div>
+    </SettingsForm>
+  )
+}

package/src/index.ts

@@ -0,0 +1,144 @@
+/**
+ * Conversation Language Switcher Plugin for DeepSeek Harness
+ *
+ * Provides a setting in General Settings to switch conversation language
+ * between Chinese and English. Uses closed-over state + waterfall interception
+ * to maximize language consistency across all scenarios (simple Q&A, tool calls,
+ * skill analysis, etc.).
+ *
+ * Install: dsh plugin --profile web add <path-to-plugin>
+ *
+ * Architecture (DSH 0.1.7-alpha.2+):
+ * - Host half declares a `Config` schema with a volatile `conversationLanguage`
+ *   field; the settings framework projects it to the browser and persists it
+ *   through the active profile's Cordis patch.
+ * - The `system-prompt/assemble` waterfall reads the live settings value on
+ *   every assembly, so language switches take effect without a restart.
+ */
+
+import type { Context } from '@deepseek-ai/cordis'
+import type { AssembleContext, PromptAssembly } from '@deepseek-ai/dsh-system-prompt'
+import { PERSONA_PREFIX_SECTION, PERSONA_SUFFIX_SECTION } from '@deepseek-ai/dsh-system-prompt'
+import z from '@deepseek-ai/schemastery'
+import { defineTool } from '@deepseek-ai/dsh-tools'
+// Ensure module augmentation for systemPrompt service and system-prompt/assemble event is visible
+import type {} from '@deepseek-ai/dsh-system-prompt'
+// Pull the SettingsForms Context merge (ctx.settings) into this program.
+import type {} from '@deepseek-ai/dsh-settings'
+import { CONVERSATION_LANGUAGE_NAMESPACE, type ConversationLanguage } from './shared.ts'
+
+export { CONVERSATION_LANGUAGE_NAMESPACE }
+export type { ConversationLanguage }
+
+/** Plugin config: the language the conversation runs in. */
+export interface Config {
+  /**
+   * Conversation language the model thinks and replies in. Volatile: the
+   * settings UI writes it through the active profile's Cordis patch.
+   */
+  conversationLanguage: 'zh' | 'en'
+}
+
+/** Runtime schema for the conversation-language row. */
+export const Config = z.object({
+  conversationLanguage: z.union([z.const('zh'), z.const('en')]).volatile().default('zh'),
+})
+
+// Persona templates — append language instruction to whatever preset persona
+// the current session uses. The base persona is detected from the assembly at
+// runtime; we only inject the language section.
+const LANGUAGE_SUFFIX_ZH = `
+
+【语言指令】
+当前对话语言为「中文」。你必须：
+1. 所有思考过程使用中文
+2. 所有回复内容使用中文
+3. 所有面向用户可见的文本都必须使用中文，包括工具调用的参数值：pwsh/bash 的 description、todo_write 的 content、subagent 的 description、任务与作业的名称等，都要用中文书写；不要沿用工具 schema 里的英文示例措辞（例如 "List files in current directory"）
+4. 如果思考中使用了英文，立即纠正回中文`
+
+const LANGUAGE_SUFFIX_EN = `
+
+[Language Instruction]
+The current conversation language is "English". You MUST:
+1. Use English for all thinking processes
+2. Use English for all response content
+3. Use English for every user-visible string, including tool-call argument values: the description argument of pwsh/bash, todo_write content, subagent descriptions, and job or task titles. Do not reuse the English wording of a tool schema's examples.
+4. If you accidentally think in another language, immediately correct back to English`
+
+export const name = 'conversation-language'
+export const inject = ['systemPrompt', 'tools'] as const
+
+/**
+ * Register the tool and the `system-prompt/assemble` waterfall interception.
+ * The language is read from the settings framework on every assembly so a
+ * switch takes effect on the very next model step without a remount.
+ * @param ctx - the plugin context carrying the settings, systemPrompt, and tools services.
+ */
+export function apply(ctx: Context): void {
+  const settings = ctx.get('settings')
+
+  /** Read the live conversation language from the settings framework. */
+  const getLanguage = (): ConversationLanguage => {
+    if (settings === undefined) return 'zh'
+    const descriptor = settings.describe().find(row => row.ns === CONVERSATION_LANGUAGE_NAMESPACE)
+    const value = descriptor?.value as { conversationLanguage?: ConversationLanguage } | undefined
+    return value?.conversationLanguage ?? 'zh'
+  }
+
+  // 使用 system-prompt/assemble waterfall 拦截
+  // 动态读取当前 preset 的 persona，追加语言部分
+  ctx.on('system-prompt/assemble', async (assembly: PromptAssembly, context: AssembleContext, next: () => Promise<PromptAssembly>) => {
+    const lang = getLanguage()
+
+    // 查找当前 preset 的 persona section
+    // DSH 0.1.5+ 将 persona 拆分为 prefix（order 0，preset 影子）与 suffix
+    // （order 10200）两个 section；优先追加到 prefix（与原 0.1.2 的
+    // 'deployment:persona' 位置一致），prefix 缺失时回退到 suffix。
+    const personaSection =
+      assembly.sections.find(s => s.name === PERSONA_PREFIX_SECTION)
+      ?? assembly.sections.find(s => s.name === PERSONA_SUFFIX_SECTION)
+    if (personaSection) {
+      // 在 persona 末尾追加语言指令
+      personaSection.text += lang === 'en' ? LANGUAGE_SUFFIX_EN : LANGUAGE_SUFFIX_ZH
+    }
+
+    // 向 tool schemas 添加语言前缀
+    for (const tool of assembly.tools) {
+      if (lang === 'zh' && !String(tool.description).startsWith('[中文思考]')) {
+        tool.description = `[中文思考] ${tool.description}`
+      } else if (lang === 'en' && !String(tool.description).startsWith('[English Thinking]')) {
+        tool.description = `[English Thinking] ${tool.description}`
+      }
+    }
+
+    return next()
+  })
+
+  // Register tool to query the current language
+  ctx.tools.register(defineTool({
+    name: 'get_conversation_language',
+    description: '获取当前对话语言设置',
+    parameters: {},
+    output: {
+      schema: {
+        type: 'object',
+        properties: {
+          language: { type: 'string', enum: ['zh', 'en'] },
+          label: { type: 'string' },
+        },
+        additionalProperties: false,
+      },
+      render: (_args, value) => [{
+        type: 'text',
+        text: `当前对话语言：${value.label} (${value.language})`,
+      }],
+    },
+    execute: async () => {
+      const lang = getLanguage()
+      return {
+        language: lang,
+        label: lang === 'zh' ? '中文' : 'English',
+      }
+    },
+  }))
+}

package/src/locales/index.ts

@@ -0,0 +1,30 @@
+/** Localization dictionaries (detail page only) */
+export const zh = {
+  "title": "对话语言",
+  "description": "选择 AI 思考与回复使用的语言，保存后下一轮模型步骤即时生效。",
+  "page.label": "对话语言",
+  "page.hint": "选择 AI 思考与回复使用的语言，保存后下一轮模型步骤即时生效。",
+  "form.unavailable": "该插件当前未加载，暂时无法配置。",
+  "form.readOnly": "本部署的设置为只读。",
+  "form.saveFailed": "保存未被接受，已保留供你修改。",
+  "form.save": "保存",
+  "form.saving": "保存中…",
+  "form.overridden": "已覆盖",
+  "form.reset": "恢复默认",
+  "form.invalid": "无效值",
+} as const
+
+export const en = {
+  "title": "Conversation Language",
+  "description": "Choose the language the AI thinks and replies in. Takes effect on the next model step after saving.",
+  "page.label": "Conversation language",
+  "page.hint": "Choose the language the AI thinks and replies in. Takes effect on the next model step after saving.",
+  "form.unavailable": "This plugin is not loaded, so it cannot be configured right now.",
+  "form.readOnly": "This deployment stores settings read-only.",
+  "form.saveFailed": "The deployment did not accept these values; they were left for you to correct.",
+  "form.save": "Save",
+  "form.saving": "Saving…",
+  "form.overridden": "Overridden",
+  "form.reset": "Reset to default",
+  "form.invalid": "Invalid value",
+} as const

package/src/shared.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared constants usable by both the Host bundle and the Client bundle.
+ * The client reads the settings namespace through this barrel so it never
+ * value-imports a Host-only package such as `@deepseek-ai/dsh-system-prompt`.
+ */
+
+/** The settings namespace is the profile entry id of this plugin row. */
+export const CONVERSATION_LANGUAGE_NAMESPACE = 'tool-conversation-language'
+
+/** 对话语言: 'zh' (中文) 或 'en' (英文), 默认 'zh' */
+export type ConversationLanguage = 'zh' | 'en'
+
+/** npm 包名：`plugins.bundle.config` slot 的 key。 */
+export const PLUGIN_PACKAGE_NAME = '@dingpenghui/dsh-conversation-language'
+
+/** `plugins.row.config` slot 的 key：`<package>#<row id>`。 */
+export const PLUGIN_ROW_CONFIG_KEY = `${PLUGIN_PACKAGE_NAME}#${CONVERSATION_LANGUAGE_NAMESPACE}`

package/src/slot-contract.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Declaration-merge the `settings.conversation-language` locale namespace into
+ * the slots `LocaleNamespaceMap`, so `locale: DICT_NS` is accepted and the
+ * framework-injected `t` seat carries the typed dictionary-key domain.
+ *
+ * The value is the union of this namespace's dictionary keys (0.2.0-rc.1
+ * shape — not an object, a string-literal union). It must exactly match the
+ * keys present in `zh`/`en` in `src/locales/index.ts`; `LocaleDictOf` checks
+ * a typed registration's dictionary against it.
+ * `export {}` makes this a module file so the `declare module` block is a
+ * module augmentation (merges with the resolved slots module) rather than an
+ * ambient module declaration.
+ */
+export {}
+
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface LocaleNamespaceMap {
+    'settings.conversation-language':
+      | 'title'
+      | 'description'
+      | 'page.label'
+      | 'page.hint'
+      | 'form.unavailable'
+      | 'form.readOnly'
+      | 'form.saveFailed'
+      | 'form.save'
+      | 'form.saving'
+      | 'form.overridden'
+      | 'form.reset'
+      | 'form.invalid'
+  }
+}

package/src/types.ts

@@ -0,0 +1,13 @@
+/**
+ * Language settings type definition
+ */
+export interface ConversationLanguageSettings {
+  /** 对话语言: 'zh' (中文) 或 'en' (英文), 默认 'zh' */
+  conversationLanguage?: 'zh' | 'en'
+}
+
+/** The settings namespace is the profile entry id of the plugin row. */
+export const LANGUAGE_SETTINGS_NAMESPACE = 'tool-conversation-language' as const
+
+/** Default language */
+export const DEFAULT_LANGUAGE: 'zh' | 'en' = 'zh'

package/src/vite-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="vite/client" />
+
+declare module '*.module.css' {
+  const classes: Readonly<Record<string, string>>
+  export default classes
+}