@qlingzzy/qling 1.0.0

package/dist/workflow-types.d.ts

@@ -0,0 +1,73 @@
+import { Message, ToolCall, ToolResult } from "./types.js";
+/**
+ * 状态机状态定义
+ */
+export interface WorkflowState {
+    id: string;
+    description: string;
+    /** 执行该状态时的逻辑类型 */
+    type: "task" | "approval" | "condition" | "end";
+    /** 当前状态下的待执行指令 */
+    instruction?: string;
+    /** 允许的迁移路径 */
+    transitions: Array<{
+        target: string;
+        condition?: string;
+    }>;
+    /** 重试策略（覆盖全局） */
+    retryPolicy?: {
+        maxAttempts: number;
+        backoffFactor: number;
+    };
+}
+/**
+ * 状态机定义
+ */
+export interface WorkflowDefinition {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    initialState: string;
+    states: Record<string, WorkflowState>;
+}
+/**
+ * 状态机运行时快照 (Checkpoint)
+ */
+export interface WorkflowCheckpoint {
+    runId: string;
+    workflowId: string;
+    sessionId: string;
+    status: "running" | "paused" | "completed" | "failed" | "awaiting_approval";
+    currentState: string;
+    history: Array<{
+        timestamp: number;
+        fromState: string;
+        toState: string;
+        action?: string;
+    }>;
+    /** 上下文快照：保留执行到此处的关键消息 */
+    contextSnapshot: Message[];
+    /** 待处理的工具调用（若在执行中中断） */
+    pendingToolCalls: ToolCall[];
+    /** 已完成的工具结果（待提交给 LLM） */
+    completedToolResults: ToolResult[];
+    /** 错误堆栈（若失败） */
+    error?: {
+        message: string;
+        stack?: string;
+        stateId: string;
+    };
+    updatedAt: number;
+}
+/**
+ * 状态机执行图的 DSL 构建器（辅助函数）
+ */
+export declare class WorkflowBuilder {
+    private workflow;
+    constructor(id: string, name: string);
+    setDescription(desc: string): this;
+    addState(state: WorkflowState): this;
+    build(): WorkflowDefinition;
+}
+//# sourceMappingURL=workflow-types.d.ts.map

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

@@ -0,0 +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"}

package/dist/workflow-types.js

@@ -0,0 +1,34 @@
+// ============================================================
+// 轻灵 - Workflow DSL & Types (v0.3)
+// 代码优先的状态机定义，支持 Checkpoint 序列化
+// ============================================================
+/**
+ * 状态机执行图的 DSL 构建器（辅助函数）
+ */
+export class WorkflowBuilder {
+    workflow;
+    constructor(id, name) {
+        this.workflow = {
+            id,
+            name,
+            description: "",
+            version: "1.0.0",
+            initialState: "",
+            states: {},
+        };
+    }
+    setDescription(desc) {
+        this.workflow.description = desc;
+        return this;
+    }
+    addState(state) {
+        this.workflow.states[state.id] = state;
+        if (!this.workflow.initialState) {
+            this.workflow.initialState = state.id;
+        }
+        return this;
+    }
+    build() {
+        return this.workflow;
+    }
+}

package/docs/docker.md

@@ -0,0 +1,66 @@
+# 在 Docker 中运行轻灵 Qling
+
+可选隔离路径（对标 Pi 的 containerization 建议）：把 Agent 关在容器里，宿主机只挂载工作区与必要配置。
+
+> **默认仍是本机直接运行。** 容器不是强制依赖。
+
+## 原则
+
+1. **密钥不进镜像** — 用 `-e` / env-file（且 env-file 不提交）。  
+2. **只挂载工作区** — 避免挂整个 `$HOME`。  
+3. **写沙箱默认开启** — 容器内 `QLING_WORKSPACE_DIR=/workspace`，`QLING_WRITE_SANDBOX=workspace`。  
+4. **网络按需收紧** — `QLING_GUARD_NETWORK_MODE=strict|open|deny`。
+
+## 快速示例
+
+仓库内草案：`packaging/docker/`。
+
+```bash
+# 构建
+docker build -f packaging/docker/Dockerfile -t qling:1.0.0 .
+
+# 运行（挂载当前目录为工作区）
+docker run --rm -it \
+  -e QLING_LLM_API_KEY \
+  -e QLING_LLM_PROVIDER=deepseek \
+  -e QLING_LLM_ENDPOINT=https://api.deepseek.com \
+  -e QLING_LLM_MODEL=deepseek-chat \
+  -e QLING_WORKSPACE_DIR=/workspace \
+  -e QLING_WRITE_SANDBOX=workspace \
+  -e QLING_GUARD_NETWORK_MODE=strict \
+  -v "%cd%":/workspace \
+  -w /workspace \
+  qling:1.0.0 \
+  run "列出 /workspace 下的文件"
+```
+
+Linux/macOS 将 `%cd%` 换成 `$(pwd)`。
+
+## docker compose
+
+见 `packaging/docker/docker-compose.yml`：
+
+```bash
+export QLING_LLM_API_KEY=...
+docker compose -f packaging/docker/docker-compose.yml run --rm qling doctor
+```
+
+## 限制
+
+| 能力 | 容器内说明 |
+|------|------------|
+| `browser_fetch` | 需额外装 Chromium 依赖，镜像体积大；默认镜像可不含 Playwright |
+| GUI TUI | 交互 TUI 可用 `docker run -it`；体验不如本机终端 |
+| 原生模块 | `better-sqlite3` 需在镜像构建时编译 |
+| Daemon | 容器重启会丢进程；状态可挂载 `~/.qling` 卷（慎挂） |
+
+## 推荐安全组合
+
+```bash
+QLING_WRITE_SANDBOX=workspace
+QLING_GUARD_NETWORK_MODE=strict
+QLING_ALLOW_SENSITIVE_WRITE=   # 保持空：禁止写 .env
+# 不要设置 QLING_WRITE_SANDBOX=off
+```
+
+本机非容器时同样适用上述环境变量。详见 [install.md](install.md)。

package/docs/install.md

@@ -0,0 +1,159 @@
+# 轻灵 Qling 安装指南
+
+面向本机开发者与 Windows 用户。更完整的产品说明见 [README.md](../README.md) / [README.en.md](../README.en.md)。
+
+## 环境要求
+
+| 依赖 | 版本 |
+|------|------|
+| Node.js | ≥ 18（推荐 20/22 LTS） |
+| npm | ≥ 9 |
+| Git | 可选，用于 diff/commit 与 isolation |
+| Playwright Chromium | 可选，仅 `browser_fetch` |
+
+## 方式 A：源码安装（当前推荐）
+
+```bash
+git clone https://github.com/Zzy-min/qling.git
+cd qling
+npm run bootstrap
+```
+
+带浏览器抓取：
+
+```bash
+npm run bootstrap -- --with-browser
+```
+
+全局命令：
+
+```bash
+npm link
+qling --help
+```
+
+`bootstrap` 会：检查 Node/npm → 安装依赖 → 构建 → 创建 `~/.qling/` → 给出 `doctor`/`setup` 下一步。默认**不**安装浏览器、**不**自动开 dashboard。
+
+## 方式 B：npm 全局安装
+
+包名因 npm 相似度策略使用作用域 **`@qlingzzy/qling`**（安装后命令仍是 `qling`）：
+
+```bash
+npm install -g @qlingzzy/qling
+qling --version
+qling bootstrap
+qling setup
+```
+
+从 GitHub 直接装：
+
+```bash
+npm install -g github:Zzy-min/qling
+```
+
+> 注意：`better-sqlite3` 为原生模块，需本机可编译环境；Windows 建议安装 [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) 或使用已预编译的 Node 版本。
+
+## 方式 C：Windows PowerShell 快速路径
+
+```powershell
+# 1) 克隆与启动
+git clone https://github.com/Zzy-min/qling.git
+cd qling
+npm run bootstrap
+
+# 2) 全局 link
+npm link
+
+# 3) 配置（密钥写用户环境变量，不写 .env）
+qling setup
+[Environment]::SetEnvironmentVariable('QLING_LLM_API_KEY', '<your-key>', 'User')
+
+# 4) 新开终端验证
+qling doctor
+qling
+```
+
+## 方式 D：Scoop 草案（未上架）
+
+清单草稿：`packaging/scoop/qling.json`。
+
+本地试用（需自行维护 bucket 与 release 资产 URL）：
+
+```powershell
+# 示例：把 packaging/scoop 加入自建 bucket 后
+scoop install qling
+```
+
+当前草案以 **npm 全局安装** 作为 `post_install` 思路；正式上架前请替换为固定 version 的 npm tarball 或 GitHub Release 资产，并填写正确 hash。
+
+## 方式 E：winget 草案（未上架）
+
+清单草稿：`packaging/winget/Zzy-min.qling.yaml`。
+
+正式提交需：
+
+1. 稳定版本的安装包 URL（msi/zip 或 portable）  
+2. SHA256  
+3. 通过 [winget-pkgs](https://github.com/microsoft/winget-pkgs) 审核  
+
+当前文件仅为**结构样例**，不可直接 `winget install`。
+
+## 配置与安全
+
+| 项 | 建议 |
+|----|------|
+| API key | 系统用户环境变量 `QLING_LLM_API_KEY` |
+| Provider 配置 | `qling setup` 写入 `~/.qling/.env`（无密钥） |
+| 禁止 | 把密钥提交到 git / 同步网盘 |
+
+本地模型（Ollama）：
+
+```bash
+# 安装并启动 Ollama 后
+qling   # 进入 TUI
+/model use ollama
+```
+
+## 验证安装
+
+```bash
+qling --help
+qling doctor
+qling run "列出当前目录"
+```
+
+期望：`doctor` 无 fail（warn 可接受）；`run` 在已配置密钥或 Ollama 时可完成一轮工具调用。
+
+## 卸载
+
+```bash
+# npm link 安装
+npm unlink -g qling
+
+# npm 全局
+npm uninstall -g qling
+
+# 可选：删除本机状态（会丢失会话/记忆）
+# Windows: Remove-Item -Recurse $env:USERPROFILE\.qling
+# Unix:    rm -rf ~/.qling
+```
+
+## 安全相关环境变量（Phase 1.5）
+
+| 变量 | 默认 | 含义 |
+|------|------|------|
+| `QLING_WRITE_SANDBOX` | `workspace` | write/patch 仅工作区；`roots` 兼容旧行为；`off` 关闭 |
+| `QLING_ALLOW_SENSITIVE_WRITE` | 空 | 设为 `1` 才允许写 `.env` / 密钥文件 |
+| `QLING_GUARD_NETWORK_MODE` | `strict` | `strict` 前缀白名单；`open` 允许 http/https；`deny` 全拒 |
+
+可选容器运行见 [docker.md](docker.md) 与 `packaging/docker/`。
+
+## 相关命令
+
+| 命令 | 作用 |
+|------|------|
+| `qling bootstrap` | 本机初始化检查 |
+| `qling setup` | Provider / Model 向导 |
+| `qling doctor` | 诊断 |
+| `qling privacy` | 数据边界 |
+| `qling` | 进入流式 TUI |

package/docs/sdk.md

@@ -0,0 +1,67 @@
+# Qling SDK（雏形）
+
+从 1.0 / Phase 2.0 起，可在 Node 项目中嵌入轻灵的 Agent 运行时。
+
+## 安装
+
+```bash
+npm install @qlingzzy/qling
+# 或: npm install github:Zzy-min/qling
+```
+
+## 最小示例
+
+```js
+import {
+  AgentLoop,
+  loadQlingConfig,
+  applyConfigToProcessEnv,
+  ALL_TOOLS,
+} from "@qlingzzy/qling";
+
+const { config } = await loadQlingConfig({
+  workspaceDir: process.cwd(),
+});
+applyConfigToProcessEnv(config);
+
+const agent = new AgentLoop({
+  apiKey: process.env.QLING_LLM_API_KEY || process.env.DEEPSEEK_API_KEY,
+  provider: config.llm.provider,
+  endpoint: config.llm.endpoint,
+  model: config.llm.model,
+  tools: ALL_TOOLS,
+  runtime: {
+    workspaceDir: process.cwd(),
+  },
+});
+
+agent.addUserMessage("列出当前目录的主要文件");
+const answer = await agent.run();
+console.log(answer);
+await agent.shutdown();
+```
+
+## 主要导出
+
+| 导出 | 用途 |
+|------|------|
+| `AgentLoop` | 核心 agent 循环 |
+| `loadQlingConfig` / `applyConfigToProcessEnv` | 配置 |
+| `listProviderPresets` / `getProviderPreset` | LLM 预设 |
+| `listMcpPresets` / `addMcpPresetToStore` | MCP 预设与本机 store |
+| `isPathAllowedForWrite` / `checkSensitiveWriteTarget` | 安全边界 |
+| `runEvalSuite` | 本地评测 |
+| `ALL_TOOLS` / `dispatch` | 工具层 |
+
+## 边界
+
+- SDK 与 CLI 共享同一运行时；**不**自动启动 TUI  
+- API key 仍须由宿主进程提供（环境变量），SDK 不落盘密钥  
+- 公开 API 在 2.x 可能调整；请 pin 版本  
+- npm 包名为 `@qlingzzy/qling`（官方不允许无作用域名 `qling`）；全局安装后 CLI 命令仍是 `qling`
+
+## CLI 仍推荐用于
+
+- 交互 TUI、`/plan`、`/model`、doctor、daemon  
+- `qling mcp add <preset>`  
+- `npm run eval:smoke`  

package/docs/skills.md

@@ -0,0 +1,51 @@
+# Skills 约定
+
+轻灵通过 Markdown skill 扩展领域知识。扫描路径：
+
+- 仓库 `skills/`
+- 本机 `~/.qling/skills/`
+- 项目 `.qling/skills/`（若存在）
+
+## 文件约定
+
+| 形式 | 说明 |
+|------|------|
+| `skills/foo.md` | 单文件 skill |
+| `skills/foo/SKILL.md` | 目录 skill（推荐） |
+| `skills/foo/index.md` | 目录 skill 兼容 |
+
+## Frontmatter
+
+```yaml
+---
+name: my-skill
+description: 何时使用该 skill（给模型做路由）
+tags: [optional, tags]
+---
+```
+
+## 模板与示例
+
+- 模板：`skills/templates/SKILL.md`
+- 示例：`skills/examples/repo-triage/SKILL.md`
+
+复制模板：
+
+```bash
+mkdir -p skills/my-skill
+cp skills/templates/SKILL.md skills/my-skill/SKILL.md
+# 编辑 name / description / 正文
+```
+
+在 TUI 中：
+
+```text
+/skill list
+/skill my-skill
+```
+
+## 设计原则
+
+1. **短而可执行** — 步骤可直接变成工具调用  
+2. **诚实边界** — 写清不要做什么  
+3. **本地优先** — 不要求外网上传  

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@qlingzzy/qling",
+  "version": "1.0.0",
+  "description": "轻灵 Qling - 本地优先的中文 AI Agent CLI 工作台 / Local-first Chinese AI Agent CLI workbench",
+  "type": "module",
+  "main": "./dist/sdk.js",
+  "types": "./dist/sdk.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/sdk.d.ts",
+      "import": "./dist/sdk.js",
+      "default": "./dist/sdk.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "qling": "dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "scripts",
+    "README.md",
+    "README.en.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "package.json",
+    "docs/sdk.md",
+    "docs/skills.md",
+    "docs/install.md",
+    "docs/docker.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "keywords": [
+    "qling",
+    "agent",
+    "cli",
+    "tui",
+    "ai",
+    "llm",
+    "coding-agent",
+    "local-first",
+    "chinese",
+    "mcp",
+    "terminal",
+    "deepseek",
+    "openai-compatible"
+  ],
+  "author": "Zzy-min",
+  "license": "MIT",
+  "homepage": "https://github.com/Zzy-min/qling#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Zzy-min/qling.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Zzy-min/qling/issues"
+  },
+  "scripts": {
+    "clean": "node scripts/clean-dist.mjs",
+    "build": "npm run clean && tsc",
+    "start": "node dist/index.js",
+    "tui": "node dist/index.js chat",
+    "repl": "node dist/index.js repl",
+    "exec": "node dist/index.js run",
+    "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"
+  },
+  "dependencies": {
+    "axios": "^1.7.0",
+    "better-sqlite3": "^12.9.0",
+    "dotenv": "^16.4.0",
+    "playwright": "^1.59.1",
+    "string-width": "^8.2.0",
+    "yaml": "^2.8.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.19.17",
+    "@types/string-width": "^2.0.0",
+    "typescript": "^5.5.0"
+  }
+}

package/scripts/bootstrap.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+const args = process.argv.slice(2);
+const withBrowser = args.includes("--with-browser");
+const noBrowser = args.includes("--no-browser");
+
+function run(command, commandArgs, options = {}) {
+  const result = spawnSync(command, commandArgs, {
+    stdio: "inherit",
+    shell: process.platform === "win32",
+    ...options,
+  });
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+}
+
+function output(command, commandArgs) {
+  const result = spawnSync(command, commandArgs, {
+    encoding: "utf8",
+    shell: process.platform === "win32",
+  });
+  return result.status === 0 ? result.stdout.trim() : "unknown";
+}
+
+const nodeMajor = Number(process.versions.node.split(".")[0] ?? "0");
+if (!Number.isFinite(nodeMajor) || nodeMajor < 18) {
+  console.error(`Node.js >= 18 is required. Current: ${process.versions.node}`);
+  process.exit(1);
+}
+
+console.log("\n🚀 轻灵 Bootstrap（源码本机启动）");
+console.log("-----------------------------------------");
+console.log(`Node : v${process.versions.node}`);
+console.log(`npm  : ${output("npm", ["--version"])}`);
+
+mkdirSync(join(homedir(), ".qling"), { recursive: true });
+
+console.log("\n[1/4] 安装依赖");
+run("npm", ["install"]);
+
+console.log("\n[2/4] 构建项目");
+run("npm", ["run", "build"]);
+
+console.log("\n[3/4] 浏览器依赖");
+if (withBrowser) {
+  run("npx", ["playwright", "install", "chromium"]);
+} else if (noBrowser) {
+  console.log("已跳过浏览器依赖。需要 browser_fetch 时可运行: npm run bootstrap -- --with-browser");
+} else {
+  console.log("默认不安装浏览器依赖。需要 browser_fetch 时可运行: npm run bootstrap -- --with-browser");
+}
+
+console.log("\n[4/4] 本地诊断");
+if (existsSync("dist/index.js")) {
+  run(process.execPath, ["dist/index.js", "doctor"]);
+}
+
+console.log("下一步: 运行 `node dist/index.js setup` 配置模型，或运行 `node dist/index.js` 进入 TUI。");

package/scripts/check_image.ps1

@@ -0,0 +1,18 @@
+$imgDir = Join-Path $env:USERPROFILE "OneDrive\图片"
+$targetFile = "ChatGPT Image 2026年4月23日 20_09_13.png"
+$fullPath = Join-Path $imgDir $targetFile
+
+Write-Output "Looking for: $fullPath"
+Write-Output "Exists: $(Test-Path $fullPath)"
+
+# List files matching ChatGPT pattern
+Write-Output "`nFiles matching ChatGPT in directory:"
+Get-ChildItem $imgDir -Filter "*ChatGPT*" -ErrorAction SilentlyContinue | ForEach-Object {
+    Write-Output "  $($_.Name) | Size: $($_.Length) bytes"
+}
+
+# Also try listing all png files
+Write-Output "`nAll PNG files (first 10):"
+Get-ChildItem $imgDir -Filter "*.png" -ErrorAction SilentlyContinue | Select-Object -First 10 | ForEach-Object {
+    Write-Output "  $($_.Name) | Size: $($_.Length) bytes"
+}

package/scripts/clean-dist.mjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * 清理 dist/，避免陈旧 JS 产物进入 npm pack。
+ * 跨平台：仅用 Node fs，不依赖 rimraf/shell。
+ */
+import { rmSync, existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+const dist = join(root, "dist");
+
+if (existsSync(dist)) {
+  rmSync(dist, { recursive: true, force: true });
+  console.log("[clean-dist] removed dist/");
+} else {
+  console.log("[clean-dist] dist/ already absent");
+}

package/scripts/copy_image.ps1

@@ -0,0 +1,5 @@
+$src = Join-Path $env:USERPROFILE "OneDrive\图片\ChatGPT Image 2026年4月23日 20_09_13.png"
+$dst = Join-Path $env:USERPROFILE "projects\qling\temp_image.png"
+Copy-Item $src $dst -Force
+$f = Get-Item $dst
+Write-Output "Copied to: $($f.FullName) | Size: $($f.Length)"

package/scripts/eval-smoke.mjs

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * 本地 smoke 评测：不依赖外部 LLM / API key
+ * Usage: node scripts/eval-smoke.mjs [--json]
+ */
+import { runEvalSuite, formatEvalReport, evalReportToJson } from "../dist/eval/runner.js";
+
+const asJson = process.argv.includes("--json");
+
+const report = await runEvalSuite();
+if (asJson) {
+  process.stdout.write(evalReportToJson(report) + "\n");
+} else {
+  process.stdout.write(formatEvalReport(report).join("\n") + "\n");
+}
+
+process.exit(report.fail === 0 ? 0 : 1);