@openav/cli 1.0.40 → 1.0.41

package/bin/stt/requirements.txt

@@ -1,32 +1,20 @@
-# DeepSeekCode 语音转文字（STT）依赖 — 英语 whisper / 中文 FunASR
+# DeepSeekCode 语音转文字（STT）依赖 — faster-whisper（唯一引擎）
 #
 # 安装（任选其一）：
 #   pip install -r packages/stt/requirements.txt
-#   或分别安装：pip install faster-whisper   （英语）
-#              pip install -U "funasr>=1.1.0,<1.5" modelscope torch  （中文）
+#   或：pip install faster-whisper
 #
 # 说明：
-#   - torch 体积较大（CPU 版约 200MB+，CUDA 版数 GB）。只有中文后端需要；
-#     如果只使用英语，可以只装 faster-whisper。
-#   - funasr 会顺带安装 modelscope（模型下载）；但**不会**装 torchaudio
-#     （1.4.x 的 Requires-Dist 里没有它，1.4.3 的 wav_frontend 却无条件 import，
-#     1.4.16 起改用内置 funasr.utils.fbank，装了 torchaudio 时仍转发给它）。
-#     所以别指望 pip 帮你补 torchaudio。
+#   - 不需要 torch / funasr / modelscope：识别引擎只有 faster-whisper
+#     （ctranslate2 后端，CPU int8 即可用），中文与英语走同一套依赖，
+#     区别只在模型档位（en → base.en，其余 → 多语言 base）。
 #   - Python 3.10+（stt_server.py 用了 PEP 604 的 `X | None` 注解），推荐 3.10~3.12。
 
-# 音频容器解码（两个后端共用）：PyAV —— OGG/Opus、MP3、M4A 等平台原生格式
+# 音频容器解码：PyAV —— OGG/Opus、MP3、M4A 等平台原生格式
 # 给 stt_server.decode_with_av 用；WAV / 裸 f32 走标准库，不需要它。
 # **不需要系统 ffmpeg**：PyAV 的 wheel 自带 FFmpeg 库（av.library_versions 可验），
 # 这正是选 PyAV 而不是 subprocess 调 ffmpeg 的全部理由。
 av>=11
 
-# 英语后端：faster-whisper（whisper.cpp 的 Python 绑定，CPU 上快且省内存）
+# 识别引擎：faster-whisper（whisper.cpp 的 Python 绑定，CPU 上快且省内存）
 faster-whisper>=1.0.0
-
-# 中文后端：FunASR（阿里达摩院，paraformer-zh 模型）
-# 上限 <1.5 是为了挡住 funasr 大版本的行为漂移：AutoModel 的参数契约
-# （model 只收字符串、标点模型走 punc_model）与 fbank 实现都在小版本间变过。
-# 同时与 sttDownload.ts#sttPackagesFor 保持一致（那份清单是「一键安装」真正执行的东西）。
-funasr>=1.1.0,<1.5
-modelscope>=1.15.0
-torch>=2.0.0

package/bin/stt/stt_server.py

@@ -1,12 +1,11 @@
 #!/usr/bin/env python3
 """DeepSeekCode 本地语音转文字（STT）服务。
 
-参考 OpenWorker 的 stt/ 侧车设计（Rust + whisper.cpp），但改为 Python 实现，
-因为中文引擎 FunASR 只有 Python 生态：
+参考 OpenWorker 的 stt/ 侧车设计（Rust + whisper.cpp），改为 Python 实现。
+**唯一的识别引擎是 faster-whisper**，按语言选两个模型档位：
 
-  - 中文（zh）→ FunASR（阿里达摩院，paraformer-zh 模型，中文识别效果优于 whisper）
   - 英语（en）→ faster-whisper 英语专用模型（base.en，CPU 上快且省内存）
-  - 其他语言（ja/ko/fr/de/es/ru/pt/it…）→ faster-whisper 多语言模型
+  - 其他语言（zh/ja/ko/fr/de/es/ru/pt/it…）→ faster-whisper 多语言模型
     （默认 base，可用 DSC_STT_WHISPER_MULTI_MODEL 调整，如 small）
 
 多语言档的语言码「未命中」时改由模型自动识别（详见 transcribe_whisper 的说明）：
@@ -18,7 +17,7 @@ WAV / 裸 f32 用标准库自己解（http.server / json / base64 / wave / struc
 选 PyAV 而不是调 `ffmpeg` 可执行文件：PyAV 的 wheel 里自带 FFmpeg 库，
 所以「本机有没有 ffmpeg」不再是这条链路的先决条件（Windows 上尤其关键）。
 后端包同样按需懒加载：`/status` 不触发任何模型下载；`/transcribe` 首次调用时会
-自动下载模型（faster-whisper 走 HuggingFace，FunASR 走 ModelScope），耗时取决于网络。
+自动下载模型（faster-whisper 走 HuggingFace），耗时取决于网络。
 
 接口（仅监听 127.0.0.1）：
   GET  /health      → {"status": "ok"}
@@ -37,17 +36,13 @@ WAV / 裸 f32 用标准库自己解（http.server / json / base64 / wave / struc
   DSC_STT_PORT           监听端口（默认 0 = 系统分配；父进程通常指定 --port）
   DSC_STT_WHISPER_MODEL  faster-whisper 英语模型名（默认 base.en）
   DSC_STT_WHISPER_MULTI_MODEL  faster-whisper 多语言模型名（默认 base）
-  DSC_STT_FUNASR_MODEL   FunASR 模型名（默认 paraformer-zh）
-  DSC_STT_FUNASR_PUNC    1 = 启用中文标点模型 ct-punc（额外下载，默认关）
   DSC_STT_DEVICE         auto|cuda|cpu（默认 auto）
 
 模型下载源（由 Node 侧按 config.yaml settings.stt.* 注入；本文件不读它们，
-而是 huggingface_hub / modelscope 在 **import 期**自行读取 —— 因此改端点
+而是 huggingface_hub 在 **import 期**自行读取 —— 因此改端点
 必须重启本进程才生效，Node 侧 restartService() 负责这件事）：
   HF_ENDPOINT            HuggingFace 端点（默认 https://huggingface.co，国内可设
                          https://hf-mirror.com）—— faster-whisper 的模型权重走这里
-  MODELSCOPE_ENDPOINT    ModelScope 端点（默认 https://modelscope.cn）——
-                         FunASR 的 paraformer-zh 等权重走这里
 """
 
 import base64
@@ -63,10 +58,10 @@ from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
 from pathlib import Path
 
 DEFAULT_MODELS_DIR = str(Path.home() / ".agent" / "stt-models")
-TARGET_RATE = 16_000  # whisper / paraformer 均要求 16k 采样率
+TARGET_RATE = 16_000  # whisper 要求 16k 采样率
 
 _backends_lock = threading.Lock()
-_loaded = {"en": None, "zh": None, "multi": None}  # 缓存已加载的模型对象
+_loaded = {"en": None, "multi": None}  # 缓存已加载的模型对象
 
 
 def log(msg: str) -> None:
@@ -352,66 +347,6 @@ def transcribe_whisper(samples_f32: list[float], language: str, kind: str) -> tu
     return text, (str(detected) if detected else None)
 
 
-
-# ─────────────────────────── 后端：中文 FunASR ───────────────────────────
-
-def _funasr_loaded() -> object | None:
-    with _backends_lock:
-        return _loaded["zh"]
-
-
-def _funasr_load() -> object:
-    with _backends_lock:
-        if _loaded["zh"] is not None:
-            return _loaded["zh"]
-        try:
-            from funasr import AutoModel  # noqa: PLC0415
-        except ImportError as exc:
-            raise RuntimeError(
-                "Chinese STT backend (FunASR) is not installed. Run:\n"
-                '  pip install -U "funasr>=1.1.0,<1.5" modelscope torch\n'
-                "The DeepSeekCode server needs it for Chinese voice input."
-            ) from exc
-        # model 必须传**字符串**：funasr 的 build_model 里有
-        # `if kwargs["model"] in {"silero-vad", "silero_vad"}`，传 list 不可哈希，
-        # 1.4.x 上直接 `TypeError: unhashable type: 'list'`。
-        # 标点模型是**独立参数** punc_model（官方用法
-        # `AutoModel(model="paraformer-zh", punc_model="ct-punc")`），不能再拼进 model。
-        kwargs: dict[str, object] = {
-            "model": os.environ.get("DSC_STT_FUNASR_MODEL", "paraformer-zh"),
-        }
-        if os.environ.get("DSC_STT_FUNASR_PUNC", "0") == "1":
-            kwargs["punc_model"] = "ct-punc"
-        device = "cuda:0" if detect_device() == "cuda" else "cpu"
-        kwargs["device"] = device
-        log(
-            f"loading FunASR model {kwargs['model']} "
-            f"(device={device}, punc={'ct-punc' if 'punc_model' in kwargs else 'off'})…"
-        )
-        model = AutoModel(**kwargs)
-        _loaded["zh"] = model
-        log("FunASR model ready")
-        return model
-
-
-def transcribe_zh(samples_f32: list[float]) -> str:
-    model = _funasr_load()
-    import numpy as np  # noqa: PLC0415
-
-    # 直接喂 float32（[-1, 1]）：funasr 的 load_utils.extract_fbank 对 numpy 输入只做
-    # torch.from_numpy、**不转 dtype**，喂 int16 会在下游 torchaudio 的 kaldi.fbank 里
-    # `RuntimeError: mean(): could not infer output dtype ... Got: Short`。
-    # 与 transcribe_whisper 的 np.asarray(samples_f32, dtype=np.float32) 同形。
-    audio = np.asarray(samples_f32, dtype=np.float32)
-    res = model.generate(input=audio, cache={})
-    text = ""
-    if isinstance(res, list) and res:
-        text = str(res[0].get("text", "") or "")
-    elif isinstance(res, dict):
-        text = str(res.get("text", "") or "")
-    return text.strip()
-
-
 # ─────────────────────────── 设备检测 / 状态 ───────────────────────────
 
 def detect_device() -> str:
@@ -420,6 +355,8 @@ def detect_device() -> str:
         return "cuda"
     if env == "cpu":
         return "cpu"
+    # torch 不是本服务的依赖（faster-whisper 走 ctranslate2）；装了就用它探 CUDA，
+    # 没装一律 cpu。想显式用 GPU 请设 DSC_STT_DEVICE=cuda。
     try:
         import torch  # noqa: PLC0415
 
@@ -431,25 +368,17 @@ def detect_device() -> str:
 def _backend_status() -> dict:
     def probe(name: str) -> dict:
         loaded = _loaded.get(name) is not None
-        # 捕获所有异常而非仅 ImportError：Windows 上 torch DLL 加载失败等
+        # 捕获所有异常而非仅 ImportError：Windows 上 ctranslate2 DLL 加载失败等
         # 场景需要把具体原因带给前端，否则"pip 装完了却仍显示未安装"无从排查。
         error = None
         try:
-            if name in ("en", "multi"):
-                import faster_whisper  # noqa: PLC0415, F401
+            import faster_whisper  # noqa: PLC0415, F401
 
-                installed = True
-            else:
-                import funasr  # noqa: PLC0415, F401
-
-                installed = True
+            installed = True
         except Exception as exc:  # noqa: BLE001 — 探测需吞掉一切导入期异常
             installed = False
             error = f"{type(exc).__name__}: {exc}"
-        if name == "zh":
-            model = os.environ.get("DSC_STT_FUNASR_MODEL", "paraformer-zh")
-        else:
-            model = os.environ.get(_WHISPER_MODEL_ENV[name], _WHISPER_MODEL_DEFAULT[name])
+        model = os.environ.get(_WHISPER_MODEL_ENV[name], _WHISPER_MODEL_DEFAULT[name])
         return {
             "installed": installed,
             "loaded": loaded,
@@ -457,7 +386,7 @@ def _backend_status() -> dict:
             "model": model,
         }
 
-    return {"en": probe("en"), "multi": probe("multi"), "zh": probe("zh")}
+    return {"en": probe("en"), "multi": probe("multi")}
 
 
 # ─────────────────────────── HTTP 服务 ───────────────────────────
@@ -500,8 +429,8 @@ class SttHandler(BaseHTTPRequestHandler):
         except Exception as exc:  # noqa: BLE001
             return self._send(400, {"error": f"Bad request body: {exc}"})
         lang = str(body.get("language") or "en").lower()
-        # 接受任意 ISO-639-1 两位小写码：zh→FunASR，en→英语专用 whisper，
-        # 其余→多语言 whisper（模型支持约 99 种语言）。非两位字母码才拒绝。
+        # 接受任意 ISO-639-1 两位小写码：en→英语专用 whisper，
+        # 其余（含 zh）→多语言 whisper（模型支持约 99 种语言）。非两位字母码才拒绝。
         if not (len(lang) == 2 and lang.isalpha() and lang.isascii()):
             return self._send(400, {"error": f"Unsupported language: {lang} (use an ISO-639-1 code like 'en' / 'zh' / 'ja')"})
         if not body.get("audio"):
@@ -519,10 +448,7 @@ class SttHandler(BaseHTTPRequestHandler):
 
         effective_lang = lang
         try:
-            if lang == "zh":
-                text = transcribe_zh(samples)
-                backend = "funasr"
-            elif lang == "en":
+            if lang == "en":
                 text, auto_lang = transcribe_whisper(samples, "en", "en")
                 backend = "faster-whisper"
                 effective_lang = auto_lang or lang
@@ -584,9 +510,8 @@ def parent_alive(pid: int) -> bool:
 
 def main() -> None:
     models_dir = os.environ.get("DSC_STT_MODELS_DIR", DEFAULT_MODELS_DIR)
-    # 模型缓存集中到 models_dir（与 Node 侧 spawn 时注入的 HF_HOME / MODELSCOPE_CACHE 一致）
+    # 模型缓存集中到 models_dir（与 Node 侧 spawn 时注入的 HF_HOME 一致）
     os.environ.setdefault("HF_HOME", str(Path(models_dir) / "huggingface"))
-    os.environ.setdefault("MODELSCOPE_CACHE", str(Path(models_dir) / "modelscope"))
     Path(models_dir).mkdir(parents=True, exist_ok=True)
 
     port = int(_arg_value("--port") or os.environ.get("DSC_STT_PORT") or "0")

package/install.cjs

@@ -15,6 +15,23 @@
 // application" error, so its message is best-effort; install.cjs failure output
 // above is the primary guidance when postinstall does run.
 //
+// WHY repairWindowsShims() EXISTS
+//
+// npm reads bin/dscode.exe's shebang while generating the `dscode` /
+// `deepseekcode` shims. The placeholder has to start with `#!/bin/sh` (that is
+// the runnable "not installed yet" message on Unix before this script replaces
+// it), so on Windows cmd-shim copies that interpreter verbatim:
+//
+//   & "/bin/sh"  "$basedir/node_modules/@deepseekcode/cli/bin/dscode.exe" $args
+//
+// /bin/sh does not exist there, so every fresh `npm i -g` on Windows lands a
+// `dscode` that dies with `/bin/sh.exe is not recognized` — while the real
+// 100MB PE binary sits right next to it. The shims are written BEFORE this
+// script runs, so they cannot be avoided; repairWindowsShims() rewrites them to
+// exec the binary that is on disk by now. (`npm rebuild -g <pkg>` also repairs
+// them: re-linking reads the shebang of the then-real PE binary, which has
+// none.)
+//
 // Platform detection + PLATFORMS map is duplicated in cli-wrapper.cjs — keep in sync.
 
 const { spawnSync } = require('child_process')
@@ -37,6 +54,14 @@ const WRAPPER_NAME = require('./package.json').name
 const PACKAGE_PREFIX = WRAPPER_NAME
 const BINARY_NAME = 'dscode'
 
+// The command names npm creates shims for (dscode + deepseekcode). Taken from
+// the published bin map so a rename never leaves a stale shim behind.
+const BIN_MAP = require('./package.json').bin || {}
+const SHIM_NAMES = Object.keys(BIN_MAP)
+// Where the native binary lands, and therefore what every shim must exec: the
+// published wrapper's bin field points at this path.
+const BIN_TARGET = path.join(__dirname, 'bin', 'dscode.exe')
+
 
 const PLATFORMS = {
   'darwin-arm64': { pkg: PACKAGE_PREFIX + '-darwin-arm64', bin: BINARY_NAME },
@@ -118,6 +143,121 @@ function placeBinary(src, dest) {
   }
 }
 
+// ---- Windows shim repair -------------------------------------------------
+// The three templates below mirror what npm writes for a non-JS bin target, i.e.
+// the shape it produces after re-linking against the real (shebang-less) PE
+// binary — a repaired shim is indistinguishable from a healthy one.
+
+function ps1Shim(target) {
+  return [
+    '#!/usr/bin/env pwsh',
+    '$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent',
+    '',
+    '$ret=0',
+    '# Support pipeline input',
+    'if ($MyInvocation.ExpectingInput) {',
+    '  $input | & "$basedir/' + target + '"   $args',
+    '} else {',
+    '  & "$basedir/' + target + '"   $args',
+    '}',
+    '$ret=$LASTEXITCODE',
+    'exit $ret',
+    '',
+  ].join('\n')
+}
+
+function cmdShim(target) {
+  return [
+    '@ECHO off',
+    'GOTO start',
+    ':find_dp0',
+    'SET dp0=%~dp0',
+    'EXIT /b',
+    ':start',
+    'SETLOCAL',
+    'CALL :find_dp0',
+    '"%dp0%\\' + target + '"   %*',
+    '',
+  ].join('\n')
+}
+
+function shShim(target) {
+  return [
+    '#!/bin/sh',
+    "basedir=$(dirname \"$(echo \"$0\" | sed -e 's,\\\\,/,g')\")",
+    '',
+    'case `uname` in',
+    '    *CYGWIN*|*MINGW*|*MSYS*)',
+    '        if command -v cygpath > /dev/null 2>&1; then',
+    '            basedir=`cygpath -w "$basedir"`',
+    '        fi',
+    '    ;;',
+    'esac',
+    '',
+    'exec "$basedir/' + target + '"   "$@"',
+    '',
+  ].join('\n')
+}
+
+// Path from the shim's directory to the binary, spelled the way each shim kind
+// expects: npm uses forward slashes in .ps1/.sh and backslashes in .cmd.
+function shimTarget(shimDir, exeAbs, sep) {
+  const rel = path.relative(shimDir, exeAbs)
+  const picked = rel && !path.isAbsolute(rel) ? rel : exeAbs
+  return sep === '\\' ? picked.replace(/\//g, '\\') : picked.replace(/\\/g, '/')
+}
+
+function shimFor(ext, target) {
+  if (ext === '.ps1') return ps1Shim(target)
+  if (ext === '.cmd') return cmdShim(target)
+  return shShim(target)
+}
+
+// Rewrite every shim under shimDirs that still calls the POSIX interpreter, and
+// return the repaired paths (empty when there was nothing to do). Inputs are
+// arguments so a test can drive it with a temp dir on any platform.
+function repairShims(shimDirs, exeAbs) {
+  const repaired = []
+  for (const dir of shimDirs) {
+    for (const name of SHIM_NAMES) {
+      for (const ext of ['.ps1', '.cmd', '']) {
+        const file = path.join(dir, name + ext)
+        let text
+        try {
+          text = readFileSync(file, 'utf8')
+        } catch {
+          continue
+        }
+        // Skip the shebang line: a healthy .sh shim legitimately starts with
+        // `#!/bin/sh`. Only /bin/sh used as an *interpreter* is the bug.
+        if (!text.replace(/^[^\n]*\n/, '').includes('/bin/sh')) continue
+        try {
+          const target = shimTarget(dir, exeAbs, ext === '.cmd' ? '\\' : '/')
+          writeFileSync(file, shimFor(ext, target), { mode: 0o755 })
+          repaired.push(file)
+        } catch {
+          // A read-only prefix (`sudo npm i -g`, then `dscode` as a user) must
+          // not fail the install — the binary itself is already in place.
+        }
+      }
+    }
+  }
+  return repaired
+}
+
+// Candidate shim directories: the npm prefix (global install) and
+// node_modules/.bin (local install). Both derive from the package location, so
+// the same code covers `npm i -g`, a project dependency and pnpm-style layouts.
+function shimDirsFor(pkgDir) {
+  const nodeModules = path.dirname(path.dirname(pkgDir))
+  return [path.dirname(nodeModules), path.join(nodeModules, '.bin')]
+}
+
+function repairWindowsShims() {
+  if (process.platform !== 'win32') return []
+  return repairShims(shimDirsFor(__dirname), BIN_TARGET)
+}
+
 function main() {
   const platformKey = getPlatformKey()
   const info = PLATFORMS[platformKey]
@@ -162,11 +302,22 @@ function main() {
   // On Unix npm links `bin/dscode` → `bin/dscode.exe` and ignores the
   // extension, so overwriting the .exe path replaces the running target on
   // every platform. Same pattern as Claude Code / Bun npm packages.
-  const dest = path.join(__dirname, 'bin', 'dscode.exe')
+  const dest = BIN_TARGET
 
   try {
     placeBinary(src, dest)
     console.log(`[${WRAPPER_NAME} postinstall] Native binary placed → ${dest}`)
+    try {
+      const repaired = repairWindowsShims()
+      if (repaired.length > 0) {
+        console.log(
+          `[${WRAPPER_NAME} postinstall] Repaired ${repaired.length} Windows shim(s) → exec the native binary`,
+        )
+      }
+    } catch {
+      // Never fail the install over cosmetic shims: the binary is placed, and
+      // `npm rebuild -g ${WRAPPER_NAME}` repairs them too.
+    }
   } catch (err) {
     console.error(`[${WRAPPER_NAME} postinstall] Failed to place binary: ${err.message}`)
     console.error('  Fallback: node ' + path.join(__dirname, 'cli-wrapper.cjs'))
@@ -174,4 +325,7 @@ function main() {
   }
 }
 
-main()
+if (require.main === module) main()
+
+// Exported for the shim-repair tests; npm runs this file directly.
+module.exports = { repairShims, shimFor, shimTarget }

package/llms.txt

@@ -1,14 +1,17 @@
 # DeepSeekCode
 
-> DeepSeekCode is a local-first AI coding agent that runs in your terminal: one local runtime
-> serving an interactive TUI, a web UI and an HTTP/WebSocket API, driven by any OpenAI-compatible
-> model. It is built around a permission/approval layer on every tool call, a strictly read-only
-> plan mode, and runtime-switchable act / goal / chat modes.
+> DeepSeekCode is a local-first AI coding agent: one npm package starts a runtime on your machine
+> that serves a terminal UI, a web UI and an HTTP + WebSocket API, driven by any OpenAI-compatible
+> model.
+>
+> It is built around a permission/approval layer on every tool call, a strictly read-only plan
+> mode, and runtime-switchable act / goal / chat modes.
 > Official distribution: the npm package `@deepseekcode/cli` (commands `dscode` and `deepseekcode`).
 > Project page: https://deepseekcode.github.io/deepseekwork/
 
 This file follows the llms.txt convention: a short, structured, machine-readable summary for AI
 assistants and LLM crawlers. Everything below is verifiable from the deployed package.
+Content reflects version 1.0.40 (2026-10-15).
 
 ## Category and identity
 
@@ -74,12 +77,36 @@ Non-interactive use (scripts, CI): `dscode exec "<task>"` emits JSONL.
   DeepSeek (深度求索) or any other model vendor; installing it does not imply any affiliation.
 - License: proprietary and closed source. It is not open source, and copying, modifying,
   distributing or selling it requires prior written permission (see `LICENSE.md`).
+- It is not a hosted or managed service: there is no subscription to buy, and model usage is billed
+  by whichever provider the user configures, not by this project.
+
+## Screenshots and demo
+
+- A 40-second demo video (1920x1080, H.264 + VP9) and the stills used in the README ship in the
+  repository at `docs/promo/media/` (`deepseekcode-promo.mp4`, `deepseekcode-promo.webm`,
+  `poster.png`, plus per-screen stills).
+- The package README embeds an animated GIF of a real agent turn (`media/demo.gif` inside the
+  package): tool calls, a diff, and a written summary.
+- The footage is recorded from the real UI with a scripted local model endpoint, so it shows real
+  tool execution rather than a mock-up.
 
 ## Languages
 
-The package README carries an English main section plus condensed sections in Simplified Chinese
-(简体中文), Japanese (日本語) and Spanish (Español). UI text is localized, and most interactive
-commands have Chinese aliases.
+- The package README carries a full English main section plus condensed sections in 16 further
+  languages, each with a stable anchor: zh-CN (Simplified Chinese), zh-TW (Traditional Chinese),
+  ja (Japanese), ko (Korean), es (Spanish), pt (Portuguese), fr (French), it (Italian), de (German),
+  ru (Russian), tr (Turkish), ar (Arabic), hi (Hindi), id (Indonesian), vi (Vietnamese) and
+  th (Thai).
+- Every language section repeats the same canonical definition, install line, feature list and FAQ,
+  so a claim about this package can be cited from the reader's own language.
+- The application UI itself is localized into 13 locales: en, zh-CN, zh-TW, ja, ko, de, fr, es,
+  pt-BR, ru, it, ar, id. Of these, zh-CN and en are complete; the other eleven translate the
+  desktop-download entry, the language setting, the built-in template texts and the hook template
+  texts (180 keys each) and fall back to English elsewhere. Arabic is included, but whole-document
+  right-to-left mirroring is deliberately not switched on yet: the stylesheet still uses physical
+  directional utilities, so `dir=rtl` would leave spacing on the wrong side.
+- Most interactive commands have Chinese aliases, and replies can be pinned to a language
+  independently of the UI locale.
 
 ## Release notes
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openav/cli",
-  "version": "1.0.40",
+  "version": "1.0.41",
   "description": "DeepSeekCode — local-first AI coding agent for your terminal: one local runtime with a TUI, a web UI and an API, a permission/approval layer, read-only plan mode, and any OpenAI-compatible model.",
   "keywords": [
     "deepseekcode",
@@ -36,14 +36,14 @@
     "xterm": "5.3.0"
   },
   "optionalDependencies": {
-    "@openav/cli-darwin-arm64": "1.0.40",
-    "@openav/cli-darwin-x64": "1.0.40",
-    "@openav/cli-linux-x64": "1.0.40",
-    "@openav/cli-linux-arm64": "1.0.40",
-    "@openav/cli-linux-x64-musl": "1.0.40",
-    "@openav/cli-linux-arm64-musl": "1.0.40",
-    "@openav/cli-win32-x64": "1.0.40",
-    "@openav/cli-win32-arm64": "1.0.40"
+    "@openav/cli-darwin-arm64": "1.0.41",
+    "@openav/cli-darwin-x64": "1.0.41",
+    "@openav/cli-linux-x64": "1.0.41",
+    "@openav/cli-linux-arm64": "1.0.41",
+    "@openav/cli-linux-x64-musl": "1.0.41",
+    "@openav/cli-linux-arm64-musl": "1.0.41",
+    "@openav/cli-win32-x64": "1.0.41",
+    "@openav/cli-win32-arm64": "1.0.41"
   },
   "files": [
     "bin/",

package/web/dist/assets/AssistantsView-dhdYVIy0.js

@@ -0,0 +1 @@
+import{i as e}from"./rolldown-runtime-COiEfhsA.js";import{$ as t,At as n,J as r,L as i,Ur as a,d as o,ft as s,g as c,kr as l,n as u,ot as d,u as f,xr as p,yt as m,z as h}from"./icons-BvYhTENi.js";import{t as g}from"./useTranslation-BGmCDuQI.js";import{t as _}from"./api-CCt9DRQm.js";import{I as v}from"./markdown-DAQZeY5V.js";import{A as y,f as b,r as x}from"./common-BHXgEvgk.js";import{n as S,t as C}from"./channelMeta-BGQXQxgj.js";import{i as w}from"./index-BX-d2OBW.js";var T=e(a(),1),E=v(),D=(0,T.memo)(function({selectedSessionId:e,onSelectionChange:n,onOpenSession:r,onNavigate:i,onCollapse:a,onDeleted:o}){let{t:s}=g(),[c,u]=(0,T.useState)([]),[f,p]=(0,T.useState)(!0),[h,v]=(0,T.useState)(null),[y,x]=(0,T.useState)(null),[S,C]=(0,T.useState)(null),[w,D]=(0,T.useState)(!1),[O,A]=(0,T.useState)(null),[j,M]=(0,T.useState)(null),N=(0,T.useCallback)(async()=>{try{let e=await _.assistants.list();e.success&&Array.isArray(e.data)?(u(e.data),v(null)):v(e.error||s(`assistants.loadFailed`))}catch(e){v(e instanceof Error?e.message:String(e))}finally{p(!1)}},[s]);(0,T.useEffect)(()=>{N();let e=window.setInterval(()=>{N()},8e3);return()=>window.clearInterval(e)},[N]);let P=(0,T.useCallback)(async(e,t)=>{(await _.assistants.update(e,t)).success&&N()},[N]),F=(0,T.useCallback)(async()=>{D(!0),M(null);try{let e=await _.assistants.create({title:s(`assistants.newAssistantTitle`)});e.success&&e.data?(await N(),n(e.data),C(e.data.sessionId)):M(e.error||s(`assistants.createFailed`))}catch(e){M(e instanceof Error?e.message:String(e))}finally{D(!1)}},[N,n,s]),I=(0,T.useCallback)(async(e,t)=>{M(null);try{let n=await _.assistants.rename(e,t);n.success?(C(null),await N()):M(n.error||s(`assistants.renameFailed`))}catch(e){M(e instanceof Error?e.message:String(e))}},[N,s]),L=(0,T.useCallback)(async(t,n)=>{if(typeof window>`u`||typeof window.confirm!=`function`||window.confirm(s(`assistants.deleteConfirm`,{title:n}))){M(null),A(t);try{let n=await _.assistants.remove(t);n.success?(S===t&&C(null),e===t&&o?.(t),await N()):M(n.error||s(`assistants.deleteFailed`))}catch(e){M(e instanceof Error?e.message:String(e))}finally{A(null)}}},[S,e,o,N,s]);return(0,T.useEffect)(()=>{if(!e)return;let t=c.find(t=>t.sessionId===e);t&&n(t)},[c,e,n]),(0,E.jsxs)(`div`,{className:`flex h-full flex-col overflow-hidden`,children:[(0,E.jsxs)(`div`,{className:`flex items-center justify-between border-b border-dark-border px-4 py-2.5`,children:[(0,E.jsxs)(`div`,{className:`flex items-center gap-2`,children:[(0,E.jsx)(l,{size:16,className:`text-accent-blue`,"aria-hidden":`true`}),(0,E.jsx)(`h2`,{className:`text-sm font-semibold text-dark-text`,children:s(`assistants.title`)}),!f&&(0,E.jsx)(`span`,{className:`rounded-full bg-dark-hover px-1.5 py-0.5 text-badge text-dark-muted`,children:c.length})]}),(0,E.jsxs)(`div`,{className:`flex items-center gap-0.5`,children:[(0,E.jsxs)(`button`,{type:`button`,onClick:()=>void F(),disabled:w,className:`flex items-center gap-1 rounded px-2 py-1 text-xs text-accent-blue hover:bg-dark-hover disabled:opacity-50`,title:s(`assistants.newAssistantHint`),"data-testid":`assistants-create`,children:[(0,E.jsx)(d,{size:12,"aria-hidden":`true`}),s(`assistants.newAssistant`)]}),(0,E.jsxs)(`button`,{type:`button`,onClick:()=>void N(),className:`flex items-center gap-1 rounded px-2 py-1 text-xs text-dark-muted hover:bg-dark-hover hover:text-dark-text`,title:s(`common.refresh`),children:[(0,E.jsx)(t,{size:12,className:f?`animate-spin`:``,"aria-hidden":`true`}),s(`common.refresh`)]}),a&&(0,E.jsx)(`button`,{type:`button`,onClick:a,className:`rounded p-1 text-dark-muted hover:bg-dark-hover hover:text-dark-text`,title:s(`assistants.collapseList`),"aria-label":s(`assistants.collapseList`),"aria-expanded":!0,"data-testid":`assistants-list-collapse`,children:(0,E.jsx)(m,{size:13,"aria-hidden":`true`})})]})]}),j&&(0,E.jsx)(`div`,{className:`border-b border-dark-border px-4 py-1.5 text-meta text-accent-red`,role:`alert`,children:j}),(0,E.jsx)(`div`,{className:`flex-1 min-h-0 overflow-y-auto p-2`,children:f&&c.length===0?(0,E.jsx)(`div`,{className:`py-2`,role:`status`,"aria-label":s(`assistants.loading`),children:(0,E.jsx)(b,{count:4})}):h&&c.length===0?(0,E.jsx)(`div`,{className:`py-8 text-center text-xs text-accent-red`,children:h}):c.length===0?(0,E.jsxs)(`div`,{className:`py-10 text-center text-xs text-dark-muted`,children:[(0,E.jsx)(l,{size:24,className:`mx-auto mb-2 text-dark-muted`,"aria-hidden":`true`}),(0,E.jsx)(`p`,{children:s(`assistants.empty`)}),(0,E.jsx)(`p`,{className:`mt-1 text-meta`,children:s(`assistants.emptyHint`)}),(0,E.jsx)(`button`,{type:`button`,onClick:()=>i(`channels`),className:`mt-3 rounded border border-dark-border px-2.5 py-1 text-meta text-dark-text hover:bg-dark-hover`,children:s(`assistants.goChannels`)})]}):(0,E.jsx)(`div`,{className:`flex flex-col gap-2`,children:c.map(t=>(0,E.jsx)(k,{assistant:t,selected:e===t.sessionId,onSelect:()=>n(t),expanded:y===t.sessionId,onToggleExpand:()=>x(y===t.sessionId?null:t.sessionId),onOpen:()=>r(t.sessionId,t.title),onUpdate:e=>void P(t.sessionId,e),editing:S===t.sessionId,onStartRename:()=>C(t.sessionId),onCancelRename:()=>C(null),onRename:e=>void I(t.sessionId,e),deleting:O===t.sessionId,onDelete:()=>void L(t.sessionId,t.title)},t.sessionId))})})]})});function O(e){if(e===`running`)return`running`;if(e===`paused`)return`waiting`;if(e===`error`)return`failed`}var k=(0,T.memo)(function({assistant:e,selected:t,onSelect:r,expanded:a,onToggleExpand:u,onOpen:d,onUpdate:p,editing:m,onStartRename:_,onCancelRename:v,onRename:y,deleting:b,onDelete:T}){let{t:D}=g(),k=e.channel?.peerKind===`group`,N=e.kind===`home`;return(0,E.jsxs)(`div`,{className:`rounded-lg border bg-dark-surface transition-colors ${t?`border-accent-blue/60 ring-1 ring-accent-blue/30`:`border-dark-border`}`,children:[(0,E.jsxs)(`button`,{type:`button`,onClick:r,"aria-current":t?`true`:void 0,className:`flex w-full items-center gap-2 rounded-t-lg px-3 py-2 text-start focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-accent-blue/60 ${t?`bg-accent-blue/5`:`hover:bg-dark-hover/40`}`,children:[(0,E.jsx)(x,{sessionId:e.sessionId,status:O(e.status),size:40}),(0,E.jsxs)(`div`,{className:`min-w-0 flex-1`,children:[(0,E.jsxs)(`div`,{className:`flex items-center gap-1.5`,children:[e.channel?(0,E.jsx)(`span`,{className:`text-base leading-none`,"aria-hidden":`true`,children:C(e.channel.type)}):(0,E.jsx)(l,{size:14,className:`shrink-0 text-dark-muted`,"aria-hidden":`true`}),(0,E.jsx)(`span`,{className:`min-w-0 flex-1 truncate text-xs font-medium text-dark-text`,title:e.title,children:e.title}),(0,E.jsx)(`span`,{className:`h-1.5 w-1.5 shrink-0 rounded-full ${w(e.status)}`,title:D(`assistants.status.${e.status}`,{defaultValue:e.status})}),e.channel&&(k?(0,E.jsx)(f,{size:11,className:`shrink-0 text-dark-muted`,"aria-label":D(`assistants.group`)}):(0,E.jsx)(o,{size:11,className:`shrink-0 text-dark-muted`,"aria-label":D(`assistants.dm`)}))]}),(0,E.jsxs)(`div`,{className:`mt-0.5 flex items-center gap-1.5 text-badge text-dark-muted`,children:[(0,E.jsx)(`span`,{className:`shrink-0`,children:e.channel?S(e.channel.type):D(N?`assistants.homeLabel`:`assistants.localLabel`)}),(0,E.jsx)(`span`,{className:`min-w-0 flex-1 truncate`,title:e.channel?.peerId,children:e.channel?e.channel.peerId:D(N?`assistants.homeHint`:`assistants.localHint`)}),e.stats.unread>0&&(0,E.jsx)(`span`,{className:`shrink-0 rounded-full bg-accent-red/15 px-1.5 text-avatar font-medium text-accent-fg`,children:e.stats.unread})]}),e.preview&&(0,E.jsx)(`p`,{className:`mt-1 line-clamp-2 text-meta leading-snug text-dark-muted`,title:e.preview,children:e.preview})]}),(0,E.jsx)(j,{mode:e.mode}),e.trust.level===`owner`?(0,E.jsx)(i,{size:12,className:`shrink-0 text-accent-green`,"aria-label":D(`assistants.trust.owner`)}):e.trust.level===`public`?(0,E.jsx)(h,{size:12,className:`shrink-0 text-accent-yellow`,"aria-label":D(`assistants.trust.public`)}):(0,E.jsx)(i,{size:12,className:`shrink-0 text-accent-blue`,"aria-label":D(`assistants.trust.team`)})]}),(0,E.jsxs)(`div`,{className:`flex items-center gap-1.5 border-t border-dark-border px-3 py-1.5`,children:[(0,E.jsxs)(`button`,{type:`button`,onClick:d,className:`flex items-center gap-1 rounded px-2 py-0.5 text-meta text-accent-blue hover:bg-dark-hover`,children:[(0,E.jsx)(n,{size:11,"aria-hidden":`true`}),D(`assistants.openSession`)]}),(0,E.jsx)(`button`,{type:`button`,onClick:u,className:`flex items-center gap-1 rounded px-2 py-0.5 text-meta text-dark-muted hover:bg-dark-hover hover:text-dark-text`,children:D(`assistants.policy`)}),!N&&(0,E.jsx)(`button`,{type:`button`,onClick:m?v:_,className:`flex items-center gap-1 rounded px-2 py-0.5 text-meta text-dark-muted hover:bg-dark-hover hover:text-dark-text`,title:D(`assistants.rename`),"aria-label":D(`assistants.rename`),"aria-pressed":m,"data-testid":`assistant-rename-${e.sessionId}`,children:(0,E.jsx)(s,{size:11,"aria-hidden":`true`})}),!N&&(0,E.jsx)(`button`,{type:`button`,onClick:T,disabled:b,className:`flex items-center gap-1 rounded px-2 py-0.5 text-meta text-dark-muted hover:bg-accent-red/10 hover:text-accent-red disabled:opacity-50`,title:D(`assistants.deleteHint`),"aria-label":D(`assistants.delete`),"data-testid":`assistant-delete-${e.sessionId}`,children:(0,E.jsx)(c,{size:11,"aria-hidden":`true`})}),(0,E.jsx)(`span`,{className:`flex-1`}),(0,E.jsx)(`span`,{className:`text-badge text-dark-muted`,children:D(`assistants.groupPolicy`,{mention:String(k?e.policy.mentionRequired:!1)})})]}),a&&(0,E.jsx)(M,{assistant:e,isGroup:k,onUpdate:p}),m&&(0,E.jsx)(A,{initial:e.title,onSubmit:y,onCancel:v})]})});function A({initial:e,onSubmit:t,onCancel:n}){let{t:r}=g(),[i,a]=(0,T.useState)(e),o=()=>{let r=i.trim();!r||r===e?n():t(r)};return(0,E.jsxs)(`div`,{className:`flex items-center gap-1.5 border-t border-dark-border px-3 py-1.5`,children:[(0,E.jsx)(`input`,{autoFocus:!0,type:`text`,value:i,onChange:e=>a(e.target.value),onKeyDown:e=>{e.key===`Enter`?(e.preventDefault(),o()):e.key===`Escape`&&(e.preventDefault(),n())},"aria-label":r(`assistants.renameLabel`),"data-testid":`assistant-rename-input`,className:`min-w-0 flex-1 rounded border border-dark-border bg-dark-surface px-1.5 py-0.5 text-meta text-dark-text`}),(0,E.jsx)(`button`,{type:`button`,onClick:o,className:`rounded p-1 text-accent-blue hover:bg-dark-hover`,title:r(`common.save`),"aria-label":r(`common.save`),"data-testid":`assistant-rename-save`,children:(0,E.jsx)(p,{size:12,"aria-hidden":`true`})}),(0,E.jsx)(`button`,{type:`button`,onClick:n,className:`rounded p-1 text-dark-muted hover:bg-dark-hover hover:text-dark-text`,title:r(`common.cancel`),"aria-label":r(`common.cancel`),children:(0,E.jsx)(u,{size:12,"aria-hidden":`true`})})]})}function j({mode:e}){let{t}=g();return(0,E.jsx)(`span`,{className:`shrink-0 rounded px-1.5 py-0.5 text-avatar font-medium ${e===`delegate`?`bg-accent-blue/15 text-accent-blue`:`bg-dark-hover text-dark-muted`}`,children:t(`assistants.mode.${e}`)})}function M({assistant:e,isGroup:t,onUpdate:n}){let{t:i}=g(),[a,o]=(0,T.useState)(e.mode),[s,c]=(0,T.useState)(e.policy.mentionRequired),[l,u]=(0,T.useState)(String(e.policy.cooldownSeconds)),[d,f]=(0,T.useState)((e.policy.keywords??[]).join(`, `)),[p,m]=(0,T.useState)(!1);return(0,E.jsxs)(`div`,{className:`border-t border-dark-border px-3 py-2.5 text-meta`,children:[(0,E.jsxs)(`div`,{className:`flex flex-wrap items-center gap-x-4 gap-y-2`,children:[(0,E.jsxs)(`label`,{className:`flex items-center gap-1.5 text-dark-muted`,children:[i(`assistants.mode.label`),(0,E.jsxs)(`select`,{value:a,onChange:e=>o(e.target.value),className:`rounded border border-dark-border bg-dark-surface px-1.5 py-0.5 text-dark-text`,children:[(0,E.jsx)(`option`,{value:`delegate`,children:i(`assistants.mode.delegate`)}),(0,E.jsx)(`option`,{value:`direct`,children:i(`assistants.mode.direct`)})]})]}),t&&(0,E.jsxs)(`label`,{className:`flex items-center gap-1.5 text-dark-muted`,children:[(0,E.jsx)(`input`,{type:`checkbox`,checked:s,onChange:e=>c(e.target.checked)}),i(`assistants.mentionRequired`)]}),(0,E.jsxs)(`label`,{className:`flex items-center gap-1.5 text-dark-muted`,children:[i(`assistants.cooldown`),(0,E.jsx)(`input`,{type:`number`,min:0,value:l,onChange:e=>u(e.target.value),className:`w-14 rounded border border-dark-border bg-dark-surface px-1.5 py-0.5 text-dark-text`}),`s`]})]}),(0,E.jsxs)(`label`,{className:`mt-2 flex items-center gap-1.5 text-dark-muted`,children:[i(`assistants.keywords`),(0,E.jsx)(`input`,{type:`text`,value:d,placeholder:i(`assistants.keywordsPlaceholder`)??``,onChange:e=>f(e.target.value),className:`min-w-0 flex-1 rounded border border-dark-border bg-dark-surface px-1.5 py-0.5 text-dark-text`})]}),(0,E.jsx)(`div`,{className:`mt-2 flex justify-end`,children:(0,E.jsx)(y,{size:`sm`,variant:`accent`,onClick:()=>{m(!0),n({mode:a,policy:{mentionRequired:t?s:!1,cooldownSeconds:Math.max(0,Number(l)||0),...d.trim()?{keywords:d.split(/[,，]/).map(e=>e.trim()).filter(Boolean)}:{}}}),window.setTimeout(()=>m(!1),600)},loading:p,leftIcon:(0,E.jsx)(r,{size:11,"aria-hidden":`true`}),children:i(`common.save`)})})]})}export{D as AssistantsView};