@ohos-cpf/3rdloop 0.0.7 → 0.0.8

package/lib/opencode.js

@@ -1,11 +1,15 @@
 /**
- * opencode.js —— opencode serve 生命周期管理
+ * opencode.js —— AI CLI serve 生命周期管理（opencode / deveco-code）
  *
  * 策略（A4）：
- *   - 探测：操作前 checkHealth()（SDK session.list()）
- *   - 拉起：CLI 自持 spawn('opencode serve')，透传 stderr 前几行；已在运行则复用不接管
+ *   - 类型：由 CLI_TYPE 决定（显式参数 > 环境变量/.env 链 > 默认 deveco-code），
+ *     deveco-code 时拉起 `deveco serve`，否则 `opencode serve`
+ *     （deveco-code 基于 opencode 扩展，HTTP API 同源，/health 通用）
+ *   - 探测：操作前 checkHealth()（HTTP GET /health）
+ *   - 拉起：CLI 自持 spawn('<bin> serve --port <port>')，透传 stderr 前几行；
+ *     已在运行则复用不接管；远端 host（非 localhost）只探测不拉起
  *   - 归属：CLI 自己拉的记 pid，退出时先 abortLoop 再杀子进程
- *   - 已知坑（AGENTS.md）：opencode 需在项目上一级目录执行 opencode serve；
+ *   - 已知坑（AGENTS.md）：serve 需在项目上一级目录执行；
  *     子任务 session 创建时强制指定 cwd 会触发权限问题（已验证 SkillExecutor.drop cwd）
  *
  * 跨平台进程清理：
@@ -14,26 +18,57 @@
 
 import { spawn, execSync } from 'node:child_process';
 import path from 'node:path';
-import fs from 'node:fs';
+import { resolveCliType } from './config.js';
+
+/** CLI 类型 → 可执行文件名 */
+const CLI_BINS = { opencode: 'opencode', 'deveco-code': 'deveco' };
+
+/** CLI 类型 → host/port 环境变量（与 Server/CLI 适配器同源） */
+const CLI_HOST_ENV = { opencode: 'OPENCODE_HOST', 'deveco-code': 'DEVECO_HOST' };
+const CLI_PORT_ENV = { opencode: 'OPENCODE_PORT', 'deveco-code': 'DEVECO_PORT' };
+
+const LOCAL_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]', '::1']);
+
+/**
+ * 解析某 CLI 类型的 serve 连接配置（bin / host / port）。
+ *
+ * 优先级与 Server/CLI 适配器、check-env.mjs 的 resolveCliServePort 保持一致：
+ *   环境变量（含 .env 链注入）> 默认 localhost:4096。
+ *
+ * @param {string} [cliType] - 未传时按 resolveCliType() 解析
+ * @returns {{ cliType: 'opencode'|'deveco-code', bin: string, host: string, port: number }}
+ */
+export function resolveCliServeConfig(cliType) {
+    const type = resolveCliType(cliType);
+    const port = Number.parseInt(String(process.env[CLI_PORT_ENV[type]] ?? ''), 10) || 4096;
+    const host = String(process.env[CLI_HOST_ENV[type]] ?? '').trim() || 'localhost';
+    return { cliType: type, bin: CLI_BINS[type], host, port };
+}
 
 /**
- * opencode 服务管理器。
+ * AI CLI serve 服务管理器（opencode / deveco-code 统一）。
  *
  * @example
- * const mgr = new OpencodeManager({ projectRoot });
+ * const mgr = new CliServeManager({ projectRoot });
  * await mgr.ensureRunning();     // 探测 -> 若未运行则拉起
  * await mgr.stop();              // 若由本 CLI 拉起则杀掉
  */
-export class OpencodeManager {
+export class CliServeManager {
     /**
      * @param {object} opts
-     * @param {string} opts.projectRoot - 项目根（opencode serve 需在上一级目录运行）
-     * @param {number} [opts.port]      - opencode 端口（默认 4096）
+     * @param {string} opts.projectRoot - 项目根（serve 需在上一级目录运行）
+     * @param {string} [opts.cliType]   - CLI 类型（默认按 CLI_TYPE 环境解析）
+     * @param {string} [opts.host]      - 服务主机（默认 OPENCODE_HOST/DEVECO_HOST 或 localhost）
+     * @param {number} [opts.port]      - 服务端口（默认 OPENCODE_PORT/DEVECO_PORT 或 4096）
      */
     constructor(opts = {}) {
+        const cfg = resolveCliServeConfig(opts.cliType);
+        this.cliType = cfg.cliType;
+        this.bin = cfg.bin;
         this.projectRoot = opts.projectRoot || process.cwd();
-        this.port = opts.port || 4096;
-        this.baseUrl = `http://localhost:${this.port}`;
+        this.host = opts.host || cfg.host;
+        this.port = opts.port || cfg.port;
+        this.baseUrl = `http://${this.host}:${this.port}`;
         /** @type {import('node:child_process').ChildProcess|null} */
         this.child = null;
         /** @type {boolean} 是否由本 CLI 拉起（决定退出时是否杀） */
@@ -41,29 +76,28 @@ export class OpencodeManager {
     }
 
     /**
-     * 探测 opencode 是否已在运行。
-     * 通过 HTTP /health 或 session.list 连通性判断。
+     * 探测 serve 是否已在运行。
+     * 通过 HTTP /health 连通性判断（opencode / deveco-code 同源 API）。
      * @returns {Promise<{ ok: boolean, message: string }>}
      */
     async checkHealth() {
         try {
-            // 轻量探测：尝试连接 baseUrl 的 /health（opencode 服务提供）
             const controller = new AbortController();
             const timer = setTimeout(() => controller.abort(), 3000);
             const res = await fetch(`${this.baseUrl}/health`, { signal: controller.signal });
             clearTimeout(timer);
             if (res.ok) {
-                return { ok: true, message: `opencode 服务正常 (${this.baseUrl})` };
+                return { ok: true, message: `${this.cliType} 服务正常 (${this.baseUrl})` };
             }
-            return { ok: false, message: `opencode 服务响应异常 (HTTP ${res.status})` };
+            return { ok: false, message: `${this.cliType} 服务响应异常 (HTTP ${res.status})` };
         } catch {
-            return { ok: false, message: `opencode 服务未运行 (${this.baseUrl})` };
+            return { ok: false, message: `${this.cliType} 服务未运行 (${this.baseUrl})` };
         }
     }
 
     /**
-     * 确保 opencode serve 正在运行。
-     * 未运行时自动拉起（在项目上一级目录执行）。
+     * 确保 serve 正在运行。
+     * 未运行时自动拉起（在项目上一级目录执行；远端 host 只探测不拉起）。
      * @returns {Promise<{ ok: boolean, message: string, spawned: boolean }>}
      */
     async ensureRunning() {
@@ -72,12 +106,21 @@ export class OpencodeManager {
             return { ok: true, message: health.message, spawned: false };
         }
 
+        // 远端 host：无法本地拉起，直接返回探测结果
+        if (!LOCAL_HOSTS.has(this.host)) {
+            return {
+                ok: false,
+                message: `${this.cliType} 服务不可达 (${this.baseUrl})，且远端 host 无法自动拉起，请先启动 ${this.bin} serve`,
+                spawned: false,
+            };
+        }
+
         // 未运行 → 尝试拉起
         const cwd = path.resolve(this.projectRoot, '..');
-        this._log(`尝试启动 opencode serve (cwd=${cwd})...`);
+        this._log(`尝试启动 ${this.bin} serve --port ${this.port} (cwd=${cwd})...`);
 
         try {
-            const child = spawn('opencode', ['serve'], {
+            const child = spawn(this.bin, ['serve', '--port', String(this.port)], {
                 cwd,
                 stdio: ['ignore', 'pipe', 'pipe'],
                 shell: process.platform === 'win32',
@@ -100,7 +143,7 @@ export class OpencodeManager {
                 await this._sleep(1000);
                 const healthAgain = await this.checkHealth();
                 if (healthAgain.ok) {
-                    return { ok: true, message: `已启动 opencode serve (${this.baseUrl})`, spawned: true };
+                    return { ok: true, message: `已启动 ${this.cliType} serve (${this.baseUrl})`, spawned: true };
                 }
                 // 子进程提前退出则报错
                 if (child.exitCode != null) {
@@ -111,25 +154,25 @@ export class OpencodeManager {
             const stderrSnippet = stderrLines.join('\n  ');
             return {
                 ok: false,
-                message: 'opencode serve 启动超时或失败' + (stderrSnippet ? `：\n  ${stderrSnippet}` : ''),
+                message: `${this.cliType} serve 启动超时或失败` + (stderrSnippet ? `：\n  ${stderrSnippet}` : ''),
                 spawned: true,
             };
         } catch (err) {
             return {
                 ok: false,
-                message: `启动 opencode serve 失败: ${err.message}`,
+                message: `启动 ${this.cliType} serve 失败: ${err.message}`,
                 spawned: false,
             };
         }
     }
 
     /**
-     * 停止由本 CLI 拉起的 opencode 进程。
+     * 停止由本 CLI 拉起的 serve 进程。
      */
     async stop() {
         if (!this.spawnedByUs || !this.child || this.child.pid == null) return;
         const pid = this.child.pid;
-        this._log(`停止由本 CLI 拉起的 opencode serve (pid=${pid})`);
+        this._log(`停止由本 CLI 拉起的 ${this.cliType} serve (pid=${pid})`);
         try {
             if (process.platform === 'win32') {
                 execSync(`taskkill /pid ${pid} /T /F`, { stdio: 'ignore' });
@@ -151,6 +194,9 @@ export class OpencodeManager {
     _sleep(ms) { return new Promise(r => setTimeout(r, ms)); }
 
     _log(msg) {
-        process.stderr.write(`[opencode] ${msg}\n`);
+        process.stderr.write(`[${this.bin}] ${msg}\n`);
     }
-}
+}
+
+/** 兼容旧名（历史上仅支持 opencode）。新代码请使用 CliServeManager。 */
+export const OpencodeManager = CliServeManager;

package/lib/orch.js

@@ -130,6 +130,17 @@ async function cmdOrchRun({ flags, rest, projectRoot, dataDir, skillDir, jsonMod
         return EXIT.ERROR;
     }
 
+    // ── 环境预检（引擎执行前快速失败：凭据/目录类问题直接退出码 1） ──
+    {
+        const { precheckEnv, reportPrecheckFailures } = await import('./doctor.js');
+        const pre = await precheckEnv({ projectRoot, dataDir, skillDir });
+        if (!pre.ok) {
+            if (jsonMode) out({ ok: false, error: '环境预检未通过', taskId: taskDef.taskId, failures: pre.failures });
+            else reportPrecheckFailures(pre.failures);
+            return EXIT.ERROR;
+        }
+    }
+
     if (!quiet && !jsonMode) {
         u.logProgress(`${u.C.cyan}编排任务已提交: ${u.C.reset}${u.C.bold}${taskDef.taskId}${u.C.reset}`);
         u.logProgress(`  任务定义: ${taskDefFile}`);
@@ -142,10 +153,10 @@ async function cmdOrchRun({ flags, rest, projectRoot, dataDir, skillDir, jsonMod
     }
 
     const r = await _runner();
-    const ctx = r.createRunContext({ projectRoot, dataDir, skillDir, cliType: 'opencode', verbose });
+    const ctx = r.createRunContext({ projectRoot, dataDir, skillDir, verbose });
 
-    // 挂载 opencode 生命周期
-    const oc = await _ensureOpcodene(ctx, u, jsonMode, out);
+    // 挂载 AI CLI serve 生命周期
+    const oc = await _ensureCliServe(ctx, u, jsonMode, out);
     if (!oc) return EXIT.ERROR;
 
     // 信号处理
@@ -220,9 +231,20 @@ async function cmdOrchStart({ flags, rest, projectRoot, dataDir, skillDir, jsonM
         return EXIT.ERROR;
     }
 
+    // ── 环境预检（引擎执行前快速失败：凭据/目录类问题直接退出码 1） ──
+    {
+        const { precheckEnv, reportPrecheckFailures } = await import('./doctor.js');
+        const pre = await precheckEnv({ projectRoot, dataDir, skillDir });
+        if (!pre.ok) {
+            if (jsonMode) out({ ok: false, error: '环境预检未通过', taskId, failures: pre.failures });
+            else reportPrecheckFailures(pre.failures);
+            return EXIT.ERROR;
+        }
+    }
+
     const r = await _runner();
-    const ctx = r.createRunContext({ projectRoot, dataDir, skillDir, cliType: 'opencode', verbose });
-    const oc = await _ensureOpcodene(ctx, u, jsonMode, out);
+    const ctx = r.createRunContext({ projectRoot, dataDir, skillDir, verbose });
+    const oc = await _ensureCliServe(ctx, u, jsonMode, out);
     if (!oc) return EXIT.ERROR;
 
     let interrupted = false;
@@ -410,15 +432,15 @@ async function cmdOrchTasks({ flags, rest, dataDir, jsonMode, out, u }) {
 
 // ─── 工具 ──────────────────────────────────────────────────────────────────
 
-/** 确保 opencode serve 运行（run/start 需要执行环境；load/progress 不需要）。 */
-async function _ensureOpcodene(ctx, u, jsonMode, out) {
-    const { OpencodeManager } = await import('./opencode.js');
-    const oc = new OpencodeManager({ projectRoot: ctx.projectRoot });
+/** 确保 AI CLI serve 运行（run/start 需要执行环境；load/progress 不需要）。 */
+async function _ensureCliServe(ctx, u, jsonMode, out) {
+    const { CliServeManager } = await import('./opencode.js');
+    const oc = new CliServeManager({ projectRoot: ctx.projectRoot, cliType: ctx.cliType });
     const ocHealth = await oc.ensureRunning();
     if (!ocHealth.ok) {
         if (jsonMode) out({ ok: false, error: ocHealth.message });
         process.stderr.write(`\n错误: ${ocHealth.message}\n`);
-        process.stderr.write('请先启动 opencode serve（项目上一级目录: opencode serve）后重试。\n');
+        process.stderr.write(`请先启动 ${oc.cliType} serve（项目上一级目录: ${oc.bin} serve）后重试。\n`);
         await oc.stop();
         return null;
     }

package/lib/runner.js

@@ -20,6 +20,7 @@
 import path from 'node:path';
 import fs from 'node:fs';
 import { fileURLToPath } from 'node:url';
+import { resolveCliType } from './config.js';
 
 // ─── vendor 路径解析 ─────────────────────────────────────────────────────────
 // 优先用 vendor/Server 下的副本（发布态）；开发期允许回退到仓库 Server/ 源码。
@@ -99,14 +100,16 @@ class RunContext {
      * @param {string} opts.projectRoot
      * @param {string} opts.dataDir
      * @param {string} opts.skillDir
-     * @param {string} opts.cliType
+     * @param {string} [opts.cliType] - CLI 类型，缺省时按 CLI_TYPE 解析（默认 deveco-code）
      * @param {boolean} opts.verbose
      */
     constructor(opts = {}) {
         this.projectRoot = opts.projectRoot || process.cwd();
         this.dataDir = opts.dataDir || '';
         this.skillDir = opts.skillDir || '';
-        this.cliType = opts.cliType || 'opencode';
+        // CLI 类型解析：显式参数 > CLI_TYPE（env/.env 链）> deveco-code（默认），
+        // 与 Server/Routes/server.js 的 createServer 默认行为一致。
+        this.cliType = resolveCliType(opts.cliType);
         this.verbose = !!opts.verbose;
         this._ready = false;
         this.cliRoot = opts.cliRoot || CLI_ROOT;
@@ -132,9 +135,9 @@ class RunContext {
             flexRunnerFactory: null,
         });
 
-        // 注入共享 cli：Brain/TestCheck 若不注入，会惰性 new CLIController('opencode')
-        // 其默认 MessageArchive 基于 vendor/Server 相对路径上溯 → 落到 cli/db/Session（数据错位）。
-        // 注入后会话归档统一写用户数据目录。
+        // 注入共享 cli：Brain/TestCheck 若不注入，会各自惰性 new CLIController()
+        // （其默认取 env CLI_TYPE，但 MessageArchive 基于 vendor/Server 相对路径上溯
+        //   → 落到 cli/db/Session，数据错位）。注入后会话归档统一写用户数据目录。
         this.brainController = new (await this._importBrainController())({
             storage: this.storage,
             skillDirectory: this.skillDir,