@huaweidevtools/aishell-dsh-brand 0.0.1 → 0.0.3

package/README.md

@@ -1,6 +1,6 @@
 # @huaweidevtools/aishell-dsh-brand
 
-AI Shell brand reskin for DSH web. Replaces the default DeepSeek fish mark in the sidebar and blank-session hero with the AI Shell icon and wordmark, and shadows the browser/window product title at runtime.
+AI Shell brand reskin for DSH web. Replaces the default DeepSeek fish mark in the sidebar and blank-session hero with the AI Shell icon and wordmark, and shadows the browser/window product title, tab favicon, and running-status whale + copy at runtime.
 
 ## How it works
 
@@ -20,6 +20,19 @@ The product title "DeepSeek Harness" is baked into the dsh tree at build time (`
 
 Shadowing is a default, not a force: the effect's disposer removes the own property and restores the official title, so disabling the plugin returns the shell to its official behavior.
 
+## Favicon and manifest shadow
+
+The browser tab icon comes from the dist's `favicon.svg` / `favicon-dark.svg` (a DeepSeek whale, one fixed fill per theme, selected by `media="(prefers-color-scheme: …)"` links) — digest-protected like the title. `src/client/favicon-shadow.ts` repoints every `link[rel~="icon"]` at the AI Shell mark data URI (`src/client/aishell-mark.ts`, pinned byte-for-byte against `assets/aishell.svg`), dropping the media qualifier because the mark's gradient reads on both themes. A MutationObserver re-shadows links re-inserted into the head. The web manifest's display names ("DeepSeek Harness" / "DSH") are rebranded to "AI Shell" through a Blob URL when the manifest is reachable; a manifest that cannot be fetched or parsed is left exactly as found, so the install prompt never breaks over a display name. The disposer restores every touched link and revokes the Blob URL.
+
+## Running-status shadows
+
+The thinking line under an active turn ("深度求索中，用时 X ···" / "Deep diving for X ···") carries two DeepSeek residues, both in ui-chat with no slot to occupy, so both are shadowed at runtime:
+
+- **The whale tail icon** (`src/client/running-mark-shadow.ts`) — the same CSS-patch approach the hero headline uses, anchored on the row's stable literal attribute `[data-chat-running]`. The patch hides the animated APNG mask and the static SVG fallback and repaints the 14px `runningIcon` box with the AI Shell mark plus a gentle bob; under `prefers-reduced-motion` the mark is static, matching the official whale's own degradation.
+- **The copy** (`src/client/running-text-shadow.ts`) — `locale.register` throws on the claimed `chat` namespace, so the rendered text is rewritten instead. One substring replacement per language covers both keys ("深度求索中" → "思考中", "Deep diving" → "Thinking"; the duration forms share the prefix). The line re-renders every second, so a MutationObserver (characterData + childList + the `data-shimmer-text` attribute — TextShimmer paints its highlight through `content: attr()`, so a stale attribute would flash the official copy on every sweep) keeps it covered for as long as the row exists. The row's aria status span sits in the same subtree and is covered by the same sweep.
+
+Both disposers restore the official whale and copy exactly.
+
 ## Install
 
 ```sh
@@ -32,9 +45,10 @@ dsh plugin --profile <name> add @huaweidevtools/aishell-dsh-base
 
 ## What it does NOT touch
 
-- Navigation, settings, panels, conversation — only the three brand slots and the product title.
+- Navigation, settings, panels, conversation — only the three brand slots, the product title, the tab icon/manifest names, and the running-status icon/copy.
 - DSH default plugins — no rows disabled.
 - Session titles in the browser title — the part before the product name passes through unchanged.
+- Duration units and the "···" tail in the running line — the harness's own words, not product branding.
 
 ## License
 

package/lib/client.js

@@ -180,7 +180,7 @@ function AishellBrandName() {
 		"aria-label": "AI Shell",
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 			className: brand_module_css_default.version,
-			children: "0.0.1"
+			children: "0.0.3"
 		})
 	});
 }
@@ -314,6 +314,341 @@ function installTitleShadow(target) {
 	};
 }
 
+//#endregion
+//#region src/client/aishell-mark.ts
+/**
+* The AI Shell mark as an inline source, shared by the runtime brand shadows.
+*
+* The slot occupants (Brand.tsx) draw the mark through a CSS module whose
+* url() the build inlines, but the runtime shadows need the bytes as a JS
+* string: the favicon shadow writes them into a link href, and the running
+* status mark shadow writes them into injected patch CSS. This module is
+* that one source, so the asset and the shadows cannot drift apart.
+* tests/aishell-mark.spec.ts pins the constant against assets/aishell.svg.
+*
+* @module @huaweidevtools/aishell-dsh-brand/client/aishell-mark
+*/
+/** The AI Shell mark, verbatim assets/aishell.svg (the spec pins this). */
+const AISHELL_MARK_SVG = `<svg viewBox="0 0 44 44" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="44.000000" height="44.000000" fill="none">
+	<defs>
+		<linearGradient id="paint_linear_0" x1="38.5" x2="2.19999695" y1="1.90734863e-06" y2="39.5999908" gradientUnits="userSpaceOnUse">
+			<stop stop-color="rgb(53,137,255)" offset="0" stop-opacity="1" />
+			<stop stop-color="rgb(169,38,255)" offset="1" stop-opacity="1" />
+		</linearGradient>
+	</defs>
+	<rect id="icon_AIShell" width="44.000000" height="44.000000" x="0.000000" y="0.000000" fill="rgb(255,255,255)" fill-opacity="0" />
+	<path id="合并" d="M37.4576 0.299738C37.3775 0.139877 37.2861 0.0428196 37.1832 0.00856393C37.0917 -0.0142732 37.006 0.00856394 36.9259 0.0770754C36.8459 0.145587 36.7887 0.219808 36.7545 0.299738C36.4572 1.86408 35.7369 3.21718 34.5937 4.35904C33.4618 5.48948 32.0956 6.22027 30.495 6.55141C30.3921 6.57424 30.3178 6.64275 30.272 6.75694C30.2377 6.87113 30.2435 6.97389 30.2892 7.06524C30.3464 7.15659 30.415 7.20226 30.495 7.20226C31.2078 7.35296 31.8779 7.58759 32.5055 7.90618L32.5055 7.9062L32.5056 7.90623C33.257 8.28771 33.9473 8.78955 34.5765 9.41176C35.7312 10.5422 36.4572 11.8896 36.7545 13.4539C36.8116 13.591 36.8974 13.6823 37.0117 13.728C37.1146 13.7622 37.2061 13.7565 37.2861 13.7109C37.3775 13.6538 37.4347 13.5681 37.4576 13.4539C37.7891 11.8896 38.5151 10.5422 39.6355 9.41176C40.7674 8.2699 42.1279 7.5334 43.717 7.20226C43.8199 7.17943 43.9 7.12233 43.9571 7.03099C44.0143 6.92822 44.0143 6.83116 43.9571 6.73981C43.9 6.63705 43.8199 6.57424 43.717 6.55141C42.1507 6.22027 40.7959 5.48948 39.6527 4.35904C38.5208 3.21718 37.7891 1.86408 37.4576 0.299738ZM42.625 16.4999L42.625 33C42.625 33.9493 42.4572 34.829 42.1216 35.6392C41.786 36.4495 41.2826 37.1902 40.6114 37.8614C39.9402 38.5326 39.1994 39.036 38.3892 39.3716C37.579 39.7072 36.6992 39.875 35.75 39.875L10.9999 39.875L8.24995 39.875C7.30073 39.875 6.42102 39.7072 5.61081 39.3716C4.80058 39.036 4.05985 38.5326 3.38863 37.8614C2.71742 37.1902 2.21402 36.4494 1.87841 35.6392C1.5428 34.829 1.375 33.9493 1.375 33L1.375 11C1.375 10.0508 1.5428 9.17106 1.8784 8.36083L1.87841 8.36082C2.21402 7.55059 2.71743 6.80987 3.38864 6.13866C4.05985 5.46745 4.80057 4.96404 5.61079 4.62843L5.6108 4.62843C6.42103 4.29282 7.30076 4.12502 8.25 4.12502L27.4999 4.125C28.2699 4.125 28.8749 4.73 28.8749 5.5C28.8749 6.27 28.2699 6.875 27.4999 6.875L8.25 6.87502C7.68045 6.87502 7.15261 6.9757 6.66648 7.17706C6.18034 7.37843 5.73591 7.68047 5.33318 8.0832C4.93046 8.48593 4.62841 8.93036 4.42705 9.41649C4.22568 9.90263 4.125 10.4305 4.125 11L4.125 33C4.125 33.5696 4.22568 34.0974 4.42705 34.5835C4.62841 35.0697 4.93045 35.5141 5.33317 35.9168C5.73588 36.3195 6.18028 36.6216 6.66639 36.8229C7.15256 37.0243 7.68042 37.125 8.24999 37.125L10.9999 37.125L35.75 37.125C36.3195 37.125 36.8474 37.0243 37.3335 36.823C37.8197 36.6216 38.2641 36.3196 38.6668 35.9168C39.0695 35.5141 39.3716 35.0697 39.573 34.5835C39.7743 34.0974 39.875 33.5696 39.875 33L39.875 16.4999C39.875 15.7299 40.48 15.1249 41.25 15.1249C42.02 15.1249 42.625 15.7299 42.625 16.4999ZM10.0277 12.7777C10.5722 12.2333 11.4278 12.2333 11.9723 12.7777L20.2222 21.0277C20.4907 21.2962 20.6249 21.6203 20.6249 22C20.6249 22.3797 20.4907 22.7037 20.2222 22.9722L11.9722 31.2223C11.4277 31.7668 10.5721 31.7668 10.0277 31.2223C9.48318 30.6779 9.48317 29.8223 10.0276 29.2778L17.3054 22L10.0277 14.7223C9.48325 14.1778 9.48326 13.3222 10.0277 12.7777ZM20.625 28.875C20.625 28.105 21.23 27.5 22 27.5L33 27.5C33.77 27.5 34.375 28.105 34.375 28.875C34.375 29.645 33.77 30.25 33 30.25L22 30.25C21.23 30.25 20.625 29.645 20.625 28.875Z" fill="rgb(0,0,0)" fill-opacity="0" fill-rule="evenodd" />
+	<path id="合并" d="M37.4576 0.299738C37.3775 0.139877 37.2861 0.0428196 37.1832 0.00856393C37.0917 -0.0142732 37.006 0.00856394 36.9259 0.0770754C36.8459 0.145587 36.7887 0.219808 36.7545 0.299738C36.4572 1.86408 35.7369 3.21718 34.5937 4.35904C33.4618 5.48948 32.0956 6.22027 30.495 6.55141C30.3921 6.57424 30.3178 6.64275 30.272 6.75694C30.2377 6.87113 30.2435 6.97389 30.2892 7.06524C30.3464 7.15659 30.415 7.20226 30.495 7.20226C31.2078 7.35296 31.8779 7.58759 32.5055 7.90618L32.5055 7.9062L32.5056 7.90623C33.257 8.28771 33.9473 8.78955 34.5765 9.41176C35.7312 10.5422 36.4572 11.8896 36.7545 13.4539C36.8116 13.591 36.8974 13.6823 37.0117 13.728C37.1146 13.7622 37.2061 13.7565 37.2861 13.7109C37.3775 13.6538 37.4347 13.5681 37.4576 13.4539C37.7891 11.8896 38.5151 10.5422 39.6355 9.41176C40.7674 8.2699 42.1279 7.5334 43.717 7.20226C43.8199 7.17943 43.9 7.12233 43.9571 7.03099C44.0143 6.92822 44.0143 6.83116 43.9571 6.73981C43.9 6.63705 43.8199 6.57424 43.717 6.55141C42.1507 6.22027 40.7959 5.48948 39.6527 4.35904C38.5208 3.21718 37.7891 1.86408 37.4576 0.299738ZM42.625 16.4999L42.625 33C42.625 33.9493 42.4572 34.829 42.1216 35.6392C41.786 36.4495 41.2826 37.1902 40.6114 37.8614C39.9402 38.5326 39.1994 39.036 38.3892 39.3716C37.579 39.7072 36.6992 39.875 35.75 39.875L10.9999 39.875L8.24995 39.875C7.30073 39.875 6.42102 39.7072 5.61081 39.3716C4.80058 39.036 4.05985 38.5326 3.38863 37.8614C2.71742 37.1902 2.21402 36.4494 1.87841 35.6392C1.5428 34.829 1.375 33.9493 1.375 33L1.375 11C1.375 10.0508 1.5428 9.17106 1.8784 8.36083L1.87841 8.36082C2.21402 7.55059 2.71743 6.80987 3.38864 6.13866C4.05985 5.46745 4.80057 4.96404 5.61079 4.62843L5.6108 4.62843C6.42103 4.29282 7.30076 4.12502 8.25 4.12502L27.4999 4.125C28.2699 4.125 28.8749 4.73 28.8749 5.5C28.8749 6.27 28.2699 6.875 27.4999 6.875L8.25 6.87502C7.68045 6.87502 7.15261 6.9757 6.66648 7.17706C6.18034 7.37843 5.73591 7.68047 5.33318 8.0832C4.93046 8.48593 4.62841 8.93036 4.42705 9.41649C4.22568 9.90263 4.125 10.4305 4.125 11L4.125 33C4.125 33.5696 4.22568 34.0974 4.42705 34.5835C4.62841 35.0697 4.93045 35.5141 5.33317 35.9168C5.73588 36.3195 6.18028 36.6216 6.66639 36.8229C7.15256 37.0243 7.68042 37.125 8.24999 37.125L10.9999 37.125L35.75 37.125C36.3195 37.125 36.8474 37.0243 37.3335 36.823C37.8197 36.6216 38.2641 36.3196 38.6668 35.9168C39.0695 35.5141 39.3716 35.0697 39.573 34.5835C39.7743 34.0974 39.875 33.5696 39.875 33L39.875 16.4999C39.875 15.7299 40.48 15.1249 41.25 15.1249C42.02 15.1249 42.625 15.7299 42.625 16.4999ZM10.0277 12.7777C10.5722 12.2333 11.4278 12.2333 11.9723 12.7777L20.2222 21.0277C20.4907 21.2962 20.6249 21.6203 20.6249 22C20.6249 22.3797 20.4907 22.7037 20.2222 22.9722L11.9722 31.2223C11.4277 31.7668 10.5721 31.7668 10.0277 31.2223C9.48318 30.6779 9.48317 29.8223 10.0276 29.2778L17.3054 22L10.0277 14.7223C9.48325 14.1778 9.48326 13.3222 10.0277 12.7777ZM20.625 28.875C20.625 28.105 21.23 27.5 22 27.5L33 27.5C33.77 27.5 34.375 28.105 34.375 28.875C34.375 29.645 33.77 30.25 33 30.25L22 30.25C21.23 30.25 20.625 29.645 20.625 28.875Z" fill="url(#paint_linear_0)" fill-rule="evenodd" />
+</svg>`;
+/**
+* The mark as a self-contained data URI.
+*
+* URL-encoded rather than base64 (shorter, and the gradient reads on both
+* light and dark themes, which is what lets one URI serve every surface).
+*/
+const AISHELL_MARK_URI = `data:image/svg+xml,${encodeURIComponent(AISHELL_MARK_SVG)}`;
+
+//#endregion
+//#region src/client/favicon-shadow.ts
+/** The official product names the manifest shadow rewrites. */
+const OFFICIAL_MANIFEST_NAMES = {
+	name: "DeepSeek Harness",
+	short_name: "DSH"
+};
+/** The branded names that shadow them. */
+const BRANDED_MANIFEST_NAMES = {
+	name: "AI Shell",
+	short_name: "AI Shell"
+};
+/**
+* Rewrite a manifest document's display names in place.
+*
+* Only the two fields the dist actually ships are touched, and only when
+* they carry their official values — anything else in the document (icons,
+* start_url, scope, display) passes through untouched, and a manifest the
+* base customized keeps its customization.
+*/
+function rebrandManifest(manifest) {
+	const branded = { ...manifest };
+	for (const key of Object.keys(OFFICIAL_MANIFEST_NAMES)) if (branded[key] === OFFICIAL_MANIFEST_NAMES[key]) branded[key] = BRANDED_MANIFEST_NAMES[key];
+	return branded;
+}
+/** The href every icon link is shadowed with (exposed for the spec). */
+const BRANDED_ICON_HREF = AISHELL_MARK_URI;
+/**
+* The rel token list of a link node, or undefined when the node is not a
+* link (comment nodes reach the same iterator).
+*
+* Duck-typed on the attribute rather than `instanceof HTMLLinkElement` so
+* the shadow works identically in the browser and under the specs' DOM
+* stub, which provides the attribute surface without the constructor.
+*/
+function linkRels(node) {
+	if (node.nodeType !== Node.ELEMENT_NODE) return void 0;
+	const rel = node.getAttribute("rel");
+	if (rel === null) return void 0;
+	return rel.split(/\s+/);
+}
+/**
+* Install the favicon shadow on a document.
+*
+* Rewrites every current icon link's href to the AI Shell mark (dropping
+* the media attribute so the one gradient serves both themes), shadows the
+* manifest names when the manifest is reachable, and observes the head so
+* re-inserted links are covered too. Returns the disposer: every touched
+* link is restored to its original href and media, the manifest link to
+* its original href, and the Blob URL is revoked, so an unload leaves the
+* document exactly as it was found.
+*/
+function installFaviconShadow(target) {
+	if (typeof target.querySelector !== "function") return () => {};
+	const iconRestores = [];
+	let manifestLink;
+	let manifestHref;
+	let blobUrl;
+	const shadowIcon = (link) => {
+		if (iconRestores.some((restore) => restore.link === link)) return;
+		iconRestores.push({
+			link,
+			href: link.getAttribute("href") ?? "",
+			media: link.getAttribute("media") ?? ""
+		});
+		link.setAttribute("href", BRANDED_ICON_HREF);
+		link.removeAttribute("media");
+	};
+	const shadowManifest = (link) => {
+		if (manifestLink !== void 0) return;
+		const href = link.getAttribute("href");
+		if (href === null) return;
+		manifestLink = link;
+		const url = new URL(href, target.baseURI);
+		fetch(url).then((response) => response.ok ? response.text() : Promise.reject(new Error(`HTTP ${response.status}`))).then((text) => {
+			if (manifestLink !== link) return;
+			const parsed = JSON.parse(text);
+			if (typeof parsed !== "object" || parsed === null) throw new Error("manifest is not an object");
+			const branded = rebrandManifest(parsed);
+			const blob = new Blob([JSON.stringify(branded)], { type: "application/manifest+json" });
+			blobUrl = URL.createObjectURL(blob);
+			manifestHref = href;
+			link.setAttribute("href", blobUrl);
+		}).catch(() => {
+			if (manifestLink === link) manifestLink = void 0;
+		});
+	};
+	const sweep$1 = (root) => {
+		for (const link of root.querySelectorAll("link")) {
+			const rels = linkRels(link);
+			if (rels === void 0) continue;
+			if (rels.includes("icon")) shadowIcon(link);
+			else if (rels.includes("manifest")) shadowManifest(link);
+		}
+	};
+	sweep$1(target.head);
+	const observer = new MutationObserver((mutations) => {
+		for (const mutation of mutations) for (const node of mutation.addedNodes) {
+			const rels = linkRels(node);
+			if (rels === void 0) continue;
+			const element = node;
+			if (rels.includes("icon")) shadowIcon(element);
+			else if (rels.includes("manifest")) shadowManifest(element);
+		}
+	});
+	observer.observe(target.head, { childList: true });
+	return () => {
+		observer.disconnect();
+		for (const { link, href, media } of iconRestores) {
+			link.setAttribute("href", href);
+			if (media !== "") link.setAttribute("media", media);
+			else link.removeAttribute("media");
+		}
+		if (manifestLink !== void 0 && manifestHref !== void 0) manifestLink.setAttribute("href", manifestHref);
+		manifestLink = void 0;
+		if (blobUrl !== void 0) URL.revokeObjectURL(blobUrl);
+	};
+}
+
+//#endregion
+//#region src/client/running-mark-shadow.ts
+/** Marker attribute the patch style element carries (exposed for the spec). */
+const RUNNING_PATCH_MARKER = "data-aishell-running-mark";
+/**
+* The patch CSS. The whale layers are hidden unconditionally — the static
+* fallback too, because the mark replaces both — while the mark's own
+* animation is guarded so reduced motion keeps it still.
+*/
+const RUNNING_MARK_PATCH_CSS = [
+	"[data-chat-running] [class*=\"runningWhaleAnimated\"],",
+	"[data-chat-running] [class*=\"runningWhaleStill\"] {",
+	"  display: none;",
+	"}",
+	"[data-chat-running] [class*=\"runningIcon\"] {",
+	`  background: url("${AISHELL_MARK_URI}") center / contain no-repeat;`,
+	"}",
+	"@keyframes aishell-running-bob {",
+	"  0%, 100% { transform: none; opacity: 1; }",
+	"  50% { transform: translateY(-0.7px); opacity: 0.82; }",
+	"}",
+	"@media (prefers-reduced-motion: no-preference) {",
+	"  [data-chat-running] [class*=\"runningIcon\"] {",
+	"    animation: aishell-running-bob 1.2s ease-in-out infinite;",
+	"  }",
+	"}"
+].join("\n");
+/**
+* Install the running-mark shadow on a document.
+*
+* Injects the patch CSS once (guarded by the marker attribute so a second
+* install is a no-op) and returns the disposer that removes the element.
+*/
+function installRunningMarkShadow(target) {
+	if (typeof target.querySelector !== "function") return () => {};
+	const existing = target.querySelector(`style[${RUNNING_PATCH_MARKER}]`);
+	if (existing !== null) return () => {
+		existing.remove();
+	};
+	const tag = target.createElement("style");
+	tag.setAttribute(RUNNING_PATCH_MARKER, "");
+	tag.textContent = RUNNING_MARK_PATCH_CSS;
+	target.head.appendChild(tag);
+	return () => {
+		tag.remove();
+	};
+}
+
+//#endregion
+//#region src/client/running-text-shadow.ts
+/** Official zh phrase, the prefix of both the bare and the duration forms. */
+const OFFICIAL_ZH = "深度求索中";
+/** Branded zh phrase (final copy: 思考中 / 思考中，用时 {duration} ···). */
+const BRANDED_ZH = "思考中";
+/** Official en phrase, the prefix of both the bare and the duration forms. */
+const OFFICIAL_EN = "Deep diving";
+/** Branded en phrase (final copy: Thinking / Thinking for {duration} ···). */
+const BRANDED_EN = "Thinking";
+/** The replacements, in order. */
+const REPLACEMENTS = [[OFFICIAL_ZH, BRANDED_ZH], [OFFICIAL_EN, BRANDED_EN]];
+/**
+* Rewrite the running-line copy inside a value.
+*
+* Every occurrence of either official phrase is replaced; a value without
+* them is returned as-is — the shadow never invents content.
+*/
+function rebrandRunningText(value) {
+	let branded = value;
+	for (const [official, replacement] of REPLACEMENTS) branded = branded.split(official).join(replacement);
+	return branded;
+}
+/** Whether the node carries the running row's stable anchor attribute.
+*
+* Duck-typed on the attribute surface rather than `instanceof Element` so
+* the shadow works identically in the browser and under the specs' DOM
+* stub, which provides the attribute methods without the constructor. */
+function isRunningRow(node) {
+	return node.nodeType === Node.ELEMENT_NODE && node.hasAttribute("data-chat-running");
+}
+/**
+* Rewrite one text node and the shimmer attribute of its parent.
+*
+* The attribute matters as much as the node: TextShimmer's decorative
+* layer draws `content: attr(data-shimmer-text)` rather than the node's
+* own text, so leaving it stale resurfaces the official copy every time
+* the highlight sweeps.
+*/
+function rewriteTextNode(node) {
+	const branded = rebrandRunningText(node.data);
+	if (branded === node.data) return;
+	node.data = branded;
+	const host = node.parentElement;
+	if (host !== null && host.hasAttribute("data-shimmer-text")) host.setAttribute("data-shimmer-text", rebrandRunningText(host.getAttribute("data-shimmer-text") ?? ""));
+}
+/**
+* Sweep a subtree for official copy, rewriting what it finds.
+*
+* The attribute-only pass matters too: TextShimmer sets the attribute to
+* the generated string while the text node itself renders null, so some
+* re-renders change only the attribute.
+*/
+function sweep(target, root) {
+	const walker = target.createTreeWalker(root, NodeFilter.SHOW_TEXT);
+	for (let node = walker.nextNode(); node !== null; node = walker.nextNode()) rewriteTextNode(node);
+	for (const host of root.querySelectorAll("[data-shimmer-text]")) {
+		const value = host.getAttribute("data-shimmer-text") ?? "";
+		const branded = rebrandRunningText(value);
+		if (branded !== value) host.setAttribute("data-shimmer-text", branded);
+	}
+}
+/**
+* Install the running-text shadow on a document.
+*
+* Sweeps every mounted [data-chat-running] row once, then observes the
+* document body for new rows (childList) and their text/attribute
+* changes (characterData, data-shimmer-text) so the per-second re-renders
+* stay covered for as long as the row exists. Returns the disposer: the
+* observer stops and every live row is restored to its official copy.
+*/
+function installRunningTextShadow(target) {
+	if (typeof target.querySelector !== "function" || typeof MutationObserver !== "function") return () => {};
+	const rewriteRow = (row) => {
+		sweep(target, row);
+	};
+	for (const row of target.querySelectorAll("[data-chat-running]")) rewriteRow(row);
+	const observer = new MutationObserver((mutations) => {
+		for (const mutation of mutations) {
+			if (mutation.type === "characterData") {
+				const node = mutation.target;
+				if (node.parentElement !== null && node.parentElement.closest("[data-chat-running]") !== null) rewriteTextNode(node);
+				continue;
+			}
+			if (mutation.type === "attributes") {
+				const host = mutation.target;
+				if (host.nodeType === Node.ELEMENT_NODE) {
+					const element = host;
+					if (element.closest("[data-chat-running]") !== null) {
+						const value = element.getAttribute("data-shimmer-text") ?? "";
+						const branded = rebrandRunningText(value);
+						if (branded !== value) element.setAttribute("data-shimmer-text", branded);
+					}
+				}
+				continue;
+			}
+			for (const node of mutation.addedNodes) if (node.nodeType === Node.ELEMENT_NODE) {
+				if (isRunningRow(node)) rewriteRow(node);
+				else if (node.parentElement !== null && node.parentElement.closest("[data-chat-running]") !== null) sweep(target, node.parentElement);
+			} else if (node.nodeType === Node.TEXT_NODE && node.parentElement !== null) {
+				if (node.parentElement.closest("[data-chat-running]") !== null) rewriteTextNode(node);
+			}
+		}
+	});
+	observer.observe(target.body, {
+		childList: true,
+		subtree: true,
+		characterData: true,
+		attributeFilter: ["data-shimmer-text"]
+	});
+	return () => {
+		observer.disconnect();
+		for (const row of target.querySelectorAll("[data-chat-running]")) {
+			const restore = (host) => {
+				if (host.hasAttribute("data-shimmer-text")) host.setAttribute("data-shimmer-text", unbrand(host.getAttribute("data-shimmer-text") ?? ""));
+			};
+			restore(row);
+			for (const host of row.querySelectorAll("[data-shimmer-text]")) restore(host);
+			const walker = target.createTreeWalker(row, NodeFilter.SHOW_TEXT);
+			for (let node = walker.nextNode(); node !== null; node = walker.nextNode()) {
+				const text = node;
+				const restored = unbrand(text.data);
+				if (restored !== text.data) text.data = restored;
+			}
+		}
+	};
+}
+/** The inverse rewrite, so the disposer restores the official copy exactly. */
+function unbrand(value) {
+	let official = value;
+	for (const [from, to] of REPLACEMENTS) official = official.split(to).join(from);
+	return official;
+}
+
 //#endregion
 //#region src/client/index.ts
 /** Required service: the UI slot registry. */
@@ -331,7 +666,12 @@ function apply(ctx) {
 		name: "conversation.hero.brand.mark",
 		priority: -1
 	}, AishellHeroBrandMark));
-	if (typeof document !== "undefined") ctx.effect(() => installTitleShadow(document), "aishell-brand: window title shadow");
+	if (typeof document !== "undefined") {
+		ctx.effect(() => installTitleShadow(document), "aishell-brand: window title shadow");
+		ctx.effect(() => installFaviconShadow(document), "aishell-brand: favicon shadow");
+		ctx.effect(() => installRunningMarkShadow(document), "aishell-brand: running mark shadow");
+		ctx.effect(() => installRunningTextShadow(document), "aishell-brand: running text shadow");
+	}
 }
 
 //#endregion

package/lib/types/client/aishell-mark.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The AI Shell mark as an inline source, shared by the runtime brand shadows.
+ *
+ * The slot occupants (Brand.tsx) draw the mark through a CSS module whose
+ * url() the build inlines, but the runtime shadows need the bytes as a JS
+ * string: the favicon shadow writes them into a link href, and the running
+ * status mark shadow writes them into injected patch CSS. This module is
+ * that one source, so the asset and the shadows cannot drift apart.
+ * tests/aishell-mark.spec.ts pins the constant against assets/aishell.svg.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/aishell-mark
+ */
+/** The AI Shell mark, verbatim assets/aishell.svg (the spec pins this). */
+export declare const AISHELL_MARK_SVG = "<svg viewBox=\"0 0 44 44\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"44.000000\" height=\"44.000000\" fill=\"none\">\n\t<defs>\n\t\t<linearGradient id=\"paint_linear_0\" x1=\"38.5\" x2=\"2.19999695\" y1=\"1.90734863e-06\" y2=\"39.5999908\" gradientUnits=\"userSpaceOnUse\">\n\t\t\t<stop stop-color=\"rgb(53,137,255)\" offset=\"0\" stop-opacity=\"1\" />\n\t\t\t<stop stop-color=\"rgb(169,38,255)\" offset=\"1\" stop-opacity=\"1\" />\n\t\t</linearGradient>\n\t</defs>\n\t<rect id=\"icon_AIShell\" width=\"44.000000\" height=\"44.000000\" x=\"0.000000\" y=\"0.000000\" fill=\"rgb(255,255,255)\" fill-opacity=\"0\" />\n\t<path id=\"\u5408\u5E76\" d=\"M37.4576 0.299738C37.3775 0.139877 37.2861 0.0428196 37.1832 0.00856393C37.0917 -0.0142732 37.006 0.00856394 36.9259 0.0770754C36.8459 0.145587 36.7887 0.219808 36.7545 0.299738C36.4572 1.86408 35.7369 3.21718 34.5937 4.35904C33.4618 5.48948 32.0956 6.22027 30.495 6.55141C30.3921 6.57424 30.3178 6.64275 30.272 6.75694C30.2377 6.87113 30.2435 6.97389 30.2892 7.06524C30.3464 7.15659 30.415 7.20226 30.495 7.20226C31.2078 7.35296 31.8779 7.58759 32.5055 7.90618L32.5055 7.9062L32.5056 7.90623C33.257 8.28771 33.9473 8.78955 34.5765 9.41176C35.7312 10.5422 36.4572 11.8896 36.7545 13.4539C36.8116 13.591 36.8974 13.6823 37.0117 13.728C37.1146 13.7622 37.2061 13.7565 37.2861 13.7109C37.3775 13.6538 37.4347 13.5681 37.4576 13.4539C37.7891 11.8896 38.5151 10.5422 39.6355 9.41176C40.7674 8.2699 42.1279 7.5334 43.717 7.20226C43.8199 7.17943 43.9 7.12233 43.9571 7.03099C44.0143 6.92822 44.0143 6.83116 43.9571 6.73981C43.9 6.63705 43.8199 6.57424 43.717 6.55141C42.1507 6.22027 40.7959 5.48948 39.6527 4.35904C38.5208 3.21718 37.7891 1.86408 37.4576 0.299738ZM42.625 16.4999L42.625 33C42.625 33.9493 42.4572 34.829 42.1216 35.6392C41.786 36.4495 41.2826 37.1902 40.6114 37.8614C39.9402 38.5326 39.1994 39.036 38.3892 39.3716C37.579 39.7072 36.6992 39.875 35.75 39.875L10.9999 39.875L8.24995 39.875C7.30073 39.875 6.42102 39.7072 5.61081 39.3716C4.80058 39.036 4.05985 38.5326 3.38863 37.8614C2.71742 37.1902 2.21402 36.4494 1.87841 35.6392C1.5428 34.829 1.375 33.9493 1.375 33L1.375 11C1.375 10.0508 1.5428 9.17106 1.8784 8.36083L1.87841 8.36082C2.21402 7.55059 2.71743 6.80987 3.38864 6.13866C4.05985 5.46745 4.80057 4.96404 5.61079 4.62843L5.6108 4.62843C6.42103 4.29282 7.30076 4.12502 8.25 4.12502L27.4999 4.125C28.2699 4.125 28.8749 4.73 28.8749 5.5C28.8749 6.27 28.2699 6.875 27.4999 6.875L8.25 6.87502C7.68045 6.87502 7.15261 6.9757 6.66648 7.17706C6.18034 7.37843 5.73591 7.68047 5.33318 8.0832C4.93046 8.48593 4.62841 8.93036 4.42705 9.41649C4.22568 9.90263 4.125 10.4305 4.125 11L4.125 33C4.125 33.5696 4.22568 34.0974 4.42705 34.5835C4.62841 35.0697 4.93045 35.5141 5.33317 35.9168C5.73588 36.3195 6.18028 36.6216 6.66639 36.8229C7.15256 37.0243 7.68042 37.125 8.24999 37.125L10.9999 37.125L35.75 37.125C36.3195 37.125 36.8474 37.0243 37.3335 36.823C37.8197 36.6216 38.2641 36.3196 38.6668 35.9168C39.0695 35.5141 39.3716 35.0697 39.573 34.5835C39.7743 34.0974 39.875 33.5696 39.875 33L39.875 16.4999C39.875 15.7299 40.48 15.1249 41.25 15.1249C42.02 15.1249 42.625 15.7299 42.625 16.4999ZM10.0277 12.7777C10.5722 12.2333 11.4278 12.2333 11.9723 12.7777L20.2222 21.0277C20.4907 21.2962 20.6249 21.6203 20.6249 22C20.6249 22.3797 20.4907 22.7037 20.2222 22.9722L11.9722 31.2223C11.4277 31.7668 10.5721 31.7668 10.0277 31.2223C9.48318 30.6779 9.48317 29.8223 10.0276 29.2778L17.3054 22L10.0277 14.7223C9.48325 14.1778 9.48326 13.3222 10.0277 12.7777ZM20.625 28.875C20.625 28.105 21.23 27.5 22 27.5L33 27.5C33.77 27.5 34.375 28.105 34.375 28.875C34.375 29.645 33.77 30.25 33 30.25L22 30.25C21.23 30.25 20.625 29.645 20.625 28.875Z\" fill=\"rgb(0,0,0)\" fill-opacity=\"0\" fill-rule=\"evenodd\" />\n\t<path id=\"\u5408\u5E76\" d=\"M37.4576 0.299738C37.3775 0.139877 37.2861 0.0428196 37.1832 0.00856393C37.0917 -0.0142732 37.006 0.00856394 36.9259 0.0770754C36.8459 0.145587 36.7887 0.219808 36.7545 0.299738C36.4572 1.86408 35.7369 3.21718 34.5937 4.35904C33.4618 5.48948 32.0956 6.22027 30.495 6.55141C30.3921 6.57424 30.3178 6.64275 30.272 6.75694C30.2377 6.87113 30.2435 6.97389 30.2892 7.06524C30.3464 7.15659 30.415 7.20226 30.495 7.20226C31.2078 7.35296 31.8779 7.58759 32.5055 7.90618L32.5055 7.9062L32.5056 7.90623C33.257 8.28771 33.9473 8.78955 34.5765 9.41176C35.7312 10.5422 36.4572 11.8896 36.7545 13.4539C36.8116 13.591 36.8974 13.6823 37.0117 13.728C37.1146 13.7622 37.2061 13.7565 37.2861 13.7109C37.3775 13.6538 37.4347 13.5681 37.4576 13.4539C37.7891 11.8896 38.5151 10.5422 39.6355 9.41176C40.7674 8.2699 42.1279 7.5334 43.717 7.20226C43.8199 7.17943 43.9 7.12233 43.9571 7.03099C44.0143 6.92822 44.0143 6.83116 43.9571 6.73981C43.9 6.63705 43.8199 6.57424 43.717 6.55141C42.1507 6.22027 40.7959 5.48948 39.6527 4.35904C38.5208 3.21718 37.7891 1.86408 37.4576 0.299738ZM42.625 16.4999L42.625 33C42.625 33.9493 42.4572 34.829 42.1216 35.6392C41.786 36.4495 41.2826 37.1902 40.6114 37.8614C39.9402 38.5326 39.1994 39.036 38.3892 39.3716C37.579 39.7072 36.6992 39.875 35.75 39.875L10.9999 39.875L8.24995 39.875C7.30073 39.875 6.42102 39.7072 5.61081 39.3716C4.80058 39.036 4.05985 38.5326 3.38863 37.8614C2.71742 37.1902 2.21402 36.4494 1.87841 35.6392C1.5428 34.829 1.375 33.9493 1.375 33L1.375 11C1.375 10.0508 1.5428 9.17106 1.8784 8.36083L1.87841 8.36082C2.21402 7.55059 2.71743 6.80987 3.38864 6.13866C4.05985 5.46745 4.80057 4.96404 5.61079 4.62843L5.6108 4.62843C6.42103 4.29282 7.30076 4.12502 8.25 4.12502L27.4999 4.125C28.2699 4.125 28.8749 4.73 28.8749 5.5C28.8749 6.27 28.2699 6.875 27.4999 6.875L8.25 6.87502C7.68045 6.87502 7.15261 6.9757 6.66648 7.17706C6.18034 7.37843 5.73591 7.68047 5.33318 8.0832C4.93046 8.48593 4.62841 8.93036 4.42705 9.41649C4.22568 9.90263 4.125 10.4305 4.125 11L4.125 33C4.125 33.5696 4.22568 34.0974 4.42705 34.5835C4.62841 35.0697 4.93045 35.5141 5.33317 35.9168C5.73588 36.3195 6.18028 36.6216 6.66639 36.8229C7.15256 37.0243 7.68042 37.125 8.24999 37.125L10.9999 37.125L35.75 37.125C36.3195 37.125 36.8474 37.0243 37.3335 36.823C37.8197 36.6216 38.2641 36.3196 38.6668 35.9168C39.0695 35.5141 39.3716 35.0697 39.573 34.5835C39.7743 34.0974 39.875 33.5696 39.875 33L39.875 16.4999C39.875 15.7299 40.48 15.1249 41.25 15.1249C42.02 15.1249 42.625 15.7299 42.625 16.4999ZM10.0277 12.7777C10.5722 12.2333 11.4278 12.2333 11.9723 12.7777L20.2222 21.0277C20.4907 21.2962 20.6249 21.6203 20.6249 22C20.6249 22.3797 20.4907 22.7037 20.2222 22.9722L11.9722 31.2223C11.4277 31.7668 10.5721 31.7668 10.0277 31.2223C9.48318 30.6779 9.48317 29.8223 10.0276 29.2778L17.3054 22L10.0277 14.7223C9.48325 14.1778 9.48326 13.3222 10.0277 12.7777ZM20.625 28.875C20.625 28.105 21.23 27.5 22 27.5L33 27.5C33.77 27.5 34.375 28.105 34.375 28.875C34.375 29.645 33.77 30.25 33 30.25L22 30.25C21.23 30.25 20.625 29.645 20.625 28.875Z\" fill=\"url(#paint_linear_0)\" fill-rule=\"evenodd\" />\n</svg>";
+/**
+ * The mark as a self-contained data URI.
+ *
+ * URL-encoded rather than base64 (shorter, and the gradient reads on both
+ * light and dark themes, which is what lets one URI serve every surface).
+ */
+export declare const AISHELL_MARK_URI: string;
+//# sourceMappingURL=aishell-mark.d.ts.map

package/lib/types/client/favicon-shadow.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Runtime favicon and manifest shadowing for the branded distribution.
+ *
+ * The browser tab icon comes from the dsh-web-frontend dist's
+ * favicon.svg / favicon-dark.svg (a DeepSeek whale, one fixed fill per
+ * theme, selected by the index's `media="(prefers-color-scheme: …)"`
+ * links), and that dist tree is covered by the desktop-runtime digest —
+ * the file-level swap cannot reach it. The plugin side therefore shadows
+ * the links at runtime: every `link[rel~="icon"]` in the head has its
+ * href rewritten to the AI Shell mark data URI. The mark's gradient
+ * reads on both light and dark themes, so the media attribute is dropped
+ * and one icon serves both.
+ *
+ * The web manifest's display names ("DeepSeek Harness" / "DSH") are
+ * shadowed the same way when they can be: the manifest is fetched, the
+ * name/short_name fields rewritten to "AI Shell", and the link pointed
+ * at a Blob URL of the result. A manifest that cannot be fetched or
+ * parsed is left exactly as found — a broken install prompt would cost
+ * more than the name is worth.
+ *
+ * A MutationObserver watches the head, so a re-inserted icon or manifest
+ * link (HMR, later injections) is re-shadowed as it appears.
+ *
+ * Shadowing is a default, not a force (plan §2.2): install() and the
+ * disposer it returns are symmetric, so disabling the plugin restores
+ * the official links exactly.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/favicon-shadow
+ */
+/** The disposer restores the official icon and manifest links; a no-op install returns this. */
+export type FaviconShadowDisposer = () => void;
+/**
+ * Rewrite a manifest document's display names in place.
+ *
+ * Only the two fields the dist actually ships are touched, and only when
+ * they carry their official values — anything else in the document (icons,
+ * start_url, scope, display) passes through untouched, and a manifest the
+ * base customized keeps its customization.
+ */
+export declare function rebrandManifest(manifest: Record<string, unknown>): Record<string, unknown>;
+/** The href every icon link is shadowed with (exposed for the spec). */
+export declare const BRANDED_ICON_HREF: string;
+/**
+ * Install the favicon shadow on a document.
+ *
+ * Rewrites every current icon link's href to the AI Shell mark (dropping
+ * the media attribute so the one gradient serves both themes), shadows the
+ * manifest names when the manifest is reachable, and observes the head so
+ * re-inserted links are covered too. Returns the disposer: every touched
+ * link is restored to its original href and media, the manifest link to
+ * its original href, and the Blob URL is revoked, so an unload leaves the
+ * document exactly as it was found.
+ */
+export declare function installFaviconShadow(target: Document): FaviconShadowDisposer;
+//# sourceMappingURL=favicon-shadow.d.ts.map

package/lib/types/client/running-mark-shadow.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Running-status whale-tail shadow for the branded distribution.
+ *
+ * ui-chat's RunningWhaleTail renders the DeepSeek whale: an APNG
+ * (running-whale@2x.png) masked over currentColor inside a 14px
+ * runningIcon box, with a static stroke SVG fallback for reduced motion.
+ * All of it is digest-protected in the dsh tree, and there is no slot for
+ * it — the row lives inside ui-chat's ChatView, which a plugin cannot
+ * register into. The shadow therefore works the same way the hero
+ * headline patch does (Brand.tsx): a CSS patch injected into the head,
+ * anchored on the row's stable literal attribute [data-chat-running]
+ * (RunningStatus.tsx writes it directly; the class names around it are
+ * CSS-module hashes, so they are matched by the same [class*="…"]
+ * substring selectors the hero patch already relies on).
+ *
+ * The patch hides both whale layers and repaints the runningIcon box with
+ * the AI Shell mark (a data URI background), adding a gentle bob/pulse
+ * that follows the official whale's degradation: under
+ * prefers-reduced-motion the mark is static, matching the official
+ * whale's own reduced-motion fallback.
+ *
+ * Shadowing is a default, not a force (plan §2.2): install() and the
+ * disposer it returns are symmetric, so disabling the plugin restores
+ * the official whale exactly.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/running-mark-shadow
+ */
+/** The disposer removes the patch style element; a no-op install returns this. */
+export type RunningMarkShadowDisposer = () => void;
+/** Marker attribute the patch style element carries (exposed for the spec). */
+export declare const RUNNING_PATCH_MARKER = "data-aishell-running-mark";
+/**
+ * The patch CSS. The whale layers are hidden unconditionally — the static
+ * fallback too, because the mark replaces both — while the mark's own
+ * animation is guarded so reduced motion keeps it still.
+ */
+export declare const RUNNING_MARK_PATCH_CSS: string;
+/**
+ * Install the running-mark shadow on a document.
+ *
+ * Injects the patch CSS once (guarded by the marker attribute so a second
+ * install is a no-op) and returns the disposer that removes the element.
+ */
+export declare function installRunningMarkShadow(target: Document): RunningMarkShadowDisposer;
+//# sourceMappingURL=running-mark-shadow.d.ts.map

package/lib/types/client/running-text-shadow.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Running-status copy shadow for the branded distribution.
+ *
+ * ui-chat's locale dictionary names the live running line after DeepSeek's
+ * own product language: zh "深度求索中" / "深度求索中，用时 {duration} ···",
+ * en "Deep diving" / "Deep diving for {duration} ···". locale.register
+ * throws on an already-claimed namespace, so the `chat` dictionary cannot
+ * be re-registered — the shadow rewrites the rendered text instead.
+ *
+ * The row re-renders every second while a Turn runs (LIVE_RUN_CLOCK_
+ * INTERVAL_MS = 1000), so a one-shot rewrite would flash the official
+ * copy on every tick. A MutationObserver watches [data-chat-running]
+ * subtrees — characterData for the second ticks, childList for mounts,
+ * and the data-shimmer-text attribute because TextShimmer paints its
+ * highlight layer through CSS `content: attr(data-shimmer-text)`: a text
+ * node rewritten without the attribute would keep showing the old glyphs
+ * every time the highlight sweeps across them.
+ *
+ * One substring replacement covers both keys: the duration form begins
+ * with the same prefix as the bare form, so replacing "深度求索中" →
+ * "思考中" and "Deep diving" → "Thinking" rewrites the long sentences
+ * too. The row's aria-hidden status span carries the same text and sits
+ * inside the same subtree, so it is covered by the same sweep. Duration
+ * units and the "···" tail are the harness's own words, not product
+ * branding, and pass through untouched.
+ *
+ * Shadowing is a default, not a force (plan §2.2): install() and the
+ * disposer it returns are symmetric, so disabling the plugin restores
+ * the official copy exactly.
+ *
+ * @module @huaweidevtools/aishell-dsh-brand/client/running-text-shadow
+ */
+/** The disposer stops the observer and restores the official copy; a no-op install returns this. */
+export type RunningTextShadowDisposer = () => void;
+/**
+ * Rewrite the running-line copy inside a value.
+ *
+ * Every occurrence of either official phrase is replaced; a value without
+ * them is returned as-is — the shadow never invents content.
+ */
+export declare function rebrandRunningText(value: string): string;
+/**
+ * Install the running-text shadow on a document.
+ *
+ * Sweeps every mounted [data-chat-running] row once, then observes the
+ * document body for new rows (childList) and their text/attribute
+ * changes (characterData, data-shimmer-text) so the per-second re-renders
+ * stay covered for as long as the row exists. Returns the disposer: the
+ * observer stops and every live row is restored to its official copy.
+ */
+export declare function installRunningTextShadow(target: Document): RunningTextShadowDisposer;
+//# sourceMappingURL=running-text-shadow.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@huaweidevtools/aishell-dsh-brand",
   "description": "AI Shell brand reskin for DSH web — replaces sidebar and hero brand marks with AI Shell SVG",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "publishConfig": {
     "access": "public"
   },