@qthinker/opencode-deepseek-search 0.2.1 → 0.3.0

package/src/gui/panel.tsx

@@ -3,6 +3,7 @@
 import type { JSX } from "solid-js"
 import { For, Show, createMemo, onCleanup, onMount } from "solid-js"
 import { usePlugin } from "@opencode/plugin/gui"
+import { t, type Key } from "../i18n/index.ts"
 import type { SearchStatus } from "../rpc.ts"
 import { sidebarRows, type SidebarRows } from "../status-view.ts"
 
@@ -28,9 +29,9 @@ const INK = {
   light: { on: "#1e7a4c", warn: "#8a5f08", error: "#b03931", off: "#6b7076", idle: "#6b7076", rule: "rgba(0,0,0,0.13)" },
 } as const
 
-const LABEL: Readonly<Record<Tone, string>> = {
-  on: "停用（交还原生搜索）", off: "启用（由 DeepSeek 接管）",
-  warn: "交还原生搜索", error: "重试", idle: "重试",
+const LABEL_KEY: Readonly<Record<Tone, Key>> = {
+  on: "panel.label.on", off: "panel.label.off",
+  warn: "panel.label.warn", error: "panel.label.error", idle: "panel.label.idle",
 }
 
 const ICON = { on: "arrow-undo-down", off: "globe", warn: "arrow-undo-down", error: "refresh", idle: "refresh" } as const
@@ -68,7 +69,11 @@ function help(action: string, mono: string): JSX.Element {
 
 export function DeepSeekPanel(props: DeepSeekPanelProps): JSX.Element {
   const ctx = usePlugin()
-  const rows = createMemo(() => sidebarRows({ status: props.status, error: props.error, maxColumns: Infinity }))
+  // The desktop plugin has no forced locale: the server resolves one and carries
+  // it in `status`. The first frame has no status and renders the loader, so the
+  // fallback only ever shows that.
+  const language = () => props.status?.language ?? "en"
+  const rows = createMemo(() => sidebarRows({ status: props.status, error: props.error, maxColumns: Infinity, language: language() }))
   const ink = createMemo(() => INK[ctx.appearance.mode()])
   const mono = () => ctx.appearance.font("mono")
 
@@ -95,8 +100,8 @@ export function DeepSeekPanel(props: DeepSeekPanelProps): JSX.Element {
         <h2 aria-live="polite" style={{ flex: 1, "min-width": 0, margin: 0, "font-size": "13px", "font-weight": 600, "line-height": "20px", "overflow-wrap": "anywhere" }}>
           {headline(rows().title, ink()[rows().tone])}
         </h2>
-        <ctx.ui.Tooltip value="刷新用量" placement="bottom">
-          <ctx.ui.IconButton icon="refresh" label="刷新用量" size="small" onClick={props.onRefresh} />
+        <ctx.ui.Tooltip value={t(language(), "panel.tooltip.refresh")} placement="bottom">
+          <ctx.ui.IconButton icon="refresh" label={t(language(), "panel.tooltip.refresh")} size="small" onClick={props.onRefresh} />
         </ctx.ui.Tooltip>
       </header>
 
@@ -106,7 +111,7 @@ export function DeepSeekPanel(props: DeepSeekPanelProps): JSX.Element {
         ) : (
           <div style={{ display: "flex", "align-items": "center", gap: "8px", "margin-top": "14px", opacity: 0.7 }}>
             <ctx.ui.Loader size="small" />
-            <span style={{ "font-size": "12px" }}>正在读取用量…</span>
+            <span style={{ "font-size": "12px" }}>{t(language(), "panel.loading")}</span>
           </div>
         )
       ) : (
@@ -145,7 +150,7 @@ export function DeepSeekPanel(props: DeepSeekPanelProps): JSX.Element {
       <Show when={rows().clickable && rows().tone !== "idle"}>
         <div style={{ "margin-top": "18px" }}>
           <ctx.ui.Button variant={rows().tone === "off" || rows().tone === "error" ? "contrast" : "neutral"} icon={ICON[rows().tone]} disabled={props.busy} busy={props.busy} onClick={props.onToggle}>
-            {LABEL[rows().tone]}
+            {t(language(), LABEL_KEY[rows().tone])}
           </ctx.ui.Button>
         </div>
       </Show>

package/src/i18n/en.ts

@@ -0,0 +1,151 @@
+// English copy: the source language and the fallback for every key.
+//
+// Every other locale is typed against `Key` (the keys of this table), so a
+// missing translation is a compile error rather than a silent English string.
+// Templates interpolate `{name}` through `format()` in ./index.ts; a brace group
+// that is not a known parameter (e.g. `{env:DEEPSEEK_API_KEY}`) is left alone.
+
+export const en = {
+  // ---------- sidebar states: full wording, then the short form used when the
+  // row cannot hold the full one ----------
+  "state.loading": "Loading…",
+  "state.loadingShort": "Loading…",
+  "state.failed": "Read failed",
+  "state.failedShort": "Failed",
+  "state.enabled": "Enabled",
+  "state.enabledShort": "On",
+  "state.disabled": "Disabled",
+  "state.disabledShort": "Off",
+  "state.unpatched": "websearch not taken over",
+  "state.unpatchedShort": "Not taken over",
+  "state.missingKey": "API key missing",
+  "state.missingKeyShort": "No API key",
+
+  // ---------- the clickable action on the card ----------
+  "action.disable": "Disable",
+  "action.enable": "Enable",
+  "action.release": "Release",
+  "action.retry": "Retry",
+
+  // ---------- desktop panel ----------
+  "panel.tooltip.refresh": "Refresh usage",
+  "panel.loading": "Reading usage…",
+  "panel.label.on": "Disable (release to native search)",
+  "panel.label.off": "Enable (take over with DeepSeek)",
+  "panel.label.warn": "Release to native search",
+  "panel.label.error": "Retry",
+  "panel.label.idle": "Retry",
+
+  // ---------- host chrome: commands, menus, toasts, dialogs ----------
+  "command.open": "DeepSeek: Open usage panel",
+  "command.toggle": "DeepSeek: Enable/disable search takeover",
+  "menu.description": "Search usage and the takeover switch",
+  "toast.openSessionFirst": "Open a session first",
+  "toast.statusMalformed": "Status payload has the wrong shape",
+  "toast.modeMalformed": "Mode switch result has the wrong shape",
+  "dialog.title": "DeepSeek search",
+  "dialog.enable": "Enable",
+  "dialog.enableDesc": "Take over the built-in websearch",
+  "dialog.disable": "Disable",
+  "dialog.disableDesc": "Return the built-in websearch to the host",
+  "dialog.refresh": "Refresh",
+  "dialog.refreshDesc": "Re-read status and usage",
+
+  // ---------- deepseek_mode output ----------
+  "mode.report": "Current search backend: {mode} (source: {source}){suffix}",
+  "mode.source.override": "deepseek_mode switch, persisted",
+  "mode.source.config": "config file options.mode",
+  "mode.suffix.patched": " · built-in websearch is served by DeepSeek",
+  "mode.suffix.notPatched": " · built-in websearch was not found, so nothing is taken over",
+  "mode.suffix.native": " · built-in websearch stays native",
+  "mode.notFound":
+    "Built-in {tool} tool not found; it cannot be switched at runtime. " +
+    'Set options.mode to "{mode}" in the config file instead.',
+  "mode.configCleared": "Persisted switch cleared; back to the config file ({mode}).",
+  "mode.persisted":
+    "Persisted: still {mode} after restarting OpenCode. " +
+    'To return to the config file, call deepseek_mode with mode: "config".',
+  "mode.statusOnly": "status only reports the current mode; it does not switch.",
+  "mode.invalid": "mode must be status / deepseek / native / config, got: {raw}",
+
+  // ---------- tool progress / bookkeeping ----------
+  "progress.fetch": "DeepSeek Fetch: fetching {url}",
+  "fetch.source": "Source: {url}",
+  "usage.reset": "Local stats cleared.",
+
+  // ---------- deepseek_usage report ----------
+  "usage.report.title":
+    "DeepSeek usage (local counts, estimated per successful request; current mode {mode}; ¥{price}/1000 requests)",
+  "usage.report.line":
+    "{label}: searches {search} · fetches {fetch} · empty/failed {skipped} (empty {empty} / failed {failed}) · est. {cost}",
+  "usage.report.note":
+    "Note: empty and failed requests are not billed; DeepSeek's account-side bill is authoritative, and these counts exclude other machines or tools.",
+  "usage.label.today": "Today",
+  "usage.label.month": "Month",
+  "usage.label.total": "Total",
+  "usage.summary.line": "Search {search} · Fetch {fetch} · empty/failed {skipped} · {cost}",
+
+  // ---------- errors ----------
+  "error.missingKey":
+    "DeepSeek API key is not configured. Set the DEEPSEEK_API_KEY environment variable " +
+    '(PowerShell: [Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY","sk-...","User")), ' +
+    'or write "apiKey": "{env:DEEPSEEK_API_KEY}" in the plugin options, then restart opencode.',
+  "error.http.400":
+    "Invalid DeepSeek request parameters (400){upstream}. Queries must be 1–128 characters; " +
+    "Fetch URLs must be valid absolute http(s) URLs.",
+  "error.http.401":
+    "Invalid DeepSeek API key (401){upstream}. Check the DEEPSEEK_API_KEY environment variable or options.apiKey.",
+  "error.http.402": "Insufficient DeepSeek account balance (402); failed requests are not billed. Top up and try again.",
+  "error.http.403": "DeepSeek Fetch was blocked by the target site's security policy (403){upstream}.{hint}",
+  "error.http.404": "DeepSeek could not extract the page body (404){upstream}. Check that the link is reachable.{hint}",
+  "error.http.408": "DeepSeek request timed out (408); one backoff retry also failed. Try again later.",
+  "error.http.413": "DeepSeek request body too large (413). Shorten the input.",
+  "error.http.429":
+    "DeepSeek rate limit hit (429; account limits: Search 100 QPS / Fetch 25 QPS); " +
+    "one backoff retry also failed. Try again later.",
+  "error.http.5xx":
+    "DeepSeek server error ({status}); one backoff retry also failed. " +
+    'You can set options.mode to "native" to use native search for now.',
+  "error.http.other": "DeepSeek request failed (HTTP {status}){upstream}",
+  "error.http.fetchHint": " You can use the built-in webfetch tool for this page.",
+  "error.parse": "DeepSeek returned an unparseable response (HTTP {status}). Try again later.",
+  "error.aborted": "DeepSeek request cancelled.",
+  "error.timeout": "DeepSeek request timed out ({seconds}s). Try again.",
+  "error.network": "Cannot reach {base} (network error: {message}). Check your network or proxy settings.",
+  "error.validate.queryEmpty": "Empty query: DeepSeek Search needs a non-empty query (1–128 characters).",
+  "error.validate.queryLong": "Query too long ({length} characters, limit {max}); shorten it and retry.",
+  "error.validate.urlScheme": 'Invalid URL: "{url}". DeepSeek Fetch only supports absolute http/https URLs.',
+  "error.validate.urlLong": "URL too long ({length} > {max} characters).",
+  "error.validate.urlHost": 'URL has no host: "{url}".',
+  "error.validate.urlUserinfo": "URL must not contain a username/password (userinfo).",
+  "error.validate.urlParse": 'Cannot parse URL: "{url}".',
+  "error.fetch.truncated":
+    "[DeepSeek Fetch truncated] The page is {raw} characters; the limit is {max}, so only the first {max} characters are kept.",
+} as const
+
+export type Key = keyof typeof en
+/** One locale's complete table: every key, no extras. */
+export type Messages = Record<Key, string>
+
+/**
+ * Usage-row ladder, richest first. Each entry is a complete row, so nothing is
+ * ever left dangling and no number is ever cut from its unit. `{label}` is the
+ * localized period label; `Search`/`Fetch` stay English in every language.
+ */
+export const enUsageForms: readonly string[] = [
+  "{label}  Search {search}  Fetch {fetch}  {cost}",
+  "{label} Search {search} Fetch {fetch} {cost}",
+  "{label}  Search {search}  Fetch {fetch}",
+  "{label} Search {search} Fetch {fetch}",
+  "{label}  {search}S  {fetch}F  {cost}",
+  "{label}  {search}S  {fetch}F",
+  "{label}  {search}S",
+]
+
+/** Missing-key hint ladder, richest first. The env var name is always present. */
+export const enHintForms: readonly string[] = [
+  "Set DEEPSEEK_API_KEY and restart",
+  "Set DEEPSEEK_API_KEY",
+  "Set API KEY",
+  "Set KEY",
+]

package/src/i18n/index.ts

@@ -0,0 +1,87 @@
+// The plugin's only copy source and the language resolver.
+//
+// The server resolves one `Language` at setup, puts it in the RPC `status`
+// payload, and the tools and both sidebars render with it — so the chat output
+// and the two sidebars can never disagree. Pure data and pure functions: no
+// plugin or host imports, so every runtime can load this module.
+
+import { isLanguage, type Language } from "../rpc.ts"
+import { en, enHintForms, enUsageForms, type Key, type Messages } from "./en.ts"
+import { ja, jaHintForms, jaUsageForms } from "./ja.ts"
+import { zh, zhHintForms, zhUsageForms } from "./zh.ts"
+
+export type { Key, Messages }
+
+/** One language's complete copy: strings plus the ladders that take widths. */
+export interface LocalePack {
+  readonly messages: Messages
+  /** Usage-row ladder, richest first; see `en.ts`. */
+  readonly usageForms: readonly string[]
+  /** Missing-key hint ladder, richest first. */
+  readonly hintForms: readonly string[]
+}
+
+const PACKS: Readonly<Record<Language, LocalePack>> = {
+  en: { messages: en, usageForms: enUsageForms, hintForms: enHintForms },
+  ja: { messages: ja, usageForms: jaUsageForms, hintForms: jaHintForms },
+  "zh-CN": { messages: zh, usageForms: zhUsageForms, hintForms: zhHintForms },
+}
+
+export function pack(language: Language): LocalePack {
+  return PACKS[language]
+}
+
+export function messages(language: Language): Messages {
+  return PACKS[language].messages
+}
+
+export type Params = Readonly<Record<string, string | number>>
+
+/**
+ * Fill `{name}` placeholders. A brace group that is not a supplied parameter is
+ * left verbatim, which keeps literals such as `{env:DEEPSEEK_API_KEY}` intact.
+ */
+export function format(template: string, params: Params = {}): string {
+  return template.replace(/\{(\w+)\}/g, (match, name: string) => (name in params ? String(params[name]) : match))
+}
+
+/** One message. An unknown key falls back to the key itself, never to a crash. */
+export function t(language: Language, key: Key, params?: Params): string {
+  const table: Readonly<Record<string, string>> = messages(language)
+  const template = table[key]
+  return template === undefined ? key : format(template, params)
+}
+
+// ---------- language resolution ----------
+
+/** The only environment the resolver looks at; both are POSIX locale names. */
+export interface LanguageEnv {
+  readonly LC_ALL?: string
+  readonly LANG?: string
+}
+
+export interface LanguagePick {
+  readonly language: Language
+  /** The raw option value when it was not a known language; the caller warns. */
+  readonly problem?: string
+}
+
+/**
+ * `options.language` wins; otherwise `LC_ALL` (which overrides `LANG` per
+ * POSIX), then `LANG`, then English. Prefix matching keeps `ja_JP.UTF-8` and
+ * `zh_CN.UTF-8` working without an alias table; anything else is English.
+ */
+export function resolveLanguage(option: unknown, env: LanguageEnv = {}): LanguagePick {
+  if (option !== undefined && option !== null && option !== "") {
+    if (isLanguage(option)) return { language: option }
+    return { language: fromEnv(env), problem: String(option) }
+  }
+  return { language: fromEnv(env) }
+}
+
+function fromEnv(env: LanguageEnv): Language {
+  const raw = (env.LC_ALL?.trim() || env.LANG?.trim() || "").toLowerCase()
+  if (raw.startsWith("ja")) return "ja"
+  if (raw.startsWith("zh")) return "zh-CN"
+  return "en"
+}

package/src/i18n/ja.ts

@@ -0,0 +1,138 @@
+// 日本語の文言。状態語は体言止め、文はです・ます調で短く。
+//
+// キー集合は ./en.ts の `Key` で型付けされており、欠けても増えてもコンパイル
+// エラーになる。製品名・Search / Fetch は英語のまま使う。
+
+import type { Messages } from "./en.ts"
+
+export const ja = {
+  // ---------- サイドバーの状態：完全な語と、幅が足りないときの短縮語 ----------
+  "state.loading": "読み込み中…",
+  "state.loadingShort": "読み込み中…",
+  "state.failed": "読み込み失敗",
+  "state.failedShort": "失敗",
+  "state.enabled": "有効",
+  "state.enabledShort": "有効",
+  "state.disabled": "無効",
+  "state.disabledShort": "無効",
+  "state.unpatched": "websearch 未引き継ぎ",
+  "state.unpatchedShort": "未引き継ぎ",
+  "state.missingKey": "APIキー未設定",
+  "state.missingKeyShort": "キー未設定",
+
+  // ---------- カード上の操作 ----------
+  "action.disable": "停止",
+  "action.enable": "有効化",
+  "action.release": "返上",
+  "action.retry": "再試行",
+
+  // ---------- デスクトップパネル ----------
+  "panel.tooltip.refresh": "使用量を更新",
+  "panel.loading": "使用量を読み込み中…",
+  "panel.label.on": "停止（ネイティブ検索に返上）",
+  "panel.label.off": "有効化（DeepSeek が引き継ぐ）",
+  "panel.label.warn": "ネイティブ検索に返上",
+  "panel.label.error": "再試行",
+  "panel.label.idle": "再試行",
+
+  // ---------- ホスト側の表示：コマンド、メニュー、トースト、ダイアログ ----------
+  "command.open": "DeepSeek: 使用量パネルを開く",
+  "command.toggle": "DeepSeek: 検索の引き継ぎを切り替え",
+  "menu.description": "検索使用量と引き継ぎスイッチ",
+  "toast.openSessionFirst": "先にセッションを開いてください",
+  "toast.statusMalformed": "状態データの形式が不正です",
+  "toast.modeMalformed": "モード切り替え結果の形式が不正です",
+  "dialog.title": "DeepSeek 検索",
+  "dialog.enable": "有効化",
+  "dialog.enableDesc": "組み込み websearch を引き継ぐ",
+  "dialog.disable": "停止",
+  "dialog.disableDesc": "組み込み websearch をホストに返上",
+  "dialog.refresh": "更新",
+  "dialog.refreshDesc": "状態と使用量を再読み込み",
+
+  // ---------- deepseek_mode の出力 ----------
+  "mode.report": "現在の検索バックエンド: {mode}（ソース: {source}）{suffix}",
+  "mode.source.override": "deepseek_mode スイッチ（永続化済み）",
+  "mode.source.config": "設定ファイルの options.mode",
+  "mode.suffix.patched": " · 組み込み websearch は DeepSeek が処理",
+  "mode.suffix.notPatched": " · 組み込み websearch が見つからず、引き継げませんでした",
+  "mode.suffix.native": " · 組み込み websearch はネイティブのまま",
+  "mode.notFound":
+    "組み込み {tool} ツールが見つからないため、実行中は切り替えできません。" +
+    "設定ファイルで options.mode を「{mode}」にしてください。",
+  "mode.configCleared": "永続化スイッチを削除し、設定ファイルの値（{mode}）に戻しました。",
+  "mode.persisted":
+    "永続化しました: OpenCode を再起動しても {mode} のままです。" +
+    "設定ファイルの値に戻すには、deepseek_mode に mode: \"config\" を渡してください。",
+  "mode.statusOnly": "status は現在のモードを読むだけで、切り替えは行いません。",
+  "mode.invalid": "mode は status / deepseek / native / config のいずれかです。受信値: {raw}",
+
+  // ---------- 進捗と記録の通知 ----------
+  "progress.fetch": "DeepSeek Fetch 取得中: {url}",
+  "fetch.source": "出典: {url}",
+  "usage.reset": "ローカル統計をクリアしました。",
+
+  // ---------- deepseek_usage のレポート ----------
+  "usage.report.title": "DeepSeek 使用量（ローカル集計・成功リクエストで概算。現在のモード {mode}、単価 ¥{price}/1000回）",
+  "usage.report.line":
+    "{label}: 検索 {search} · 取得 {fetch} · 空/失敗 {skipped}（空結果 {empty} / 失敗 {failed}）· 推定 {cost}",
+  "usage.report.note":
+    "注: 空結果と失敗は課金されません。請求は DeepSeek のアカウント側が正で、この集計は他のマシンや他ツールの呼び出しを含みません。",
+  "usage.label.today": "今日",
+  "usage.label.month": "今月",
+  "usage.label.total": "合計",
+  "usage.summary.line": "検索 {search} · 取得 {fetch} · 空/失敗 {skipped} · {cost}",
+
+  // ---------- エラー ----------
+  "error.missingKey":
+    "DeepSeek APIキーが未設定です。環境変数 DEEPSEEK_API_KEY を設定してください" +
+    "（PowerShell: [Environment]::SetEnvironmentVariable(\"DEEPSEEK_API_KEY\",\"sk-...\",\"User\")）。" +
+    "またはプラグイン options に \"apiKey\": \"{env:DEEPSEEK_API_KEY}\" を書き、opencode を再起動してください。",
+  "error.http.400":
+    "DeepSeek のリクエストパラメータが不正です（400）{upstream}。検索語は 1〜128 文字、Fetch の URL は有効な http(s) 絶対 URL が必要です。",
+  "error.http.401": "DeepSeek APIキーが無効です（401）{upstream}。DEEPSEEK_API_KEY 環境変数か options.apiKey を確認してください。",
+  "error.http.402": "DeepSeek アカウントの残高が不足しています（402）。失敗したリクエストは課金されません。チャージ後に再試行してください。",
+  "error.http.403": "DeepSeek Fetch は対象サイトのセキュリティポリシーに拒否されました（403）{upstream}。{hint}",
+  "error.http.404": "DeepSeek はこのリンクの本文を抽出できませんでした（404）{upstream}。リンクにアクセスできるか確認してください。{hint}",
+  "error.http.408": "DeepSeek リクエストがタイムアウトしました（408）。バックオフ再試行も失敗しました。しばらくしてから再試行してください。",
+  "error.http.413": "DeepSeek リクエストの本文が大きすぎます（413）。入力を短くしてください。",
+  "error.http.429":
+    "DeepSeek のレート制限に達しました（429。アカウント上限: Search 100 QPS / Fetch 25 QPS）。" +
+    "バックオフ再試行も失敗しました。しばらくしてから再試行してください。",
+  "error.http.5xx":
+    "DeepSeek のサーバーエラーです（{status}）。バックオフ再試行も失敗しました。" +
+    "一時的に options.mode を \"native\" にするとネイティブ検索を使えます。",
+  "error.http.other": "DeepSeek リクエストが失敗しました（HTTP {status}）{upstream}",
+  "error.http.fetchHint": " このページには組み込み webfetch ツールを使えます。",
+  "error.parse": "DeepSeek が解析できないレスポンスを返しました（HTTP {status}）。しばらくしてから再試行してください。",
+  "error.aborted": "DeepSeek リクエストはキャンセルされました。",
+  "error.timeout": "DeepSeek リクエストがタイムアウトしました（{seconds} 秒）。再試行してください。",
+  "error.network": "{base} に接続できません（ネットワークエラー: {message}）。ネットワークかプロキシの設定を確認してください。",
+  "error.validate.queryEmpty": "検索語が空です。DeepSeek Search には空でない query（1〜128 文字）が必要です。",
+  "error.validate.queryLong": "検索語が長すぎます（{length} 文字、上限 {max}）。短くして再試行してください。",
+  "error.validate.urlScheme": "無効な URL:「{url}」。DeepSeek Fetch は http/https の絶対 URL のみ対応します。",
+  "error.validate.urlLong": "URL が長すぎます（{length} > {max} 文字）。",
+  "error.validate.urlHost": "URL にホスト名がありません:「{url}」。",
+  "error.validate.urlUserinfo": "URL にユーザー名/パスワード（userinfo）を含められません。",
+  "error.validate.urlParse": "URL を解析できません:「{url}」。",
+  "error.fetch.truncated": "[DeepSeek Fetch 切り詰め] 元の本文は {raw} 文字で、上限 {max} 文字を超えています。先頭 {max} 文字のみ保持しました。",
+} satisfies Messages
+
+/** 使用量行の階段：完全な行から最も短い行まで。各段は単体で完結する。 */
+export const jaUsageForms: readonly string[] = [
+  "{label}  Search {search}  Fetch {fetch}  {cost}",
+  "{label} Search {search} Fetch {fetch} {cost}",
+  "{label}  Search {search}  Fetch {fetch}",
+  "{label} Search {search} Fetch {fetch}",
+  "{label}  {search}S  {fetch}F  {cost}",
+  "{label}  {search}S  {fetch}F",
+  "{label}  {search}S",
+]
+
+/** APIキー未設定のヒント階段：最後の段でも何を設定するかは残る。 */
+export const jaHintForms: readonly string[] = [
+  "DEEPSEEK_API_KEY を設定して再起動",
+  "DEEPSEEK_API_KEY を設定",
+  "API KEY を設定",
+  "KEY 設定",
+]

package/src/i18n/zh.ts

@@ -0,0 +1,133 @@
+// 简体中文文案（现有界面文案的升格版，措辞尽量保持原样）。
+//
+// 键集合由 ./en.ts 的 `Key` 约束：缺键或多键都会编译失败。
+
+import type { Messages } from "./en.ts"
+
+export const zh = {
+  // ---------- 侧边栏状态：完整措辞与窄宽度下的短式 ----------
+  "state.loading": "正在读取…",
+  "state.loadingShort": "正在读取…",
+  "state.failed": "读取失败",
+  "state.failedShort": "读取失败",
+  "state.enabled": "已启用",
+  "state.enabledShort": "已启用",
+  "state.disabled": "已停用",
+  "state.disabledShort": "已停用",
+  "state.unpatched": "未接管内置 websearch",
+  "state.unpatchedShort": "未接管",
+  "state.missingKey": "未配置 API Key",
+  "state.missingKeyShort": "缺 API Key",
+
+  // ---------- 卡片上的可点击动作 ----------
+  "action.disable": "停用",
+  "action.enable": "启用",
+  "action.release": "交还",
+  "action.retry": "重试",
+
+  // ---------- 桌面面板 ----------
+  "panel.tooltip.refresh": "刷新用量",
+  "panel.loading": "正在读取用量…",
+  "panel.label.on": "停用（交还原生搜索）",
+  "panel.label.off": "启用（由 DeepSeek 接管）",
+  "panel.label.warn": "交还原生搜索",
+  "panel.label.error": "重试",
+  "panel.label.idle": "重试",
+
+  // ---------- 宿主 chrome：命令、菜单、toast、对话框 ----------
+  "command.open": "DeepSeek: 打开统计面板",
+  "command.toggle": "DeepSeek: 启用/停用搜索接管",
+  "menu.description": "搜索用量与接管开关",
+  "toast.openSessionFirst": "请先打开一个会话",
+  "toast.statusMalformed": "状态数据格式不符",
+  "toast.modeMalformed": "模式切换结果格式不符",
+  "dialog.title": "DeepSeek 搜索",
+  "dialog.enable": "启用",
+  "dialog.enableDesc": "接管内置 websearch",
+  "dialog.disable": "停用",
+  "dialog.disableDesc": "把内置 websearch 交还宿主",
+  "dialog.refresh": "刷新",
+  "dialog.refreshDesc": "重新读取状态与统计",
+
+  // ---------- deepseek_mode 输出 ----------
+  "mode.report": "当前搜索后端: {mode}（来源: {source}）{suffix}",
+  "mode.source.override": "deepseek_mode 开关，已持久化",
+  "mode.source.config": "配置文件 options.mode",
+  "mode.suffix.patched": " · 内置 websearch 已由 DeepSeek 接管",
+  "mode.suffix.notPatched": " · 未找到内置 websearch 工具，实际未能接管",
+  "mode.suffix.native": " · 内置 websearch 保持原生",
+  "mode.notFound":
+    "未找到内置 {tool} 工具，无法在运行时切换。" +
+    '请改用配置文件把 options.mode 设为 "{mode}"。',
+  "mode.configCleared": "已清除持久化开关，回到配置文件设置（{mode}）。",
+  "mode.persisted":
+    "已持久化：重启 OpenCode 后仍为 {mode}。" +
+    '要恢复配置文件设置，调用 deepseek_mode 并传 mode: "config"。',
+  "mode.statusOnly": "status 只读取当前模式，不做切换。",
+  "mode.invalid": "mode 只能是 status / deepseek / native / config，收到：{raw}",
+
+  // ---------- 工具进度与记账提示 ----------
+  "progress.fetch": "DeepSeek Fetch 抓取中: {url}",
+  "fetch.source": "来源: {url}",
+  "usage.reset": "已清零本地统计。",
+
+  // ---------- deepseek_usage 报告 ----------
+  "usage.report.title": "DeepSeek 用量（本地统计，按成功请求估算；当前模式 {mode}；单价 ¥{price}/1000 次）",
+  "usage.report.line":
+    "{label}: 搜索 {search} · 抓取 {fetch} · 空/失 {skipped}（空结果 {empty} / 失败 {failed}）· 估算 {cost}",
+  "usage.report.note": "说明：空结果与失败请求不计费；DeepSeek 以账号侧账单为准，本统计不含其他机器或其他工具的调用。",
+  "usage.label.today": "今日",
+  "usage.label.month": "本月",
+  "usage.label.total": "累计",
+  "usage.summary.line": "搜索 {search} · 抓取 {fetch} · 空/失 {skipped} · {cost}",
+
+  // ---------- 错误信息 ----------
+  "error.missingKey":
+    "未配置 DeepSeek API Key：请设置环境变量 DEEPSEEK_API_KEY" +
+    '（PowerShell: [Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY","sk-...","User")），' +
+    '或在插件 options 中写 "apiKey": "{env:DEEPSEEK_API_KEY}"，然后重启 opencode。',
+  "error.http.400":
+    "DeepSeek 请求参数无效（400）{upstream}。搜索词需 1~128 字符；Fetch 的 URL 需为合法的 http(s) 绝对地址。",
+  "error.http.401": "DeepSeek API Key 无效（401）{upstream}。请检查 DEEPSEEK_API_KEY 环境变量或 options.apiKey。",
+  "error.http.402": "DeepSeek 账户余额不足（402），失败请求不计费。请充值后重试。",
+  "error.http.403": "DeepSeek Fetch 被目标站点安全策略拒绝（403）{upstream}。{hint}",
+  "error.http.404": "DeepSeek 无法提取该链接的正文（404）{upstream}。请确认链接可访问。{hint}",
+  "error.http.408": "DeepSeek 请求超时（408），已退避重试一次仍失败。请稍后重试。",
+  "error.http.413": "DeepSeek 请求体过大（413）。请缩短输入。",
+  "error.http.429": "DeepSeek 触发限速（429，账号级 Search 100 QPS / Fetch 25 QPS），已退避重试一次仍失败。请稍后再试。",
+  "error.http.5xx":
+    "DeepSeek 服务端错误（{status}），已退避重试一次仍失败。可把插件 options.mode 改为 \"native\" 暂用原生搜索。",
+  "error.http.other": "DeepSeek 请求失败（HTTP {status}）{upstream}",
+  "error.http.fetchHint": " 可改用内置 webfetch 工具抓取该页面。",
+  "error.parse": "DeepSeek 返回了无法解析的响应（HTTP {status}）。请稍后重试。",
+  "error.aborted": "DeepSeek 请求已取消。",
+  "error.timeout": "DeepSeek 请求超时（{seconds} 秒），请重试。",
+  "error.network": "无法连接 {base}（网络错误：{message}）。请检查网络或代理设置。",
+  "error.validate.queryEmpty": "搜索词为空：DeepSeek Search 需要非空 query（1~128 字符）。",
+  "error.validate.queryLong": "搜索词过长（{length} 字符，上限 {max}），请精简后重试。",
+  "error.validate.urlScheme": "无效 URL：「{url}」。DeepSeek Fetch 仅支持 http/https 绝对地址。",
+  "error.validate.urlLong": "URL 过长（{length} > {max} 字符）。",
+  "error.validate.urlHost": "URL 缺少主机名：「{url}」。",
+  "error.validate.urlUserinfo": "URL 不能包含用户名/密码（userinfo）。",
+  "error.validate.urlParse": "无法解析 URL：「{url}」。",
+  "error.fetch.truncated": "[DeepSeek Fetch 截断提示] 原文共 {raw} 字符，超出上限 {max}，此处仅保留前 {max} 字符。",
+} satisfies Messages
+
+/** 用量行阶梯：从最完整到最紧凑；每一条都是完整的一行。 */
+export const zhUsageForms: readonly string[] = [
+  "{label}  Search {search}  Fetch {fetch}  {cost}",
+  "{label} Search {search} Fetch {fetch} {cost}",
+  "{label}  Search {search}  Fetch {fetch}",
+  "{label} Search {search} Fetch {fetch}",
+  "{label}  {search}S  {fetch}F  {cost}",
+  "{label}  {search}S  {fetch}F",
+  "{label}  {search}S",
+]
+
+/** 缺 key 提示阶梯：最后一档仍然指明要设置什么。 */
+export const zhHintForms: readonly string[] = [
+  "设置 DEEPSEEK_API_KEY 后重启",
+  "设置 API KEY 后重启",
+  "设置 API KEY",
+  "设置 KEY",
+]