@qlingzzy/qling 1.0.0 → 1.1.0

package/dist/tui/streaming-tui.js

@@ -18,7 +18,7 @@ import { default as stringWidth } from "string-width";
 import { findSlashCompletion, formatSlashCommandPanel, formatGroupedSlashPanel } from "../commands/index.js";
 import { InputBuffer } from "./input-buffer.js";
 import { formatProgressPulse } from "./progress.js";
-import { formatBottomHints, formatWelcomeGuide, formatRoleHeader, formatToolOutputCard, formatToolTimelineRow, formatTopBar, padVisible, truncateVisible, } from "./shell.js";
+import { formatWelcomeGuide, formatRoleHeader, formatResultHighlight, formatToolOutputCard, formatToolTimelineRow, formatTopBar, padVisible, truncateVisible, } from "./shell.js";
 import { formatMarkdownForTerminal } from "./markdown.js";
 import { getPackageVersion } from "../package-version.js";
 // ── ANSI 颜色工具 ───────────────────────────────────────
@@ -101,6 +101,7 @@ export class StreamUI {
     slashCompletionSelectedIndex = 0;
     inputCursorAnchor = "current";
     inputStartRow = 0;
+    recoveryState = null;
     now;
     doubleCtrlCExitWindowMs = 2_000;
     constructor(model = "deepseek-chat", tools = 0, options = {}) {
@@ -148,6 +149,30 @@ export class StreamUI {
         if (next)
             this.model = next;
     }
+    setRecoveryState(state) {
+        this.recoveryState = state ? { ...state } : null;
+        if (state?.status === "paused")
+            this.appendRecoveryCard(state);
+    }
+    setInputDraft(draft) {
+        this.input.clear();
+        for (const ch of draft)
+            ch === "\n" ? this.input.insertNewline() : this.input.insertChar(ch);
+        this.draftDisplaySource = draft.includes("\n") ? "typed" : null;
+        this.redrawInput();
+    }
+    appendRecoveryCard(state) {
+        this.moveAfterInputFrame();
+        const failure = state.lastFailure;
+        process.stdout.write("\n" + [
+            S.y("执行已暂停"),
+            `${DIM("原因")} ${failure?.category ?? "unknown"}: ${failure?.message ?? "-"}`,
+            `${DIM("证据")} ${failure?.fingerprint ?? "-"}  ${DIM("剩余预算")} ${state.remainingStrategyAttempts}`,
+            `${S.p("R")} 重试  ${S.p("S")} 下一策略  ${S.p("E")} 编辑任务  ${S.p("C")} 取消并保存摘要`,
+        ].join("\n") + "\n");
+        this.writeInputValue(true);
+        this.syncCursor();
+    }
     isExpandLongToolOutput() {
         return this.expandLongToolOutput;
     }
@@ -210,13 +235,12 @@ export class StreamUI {
         process.stdout.write(chunks.join(""));
     }
     // ── 底部输入栏 ────────────────────────────────────
+    /**
+     * 输入框上方不再堆叠 statusline / 快捷键黑灰提示（去噪）。
+     * 详情仍可通过 /statusline、/shortcuts 与顶栏查看。
+     */
     printPromptHint() {
-        const chunks = [];
-        if (this.statusLineEnabled && this.statusLine) {
-            chunks.push(DIM(this.statusLine) + "\n");
-        }
-        chunks.push(DIM(formatBottomHints()) + "\n");
-        process.stdout.write(chunks.join(""));
+        // intentionally empty — keep input chrome minimal
     }
     printInputBar() {
         this.printPromptHint();
@@ -537,6 +561,11 @@ export class StreamUI {
         this.dataHandler = (chunk) => {
             if (!this.running)
                 return;
+            if (this.recoveryState?.status === "paused" && !this.input.value && /^[rsec]$/i.test(chunk)) {
+                const action = { r: "retry", s: "next", e: "edit", c: "cancel" }[chunk.toLowerCase()];
+                this.inputCallback?.(`/recover ${action}`);
+                return;
+            }
             if (chunk === "\x1b") {
                 partial = "";
                 return;
@@ -610,6 +639,10 @@ export class StreamUI {
                     partial = "";
                     this.handleTab();
                 }
+                else if (seq === "\x1b[Z") {
+                    partial = "";
+                    this.handleShiftTab();
+                }
                 else if (seq === "\x03") {
                     partial = "";
                     this.handleCtrlC();
@@ -751,6 +784,14 @@ export class StreamUI {
         }
         this.appendFeedbackAndRedraw(S.y("Tab agents 仅在空输入时打开；当前草稿已保留，补全未启用"));
     }
+    handleShiftTab() {
+        this.lastEmptyCtrlCAt = 0;
+        this.moveAfterInputFrame();
+        process.stdout.write("\n");
+        if (this.inputCallback) {
+            this.inputCallback("/mode cycle");
+        }
+    }
     handleCtrlC() {
         if (!this.input.value) {
             const now = this.now();
@@ -1029,11 +1070,28 @@ export class StreamUI {
         process.stdout.write("\n  " + S.d("retry:") + " " + S.y(String(retryCount)));
     }
     appendFinal(text) {
-        process.stdout.write("\n" + S.p(formatRoleHeader("assistant")) + "\n");
         const width = process.stdout.columns || 100;
-        const lines = formatMarkdownForTerminal(text, { width });
-        for (const line of lines) {
-            process.stdout.write(line + "\n");
+        const mdWidth = Math.max(40, width - 4);
+        const mdLines = formatMarkdownForTerminal(text, { width: mdWidth });
+        process.stdout.write("\n" + S.p(BOLD(formatRoleHeader("assistant"))) + "  " + S.g(BOLD("结果")) + "\n");
+        const box = formatResultHighlight({
+            header: "结果",
+            lines: mdLines,
+            width,
+        });
+        for (let i = 0; i < box.length; i++) {
+            const line = box[i];
+            // 顶/底与左右边框用强调色；正文保留 Markdown 原色
+            if (i === 0 || i === box.length - 1) {
+                process.stdout.write(S.g(BOLD(line)) + "\n");
+            }
+            else if (line.startsWith("│ ") && line.endsWith(" │")) {
+                const mid = line.slice(2, line.length - 2);
+                process.stdout.write(S.g("│ ") + mid + S.g(" │") + "\n");
+            }
+            else {
+                process.stdout.write(S.g(line) + "\n");
+            }
         }
     }
     appendError(text) {
@@ -1044,6 +1102,6 @@ export class StreamUI {
     }
     appendDone(durationMs) {
         const dur = fmtDur(durationMs);
-        process.stdout.write("\n" + S.g("☑ 分析完成") + " " + DIM(dur));
+        process.stdout.write("\n" + S.g(BOLD("☑ 任务完成")) + "  " + S.p(dur) + "\n");
     }
 }

package/dist/types.d.ts

@@ -37,7 +37,6 @@ export interface AgentConfig {
     systemPrompt: string;
     maxIterations: number;
     tools: ToolDefinition[];
-    tokenBudget?: TokenBudgetConfig;
     sections?: PromptSectionRegistry;
     runtime?: {
         workspaceDir: string | null;
@@ -45,7 +44,6 @@ export interface AgentConfig {
         fileStateDir: string;
         maxSteps: number;
         parseRetries: number;
-        maxTokenBudget: number;
         toolRepeatLimit: number;
         timeoutMs: number;
     };
@@ -87,12 +85,6 @@ export interface ToolDefinition {
     scenes?: string[];
     priority?: number;
 }
-export interface TokenBudgetConfig {
-    maxTokens: number;
-    nudgeThreshold: number;
-    totalBudget: number;
-    usedTokens?: number;
-}
 export type HookName = "PreToolUse" | "PostToolUse" | "PostToolUseFailure";
 export type PermissionDecision = "allow" | "deny" | "ask";
 export interface ToolHookContext {

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/workflow-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-runtime.d.ts","sourceRoot":"","sources":["../src/workflow-runtime.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAiB,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAmC;gBAEvC,aAAa,EAAE,MAAM;IAI3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqBpH;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkBxD;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBvE;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3D;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1D,aAAa,IAAI,kBAAkB,GAAG,IAAI;YAI5B,cAAc;IAM5B,OAAO,CAAC,iBAAiB;CAG1B"}
+{"version":3,"file":"workflow-runtime.d.ts","sourceRoot":"","sources":["../src/workflow-runtime.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAmC;gBAEvC,aAAa,EAAE,MAAM;IAI3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsBpH;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0BxD;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBvE;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3D;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1D,aAAa,IAAI,kBAAkB,GAAG,IAAI;YAI5B,cAAc;IAM5B,OAAO,CAAC,iBAAiB;CAG1B"}

package/dist/workflow-runtime.js

@@ -26,6 +26,7 @@ export class WorkflowRuntime {
         this.currentCheckpoint = {
             runId,
             workflowId: workflow.id,
+            workflowDefinition: workflow,
             sessionId,
             status: "running",
             currentState: workflow.initialState,
@@ -42,13 +43,20 @@ export class WorkflowRuntime {
      * 从 Checkpoint 恢复
      */
     async resume(runId) {
+        if (!/^[A-Za-z0-9_-]+$/.test(runId)) {
+            throw new Error(`Invalid workflow runId: ${runId}`);
+        }
         const cpPath = this.getCheckpointPath(runId);
         if (!existsSync(cpPath)) {
             throw new Error(`Checkpoint not found for runId: ${runId}`);
         }
         const raw = await fs.readFile(cpPath, "utf-8");
-        this.currentCheckpoint = JSON.parse(raw);
-        // TODO: 这里需要加载对应的 WorkflowDefinition（可能需要持久化存储定义）
+        const checkpoint = JSON.parse(raw);
+        if (!checkpoint.workflowDefinition || checkpoint.workflowDefinition.id !== checkpoint.workflowId) {
+            throw new Error(`Checkpoint ${runId} cannot be resumed: workflow definition is missing or inconsistent`);
+        }
+        this.workflow = checkpoint.workflowDefinition;
+        this.currentCheckpoint = checkpoint;
         this.currentCheckpoint.status = "running";
         this.currentCheckpoint.updatedAt = Date.now();
         await this.saveCheckpoint();

package/dist/workflow-types.d.ts

@@ -37,6 +37,8 @@ export interface WorkflowDefinition {
 export interface WorkflowCheckpoint {
     runId: string;
     workflowId: string;
+    /** Definition required to restore state transitions after process restart. */
+    workflowDefinition?: WorkflowDefinition;
     sessionId: string;
     status: "running" | "paused" | "completed" | "failed" | "awaiting_approval";
     currentState: string;

package/dist/workflow-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-types.d.ts","sourceRoot":"","sources":["../src/workflow-types.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,KAAK,CAAC;IAChD,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,iBAAiB;IACjB,WAAW,CAAC,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,mBAAmB,CAAC;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,yBAAyB;IACzB,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,wBAAwB;IACxB,gBAAgB,EAAE,QAAQ,EAAE,CAAC;IAC7B,yBAAyB;IACzB,oBAAoB,EAAE,UAAU,EAAE,CAAC;IACnC,gBAAgB;IAChB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAqB;gBAEzB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAWpC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKlC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAQpC,KAAK,IAAI,kBAAkB;CAG5B"}
+{"version":3,"file":"workflow-types.d.ts","sourceRoot":"","sources":["../src/workflow-types.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,KAAK,CAAC;IAChD,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,iBAAiB;IACjB,WAAW,CAAC,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,mBAAmB,CAAC;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,yBAAyB;IACzB,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,wBAAwB;IACxB,gBAAgB,EAAE,QAAQ,EAAE,CAAC;IAC7B,yBAAyB;IACzB,oBAAoB,EAAE,UAAU,EAAE,CAAC;IACnC,gBAAgB;IAChB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAqB;gBAEzB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAWpC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKlC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAQpC,KAAK,IAAI,kBAAkB;CAG5B"}

package/docs/install.md

@@ -75,28 +75,49 @@ qling
 
 ## 方式 D：Scoop 草案（未上架）
 
-清单草稿：`packaging/scoop/qling.json`。
+清单草稿：`packaging/scoop/qling.json`（版本与 `package.json` 对齐，当前 **1.1.0**）。
 
-本地试用（需自行维护 bucket 与 release 资产 URL）：
+本地校验（不安装到官方 bucket）：
 
 ```powershell
-# 示例：把 packaging/scoop 加入自建 bucket 后
+npm run validate:packaging
+# 检查 version / url 是否钉死到当前版本
+Get-Content packaging/scoop/qling.json | ConvertFrom-Json | Select-Object version, url, hash
+```
+
+本地试用（需自建 bucket，并先把 `hash` 换成真实 tarball SHA256）：
+
+```powershell
+# 示例：私有 bucket 放好 manifest 后
 scoop install qling
 ```
 
-当前草案以 **npm 全局安装** 作为 `post_install` 思路；正式上架前请替换为固定 version 的 npm tarball 或 GitHub Release 资产，并填写正确 hash。
+当前草案 URL 指向 npm tarball；`hash` 仍为占位。正式上架前请：
+
+1. `npm pack` 或发布后下载 tarball  
+2. 计算 SHA256 写入 `hash`  
+3. 提交到自建/社区 Scoop bucket  
+
+在 hash 未填前，**推荐**继续用 `npm install -g @qlingzzy/qling` 或源码 bootstrap。
 
 ## 方式 E：winget 草案（未上架）
 
-清单草稿：`packaging/winget/Zzy-min.qling.yaml`。
+清单草稿：`packaging/winget/Zzy-min.qling.yaml`（`PackageVersion` 与当前版本对齐）。
+
+本地校验：
+
+```powershell
+npm run validate:packaging
+Select-String -Path packaging/winget/Zzy-min.qling.yaml -Pattern 'PackageVersion|InstallerUrl|InstallerSha256'
+```
 
 正式提交需：
 
-1. 稳定版本的安装包 URL（msi/zip 或 portable）  
-2. SHA256  
+1. 稳定版本的安装包 URL（msi/zip 或 portable；当前示例为 GitHub Release zip）  
+2. 真实 `InstallerSha256`（草案里为全零占位）  
 3. 通过 [winget-pkgs](https://github.com/microsoft/winget-pkgs) 审核  
 
-当前文件仅为**结构样例**，不可直接 `winget install`。
+当前文件仅为**结构样例**，不可直接 `winget install`。发布 zip 前可先用 npm 全局安装路径。
 
 ## 配置与安全
 

package/docs/skills.md

@@ -1,10 +1,32 @@
 # Skills 约定
 
-轻灵通过 Markdown skill 扩展领域知识。扫描路径：
+轻灵通过 Markdown skill 扩展领域知识。扫描路径（去重，优先靠前）：
 
-- 仓库 `skills/`
-- 本机 `~/.qling/skills/`
-- 项目 `.qling/skills/`（若存在）
+1. **包内** `skills/`（随 `@qlingzzy/qling` 安装，全局可用）
+2. 本机 `~/.qling/skills/`
+3. 当前工作区 `skills/`
+4. 项目 `.qling/skills/`（若存在）
+5. 可选 `HERMES_HOME/skills`
+
+内置：`opencli`（平台数据必读）、`qling`、**lifecycle-*** 生命周期六件套，以及 `skills/examples/` 示例包：
+
+| 示例 skill | 用途 |
+|------------|------|
+| `repo-triage` | 陌生仓库快速摸底 |
+| `fix-failing-test` | 修失败单测 |
+| `add-function` | 增量加导出函数 |
+| `pr-summary` | 写 PR / 发布摘要 |
+
+详见 `skills/examples/README.md`。
+
+## 渐进加载（Progressive Skills）
+
+| 层级 | 内容 |
+|------|------|
+| System 索引 | 仅 `name` / `description` / `tags` / `triggers`（短描述） |
+| 按需正文 | `skill name="..."` 或 `/skill <name>` 加载 Markdown body |
+
+**原则**：用到什么知识，临时加载什么知识，不把全部 skill 正文塞进 system prompt。
 
 ## 文件约定
 
@@ -21,9 +43,33 @@
 name: my-skill
 description: 何时使用该 skill（给模型做路由）
 tags: [optional, tags]
+triggers: [关键词1, 场景2]
 ---
 ```
 
+## 安全扫描
+
+加载 skill 前默认静态扫描（`QLING_SKILL_SCAN`）：
+
+| 值 | 行为 |
+|----|------|
+| `on`（默认） | critical/high 命中则 **拒绝加载** |
+| `warn` | 仅警告仍加载 |
+| `off` | 关闭（仅调试） |
+
+规则覆盖：私钥 PEM、典型密钥形态、`curl|bash` / `irm|iex`、可疑 base64 执行等。
+
+## 生命周期 skills
+
+| name | 用途 |
+|------|------|
+| `lifecycle-spec` | 规格 / 验收 |
+| `lifecycle-plan` | 任务拆分 |
+| `lifecycle-build` | 增量实现 |
+| `lifecycle-test` | 测试证明 |
+| `lifecycle-review` | 合并前审查 |
+| `lifecycle-ship` | 发布清单 |
+
 ## 模板与示例
 
 - 模板：`skills/templates/SKILL.md`
@@ -42,10 +88,13 @@ cp skills/templates/SKILL.md skills/my-skill/SKILL.md
 ```text
 /skill list
 /skill my-skill
+/skill lifecycle-plan
 ```
 
 ## 设计原则
 
-1. **短而可执行** — 步骤可直接变成工具调用  
-2. **诚实边界** — 写清不要做什么  
-3. **本地优先** — 不要求外网上传  
+1. **短而可执行** — 步骤可直接变成工具调用
+2. **诚实边界** — 写清不要做什么
+3. **本地优先** — 不要求外网上传
+4. **渐进加载** — 索引进 prompt，正文 on-demand
+5. **默认可扫描** — 第三方 skill 先过安全规则

package/docs/web-routing.md

@@ -0,0 +1,83 @@
+# 网页 / 平台数据路由（Phase 3.3）
+
+轻灵有多条「上网」路径。**先选对通道，再调用**，避免反爬挑战页被当成成功数据。
+
+## 决策树
+
+```
+需要外部数据？
+├─ 社交/内容平台（抖音、小红书、微博、B站、TikTok、X…）
+│   → skill name="opencli"
+│   → bash: opencli <site> … -f json
+│   → 禁止 url_fetch / browser_* 当主路径
+│
+├─ 普通 HTTPS API / 静态页
+│   → url_fetch（Guard 白名单 / 私网拦截）
+│
+├─ 文档站 / 弱反爬、需 JS 渲染摘要
+│   → browser_fetch（Playwright 只读抓取）
+│
+├─ 需要点击/填表等交互（实验）
+│   → 优先 opencli browser <session> …
+│   → 或启用 browser_act（QLING_BROWSER_ACT=1，默认关）
+│
+└─ 不确定
+    → opencli list / doctor；不要盲目重试 url_fetch
+```
+
+## 工具对照
+
+| 工具 | 默认 | 能力 | 典型场景 |
+|------|------|------|----------|
+| **opencli**（via bash） | 本机已装则可用 | 站点适配器、登录会话、结构化 JSON | 抖/红/微/B/推 |
+| **url_fetch** | 开 | HTTP + Guard | 公开 API、静态资源 |
+| **browser_fetch** | 开 | 无头浏览、正文摘要 | 文档站 SPA |
+| **browser_act** | **关** | goto/click/type/extract | 显式启用后的弱交互 |
+
+## browser_act 启用与跨步会话
+
+```powershell
+# Windows PowerShell
+$env:QLING_BROWSER_ACT = "1"
+```
+
+**推荐流程（同 session 保活页面）**：
+
+```text
+browser_act action=open session=demo url="https://example.com"
+browser_act action=click session=demo selector="a.docs"
+browser_act action=extract session=demo
+browser_act action=close session=demo
+browser_act action=status
+```
+
+- `session` 默认 `default`；进程内保活，跨多次 tool 调用
+- 空闲超时默认 10 分钟：`QLING_BROWSER_ACT_IDLE_TTL_MS`
+- 最大会话数默认 3：`QLING_BROWSER_ACT_MAX_SESSIONS`
+- 与 `url_fetch` **共用网络 Guard**；**Plan Mode 禁止**
+- 强反爬平台仍应 **opencli**，不要靠 browser_act 硬抠
+
+## 失败诚实
+
+| 现象 | 含义 | 动作 |
+|------|------|------|
+| HTML 含 `_$jsvmprt` / `acrawler` | 反爬挑战页 | 换 opencli 站点命令 + 登录 |
+| `BROWSER_ACT_DISABLED` | 未开启交互 | 开 env 或改 opencli browser |
+| Guard deny | 策略拦截 | 检查网络模式 / 白名单 |
+
+## 使命通道通知（Phase 3.5）
+
+| 变量 | 默认 | 说明 |
+|------|------|------|
+| `QLING_MISSION_NOTIFY` | on | 总开关 |
+| `QLING_MISSION_NOTIFY_STYLE` | rich | rich=TG HTML / Slack Blocks；plain=纯文本 |
+| `QLING_MISSION_NOTIFY_LOGS` | milestone | off / milestone / all — 日志推送粒度 |
+| `QLING_CHANNEL_TELEGRAM_TOKEN` + chat ids | — | Telegram |
+| `QLING_CHANNEL_SLACK_BOT_TOKEN` + channel ids | — | Slack |
+
+`qling doctor` 会摘要 browser_act / parallel / notify 开关。
+
+## 相关
+
+- Skill：`skills/opencli/SKILL.md`
+- 沙箱/网络：`docs/docker.md`、环境变量 `QLING_GUARD_*`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qlingzzy/qling",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "轻灵 Qling - 本地优先的中文 AI Agent CLI 工作台 / Local-first Chinese AI Agent CLI workbench",
   "type": "module",
   "main": "./dist/sdk.js",
@@ -32,7 +32,8 @@
     "docs/sdk.md",
     "docs/skills.md",
     "docs/install.md",
-    "docs/docker.md"
+    "docs/docker.md",
+    "docs/web-routing.md"
   ],
   "engines": {
     "node": ">=18"
@@ -77,12 +78,17 @@
     "bootstrap": "node scripts/bootstrap.mjs",
     "daemon": "node dist/daemon.js",
     "prepare": "npm run build",
-    "prepack": "npm run build",
     "dev": "tsc --watch",
     "test": "npm run build && node --experimental-test-module-mocks --test \"tests/unit/**/*.test.mjs\"",
     "test:smoke": "npm run build && node --test \"tests/smoke/**/*.test.mjs\"",
     "eval:smoke": "npm run build && node scripts/eval-smoke.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"
+    "eval:recovery": "npm run build && node scripts/eval-recovery.mjs",
+    "eval:tasks": "npm run build && node scripts/eval-tasks.mjs",
+    "eval:llm": "npm run build && node scripts/eval-llm.mjs",
+    "validate:packaging": "node scripts/validate-packaging.mjs",
+    "dep:layers": "node scripts/dep-layers.mjs",
+    "dep:layers:json": "node scripts/dep-layers.mjs --json",
+    "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"
   },
   "dependencies": {
     "axios": "^1.7.0",
@@ -93,6 +99,14 @@
     "yaml": "^2.8.1",
     "zod": "^3.23.0"
   },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.19.17",