dsh-claude-desktop-theme 0.4.4 → 0.4.6

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

@@ -9,6 +9,21 @@
 export declare const SETTINGS_NAMESPACE = "ccdSettings";
 /** Simplified Chinese dictionary; the key set is the source of truth. */
 export declare const zh: {
+    readonly 'section.personalization': '个性化';
+    readonly 'field.petStyle': '宠物样式';
+    readonly 'field.runningStyle': '输出中状态';
+    readonly 'running.whale': '鲸鱼（原生）';
+    readonly 'running.claude': 'Claude 呼吸星芒与状态';
+    readonly 'field.replySignatureStyle': '回复签名';
+    readonly 'signature.whale': '鲸鱼尾巴';
+    readonly 'signature.claude': 'Claude 星芒';
+    readonly 'pet.whale': '小鲸鱼';
+    readonly 'pet.claude': 'Claude 像素宠物';
+    readonly 'field.greetingStyle': '首页问候';
+    readonly 'greeting.explore': '探索未知之境';
+    readonly 'greeting.claude': 'Claude 问候与图标';
+    readonly 'field.greetingName': '问候语中的称呼';
+    readonly 'hint.personalization': '各项可独立切换；宠物点击后播放对应动作，问候语跟随界面语言，不显示姓名。原有模块开关仍控制显示。';
     readonly nav: 'Claude 主题';
     readonly summary: 'CCD 风格界面 · 外观 · 字体';
     readonly 'section.general': '通用';
@@ -16,6 +31,10 @@ export declare const zh: {
     readonly 'section.appearance': '外观';
     readonly 'section.fonts': '字体';
     readonly 'section.view': '视图';
+    readonly 'field.showModelIcons': '显示模型图标';
+    readonly 'hint.showModelIcons': '显示模型选单中名称前的图标，默认开启';
+    readonly 'field.showSidebarBrand': '显示 DeepSeek Harness 品牌条目';
+    readonly 'hint.showSidebarBrand': '显示侧栏顶部的品牌标志与名称，默认关闭';
     readonly 'field.showHeaderSubagents': '显示顶栏子代理入口';
     readonly 'hint.showHeaderSubagents': '显示会话顶栏的子代理数量与列表入口，默认关闭；子代理运行与侧栏树不受影响';
     readonly 'field.showHeaderTeam': '显示顶栏团队入口';
@@ -53,10 +72,12 @@ export declare const zh: {
     readonly 'feature.shell': '窗口与分栏骨架';
     readonly 'feature.sidebar': '侧栏';
     readonly 'feature.new-session': '新建页';
+    readonly 'feature.hero-ripples': '主页字符水波纹';
+    readonly 'hint.hero-ripples': '主页与标题栏的流动背景和点击扩散，默认开启；需同时开启新建页模块';
     readonly 'feature.conversation': '聊天页';
     readonly 'feature.tool-calls': '工具调用展示';
     readonly 'feature.statistics': '统计卡片';
-    readonly 'feature.composer-pet': '输入框小鲸鱼';
+    readonly 'feature.composer-pet': '输入框宠物';
     readonly 'feature.composer-stats': '状态栏统计读数';
     readonly 'hint.composer-stats': '输出速度与缓存命中率，关掉时这两项不显示（默认）';
     readonly 'feature.context-panel': '上下文分解面板';

package/lib/types/client/features/tool-calls/index.d.ts

@@ -1,2 +1,2 @@
-import type { PlannedFeature } from '../../contracts/feature.ts';
-export declare const toolCallsFeature: PlannedFeature;
+import type { ImplementedFeature } from '../../contracts/feature.ts';
+export declare const toolCallsFeature: ImplementedFeature;

package/lib/types/host/balance.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from '@deepseek-ai/cordis';
+/** Resolve the same reference as DSH's official API-key provider, only on Host. */
+export declare function readBalanceKey(ctx: Context): Promise<string | undefined>;
+/** Authenticated renderer route; only normalized balances leave the Host. */
+export declare function mountDeepSeekBalance(ctx: Context, isEnabled: () => boolean): void;

package/lib/types/host/git.d.ts

@@ -0,0 +1,37 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type GitBranchView, type GitCheckoutResult } from '../shared/git.ts';
+/** Runs one git invocation in a directory; rejects with the child's error. */
+export type GitRunner = (cwd: string, args: readonly string[], signal: AbortSignal, timeout?: number) => Promise<string>;
+/**
+ * No shell, no prompts, no optional locks: listing branches must never block on
+ * credentials, never start a repository-configured fsmonitor, and never take
+ * the index lock a concurrent `git` in the user's terminal is waiting for.
+ * `LC_ALL=C` keeps git's own messages in English, which is what tells a
+ * non-repository apart from other fatal errors (a Chinese locale prints
+ * 「不是 git 仓库」); ref names are bytes and pass through unchanged.
+ */
+export declare const runGit: GitRunner;
+/**
+ * Local branches of the repository that contains `cwd`, read-only.
+ * @returns `ready` with the current branch first, or the reason there is none.
+ */
+export declare function listBranches(cwd: string, run: GitRunner, signal: AbortSignal): Promise<GitBranchView>;
+/**
+ * Check out one existing local branch with plain `git switch`.
+ *
+ * No `--force`, no stash: when local changes would be overwritten git refuses
+ * and the tree is left as it was. Changes that do not conflict travel to the
+ * new branch, as git does by default; their count comes back so the picker can
+ * say so. The name must already resolve under `refs/heads/` and may not start
+ * with `-`, so it can only ever be read as a branch, never as an option.
+ * Repository `post-checkout` hooks run, exactly as for a `git switch` typed in a
+ * terminal. The switch is not tied to the request's lifetime: a card closed
+ * mid-switch must not kill git halfway through updating the tree.
+ */
+export declare function checkoutBranch(cwd: string, branch: string, run: GitRunner): Promise<GitCheckoutResult>;
+/**
+ * Authenticated renderer routes: the branch listing and the checkout. The
+ * client names a registered Workspace, never a path, so neither route can be
+ * pointed at an arbitrary directory.
+ */
+export declare function mountGitBranches(ctx: Context, isEnabled: () => boolean, run?: GitRunner): void;

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

@@ -26,6 +26,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         'composer-pet': z<boolean, boolean, "defined">;
         'composer-stats': z<boolean, boolean, "defined">;
         'context-panel': z<boolean, boolean, "defined">;
+        'hero-ripples': z<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
         shell: z<boolean, boolean, "defined">;
         sidebar: z<boolean, boolean, "defined">;
@@ -36,6 +37,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         'composer-pet': z<boolean, boolean, "defined">;
         'composer-stats': z<boolean, boolean, "defined">;
         'context-panel': z<boolean, boolean, "defined">;
+        'hero-ripples': z<boolean, boolean, "defined">;
     }>>>, "volatile-defined">;
     appearance: z<NoInfer<Schemastery.ObjectS<NoInfer<{
         canvas: z<string, string, "defined">;
@@ -53,12 +55,29 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         uiCjk: z<string, string, "defined">;
         code: z<string, string, "defined">;
     }>>>, "volatile-defined">;
+    personalization: z<NoInfer<Schemastery.ObjectS<NoInfer<{
+        petStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        runningStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        replySignatureStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        greetingStyle: z<"claude" | "explore", "claude" | "explore", "defined">;
+        greetingName: z<string, string, "defined">;
+    }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        petStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        runningStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        replySignatureStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        greetingStyle: z<"claude" | "explore", "claude" | "explore", "defined">;
+        greetingName: z<string, string, "defined">;
+    }>>>, "volatile-defined">;
     view: z<NoInfer<Schemastery.ObjectS<NoInfer<{
+        showModelIcons: z<boolean, boolean, "defined">;
+        showSidebarBrand: z<boolean, boolean, "defined">;
         showHeaderSubagents: z<boolean, boolean, "defined">;
         showHeaderTeam: z<boolean, boolean, "defined">;
         groupByStatus: z<boolean, boolean, "defined">;
         showEmptyGroups: z<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        showModelIcons: z<boolean, boolean, "defined">;
+        showSidebarBrand: z<boolean, boolean, "defined">;
         showHeaderSubagents: z<boolean, boolean, "defined">;
         showHeaderTeam: z<boolean, boolean, "defined">;
         groupByStatus: z<boolean, boolean, "defined">;
@@ -77,6 +96,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         'composer-pet': z<boolean, boolean, "defined">;
         'composer-stats': z<boolean, boolean, "defined">;
         'context-panel': z<boolean, boolean, "defined">;
+        'hero-ripples': z<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
         shell: z<boolean, boolean, "defined">;
         sidebar: z<boolean, boolean, "defined">;
@@ -87,6 +107,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         'composer-pet': z<boolean, boolean, "defined">;
         'composer-stats': z<boolean, boolean, "defined">;
         'context-panel': z<boolean, boolean, "defined">;
+        'hero-ripples': z<boolean, boolean, "defined">;
     }>>>, "volatile-defined">;
     appearance: z<NoInfer<Schemastery.ObjectS<NoInfer<{
         canvas: z<string, string, "defined">;
@@ -104,12 +125,29 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         uiCjk: z<string, string, "defined">;
         code: z<string, string, "defined">;
     }>>>, "volatile-defined">;
+    personalization: z<NoInfer<Schemastery.ObjectS<NoInfer<{
+        petStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        runningStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        replySignatureStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        greetingStyle: z<"claude" | "explore", "claude" | "explore", "defined">;
+        greetingName: z<string, string, "defined">;
+    }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        petStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        runningStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        replySignatureStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        greetingStyle: z<"claude" | "explore", "claude" | "explore", "defined">;
+        greetingName: z<string, string, "defined">;
+    }>>>, "volatile-defined">;
     view: z<NoInfer<Schemastery.ObjectS<NoInfer<{
+        showModelIcons: z<boolean, boolean, "defined">;
+        showSidebarBrand: z<boolean, boolean, "defined">;
         showHeaderSubagents: z<boolean, boolean, "defined">;
         showHeaderTeam: z<boolean, boolean, "defined">;
         groupByStatus: z<boolean, boolean, "defined">;
         showEmptyGroups: z<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        showModelIcons: z<boolean, boolean, "defined">;
+        showSidebarBrand: z<boolean, boolean, "defined">;
         showHeaderSubagents: z<boolean, boolean, "defined">;
         showHeaderTeam: z<boolean, boolean, "defined">;
         groupByStatus: z<boolean, boolean, "defined">;

package/lib/types/shared/balance.d.ts

@@ -0,0 +1,8 @@
+export declare const BALANCE_PATH = "/api/ccd-deepseek-balance";
+export interface CnyBalance {
+    readonly total: string;
+    readonly granted: string;
+    readonly toppedUp: string;
+}
+/** Accept only the official CNY row; USD is never relabelled as RMB. */
+export declare function readCnyBalance(value: unknown): CnyBalance | null;

package/lib/types/shared/config.d.ts

@@ -8,7 +8,7 @@
  * pill (the output rate, or the cache-hit share) in place of the host's own
  * label.
  */
-export declare const FEATURE_IDS: readonly ['shell', 'sidebar', 'new-session', 'conversation', 'tool-calls', 'statistics', 'composer-pet', 'composer-stats', 'context-panel'];
+export declare const FEATURE_IDS: readonly ['shell', 'sidebar', 'new-session', 'conversation', 'tool-calls', 'statistics', 'composer-pet', 'composer-stats', 'context-panel', 'hero-ripples'];
 export type FeatureId = typeof FEATURE_IDS[number];
 export type FeatureFlags = Readonly<Record<FeatureId, boolean>>;
 /** Fields of the background-colour section; an empty string means "built-in palette". */
@@ -16,13 +16,22 @@ export declare const APPEARANCE_FIELDS: readonly ['canvas', 'sidebar'];
 /** Fields of the typeface section; an empty string means "system stack". */
 export declare const FONT_FIELDS: readonly ['uiLatin', 'uiCjk', 'code'];
 /** Fields of the view-options section. */
-export declare const VIEW_FIELDS: readonly ['showEmptyGroups', 'groupByStatus', 'showHeaderSubagents', 'showHeaderTeam'];
+export declare const VIEW_FIELDS: readonly ['showEmptyGroups', 'groupByStatus', 'showHeaderSubagents', 'showHeaderTeam', 'showSidebarBrand', 'showModelIcons'];
 export type AppearanceField = typeof APPEARANCE_FIELDS[number];
 export type FontField = typeof FONT_FIELDS[number];
 export type ViewField = typeof VIEW_FIELDS[number];
 export type AppearanceConfig = Readonly<Record<AppearanceField, string>>;
 export type FontsConfig = Readonly<Record<FontField, string>>;
 export type ViewConfig = Readonly<Record<ViewField, boolean>>;
+export interface PersonalizationConfig {
+    readonly petStyle: 'whale' | 'claude';
+    readonly runningStyle: 'whale' | 'claude';
+    readonly replySignatureStyle: 'whale' | 'claude';
+    readonly greetingStyle: 'explore' | 'claude';
+    readonly greetingName: string;
+}
+export declare const DEFAULT_PERSONALIZATION: PersonalizationConfig;
+export declare function normalizeGreetingName(value: unknown): string;
 export interface StyleConfig {
     readonly enabled: boolean;
     readonly debug: boolean;
@@ -30,6 +39,7 @@ export interface StyleConfig {
     readonly appearance: AppearanceConfig;
     readonly fonts: FontsConfig;
     readonly view: ViewConfig;
+    readonly personalization: PersonalizationConfig;
 }
 export interface StyleOptions {
     readonly enabled?: boolean;
@@ -38,9 +48,10 @@ export interface StyleOptions {
     readonly appearance?: Partial<Record<AppearanceField, unknown>>;
     readonly fonts?: Partial<Record<FontField, unknown>>;
     readonly view?: Partial<Record<ViewField, unknown>>;
+    readonly personalization?: Partial<Record<keyof PersonalizationConfig, unknown>>;
 }
 export declare const DEFAULT_FEATURES: FeatureFlags;
-/** Empty strings keep the built-in palette and the system font stack in charge. */
+/** Empty colours keep the built-in palette in charge. */
 export declare const DEFAULT_APPEARANCE: AppearanceConfig;
 export declare const DEFAULT_FONTS: FontsConfig;
 /**

package/lib/types/shared/git.d.ts

@@ -0,0 +1,30 @@
+/** Read-only branch listing for the workspace picker's branch row. */
+export declare const GIT_BRANCHES_PATH = "/api/ccd-git-branches";
+/** Upper bound on listed local branches; the rest are reported as truncated. */
+export declare const GIT_BRANCH_LIMIT = 200;
+export type GitBranchState = 'ready' | 'not-repo' | 'no-git' | 'unknown-workspace' | 'error';
+/** What the Host reports for one Workspace directory. */
+export interface GitBranchView {
+    readonly state: GitBranchState;
+    /** Checked-out branch, or the short commit id when `detached`. */
+    readonly current: string | null;
+    readonly detached: boolean;
+    /** Local branches, current first, then most recently committed. */
+    readonly branches: readonly string[];
+    readonly truncated: boolean;
+}
+/** Accept only a well-formed view; anything else reads as an error. */
+export declare function readGitBranchView(value: unknown): GitBranchView;
+/** Branch checkout for the same row, offered on the new-session page only. */
+export declare const GIT_CHECKOUT_PATH = "/api/ccd-git-checkout";
+export type GitCheckoutState = 'switched' | 'conflict' | 'in-worktree' | 'invalid-branch' | 'unknown-workspace' | 'error';
+/** What the Host reports after one checkout attempt. */
+export interface GitCheckoutResult {
+    readonly state: GitCheckoutState;
+    /** Tracked files still modified after a switch: the changes git carried over. */
+    readonly carried: number;
+    /** First line of git's own message, for `error` only. */
+    readonly message: string;
+}
+/** Accept only a well-formed result; anything else reads as an error. */
+export declare function readGitCheckoutResult(value: unknown): GitCheckoutResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-claude-desktop-theme",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "license": "MIT",
   "description": "Claude Code Desktop-style theme for DeepSeek Harness (DSH) Desktop on macOS and Windows, with light/dark themes, model/effort pickers and an interactive pixel whale",
   "author": "zkforge",
@@ -81,6 +81,7 @@
     "typecheck": "tsc --noEmit",
     "check:architecture": "node scripts/check-architecture.mjs",
     "check:package": "node scripts/check-package.mjs",
+    "icons:models": "node scripts/generate-model-icons.mjs",
     "test": "node --test tests/*.test.ts tests/*.test.mjs",
     "check": "npm run typecheck && npm run check:architecture && npm test && npm run build && npm run check:package",
     "prepack": "npm run check",