@qthinker/opencode-deepseek-search 0.2.0 → 0.3.0

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",
+]

package/src/index.ts

@@ -24,6 +24,7 @@ import {
   validateUrl,
   type SearchResult,
 } from "./deepseek.ts"
+import { resolveLanguage, t } from "./i18n/index.ts"
 import { DeepSeekRpc, type ModeSwitchResult, type SearchStatus } from "./rpc.ts"
 import {
   USAGE_KEY,
@@ -56,11 +57,13 @@ const SEARCH_TOOL_DESCRIPTION =
   "Search the web using DeepSeek Search. Use this for current information beyond knowledge cutoff." +
   `\n\nThe current year is ${new Date().getFullYear()}. Use this year when searching for recent information or current events.`
 
-function readModeAction(input: unknown): ModeAction {
+// Pure parser: the caller decides how to surface an invalid value (tool error
+// vs. RPC result), so the message can be localized at that call site.
+function readModeAction(input: unknown): { action: ModeAction } | { invalid: string } {
   const raw = (input as { mode?: unknown } | undefined)?.mode
-  if (raw === undefined || raw === null || raw === "") return "status"
-  if (raw === "status" || raw === "deepseek" || raw === "native" || raw === "config") return raw
-  throw new Error(`mode 只能是 status / deepseek / native / config，收到：${String(raw)}`)
+  if (raw === undefined || raw === null || raw === "") return { action: "status" }
+  if (raw === "status" || raw === "deepseek" || raw === "native" || raw === "config") return { action: raw }
+  return { invalid: String(raw) }
 }
 
 
@@ -95,6 +98,18 @@ export default Plugin.define({
   id: "deepseek-search",
   async setup(ctx) {
     const opt = (ctx.options ?? {}) as Record<string, unknown>
+    // Resolved once per setup: every tool output and the RPC status payload use
+    // this single language, so surfaces can never disagree.
+    const pick = resolveLanguage(opt.language, {
+      LC_ALL: readEnvValue("LC_ALL"),
+      LANG: readEnvValue("LANG"),
+    })
+    const language = pick.language
+    if (pick.problem !== undefined)
+      console.error(
+        `[deepseek-search] invalid language option ${JSON.stringify(pick.problem)}; ` +
+          `valid values: en / ja / zh-CN. Using ${language}.`,
+      )
     const configMode: Mode = str(opt.mode) === "native" ? "native" : "deepseek"
     // Precedence: a persisted `deepseek_mode` switch wins over the config file
     // until it is cleared with `mode: "config"`.
@@ -143,10 +158,10 @@ export default Plugin.define({
     }
 
     const runSearch = async (query: string, signal: AbortSignal): Promise<SearchResult[]> => {
-      const problem = validateQuery(query)
+      const problem = validateQuery(query, language)
       if (problem) throw new Error(problem)
       try {
-        const results = await deepseekSearch(query, apiKey, count, signal)
+        const results = await deepseekSearch(query, apiKey, count, language, signal)
         tally(results.length > 0 ? "search" : "empty")
         return results
       } catch (e) {
@@ -176,7 +191,7 @@ export default Plugin.define({
 
     const deepseekSearchExecute = async (input: unknown, context: ToolContext): Promise<ToolResult> => {
       const query = readQuery(input)
-      const problem = validateQuery(query)
+      const problem = validateQuery(query, language)
       if (problem) throw new Error(problem)
       await ctx.permission.assert({
         sessionID: context.sessionID,
@@ -217,38 +232,38 @@ export default Plugin.define({
       return true
     }
 
-    const describeMode = (): string =>
-      `当前搜索后端: ${mode}（来源: ${overrideMode ? "deepseek_mode 开关，已持久化" : "配置文件 options.mode"}）` +
-      (mode === "deepseek"
-        ? searchToolPatched
-          ? " · 内置 websearch 已由 DeepSeek 接管"
-          : " · 未找到内置 websearch 工具，实际未能接管"
-        : " · 内置 websearch 保持原生")
+    const describeMode = (): string => {
+      const source = overrideMode ? t(language, "mode.source.override") : t(language, "mode.source.config")
+      const suffix =
+        mode === "deepseek"
+          ? searchToolPatched
+            ? t(language, "mode.suffix.patched")
+            : t(language, "mode.suffix.notPatched")
+          : t(language, "mode.suffix.native")
+      return t(language, "mode.report", { mode, source, suffix })
+    }
 
     // Shared by the `deepseek_mode` tool and the RPC `setMode` method. The
     // returned strings are the tool's documented output, word for word.
     const switchMode = async (action: Exclude<ModeAction, "status">): Promise<string> => {
       if (!pristine) {
-        return (
-          `未找到内置 ${SEARCH_TOOL} 工具，无法在运行时切换。` +
-          `请改用配置文件把 options.mode 设为 "${action === "config" ? configMode : action}"。`
-        )
+        return t(language, "mode.notFound", {
+          tool: SEARCH_TOOL,
+          mode: action === "config" ? configMode : action,
+        })
       }
       if (action === "config") {
         await ctx.storage.remove(MODE_KEY)
         overrideMode = undefined
         await applySearchMode(configMode)
         notifyChanged()
-        return `${describeMode()}\n\n已清除持久化开关，回到配置文件设置（${configMode}）。`
+        return `${describeMode()}\n\n${t(language, "mode.configCleared", { mode: configMode })}`
       }
       await ctx.storage.set(MODE_KEY, action)
       overrideMode = action
       await applySearchMode(action)
       notifyChanged()
-      return (
-        `${describeMode()}\n\n已持久化：重启 OpenCode 后仍为 ${action}。` +
-        '要恢复配置文件设置，调用 deepseek_mode 并传 mode: "config"。'
-      )
+      return `${describeMode()}\n\n${t(language, "mode.persisted", { mode: action })}`
     }
 
     // ---------- tools ----------
@@ -289,11 +304,11 @@ export default Plugin.define({
         },
         execute: async (input, context) => {
           const url = String((input as { url?: unknown } | undefined)?.url ?? "").trim()
-          const problem = validateUrl(url)
+          const problem = validateUrl(url, language)
           if (problem) throw new Error(problem)
           try {
-            await context.progress({ status: `DeepSeek Fetch 抓取中: ${url}` })
-            const result = await deepseekFetch(url, apiKey, fetchMaxChars, context.signal)
+            await context.progress({ status: t(language, "progress.fetch", { url }) })
+            const result = await deepseekFetch(url, apiKey, fetchMaxChars, language, context.signal)
             tally(result.empty ? "empty" : "fetch")
             return {
               content: result.markdown,
@@ -322,10 +337,10 @@ export default Plugin.define({
         execute: async (input) => {
           const reset = Boolean((input as { reset?: unknown } | undefined)?.reset)
           const report = await withLedger(async (ledger) => {
-            const text = formatUsage(ledger, pricePerThousand, mode)
+            const text = formatUsage(ledger, pricePerThousand, mode, language)
             if (!reset) return text
             await ctx.storage.set(USAGE_KEY, emptyLedger())
-            return `${text}\n\n已清零本地统计。`
+            return `${text}\n\n${t(language, "usage.reset")}`
           })
           return { content: report }
         },
@@ -351,7 +366,9 @@ export default Plugin.define({
           additionalProperties: false,
         },
         execute: async (input) => {
-          const action = readModeAction(input)
+          const parsed = readModeAction(input)
+          if ("invalid" in parsed) throw new Error(t(language, "mode.invalid", { raw: parsed.invalid }))
+          const action = parsed.action
           if (action === "status") return { content: describeMode() }
           return { content: await switchMode(action) }
         },
@@ -372,7 +389,8 @@ export default Plugin.define({
             patched: searchToolPatched,
             hasKey: Boolean(apiKey),
             pricePerThousand,
-            ...usageSummaryLines(ledger, todayKey),
+            language,
+            ...usageSummaryLines(ledger, language, todayKey),
             // Same ledger read as the strings above, exposed as numbers so the
             // sidebars can lay them out for their own width.
             counts: {
@@ -384,13 +402,12 @@ export default Plugin.define({
         }),
       // The input is plain JSON Schema, hence `unknown`: report, never throw.
       setMode: async (input: unknown): Promise<ModeSwitchResult> => {
-        let action: ModeAction
-        try {
-          action = readModeAction(input)
-        } catch (e) {
-          return { ok: false, mode, message: e instanceof Error ? e.message : String(e) }
+        const parsed = readModeAction(input)
+        if ("invalid" in parsed) {
+          return { ok: false, mode, message: t(language, "mode.invalid", { raw: parsed.invalid }) }
         }
-        if (action === "status") return { ok: false, mode, message: "status 只读取当前模式，不做切换。" }
+        const action = parsed.action
+        if (action === "status") return { ok: false, mode, message: t(language, "mode.statusOnly") }
         const message = await switchMode(action)
         // `!pristine` means switchMode could not apply the change; its message says why.
         return { ok: Boolean(pristine), mode, message }
@@ -403,16 +420,16 @@ export default Plugin.define({
         `apiKey=${apiKey ? "present" : "MISSING"} count=${count} ` +
         `searchTool=${searchToolPatched ? "deepseek" : "untouched"}`,
     )
-    if (!apiKey) console.error(`[deepseek-search] ${missingKeyMessage()}`)
+    if (!apiKey) console.error(`[deepseek-search] ${missingKeyMessage("en")}`)
     if (overrideMode && overrideMode !== configMode)
       console.error(
-        `[deepseek-search] 注意：存在持久化开关 mode=${overrideMode}，已覆盖配置文件里的 ${configMode}；` +
-          `调用 deepseek_mode 传 "config" 可清除。`,
+        `[deepseek-search] note: a persisted mode=${overrideMode} overrides the config file's ${configMode}; ` +
+          `call deepseek_mode with "config" to clear it.`,
       )
     if (mode === "deepseek" && !searchToolPatched)
       console.error(
-        `[deepseek-search] 警告：未找到内置 ${SEARCH_TOOL} 工具，搜索仍走内置后端。` +
-          `可在 opencode.jsonc 设置 "websearch": { "provider": "${PROVIDER_ID}" } 强制路由。`,
+        `[deepseek-search] warning: built-in ${SEARCH_TOOL} tool not found; search still uses the built-in backend. ` +
+          `Set "websearch": { "provider": "${PROVIDER_ID}" } in opencode.jsonc to force the route.`,
       )
   },
 })

package/src/rpc.ts

@@ -13,6 +13,17 @@ import type { Rpc } from "@opencode/plugin/rpc"
 
 export const DEEPSEEK_RPC_ID = "deepseek-search"
 
+/**
+ * UI languages the plugin ships. The server resolves one of them once and puts
+ * it in `status`, so the tools and both sidebars always speak the same language.
+ */
+export type Language = "en" | "ja" | "zh-CN"
+export const LANGUAGE_VALUES = ["en", "ja", "zh-CN"] as const
+
+export function isLanguage(value: unknown): value is Language {
+  return value === "en" || value === "ja" || value === "zh-CN"
+}
+
 // Shared by the today/month/total slots of `status.counts`.
 const USAGE_COUNTS_SCHEMA = {
   type: "object",
@@ -43,6 +54,9 @@ export const DeepSeekRpc = {
           today: { type: "string" },
           month: { type: "string" },
           total: { type: "string" },
+          // Declared but not required: older servers omit it, and readStatus
+          // falls back to English without failing the rest of the payload.
+          language: { type: "string", enum: ["en", "ja", "zh-CN"] },
           counts: {
             type: "object",
             properties: {
@@ -102,6 +116,12 @@ export interface SearchStatus {
   today: string
   month: string
   total: string
+  /**
+   * UI language resolved by the server. Required by this interface: `readStatus`
+   * always fills it (English when the server is older or sends garbage), so
+   * every surface has one value to render with.
+   */
+  language: Language
   /** Structured counters, so each surface can format for its own width. Optional for older servers. */
   counts?: { today: UsageCounts; month: UsageCounts; total: UsageCounts }
 }
@@ -134,13 +154,25 @@ function readUsageCounts(value: unknown): UsageCounts | undefined {
 /** Defensive read of an RPC `status` result. Never throws. */
 export function readStatus(raw: unknown): SearchStatus | undefined {
   if (!isRecord(raw)) return undefined
-  const { mode, source, patched, hasKey, pricePerThousand, today, month, total, counts } = raw
+  const { mode, source, patched, hasKey, pricePerThousand, today, month, total, language, counts } = raw
   if (!isMode(mode)) return undefined
   if (source !== "override" && source !== "config") return undefined
   if (typeof patched !== "boolean" || typeof hasKey !== "boolean") return undefined
   if (typeof pricePerThousand !== "number" || !Number.isFinite(pricePerThousand)) return undefined
   if (typeof today !== "string" || typeof month !== "string" || typeof total !== "string") return undefined
-  const status: SearchStatus = { mode, source, patched, hasKey, pricePerThousand, today, month, total }
+  const status: SearchStatus = {
+    mode,
+    source,
+    patched,
+    hasKey,
+    pricePerThousand,
+    today,
+    month,
+    total,
+    // An older server has no language; a malformed one is not worth failing the
+    // whole payload over. Both fall back to English.
+    language: isLanguage(language) ? language : "en",
+  }
   // Old servers omit `counts`; a malformed triple is dropped without failing the rest.
   if (isRecord(counts)) {
     const todayCounts = readUsageCounts(counts.today)