@huaweidevtools/aishell-dsh-llm 0.0.3 → 0.0.5

package/README.md

@@ -6,7 +6,7 @@ Besides the live route, the plugin declares `aishell` in the configurable-provid
 
 ## The Models-page row
 
-The row itself is read-only: the profile has no fields the host editor knows how to write, and credentials are managed at Settings → AI Shell (by `aishell-credentials`). The browser half therefore does not extend the row with a card — it shadows the row's header at runtime (`src/client/provider-row-shadow.ts`, the same approach `aishell-brand` uses for its digest-protected host residues): a status dot after the row's name (green when AK/SK are stored, warn when they are not, with the readiness copy as its hover title) and the header's Edit button hidden, because there is nothing to edit. A MutationObserver keeps the shadow applied across the page's re-renders; disabling the plugin restores the official row exactly.
+The row itself is read-only: the profile has no fields the host editor knows how to write, and credentials are entered through the form the `aishell-credentials` chips open (the account chip beside the chat input, or the chip on a New Session page). The browser half therefore does not extend the row with a card — it shadows the row's header at runtime (`src/client/provider-row-shadow.ts`, the same approach `aishell-brand` uses for its digest-protected host residues): a status dot after the row's name (green when AK/SK are stored, warn when they are not, with the readiness copy as its hover title) and the header's Edit button hidden, because there is nothing to edit. A MutationObserver keeps the shadow applied across the page's re-renders; the shadow is re-installed on a locale switch so the hover copy follows the active language; disabling the plugin restores the official row exactly.
 
 ## How it works
 
@@ -80,7 +80,7 @@ The three image fields share `dsh-llm-pi-ai`'s defaults: the gateway publishes n
 
 ## Storing credentials
 
-**Web UI (recommended):** Install `aishell-credentials` (or the `aishell-base` bundle) — the Settings page gets an "AI Shell" section with AK/SK/SecurityToken input fields. Values are transferred to the credential store.
+**Web UI (recommended):** Install `aishell-credentials` (or the `aishell-base` bundle) — clicking the credentials button beside the chat input (or the one on a New Session page) opens a form with AK/SK/SecurityToken fields. Values are verified against Huawei Cloud IAM and transferred to the credential store; the button flips to the account name when they are stored.
 
 **CLI fallback:**
 

package/lib/client.js

@@ -46,13 +46,6 @@ const ROW_DOT_CSS = [
 	"  display: none !important;",
 	"}"
 ].join("\n");
-/** Title copy for the dot, by readiness. The warn state keeps the
-* actionable half — where to save AK/SK — because that is the one thing a
-* fresh user cannot guess; the ready state needs nothing beyond itself. */
-const DOT_TITLE = {
-	ok: "已就绪",
-	warn: "未就绪 — 凭据未配置（在 设置 → AI Shell 中保存 AK/SK）"
-};
 /** Every Edit button an aishell row renders (there is ordinarily one; a
 * re-render that leaves a second copy gets both, so none stays visible). */
 function findEditButtons(row) {
@@ -93,15 +86,15 @@ function isProviderRow(node) {
 * `target` is the owning document, passed in because the stub DOM the specs
 * run on keeps no `ownerDocument` link.
 */
-function shadowRow(row, ready, target) {
+function shadowRow(row, ready, titles, target) {
 	const identity = row.querySelector("[class*=\"rowIdentity\"]");
 	if (identity === null) return;
 	const state = ready ? "ok" : "warn";
 	const existing = identity.querySelector(`[${ROW_DOT_MARKER}]`);
 	const dot = existing ?? target.createElement("span");
 	dot.setAttribute(ROW_DOT_MARKER, state);
-	dot.setAttribute("title", DOT_TITLE[state]);
-	dot.setAttribute("aria-label", DOT_TITLE[state]);
+	dot.setAttribute("title", titles[state]);
+	dot.setAttribute("aria-label", titles[state]);
 	if (existing === null) {
 		dot.setAttribute("role", "img");
 		identity.appendChild(dot);
@@ -122,21 +115,23 @@ function unshadowRow(row) {
 *
 * `ready` is the credential fact as the browser half derives it from the
 * settings namespace `aishell-credentials` owns (see `client/index.ts`);
-* the install does not read the store itself, so a later credential save is
-* a reinstall with the new fact, not a re-derivation buried in here. Sweeps
-* the page once, then observes the body so re-rendered rows are covered too.
-* Returns the disposer that stops the observer and restores every row.
+* `titles` is the dot's hover copy in the active locale (the installer
+* translates; this module holds only the DOM work). Neither is read from any
+* store here, so a later credential save or locale switch is a reinstall with
+* the new values, not a re-derivation buried in here. Sweeps the page once,
+* then observes the body so re-rendered rows are covered too. Returns the
+* disposer that stops the observer and restores every row.
 */
-function installProviderRowShadow(target, ready) {
+function installProviderRowShadow(target, ready, titles) {
 	if (typeof target.querySelector !== "function" || typeof MutationObserver !== "function") return () => {};
 	/** Run the shadow over every provider row at or below `root`. */
 	const sweep = (root) => {
-		if (isElement(root) && isProviderRow(root)) shadowRow(root, ready, target);
-		for (const row of root.querySelectorAll("[class*=\"rowCard\"], [class*=\"setupCard\"]")) if (isProviderRow(row)) shadowRow(row, ready, target);
+		if (isElement(root) && isProviderRow(root)) shadowRow(root, ready, titles, target);
+		for (const row of root.querySelectorAll("[class*=\"rowCard\"], [class*=\"setupCard\"]")) if (isProviderRow(row)) shadowRow(row, ready, titles, target);
 	};
 	const sweepIfRow = (node) => {
 		if (isProviderRow(node)) {
-			shadowRow(node, ready, target);
+			shadowRow(node, ready, titles, target);
 			return;
 		}
 		for (let parent = node.parentElement; parent !== null; parent = parent.parentElement) sweep(parent);
@@ -160,20 +155,54 @@ function installProviderRowShadow(target, ready) {
 	};
 }
 
+//#endregion
+//#region src/client/locales.ts
+/**
+* aishell-llm locale dictionaries — the Models-page provider row's copy.
+*
+* The row shadow is a DOM patch, not a React render, so its strings do not
+* ride the framework's locale seat: the install reads them through `t` at
+* install time and repaints on a locale switch (the client half re-installs
+* on `locale/change`). zh is the key-set source of truth; en mirrors it.
+*
+* @module @huaweidevtools/aishell-dsh-llm/client/locales
+*/
+/** Dictionary namespace owned by this plugin. */
+const NS = "aishell-llm";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+const zh = {
+	"provider.ready": "已就绪",
+	"provider.warn": "未就绪 — 凭据未配置（点击对话输入框上方的凭据按钮填写 AK/SK）"
+};
+/** English dictionary. */
+const en = {
+	"provider.ready": "Ready",
+	"provider.warn": "Not ready — credentials missing (click the credentials button above the chat input to enter AK/SK)"
+};
+
 //#endregion
 //#region src/client/index.ts
 /** The settings namespace aishell-credentials owns (the shadow reads its status). */
 const AISHELL_CREDENTIALS_NS = "aishell-client-credentials";
 /** Required services. */
-const inject = ["configForms"];
+const inject = ["configForms", "locale"];
 function apply(ctx) {
 	if (typeof document === "undefined") return;
+	ctx.effect(() => ctx.locale.register(NS, {
+		zh,
+		en
+	}), "aishell-llm: dictionaries");
+	const t = ctx.locale.bind(NS);
 	const form = ctx.configForms.get(AISHELL_CREDENTIALS_NS);
 	let readiness = form.getSnapshot().value?.credentialsStored === true;
 	let disposeShadow;
+	const titles = () => ({
+		ok: t("provider.ready"),
+		warn: t("provider.warn")
+	});
 	const sync = () => {
 		disposeShadow?.();
-		disposeShadow = installProviderRowShadow(document, readiness);
+		disposeShadow = installProviderRowShadow(document, readiness, titles());
 	};
 	const derive = () => {
 		const next = form.getSnapshot().value?.credentialsStored === true;
@@ -190,6 +219,9 @@ function apply(ctx) {
 		};
 	}), "aishell-llm: models page provider row shadow");
 	ctx.effect(() => form.subscribe(derive), "aishell-llm: credential presence for the models row");
+	ctx.effect(() => ctx.on("locale/change", () => {
+		sync();
+	}), "aishell-llm: shadow locale repaint");
 }
 
 //#endregion

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

@@ -2,11 +2,12 @@
  * aishell LLM browser half — shadows the Models page's provider row.
  *
  * The page's row for the aishell family is read-only: its profile has no
- * fields the host editor knows how to write, and its credentials live in
- * `aishell-credentials`' own settings section. What the row should tell the
- * user is the one fact the old card extension distilled — ready or not — so
- * the browser half paints it as a status dot beside the row's name and hides
- * the header's Edit button (see `client/provider-row-shadow.ts`).
+ * fields the host editor knows how to write, and its credentials are entered
+ * through the credential form the `aishell-credentials` chips open. What the
+ * row should tell the user is the one fact the old card extension distilled —
+ * ready or not — so the browser half paints it as a status dot beside the
+ * row's name and hides the header's Edit button (see
+ * `client/provider-row-shadow.ts`).
  *
  * The readiness fact is read from the `aishell-client-credentials` settings
  * namespace (`aishell-credentials` owns it; the shadow never names accounts
@@ -15,10 +16,15 @@
  * installed standalone) shows no trace of the dot either — the fact is
  * unknown, not false.
  *
+ * The dot's hover copy rides this package's own locale namespace. The shadow
+ * is a DOM patch that does not re-render on a locale switch, so the install
+ * is redone on `locale/change` — the repaint is attribute writes over rows
+ * the sweep re-finds, not a page mutation.
+ *
  * @module @huaweidevtools/aishell-dsh-llm/client
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
-export type { ProviderRowShadowDisposer, } from './provider-row-shadow.ts';
+export type { ProviderRowShadowDisposer, ProviderRowTitles, } from './provider-row-shadow.ts';
 export { installProviderRowShadow, ROW_DOT_MARKER, ROW_EDIT_HIDDEN, } from './provider-row-shadow.ts';
 /** Required services. */
 export declare const inject: string[];

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

@@ -0,0 +1,30 @@
+/**
+ * aishell-llm locale dictionaries — the Models-page provider row's copy.
+ *
+ * The row shadow is a DOM patch, not a React render, so its strings do not
+ * ride the framework's locale seat: the install reads them through `t` at
+ * install time and repaints on a locale switch (the client half re-installs
+ * on `locale/change`). zh is the key-set source of truth; en mirrors it.
+ *
+ * @module @huaweidevtools/aishell-dsh-llm/client/locales
+ */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS: "aishell-llm";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    readonly 'provider.ready': "已就绪";
+    readonly 'provider.warn': "未就绪 — 凭据未配置（点击对话输入框上方的凭据按钮填写 AK/SK）";
+};
+/** English dictionary. */
+export declare const en: {
+    readonly 'provider.ready': "Ready";
+    readonly 'provider.warn': "Not ready — credentials missing (click the credentials button above the chat input to enter AK/SK)";
+};
+/** All keys (derived from the zh dictionary, the source of truth). */
+export type AishellLlmLocaleKey = keyof typeof zh;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        'aishell-llm': AishellLlmLocaleKey;
+    }
+}
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/provider-row-shadow.d.ts

@@ -24,8 +24,8 @@
  *
  *   1. a status dot after the name — the host credential dot's own 8px
  *      geometry and success/warn colors, green when AK/SK are stored, warn
- *      when they are not, with the readiness copy as its title (the row
- *      keeps saying what the old card said, just in one word of hover);
+ *      when they are not, with the readiness copy (installer-supplied, so it
+ *      follows the active locale) as its title;
  *   2. the row's Edit button is hidden — the row is read-only, and the only
  *      control the header keeps is whatever the host itself decides (Remove,
  *      for user-added rows; this family's row is not removable). The hide is
@@ -53,15 +53,28 @@ export declare const ROW_DOT_MARKER = "data-aishell-provider-dot";
 export declare const ROW_EDIT_HIDDEN = "data-aishell-edit-hidden";
 /** The dot's own CSS: the host credential dot's geometry and palette. */
 export declare const ROW_DOT_CSS: string;
+/** Title copy for the dot, by readiness — supplied by the installer so it
+ * follows the active locale (this module is a DOM patch with no locale seat
+ * of its own). The warn state keeps the actionable half — where to enter
+ * AK/SK — because that is the one thing a fresh user cannot guess; the ready
+ * state needs nothing beyond itself. */
+export interface ProviderRowTitles {
+    /** Hover copy when AK/SK are stored. */
+    readonly ok: string;
+    /** Hover copy when they are not. */
+    readonly warn: string;
+}
 /**
  * Install the provider-row shadow on a document.
  *
  * `ready` is the credential fact as the browser half derives it from the
  * settings namespace `aishell-credentials` owns (see `client/index.ts`);
- * the install does not read the store itself, so a later credential save is
- * a reinstall with the new fact, not a re-derivation buried in here. Sweeps
- * the page once, then observes the body so re-rendered rows are covered too.
- * Returns the disposer that stops the observer and restores every row.
+ * `titles` is the dot's hover copy in the active locale (the installer
+ * translates; this module holds only the DOM work). Neither is read from any
+ * store here, so a later credential save or locale switch is a reinstall with
+ * the new values, not a re-derivation buried in here. Sweeps the page once,
+ * then observes the body so re-rendered rows are covered too. Returns the
+ * disposer that stops the observer and restores every row.
  */
-export declare function installProviderRowShadow(target: Document, ready: boolean): ProviderRowShadowDisposer;
+export declare function installProviderRowShadow(target: Document, ready: boolean, titles: ProviderRowTitles): ProviderRowShadowDisposer;
 //# sourceMappingURL=provider-row-shadow.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@huaweidevtools/aishell-dsh-llm",
   "description": "aishell LLM gateway adapter for DSH — OpenAI-compatible, Huawei Cloud AK/SK auth via credential store",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "publishConfig": {
     "access": "public"
   },
@@ -33,29 +33,32 @@
   "license": "Apache-2.0",
   "dependencies": {
     "eventsource-parser": "^3.0.0",
-    "@huaweidevtools/aishell-dsh-credentials-store": "0.0.3"
+    "@huaweidevtools/aishell-dsh-credentials-store": "0.0.5"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
-    "@deepseek-ai/dsh-attachment": ">=0.2.0-0 <0.3.0-0",
-    "@deepseek-ai/dsh-brand": ">=0.2.0-0 <0.3.0-0",
-    "@deepseek-ai/dsh-fs": ">=0.2.0-0 <0.3.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.2.0-0 <0.3.0-0"
+    "@deepseek-ai/dsh-attachment": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1",
+    "@deepseek-ai/dsh-brand": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1",
+    "@deepseek-ai/dsh-fs": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.5",
     "@deepseek-ai/dsh-attachment": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-brand": ">=0.2.0-0 <0.3.0-0",
+    "@deepseek-ai/dsh-brand": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1",
     "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1",
     "@deepseek-ai/dsh-fs": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-llm": ">=0.2.0-0 <0.3.0-0",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1",
     "@deepseek-ai/schemastery": "3.18.4"
   },
   "dsh": {
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-ui-settings"
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale"
       ],
       "platform": "web"
     },