dsh-nonead-universal-robots 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 This project adheres to [Keep a Changelog](https://keepachangelog.com/) and [Semantic Versioning](https://semver.org/).
 
+## [0.8.1] - 2026-10-29
+
+### Docs — installation rewritten for an npm-published package
+
+- Both READMEs gained **"Option 0 — from npm"**
+  (`dsh.cmd plugin add dsh-nonead-universal-robots`, or `"dsh-nonead-universal-robots": "^0.8.0"`
+  in `dependencies`), and the stale "not published to npm (yet)" note is gone.
+- In the hand-written bundle route the **primary** dependency is now the registry range `^0.8.0`;
+  `file:` and `github:` are documented as offline / air-gapped fallbacks.
+- New **"Languages (UI copy)"** section: the eight languages shipped since 0.8.0, the fact that they
+  follow the DSH Desktop app language (`locale.preference`) and switch without a reload, and the
+  fallback order when no host locale service is present.
+- **Documentation only** — `lib/`, `python/` and `src/` are untouched; `lib/client.js` was rebuilt so
+  it still matches `src/` byte for byte.
+
 ## [0.8.0] - 2026-10-29
 
 ### Added — client copy in 8 languages, following the desktop app language

package/CHANGELOG.zh.md

@@ -2,6 +2,19 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/) 与 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.8.1] - 2026-10-29
+
+### 文档 —— 按「已发布到 npm」的口径重写安装说明
+
+- 两份 README（中/英）的安装章节新增 **「方式零 / Option 0：从 npm 安装」**
+  （`dsh.cmd plugin add dsh-nonead-universal-robots`，或 `dependencies` 里写 `^0.8.0`），
+  并删掉「尚未发布到 npm」那句已过时的说明。
+- 手动 bundle 方式里，`dependencies` 的**首选**改为注册表版本范围 `^0.8.0`；`file:` 与 `github:`
+  降级为离线/内网环境的退路。
+- 新增 **「语言（界面文案）」** 章节：说明 0.8.0 起的 8 种语言、跟随 DSH 桌面程序语言
+  （`locale.preference`）、免刷新切换，以及无宿主 locale 服务时的回退顺序。
+- **仅文档变更**，`lib/`、`python/`、`src/` 未改动；`lib/client.js` 重新构建以保持与 `src/` 一致。
+
 ## [0.8.0] - 2026-10-29
 
 ### 新增 —— 客户端文案支持 8 种语言，并跟随桌面程序语言

package/README.md

@@ -84,9 +84,48 @@ Failure responses carry a **machine-readable `code`** (`no_robot` / `robot_not_c
 
 ---
 
+## Languages (UI copy)
+
+Since **0.8.0** the twin panel and the right-dock entry are localised into **eight languages**:
+
+> 简体中文 · English · 日本語 · Español · Français · Deutsch · Русский · Português (Brasil)
+
+The language **follows the DSH Desktop app language**: the eight dictionaries are registered with the
+host's `@deepseek-ai/dsh-client-locale` (`dsh.client.inject` + `ctx.locale.register('ur-twin', …)`),
+and the host's `locale.preference` decides which one is used. Switching the language in
+**Settings → 界面语言 / Language** updates the panel **without a reload**. Without a host locale
+service the plugin falls back to `navigator.languages` → `navigator.language` → Simplified Chinese.
+
+Every user-visible string lives in one table ([`src/client/strings.js`](./src/client/strings.js)), so
+adding a language means adding one dictionary — the key set is enforced by tests.
+
+---
+
 ## Install into a DSH profile
 
-> 📦 **Not published to npm (yet)**, so there is no version range to write into `dependencies`. Install from the plugin market / plugin page or from this repository (a local checkout or its GitHub URL).
+> 📦 **Published on npm** as [`dsh-nonead-universal-robots`](https://www.npmjs.com/package/dsh-nonead-universal-robots)
+> — current release **0.8.0**. The npm route (Option 0) is the simplest: no GitHub tarball download
+> and no local checkout.
+
+### Option 0 — from npm (recommended)
+
+```sh
+# DSH Desktop ships a CLI wrapper per profile; it adds --profile itself:
+dsh.cmd plugin add dsh-nonead-universal-robots
+# pin an exact version if you prefer:
+dsh.cmd plugin add dsh-nonead-universal-robots@0.8.0
+# on other setups: dsh plugin --profile <profile> add dsh-nonead-universal-robots
+```
+
+Or write the range into the profile's `package.json` yourself — the registry is the default source:
+
+```jsonc
+"dependencies": { "dsh-nonead-universal-robots": "^0.8.0" }
+```
+
+`npm install dsh-nonead-universal-robots` also works if you want to vendor the tarball into another
+package. The installed copy contains `lib/`, `python/` (worker + vendored `URBasic`), `assets/`,
+`cordis.patch.yml`, the changelogs and `THIRD_PARTY_NOTICES.md`.
 
 ### Option 1 — plugin market / plugin page (GUI)
 
@@ -118,7 +157,8 @@ This is the same path the plugin page uses: it writes the dependency **and** the
    // <DSH_HOME>/profiles/<profile>/package.json
    {
      "dependencies": {
-       "dsh-nonead-universal-robots": "file:D:/path/to/dsh-nonead-universal-robots"
+       "dsh-nonead-universal-robots": "^0.8.0"
+       // offline / air-gapped fallbacks: "file:D:/path/to/dsh-nonead-universal-robots"
        // or, once GitHub is reachable: "github:NoneadChina/dsh-nonead-universal-robots"
      },
      "dsh": {

package/README.zh.md

@@ -84,9 +84,46 @@ host 侧路由（均限定 loopback 调用方）：
 
 ---
 
+## 语言（界面文案）
+
+自 **0.8.0** 起，孪生面板与右栏入口卡片已本地化为**八种语言**：
+
+> 简体中文 · English · 日本語 · Español · Français · Deutsch · Русский · Português (Brasil)
+
+语言**跟随 DSH 桌面程序的语言**：八份字典通过宿主自带的 `@deepseek-ai/dsh-client-locale` 注册
+（`dsh.client.inject` + `ctx.locale.register('ur-twin', …)`），由宿主的 `locale.preference` 决定用哪份。
+在**设置 → 界面语言**里切换，面板**无需刷新页面**即生效。宿主没有 locale 服务时，回退顺序是
+`navigator.languages` → `navigator.language` → 简体中文。
+
+所有用户可见文案都集中在一张表里（[`src/client/strings.js`](./src/client/strings.js)），
+新增一种语言＝新增一份字典；键集合的对称性由测试钉住。
+
+---
+
 ## 安装到 DSH profile
 
-> 📦 **尚未发布到 npm**，因此没有可写进 `dependencies` 的版本号。请从插件市场/插件页安装，或从本仓库安装（本地检出目录或它的 GitHub 地址）。
+> 📦 **已发布到 npm**：[`dsh-nonead-universal-robots`](https://www.npmjs.com/package/dsh-nonead-universal-robots)
+> —— 当前版本 **0.8.0**。最快的是下面的「方式零」：不需要从 GitHub 下 tarball，也不需要本地检出。
+
+### 方式零：从 npm 安装（推荐）
+
+```sh
+# DSH Desktop 会为每个 profile 生成一个 CLI 包装器，它会自己补上 --profile：
+dsh.cmd plugin add dsh-nonead-universal-robots
+# 需要锁定版本时：
+dsh.cmd plugin add dsh-nonead-universal-robots@0.8.0
+# 其他环境：dsh plugin --profile <profile> add dsh-nonead-universal-robots
+```
+
+也可以直接写进 profile 的 `package.json` —— 默认就从注册表取：
+
+```jsonc
+"dependencies": { "dsh-nonead-universal-robots": "^0.8.0" }
+```
+
+如果要把 tarball 内联进别的包，`npm install dsh-nonead-universal-robots` 同样可用。安装进来的副本包含
+`lib/`、`python/`（worker 与 vendored `URBasic`）、`assets/`、`cordis.patch.yml`、两份 CHANGELOG 与
+`THIRD_PARTY_NOTICES.md`。
 
 ### 方式一：插件市场 / 插件页（GUI）
 
@@ -118,7 +155,8 @@ dsh.cmd plugin add "file:D:/path/to/dsh-nonead-universal-robots"
    // <DSH_HOME>/profiles/<profile>/package.json
    {
      "dependencies": {
-       "dsh-nonead-universal-robots": "file:D:/path/to/dsh-nonead-universal-robots"
+       "dsh-nonead-universal-robots": "^0.8.0"
+       // 离线/内网环境的退路："file:D:/path/to/dsh-nonead-universal-robots"
        // 或（GitHub 可达时）："github:NoneadChina/dsh-nonead-universal-robots"
      },
      "dsh": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-nonead-universal-robots",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "一个让 DSH 用自然语言直接控制 Universal Robots（UR）机械臂的插件，由拓德科技（Nonead）基于自研的 nUR MCP Server 同源逻辑开发。",
   "type": "module",
   "main": "lib/index.js",