@deepseek-ai/dsh-client-ui-settings-models 0.1.7-rc.2 → 0.2.0-rc.1

package/README.i18n.yaml

@@ -6,11 +6,11 @@
   en: d1bc4d9ef67bfb19
   zh: d095e4dc76f1c5e0
 /deepseek-ai-dsh-client-ui-settings-models:
-  en: 65e1e8a17a23e576
-  zh: 01de4e98a002d376
+  en: 0db6fa836e1ff511
+  zh: 0e2968763e1fb7a5
 /deepseek-ai-dsh-client-ui-settings-models/summary:
-  en: 53301a5d29936f69
-  zh: 9ac408a33571dbdd
+  en: 51252c1e9fa6da0a
+  zh: 227b54d7898417fa
 /deepseek-ai-dsh-client-ui-settings-models/table-of-contents:
   en: d152484eb41ac6b4
   zh: 09388d293f9be9cb
@@ -42,8 +42,8 @@
   en: 670b8c066aed9b7a
   zh: 2bedba9a2e0e3fee
 /deepseek-ai-dsh-client-ui-settings-models/understand-the-implementation/onboarding-coordinator:
-  en: 5b18ec5319a96cfa
-  zh: 0eaa3078e7d87cad
+  en: 46dea666dffe8813
+  zh: 6f56fdc365fa3642
 /deepseek-ai-dsh-client-ui-settings-models/further-exploration:
   en: 20abd8b98b6c20e2
   zh: 6dfda7955ce5f33f

package/README.md

@@ -7,9 +7,11 @@ kind: "package-reference"
 
 English | [中文](README.zh.md)
 
+Desktop product events use the optional [product analytics service](../product-analytics/README.md); ordinary Web interactions are excluded.
+
 ## Summary
 
-`dsh-client-ui-settings-models` is the Models settings page of the dsh web client: users configure API keys (stored write-only under the profile's credential reference), edit each provider's model list, and hand-declare custom pi-ai routes, with provider rows and one editor card at a time. The page joins the provider directory, the settings document, and the credential descriptions into one shared snapshot, so a row's state stays consistent across all three. It also walks first-run users through two ordered dialogs — a versioned internal-testing notice and the conditional official-DeepSeek credential step.
+`dsh-client-ui-settings-models` is the Models settings page of the dsh web client: users configure API keys (stored write-only under the profile's credential reference), edit each provider's model list, and hand-declare custom pi-ai routes, with provider rows and one editor card at a time. The page joins the provider directory, the settings document, and the credential descriptions into one shared snapshot, so a row's state stays consistent across all three. It also walks first-run users through two ordered dialogs — a versioned preview notice and the conditional official-DeepSeek credential step.
 
 ## Table of Contents
 
@@ -83,7 +85,7 @@ Each settings write carries the card's current `revision`, so a concurrent write
 
 ### Onboarding coordinator
 
-The notice step owns its exact copy in `src/client/locales.ts` and its acknowledgement version in `src/onboarding-copy.ts`; on loopback it compares and writes `ui-settings-general.welcomeNoticeVersion` through the shared configuration form, and only an explicit Continue records the current version. A non-loopback browser cannot use that Host-only namespace, so acknowledgement is process-local and the notice returns after reload. The DeepSeek step targets `deepseek-official` in `llm-deepseek` and renders the existing `ProviderEditor` in credential-only mode inside the shared onboarding modal; `credentials.set` stays the only secret write, and no provider settings are changed.
+The notice step owns its exact copy in `src/client/locales.ts` and its acknowledgement version in `src/onboarding-copy.ts`; on loopback it compares and writes `ui-settings-general.welcomeNoticeVersion` through the shared configuration form, and only an explicit Continue records the current version. Users who acknowledged an earlier version see the current notice again. A non-loopback browser cannot use that Host-only namespace, so acknowledgement is process-local and the notice returns after reload. The DeepSeek step targets `deepseek-official` in `llm-deepseek` and renders the existing `ProviderEditor` in credential-only mode inside the shared onboarding modal; `credentials.set` stays the only secret write, and no provider settings are changed.
 
 </details>
 

package/README.zh.md

@@ -7,9 +7,11 @@ kind: "package-reference"
 
 [English](README.md) | 中文
 
+桌面端产品事件使用可选的[产品埋点服务](../product-analytics/README.zh.md)，不包含普通 Web 交互。
+
 ## 概述
 
-`dsh-client-ui-settings-models` 是 dsh Web 客户端的 Models 设置页面：用户可以配置 API 密钥（以只写方式存入 profile 的凭据引用之下）、编辑每个提供商的模型列表，并手工声明自定义 pi-ai 路由；页面以提供商行展示，一次只展开一张编辑卡片。该页面把提供商目录、设置文档与凭据描述合并为一个共享快照，因此行的状态在三个方面始终一致。它还会带首次运行的用户走两个有序弹窗——版本化内测声明，以及按条件显示的官方 DeepSeek 凭据步骤。
+`dsh-client-ui-settings-models` 是 dsh Web 客户端的 Models 设置页面：用户可以配置 API 密钥（以只写方式存入 profile 的凭据引用之下）、编辑每个提供商的模型列表，并手工声明自定义 pi-ai 路由；页面以提供商行展示，一次只展开一张编辑卡片。该页面把提供商目录、设置文档与凭据描述合并为一个共享快照，因此行的状态在三个方面始终一致。它还会带首次运行的用户走两个有序弹窗——版本化预览版说明，以及按条件显示的官方 DeepSeek 凭据步骤。
 
 ## 目录
 
@@ -83,7 +85,7 @@ Models 页面包含 **DeepSeek 账号**（`deepseek-account`，英文为 **DeepS
 
 ### 引导协调器
 
-声明步骤在 `src/client/locales.ts` 中持有精确文案，并在 `src/onboarding-copy.ts` 中持有确认版本；回环时它通过既有 settings API 比较并写入 `ui-settings-general.welcomeNoticeVersion`，且只有显式点击「继续」才会记录当前版本。非回环浏览器无法使用这个仅限宿主的 namespace，因此确认只保留在进程内，刷新后声明会再次出现。DeepSeek 步骤面向 `llm-deepseek` 中的 `deepseek-official`，在共享引导模态框内以仅凭据模式渲染既有 `ProviderEditor`；`credentials.set` 仍是唯一的机密写入，且不改变任何提供商设置。
+预览版说明在 `src/client/locales.ts` 中持有精确文案，并在 `src/onboarding-copy.ts` 中持有确认版本；回环时它通过既有 settings API 比较并写入 `ui-settings-general.welcomeNoticeVersion`，且只有显式点击「继续」才会记录当前版本。已确认旧版的用户会再次看到当前说明。非回环浏览器无法使用这个仅限宿主的 namespace，因此确认只保留在进程内，刷新后说明会再次出现。DeepSeek 步骤面向 `llm-deepseek` 中的 `deepseek-official`，在共享引导模态框内以仅凭据模式渲染既有 `ProviderEditor`；`credentials.set` 仍是唯一的机密写入，且不改变任何提供商设置。
 
 </details>
 

package/lib/client.js

@@ -1833,6 +1833,7 @@ window.__ModuleLoader__.load({
 							props.onClose(false);
 						},
 						onSubmit: () => {
+							props.onSubmitCredential?.();
 							apply();
 						}
 					})
@@ -2472,13 +2473,6 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region lib/types/client/DeepSeekOnboardingDialog.js
-		/**
-		* Official-DeepSeek first-run step. Readiness comes from the same
-		* provider/settings/credential join as the Models page: any provider the user
-		* can already talk to ends the step, and only a user with none is offered the
-		* official DeepSeek route. The step reuses that page's credential editor in
-		* the onboarding plugin's shared modal, so the key is entered once.
-		*/
 		/* v8 ignore next 3 -- closed-union defaults only defend future source widening */
 		function assertNever$1(_value) {
 			throw new Error("unexpected DeepSeek onboarding state");
@@ -2551,6 +2545,9 @@ window.__ModuleLoader__.load({
 						readOnly: false,
 						hideTitle: true,
 						credentialOnly: true,
+						onSubmitCredential: () => {
+							props.track?.("api_key_save_click", {});
+						},
 						credentialRequired: true,
 						autoFocusCredential: true,
 						cancelLabelKey: "onboardingLater",
@@ -2586,7 +2583,7 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region lib/types/client/WelcomeNotice.js
-		/** Product-wide, versioned internal-testing notice. */
+		/** Product-wide, versioned preview notice. */
 		/**
 		* Render the current notice until its exact copy version is acknowledged.
 		* @param props - settings-shell owner state and welcome dependencies.
@@ -2650,7 +2647,7 @@ window.__ModuleLoader__.load({
 		* Bump only when the notice changes materially and every user should see it
 		* again. The acknowledgement is compared for exact equality.
 		*/
-		const WELCOME_NOTICE_VERSION = "2026-08-13.1";
+		const WELCOME_NOTICE_VERSION = "2026-09-28.1";
 		//#endregion
 		//#region lib/types/client/welcome-store.js
 		/**
@@ -2948,8 +2945,8 @@ window.__ModuleLoader__.load({
 			settingsPathUnresolvable: "unresolvable settings path",
 			create: "Create provider",
 			creating: "Creating…",
-			welcomeTitle: "Internal Testing Notice",
-			welcomeBody: "DeepSeek Harness 0.1 remains in testing for Harness developers. Many areas need further improvement, and we welcome feedback from the developer community. DeepSeek Harness's core plugins and foundational APIs will continue to evolve rapidly over the coming months.\n\nWe look forward to exploring the limits of intelligence with developers around the world, building on open-source, open, reusable, and composable infrastructure. We welcome Harness developers everywhere to join the DSH plugin ecosystem.",
+			welcomeTitle: "Preview Notice",
+			welcomeBody: "DeepSeek Harness 0.2 is still in preview, and many areas need continued improvement and refinement. We welcome feedback and suggestions from all developers and users. The new desktop app now targets a broad range of users, while developer-related advanced features can be enabled in the settings. DeepSeek Harness’s product features and plugin APIs are expected to continue rapid iteration and evolution, and will gradually stabilize over time.\n\nWe look forward to exploring the limits of intelligence together with users and developers around the world, building on open-source, reusable, and composable infrastructure. We welcome everyone to bring their ideas to life with DeepSeek Harness and participate in the community to enrich the plugin ecosystem.",
 			welcomeContinue: "Continue",
 			welcomeError: "The acknowledgement could not be saved. Please try again.",
 			onboardingTitle: "Add an API key to get started",
@@ -3064,8 +3061,8 @@ window.__ModuleLoader__.load({
 			settingsPathUnresolvable: "无法解析设置路径",
 			create: "创建提供商",
 			creating: "创建中…",
-			welcomeTitle: "内测声明",
-			welcomeBody: "DeepSeek Harness 目前的 0.1 版本仍处在面向 Harness 开发者进行测试的阶段，还有许多地方需要持续改进和打磨，希望听取广大开发者的反馈建议。预计 DeepSeek Harness 的核心插件以及基础 API 都会在接下来的一段时间内快速迭代、持续演化。\n\n我们期待与全球开发者一起，在开源、开放、可复用、可组合的基础设施之上，共同探索智能上限。欢迎全球 Harness 开发者加入 DSH 插件生态。",
+			welcomeTitle: "预览版说明",
+			welcomeBody: "DeepSeek Harness 目前的 0.2 版本仍处于预览阶段，还有许多地方需要持续改进和打磨，希望听取广大开发者和用户的反馈建议。现在，新的桌面端面向广泛用户，开发者相关的进阶功能可在配置中开启使用。预计 DeepSeek Harness 的产品功能以及插件 API 都会继续快速迭代、持续演化，并逐渐趋于稳定。\n\n我们期待与全球用户和开发者一起，在开源、可复用、可组合的基础设施之上，共同探索智能上限。欢迎大家用 DeepSeek Harness 将想法变成现实，与社区一起丰富插件生态。",
 			welcomeContinue: "继续",
 			welcomeError: "暂时无法保存确认状态，请重试。",
 			onboardingTitle: "添加一个 API Key 开始使用",
@@ -4028,6 +4025,7 @@ window.__ModuleLoader__.load({
 			});
 			const deepSeekOnboardingInjected = () => ({
 				automatic: credentialOnboarding,
+				track: (name, attributes) => ctx.get("productAnalytics")?.track(name, attributes),
 				controller,
 				hooks: { models: controller.store },
 				operations,

package/lib/types/client/DeepSeekOnboardingDialog.d.ts

@@ -5,6 +5,7 @@
  * official DeepSeek route. The step reuses that page's credential editor in
  * the onboarding plugin's shared modal, so the key is entered once.
  */
+import type { TrackProductEvent } from '@deepseek-ai/dsh-client-product-analytics/client';
 import type { ReactNode } from 'react';
 import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { InjectFace, PropsRuntime, PropsRenderSlots } from '@deepseek-ai/dsh-client-ui-slots';
@@ -14,6 +15,8 @@ import type { SettingsSchemaOperations } from './schema-operations.ts';
 import type { en } from './locales.ts';
 /** Registration-side dependencies of {@link DeepSeekOnboardingDialog}. */
 export interface DeepSeekOnboardingInjected {
+    /** Desktop-only event collection. */
+    track?: TrackProductEvent;
     /** Whether first-run setup should show automatically. Explicit requests remain available. */
     automatic: boolean;
     hooks: {

package/lib/types/client/ProviderEditor.d.ts

@@ -67,6 +67,8 @@ export interface ProviderEditorProps {
     submitBusyLabelKey?: keyof typeof en;
     /** Close the editor; `changed` reports whether an Apply committed. */
     onClose: (changed: boolean) => void;
+    /** Called on a credential form submission before the save starts. */
+    onSubmitCredential?: () => void;
     /**
      * Called once per change with whether the apply or the model list's
      * endpoint interrogation is in flight, so the owner can hold its surface

package/lib/types/client/WelcomeNotice.d.ts

@@ -1,4 +1,4 @@
-/** Product-wide, versioned internal-testing notice. */
+/** Product-wide, versioned preview notice. */
 import type { ReactNode } from 'react';
 import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';

package/lib/types/client/index.d.ts

@@ -1,11 +1,3 @@
-/**
- * Models settings and product-onboarding plugin, browser half. It registers
- * the Models page plus the ordered internal-testing and official-DeepSeek
- * onboarding dialogs, whose UI shares this package's modal wrapper. The Host
- * settings and credential contracts stay behind their existing wire APIs.
- * Export discipline:
- * packages/client/AGENTS.md.
- */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
 import { ModelsSettingsStore } from './store.ts';
 import { type ModelsKey } from './locales.ts';

package/lib/types/onboarding-copy.d.ts

@@ -6,5 +6,5 @@ export declare const WELCOME_NOTICE_ACK_FIELD = "welcomeNoticeVersion";
  * Bump only when the notice changes materially and every user should see it
  * again. The acknowledgement is compared for exact equality.
  */
-export declare const WELCOME_NOTICE_VERSION = "2026-08-13.1";
+export declare const WELCOME_NOTICE_VERSION = "2026-09-28.1";
 //# sourceMappingURL=onboarding-copy.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-settings-models",
   "description": "Models settings and shared product-onboarding dialogs over existing settings and credential joins",
-  "version": "0.1.7-rc.2",
+  "version": "0.2.0-rc.1",
   "publishConfig": {
     "access": "public"
   },
@@ -42,18 +42,19 @@
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-host-webserver": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-store": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-util-values": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-remote-mock": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-remote-mock": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-product-analytics": "0.2.0-rc.1"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "~3.18.4"