@qlingzzy/qling 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 ## Unreleased
 
+## v1.2.1 (2026-07-15)
+
+### Official distribution + strict layers + self-contained portable
+
+- **分层**：清零反向依赖；`ci:check` 启用 `dep:layers --strict`；`installSlashPorts` + `DurableSessionSupervisor` 上提 `agent/`。
+- **便携包**：`build:portable-win` 内嵌 Node 运行时（`runtime/node.exe`），无需本机安装 Node。
+- **Scoop/winget**：manifest 指向 GitHub Release portable zip；多文件 winget 清单；官方 PR 按审阅修正 64bit 结构与 hash 格式。
+- **公共 Scoop bucket**：https://github.com/Zzy-min/scoop-qling
+
 ## v1.2.0 (2026-07-14)
 
 ### Phase 8.0 — Sprint 5 分层治理 + 分发资产

package/README.en.md

@@ -2,7 +2,7 @@
 
 [![Node](https://img.shields.io/badge/Node-%E2%89%A518-339933?logo=node.js&logoColor=white)](#requirements)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-1.2.0-orange.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-1.2.1-orange.svg)](CHANGELOG.md)
 [![Release](https://img.shields.io/github/v/release/Zzy-min/qling?display_name=tag&sort=semver)](https://github.com/Zzy-min/qling/releases)
 
 **Qling** is a **local-first** AI Agent CLI workbench. It keeps sessions, tools, skills, permissions, diagnostics, long-running missions, and recovery controls in one auditable terminal console.
@@ -178,14 +178,14 @@ QLING_EVAL_LLM=1 npm run eval:llm
 | Channel | Status |
 |---------|--------|
 | Source + bootstrap | Ready |
-| npm `@qlingzzy/qling` | **Published** `1.2.0` — install with `--registry https://registry.npmjs.org/` if your default is a mirror |
+| npm `@qlingzzy/qling` | **Published** `1.2.1` — install with `--registry https://registry.npmjs.org/` if your default is a mirror |
 | Scoop | Draft + real tarball SHA256; not in official buckets |
 | winget | Draft YAML only (needs portable zip + SHA256) |
 | Portable zip / single binary | Not yet |
 
 ## Version
 
-- Package: `1.2.0` (see latest tag on GitHub for hotfixes)
+- Package: `1.2.1` (see latest tag on GitHub for hotfixes)
 - Changelog: [CHANGELOG.md](CHANGELOG.md)
 - Specs / plans: `docs/superpowers/`
 

package/README.md

@@ -2,7 +2,7 @@
 
 [![Node](https://img.shields.io/badge/Node-%E2%89%A518-339933?logo=node.js&logoColor=white)](#环境要求)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-1.2.0-orange.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-1.2.1-orange.svg)](CHANGELOG.md)
 
 [English](README.en.md) · [安装指南](docs/install.md) · [CHANGELOG](CHANGELOG.md)
 
@@ -63,7 +63,7 @@ qling
 # 或从 GitHub 直接全局安装
 npm install -g github:Zzy-min/qling
 
-# npm 官方包（已发布 1.2.0；作用域名，CLI 仍是 qling）
+# npm 官方包（已发布 1.2.1；作用域名，CLI 仍是 qling）
 # 若默认 registry 是国内镜像，请显式指定官方源
 npm install -g @qlingzzy/qling --registry https://registry.npmjs.org/
 ```
@@ -402,7 +402,7 @@ npm audit --registry=https://registry.npmjs.org --audit-level=high
 
 ## 版本与变更
 
-- 当前版本：`1.2.0`
+- 当前版本：`1.2.1`
 
 - 完整变更历史：见 [CHANGELOG.md](CHANGELOG.md)
 - 安装与分发：见 [docs/install.md](docs/install.md)、[packaging/](packaging/)

package/dist/agent/durable-session-supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-session-supervisor.d.ts","sourceRoot":"","sources":["../../src/agent/durable-session-supervisor.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,+BAA+B;IAMpD,KAAK,IAAI,IAAI;IAQP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAOb,IAAI;YAyBJ,iBAAiB;YAcjB,iBAAiB;YAiBjB,sBAAsB;YAiCtB,cAAc;YAoCd,iBAAiB;YAyBjB,WAAW;CA8B1B"}

package/dist/{session → agent}/durable-session-supervisor.js

@@ -4,9 +4,9 @@ import * as path from "path";
 import { AgentLoop } from "../agent-loop.js";
 import { applyConfigToProcessEnv, loadQlingConfig } from "../config.js";
 import { buildToolRegistry } from "../tools/index.js";
-import { SessionGoalController } from "./goal-controller.js";
-import { SessionGoalManager } from "./session-goal-manager.js";
-import { SessionScheduler } from "./session-scheduler.js";
+import { SessionGoalController } from "../session/goal-controller.js";
+import { SessionGoalManager } from "../session/session-goal-manager.js";
+import { SessionScheduler } from "../session/session-scheduler.js";
 export class DurableSessionSupervisor {
     stateDir;
     tickIntervalMs;

package/dist/daemon.js

@@ -13,7 +13,7 @@ import dotenv from "dotenv";
 import { SessionScheduler } from "./session/session-scheduler.js";
 import { SessionGoalController } from "./session/goal-controller.js";
 import { SessionGoalManager } from "./session/session-goal-manager.js";
-import { DurableSessionSupervisor } from "./session/durable-session-supervisor.js";
+import { DurableSessionSupervisor } from "./agent/durable-session-supervisor.js";
 import { formatDaemonVersion } from "./package-version.js";
 const HOME_DIR = os.homedir();
 const DEFAULT_STATE_DIR = path.join(HOME_DIR, ".qling");

package/dist/index.js

@@ -15,6 +15,8 @@ import axios from "axios";
 import { AgentLoop } from "./agent-loop.js";
 import { Repl } from "./repl.js";
 import { StreamingREPL } from "./tui/streaming-repl.js";
+import { installSlashPorts } from "./slash-ports.js";
+import { handleSlashCommand, findSlashCompletion, formatSlashCommandPanel, formatGroupedSlashPanel, } from "./commands/index.js";
 import { buildHelpText, formatCliError, parseCliArgs } from "./cli/startup-contract.js";
 import { runBootstrap } from "./cli/bootstrap.js";
 import { applyConfigToProcessEnv, loadQlingConfig } from "./config.js";
@@ -1111,6 +1113,14 @@ async function main() {
                 process.exit(1);
             }
         }
+        installSlashPorts({
+            handleSlashCommand,
+            ui: {
+                findSlashCompletion,
+                formatSlashCommandPanel,
+                formatGroupedSlashPanel,
+            },
+        });
         if (decision.mode === "chat") {
             const repl = new StreamingREPL(agent, {
                 continueSession: decision.global.continueSession,

package/dist/repl.d.ts

@@ -1,4 +1,5 @@
 import { AgentLoop } from "./agent-loop.js";
+import { type SlashCommandHandler } from "./slash-ports.js";
 export type ReplInputResult = "continue" | "exit";
 export declare class Repl {
     private agent;
@@ -10,9 +11,11 @@ export declare class Repl {
     private controllersSessionId;
     private immediatePrompt;
     private runningScheduledTask;
+    private readonly handleSlashCommandOverride?;
     constructor(agent?: AgentLoop, options?: {
         resumeSession?: string;
         continueSession?: boolean;
+        handleSlashCommand?: SlashCommandHandler;
     });
     start(): Promise<void>;
     private loop;

package/dist/repl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQ5C,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,CAAC;AAMlD,qBAAa,IAAI;IACf,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,EAAE,CAAqB;IAC/B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,oBAAoB,CAAS;gBAGnC,KAAK,CAAC,EAAE,SAAS,EACjB,OAAO,GAAE;QACP,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;KACtB;IAWF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAqBd,IAAI;IAeZ,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;YA+EhD,aAAa;YA8Bb,6BAA6B;YAqC7B,gCAAgC;IAoB9C,OAAO,CAAC,kBAAkB;YAkBZ,iCAAiC;YAwBjC,sBAAsB;IAepC,OAAO,CAAC,+BAA+B;YAezB,uBAAuB;IAWrC,OAAO,CAAC,oBAAoB;YASd,wBAAwB;IAatC,OAAO,CAAC,iBAAiB;YAKX,6BAA6B;YAwC7B,4BAA4B;YAS5B,aAAa;YAWb,uBAAuB;YAMvB,sBAAsB;IAcpC,OAAO,CAAC,0BAA0B;IAIlC,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,8BAA8B;YAYxB,6BAA6B;CAS5C"}
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,CAAC;AAMlD,qBAAa,IAAI;IACf,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,EAAE,CAAqB;IAC/B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAsB;gBAGhE,KAAK,CAAC,EAAE,SAAS,EACjB,OAAO,GAAE;QACP,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;KACrC;IAYF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAqBd,IAAI;IAeZ,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;YAgFhD,aAAa;YA8Bb,6BAA6B;YAqC7B,gCAAgC;IAoB9C,OAAO,CAAC,kBAAkB;YAkBZ,iCAAiC;YAwBjC,sBAAsB;IAepC,OAAO,CAAC,+BAA+B;YAezB,uBAAuB;IAWrC,OAAO,CAAC,oBAAoB;YASd,wBAAwB;IAatC,OAAO,CAAC,iBAAiB;YAKX,6BAA6B;YAwC7B,4BAA4B;YAS5B,aAAa;YAWb,uBAAuB;YAMvB,sBAAsB;IAcpC,OAAO,CAAC,0BAA0B;IAIlC,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,8BAA8B;YAYxB,6BAA6B;CAS5C"}

package/dist/repl.js

@@ -4,7 +4,7 @@
 // ============================================================
 import * as readline from "readline";
 import { AgentLoop } from "./agent-loop.js";
-import { handleSlashCommand } from "./commands/index.js";
+import { resolveSlashHandler, } from "./slash-ports.js";
 import { SessionGoalController } from "./session/goal-controller.js";
 import { SessionGoalManager } from "./session/session-goal-manager.js";
 import { SessionScheduler } from "./session/session-scheduler.js";
@@ -18,10 +18,12 @@ export class Repl {
     controllersSessionId = null;
     immediatePrompt = null;
     runningScheduledTask = false;
+    handleSlashCommandOverride;
     constructor(agent, options = {}) {
         this.agent = agent ?? new AgentLoop();
         this.startupResumeTarget = options.resumeSession;
         this.startupContinue = options.continueSession ?? false;
+        this.handleSlashCommandOverride = options.handleSlashCommand;
         this.rl = readline.createInterface({
             input: process.stdin,
             output: process.stdout,
@@ -114,6 +116,7 @@ export class Repl {
         if (trimmedInput.startsWith("/")) {
             await this.ensureLocalSessionControllers();
             this.immediatePrompt = null;
+            const handleSlashCommand = await resolveSlashHandler(this.handleSlashCommandOverride);
             const handledSlashCommand = await handleSlashCommand(trimmedInput, this.createSlashContext());
             if (handledSlashCommand) {
                 if (this.immediatePrompt) {

package/dist/slash-ports.d.ts

@@ -0,0 +1,24 @@
+import type { SlashCommandContext } from "./slash-context.js";
+export type SlashCommandHandler = (input: string, context: SlashCommandContext | Record<string, any>) => Promise<boolean>;
+export interface SlashCatalogItem {
+    name: string;
+    description?: string;
+    aliases?: string[];
+}
+export type FindSlashCompletion = (prefix: string, limit?: number) => SlashCatalogItem[];
+export type FormatSlashPanel = (prefix: string, selectedIndex?: number, width?: number, limit?: number) => string[];
+export type FormatGroupedSlashPanel = (width?: number) => string[];
+export interface SlashUiPorts {
+    findSlashCompletion: FindSlashCompletion;
+    formatSlashCommandPanel: FormatSlashPanel;
+    formatGroupedSlashPanel: FormatGroupedSlashPanel;
+}
+export interface SlashRuntimePorts {
+    handleSlashCommand: SlashCommandHandler;
+    ui?: SlashUiPorts;
+}
+export declare function installSlashPorts(ports: SlashRuntimePorts): void;
+export declare function getInstalledSlashPorts(): SlashRuntimePorts | null;
+export declare function resolveSlashHandler(override?: SlashCommandHandler): Promise<SlashCommandHandler>;
+export declare function resolveSlashUiPorts(override?: SlashUiPorts): Promise<SlashUiPorts>;
+//# sourceMappingURL=slash-ports.d.ts.map

package/dist/slash-ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-ports.d.ts","sourceRoot":"","sources":["../src/slash-ports.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAC/C,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;AACzF,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;AACpH,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,uBAAuB,EAAE,gBAAgB,CAAC;IAC1C,uBAAuB,EAAE,uBAAuB,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,EAAE,CAAC,EAAE,YAAY,CAAC;CACnB;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAEhE;AAED,wBAAgB,sBAAsB,IAAI,iBAAiB,GAAG,IAAI,CAEjE;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAK9B;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CASxF"}

package/dist/slash-ports.js

@@ -0,0 +1,31 @@
+// ============================================================
+// Slash ports — agent-runtime / presentation 依赖的抽象，避免直接 import cli/commands
+// ============================================================
+/** 由 cli 入口注入；未注入时 runtime 使用动态 import 回退（不形成静态分层边） */
+let installedPorts = null;
+export function installSlashPorts(ports) {
+    installedPorts = ports;
+}
+export function getInstalledSlashPorts() {
+    return installedPorts;
+}
+export async function resolveSlashHandler(override) {
+    if (override)
+        return override;
+    if (installedPorts?.handleSlashCommand)
+        return installedPorts.handleSlashCommand;
+    const mod = await import("./commands/index.js");
+    return mod.handleSlashCommand;
+}
+export async function resolveSlashUiPorts(override) {
+    if (override)
+        return override;
+    if (installedPorts?.ui)
+        return installedPorts.ui;
+    const mod = await import("./commands/index.js");
+    return {
+        findSlashCompletion: mod.findSlashCompletion,
+        formatSlashCommandPanel: mod.formatSlashCommandPanel,
+        formatGroupedSlashPanel: mod.formatGroupedSlashPanel,
+    };
+}

package/dist/tui/streaming-repl.d.ts

@@ -1,4 +1,5 @@
 import { AgentLoop } from "../agent-loop.js";
+import { type SlashCommandHandler, type SlashUiPorts } from "../slash-ports.js";
 export declare class StreamingREPL {
     private ui;
     private agent;
@@ -13,9 +14,12 @@ export declare class StreamingREPL {
     private closed;
     private onClose;
     private lastExecutionStatus;
+    private readonly handleSlashCommandOverride?;
     constructor(agent?: AgentLoop, options?: {
         resumeSession?: string;
         continueSession?: boolean;
+        handleSlashCommand?: SlashCommandHandler;
+        slashUi?: SlashUiPorts;
     });
     start(): Promise<void>;
     stop(): Promise<void>;

package/dist/tui/streaming-repl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streaming-repl.d.ts","sourceRoot":"","sources":["../../src/tui/streaming-repl.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAa7C,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,mBAAmB,CAAM;gBAG/B,KAAK,CAAC,EAAE,SAAS,EACjB,OAAO,GAAE;QACP,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;KACtB;IAyBF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAIb,KAAK;IAkBnB,OAAO,CAAC,eAAe;IA8DvB,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,kBAAkB;YAqDZ,gBAAgB;YAKhB,iBAAiB;YAoBjB,qBAAqB;YAQrB,uBAAuB;YAQvB,aAAa;YAsEb,eAAe;YASf,2BAA2B;IA4BzC,OAAO,CAAC,0BAA0B;YAkCpB,qBAAqB;IAgCnC,OAAO,CAAC,kBAAkB;YAWZ,6BAA6B;YAU7B,yBAAyB;YA2BzB,aAAa;CAsB5B"}
+{"version":3,"file":"streaming-repl.d.ts","sourceRoot":"","sources":["../../src/tui/streaming-repl.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI7C,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAS3B,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,mBAAmB,CAAM;IACjC,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAsB;gBAGhE,KAAK,CAAC,EAAE,SAAS,EACjB,OAAO,GAAE;QACP,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;QACzC,OAAO,CAAC,EAAE,YAAY,CAAC;KACnB;IA0BF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAIb,KAAK;IAkBnB,OAAO,CAAC,eAAe;IA8DvB,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,kBAAkB;YAqDZ,gBAAgB;YAKhB,iBAAiB;YAoBjB,qBAAqB;YAQrB,uBAAuB;YAQvB,aAAa;YAsEb,eAAe;YASf,2BAA2B;IA4BzC,OAAO,CAAC,0BAA0B;YAkCpB,qBAAqB;IAiCnC,OAAO,CAAC,kBAAkB;YAWZ,6BAA6B;YAU7B,yBAAyB;YA2BzB,aAAa;CAsB5B"}

package/dist/tui/streaming-repl.js

@@ -10,8 +10,8 @@
 // ============================================================
 import { AgentLoop } from "../agent-loop.js";
 import { StreamUI } from "./streaming-tui.js";
-import { handleSlashCommand } from "../commands/index.js";
 import { SessionScheduler } from "../session/session-scheduler.js";
+import { resolveSlashHandler, } from "../slash-ports.js";
 import { SessionGoalManager } from "../session/session-goal-manager.js";
 import { SessionGoalController } from "../session/goal-controller.js";
 import { DaemonSessionApi } from "../session/daemon-session-api.js";
@@ -32,14 +32,16 @@ export class StreamingREPL {
     closed = false;
     onClose = null;
     lastExecutionStatus = "";
+    handleSlashCommandOverride;
     constructor(agent, options = {}) {
         this.agent = agent ?? new AgentLoop();
         const model = this.agent.getModel();
         const toolsCount = this.agent.getToolCount();
-        this.ui = new StreamUI(model, toolsCount);
+        this.ui = new StreamUI(model, toolsCount, { slashUi: options.slashUi });
         this.daemonSessionApi = new DaemonSessionApi();
         this.startupResumeTarget = options.resumeSession;
         this.startupContinue = options.continueSession ?? false;
+        this.handleSlashCommandOverride = options.handleSlashCommand;
         this.inputQueue = new SerialInputQueue({
             maxPending: 20,
             onQueued: ({ pendingCount }) => {
@@ -402,6 +404,7 @@ export class StreamingREPL {
         }
         // v0.4 Slash Commands
         this.immediatePrompt = null;
+        const handleSlashCommand = await resolveSlashHandler(this.handleSlashCommandOverride);
         const handled = await handleSlashCommand(input, this.createSlashContext());
         if (handled) {
             // plan/model/permissions 等变更后刷新 chrome + statusline

package/dist/tui/streaming-tui.d.ts

@@ -1,3 +1,4 @@
+import { type SlashUiPorts } from "../slash-ports.js";
 import type { RecoveryState } from "../execution/types.js";
 export type AgentEvent = {
     type: "tool_start";
@@ -73,8 +74,11 @@ export declare class StreamUI {
     private recoveryState;
     private readonly now;
     private readonly doubleCtrlCExitWindowMs;
+    private slashUi;
+    private readonly slashUiPromise;
     constructor(model?: string, tools?: number, options?: {
         now?: () => number;
+        slashUi?: SlashUiPorts;
     });
     start(): void;
     stop(): void;

package/dist/tui/streaming-tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streaming-tui.d.ts","sourceRoot":"","sources":["../../src/tui/streaming-tui.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"streaming-tui.d.ts","sourceRoot":"","sources":["../../src/tui/streaming-tui.ts"],"names":[],"mappings":"AAmBA,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAe3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAgE3D,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxF;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAIzC,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAQb;IACP,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,aAAa,CAAiD;IACtE,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,aAAa,CAAW;IAChC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,6BAA6B,CAAmC;IACxE,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,yBAAyB,CAAK;IACtC,OAAO,CAAC,wBAAwB,CAAK;IACrC,OAAO,CAAC,sBAAsB,CAAK;IACnC,OAAO,CAAC,4BAA4B,CAAK;IACzC,OAAO,CAAC,iBAAiB,CAAmC;IAC5D,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IACjD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;gBAGrD,KAAK,GAAE,MAAwB,EAC/B,KAAK,GAAE,MAAU,EACjB,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,YAAY,CAAA;KAAO;IAgB9D,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;IAkBZ,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIjD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIxC,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI5C,eAAe,CAAC,MAAM,EAAE;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,IAAI;IAIR,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAKnD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOlC,OAAO,CAAC,kBAAkB;IAa1B,sBAAsB,IAAI,OAAO;IAIjC,uBAAuB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAIhD,0BAA0B,IAAI,OAAO;IAKrC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAInC,aAAa,CAAC,KAAK,GAAE,MAAgB,EAAE,UAAU,GAAE,MAAe,GAAG,IAAI;IAYzE,YAAY,IAAI,IAAI;IAQpB,OAAO,CAAC,WAAW;IAiCnB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,oBAAoB;IA+C5B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,8BAA8B;IAMtC,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,eAAe;IA4EvB,OAAO,CAAC,iCAAiC;IAuBzC,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,4BAA4B;IAepC,UAAU,IAAI,IAAI;IASlB,iCAAiC;IACjC,uBAAuB,IAAI,OAAO;IAMlC,OAAO,CAAC,UAAU;IAyLlB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,eAAe;IAqBvB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMpD,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAW1F,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAYvF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAUlC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIzC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMtE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOhC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQnC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAOtE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAwB/B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAI3C,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAIrC"}

package/dist/tui/streaming-tui.js

@@ -15,7 +15,7 @@
 // appendFinal / appendError / appendState / appendDone
 // ============================================================
 import { default as stringWidth } from "string-width";
-import { findSlashCompletion, formatSlashCommandPanel, formatGroupedSlashPanel } from "../commands/index.js";
+import { resolveSlashUiPorts, } from "../slash-ports.js";
 import { InputBuffer } from "./input-buffer.js";
 import { formatProgressPulse } from "./progress.js";
 import { formatWelcomeGuide, formatRoleHeader, formatResultHighlight, formatToolOutputCard, formatToolTimelineRow, formatTopBar, padVisible, truncateVisible, } from "./shell.js";
@@ -104,13 +104,26 @@ export class StreamUI {
     recoveryState = null;
     now;
     doubleCtrlCExitWindowMs = 2_000;
+    slashUi = null;
+    slashUiPromise;
     constructor(model = "deepseek-chat", tools = 0, options = {}) {
         this.model = model;
         this.tools = tools;
         this.now = options.now ?? (() => Date.now());
+        if (options.slashUi) {
+            this.slashUi = options.slashUi;
+            this.slashUiPromise = Promise.resolve(options.slashUi);
+        }
+        else {
+            this.slashUiPromise = resolveSlashUiPorts().then((ports) => {
+                this.slashUi = ports;
+                return ports;
+            });
+        }
     }
     start() {
         this.running = true;
+        void this.slashUiPromise;
         this.printHeader();
         this.printInputBar();
         this.setupInput();
@@ -486,15 +499,20 @@ export class StreamUI {
     formatCurrentSlashCompletionHints() {
         if (!this.isSlashCompletionActive(this.input.value))
             return [];
-        const matches = findSlashCompletion(this.input.value, 8);
+        const ports = this.slashUi;
+        if (!ports) {
+            void this.slashUiPromise;
+            return [];
+        }
+        const matches = ports.findSlashCompletion(this.input.value, 8);
         if (matches.length > 0 && this.slashCompletionSelectedIndex >= matches.length) {
             this.slashCompletionSelectedIndex = 0;
         }
         const inputVal = this.input.value || "";
         if (inputVal === "/" || inputVal === "") {
-            return formatGroupedSlashPanel(process.stdout.columns || 80);
+            return ports.formatGroupedSlashPanel(process.stdout.columns || 80);
         }
-        return formatSlashCommandPanel(inputVal, this.slashCompletionSelectedIndex, process.stdout.columns || 80, 8);
+        return ports.formatSlashCommandPanel(inputVal, this.slashCompletionSelectedIndex, process.stdout.columns || 80, 8);
     }
     isSlashCompletionPrefix(value) {
         const text = value.trim();
@@ -506,7 +524,12 @@ export class StreamUI {
     acceptSlashCompletion() {
         if (!this.isSlashCompletionPrefix(this.input.value))
             return false;
-        const matches = findSlashCompletion(this.input.value, 8);
+        const ports = this.slashUi;
+        if (!ports) {
+            void this.slashUiPromise;
+            return false;
+        }
+        const matches = ports.findSlashCompletion(this.input.value, 8);
         const completion = matches[this.slashCompletionSelectedIndex] ?? matches[0];
         if (!completion)
             return false;
@@ -521,7 +544,12 @@ export class StreamUI {
     moveSlashCompletionSelection(delta) {
         if (!this.isSlashCompletionPrefix(this.input.value))
             return false;
-        const matches = findSlashCompletion(this.input.value, 8);
+        const ports = this.slashUi;
+        if (!ports) {
+            void this.slashUiPromise;
+            return false;
+        }
+        const matches = ports.findSlashCompletion(this.input.value, 8);
         if (matches.length <= 1)
             return false;
         this.slashCompletionSelectedIndex =

package/docs/install.md

@@ -89,13 +89,19 @@ qling
 ### D1. 本仓库自建 bucket（推荐试用）
 
 ```powershell
-cd path\to\qling
-scoop bucket add qling "$PWD\packaging\scoop-bucket"
-scoop install qling/qling
+# 公共 bucket（推荐）
+scoop bucket add qling https://github.com/Zzy-min/scoop-qling
+scoop install qling
+
+# 或从本仓库本地路径
+# scoop bucket add qling "$PWD\packaging\scoop-bucket"
+# scoop install qling/qling
+
 qling --version
 ```
 
-说明见 `packaging/scoop-bucket/README.md`。清单含真实 npm tarball SHA256；若原生模块 shim 不理想，manifest 会提示改用 npm 全局安装。
+便携包内嵌 Node 运行时，**无需系统安装 Node**。公共 bucket：https://github.com/Zzy-min/scoop-qling  
+官方 Extras PR：https://github.com/ScoopInstaller/Extras/pull/18307
 
 ### D2. 校验与同步
 
@@ -117,7 +123,7 @@ npm run build:portable-win
 # → dist-portable/qling-win-x64.zip + portable-meta.json (sha256)
 ```
 
-Release 资产示例：`https://github.com/Zzy-min/qling/releases/download/v1.2.0/qling-win-x64.zip`  
+Release 资产示例：`https://github.com/Zzy-min/qling/releases/download/v1.2.1/qling-win-x64.zip`  
 清单：`packaging/winget/Zzy-min.qling.yaml`（含 InstallerSha256）。
 
 ### 本地校验
@@ -127,7 +133,7 @@ npm run validate:packaging
 Select-String -Path packaging/winget/Zzy-min.qling.yaml -Pattern 'PackageVersion|InstallerUrl|InstallerSha256'
 ```
 
-正式提交 [winget-pkgs](https://github.com/microsoft/winget-pkgs) 仍需 PR；在此之前可用 zip 解压 + `qling.cmd`（需本机 Node ≥ 18）。
+正式提交 [winget-pkgs](https://github.com/microsoft/winget-pkgs) 仍需 PR；在此之前可用 zip 解压 + `qling.cmd`（便携 zip 已内嵌 Node 运行时（亦可使用系统 Node））。
 
 ## 配置与安全
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qlingzzy/qling",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "轻灵 Qling - 本地优先的中文 AI Agent CLI 工作台 / Local-first Chinese AI Agent CLI workbench",
   "type": "module",
   "main": "./dist/sdk.js",
@@ -92,7 +92,8 @@
     "dep:layers:write-baseline": "node scripts/dep-layers.mjs --write-baseline",
     "sync:scoop-bucket": "node scripts/sync-scoop-bucket.mjs",
     "build:portable-win": "node scripts/build-portable-win.mjs",
-    "ci:check": "npm run build && node --experimental-test-module-mocks --test \"tests/unit/**/*.test.mjs\" && node --test \"tests/smoke/**/*.test.mjs\" && node scripts/eval-smoke.mjs && node scripts/eval-tasks.mjs && node scripts/validate-packaging.mjs && node scripts/dep-layers.mjs --baseline"
+    "sync:winget-sha": "node scripts/sync-winget-sha.mjs",
+    "ci:check": "npm run build && node --experimental-test-module-mocks --test \"tests/unit/**/*.test.mjs\" && node --test \"tests/smoke/**/*.test.mjs\" && node scripts/eval-smoke.mjs && node scripts/eval-tasks.mjs && node scripts/validate-packaging.mjs && node scripts/dep-layers.mjs --strict"
   },
   "dependencies": {
     "axios": "^1.7.0",

package/scripts/build-portable-win.mjs

@@ -1,16 +1,17 @@
 #!/usr/bin/env node
 /**
- * Build a Windows portable zip for winget / manual install.
- * Usage: node scripts/build-portable-win.mjs
+ * Build a Windows portable zip that embeds a Node.js runtime (no system Node required).
+ * Usage: node scripts/build-portable-win.mjs [--skip-node]
  *
  * Output: dist-portable/qling-win-x64.zip
  * Layout:
  *   qling-win-x64/
- *     package/          # npm pack contents
- *     qling.cmd         # launcher → node package/dist/index.js
+ *     runtime/node.exe   # bundled Node (same major as build host by default)
+ *     package/           # npm pack contents
+ *     qling.cmd          # launcher → runtime\node.exe package\dist\index.js
  *     README.txt
  */
-import { spawnSync } from "node:child_process";
+import { spawnSync, execFileSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import {
   mkdir,
@@ -18,31 +19,34 @@ import {
   readFile,
   writeFile,
   copyFile,
-  readdir,
-  stat,
+  access,
 } from "node:fs/promises";
-import { createWriteStream, existsSync, createReadStream } from "node:fs";
+import { createWriteStream, existsSync } from "node:fs";
 import { join, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { pipeline } from "node:stream/promises";
-import { createGzip } from "node:zlib";
-import { execFileSync } from "node:child_process";
+import { get } from "node:https";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const ROOT = resolve(__dirname, "..");
 const OUT_DIR = join(ROOT, "dist-portable");
 const STAGE = join(OUT_DIR, "qling-win-x64");
 const ZIP_PATH = join(OUT_DIR, "qling-win-x64.zip");
+const skipNode = process.argv.includes("--skip-node");
 
 const pkg = JSON.parse(await readFile(join(ROOT, "package.json"), "utf8"));
 const version = pkg.version;
+const nodeVersion = process.version; // e.g. v22.22.1
+const nodeDistName = `node-${nodeVersion}-win-x64`;
+const nodeZipUrl = `https://nodejs.org/dist/${nodeVersion}/${nodeDistName}.zip`;
 
 console.log(`[portable] building qling ${version} for win-x64…`);
+console.log(`[portable] host node ${nodeVersion} ${process.arch}`);
 
 await rm(OUT_DIR, { recursive: true, force: true });
 await mkdir(STAGE, { recursive: true });
 
-// Prefer npm pack of current tree (matches publish)
+// 1) npm pack current tree
 const pack = spawnSync(
   process.platform === "win32" ? "npm.cmd" : "npm",
   ["pack", "--pack-destination", OUT_DIR],
@@ -64,61 +68,92 @@ if (!tgzName) {
 const tgzPath = join(OUT_DIR, tgzName);
 console.log(`[portable] packed ${tgzName}`);
 
-// Extract with tar (Node 22+ / Windows 10+ tar)
-const pkgDir = join(STAGE, "package");
-await mkdir(pkgDir, { recursive: true });
 try {
   execFileSync("tar", ["-xzf", tgzPath, "-C", STAGE], { stdio: "inherit" });
-  // npm pack extracts to package/
 } catch (err) {
   console.error("tar extract failed:", err instanceof Error ? err.message : err);
   process.exit(1);
 }
 
+// 2) Bundle Node runtime
+const runtimeDir = join(STAGE, "runtime");
+await mkdir(runtimeDir, { recursive: true });
+let bundledNode = false;
+let nodeNote = "System Node.js >= 18 on PATH";
+
+if (!skipNode && process.platform === "win32") {
+  const cacheDir = join(OUT_DIR, ".node-cache");
+  await mkdir(cacheDir, { recursive: true });
+  const nodeZipPath = join(cacheDir, `${nodeDistName}.zip`);
+  if (!existsSync(nodeZipPath)) {
+    console.log(`[portable] downloading ${nodeZipUrl}`);
+    await downloadFile(nodeZipUrl, nodeZipPath);
+  } else {
+    console.log(`[portable] using cached ${nodeZipPath}`);
+  }
+  const extractDir = join(cacheDir, nodeDistName);
+  await rm(extractDir, { recursive: true, force: true });
+  execFileSync("tar", ["-xf", nodeZipPath, "-C", cacheDir], { stdio: "inherit" });
+  const nodeExeSrc = join(extractDir, "node.exe");
+  await access(nodeExeSrc);
+  await copyFile(nodeExeSrc, join(runtimeDir, "node.exe"));
+  // LICENSE if present
+  const license = join(extractDir, "LICENSE");
+  if (existsSync(license)) {
+    await copyFile(license, join(runtimeDir, "NODE-LICENSE"));
+  }
+  bundledNode = true;
+  nodeNote = `Bundled Node ${nodeVersion} (runtime\\node.exe)`;
+  console.log(`[portable] bundled node.exe from ${nodeDistName}`);
+} else if (!skipNode) {
+  console.warn("[portable] non-Windows host: skip embedding node.exe (use --skip-node to silence)");
+}
+
 const launcher = `@echo off
 setlocal
 set "ROOT=%~dp0"
-set "NODE="
-where node >nul 2>nul && set "NODE=node"
-if not defined NODE (
-  echo [qling] Node.js ^>= 18 is required on PATH.
+set "NODE_EXE="
+if exist "%ROOT%runtime\\node.exe" set "NODE_EXE=%ROOT%runtime\\node.exe"
+if not defined NODE_EXE (
+  where node >nul 2>nul && set "NODE_EXE=node"
+)
+if not defined NODE_EXE (
+  echo [qling] No bundled runtime and no system Node on PATH.
+  echo [qling] Re-download the portable zip or install Node.js ^>= 18.
   exit /b 1
 )
-"%NODE%" "%ROOT%package\\dist\\index.js" %*
+"%NODE_EXE%" "%ROOT%package\\dist\\index.js" %*
 `;
 await writeFile(join(STAGE, "qling.cmd"), launcher, "utf8");
 
 const readme = `Qling ${version} — Windows portable layout
 ========================================
 
-Requirements:
-  - Node.js >= 18 on PATH
-  - Visual Studio Build Tools may be needed for better-sqlite3 rebuilds
+${bundledNode ? "This build embeds a Node.js runtime — no system Node install required." : "This build expects system Node.js >= 18 on PATH."}
+
+Runtime:
+  ${nodeNote}
 
 Run:
   .\\qling.cmd --version
   .\\qling.cmd doctor
   .\\qling.cmd setup
 
-Preferred install for most users:
+Notes:
+  - better-sqlite3 native binary is compiled for the Node ABI used at pack time.
+  - Prefer matching the bundled Node major version if you replace runtime\\node.exe.
+
+npm alternative:
   npm install -g @qlingzzy/qling@${version} --registry https://registry.npmjs.org/
 
 Source: https://github.com/Zzy-min/qling
 `;
 await writeFile(join(STAGE, "README.txt"), readme, "utf8");
 
-// Zip via tar (bsdtar on Windows supports zip)
 await rm(ZIP_PATH, { force: true });
-try {
-  execFileSync(
-    "tar",
-    ["-a", "-cf", ZIP_PATH, "-C", OUT_DIR, "qling-win-x64"],
-    { stdio: "inherit" }
-  );
-} catch (err) {
-  console.error("zip failed:", err instanceof Error ? err.message : err);
-  process.exit(1);
-}
+execFileSync("tar", ["-a", "-cf", ZIP_PATH, "-C", OUT_DIR, "qling-win-x64"], {
+  stdio: "inherit",
+});
 
 const buf = await readFile(ZIP_PATH);
 const sha256 = createHash("sha256").update(buf).digest("hex");
@@ -128,10 +163,31 @@ const meta = {
   path: ZIP_PATH,
   size: buf.length,
   sha256,
+  bundledNode,
+  nodeVersion: bundledNode ? nodeVersion : null,
   createdAt: new Date().toISOString(),
 };
 await writeFile(join(OUT_DIR, "portable-meta.json"), JSON.stringify(meta, null, 2) + "\n");
 
 console.log(`[portable] wrote ${ZIP_PATH}`);
 console.log(`[portable] size=${buf.length} sha256=${sha256}`);
+console.log(`[portable] bundledNode=${bundledNode}`);
 console.log(`[portable] meta: dist-portable/portable-meta.json`);
+
+function downloadFile(url, dest) {
+  return new Promise((resolvePromise, reject) => {
+    const file = createWriteStream(dest);
+    get(url, (res) => {
+      if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        file.close();
+        downloadFile(res.headers.location, dest).then(resolvePromise, reject);
+        return;
+      }
+      if (res.statusCode !== 200) {
+        reject(new Error(`download failed: HTTP ${res.statusCode}`));
+        return;
+      }
+      pipeline(res, file).then(resolvePromise, reject);
+    }).on("error", reject);
+  });
+}

package/scripts/dep-layers.mjs

@@ -70,6 +70,7 @@ export function layerOf(rel) {
     p.startsWith("tools/") ||
     p.startsWith("execution/") ||
     p === "slash-context.ts" ||
+    p === "slash-ports.ts" ||
     p === "repl.ts"
   ) {
     return "agent-runtime";

package/scripts/sync-winget-sha.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * Fill winget InstallerSha256 from dist-portable/portable-meta.json
+ */
+import { readFile, writeFile, readdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+const metaPath = join(root, "dist-portable", "portable-meta.json");
+if (!existsSync(metaPath)) {
+  console.error("missing dist-portable/portable-meta.json — run npm run build:portable-win first");
+  process.exit(1);
+}
+const meta = JSON.parse(await readFile(metaPath, "utf8"));
+const sha = String(meta.sha256 || "").toLowerCase();
+if (!/^[a-f0-9]{64}$/.test(sha)) {
+  console.error("invalid sha256 in portable-meta.json");
+  process.exit(1);
+}
+
+const version = meta.version || JSON.parse(await readFile(join(root, "package.json"), "utf8")).version;
+const targets = [
+  join(root, "packaging", "winget", "Zzy-min.qling.yaml"),
+  join(root, "packaging", "winget", "manifests", "Zzy-min", "qling", version, "Zzy-min.qling.installer.yaml"),
+];
+
+for (const file of targets) {
+  if (!existsSync(file)) {
+    console.warn("skip missing", file);
+    continue;
+  }
+  let text = await readFile(file, "utf8");
+  text = text.replace(/InstallerSha256:\s*[A-Za-z0-9_]+/g, `InstallerSha256: ${sha}`);
+  text = text.replace(/PackageVersion:\s*[\d.]+/g, `PackageVersion: ${version}`);
+  text = text.replace(/v[\d.]+\//g, `v${version}/`);
+  await writeFile(file, text, "utf8");
+  console.log("updated", file);
+}
+
+// Scoop: rewrite Extras-compatible 64bit manifest
+const { spawnSync } = await import("node:child_process");
+const scoopScript = join(root, "scripts", "write-scoop-manifest.mjs");
+const r = spawnSync(process.execPath, [scoopScript], { cwd: root, encoding: "utf8" });
+process.stdout.write(r.stdout || "");
+process.stderr.write(r.stderr || "");
+if (r.status !== 0) process.exit(r.status || 1);
+
+// Multi-file winget for this version dir (create if missing)
+const multiDir = join(root, "packaging", "winget", "manifests", "Zzy-min", "qling", version);
+if (!existsSync(multiDir)) {
+  console.warn("note: multi-file winget dir missing for", version, "- create under packaging/winget/manifests");
+}
+
+console.log(`sync-winget-sha OK version=${version} sha=${sha.slice(0, 16)}… bundledNode=${meta.bundledNode}`);

package/scripts/validate-packaging.mjs

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 /**
- * Validate Scoop / winget draft manifests align with package.json version.
+ * Validate Scoop / winget manifests align with package.json version.
  * Usage: node scripts/validate-packaging.mjs
  */
 import { readFile } from "node:fs/promises";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
 
 const root = join(dirname(fileURLToPath(import.meta.url)), "..");
 const errors = [];
@@ -18,17 +19,26 @@ const scoop = JSON.parse(scoopRaw);
 if (scoop.version !== version) {
   errors.push(`scoop version ${scoop.version} != package ${version}`);
 }
-if (!String(scoop.url || "").includes(version)) {
-  errors.push(`scoop url does not pin ${version}: ${scoop.url}`);
+const scoopUrl =
+  scoop.architecture?.["64bit"]?.url || scoop.url || "";
+const scoopHash =
+  scoop.architecture?.["64bit"]?.hash || scoop.hash || "";
+if (!String(scoopUrl).includes(version)) {
+  errors.push(`scoop url does not pin ${version}: ${scoopUrl}`);
 }
-if (!Array.isArray(scoop.notes) || !scoop.notes.some((n) => /DRAFT|draft/i.test(n))) {
-  errors.push("scoop notes should mark DRAFT status");
+if (!scoop.architecture?.["64bit"]) {
+  errors.push("scoop should nest url/hash under architecture.64bit (Extras style)");
 }
-const hash = String(scoop.hash || "");
-if (!hash || /TODO|REPLACE/i.test(hash)) {
-  errors.push("scoop hash still placeholder — fill real SHA256 after npm publish");
-} else if (!/^(sha256:)?[a-f0-9]{64}$/i.test(hash)) {
-  errors.push(`scoop hash looks invalid: ${hash}`);
+if (!scoopHash || /TODO|REPLACE|PLACEHOLDER/i.test(String(scoopHash))) {
+  errors.push("scoop hash still placeholder — run build:portable-win + sync-winget-sha");
+} else if (!/^(sha256:)?[a-f0-9]{64}$/i.test(String(scoopHash))) {
+  errors.push(`scoop hash looks invalid: ${scoopHash}`);
+}
+if (/sha256:/i.test(String(scoopHash))) {
+  errors.push("scoop hash should be plain hex (no sha256: prefix) for Extras");
+}
+if (!String(scoop.bin || "").includes("qling")) {
+  errors.push("scoop bin should expose qling");
 }
 
 const winget = await readFile(
@@ -41,8 +51,36 @@ if (!winget.includes(`PackageVersion: ${version}`)) {
 if (!winget.includes("PackageIdentifier: Zzy-min.qling")) {
   errors.push("winget PackageIdentifier missing");
 }
-if (!/DRAFT|not submitted/i.test(winget)) {
-  errors.push("winget should remain marked as DRAFT");
+if (/InstallerSha256:\s*(0{64}|PLACEHOLDER)/i.test(winget)) {
+  errors.push("winget InstallerSha256 is still placeholder");
+}
+
+const multiInstaller = join(
+  root,
+  "packaging",
+  "winget",
+  "manifests",
+  "Zzy-min",
+  "qling",
+  version,
+  "Zzy-min.qling.installer.yaml"
+);
+if (existsSync(multiInstaller)) {
+  const mi = await readFile(multiInstaller, "utf8");
+  if (/InstallerSha256:\s*(0{64}|PLACEHOLDER)/i.test(mi)) {
+    errors.push("multi-file winget installer sha still placeholder");
+  }
+  if (!mi.includes(`PackageVersion: ${version}`)) {
+    errors.push("multi-file winget installer version mismatch");
+  }
+}
+
+const bucket = join(root, "packaging", "scoop-bucket", "qling.json");
+if (existsSync(bucket)) {
+  const b = JSON.parse(await readFile(bucket, "utf8"));
+  if (b.version !== version) errors.push("scoop-bucket version mismatch");
+  const bHash = b.architecture?.["64bit"]?.hash || b.hash;
+  if (bHash !== scoopHash) errors.push("scoop-bucket hash out of sync with scoop/qling.json");
 }
 
 if (errors.length) {
@@ -52,6 +90,6 @@ if (errors.length) {
 }
 
 console.log(`validate-packaging OK (version ${version})`);
-console.log("  scoop:", scoop.url);
+console.log("  scoop:", scoopUrl);
+console.log("  scoop.hash:", String(scoopHash).slice(0, 20) + "…");
 console.log("  winget: Zzy-min.qling @", version);
-console.log("  note: still drafts — not published to official catalogs");

package/scripts/write-scoop-manifest.mjs

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * Write Scoop-compatible manifest (Extras style):
+ * - 4-space indent
+ * - plain SHA256 (no sha256: prefix)
+ * - architecture.64bit for url/hash/extract_dir
+ * - autoupdate.architecture.64bit
+ *
+ * Reads dist-portable/portable-meta.json when present.
+ */
+import { readFile, writeFile } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+const pkg = JSON.parse(await readFile(join(root, "package.json"), "utf8"));
+const version = pkg.version;
+
+let hash = "PLACEHOLDER";
+const metaPath = join(root, "dist-portable", "portable-meta.json");
+if (existsSync(metaPath)) {
+  const meta = JSON.parse(await readFile(metaPath, "utf8"));
+  hash = String(meta.sha256 || "").toLowerCase();
+}
+
+const manifest = {
+  version,
+  description: "Local-first Chinese AI Agent CLI workbench (Qling / 轻灵).",
+  homepage: "https://github.com/Zzy-min/qling",
+  license: "MIT",
+  notes: [
+    "Portable zip embeds a Node.js runtime (no system Node required).",
+    "Set API keys as user environment variables (never commit secrets).",
+    "After install: run qling doctor, then qling setup.",
+  ],
+  architecture: {
+    "64bit": {
+      url: `https://github.com/Zzy-min/qling/releases/download/v${version}/qling-win-x64.zip`,
+      hash,
+      extract_dir: "qling-win-x64",
+    },
+  },
+  bin: "qling.cmd",
+  post_install: [
+    "Write-Host 'Run qling doctor, then qling setup.' -ForegroundColor Cyan",
+  ],
+  checkver: {
+    github: "https://github.com/Zzy-min/qling",
+  },
+  autoupdate: {
+    architecture: {
+      "64bit": {
+        url: "https://github.com/Zzy-min/qling/releases/download/v$version/qling-win-x64.zip",
+      },
+    },
+  },
+};
+
+const json = JSON.stringify(manifest, null, 4) + "\n";
+const targets = [
+  join(root, "packaging", "scoop", "qling.json"),
+  join(root, "packaging", "scoop-bucket", "qling.json"),
+];
+for (const t of targets) {
+  await writeFile(t, json, "utf8");
+  console.log("wrote", t);
+}
+console.log(`version=${version} hash=${hash.slice(0, 16)}…`);

package/dist/session/durable-session-supervisor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"durable-session-supervisor.d.ts","sourceRoot":"","sources":["../../src/session/durable-session-supervisor.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,+BAA+B;IAMpD,KAAK,IAAI,IAAI;IAQP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAOb,IAAI;YAyBJ,iBAAiB;YAcjB,iBAAiB;YAiBjB,sBAAsB;YAiCtB,cAAc;YAoCd,iBAAiB;YAyBjB,WAAW;CA8B1B"}