@ohos-cpf/3rdloop 0.0.1 → 0.0.2

package/lib/update.js

@@ -0,0 +1,280 @@
+/**
+ * update.js —— 自更新（3rdloop update）
+ *
+ * 职责：
+ *   - 检测本地版本（getCliVersion）与 npm registry 最新版
+ *   - 识别开发态（npm link 软链）与正式全局安装
+ *   - 交互确认后通过 npm install -g 重装
+ *
+ * 交互/输出契约：
+ *   - 进度/日志 → stderr；--json 结构化结果 → stdout
+ *   - 非 TTY 下交互确认自动拒绝（需 --yes 配合脚本化更新）
+ *
+ * 安全：
+ *   - registry 默认尊重用户 npm 配置（镜像源），--registry 可覆盖
+ *   - 全部经 child_process.execFileSync 调 npm，避免 shell 注入
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import readline from 'node:readline';
+import { execFileSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+// 本文件在 cli/lib/ 下
+const CLI_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const PKG_NAME = '@ohos-cpf/3rdloop';
+const BIN_ABS = path.join(CLI_ROOT, 'bin', '3rdloop.mjs');
+
+// ── 工具 ─────────────────────────────────────────────────────────
+
+/**
+ * 轻量语义化版本比较。返回负数/零/正数；pre-release 视为低于正式版。
+ */
+export function compareVersions(a, b) {
+    const parse = (v) => String(v || '')
+        .trim()
+        .replace(/^v/i, '')
+        .split(/[\.+\-]/)
+        .map((part, idx) => idx < 3 ? parseInt(part, 10) || 0 : part);
+    const pa = parse(a);
+    const pb = parse(b);
+    for (let i = 0; i < 3; i++) {
+        const na = pa[i] || 0;
+        const nb = pb[i] || 0;
+        if (na !== nb) return na - nb;
+    }
+    // 无 pre-release（第 4 部分为空 / 纯数字）视为正式版，大于带 pre 的版本
+    const preA = pa[3];
+    const preB = pb[3];
+    if (!preA && preB) return 1;
+    if (preA && !preB) return -1;
+    return String(preA).localeCompare(String(preB));
+}
+
+/**
+ * 检测当前命令是否为 npm link 软链（开发态）。
+ *
+ * 原理：npm link 的全局 bin 是指向仓库 bin 的软链；真实全局安装则是
+ * node_modules 内的副本。比较 process.argv[1] 与仓库内 bin 的 realpath 是否相同。
+ */
+export function detectLinkMode(argv1 = process.argv[1]) {
+    try {
+        const realArgv = fs.realpathSync(argv1 || '');
+        const realLocal = fs.realpathSync(BIN_ABS);
+        return realArgv === realLocal;
+    } catch {
+        return false;
+    }
+}
+
+/**
+ * 获取最新版本。
+ * 优先 `npm view`（尊重用户 .npmrc 镜像配置）；失败回退 packument API。
+ * @returns {Promise<string | null>} latest 版本号；查询失败返回 null
+ */
+export async function fetchLatestVersion({ registry } = {}) {
+    const args = ['view', PKG_NAME, 'version'];
+    if (registry) args.push('--registry', registry);
+    try {
+        const out = execFileSync('npm', args, {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+            timeout: 30000,
+        });
+        const v = out.trim().split('\n')[0];
+        return v || null;
+    } catch { /* 回退 packument API */ }
+
+    // packument API 兜底（尊重用户 npm 镜像配置）
+    const registryHost = registry || _detectNpmRegistry();
+    try {
+        const enc = encodeURIComponent(PKG_NAME);
+        const url = `${registryHost.replace(/\/$/, '')}/${enc}/latest`;
+        const res = await fetch(url, { signal: AbortSignal.timeout(30000) });
+        if (!res.ok) return null;
+        const data = await res.json();
+        return data.version || null;
+    } catch {
+        return null;
+    }
+}
+
+/** 从用户 npm 配置读取 registry（无 --registry 时使用镜像源）。 */
+function _detectNpmRegistry() {
+    try {
+        const out = execFileSync('npm', ['config', 'get', 'registry'], {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+            timeout: 10000,
+        });
+        const v = out.trim();
+        return v && v !== 'undefined' ? v : 'https://registry.npmjs.org/';
+    } catch {
+        return 'https://registry.npmjs.org/';
+    }
+}
+
+/**
+ * 交互确认是否更新。非 TTY 自动视为不确认。
+ * @returns {Promise<boolean>}
+ */
+export async function confirmUpdate({ current, latest } = {}) {
+    if (!process.stdin.isTTY) return false;
+    const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+    return new Promise((resolve) => {
+        rl.question(`  检测到新版本 ${latest}（当前 ${current}），是否更新? [y/N] `, (ans) => {
+            rl.close();
+            resolve(/^y(es)?$/i.test(ans.trim()));
+        });
+    });
+}
+
+/**
+ * 执行更新。
+ * @param {object} opts
+ * @param {string} opts.latest        目标版本（registry latest）
+ * @param {string} [opts.registry]    registry 覆盖
+ * @param {boolean} [opts.force]      开发态也强制替换
+ * @param {boolean} [opts.isLink]     是否 link 模式（可注入便于测试）
+ */
+export function performUpdate({ latest, registry, force = false, isLink = detectLinkMode() } = {}) {
+    const installArgs = ['install', '-g', `${PKG_NAME}@latest`];
+    if (registry) installArgs.push('--registry', registry);
+
+    // 开发态（npm link）：默认警告并跳过，仅提示 git pull
+    if (isLink && !force) {
+        process.stderr.write(
+            `\n[update] 检测到当前为开发态（npm link），已跳过自更新。\n` +
+            `  开发态请用 git pull 更新仓库源码（数据目录 ~/.3lib/3rdloop/db 不受影响）。\n` +
+            `  如需强制用正式包替换链接，可加 --force。\n`
+        );
+        return { updated: false, skipped: 'link-mode' };
+    }
+
+    // 开发态 + --force：先解除链接
+    if (isLink && force) {
+        process.stderr.write(`[update] 检测到 npm link，先解除链接...\n`);
+        execFileSync('npm', ['unlink', '-g', PKG_NAME], { encoding: 'utf-8', stdio: 'inherit' });
+    }
+
+    process.stderr.write(`[update] 卸载旧版本（@${PKG_NAME}）...\n`);
+    try {
+        execFileSync('npm', ['uninstall', '-g', PKG_NAME], { encoding: 'utf-8', stdio: 'inherit' });
+    } catch { /* 卸载失败不阻断重装 */ }
+
+    process.stderr.write(`[update] 安装最新版本...\n`);
+    execFileSync('npm', installArgs, { encoding: 'utf-8', stdio: 'inherit' });
+
+    return { updated: true, version: latest };
+}
+
+/**
+ * update 命令主入口。
+ * @param {object} opts
+ * @param {boolean} opts.jsonMode
+ * @param {string[]} opts.rest  位置参数 + flags
+ * @returns {Promise<{ok: boolean, skipLink?: boolean, message?: string, current?: string, latest?: string}>}
+ */
+export async function cmdUpdateImpl({ jsonMode = false, rest = [] } = {}) {
+    const checkOnly = rest.includes('--check');
+    const yes = rest.includes('--yes') || rest.includes('-y');
+    const force = rest.includes('--force');
+    const regIdx = rest.indexOf('--registry');
+    const registry = regIdx !== -1 ? rest[regIdx + 1] : undefined;
+
+    // update 用法说明（--help，离线可测，不触碰网络）
+    if (rest.includes('--help') || rest.includes('-h')) {
+        const help = [
+            '用法: 3rdloop update [--check] [--yes] [--force] [--registry <url>]',
+            '',
+            '  默认: 检测本地版本与 npm registry 最新版，差异存在时交互确认后重装',
+            '  --check           仅检查是否有新版本，不执行更新',
+            '  --yes, -y         跳过交互确认直接更新（非 TTY 必须）',
+            '  --force           开发态（npm link）也强制替换为 registry 正式包',
+            '  --registry <url>  覆盖 npm registry（默认尊重用户 npm 镜像配置）',
+            '  注意: 数据目录 ~/.3lib/3rdloop/db 与 SKILL 配置不受更新影响',
+        ].join('\n');
+        process.stdout.write(help + '\n');
+        return { ok: true, helped: true };
+    }
+
+    // 拒绝多余的位置参数（保持命令简单）
+    const unknowns = rest.filter(a => !a.startsWith('--'));
+    if (unknowns.length > 0) {
+        process.stderr.write(`未知参数: ${unknowns.join(' ')}（update 不接受位置参数）\n`);
+        if (jsonMode) process.stdout.write(JSON.stringify({ ok: false, error: '未知参数' }, null, 2) + '\n');
+        return { ok: false, error: '未知参数' };
+    }
+
+    const run = await import('./config.js');
+    const current = run.getCliVersion();
+
+    const latest = await fetchLatestVersion({ registry });
+    if (!latest) {
+        const msg = `无法查询 ${PKG_NAME} 的 registry 最新版本（网络或镜像配置问题）`;
+        process.stderr.write(`\n[update] ${msg}\n`);
+        if (jsonMode) process.stdout.write(JSON.stringify({ ok: false, error: msg }, null, 2) + '\n');
+        return { ok: false, error: msg };
+    }
+
+    if (jsonMode) {
+        process.stdout.write(JSON.stringify({
+            ok: true,
+            latest,
+            current,
+            upToDate: compareVersions(current, latest) >= 0,
+        }, null, 2) + '\n');
+        if (!checkOnly) {
+            // --json 下不交互，直接更新（用户显式要求命令行为，等价 --yes）
+            try {
+                const r = performUpdate({ latest, registry, force });
+                process.stdout.write(JSON.stringify({ ...r, ok: true }, null, 2) + '\n');
+                return { ok: true, ...r };
+            } catch (err) {
+                const msg = `更新失败: ${err.message}`;
+                process.stderr.write(`\n[update] ${msg}\n`);
+                return { ok: false, error: msg };
+            }
+        }
+        return { ok: true, current, latest };
+    }
+
+    // ── 非 JSON 模式 ──────────────────────────────────────────
+    process.stderr.write(`当前版本: ${current}  最新版本: ${latest}\n`);
+
+    if (compareVersions(current, latest) >= 0) {
+        process.stderr.write(`\n[update] 已是最新版本，无需更新。\n`);
+        return { ok: true, upToDate: true, current, latest };
+    }
+
+    if (checkOnly) {
+        process.stderr.write(`\n[update] 可更新到 ${latest}（使用 "3rdloop update" 执行更新）\n`);
+        return { ok: true, current, latest };
+    }
+
+    // 交互确认（非 TTY 自动拒绝；--yes 跳过）
+    const confirmed = yes ? true : await confirmUpdate({ current, latest });
+
+    if (jsonMode) {
+        if (!confirmed) {
+            process.stdout.write(JSON.stringify({ ok: true, confirmed: false }, null, 2) + '\n');
+            return { ok: true, skipped: 'declined' };
+        }
+    }
+
+    if (!confirmed) {
+        process.stderr.write(`已取消更新。\n`);
+        return { ok: true, skipped: 'declined' };
+    }
+
+    process.stderr.write(`\n`);
+    try {
+        const r = performUpdate({ latest, registry, force });
+        return { ok: true, ...r };
+    } catch (err) {
+        const msg = `更新失败: ${err.message}`;
+        process.stderr.write(`\n[update] ${msg}\n`);
+        return { ok: false, error: msg };
+    }
+}

package/lib/workflow.js

@@ -8,6 +8,8 @@
  *   - 复用 runner.js 的 orchLoad / orchStart 链路执行编排，沿用 orch.js 的
  *     信号处理、进度渲染与退出码约定（passed=0 / failed=2 / TIMEOUT=3 / SIGINT=130 / SIGTERM=143）
  *   - --print-taskdef dry-run：只构造并打印/落盘 taskDef，不触碰引擎
+ *   - afterRun 钩子：工作流声明对象上可选的 async 函数，编排结束后执行
+ *     （成功/失败均调用；入参 { params, taskDef, result, dataDir, cwd }；抛错只记录不改退出码）
  *
  * 产品形态与责任边界：
  *   - 本期只提供机制（注册/分发/taskDef 构造/编排执行），不预置业务工作流
@@ -88,7 +90,7 @@ export async function cmdWorkflow({ wf, wfWords, flags, env }) {
     // ── 构造 taskDef ────────────────────────────────────────────────
     let taskDef;
     try {
-        taskDef = await wf.buildTaskDef(params, { dataDir });
+        taskDef = await wf.buildTaskDef(params, { dataDir, cwd: process.cwd() });
     } catch (err) {
         process.stderr.write(`工作流 "${wf.name}" 构造 taskDef 失败: ${err.message}\n`);
         return EXIT.ERROR;
@@ -174,6 +176,22 @@ export async function cmdWorkflow({ wf, wfWords, flags, env }) {
         await r.orchLoad(ctx, taskDef);
         const result = await _startAndRender(ctx, r, taskDef.taskId, { jsonMode, quiet, verbose, out, u, started });
 
+        // ── afterRun 钩子：工作流声明的后置动作（如报告复制）────────
+        // 成功/失败均执行（由工作流自身决定是否动作）；抛错只记录，不改变退出码。
+        if (typeof wf.afterRun === 'function') {
+            try {
+                await wf.afterRun({
+                    params,
+                    taskDef,
+                    result,
+                    dataDir,
+                    cwd: process.cwd(),
+                });
+            } catch (hookErr) {
+                process.stderr.write(`[workflow] afterRun 钩子执行失败（忽略）: ${hookErr.message}\n`);
+            }
+        }
+
         if (jsonMode) {
             out({
                 ok: result.passed,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ohos-cpf/3rdloop",
-    "version": "0.0.1",
+    "version": "0.0.2",
     "description": "3rdLibraryLoop 三方库自动化检视 CLI：嵌入式复用核心引擎，任务生命周期管理（submit/run/wait/progress/abort/list/result/doctor）",
     "type": "module",
     "license": "MIT",

package/vendor/Server/Brain/SkillExecutor.js

@@ -61,7 +61,7 @@ export class SkillExecutor {
     async getCLI() {
         if (!this._cli) {
             const CLIController = await _loadCLIController();
-            this._cli = new CLIController('opencode');
+            this._cli = new CLIController();
         }
         return this._cli;
     }
@@ -90,7 +90,7 @@ export class SkillExecutor {
         // ── 1. 健康检查 ──
         const health = await cli.checkHealth();
         if (health.status !== 'ok') {
-            throw new Error(`opencode 服务不可用: ${health.message || 'health check failed'}`);
+            throw new Error(`CLI(${cli.getType()}) 服务不可用: ${health.message || 'health check failed'}`);
         }
 
         // ── 1b. 确保工作目录存在 ──

package/vendor/Server/CLI/cli.js

@@ -1,13 +1,35 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import OpenCodeCLI from './opencode/index.js';
+import DevEcoCodeCLI from './deveco-code/index.js';
 import { StatsService } from '../library/StatsService.js';
 
+// 加载 Server/.env（本文件在 CLI/ 下，上一级目录为 Server/）。
+// dotenv 为可选依赖：未安装时跳过（如纯 mock 测试场景）。
+// dotenv 默认不覆盖已存在的环境变量，因此 shell export / --type 参数优先级仍高于 .env。
+try {
+    const dotenv = (await import('dotenv')).default;
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    dotenv.config({ path: path.resolve(__dirname, '..', '.env') });
+} catch {
+    // dotenv 未安装或 .env 不存在，跳过
+}
+
 /**
  * 通用 CLI 控制类
  *
- * 封装 opencode-cli，对外暴露统一的 Session 管理接口。
+ * 封装 AI 编程助手 CLI（opencode / deveco-code），对外暴露统一的 Session 管理接口。
+ *
+ * 默认 CLI 类型可在 Server/.env 中配置 CLI_TYPE=opencode|deveco-code，
+ * 也可通过 shell 环境变量 CLI_TYPE 指定（优先级高于 .env），均未设置时默认 'opencode'。
+ * 显式传入 type 参数优先级最高。
+ *
+ * 连接配置同样支持 .env：OPENCODE_HOST/OPENCODE_PORT、DEVECO_HOST/DEVECO_PORT。
  *
  * @example
- * const cli = new CLIController('opencode', { host: 'localhost', port: '4096' });
+ * const cli = new CLIController('opencode');   // 连接 localhost:4096
+ * const cli = new CLIController('deveco-code'); // 连接 localhost:4096（两者默认端口一致）
+ * const cli = new CLIController();  // 使用 .env / 环境变量 CLI_TYPE 指定的默认类型
  *
  * // 通用接口
  * await cli.checkHealth();
@@ -21,7 +43,8 @@ import { StatsService } from '../library/StatsService.js';
  */
 class CLIController {
     /**
-     * @param {'opencode'} type - CLI 类型
+     * @param {'opencode'|'deveco-code'} [type] - CLI 类型，缺省时取环境变量 CLI_TYPE
+     *   （shell 环境变量 > Server/.env），仍未设置则 'opencode'
      * @param {object} [options={}]       - 传递给对应适配器的配置项
      *
      * opencode 选项：
@@ -29,19 +52,28 @@ class CLIController {
      *   options.port    {string} - 服务端口（默认 4096）
      *   options.baseUrl {string} - 完整 URL，优先级高于 host/port
      *
+     * deveco-code 选项：
+     *   options.host    {string} - 服务主机（默认 localhost）
+     *   options.port    {string} - 服务端口（默认 4096，与 opencode 一致；两者需同时
+     *                              运行时可通过 DEVECO_PORT 指定不同端口）
+     *   options.baseUrl {string} - 完整 URL，优先级高于 host/port
+     *
      * 公共选项：
      *   options.archive    - MessageArchive 实例（消息存档与卡死检测），不传则适配器内部自建
      */
-    constructor(type = 'opencode', options = {}) {
+    constructor(type = process.env.CLI_TYPE || 'opencode', options = {}) {
         this.type = type;
 
         switch (type) {
             case 'opencode':
                 this.adapter = new OpenCodeCLI(options);
                 break;
+            case 'deveco-code':
+                this.adapter = new DevEcoCodeCLI(options);
+                break;
             default:
                 throw new Error(
-                    `不支持的 CLI 类型: "${type}"，可选值为 'opencode'`
+                    `不支持的 CLI 类型: "${type}"，可选值为 'opencode'、'deveco-code'`
                 );
         }
     }
@@ -224,7 +256,7 @@ class CLIController {
 
     /**
      * 返回当前使用的 CLI 类型
-     * @returns {'opencode'}
+     * @returns {'opencode'|'deveco-code'}
      */
     getType() {
         return this.type;
@@ -232,12 +264,12 @@ class CLIController {
 
     /**
      * 返回底层适配器实例（供高级用途）
-     * @returns {OpenCodeCLI}
+     * @returns {OpenCodeCLI|DevEcoCodeCLI}
      */
     getAdapter() {
         return this.adapter;
     }
 }
 
-export { CLIController, OpenCodeCLI };
+export { CLIController, OpenCodeCLI, DevEcoCodeCLI };
 export default CLIController;

package/vendor/Server/CLI/deveco-code/index.js

@@ -0,0 +1,71 @@
+import OpenCodeCLI from '../opencode/index.js';
+
+/**
+ * DevEco Code CLI 适配器
+ *
+ * 对接华为开源的 DevEco Code（https://gitcode.com/openharmony-sig/deveco-code），
+ * 面向 HarmonyOS 开发场景的 AI Agent 工具（npm 包 @deveco/deveco-code）。
+ *
+ * DevEco Code 基于开源项目 OpenCode 扩展开发，其 headless 服务（`deveco serve`）
+ * 保留与 opencode 完全一致的 HTTP API（/session、/session/{id}/message、
+ * /session/{id}/prompt_async、/session/status 等），因此本适配器直接继承
+ * OpenCodeCLI，复用其全部 Session 管理逻辑，仅覆盖连接配置与身份标识：
+ *
+ *   - 环境变量：DEVECO_HOST / DEVECO_PORT（优先级低于 options.host / options.port）
+ *   - 默认端口：4096（与 opencode 一致，两者同一时间只运行一个，无需改端口配置；
+ *     若需与 opencode 服务同时运行，可通过 DEVECO_PORT 指定其他端口）
+ *   - 存档 meta.cliType：'deveco-code'
+ *
+ * 服务启动方式：
+ *   deveco serve            （默认即监听 4096）
+ *   deveco serve --port X   （需共存/端口冲突时显式指定）
+ *   （注意：`deveco serve` 在 4096 被占用且未指定 --port 时会随机分配端口）
+ *
+ * @example
+ * const cli = new CLIController('deveco-code');  // 连接 localhost:4096
+ * await cli.checkHealth();
+ */
+class DevEcoCodeCLI extends OpenCodeCLI {
+    /** 存档 meta.cliType 标识 */
+    static _cliType = 'deveco-code';
+
+    /** 日志器名称 */
+    static _loggerName = 'DevEcoCodeCLI';
+
+    /**
+     * @param {object} options
+     * @param {string} [options.host]    - deveco 服务主机（默认 DEVECO_HOST 或 localhost）
+     * @param {string} [options.port]    - deveco 服务端口（默认 DEVECO_PORT 或 4096）
+     * @param {string} [options.baseUrl] - 完整 baseUrl，优先级高于 host/port
+     * @param {import('../../DbUse/MessageArchive.js').default} [options.archive] - 消息存档服务
+     */
+    constructor(options = {}) {
+        super({
+            ...options,
+            host: options.host || process.env.DEVECO_HOST || 'localhost',
+            port: options.port || process.env.DEVECO_PORT || '4096'
+        });
+        // cliType / _loggerName 已通过 static 覆盖，在父类构造期间即正确初始化
+    }
+
+    // ─── 运行状态检查 ──────────────────────────────────────────────────────────
+
+    /**
+     * 检查 deveco 服务是否正常运行（复用父类轻量健康检查逻辑，仅覆盖提示文案）
+     */
+    async checkHealth() {
+        try {
+            await this.client.session.list();
+            return { status: 'ok', message: 'DevEco Code CLI is healthy', target: this.baseUrl };
+        } catch (error) {
+            this._log('warn', `checkHealth: 连接失败 — ${error.message}`);
+            return {
+                status: 'error',
+                message: `Health check failed: ${error.message}`,
+                error: error.message
+            };
+        }
+    }
+}
+
+export default DevEcoCodeCLI;

package/vendor/Server/CLI/deveco-code.js

@@ -0,0 +1,5 @@
+/**
+ * DevEcoCodeCLI 快捷导出
+ * 方便通过 import DevEcoCodeCLI from './cli/deveco-code.js' 引用
+ */
+export { default } from './deveco-code/index.js';

package/vendor/Server/CLI/opencode/index.js

@@ -14,6 +14,17 @@ import { createLogger } from '../../Routes/library/logger.js';
  *   OPENCODE_PORT  - opencode 服务端口（默认 4096）
  */
 class OpenCodeCLI {
+    /**
+     * CLI 类型标识（写入存档 meta，供导出/审计区分底层 CLI）。
+     * 子类通过 static 字段覆盖，父类构造期间即可生效。
+     */
+    static _cliType = 'opencode';
+
+    /**
+     * 日志器名称。子类通过 static 字段覆盖，父类构造期间即可生效。
+     */
+    static _loggerName = 'OpenCodeCLI';
+
     /**
      * @param {object} options
      * @param {string} [options.host]    - opencode 服务主机
@@ -26,6 +37,9 @@ class OpenCodeCLI {
         this.port = options.port || process.env.OPENCODE_PORT || '4096';
         this.baseUrl = options.baseUrl || `http://${this.host}:${this.port}`;
         this.client = null;
+        // CLI 类型标识 / 日志器名称（经 static 覆盖，子类构造期间即正确）
+        this.cliType = this.constructor._cliType;
+        this._loggerName = this.constructor._loggerName;
         // 消息存档：用于保留对话消息、判断 opencode 是否长时间无新响应（防卡死）
         this.archive = options.archive ?? new MessageArchive();
         // 记录各 session 首次进入 busy/retry 的时间戳（ms），用于"busy 停滞兜底"判定
@@ -329,7 +343,7 @@ class OpenCodeCLI {
             await this.archive.patchMeta(sessionId, {
                 sessionId,
                 title,
-                cliType: 'opencode',
+                cliType: this.cliType,
                 createdAt: nowCST(),
                 status: 'idle'
             }).catch(e => {
@@ -784,7 +798,7 @@ class OpenCodeCLI {
     // ─── 内部方法 ──────────────────────────────────────────────────────────────
 
     _log(level, msg) {
-        const logger = createLogger('OpenCodeCLI');
+        const logger = createLogger(this._loggerName);
         switch (level) {
             case 'error':
                 logger.error(`❌ ${msg}`);

package/vendor/Server/FlexRunner/FlexRunner.js

@@ -402,7 +402,7 @@ class FlexRunner {
             this.#cli = cli;
         } else {
             const CLIController = await _loadCLIController();
-            this.#cli = new CLIController('opencode', {});
+            this.#cli = new CLIController();
         }
 
         if (skillSelector) {
@@ -815,7 +815,7 @@ class FlexRunner {
             // ── 1. 健康检查 ──
             const health = await this.#cli.checkHealth();
             if (health.status !== 'ok') {
-                this._log('error', `opencode 服务不可用: ${health.message}`);
+                this._log('error', `CLI(${this.#cli.getType()}) 服务不可用: ${health.message}`);
                 return false;
             }
 

package/vendor/Server/Knowledge/KnowledgeImporter.js

@@ -101,7 +101,7 @@ class KnowledgeImporter {
     async _getCLI() {
         if (!this._cli) {
             const CLIController = await _loadCLIController();
-            this._cli = new CLIController('opencode', {});
+            this._cli = new CLIController();
         }
         return this._cli;
     }

package/vendor/Server/LoopEngine/LoopEngine.js

@@ -251,7 +251,7 @@ class LoopEngine {
         let cli = null;
         try {
             const mod = await import('../CLI/cli.js');
-            cli = new mod.CLIController('opencode', {});
+            cli = new mod.CLIController();
         } catch (err) {
             this._log('warn', `_abortSessions: 加载 CLIController 失败: ${err.message}`);
             return;

package/vendor/Server/Routes/server.js

@@ -30,14 +30,15 @@ import KnowledgeImportController from './controllers/KnowledgeImportController.j
  *   const server = await createServer({ port: 3000 });
  *
  * 或直接运行：
- *   node server.js --port 3000 --type opencode
+ *   node server.js --port 3000 --type deveco-code
+ *   （也可用环境变量指定默认 CLI：CLI_TYPE=deveco-code node server.js --port 3000）
  */
 
 /**
  * 创建并启动 HTTP 服务
  * @param {object} [options]
  * @param {number} [options.port=3000]          - 监听端口
- * @param {string} [options.cliType='opencode'] - CLI 类型
+ * @param {string} [options.cliType]            - CLI 类型，缺省时取环境变量 CLI_TYPE，仍未设置则 'opencode'
  * @param {object} [options.cliOptions={}]      - CLI 适配器配置
  * @param {CLIController} [options.cli]         - 已存在的 CLI 实例（优先于 cliType/cliOptions）
  * @returns {Promise<http.Server>}
@@ -45,7 +46,7 @@ import KnowledgeImportController from './controllers/KnowledgeImportController.j
 export async function createServer(options = {}) {
     const {
         port = 3000,
-        cliType = 'opencode',
+        cliType = process.env.CLI_TYPE || 'opencode',
         cliOptions = {},
         cli = null
     } = options;
@@ -191,7 +192,7 @@ if (import.meta.url === pathToFileURL(process.argv[1]).href) {
     const portIdx = args.indexOf('--port');
     const typeIdx = args.indexOf('--type');
     const port = portIdx !== -1 ? Number(args[portIdx + 1]) : 3000;
-    const cliType = typeIdx !== -1 ? args[typeIdx + 1] : 'opencode';
+    const cliType = typeIdx !== -1 ? args[typeIdx + 1] : (process.env.CLI_TYPE || 'opencode');
 
     createServer({ port, cliType }).catch(err => {
         console.error('[Server] 启动失败:', err);