cline-kit 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -4,6 +4,35 @@ All notable changes to this project are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); dictionary data changes are versioned inside
 each `dictionaries/<locale>.json` rather than here.
 
+## [0.1.2] - 2026-09-21
+
+### Added
+
+- `ckit locales` — lists the interface languages that ship with the kit (code, native name, string
+  count, dictionary version, `*` on the active one) and `ckit locales <code>` switches to one. Language
+  choice used to be reachable only through `ckit config --dictionary=<code>`, which no one finds without
+  reading the middle of the README; the old flag still works and writes the same field.
+- `ckit install` prints the current language and the switch command every time, and the first successful
+  `ckit start` says it once (`hintLanguageShown` in `%APPDATA%\cline-kit\config.json`).
+- `scripts/cli-locale-switch-check.js` — drives the CLI as a subprocess and probes the live DOM, so the
+  check covers the command a user types rather than the internal config write.
+
+### Changed
+
+- `npm test` is 25 checks: the new one asserts every bundled locale appears in `ckit locales`, that
+  `--help` documents each command, and that an unknown code fails instead of storing a broken language.
+
+## [0.1.1] - 2026-09-20
+
+### Changed
+
+- First npm publication is live: `cline-kit@0.1.0` was bootstrapped with a one-time granular token
+  that was deleted immediately afterwards, and the package now carries an **OIDC trusted publisher**
+  (`chentaoxing / Cline-kit / release.yml`). Every later version is published by the release
+  workflow itself - no npm token or repository secret exists or is needed.
+- `publishConfig` pins `registry.npmjs.org` so a contributor whose `.npmrc` points at a mirror cannot
+  publish to the wrong place.
+
 ## [0.1.0] - 2026-09-20
 
 First public release. Windows only.
@@ -49,8 +78,8 @@ First public release. Windows only.
 - `ckit audit` — walks the screens over CDP, filters hidden-but-mounted panels by hit-testing each node,
   and reports only strings the dictionary does not cover.
 - `ckit.cmd` so a release-zip download has an entry point without a global install.
-- CI: `npm test` plus a CLI smoke pass on tag, a portable Windows zip artifact, and npm publish gated on
-  an `NPM_TOKEN` secret.
+- CI: `npm test` plus a CLI smoke pass on tag, a portable Windows zip artifact, and `npm publish` through
+  npm's OIDC trusted publishing - the repository holds no npm credential.
 
 ### Changed
 

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 chentaoxing
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 chentaoxing
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -13,9 +13,9 @@ Every project you registered but have not opened yet is simply invisible. `cline
 them listed, with the same styling as the native groups, and lets you switch into an empty project
 straight from the sidebar.
 
-**Secondary feature:** UI locale packs (简体中文 today; 繁體中文 / 日本語 / 한국어 / Tiếng Việt use the
-same format). Locales exist because the same injection channel can carry them — they are not what the
-project is for.
+**Secondary feature:** UI locale packs — five ship: 简体中文 (reference, proofread), plus 繁體中文 /
+日本語 / 한국어 / Tiếng Việt. Locales exist because the same injection channel can carry them — they
+are not what the project is for.
 
 ## The sidebar problem
 
@@ -57,7 +57,7 @@ or both.
 
 Three routes, same tool. All of them need Node.js on `PATH`; none of them touch `cline-app.exe`.
 
-**1. npm (recommended, once the package is published)**
+**1. npm (recommended)**
 
 ```bash
 npm install -g cline-kit
@@ -81,13 +81,14 @@ ckit.cmd start
 git clone https://github.com/chentaoxing/Cline-kit.git
 cd cline-kit
 npm install -g .            # or call it directly: node src/cli.js <command>
-npm test                    # 22 checks, no dependencies
+npm test                    # 25 checks, no dependencies
 ```
 
 Then in every case:
 
 ```bash
 ckit doctor                 # confirms the overlay is live inside the running window
+ckit locales                # optional: list / switch the interface language
 ```
 
 `ckit install` locates the Cline shortcut in the Start Menu / Desktop, saves its original target in
@@ -106,11 +107,27 @@ then gives you the enhanced sidebar. If you would rather keep your own launcher,
 | `ckit attach` | Inject once into a Cline you started yourself (`--port=N`), without owning the shortcut |
 | `ckit features` | List feature plugins and whether each is on |
 | `ckit feature enable\|disable <id>` | Toggle a feature (applies within ~4 s, no restart) |
+| `ckit locales` | List the bundled interface languages |
+| `ckit locales <code>` | Switch language — e.g. `ckit locales ja` (applies within ~4 s, no restart) |
 | `ckit install` / `uninstall` | Repoint / restore your Cline shortcut |
 | `ckit update` | Pull the latest locale dictionary from GitHub (`--force` to check now) |
 | `ckit audit` | Walk the UI and list strings still in English |
 | `ckit dict` | Dictionary statistics and the local override path |
-| `ckit config` | Inspect or set `--cline-path`, `--port`, `--auto-update=on\|off` |
+| `ckit config` | Inspect or set `--cline-path`, `--port`, `--auto-update=on\|off`, `--dictionary=<code>` |
+
+### Choosing a language
+
+Language is a per-install choice, and Cline has no language setting of its own, so the kit exposes it:
+
+```bash
+ckit locales          # what ships, how many strings each covers, which one is active
+ckit locales ja       # switch; the open window changes within ~4 s, no restart
+ckit locales zh-CN    # back to the reference dictionary
+```
+
+`ckit install` prints the current language and this command, and the first `ckit start` says it once.
+`ckit config --dictionary=<code>` is the same write if you prefer the generic config command. Once a
+non-default locale is selected, `ckit update` hot-updates *that* dictionary.
 
 ## Features
 
@@ -128,9 +145,9 @@ then gives you the enhanced sidebar. If you would rather keep your own launcher,
   30 pattern rules, built by combining a UI walk with extraction from the app's own source. Five
   dictionaries ship: **zh-CN** (reference, proofread against the running app), **zh-TW**, **ja**,
   **ko**, **vi** - complete but machine-assisted and *not* reviewed by native speakers, so a pull
-  request fixing a term is genuinely welcome. Switch with `ckit config --dictionary=ja`; the change
-  applies to the open window without a reload, and `ckit update` follows the locale you picked.
-  Authoring guide: [`docs/dictionary-pipeline.zh-CN.md`](docs/dictionary-pipeline.zh-CN.md).
+  request fixing a term is genuinely welcome. Pick one with `ckit locales` — see
+  [Choosing a language](#choosing-a-language). Authoring guide:
+  [`docs/dictionary-pipeline.zh-CN.md`](docs/dictionary-pipeline.zh-CN.md).
 
 ## Limitations
 
@@ -143,6 +160,9 @@ then gives you the enhanced sidebar. If you would rather keep your own launcher,
   repointed) has no debug port to attach to, so you get plain Cline.
 * **Cline updates can break things.** If the app renames a label, the locale leaves it in English; if
   it restructures the sidebar, `sidebar-groups` needs updating. Run `ckit audit` and open an issue.
+* **The language switch is in the kit, not in Cline.** Cline has no language setting, so there is no
+  gear icon to find it under: `ckit locales` is the picker (and `ckit install` / the first `ckit start`
+  point at it).
 * **Per-model description blurbs stay English** — free-form text from a remote provider catalogue.
 * **Same-named projects.** Cline's own group headers expose only the folder name, never the path, so if
   the registry holds two different `LLM` folders and one already has a native group, the kit cannot tell

package/README.zh-CN.md

@@ -10,8 +10,8 @@
 在界面上根本不存在。cline-kit 把所有已登记项目常驻列出，样式与原生分组一致，并且可以直接从侧边栏
 切进一个还没有会话的项目。
 
-**附属功能：** 界面语言包（目前简体中文；繁體中文 / 日本語 / 한국어 / Tiếng Việt 用同一套格式）。
-语言包之所以在这里，是因为同一条注入通道顺带能承载它——它不是这个项目存在的理由。
+**附属功能：** 界面语言包，随包 5 份：**zh-CN**（基准，逐条对着界面校过）、繁體中文 / 日本語 /
+한국어 / Tiếng Việt。语言包之所以在这里，是因为同一条注入通道顺带能承载它——它不是这个项目存在的理由。
 
 ## 要解决的问题
 
@@ -52,7 +52,7 @@ ckit start
 
 三条路都是同一个工具，都要求 `PATH` 里有 Node.js，都不碰 `cline-app.exe`。
 
-**1. npm（推荐，发布后适用）**
+**1. npm（推荐）**
 
 ```bash
 npm install -g cline-kit
@@ -73,13 +73,14 @@ ckit.cmd start
 git clone https://github.com/chentaoxing/Cline-kit.git
 cd cline-kit
 npm install -g .        # 或直接用：node src/cli.js <命令>
-npm test                # 22 项无依赖自检
+npm test                # 25 项无依赖自检
 ```
 
 装完统一确认一次：
 
 ```bash
 ckit doctor             # 直接问运行中的窗口：增强层到底进没进去
+ckit locales            # 可选：看有哪些语言、换语言
 ```
 
 `ckit install` 会在开始菜单 / 桌面找到 Cline 快捷方式，把原始目标备份进 `%APPDATA%\cline-kit\config.json`，
@@ -97,12 +98,27 @@ ckit doctor             # 直接问运行中的窗口：增强层到底进没进
 | `ckit attach` | 往你自己启动、已开调试端口的 Cline 注入一次（`--port=N`），不接管快捷方式 |
 | `ckit features` | 列出功能插件与开关状态 |
 | `ckit feature enable\|disable <id>` | 开关某个插件（约 4 秒生效，无需重启） |
+| `ckit locales` | 列出随包发行的界面语言、字符串数与当前语言 |
+| `ckit locales <语言>` | 切换语言，如 `ckit locales ja`（约 4 秒生效，无需重启） |
 | `ckit install` / `uninstall` | 改写 / 还原 Cline 快捷方式 |
 | `ckit update` | 从 GitHub 拉取最新语言词典（`--force` 立即检查） |
 | `ckit audit` | 走查界面，列出仍是英文的字符串 |
 | `ckit dict` | 词典统计与本地覆盖文件路径 |
 | `ckit config` | 查看或设置 `--cline-path`、`--port`、`--auto-update=on\|off`、`--dictionary=<语言>`、`--hide=<路径>` |
 
+### 选择语言
+
+Cline 自己没有语言设置，所以选择权在工具这一侧：
+
+```bash
+ckit locales          # 看有哪些语言、各覆盖多少条、当前用的是哪一个（* 号标记）
+ckit locales ja       # 切换；正在打开的窗口约 4 秒内跟着变，不用重启
+ckit locales zh-CN    # 换回基准词典
+```
+
+`ckit install` 每次都会打印当前语言和这条命令，第一次 `ckit start` 成功后也会提示一次。
+`ckit config --dictionary=<语言>` 是等价的写法。选定非默认语言后，`ckit update` 热更新的就是那一份。
+
 ## 功能
 
 `ckit features` 看实时列表。
@@ -116,8 +132,8 @@ ckit doctor             # 直接问运行中的窗口：增强层到底进没进
   工具标识和代码。语料为 476 条词条 + 30 条规则，来源是「界面走查 + 从应用自身源码提取」两路合并。
   现在随包附带 5 份词典：**zh-CN**（基准，逐条对着运行中的界面校对过）、**zh-TW**、**ja**、**ko**、
   **vi** —— 后四份条目齐全但属于机器辅助翻译、未经母语者审校，术语有偏差欢迎提 PR 直接改。
-  切换：`ckit config --dictionary=ja`，正在打开的窗口**不需要重启或刷新**就会跟着变；
-  `ckit update` 也只更新你选的那一份。制作流程见
+  切换：`ckit locales`（列出并切换）或 `ckit locales ja`，正在打开的窗口**不需要重启或刷新**就会跟着变；
+  `ckit update` 也只更新你选的那一份。详见[选择语言](#选择语言)。制作流程见
   [`docs/dictionary-pipeline.zh-CN.md`](docs/dictionary-pipeline.zh-CN.md)。
 
 ## 已知限制
@@ -129,6 +145,8 @@ ckit doctor             # 直接问运行中的窗口：增强层到底进没进
   得到的是原版界面。
 * **Cline 升级可能失效。** 文案改了，语言包会留英文；侧边栏结构改了，`sidebar-groups` 需要跟进。
   跑一次 `ckit audit` 并开 issue。
+* **语言开关在工具这一侧，不在 Cline 里。** Cline 没有语言设置，所以界面里找不到那个齿轮：
+  `ckit locales` 就是选择器（`ckit install` 和第一次 `ckit start` 都会提示它）。
 * **模型下方的一句英文简介不覆盖**——来自云端目录的自由文本，条数随服务商变化。
 * **同名项目。** Cline 自己的分组标题只有文件夹名、没有路径，所以登记表里出现两个不同盘符下的 `LLM`
   且其中一个已有原生分组时，无法判断哪一个才是它。此时两行都列出（带上级目录区分），并且不在这种行里

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cline-kit",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Desktop enhancement kit for the Cline desktop app (Windows): keeps every registered project visible in the sidebar, and adds optional UI locale packs (zh-CN, zh-TW, ja, ko, vi). Runtime overlay - no binary patching.",
   "keywords": [
     "cline",

package/src/cli.js

@@ -2,8 +2,9 @@
 "use strict";
 // Cline-kit - desktop enhancement kit for the Cline desktop app.
 // Flagship feature: keep every registered project visible in the sidebar.
-// Optional: UI locale packs (zh-CN today; zh-TW / ja / ko / vi follow the same data format).
+// Optional: UI locale packs (zh-CN reference; zh-TW / ja / ko / vi ship the same key set).
 const cfg = require("./config");
+const fs = require("fs");
 
 function guard() {
   if (typeof WebSocket !== "function") {
@@ -26,6 +27,7 @@ Usage: ckit <command> [options]
   uninstall        Restore the original shortcuts
   features         List feature plugins and whether each is on
   feature          Toggle a plugin: ckit feature enable|disable <id>
+  locales          List the UI languages that ship with the kit, and switch between them
   update           Fetch the latest locale dictionary from GitHub (skipped when offline)
   audit            Walk the UI and list strings still without a translation
   dict             Dictionary stats and the local override file path
@@ -40,13 +42,16 @@ Main feature
 Optional feature
   locale packs     dictionaries/<locale>.json - whole-string replacement only, so provider names,
                    model names and code cannot be mangled. Bundled: zh-CN (reference, 476 entries),
-                   zh-TW, ja, ko, vi. Choose one: ckit config --dictionary=ja  (ckit update then
-                   follows that locale). Only zh-CN is proofread against the running app.
+                   zh-TW, ja, ko, vi. Pick one with 'ckit locales' (lists + switches); the older
+                   'ckit config --dictionary=ja' does the same. 'ckit update' then follows that
+                   locale. Only zh-CN is proofread against the running app.
 
 Examples:
   ckit start
   ckit install
   ckit features
+  ckit locales
+  ckit locales ja
   ckit feature disable sidebar-groups
   ckit config --cline-path "D:\\Programs\\Cline\\cline-app.exe"
 `;
@@ -62,6 +67,22 @@ function parseFlags(argv) {
   return { flags, rest };
 }
 
+// Language choice is a per-install decision, so say where to change it once per
+// setup path instead of hiding it in the README. Returns nothing; prints itself.
+function languageTip(conf, showOnce) {
+  if (showOnce) {
+    if (conf.hintLanguageShown) return;
+    conf.hintLanguageShown = true;
+    cfg.write(conf);
+  }
+  const dict = require("./dict");
+  let codes = [];
+  try { codes = dict.available(); } catch (e) { codes = []; }
+  const current = conf.dictionary || "zh-CN";
+  console.log(`Interface language: ${current}  (bundled: ${codes.join(", ") || current})`);
+  console.log("  list / switch with: ckit locales        e.g. ckit locales ja");
+}
+
 async function main() {
   guard();
   const argv = process.argv.slice(2);
@@ -80,6 +101,7 @@ async function main() {
     console.log(out.debugPortAlive
       ? `Cline is up (port ${out.port}, path from ${out.source}) and the overlay is loaded.`
       : `Warning: Cline started but port ${out.port} is not answering; the overlay may not be loaded.`);
+    if (out.debugPortAlive) languageTip(conf, true);
     if (!out.debugPortAlive) process.exitCode = 1;
     return;
   }
@@ -136,6 +158,7 @@ async function main() {
     r.shortcuts.forEach((s) => console.log("  " + s));
     console.log("Launcher: " + r.launcher);
     console.log("Open Cline from those shortcuts from now on; `ckit uninstall` restores them.");
+    languageTip(cfg.read(), false);
     return;
   }
 
@@ -192,6 +215,36 @@ async function main() {
     return;
   }
 
+  if (cmd === "locales" || cmd === "locale") {
+    const dict = require("./dict");
+    const conf2 = cfg.read();
+    const have = dict.available();
+    const target = argv.slice(1).filter((a) => !a.startsWith("--"))[0];
+    if (target) {
+      if (!have.includes(target)) {
+        console.error(`Unknown locale "${target}". Bundled: ${have.join(", ")}`);
+        process.exitCode = 1;
+        return;
+      }
+      conf2.dictionary = target;
+      cfg.write(conf2);
+      console.log(`Language -> ${target} (the injector applies it within ~4 s, no restart needed)`);
+      console.log("Cline must be running through cline-kit for the open window to change; otherwise it");
+      console.log("applies the next time you start it with `ckit start`.");
+      return;
+    }
+    console.log("Bundled UI languages (switch with: ckit locales <code>):\n");
+    for (const code of have) {
+      const d = JSON.parse(fs.readFileSync(dict.bundledPath(code), "utf8"));
+      const n = Object.keys(d.entries || {}).length;
+      const active = (conf2.dictionary || "zh-CN") === code;
+      console.log(`  ${active ? "*  " : "   "}${code.padEnd(7)} ${(d.label || "").padEnd(12)} ${String(n).padStart(4)} strings  v${d.version}`);
+    }
+    console.log("\nOnly zh-CN is proofread against the running app; the others are complete but not");
+    console.log("reviewed by native speakers - see dictionaries/ if you want to fix a term.");
+    return;
+  }
+
   if (cmd === "dict") {
     console.log(JSON.stringify(require("./payload").info(conf), null, 2));
     console.log("Local override file (highest priority): " + cfg.localDictFile(conf.dictionary));

package/src/config.js

@@ -73,7 +73,9 @@ const DEFAULTS = {
   shortcutPath: null,
   autostart: false,
   lastUpdateCheck: 0,
-  remoteVersion: null
+  remoteVersion: null,
+  // one-off: `ckit start` points at `ckit locales` the first time it succeeds
+  hintLanguageShown: false
 };
 
 function read() {