svharness 0.15.11 → 0.15.13

package/dist/commands/auto.js

@@ -12,6 +12,7 @@ const logger_1 = require("../utils/logger");
 const harness_resolver_1 = require("../lib/harness-resolver");
 const auto_orchestrator_1 = require("../lib/auto-orchestrator");
 const dashboard_1 = require("../dashboard");
+const acp_agent_cli_resolver_1 = require("../lib/acp-agent-cli-resolver");
 /**
  * Prevent system sleep on Windows during long-running auto execution.
  * Registers process-level handlers so sleep is restored on any exit path.
@@ -46,6 +47,13 @@ async function runAuto(positionalWorkdir, opts, cmd) {
     const merged = (0, config_1.mergeAutoOptions)(opts, loaded?.config.auto, loaded?.config.defaults, cmd);
     const ctx = await resolveAutoContext(positionalWorkdir, merged);
     (0, logger_1.setVerbose)(ctx.verbose);
+    if (!ctx.dryRun) {
+        logger_1.logger.section('[auto] 启动前检查：Agent CLI');
+        if (!ctx.acpAgentCli) {
+            throw new Error('内部错误：ACP Agent CLI 未解析');
+        }
+        logger_1.logger.success(`已找到 Agent CLI → ${(0, acp_agent_cli_resolver_1.formatAcpAgentCliLog)(ctx.acpAgentCli)}`);
+    }
     // Start dashboard server (non-blocking, best-effort)
     (0, dashboard_1.startDashboard)(7879).catch(() => { });
     // Prevent system sleep during execution; restore on any exit path
@@ -63,12 +71,14 @@ async function runAuto(positionalWorkdir, opts, cmd) {
 async function resolveAutoContext(positionalWorkdir, opts) {
     const workDir = node_path_1.default.resolve(positionalWorkdir ?? opts.workDir ?? process.cwd());
     const harnessRoot = await (0, harness_resolver_1.resolveHarnessRoot)(workDir);
+    const acpAgentCli = opts.dryRun ? null : (0, acp_agent_cli_resolver_1.ensureAcpAgentCliAvailable)();
     return {
         workDir,
         harnessRoot,
         harnessExists: !!harnessRoot,
+        acpAgentCli,
         targetScore: normalizeNumber(opts.targetScore, 9.5, '--target-score'),
-        maxOptimizeRounds: normalizeInteger(opts.maxOptimizeRounds, 5, '--max-optimize-rounds'),
+        maxOptimizeRounds: normalizeInteger(opts.maxOptimizeRounds, 10, '--max-optimize-rounds'),
         dryRun: !!opts.dryRun,
         autoApprove: !!opts.autoApprove,
         yes: !!opts.yes,
@@ -80,6 +90,8 @@ async function resolveAutoContext(positionalWorkdir, opts) {
         acpTimeoutMs: normalizeInteger(opts.acpTimeoutMs, 1_800_000, '--acp-timeout-ms'),
         maxRetriesPerPhase: normalizeInteger(opts.maxRetriesPerPhase, 2, '--max-retries-per-phase'),
         baselineAutoExtract: normalizeBaselineExtract(opts.baselineAutoExtract),
+        scope: normalizeScope(opts.scope),
+        sampleCount: normalizeInteger(opts.sampleCount, 7, '--sample-count'),
         promptDir: opts.promptDir,
         checkpoint: opts.checkpoint,
         maxPhase: opts.maxPhase,
@@ -107,3 +119,6 @@ function normalizeBaselineExtract(value) {
     }
     return 'conservative';
 }
+function normalizeScope(value) {
+    return value === 'requirements' ? 'requirements' : 'full';
+}

package/dist/commands/convert.js

@@ -182,6 +182,8 @@ async function runConvert(opts) {
         catch (err) {
             const e = err;
             logger_1.logger.error(`markitdown_serve unreachable at ${v.endpoint}: ${e.message}`);
+            logger_1.logger.plain('  - if another user is converting a large PDF, the service may still be busy; retry in a minute');
+            logger_1.logger.plain('  - production should run uvicorn with --workers 4+ and nginx proxy_read_timeout ≥ 900s');
             logger_1.logger.plain('');
             logger_1.logger.plain('  - confirm the service is deployed and reachable from this machine');
             logger_1.logger.plain('  - pass --endpoint <url> or comma-separated URLs for failover');

package/dist/commands/shell-integration.js

@@ -3,7 +3,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveLaunchScriptPath = void 0;
 exports.resolveShellMenuIconSourcePath = resolveShellMenuIconSourcePath;
 exports.installShellMenuIcon = installShellMenuIcon;
 exports.resolveWindowsTerminalPath = resolveWindowsTerminalPath;
@@ -19,11 +18,8 @@ const child_process_1 = require("child_process");
 const logger_1 = require("../utils/logger");
 const win_registry_1 = require("../lib/win-registry");
 const ps_codechat_alias_1 = require("../lib/ps-codechat-alias");
-const launch_script_path_1 = require("../lib/launch-script-path");
-Object.defineProperty(exports, "resolveLaunchScriptPath", { enumerable: true, get: function () { return launch_script_path_1.resolveLaunchScriptPath; } });
 const STUB_DIR = path_1.default.join(process.env.LOCALAPPDATA ?? path_1.default.join(os_1.default.homedir(), 'AppData', 'Local'), 'svharness', 'bin');
-const STUB_PATH = path_1.default.join(STUB_DIR, 'launch_codechat_cli.ps1');
-const LEGACY_STUB_PATH = path_1.default.join(STUB_DIR, 'launch_codechat_cli.cmd');
+const PS1_INSTALL_PATH = path_1.default.join(STUB_DIR, 'Start-CodeChat.ps1');
 const ICON_FILENAME = 'codechat-agent.ico';
 const ICON_STUB_PATH = path_1.default.join(STUB_DIR, ICON_FILENAME);
 const STANDALONE_MENU_KEY_BG = 'HKCU\\Software\\Classes\\Directory\\Background\\shell\\CodeChatStandaloneAgent';
@@ -102,31 +98,24 @@ function resolveWindowsTerminalPath() {
     }
     return null;
 }
-function buildStubContent(launchScriptPath) {
-    const escapedNodeScript = launchScriptPath.replace(/'/g, "''");
-    // ASCII-only + UTF-8 BOM. Legacy conhost fallback sets UTF-8 before CodeChat TUI.
-    return `param(
-  [string]$WorkDir = (Get-Location).Path
-)
-
-$ErrorActionPreference = 'Stop'
-
-try { chcp 65001 | Out-Null } catch {}
-[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)
-[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
-$OutputEncoding = [System.Text.UTF8Encoding]::new($false)
-
-Set-Location -LiteralPath $WorkDir
-& node '${escapedNodeScript}' "$WorkDir"
-exit $LASTEXITCODE
-`;
-}
-function writeStubFile(launchScriptPath) {
-    const content = buildStubContent(launchScriptPath);
-    return fs_extra_1.default.writeFile(STUB_PATH, `\uFEFF${content}`, 'utf8');
-}
 function buildPsInvokeArgs(ps1Path, dirPlaceholder) {
-    return `-NoExit -NoProfile -ExecutionPolicy Bypass -File "${ps1Path}" ${dirPlaceholder}`;
+    return `-NoExit -NoProfile -ExecutionPolicy Bypass -File "${ps1Path}" -Action Start -WorkDir ${dirPlaceholder}`;
+}
+async function installStartCodeChatPs1() {
+    const fromDist = path_1.default.resolve(__dirname, '..', '..', 'templates', 'codechat', 'Start-CodeChat.ps1');
+    const fromCwd = path_1.default.resolve(__dirname, '..', '..', '..', 'templates', 'codechat', 'Start-CodeChat.ps1');
+    let source = '';
+    if (fs_extra_1.default.existsSync(fromDist)) {
+        source = fromDist;
+    }
+    else if (fs_extra_1.default.existsSync(fromCwd)) {
+        source = fromCwd;
+    }
+    else {
+        throw new Error(`\u672A\u627E\u5230 Start-CodeChat.ps1\uFF08\u9884\u671F\uFF1A${fromDist}\uFF09`);
+    }
+    await fs_extra_1.default.copy(source, PS1_INSTALL_PATH, { overwrite: true });
+    return PS1_INSTALL_PATH;
 }
 function buildMenuCommand(ps1Path, dirPlaceholder, wtPath) {
     const psArgs = buildPsInvokeArgs(ps1Path, dirPlaceholder);
@@ -150,23 +139,18 @@ async function runShellInstall(opts = {}) {
     // Avoid duplicate menu entries: overwrite standalone menu if present.
     (0, win_registry_1.regDeleteKey)(STANDALONE_MENU_KEY_BG);
     (0, win_registry_1.regDeleteKey)(STANDALONE_MENU_KEY_DIR);
-    const launchScriptPath = (0, launch_script_path_1.resolveLaunchScriptPath)();
     await fs_extra_1.default.ensureDir(STUB_DIR);
-    await writeStubFile(launchScriptPath);
-    if (await fs_extra_1.default.pathExists(LEGACY_STUB_PATH)) {
-        await fs_extra_1.default.remove(LEGACY_STUB_PATH);
-    }
+    const ps1Path = await installStartCodeChatPs1();
     const iconValue = await installShellMenuIcon();
     const wtPath = resolveWindowsTerminalPath();
-    const bgCommand = buildMenuCommand(STUB_PATH, '"%V"', wtPath);
-    const dirCommand = buildMenuCommand(STUB_PATH, '"%1"', wtPath);
+    const bgCommand = buildMenuCommand(PS1_INSTALL_PATH, '"%V"', wtPath);
+    const dirCommand = buildMenuCommand(PS1_INSTALL_PATH, '"%1"', wtPath);
     registerMenuKey(win_registry_1.SHELL_MENU_KEY_BG, bgCommand, iconValue);
     registerMenuKey(win_registry_1.SHELL_MENU_KEY_DIR, dirCommand, iconValue);
     const via = wtPath ? 'Windows Terminal' : 'PowerShell（UTF-8）';
     logSuccess(`Windows 右键菜单已注册：「在此启动 CodeChat Agent」（${via}）`, opts.silent);
-    logInfo(`  stub: ${STUB_PATH}`, opts.silent);
+    logInfo(`  脚本: ${ps1Path}`, opts.silent);
     logInfo(`  icon: ${ICON_STUB_PATH}`, opts.silent);
-    logInfo(`  脚本: ${launchScriptPath}`, opts.silent);
     if (wtPath) {
         logInfo(`  wt:   ${wtPath}`, opts.silent);
     }
@@ -183,15 +167,12 @@ async function runShellUninstall(opts = {}) {
     // Also remove standalone script menu (Start-CodeChat.ps1 independent install)
     (0, win_registry_1.regDeleteKey)(STANDALONE_MENU_KEY_BG);
     (0, win_registry_1.regDeleteKey)(STANDALONE_MENU_KEY_DIR);
-    if (await fs_extra_1.default.pathExists(STUB_PATH)) {
-        await fs_extra_1.default.remove(STUB_PATH);
+    if (await fs_extra_1.default.pathExists(PS1_INSTALL_PATH)) {
+        await fs_extra_1.default.remove(PS1_INSTALL_PATH);
     }
     if (await fs_extra_1.default.pathExists(ICON_STUB_PATH)) {
         await fs_extra_1.default.remove(ICON_STUB_PATH);
     }
-    if (await fs_extra_1.default.pathExists(LEGACY_STUB_PATH)) {
-        await fs_extra_1.default.remove(LEGACY_STUB_PATH);
-    }
     // Clean up standalone script directory (Start-CodeChat.ps1 independent install)
     const standaloneDir = path_1.default.join(process.env.LOCALAPPDATA ?? path_1.default.join(os_1.default.homedir(), 'AppData', 'Local'), 'codechat-standalone');
     if (await fs_extra_1.default.pathExists(standaloneDir)) {
@@ -205,24 +186,17 @@ async function runShellUninstall(opts = {}) {
  */
 function getShellStatus() {
     assertWin32();
-    let launchScriptPath = '';
-    try {
-        launchScriptPath = (0, launch_script_path_1.resolveLaunchScriptPath)();
-    }
-    catch {
-        launchScriptPath = '(未找到)';
-    }
+    const ps1Installed = fs_extra_1.default.existsSync(PS1_INSTALL_PATH);
     const backgroundMenu = (0, win_registry_1.regKeyExists)(win_registry_1.SHELL_MENU_KEY_BG);
     const directoryMenu = (0, win_registry_1.regKeyExists)(win_registry_1.SHELL_MENU_KEY_DIR);
-    const stubExists = fs_extra_1.default.existsSync(STUB_PATH);
     const wtPath = resolveWindowsTerminalPath();
     const aliasStatus = (0, ps_codechat_alias_1.getCodechatAliasStatus)();
     return {
-        installed: backgroundMenu && directoryMenu && stubExists,
-        stubPath: STUB_PATH,
+        installed: backgroundMenu && directoryMenu && ps1Installed,
+        stubPath: PS1_INSTALL_PATH,
         backgroundMenu,
         directoryMenu,
-        launchScriptPath,
+        launchScriptPath: PS1_INSTALL_PATH,
         viaWindowsTerminal: wtPath !== null,
         aliasInstalled: aliasStatus.installed,
         profilePath: aliasStatus.profilePath,
@@ -232,10 +206,9 @@ function printShellStatus() {
     const status = getShellStatus();
     logger_1.logger.section('Windows shell 集成状态');
     logger_1.logger.plain(`  右键菜单完整: ${status.installed ? '是' : '否'}`);
-    logger_1.logger.plain(`  stub 路径:     ${status.stubPath}`);
+    logger_1.logger.plain(`  Start-CodeChat.ps1: ${status.stubPath}`);
     logger_1.logger.plain(`  空白处菜单:    ${status.backgroundMenu ? '已注册' : '未注册'}`);
     logger_1.logger.plain(`  文件夹菜单:    ${status.directoryMenu ? '已注册' : '未注册'}`);
-    logger_1.logger.plain(`  启动脚本:      ${status.launchScriptPath}`);
     logger_1.logger.plain(`  经 WT 启动:    ${status.viaWindowsTerminal ? '是（install 时检测到 wt.exe）' : '否'}`);
     logger_1.logger.plain(`  codechat 别名: ${status.aliasInstalled ? '已安装' : '未安装'}`);
     logger_1.logger.plain(`  profile 路径:  ${status.profilePath}`);

package/dist/config/merge-options.js

@@ -85,6 +85,8 @@ function mergeAutoOptions(cli, configSection, defaults, cmd) {
         promptDir: pickString('promptDir', cli.promptDir, cfg.promptDir, cmd),
         baselineAutoExtract: pickString('baselineAutoExtract', cli.baselineAutoExtract, cfg.baselineAutoExtract, cmd),
         convertEndpoint: pickString('convertEndpoint', cli.convertEndpoint, cfg.convertEndpoint, cmd),
+        scope: pickString('scope', cli.scope, cfg.scope, cmd),
+        sampleCount: pickNumber('sampleCount', cli.sampleCount, cfg.sampleCount, cmd),
     };
 }
 function mergeBuildOptions(cli, configSection, defaults, cmd) {

package/dist/config/normalize.js

@@ -50,6 +50,7 @@ function pickAutoSection(raw) {
         'costAlertThreshold',
         'acpTimeoutMs',
         'maxRetriesPerPhase',
+        'sampleCount',
     ]) {
         if (raw[k] !== undefined && raw[k] !== null) {
             s[k] = Number(raw[k]);
@@ -235,5 +236,11 @@ function normalizeConfig(raw, configPath) {
         }
         cfg.auto = pickAutoSection(raw.auto);
     }
+    if (raw.auto_pack_req !== undefined) {
+        if (!isPlainObject(raw.auto_pack_req)) {
+            throw new Error(`配置 auto_pack_req 必须是对象：${configPath}`);
+        }
+        cfg.auto_pack_req = pickAutoSection(raw.auto_pack_req);
+    }
     return cfg;
 }

package/dist/constants/convert.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONVERT_TIMEOUT_SEC = void 0;
+/** Default per-file convert HTTP timeout: 15 minutes. */
+exports.DEFAULT_CONVERT_TIMEOUT_SEC = 900;

package/dist/core/markitdown-client.js

@@ -57,7 +57,7 @@ function parseEndpointList(raw) {
     }
     return out;
 }
-async function ping(endpoint, timeoutMs = 10_000) {
+async function ping(endpoint, timeoutMs = 30_000) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), timeoutMs);
     try {
@@ -80,7 +80,7 @@ async function ping(endpoint, timeoutMs = 10_000) {
     }
 }
 /** Probe endpoints in order; return those that respond to /healthz. */
-async function filterHealthyEndpoints(endpoints, timeoutMs = 10_000) {
+async function filterHealthyEndpoints(endpoints, timeoutMs = 30_000) {
     const healthy = [];
     for (const endpoint of endpoints) {
         try {
@@ -186,6 +186,11 @@ function extractTraceId(body) {
 }
 function describeHttpError(status, body, endpoint) {
     const prefix = endpoint ? `[${endpoint}] ` : '';
+    if (status === 504) {
+        return (`${prefix}gateway timeout (HTTP 504): reverse proxy gave up waiting for markitdown_serve ` +
+            `(worker may still be running VLM/OCR). Increase nginx proxy_read_timeout to match ` +
+            `--timeout-sec, or reduce MARKITDOWN_OCR_MAX_RENDER_PX / use a shorter PDF export.`);
+    }
     if (body && typeof body === 'object') {
         const b = body;
         if (status === 415 && b.error === 'unsupported_format') {

package/dist/index.js

@@ -5,13 +5,15 @@ const logger_1 = require("./utils/logger");
 const version_1 = require("./utils/version");
 const validate_args_1 = require("./utils/validate-args");
 const harness_name_1 = require("./utils/harness-name");
+const convert_1 = require("./constants/convert");
 const init_1 = require("./commands/init");
 const apply_1 = require("./commands/apply");
-const convert_1 = require("./commands/convert");
+const convert_2 = require("./commands/convert");
 const wizard_1 = require("./commands/wizard");
 const doctor_1 = require("./commands/doctor");
 const wiki_1 = require("./commands/wiki");
 const auto_1 = require("./commands/auto");
+const auto_pack_req_1 = require("./commands/auto-pack-req");
 const requirements_1 = require("./commands/requirements");
 const start_agent_1 = require("./commands/start-agent");
 const shell_integration_1 = require("./commands/shell-integration");
@@ -163,7 +165,7 @@ function attachBuildOptions(cmd) {
         .option('--convert-endpoint <url>', '【build 自动 convert】markitdown_serve 基址（默认 http://markitdown.desaysz.site）')
         .option('--convert-concurrency <n>', '【build 自动 convert】并发上传数（默认沿用 convert）', (v) => Number(v))
         .option('--convert-max-file-mb <n>', '【build 自动 convert】单文件大小上限 MB（默认沿用 convert）', (v) => Number(v))
-        .option('--convert-timeout-sec <n>', '【build 自动 convert】超时秒数（默认沿用 convert）', (v) => Number(v))
+        .option('--convert-timeout-sec <n>', `【build 自动 convert】超时秒数（默认 ${convert_1.DEFAULT_CONVERT_TIMEOUT_SEC}，15 分钟）`, (v) => Number(v))
         .option('--convert-force', '【build 自动 convert】覆盖已存在同名 .md')
         .option('--force', '强制覆盖已存在的目标目录')
         .option('-y, --yes', '跳过交互确认，使用默认值')
@@ -218,6 +220,10 @@ function main() {
         '│  # 方式六：对当前工程生成 wiki 骨架                                       ',
         '│  svharness wiki                                                          ',
         '│                                                                          ',
+        '│  # 方式七：在 requirements 资料目录直接条目化（或指定资料包根）          ',
+        '│  cd ./requirements && svharness auto_pack_req --yes                      ',
+        '│  svharness auto_pack_req ./req-pack --yes                                ',
+        '│                                                                          ',
         '└──────────────────────────────────────────────────────────────────────────',
         '  📚 使用说明文档：https://yesv-desaysv.feishu.cn/docx/OEBwdywTfoncPNxPZ0acClNincg',
         '',
@@ -248,7 +254,7 @@ function main() {
         .option('--extra-skills <path...>', '额外运行期资源路径（覆盖自动检测）')
         .option('--force', '目标 harness 已存在时覆盖')
         .option('--target-score <score>', '目标综合评分（默认 9.5）', (v) => Number(v))
-        .option('--max-optimize-rounds <n>', '最大优化轮数（默认 5）', (v) => Number(v))
+        .option('--max-optimize-rounds <n>', '最大优化轮数（默认 10）', (v) => Number(v))
         .option('--checkpoint <phase>', '到达阶段前暂停')
         .option('--max-phase <phase>', '只运行到此阶段即停止')
         .option('--dry-run', '打印 prompt 和动作，不调用 Claude')
@@ -277,6 +283,72 @@ function main() {
             process.exitCode = 1;
         }
     });
+    program
+        .command('auto_pack_req [workdir]')
+        .description('需求包全自动条目化（S40 专项）：S30+S40 → 机械门禁+对抗验证+抽样验证，综合分须严格大于目标分')
+        .addHelpText('after', [
+        '',
+        '说明：',
+        '  独立于 svharness auto，仅跑 S30_convert_docs + S40_extract_requirements，不执行 S50~S90。',
+        '  综合分 = 机械门禁×0.40 + 对抗验证×0.30 + 抽样验证×0.30',
+        '  通过条件：综合分 > targetScore（默认 9.5）且 verify/doctor 硬门禁全通过。',
+        '',
+        '工作目录（无参数时默认当前目录）：',
+        '  · 当前目录是 requirements 资料夹（含 doc/md/pdf 等）→ 视为输入，在上级目录创建 harness',
+        '  · 当前目录是资料包根（含 requirements/ 子目录）→ 在目录内创建 harness',
+        '  · 当前目录是已有 harness 根 → 重置 S40 后重做条目化',
+        '',
+        '两种入口：',
+        '  · 资料包新建 — 无 harness.yaml，自动 build 后条目化',
+        '  · 已有 harness 重做 — 检测到 harness.yaml 后重置 S40=PENDING，仅重跑 S40',
+        '',
+        '内置默认：targetScore=9.5, maxOptimizeRounds=10, sampleCount=7, autoApprove=yes',
+        '配置示例：auto/templates/auto-pack-req.config.example.yaml（auto_pack_req: 节）',
+        '详细设计：auto/auto-harness-detail-design.md §2.2.1',
+        '',
+        '示例：',
+        '  cd ./requirements && svharness auto_pack_req --yes',
+        '  svharness auto_pack_req ./req-pack --yes',
+        '  svharness auto_pack_req ./my-harness --requirements ./docs --yes',
+        '  svharness auto_pack_req --dry-run',
+        '',
+    ].join('\n'))
+        .option('--work-dir <path>', '工作目录（资料包根或已有 harness 根）')
+        .option('--config <path>', '配置文件路径（支持 auto_pack_req: 节）')
+        .option('--harness-name <name>', 'harness 名称（资料包模式可自动推断）')
+        .option('--goal <text>', '构建目的描述')
+        .option('--arch <arch>', '架构模板：' + (0, validate_args_1.listSupportedArches)().join(' | '))
+        .option('--agent <agent>', '目标 Agent（默认 claude-code）')
+        .option('--requirements <path>', '需求文档路径（覆盖自动检测）')
+        .option('--force', '目标 harness 已存在时覆盖')
+        .option('--target-score <score>', '目标综合评分（默认 9.5，须严格大于此值）', (v) => Number(v))
+        .option('--max-optimize-rounds <n>', '最大优化轮数（默认 10）', (v) => Number(v))
+        .option('--sample-count <n>', '抽样验证片段数（默认 7）', (v) => Number(v))
+        .option('--dry-run', '打印 prompt 和动作，不调用 Agent')
+        .option('--auto-approve', '自动通过无人值守下的表单门禁')
+        .option('-y, --yes', '跳过交互确认')
+        .option('--verbose', '显示详细日志')
+        .option('--max-total-calls <n>', 'ACP 调用次数上限（默认 100）', (v) => Number(v))
+        .option('--budget-usd <amount>', '费用预算上限（USD）', (v) => Number(v))
+        .option('--cost-alert <amount>', '单次调用费用告警阈值（USD）', (v) => Number(v))
+        .option('--acp-mode <mode>', 'ACP 模式：auto | cli-print | sdk')
+        .option('--acp-timeout-ms <n>', '单次 ACP 调用超时毫秒', (v) => Number(v))
+        .option('--max-retries-per-phase <n>', '每阶段最大重试次数', (v) => Number(v))
+        .option('--prompt-dir <path>', '覆盖 auto phase prompt 模板目录')
+        .option('--convert-endpoint <url>', 'markitdown_serve 基址')
+        .option('--no-auto-repair', '禁用阶段失败自动修复（默认启用）')
+        .action(async (workdir, opts, cmd) => {
+        try {
+            await (0, auto_pack_req_1.runAutoPackReq)(workdir, {
+                ...opts,
+                costAlertThreshold: opts.costAlert,
+            }, cmd);
+        }
+        catch (err) {
+            logger_1.logger.error(err.message);
+            process.exitCode = 1;
+        }
+    });
     program
         .command('wizard')
         .description('交互式向导：分步填写路径与说明，可保存到 svharness.config.yaml 并/或立即执行 build/apply/convert。')
@@ -299,7 +371,7 @@ function main() {
         .option('--endpoint <url>', 'markitdown_serve 基址（逗号分隔可配置 failover）')
         .option('--concurrency <n>', '【默认 3】并发上传数', (v) => Number(v))
         .option('--max-file-mb <n>', '【默认 50】单文件大小上限（MB）', (v) => Number(v))
-        .option('--timeout-sec <n>', '【默认 120】超时秒数', (v) => Number(v))
+        .option('--timeout-sec <n>', `【默认 ${convert_1.DEFAULT_CONVERT_TIMEOUT_SEC}，15 分钟】单文件转换超时秒数`, (v) => Number(v))
         .option('--type <type>', 'requirements | references')
         .option('--force', '覆盖已存在同名 .md')
         .option('--split-sheets-suffix <suffix>', 'xlsx/xls 按 sheet（##）拆分时的子目录后缀', '_split')
@@ -326,7 +398,7 @@ function main() {
                 yes: opts.yes,
                 verbose: opts.verbose,
             }, loaded?.config.convert, loaded?.config.defaults, cmd);
-            await (0, convert_1.runConvert)({
+            await (0, convert_2.runConvert)({
                 input: merged.input ?? [],
                 harness: merged.harness,
                 output: merged.output,

package/dist/lib/acp-agent-cli-resolver.js

@@ -0,0 +1,193 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPreferredLocalClaudePath = getPreferredLocalClaudePath;
+exports.resolveAcpAgentCli = resolveAcpAgentCli;
+exports.ensureAcpAgentCliAvailable = ensureAcpAgentCliAvailable;
+exports.formatAcpAgentCliLog = formatAcpAgentCliLog;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const os_1 = __importDefault(require("os"));
+const node_child_process_1 = require("node:child_process");
+const codechat_runner_resolver_1 = require("./codechat-runner-resolver");
+/** Preferred Claude install: ~/.local/bin/claude(.exe) */
+function getPreferredLocalClaudePath(homedir = os_1.default.homedir(), platform = process.platform) {
+    const binName = platform === 'win32' ? 'claude.exe' : 'claude';
+    return node_path_1.default.join(homedir, '.local', 'bin', binName);
+}
+function normalizeComparable(p) {
+    return node_path_1.default.resolve(p).replace(/\\/g, '/').toLowerCase();
+}
+function canAccessExecutable(filePath) {
+    try {
+        fs_extra_1.default.accessSync(filePath, fs_extra_1.default.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function findExecutableInPath(name, platform = process.platform) {
+    try {
+        if (platform === 'win32') {
+            const out = (0, node_child_process_1.execSync)(`where.exe ${name}`, {
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'ignore'],
+                windowsHide: true,
+            });
+            for (const line of out.split(/\r?\n/)) {
+                const trimmed = line.trim();
+                if (trimmed && canAccessExecutable(trimmed)) {
+                    return node_path_1.default.resolve(trimmed);
+                }
+            }
+            return null;
+        }
+        const out = (0, node_child_process_1.execSync)(`command -v ${name}`, {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        }).trim();
+        if (out && canAccessExecutable(out)) {
+            return node_path_1.default.resolve(out);
+        }
+    }
+    catch {
+        // not in PATH
+    }
+    return null;
+}
+function getOtherClaudeCandidates(homedir, platform, excludePath) {
+    const exclude = excludePath ? normalizeComparable(excludePath) : undefined;
+    const found = [];
+    const seen = new Set();
+    const push = (candidate) => {
+        if (!candidate || !canAccessExecutable(candidate))
+            return;
+        const key = normalizeComparable(candidate);
+        if (exclude && key === exclude)
+            return;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        found.push(node_path_1.default.resolve(candidate));
+    };
+    push(findExecutableInPath('claude', platform));
+    if (platform === 'win32') {
+        const appData = process.env.APPDATA ?? node_path_1.default.join(homedir, 'AppData', 'Roaming');
+        push(node_path_1.default.join(appData, 'npm', 'claude.cmd'));
+        push(node_path_1.default.join(appData, 'npm', 'claude'));
+        push(node_path_1.default.join(homedir, '.claude', 'local', 'claude.exe'));
+    }
+    return found;
+}
+const ALTERNATIVE_CLI_NAMES = [
+    'codechat',
+    'qodercli',
+    'traecli',
+    'opencode',
+    'codex',
+];
+function tryResolveCodechatRunner() {
+    try {
+        const { runner, source, label } = (0, codechat_runner_resolver_1.resolveCodechatRunner)();
+        return {
+            command: runner,
+            kind: 'codechat-runner',
+            source: `codechat-${source}`,
+            label,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function tryAlternativeClis(platform) {
+    for (const name of ALTERNATIVE_CLI_NAMES) {
+        const resolved = findExecutableInPath(name, platform);
+        if (resolved) {
+            return {
+                command: resolved,
+                kind: 'alternative-cli',
+                source: 'path',
+                label: name,
+            };
+        }
+    }
+    return tryResolveCodechatRunner();
+}
+/**
+ * Resolve the CLI used by ACP (`--print` mode).
+ *
+ * Priority:
+ * 1. ~/.local/bin/claude(.exe)
+ * 2. Other claude installs (PATH, npm global, etc.)
+ * 3. Alternative CLIs (codechat, qodercli, traecli, …) or CodeChat runner
+ */
+function resolveAcpAgentCli(options = {}) {
+    if (options.testCandidates?.length) {
+        return options.testCandidates[0];
+    }
+    const platform = options.platform ?? process.platform;
+    const homedir = options.homedir ?? os_1.default.homedir();
+    const localClaude = getPreferredLocalClaudePath(homedir, platform);
+    if (canAccessExecutable(localClaude)) {
+        return {
+            command: node_path_1.default.resolve(localClaude),
+            kind: 'claude-local-bin',
+            source: 'local-bin',
+            label: localClaude,
+        };
+    }
+    if (!options.skipProbe) {
+        const otherClaude = getOtherClaudeCandidates(homedir, platform, localClaude);
+        if (otherClaude.length > 0) {
+            return {
+                command: otherClaude[0],
+                kind: 'claude-path',
+                source: 'path',
+                label: otherClaude[0],
+            };
+        }
+        const alt = tryAlternativeClis(platform);
+        if (alt)
+            return alt;
+    }
+    return null;
+}
+function buildAgentCliNotFoundError(homedir, platform) {
+    const localClaude = getPreferredLocalClaudePath(homedir, platform);
+    const altList = ALTERNATIVE_CLI_NAMES.join('、');
+    const lines = [
+        '未找到可用于 ACP 调用的 Agent CLI（codechat / claude）。已按优先级检查：',
+        `  1. 本地 Claude → ${localClaude}`,
+        '  2. 其他 Claude 安装（PATH / npm global）',
+        `  3. 其他 CLI（${altList}）或 CodeChat runner`,
+        '',
+        '请先安装并配置其中之一，例如：',
+        `  - 将 claude.exe 放到 ${node_path_1.default.join(homedir, '.local', 'bin')}`,
+        '  - 或安装 CodeChat CLI / IDE 插件（~/.codechat/cli_app/）',
+        `  - 或确保 ${altList} 之一在 PATH 中`,
+        '',
+        '配置完成后再执行：svharness auto',
+    ];
+    return lines.join('\n');
+}
+/**
+ * Ensure an Agent CLI is available before auto mode starts.
+ * Throws with a user-facing message when nothing is found.
+ */
+function ensureAcpAgentCliAvailable(options = {}) {
+    const resolved = resolveAcpAgentCli(options);
+    if (!resolved) {
+        const homedir = options.homedir ?? os_1.default.homedir();
+        const platform = options.platform ?? process.platform;
+        throw new Error(buildAgentCliNotFoundError(homedir, platform));
+    }
+    return resolved;
+}
+function formatAcpAgentCliLog(resolved) {
+    const detail = resolved.label ?? resolved.command;
+    return `${resolved.command} (${resolved.source}${detail ? `: ${detail}` : ''})`;
+}

package/dist/lib/acp-client.js

@@ -29,8 +29,10 @@ function parseCompletionSignal(output) {
  */
 class AcpClient {
     mode;
-    constructor(mode = 'auto') {
+    agentCommand;
+    constructor(mode = 'auto', agentCommand = 'claude') {
         this.mode = mode;
+        this.agentCommand = agentCommand;
     }
     async call(opts) {
         if (this.mode === 'sdk') {
@@ -45,7 +47,7 @@ class AcpClient {
         const timeoutMs = opts.timeoutMs ?? 1_800_000;
         const isWin = process.platform === 'win32';
         return new Promise((resolve) => {
-            const child = (0, node_child_process_1.spawn)('claude', args, {
+            const child = (0, node_child_process_1.spawn)(this.agentCommand, args, {
                 cwd: opts.workDir,
                 shell: isWin,
             });

package/dist/lib/agent-launcher.js

@@ -230,10 +230,15 @@ async function ensureUserEnv(workdir, config, syncEnv) {
 }
 function buildRunnerArgs(config, workdir, skipPermissions) {
     const envFile = resolveUserEnvPath(config);
-    const args = [
-        formatRunnerArg('--env-file', envFile),
-        formatRunnerArg('--cwd', workdir),
-    ];
+    const resolvedWorkdir = path_1.default.resolve(workdir);
+    const args = [formatRunnerArg('--env-file', envFile)];
+    // run.bat → bootstrap.ps1: -cwd <path> must be two args; --cwd=path is dropped via cmd %*.
+    if (process.platform === 'win32') {
+        args.push('-cwd', resolvedWorkdir);
+    }
+    else {
+        args.push(formatRunnerArg('--cwd', resolvedWorkdir));
+    }
     if (skipPermissions) {
         args.push('--dangerously-skip-permissions');
     }