@sparkelf/dsh-plus-standalone 0.1.0-rc.26

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+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.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/standalone/plus-standalone/README.md
+README.md: 8bd85e1755d46688ee70d0881d94377bdc9d80d2
+README.zh.md: 76b49efa5f5a47cd3c8718437b45d73ac4236868

package/README.md

@@ -0,0 +1,73 @@
+---
+description: "Registry installation entry point for DeepSeek Harness Plus: pins the runtime and every reviewed plugin, and carries the generated mount order."
+kind: "package-reference"
+---
+
+# @sparkelf/dsh-plus-standalone
+
+English | [中文](README.zh.md)
+
+Install DeepSeek Harness Plus from the registry and reach the browser UI without a source checkout, a build, or git.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+## Summary
+
+One `npm install` brings the official runtime, the Plus distribution, and every reviewed plugin. `dsh-plus start` then writes the profile the launcher boots, picks a free port, starts the server, and prints the URL. The remaining commands cover what the launcher leaves to the user: stop, status, update, and a doctor check. The package is a manifest whose dependencies and bundle order are generated from the distribution, so a plugin added there cannot reach this package without reaching its mount order too.
+
+## Use this package
+
+```sh
+npm install -g @sparkelf/dsh-plus-standalone
+dsh-plus start
+```
+
+| Command | Effect |
+|---|---|
+| `dsh-plus start` | Writes the profile on first run, picks a free port, starts the server, prints the URL |
+| `dsh-plus stop` | Ends a background server within its grace period |
+| `dsh-plus status` | Reports whether the server is running and on which port |
+| `dsh-plus update` | Moves to a newer published release; `--check` reports without installing |
+| `dsh-plus doctor` | Checks Node, the distribution, the profile, and the port |
+
+## Model Experience
+
+### Standalone installation
+
+#### What the model sees
+
+Nothing. `@sparkelf/dsh-plus-standalone` selects the runtime and the plugins a profile mounts; it registers no tool, prompt section, or Session event of its own. The model meets only what the mounted plugins expose.
+
+#### Token effect
+
+Zero. The package adds no model-request tokens.
+
+#### KV Cache effect
+
+None. It contributes no prompt content, so it cannot shift a cache prefix.
+
+## Known Limitations and Deferred Work
+
+No invariant companion is published because this package selects other packages and observes no relation of its own.
+
+- `dsh-plus update` changes the profile and reinstalls, but a running server keeps the version it started with; restart to load the new release.
+- The manifest carries peer overrides for three published plugins whose declared ranges cannot match the shipped runtime. The overrides are derived and disappear once a plugin fixes its range, but until then that plugin's own declared range stays unsatisfied.
+
+### Dev Note
+
+<details>
+<summary>Working context for maintainers, click to expand</summary>
+
+This Dev Note is working context for maintainers; shipped behavior, limits, and rationale live in the sections above, the package code, and the linked Agent Note.
+
+- The [standalone distribution Agent Note](../../../.agents/notes/proposed/feature/2026-09-11-standalone-distribution.md) owns the installation decision; `package.json` and the `dsh-plus` command in [`packages/bundle/plus/`](../../bundle/plus/README.md) own current behavior.
+- Regenerate this manifest with `pnpm exec tsx scripts/standalone/generate-manifest.ts --distribution packages/bundle/plus --out packages/standalone/plus-standalone/package.json --runtime-version <version>`; it rewrites the derived fields and leaves the identity fields in place.
+
+</details>

package/README.zh.md

@@ -0,0 +1,77 @@
+---
+description: "DeepSeek Harness Plus 的 registry 安装入口：pin runtime 与全部受审 plugin，并携带生成的挂载顺序。"
+kind: "package-reference"
+---
+
+# @sparkelf/dsh-plus-standalone
+
+[English](README.md) | 中文
+
+从 registry 安装 DeepSeek Harness Plus，无需 source checkout、无需构建、无需 git 即可到达浏览器 UI。
+
+## 目录
+
+- [使用此软件包](#use-this-package)
+- [模型体验](#model-experience)
+- [已知限制和延期工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+## 概述
+
+一次 `npm install` 带来 official runtime、Plus distribution 与全部受审 plugin。随后 `dsh-plus start` 写出 launcher 启动所需的 profile、选择空闲端口、启动 server 并打印 URL。其余命令覆盖 launcher 留给用户的部分：stop、status、update 与 doctor 检查。该 package 是一份 manifest，其 dependencies 与 bundle 顺序由 distribution 生成，因此加入其中的 plugin 不可能只进入 distribution 而不进入这里的挂载顺序。
+
+<a id="use-this-package"></a>
+## 使用此软件包
+
+```sh
+npm install -g @sparkelf/dsh-plus-standalone
+dsh-plus start
+```
+
+| Command | Effect |
+|---|---|
+| `dsh-plus start` | 首次运行写出 profile、选择空闲端口、启动 server、打印 URL |
+| `dsh-plus stop` | 在 grace period 内结束后台 server |
+| `dsh-plus status` | 报告 server 是否运行及端口 |
+| `dsh-plus update` | 移到更新的已发布 release；`--check` 只报告不安装 |
+| `dsh-plus doctor` | 检查 Node、distribution、profile 与端口 |
+
+<a id="model-experience"></a>
+## 模型体验
+
+### Standalone installation
+
+#### What the model sees
+
+Nothing。`@sparkelf/dsh-plus-standalone` 选择 profile 挂载的 runtime 与 plugins；它自身不注册任何 tool、prompt section 或 Session event。model 只会遇到被挂载 plugins 所暴露的内容。
+
+#### Token effect
+
+Zero。该 package 不增加任何 model-request tokens。
+
+#### KV Cache effect
+
+None。它不贡献 prompt 内容，因此无法移动 cache prefix。
+
+<a id="known-limitations-and-deferred-work"></a>
+## 已知限制和延期工作
+
+No invariant companion is published because 该 package 只选择其它 package、自身不观察任何关系。
+
+- `dsh-plus update` 会修改 profile 并重装，但正在运行的 server 保持其启动时的版本；restart 才会加载新 release。
+- manifest 为三个已发布 plugin 携带 peer overrides，它们声明的范围无法匹配所交付的 runtime。overrides 是推导出来的，plugin 修正其范围后即消失；在那之前该 plugin 自己声明的范围仍未被满足。
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者工作上下文，点击展开</summary>
+
+本 Dev Note 是维护者的工作上下文；已交付行为、限制与理由位于上文各节、package code 与所链接的 Agent Note。
+
+- [独立发行版 Agent Note](../../../.agents/notes/proposed/feature/2026-09-11-standalone-distribution.zh.md) 负责安装决策；`package.json` 与 [`packages/bundle/plus/`](../../bundle/plus/README.zh.md) 中的 `dsh-plus` command 负责当前行为。
+- 用 `pnpm exec tsx scripts/standalone/generate-manifest.ts --distribution packages/bundle/plus --out packages/standalone/plus-standalone/package.json --runtime-version <version>` 重新生成该 manifest；它会重写派生字段并保留身份字段。
+
+</details>

package/lib/index.js

@@ -0,0 +1,30 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region lib/types/index.js
+/**
+* The standalone Plus distribution.
+*
+* This package exists to be installed, not to be called: its manifest pins the
+* distribution and its runtime, and the profile it needs is written by `dsh-plus
+* start`. The module exports the two facts a consumer or a gate may want to read
+* without parsing the distribution's own manifest.
+*
+* @module @sparkelf/dsh-plus-standalone
+*/
+/** Profile this installation owns. */
+const PROFILE = "plus";
+/** Distribution package this installation pins. */
+const DISTRIBUTION = "@sparkelf/dsh-plus";
+/**
+* Official runtime version this installation targets.
+*
+* @returns the pinned `@deepseek-ai/dsh` version.
+*/
+function runtimeVersion() {
+	const pinned = JSON.parse(readFileSync(join(fileURLToPath(new URL("..", import.meta.url)), "../../package.json"), "utf8")).dependencies?.["@deepseek-ai/dsh"];
+	if (pinned === void 0) throw new Error("the standalone manifest pins no @deepseek-ai/dsh version");
+	return pinned;
+}
+//#endregion
+export { DISTRIBUTION, PROFILE, runtimeVersion };

package/lib/types/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The standalone Plus distribution.
+ *
+ * This package exists to be installed, not to be called: its manifest pins the
+ * distribution and its runtime, and the profile it needs is written by `dsh-plus
+ * start`. The module exports the two facts a consumer or a gate may want to read
+ * without parsing the distribution's own manifest.
+ *
+ * @module @sparkelf/dsh-plus-standalone
+ */
+/** Profile this installation owns. */
+export declare const PROFILE = "plus";
+/** Distribution package this installation pins. */
+export declare const DISTRIBUTION = "@sparkelf/dsh-plus";
+/**
+ * Official runtime version this installation targets.
+ *
+ * @returns the pinned `@deepseek-ai/dsh` version.
+ */
+export declare function runtimeVersion(): string;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.js

@@ -0,0 +1,30 @@
+/**
+ * The standalone Plus distribution.
+ *
+ * This package exists to be installed, not to be called: its manifest pins the
+ * distribution and its runtime, and the profile it needs is written by `dsh-plus
+ * start`. The module exports the two facts a consumer or a gate may want to read
+ * without parsing the distribution's own manifest.
+ *
+ * @module @sparkelf/dsh-plus-standalone
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Profile this installation owns. */
+export const PROFILE = 'plus';
+/** Distribution package this installation pins. */
+export const DISTRIBUTION = '@sparkelf/dsh-plus';
+/**
+ * Official runtime version this installation targets.
+ *
+ * @returns the pinned `@deepseek-ai/dsh` version.
+ */
+export function runtimeVersion() {
+    const manifest = JSON.parse(readFileSync(join(fileURLToPath(new URL('..', import.meta.url)), '../../package.json'), 'utf8'));
+    const pinned = manifest.dependencies?.['@deepseek-ai/dsh'];
+    if (pinned === undefined)
+        throw new Error('the standalone manifest pins no @deepseek-ai/dsh version');
+    return pinned;
+}
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,109 @@
+{
+  "dependencies": {
+    "@changfenhuang/dsh-genui": "0.9.9",
+    "@deepseek-ai/dsh": ">=0.1.5-rc.2",
+    "@huanlin/dsh-plugin-better-locale": "0.4.1",
+    "@huanlin/dsh-plugin-better-sidebar-plugin-office": "0.2.0",
+    "@sparkelf/dsh-api-client": "0.5.1",
+    "@sparkelf/dsh-mineru": "0.1.2",
+    "@sparkelf/dsh-mobile-bridge": ">=0.2.11",
+    "@sparkelf/dsh-officecli": "0.1.2",
+    "@sparkelf/dsh-plugin-supervisor": "0.1.5",
+    "@sparkelf/dsh-ssh-manager": "0.7.2",
+    "@sparkelf/dsh-workbench-vault": "0.1.2",
+    "dsh-better-sidebar": "0.19.1",
+    "dsh-sql-workbench": "0.5.1",
+    "dsh-video-preview": "0.1.4",
+    "dshmarket": ">=1.45.1",
+    "semver": ">=7.7.3",
+    "yaml": ">=2.9.0"
+  },
+  "description": "Install and run DeepSeek Harness Plus from the registry: no source checkout and no build.",
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  },
+  "dshPlusStandalone": {
+    "allowBuilds": {
+      "@officecli/officecli": true,
+      "cpu-features": false,
+      "node-pty": true,
+      "oracledb": true,
+      "protobufjs": false,
+      "ssh2": true
+    },
+    "bundles": [
+      "@deepseek-ai/dsh-base",
+      "@deepseek-ai/dsh-web-app",
+      "@sparkelf/dsh-mineru",
+      "@sparkelf/dsh-officecli",
+      "@sparkelf/dsh-mobile-bridge",
+      "dshmarket",
+      "@huanlin/dsh-plugin-better-locale",
+      "dsh-better-sidebar",
+      "@huanlin/dsh-plugin-better-sidebar-plugin-office",
+      "dsh-video-preview",
+      "@changfenhuang/dsh-genui",
+      "@sparkelf/dsh-plugin-supervisor",
+      "@sparkelf/dsh-plus",
+      "dsh-sql-workbench",
+      "@sparkelf/dsh-ssh-manager",
+      "@sparkelf/dsh-api-client"
+    ],
+    "formatVersion": 1,
+    "peerOverrides": [
+      {
+        "name": "@huanlin/dsh-plugin-better-locale",
+        "reason": "dsh-better-sidebar@0.19.1 declares ^0.1.0, which 0.1.5-rc.2 does not satisfy",
+        "version": "0.4.1"
+      },
+      {
+        "name": "dsh-better-sidebar",
+        "reason": "@huanlin/dsh-plugin-better-sidebar-plugin-office@0.2.0 declares ^0.17.0, which 0.1.5-rc.2 does not satisfy",
+        "version": "0.19.1"
+      },
+      {
+        "name": "@deepseek-ai/dsh-settings",
+        "reason": "dshmarket@>=1.45.1 declares ^0.1.0-rc.7 || ^0.1.1-rc.2 || ^0.1.2-alpha.2, which 0.1.5-rc.2 does not satisfy",
+        "version": "0.1.5-rc.2"
+      }
+    ],
+    "profile": "plus"
+  },
+  "exports": {
+    ".": {
+      "default": "./lib/index.js",
+      "types": "./lib/types/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.d.ts",
+    "README.md",
+    "README.zh.md",
+    "README.i18n.yaml"
+  ],
+  "license": "MIT",
+  "main": "lib/index.js",
+  "name": "@sparkelf/dsh-plus-standalone",
+  "overrides": {
+    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
+    "@huanlin/dsh-plugin-better-locale": "0.4.1",
+    "dsh-better-sidebar": "0.19.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.2"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "directory": "packages/standalone/plus-standalone",
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git"
+  },
+  "type": "module",
+  "types": "lib/types/index.d.ts",
+  "version": "0.1.0-rc.26"
+}