@karoc/dsh-proxy 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [0.1.2]
+
+- **Brand name**: DSH Smoothly Proxy (DSH SP) — used in the README, settings page title, and changelog.
+
+## [0.1.1]
+
+- **dsh 0.1.2 compatibility:** the loader identity now matches the npm package
+  name everywhere. `client-modules` serves graph rows under the package name
+  (`@karoc/dsh-proxy`) and the browser module system awaits factories
+  registered under that exact id — the bundle previously registered as
+  `dsh-proxy` (the pre-rename tsdown ID), so on dsh ≥ 0.1.2 the entry import
+  failed and cascaded into duplicate-factory errors that dropped every
+  external plugin's client half. Aligned: module-table ID (`tsdown.config.ts`),
+  loader entry `name` (`cordis.patch.yml`, the runtime id stays `dsh-proxy`),
+  and the host `export const name`. Runtime business ids (settings.section id,
+  locale namespace, CSS prefix, style-tag marker) are unchanged.
+- **First tarball with the correct scoped identity:** the 0.1.0 tarball shipped
+  the old unscoped patch/ID, which worked on dsh < 0.1.2 but failed the graph
+  row match on newer dsh. 0.1.1 is the first release where the package name,
+  loader entry name, bundle registration id, and host name are all
+  `@karoc/dsh-proxy`.
+- **Release-flow hardening:** `release:check` now fails fast when `tsdown` is
+  not resolvable from PATH (a never-installed project would otherwise fail
+  mid-publish with `tsdown: not found`); fixes a template-literal syntax error
+  in `post-publish-check.mjs` that crashed the postpublish lifecycle (and hid
+  the fact that the upload had actually succeeded).
+- Tests: `client-boot.spec.mjs` asserts the scoped registration id; engine /
+  host-route / mount / tooltip acceptance suites unchanged and passing.
+
 ## [0.1.0]
 
 - Initial release: external DeepSeek Harness plugin providing a model-provider

package/CONTRIBUTING.md

@@ -54,6 +54,14 @@ tag). The gate script (`pnpm release:check`, also run by `prepack` and
 5. Working tree is clean (everything committed).
 6. `lib/` is present and fresh (run `pnpm bundle` after touching `src/`).
 7. The version is not already published on npm.
+8. **Identity parity:** `tsdown.config.ts` module-table ID, the loader entry
+   `name` in `cordis.patch.yml`, and the host `export const name` in
+   `src/index.ts` must all equal the npm package name (`@karoc/dsh-proxy`).
+   `client-modules` serves graph rows under the package name and the browser
+   awaits factories under that exact id; a mismatch drops the client half on
+   dsh ≥ 0.1.2. Runtime business ids (settings.section id, locale NS, CSS
+   prefix, style-tag marker) intentionally stay `dsh-proxy`. The `release-check`
+   gate does not verify this — check it before tagging.
 
 Release steps:
 

package/README.md

@@ -1,4 +1,4 @@
-# dsh-proxy
+# DSH Smoothly Proxy (DSH SP)
 
 English | [简体中文](README.zh.md)
 
@@ -6,9 +6,9 @@ English | [简体中文](README.zh.md)
 [![npm downloads](https://img.shields.io/npm/dm/@karoc/dsh-proxy.svg)](https://www.npmjs.com/package/@karoc/dsh-proxy)
 [![license MIT](https://img.shields.io/npm/l/@karoc/dsh-proxy.svg)](LICENSE)
 
-An **external** DeepSeek Harness plugin: a model-provider **forward proxy** with
-**per-host routing**, plus a **Settings page** dedicated to model-provider
-proxying.
+DSH Smoothly Proxy (**DSH SP**) is an **external** DeepSeek Harness plugin: a
+model-provider **forward proxy** with **per-host routing**, plus a **Settings
+page** dedicated to model-provider proxying.
 
 It runs a loopback forward proxy inside the dsh host process, points the
 process's egress traffic at it (`HTTP(S)_PROXY` + `NODE_USE_ENV_PROXY`), and
@@ -196,6 +196,13 @@ module table; everything else is inlined.
   external plugin cannot set it without patching the shell. When DSH exposes a
   per-section icon, use `IconGlobeOutline14` from `dsh-client-ui-primitives`
   for this section.
+- **Works with dsh ≥ 0.1.2 when installed the official way.** The loader
+  entry name, bundle registration id, and host plugin name are all
+  `@karoc/dsh-proxy` (matching the npm package name). Hand-written `link:`
+  dependencies are not recognized as packages by newer loaders — install via
+  `dsh plugin --profile web add @karoc/dsh-proxy` (npm) or
+  `dsh plugin --profile web add link:/path/to/dsh-proxy` (source), then restart
+  `dsh web`.
 - The desktop shell (`dsh-desktop`) keeps its own proxy and tray settings
   window — this plugin is a standalone extraction, not a replacement. Both can
   coexist (e.g. install `dsh-proxy` into the shell's profile to get the

package/README.zh.md

@@ -1,4 +1,4 @@
-# dsh-proxy
+# DSH Smoothly Proxy（DSH SP）
 
 [English](README.md) | 简体中文
 
@@ -6,7 +6,7 @@
 [![npm downloads](https://img.shields.io/npm/dm/@karoc/dsh-proxy.svg)](https://www.npmjs.com/package/@karoc/dsh-proxy)
 [![license MIT](https://img.shields.io/npm/l/@karoc/dsh-proxy.svg)](LICENSE)
 
-一个**外部** DeepSeek Harness 插件：为**模型提供方**提供带**按主机路由**的**正向代理**，并附带一个专职设置页。
+DSH Smoothly Proxy（**DSH SP**）是一个**外部** DeepSeek Harness 插件：为**模型提供方**提供带**按主机路由**的**正向代理**，并附带一个专职设置页。
 
 它在 dsh host 进程内启动一个 loopback 正向代理，把进程的出站流量指向它（`HTTP(S)_PROXY` + `NODE_USE_ENV_PROXY`），**只把你在设置页勾选的主机**转发到可选的上游代理（HTTP / HTTPS / SOCKS5，支持可选 Basic 认证），其余全部直连。模型提供方主机从你的 dsh `settings.yaml` 读取，流量中观测到的主机也会被收集——两者都以复选框形式出现。
 
@@ -149,6 +149,7 @@ bundle 把平台包（`react`、`@deepseek-ai/cordis`、`@deepseek-ai/dsh-client
 - **代理是进程级出站点，不是模型逐请求读的开关。** 它通过把进程的 `HTTP(S)_PROXY` 指向自身来实现。本插件 host `apply()` 之后 dsh 发起的请求（任何子进程、以及 global dispatcher 仍是惰性的 undici fetch）会走代理。若某个 dsh 内部 fetch 在插件加载前就已实体化了 dispatcher，可能不会走它——文档化的解法是重启 dsh（桌面壳通过 spawn dsh 前设环境变量来施加同样的边界）。
 - `npm`/`pnpm` 安装/更新流量与其它一样走代理；改动**与安装/更新相关的主机**会在下次安装/更新时生效（已在进行的操作保留其环境）。
 - **设置页导航图标由壳分配，插件无法自定义。** 内置 `ui-settings-general` 的 `SettingsRoot.tsx` `navIcon(id)` 只映射已知 id，其它 id（包括本节的 `dsh-proxy`）一律齿轮。`settings.section` 注册没有 icon 字段，外部插件不 patch 壳就改不了。等 DSH 开放每节图标后，本节建议用 `dsh-client-ui-primitives` 的 `IconGlobeOutline14`。
+- **dsh ≥ 0.1.2 需以官方方式安装才生效。** loader entry 名、bundle 注册 id、host 插件名三者均为 `@karoc/dsh-proxy`（与 npm 包名一致）。新版 loader 不再把手写 `link:` 依赖识别为包——请用 `dsh plugin --profile web add @karoc/dsh-proxy`（npm）或 `dsh plugin --profile web add link:/path/to/dsh-proxy`（源码）安装，然后重启 `dsh web`。
 - 桌面壳（`dsh-desktop`）保留自己的代理与托盘设置窗口——本插件是独立抽取，不是替代品。两者可共存（例如把 `dsh-proxy` 装进壳的 profile，同时获得 dsh 内设置页）。
 
 ## License

package/cordis.patch.yml

@@ -2,7 +2,9 @@
 # package so the host loader resolves the node half and client-modules serves
 # exports["./client"] at /plugins/dsh-proxy/client.js. The host half starts the
 # loopback forward proxy and registers /proxy/api; the client half registers
-# the settings.section settings page.
+# the settings.section settings page. The loader entry `name` must equal the
+# npm package name (@karoc/dsh-proxy) — client-modules resolves it as a
+# package; the runtime plugin id stays `dsh-proxy`.
 - insert:
     - id: dsh-proxy
-      name: dsh-proxy
+      name: '@karoc/dsh-proxy'

package/lib/client.js

@@ -1,5 +1,5 @@
 window.__ModuleLoader__.load({
-	id: "dsh-proxy",
+	id: "@karoc/dsh-proxy",
 	factory: (require) => {
 		var module = { exports: {} };
 		var exports = module.exports;
@@ -528,12 +528,13 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/locales.ts
 		/**
-		* Copy dictionaries for the Proxy settings section. English is the key source
-		* (en object keyed by the same strings), zh must carry every key.
+		* Copy dictionaries for the Proxy settings section (DSH Smoothly Proxy / DSH SP).
+		* English is the key source (en object keyed by the same strings), zh must
+		* carry every key.
 		*/
 		const en = {
 			nav: "Proxy",
-			title: "Proxy settings",
+			title: "DSH Smoothly Proxy (DSH SP)",
 			subtitle: "Model-provider traffic through an optional upstream proxy, per host.",
 			upstreamTitle: "Upstream proxy (optional)",
 			upstreamEnabled: "Enable upstream proxy (when off, every host connects directly)",
@@ -571,7 +572,7 @@ window.__ModuleLoader__.load({
 		};
 		const zh = {
 			nav: "代理",
-			title: "代理设置",
+			title: "DSH Smoothly Proxy（DSH SP）",
 			subtitle: "按主机把模型提供方流量转发到可选的上游代理。",
 			upstreamTitle: "上游代理（可选）",
 			upstreamEnabled: "启用上游代理（未启用时所有主机直连）",

package/lib/index.js

@@ -758,7 +758,7 @@ function testUpstreamProxy(upstream) {
 }
 //#endregion
 //#region src/index.ts
-const name = "dsh-proxy";
+const name = "@karoc/dsh-proxy";
 const inject = ["webServer"];
 /** Resolve the harness home: $DSH_HOME (blank = unset) else ~/.dsh. */
 function resolveDshHome() {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@karoc/dsh-proxy",
-  "version": "0.1.0",
-  "description": "External DeepSeek Harness plugin: a model-provider forward proxy with per-host routing and a Settings page.",
+  "version": "0.1.2",
+  "description": "DSH Smoothly Proxy (DSH SP): external DeepSeek Harness plugin — a model-provider forward proxy with per-host routing and a Settings page.",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -44,7 +44,7 @@
     "postpublish": "node scripts/post-publish-check.mjs"
   },
   "engines": { "node": ">=18" },
-  "keywords": ["deepseek-harness", "dsh", "plugin", "proxy", "model-provider", "settings"],
+  "keywords": ["deepseek-harness", "dsh", "plugin", "proxy", "model-provider", "settings", "smoothly-proxy", "sp"],
   "author": "karoc",
   "license": "MIT",
   "repository": { "type": "git", "url": "git+https://github.com/karoc/dsh-proxy.git" },