@jaychang1989/dsh-webchat 0.3.0

package/lib/types/transfer.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Harness-mode transfer: turn a web-chat transcript into development context.
+ *
+ * This is the "Continue in Codex" / ChatGPT-mode analog, and like Codex it is
+ * a CONTEXT HANDOFF rather than a raw replay: the exploration-phase web
+ * conversation is distilled (via the harness LLM) into an executable task
+ * brief — the execution-phase state representation the agent actually needs —
+ * and that brief seeds a fresh harness session. The raw transcript is kept as
+ * the fallback when distillation is unavailable.
+ *
+ * Two targets:
+ *  - new harness session — a COLD persisted session seeded with the distilled
+ *    brief (or raw transcript), so it shows up in the GUI list and resumes;
+ *  - workspace file — the raw transcript rendered to markdown in the target
+ *    project directory, so any agent can read it with file tools.
+ *
+ * Session creation writes directly through the session-persistence backend
+ * (`sessionPersistence.create` + `append`), NOT `ctx.sessions.create()`:
+ * the store's `create` produces a LIVE session owned by the calling fiber,
+ * which the GUI then refuses to resume ("cannot prepare … while it is live").
+ * A cold persisted session is exactly what the GUI's resume path expects.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { Workspace } from '@deepseek-ai/dsh-workspace';
+import type { TransferMode, WebChatMessage, WebChatTranscript } from './protocol.ts';
+/** Render the message list of a transcript (no header) to markdown. */
+export declare function renderMessagesMarkdown(messages: WebChatMessage[], options?: {
+    excludeThinking?: boolean;
+}): string;
+/** Render one transcript to markdown for harness consumption. */
+export declare function renderTranscriptMarkdown(transcript: WebChatTranscript, options?: {
+    excludeThinking?: boolean;
+}): string;
+/**
+ * Framing that turns the distilled brief into established context for the
+ * agent — the analog of Codex's "another model started to solve this problem
+ * and produced a summary; use it to build on the work already done".
+ */
+export declare const HANDOFF_PREAMBLE = "\u8FD9\u662F\u4E00\u6B21\u4ECE DeepSeek \u7F51\u9875\u7AEF\u4F1A\u8BDD\uFF08chat.deepseek.com\uFF09\u8F6C\u6765\u7684\u4E0A\u4E0B\u6587\u4EA4\u63A5\u3002\u4E0B\u9762\u7684\u4EFB\u52A1\u7B80\u62A5\u5DF2\u628A\u8BE5\u5BF9\u8BDD\u63D0\u70BC\u4E3A\u53EF\u6267\u884C\u7684\u4EFB\u52A1\u4E0A\u4E0B\u6587\u2014\u2014\u628A\u5B83\u5F53\u4F5C\u65E2\u5B9A\u76EE\u6807\u4E0E\u80CC\u666F\uFF0C\u76F4\u63A5\u5728\u5176\u57FA\u7840\u4E0A\u7EE7\u7EED\uFF0C\u4E0D\u8981\u590D\u8FF0\u3002";
+/** Transfer distillation settings (resolved from the plugin config surface). */
+export interface DistillConfig {
+    /** When true (default), distill the transcript into a task brief via ctx.llm. */
+    distill: boolean;
+    /** Provider route for the distillation call; empty = auto-detect. */
+    provider: string;
+    /** Model id for the distillation call; empty = auto-detect. */
+    model: string;
+    /** Output-token cap for the final brief (single-shot / reduce). Default 4096. */
+    maxTokens?: number;
+    /** Output-token cap for each per-chunk map summary. Default 1024. */
+    chunkTokens?: number;
+}
+/** Default output-token cap for the final distillation brief. */
+export declare const DEFAULT_TRANSFER_MAX_TOKENS = 4096;
+/** Default output-token cap for one chunk summary in the map phase. */
+export declare const DEFAULT_TRANSFER_CHUNK_TOKENS = 1024;
+/** Character budget per chunk when splitting a long transcript for map-reduce. */
+export declare const CHUNK_CHAR_BUDGET = 12000;
+/** A successful distillation result. */
+export interface DistillResult {
+    brief: string;
+    provider: string;
+    model: string;
+}
+/**
+ * Split a transcript's messages into chunks of at most `budget` characters
+ * (sum of `message.content.length`), never splitting a single message: a
+ * message larger than the budget becomes its own (oversized) chunk. Streaming
+ * assistant messages are skipped (they were never completed).
+ */
+export declare function chunkTranscript(transcript: WebChatTranscript, budget?: number): WebChatMessage[][];
+/**
+ * Distill a web transcript into an executable task brief via the harness LLM.
+ * Long transcripts are distilled with map-reduce: each chunk is summarized
+ * (map, capped at `chunkTokens`), then the summaries are merged into the final
+ * brief (reduce, capped at `maxTokens`). Short transcripts take a single shot.
+ * Returns undefined (so callers fall back to the raw transcript) when the LLM
+ * service, a provider/model, or a clean completion is unavailable.
+ */
+export declare function distillTranscriptToBrief(ctx: Context, transcript: WebChatTranscript, config: DistillConfig): Promise<DistillResult | undefined>;
+/** Build a user-message surface event carrying the handoff text at a given seq. */
+export declare function transcriptUserMessageEvent(markdown: string, seq: number): SessionEvent<'user/message'>;
+/** Build the seed user-message event carrying the handoff text (seq 0). */
+export declare function transcriptSeedEvent(markdown: string): SessionEvent<'user/message'>;
+export interface TransferWorkspaceTarget {
+    /** Stable workspace id (from the registry / GUI picker); wins over `path`. */
+    workspaceId?: string;
+    /** Directory path to use as the session cwd (optionally resolves to a workspace). */
+    path?: string;
+}
+export interface TransferToSessionInput {
+    transcript: WebChatTranscript;
+    cwd?: string;
+    /** Target workspace; when set, the session is grouped under it (attached). */
+    workspace?: TransferWorkspaceTarget;
+    /**
+     * Existing harness session to CONTINUE instead of creating a new one. When
+     * set, the distilled brief (or raw transcript) is appended as a fresh user
+     * message to that session rather than seeding a new session.
+     */
+    targetSessionId?: string;
+}
+/** Resolved transfer destination: the session cwd plus an optional owning workspace. */
+export interface ResolvedTransferTarget {
+    cwd: string;
+    workspace?: Workspace;
+}
+/** The result of creating a transferred harness session. */
+export interface TransferToSessionResult {
+    sessionId: string;
+    distilled: boolean;
+    /** True when the session was attached to a workspace; false = ungrouped. */
+    attached: boolean;
+    /** Workspace id the session landed in, when attached. */
+    workspaceId?: string;
+}
+/**
+ * Create a new COLD harness session seeded with a distilled task brief (or the
+ * raw transcript when the user chooses 'raw' / distillation is unavailable),
+ * written straight through the session-persistence backend so the GUI lists it
+ * and can resume it later (no live-store ownership). When `input.workspace`
+ * names a registered workspace, the session's cwd is set to that workspace's
+ * canonical path and the session is attached to the workspace's account, so
+ * the GUI groups it under that workspace instead of "ungrouped".
+ *
+ * `mode` is the user's explicit choice; when undefined the plugin config
+ * default (`transferDistill`) applies.
+ */
+export declare function transferToHarnessSession(ctx: Context, input: TransferToSessionInput, config: DistillConfig, mode?: TransferMode): Promise<TransferToSessionResult>;
+export interface ExportTranscriptInput {
+    transcript: WebChatTranscript;
+    cwd?: string;
+}
+/** Write the transcript markdown into the target directory; returns the path. */
+export declare function exportTranscriptFile(input: ExportTranscriptInput): {
+    filePath: string;
+};

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@jaychang1989/dsh-webchat",
+  "version": "0.3.0",
+  "description": "Codex-ChatGPT-mode style web chat for DeepSeek Harness: chat through chat.deepseek.com with your DeepSeek web session instead of API billing, then transfer the conversation into a harness session as development context — or let the harness agent chat through the same web session. Maintained fork retargeted at dsh 0.2.x.",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "deepseek",
+    "webchat",
+    "chatgpt-mode",
+    "deepseek-web",
+    "harness-plugin",
+    "plugin"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jaychang1989/dsh-webchat.git"
+  },
+  "homepage": "https://github.com/jaychang1989/dsh-webchat#readme",
+  "bugs": {
+    "url": "https://github.com/jaychang1989/dsh-webchat/issues"
+  },
+  "author": "jaychang1989",
+  "contributors": [
+    "xmuwenxiang (original dsh-web-chat, Apache-2.0)"
+  ],
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22",
+    "dsh": ">=0.2.0-rc.1"
+  },
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "dependencies": {
+    "playwright-core": "^1.63.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-llm": ">=0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": ">=0.2.0-rc.1",
+    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "^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/dsh-workspace": "^0.2.0-rc.1",
+    "@types/node": "^22.20.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "^18.3.5",
+    "schemastery": "^3.18.0",
+    "typescript": "~5.7.2"
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.js.map",
+    "lib/**/*.d.ts",
+    "lib/**/*.d.ts.map",
+    "src",
+    "cordis.patch.yml",
+    "NOTICE",
+    "README.md",
+    "README.zh.md"
+  ],
+  "scripts": {
+    "test": "node --test"
+  }
+}

package/src/client/api.ts

@@ -0,0 +1,90 @@
+/**
+ * Browser-side API client for the /api/dsh-webchat route family. The only
+ * data access path the panel components use — plain fetch, same origin.
+ */
+
+import { WEBChat_API, type TransferMode, type WebChatState } from '../protocol.ts'
+
+/** Shape every /api/dsh-webchat response carries: ok plus optional error. */
+interface ApiResult {
+  ok: boolean
+  error?: string
+}
+
+/** Endpoint payloads always extend ApiResult. */
+type EndpointResult<T> = T & ApiResult
+
+async function request<T>(path: string, body?: unknown): Promise<EndpointResult<T>> {
+  const response = await fetch(path, {
+    method: body === undefined ? 'GET' : 'POST',
+    headers: body === undefined ? undefined : { 'content-type': 'application/json' },
+    body: body === undefined ? undefined : JSON.stringify(body),
+  })
+  const payload = (await response.json().catch(() => ({}))) as EndpointResult<T>
+  if (!response.ok && payload.ok !== true) {
+    return { ...payload, ok: false, error: payload.error ?? `HTTP ${response.status}` }
+  }
+  return payload
+}
+
+export class WebChatApi {
+  state(): Promise<EndpointResult<WebChatState>> {
+    return request<WebChatState>(WEBChat_API.state)
+  }
+
+  openLogin(): Promise<EndpointResult<{ ok: boolean }>> {
+    return request<{ ok: boolean }>(WEBChat_API.openLogin)
+  }
+
+  closeBrowser(): Promise<EndpointResult<{ ok: boolean }>> {
+    return request<{ ok: boolean }>(WEBChat_API.closeBrowser)
+  }
+
+  newChat(): Promise<EndpointResult<{ ok: boolean; chatId?: string }>> {
+    return request<{ ok: boolean; chatId?: string }>(WEBChat_API.newChat)
+  }
+
+  send(text: string, images?: string[]): Promise<EndpointResult<{ ok: boolean; chatId?: string }>> {
+    return request<{ ok: boolean; chatId?: string }>(WEBChat_API.send, { text, images })
+  }
+
+  stop(): Promise<EndpointResult<{ ok: boolean }>> {
+    return request<{ ok: boolean }>(WEBChat_API.stop)
+  }
+
+  setDeepThink(enabled: boolean): Promise<EndpointResult<{ ok: boolean }>> {
+    return request<{ ok: boolean }>(WEBChat_API.deepThink, { enabled })
+  }
+
+  setSearch(enabled: boolean): Promise<EndpointResult<{ ok: boolean }>> {
+    return request<{ ok: boolean }>(WEBChat_API.search, { enabled })
+  }
+
+  transfer(chatId: string, cwd?: string, mode?: TransferMode, workspaceId?: string, targetSessionId?: string): Promise<EndpointResult<{ ok: boolean; sessionId?: string; distilled?: boolean; attached?: boolean; continued?: boolean; workspaceId?: string }>> {
+    return request<{ ok: boolean; sessionId?: string; distilled?: boolean; attached?: boolean; continued?: boolean; workspaceId?: string }>(WEBChat_API.transfer, { chatId, cwd, mode, workspaceId, targetSessionId })
+  }
+
+  exportFile(chatId: string, cwd?: string): Promise<EndpointResult<{ ok: boolean; filePath?: string }>> {
+    return request<{ ok: boolean; filePath?: string }>(WEBChat_API.exportFile, { chatId, cwd })
+  }
+
+  renameChat(chatId: string, title: string): Promise<EndpointResult<{ ok: boolean }>> {
+    return request<{ ok: boolean }>(WEBChat_API.renameChat, { chatId, title })
+  }
+
+  deleteChat(chatId: string): Promise<EndpointResult<{ ok: boolean }>> {
+    return request<{ ok: boolean }>(WEBChat_API.deleteChat, { chatId })
+  }
+
+  clearChats(): Promise<EndpointResult<{ ok: boolean; count?: number }>> {
+    return request<{ ok: boolean; count?: number }>(WEBChat_API.clearChats)
+  }
+
+  webChats(): Promise<EndpointResult<{ ok: boolean; web: Array<{ title: string }>; missing: string[] }>> {
+    return request<{ ok: boolean; web: Array<{ title: string }>; missing: string[] }>(WEBChat_API.webChats)
+  }
+
+  recover(title: string): Promise<EndpointResult<{ ok: boolean; chatId?: string; title?: string; created?: boolean }>> {
+    return request<{ ok: boolean; chatId?: string; title?: string; created?: boolean }>(WEBChat_API.recover, { title })
+  }
+}

package/src/client/controller.ts

@@ -0,0 +1,43 @@
+/**
+ * Panel controller: minimal external state the sidebar entry and the panel
+ * share (open/closed), plus a tiny pub/sub. The chat data itself lives in the
+ * panel component's polling loop.
+ */
+
+export interface PanelSnapshot {
+  readonly panelOpen: boolean
+}
+
+const INITIAL: PanelSnapshot = { panelOpen: false }
+
+/** Plain pub/sub store (no React dependency — used by the DOM sidebar entry). */
+export class PanelController {
+  private snapshot: PanelSnapshot = INITIAL
+  private readonly listeners = new Set<() => void>()
+
+  getSnapshot(): PanelSnapshot {
+    return this.snapshot
+  }
+
+  subscribe(listener: () => void): () => void {
+    this.listeners.add(listener)
+    return () => { this.listeners.delete(listener) }
+  }
+
+  private set(patch: Partial<PanelSnapshot>): void {
+    this.snapshot = { ...this.snapshot, ...patch }
+    for (const listener of [...this.listeners]) listener()
+  }
+
+  open(): void {
+    if (!this.snapshot.panelOpen) this.set({ panelOpen: true })
+  }
+
+  close(): void {
+    if (this.snapshot.panelOpen) this.set({ panelOpen: false })
+  }
+
+  toggle(): void {
+    this.set({ panelOpen: !this.snapshot.panelOpen })
+  }
+}

package/src/client/css-modules.d.ts

@@ -0,0 +1,5 @@
+/** CSS Modules ambient declaration for the tsdown virtual loader. */
+declare module '*.module.css' {
+  const classes: Record<string, string>
+  export default classes
+}

package/src/client/index.ts

@@ -0,0 +1,75 @@
+/**
+ * Browser-half entry for the dsh-webchat plugin — runs inside the dsh web GUI.
+ *
+ * Registers the locale dictionaries and mounts the two DOM surfaces: the
+ * sidebar entry row (toggles the panel) and the web-chat panel in the center
+ * column. Failure policy: DOM mounting problems are logged, never thrown —
+ * the web shell fails the whole boot when a plugin apply throws, and an
+ * external plugin must not take the GUI down.
+ *
+ * Export discipline (packages/client rule): the /client surface carries what
+ * cordis loading needs plus types only — all value exports stay internal.
+ */
+import type { ClientContext, ISessions, IWorkspaces } from '@deepseek-ai/dsh-client-runtime/client'
+// Type-only: pulls the locale plugin's Context merge (ctx.locale).
+import type {} from '@deepseek-ai/dsh-client-locale/client'
+// Type-only: pulls the LocaleNamespaceMap merge table.
+import type {} from '@deepseek-ai/dsh-client-ui-slots'
+import { WebChatApi } from './api.ts'
+import { PanelController } from './controller.ts'
+import { en, zh, type WebChatKey } from './locales.ts'
+import { mountPanel } from './mount.tsx'
+import { mountSidebarEntry } from './sidebar-entry.ts'
+
+/** Locale namespace this plugin owns. */
+const NS = 'dsh-webchat'
+
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface LocaleNamespaceMap {
+    /** dsh-webchat surface copy. */
+    'dsh-webchat': WebChatKey
+  }
+}
+
+/** Required services (fiber inject waiting — the runtime must be up first). */
+export const inject = ['slots', 'locale', 'sessions', 'workspaces']
+
+/** Type-only surface (export discipline: no value exports beyond the plugin contract). */
+export type { WebChatPanelProps } from './panel/WebChatPanel.tsx'
+export type { WebChatKey } from './locales.ts'
+
+/**
+ * Mount the web-chat panel.
+ * @param ctx - client root context (locale + sessions services).
+ */
+export function apply(ctx: ClientContext): void {
+  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'dsh-webchat: dictionaries')
+
+  const controller = new PanelController()
+  const api = new WebChatApi()
+  // The host-side dsh-session package also merges `Context.sessions` into
+  // cordis types; the client runtime's ISessions is the authoritative shape
+  // here, so read it through a narrow cast rather than trusting the merged
+  // type (which the host package wins during a shared typecheck).
+  const sessions = (ctx as unknown as { sessions: ISessions }).sessions
+  const workspaces = (ctx as unknown as { workspaces: IWorkspaces }).workspaces
+  const tt = ctx.locale.bind(NS)
+  const currentCwd = (): string | undefined => {
+    const snapshot = sessions.list.getSnapshot()
+    const current = snapshot.current
+    if (current === undefined) return undefined
+    return snapshot.byId[current]?.cwd
+  }
+
+  const disposers: Array<() => void> = []
+  try {
+    disposers.push(mountSidebarEntry({ controller, tt }))
+    disposers.push(mountPanel({ sessions, workspaces, api, controller, tt, currentCwd }))
+  } catch (error) {
+    // DOM failures degrade the panel, never the GUI.
+    console.warn('[dsh-webchat] mount failed:', error)
+  }
+  ctx.effect(() => () => {
+    for (const dispose of disposers.splice(0)) dispose()
+  }, 'dsh-webchat: ui mounts')
+}

package/src/client/locales.ts

@@ -0,0 +1,172 @@
+/**
+ * dsh-webchat surface copy: zh is the key source, en mirrors every key. The
+ * key union (not an object shape) is what the locale machinery wants —
+ * LocaleKeysOf<N> intersects the namespace with `string`, so the namespace
+ * value must itself be the key union (same pattern as dsh-ssh).
+ */
+
+export const zh = {
+  'entry.label': '网页聊天',
+  'entry.tooltip': 'DeepSeek 网页端聊天（deepseek-chat，Codex ChatGPT 模式）',
+  'panel.title': 'DeepSeek 网页端聊天',
+  'status.engine.stopped': '浏览器未启动',
+  'status.engine.launching': '浏览器启动中…',
+  'status.engine.ready': '浏览器就绪',
+  'status.engine.error': '浏览器错误',
+  'status.loggedIn': '已登录',
+  'status.notLoggedIn': '未登录',
+  'status.unknown': '状态未知',
+  'action.openLogin': '打开登录窗口',
+  'action.closeBrowser': '关闭浏览器',
+  'action.newChat': '新对话',
+  'action.recover': '从网页恢复',
+  'action.refresh': '刷新',
+  'action.send': '发送',
+  'action.stop': '停止生成',
+  'action.transferToHarness': '转移到 Harness',
+  'action.exportFile': '导出为文件',
+  'transfer.mode.distill': '蒸馏为任务简报',
+  'transfer.mode.raw': '原始记录',
+  'transfer.mode.hint': '蒸馏：用 harness LLM 把对话提炼成可执行任务简报；原始记录：原样放入新会话首条消息',
+  'transfer.workspace.label': '目标工作区',
+  'transfer.workspace.ungrouped': '未分组',
+  'transfer.workspace.new': '新建工作区…',
+  'transfer.workspace.hint': '转移到所选工作区；未分组则不归入任何工作区',
+  'transfer.workspace.created': '已创建并选中工作区 {title}',
+  'transfer.workspace.createFailed': '创建工作区失败：{error}',
+  'transfer.session.label': '延续到会话',
+  'transfer.session.hint': '选择已有 harness 会话以延续（把简报作为新消息追加）；默认新建会话',
+  'transfer.session.new': '新建会话',
+  'transfer.attached.failed': '会话已创建（{sessionId}），但归入工作区失败，现为未分组',
+  'handoff.eyebrow': '交付到 Harness',
+  'toggle.deepThink': '深度思考',
+  'toggle.search': '智能搜索',
+  'toggle.deepThink.hint': '开启 R1 深度思考',
+  'toggle.search.hint': '开启联网检索',
+  'sidebar.empty': '暂无对话',
+  'chats.count': '{count} 条',
+  'role.you': '你',
+  'chat.rename': '重命名',
+  'chat.delete': '删除',
+  'chat.delete.confirm': '确认删除？',
+  'chat.clearAll': '清空全部',
+  'chat.clearAll.confirm': '确认清空全部？',
+  'chat.rename.placeholder': '输入新标题…',
+  'chat.rename.ok': '确定',
+  'chat.rename.cancel': '取消',
+  'chat.manage.hint': '管理本地保存的聊天记录（不影响网页端）',
+  'toast.rename.done': '已重命名',
+  'toast.rename.failed': '重命名失败：{error}',
+  'toast.delete.done': '已删除该对话',
+  'toast.delete.failed': '删除失败：{error}',
+  'toast.clear.done': '已清空全部对话',
+  'toast.clear.failed': '清空失败：{error}',
+  'model.deepseek-chat': 'DeepSeek',
+  'model.deepseek-reasoner': 'DeepSeek',
+  'composer.placeholder': '给 DeepSeek 发送消息…（将发送到网页端）',
+  'composer.hint': 'Enter 发送 · Shift+Enter 换行',
+  'composer.busy': '正在生成回复…',
+  'composer.notLoggedIn': '请先登录 DeepSeek 网页端',
+  'composer.attach': '图片',
+  'composer.attach.hint': '添加本地图片（绝对路径，逗号/换行分隔）',
+  'composer.attach.placeholder': '图片绝对路径，逗号或换行分隔',
+  'empty.eyebrow': 'DeepSeek 网页端 · 桥接开发',
+  'empty.title': '先聊，再交付',
+  'empty.body': '登录网页端即可开始对话；任何对话都能蒸馏成任务简报，转入 Harness 会话继续开发。',
+  'transfer.done': '已创建 Harness 会话 {sessionId}，正在为你打开…',
+  'transfer.continued': '已延续 Harness 会话 {sessionId}，正在为你打开…',
+  'transfer.failed': '转移到 Harness 失败：{error}',
+  'export.done': '已导出到工作区文件：{filePath}',
+  'export.failed': '导出失败：{error}',
+  'recover.hint': '列出网页端尚未导入本地的会话',
+  'recover.empty': '网页端没有未导入的会话',
+  'recover.done': '已恢复「{title}」',
+  'msg.empty': '（空）',
+  'msg.error': '（该回复可能不完整：{error}）',
+  'streaming': '生成中',
+} as const
+
+/** Bilingual balance enforced: en must cover every zh key. */
+export const en = {
+  'entry.label': 'Web Chat',
+  'entry.tooltip': 'DeepSeek web chat (deepseek-chat, Codex ChatGPT mode)',
+  'panel.title': 'DeepSeek Web Chat',
+  'status.engine.stopped': 'Browser not started',
+  'status.engine.launching': 'Starting browser…',
+  'status.engine.ready': 'Browser ready',
+  'status.engine.error': 'Browser error',
+  'status.loggedIn': 'Logged in',
+  'status.notLoggedIn': 'Not logged in',
+  'status.unknown': 'Unknown',
+  'action.openLogin': 'Open login window',
+  'action.closeBrowser': 'Close browser',
+  'action.newChat': 'New chat',
+  'action.recover': 'Recover from web',
+  'action.refresh': 'Refresh',
+  'action.send': 'Send',
+  'action.stop': 'Stop',
+  'action.transferToHarness': 'Transfer to Harness',
+  'action.exportFile': 'Export to file',
+  'transfer.mode.distill': 'Distill to task brief',
+  'transfer.mode.raw': 'Raw transcript',
+  'transfer.mode.hint': 'Distill: condense the chat into an executable brief via the harness LLM; Raw: replay the full transcript as the session\'s first message',
+  'transfer.workspace.label': 'Target workspace',
+  'transfer.workspace.ungrouped': 'Ungrouped',
+  'transfer.workspace.new': 'New workspace…',
+  'transfer.workspace.hint': 'Transfer into the chosen workspace; ungrouped leaves it out of any workspace',
+  'transfer.workspace.created': 'Created and selected workspace {title}',
+  'transfer.workspace.createFailed': 'Create workspace failed: {error}',
+  'transfer.session.label': 'Continue into session',
+  'transfer.session.hint': 'Continue into an existing harness session (append the brief as a new message); default creates a new one',
+  'transfer.session.new': 'New session',
+  'transfer.attached.failed': 'Session created ({sessionId}) but attaching to workspace failed; it is ungrouped',
+  'handoff.eyebrow': 'Handoff to Harness',
+  'toggle.deepThink': 'DeepThink',
+  'toggle.search': 'Search',
+  'toggle.deepThink.hint': 'Enable R1 deep think',
+  'toggle.search.hint': 'Enable web search',
+  'sidebar.empty': 'No chats',
+  'chats.count': '{count} msgs',
+  'role.you': 'You',
+  'chat.rename': 'Rename',
+  'chat.delete': 'Delete',
+  'chat.delete.confirm': 'Delete?',
+  'chat.clearAll': 'Clear all',
+  'chat.clearAll.confirm': 'Clear all?',
+  'chat.rename.placeholder': 'New title…',
+  'chat.rename.ok': 'OK',
+  'chat.rename.cancel': 'Cancel',
+  'chat.manage.hint': 'Manage locally saved transcripts (does not affect the web)',
+  'toast.rename.done': 'Renamed',
+  'toast.rename.failed': 'Rename failed: {error}',
+  'toast.delete.done': 'Chat deleted',
+  'toast.delete.failed': 'Delete failed: {error}',
+  'toast.clear.done': 'All chats cleared',
+  'toast.clear.failed': 'Clear failed: {error}',
+  'model.deepseek-chat': 'DeepSeek',
+  'model.deepseek-reasoner': 'DeepSeek',
+  'composer.placeholder': 'Message DeepSeek… (sent via the web)',
+  'composer.hint': 'Enter to send · Shift+Enter for newline',
+  'composer.busy': 'Generating…',
+  'composer.notLoggedIn': 'Sign in to DeepSeek web first',
+  'composer.attach': 'Images',
+  'composer.attach.hint': 'Attach local images (absolute paths, comma/newline separated)',
+  'composer.attach.placeholder': 'Image absolute paths (comma or newline separated)',
+  'empty.eyebrow': 'DeepSeek Web · Bridge to Code',
+  'empty.title': 'Chat first, hand off later',
+  'empty.body': 'Sign in to the web and start chatting; any chat can be distilled into a task brief and handed off to Harness.',
+  'transfer.done': 'Created Harness session {sessionId}; opening it…',
+  'transfer.continued': 'Continued Harness session {sessionId}; opening it…',
+  'transfer.failed': 'Transfer failed: {error}',
+  'export.done': 'Exported to workspace file: {filePath}',
+  'export.failed': 'Export failed: {error}',
+  'recover.hint': 'List web conversations not yet imported locally',
+  'recover.empty': 'No unimported web conversations',
+  'recover.done': 'Recovered "{title}"',
+  'msg.empty': '(empty)',
+  'msg.error': '(reply may be incomplete: {error})',
+  'streaming': 'generating',
+} satisfies Record<keyof typeof zh, string>
+
+/** Key union of the web-chat surface copy. */
+export type WebChatKey = keyof typeof zh