svharness 0.14.12 → 0.14.13

package/dist/commands/shell-integration.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveLaunchScriptPath = resolveLaunchScriptPath;
+exports.resolveWindowsTerminalPath = resolveWindowsTerminalPath;
 exports.runShellInstall = runShellInstall;
 exports.runShellUninstall = runShellUninstall;
 exports.getShellStatus = getShellStatus;
@@ -12,6 +13,7 @@ exports.runShellInstallSafe = runShellInstallSafe;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
+const child_process_1 = require("child_process");
 const logger_1 = require("../utils/logger");
 const win_registry_1 = require("../lib/win-registry");
 const STUB_DIR = path_1.default.join(process.env.LOCALAPPDATA ?? path_1.default.join(os_1.default.homedir(), 'AppData', 'Local'), 'svharness', 'bin');
@@ -50,13 +52,55 @@ function resolveLaunchScriptPath() {
     }
     throw new Error(`未找到 launch-codechat-cli.js（预期：${fromDist}）`);
 }
+function canAccessExecutable(filePath) {
+    try {
+        fs_extra_1.default.accessSync(filePath, fs_extra_1.default.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve wt.exe at shell install time (Explorer context menus use this path directly).
+ */
+function resolveWindowsTerminalPath() {
+    try {
+        const out = (0, child_process_1.execFileSync)('where', ['wt'], { encoding: 'utf8', windowsHide: true }).trim();
+        const first = out.split(/\r?\n/)[0]?.trim();
+        if (first && canAccessExecutable(first)) {
+            return first;
+        }
+    }
+    catch {
+        // wt not on PATH during install
+    }
+    const localAppData = process.env.LOCALAPPDATA ?? path_1.default.join(os_1.default.homedir(), 'AppData', 'Local');
+    const candidates = [
+        path_1.default.join(localAppData, 'Microsoft', 'WindowsApps', 'wt.exe'),
+        path_1.default.join(process.env.ProgramFiles ?? 'C:\\Program Files', 'Windows Terminal', 'wt.exe'),
+    ];
+    for (const candidate of candidates) {
+        if (candidate && canAccessExecutable(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
 function buildStubContent(launchScriptPath) {
     const escapedNodeScript = launchScriptPath.replace(/'/g, "''");
-    // ASCII-only + UTF-8 BOM: Windows PowerShell 5.1 misparses UTF-8 without BOM when comments contain non-ASCII.
+    // 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
@@ -66,8 +110,16 @@ function writeStubFile(launchScriptPath) {
     const content = buildStubContent(launchScriptPath);
     return fs_extra_1.default.writeFile(STUB_PATH, `\uFEFF${content}`, 'utf8');
 }
-function buildMenuCommand(ps1Path, dirPlaceholder) {
-    return `powershell.exe -NoExit -NoProfile -ExecutionPolicy Bypass -File "${ps1Path}" ${dirPlaceholder}`;
+function buildPsInvokeArgs(ps1Path, dirPlaceholder) {
+    return `-NoExit -NoProfile -ExecutionPolicy Bypass -File "${ps1Path}" ${dirPlaceholder}`;
+}
+function buildMenuCommand(ps1Path, dirPlaceholder, wtPath) {
+    const psArgs = buildPsInvokeArgs(ps1Path, dirPlaceholder);
+    if (wtPath) {
+        // Launch WT directly from registry — avoids an extra conhost window from stub bootstrap.
+        return `"${wtPath}" -d ${dirPlaceholder} --title CodeChat -- powershell.exe ${psArgs}`;
+    }
+    return `powershell.exe ${psArgs}`;
 }
 function registerMenuKey(menuKey, command) {
     (0, win_registry_1.regSetDefault)(menuKey, win_registry_1.SHELL_MENU_LABEL);
@@ -84,13 +136,18 @@ async function runShellInstall(opts = {}) {
     if (await fs_extra_1.default.pathExists(LEGACY_STUB_PATH)) {
         await fs_extra_1.default.remove(LEGACY_STUB_PATH);
     }
-    const bgCommand = buildMenuCommand(STUB_PATH, '"%V"');
-    const dirCommand = buildMenuCommand(STUB_PATH, '"%1"');
+    const wtPath = resolveWindowsTerminalPath();
+    const bgCommand = buildMenuCommand(STUB_PATH, '"%V"', wtPath);
+    const dirCommand = buildMenuCommand(STUB_PATH, '"%1"', wtPath);
     registerMenuKey(win_registry_1.SHELL_MENU_KEY_BG, bgCommand);
     registerMenuKey(win_registry_1.SHELL_MENU_KEY_DIR, dirCommand);
-    logSuccess('Windows 右键菜单已注册：「在此启动 CodeChat Agent」（PowerShell）', opts.silent);
+    const via = wtPath ? 'Windows Terminal' : 'PowerShell（UTF-8）';
+    logSuccess(`Windows 右键菜单已注册：「在此启动 CodeChat Agent」（${via}）`, opts.silent);
     logInfo(`  stub: ${STUB_PATH}`, opts.silent);
     logInfo(`  脚本: ${launchScriptPath}`, opts.silent);
+    if (wtPath) {
+        logInfo(`  wt:   ${wtPath}`, opts.silent);
+    }
 }
 /**
  * Remove HKCU context menus and stub file.
@@ -122,12 +179,14 @@ function getShellStatus() {
     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();
     return {
         installed: backgroundMenu && directoryMenu && stubExists,
         stubPath: STUB_PATH,
         backgroundMenu,
         directoryMenu,
         launchScriptPath,
+        viaWindowsTerminal: wtPath !== null,
     };
 }
 function printShellStatus() {
@@ -138,6 +197,7 @@ function printShellStatus() {
     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）' : '否'}`);
 }
 async function runShellInstallSafe(opts = {}) {
     try {

package/dist/lib/agent-launcher.js

@@ -18,6 +18,42 @@ const DEFAULT_ENV_TEMPLATE = 'default-claude.env';
 function homePath(...segments) {
     return path_1.default.join(os_1.default.homedir(), ...segments);
 }
+/** Absolute normalized path for runner CLI args. */
+function resolveUserEnvPath(config) {
+    return path_1.default.resolve(config.envFile);
+}
+function formatRunnerArg(name, value) {
+    const resolved = path_1.default.resolve(value);
+    if (process.platform === 'win32') {
+        // Quote paths for cmd.exe (matches manual: --env-file="C:\Users\...\.claude\.env")
+        return `${name}="${resolved.replace(/"/g, '""')}"`;
+    }
+    return `${name}=${resolved}`;
+}
+const ENV_FILE_VERIFY_RETRIES = 5;
+const ENV_FILE_VERIFY_DELAY_MS = 40;
+async function delay(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Wait until user env exists and is non-empty (Windows AV / flush visibility). */
+async function verifyUserEnvWritten(userEnvPath) {
+    for (let attempt = 1; attempt <= ENV_FILE_VERIFY_RETRIES; attempt++) {
+        try {
+            const stat = await fs_extra_1.default.stat(userEnvPath);
+            if (stat.isFile() && stat.size > 0) {
+                return;
+            }
+        }
+        catch {
+            // retry
+        }
+        if (attempt < ENV_FILE_VERIFY_RETRIES) {
+            await delay(ENV_FILE_VERIFY_DELAY_MS);
+        }
+    }
+    throw new Error(`env 写入后校验失败（文件不存在或为空）：${userEnvPath}\n` +
+        `请重试 svharness start-agent，或手动创建该文件。`);
+}
 function getCodechatRunnerConfig() {
     const platform = process.platform;
     if (platform === 'win32') {
@@ -91,8 +127,11 @@ function assertUserEnvWriteTarget(userEnvPath) {
 }
 async function copyEnvToUserOnly(fromPath, userEnvPath) {
     assertUserEnvWriteTarget(userEnvPath);
-    await fs_extra_1.default.ensureDir(path_1.default.dirname(userEnvPath));
-    await fs_extra_1.default.copy(fromPath, userEnvPath, { overwrite: true });
+    const dest = path_1.default.resolve(userEnvPath);
+    await fs_extra_1.default.ensureDir(path_1.default.dirname(dest));
+    const content = await fs_extra_1.default.readFile(fromPath, 'utf8');
+    await fs_extra_1.default.writeFile(dest, content, { encoding: 'utf8' });
+    await verifyUserEnvWritten(dest);
 }
 /**
  * Sync project env to user profile, or seed bundled default when none exists.
@@ -144,9 +183,10 @@ function warnIfNotHarnessProject(workdir) {
     }
 }
 function buildRunnerArgs(config, workdir, skipPermissions) {
+    const envFile = resolveUserEnvPath(config);
     const args = [
-        `--env-file=${config.envFile}`,
-        `--cwd=${workdir}`,
+        formatRunnerArg('--env-file', envFile),
+        formatRunnerArg('--cwd', workdir),
     ];
     if (skipPermissions) {
         args.push('--dangerously-skip-permissions');
@@ -170,13 +210,15 @@ async function runStartAgent(opts) {
     const syncEnv = opts.syncEnv !== false;
     const skipPermissions = opts.skipPermissions !== false;
     await ensureUserEnv(workdir, config, syncEnv);
+    const userEnvFile = resolveUserEnvPath(config);
     if (!(await fs_extra_1.default.pathExists(config.runner))) {
         throw new Error(`未找到 CodeChat CLI：${config.runner}\n请先安装 CodeChat CLI 到用户目录。`);
     }
-    if (!(await fs_extra_1.default.pathExists(config.envFile))) {
-        throw new Error(`未找到 env 文件：${config.envFile}\n` +
+    if (!(await fs_extra_1.default.pathExists(userEnvFile))) {
+        throw new Error(`未找到 env 文件：${userEnvFile}\n` +
             `请提供 ${path_1.default.join(workdir, config.envSyncFromRel)}，或确保内置模板 templates/default-claude.env 可访问。`);
     }
+    await verifyUserEnvWritten(userEnvFile);
     warnIfNotHarnessProject(workdir);
     const args = buildRunnerArgs(config, workdir, skipPermissions);
     logger_1.logger.info(`启动 CodeChat Agent（workdir: ${workdir}）`);

package/docs/agent-launcher-design.md

@@ -142,9 +142,11 @@ launch_codechat_cli ./my-app     # 指定 workdir
 | 2 | `~/.claude/.env` 已存在 | 保持不变 |
 | 3 | 以上均不满足 | 从 `templates/default-claude.env` **仅**生成 `~/.claude/.env` |
 
-内置模板为德赛 CodeChat 通用配置。首次使用前请配置有效 `ANTHROPIC_AUTH_TOKEN`（改用户级 env 或项目 `.claude/.env`）。
+内置模板为德赛 CodeChat 通用配置（含默认 `ANTHROPIC_AUTH_TOKEN`）。项目 `.claude/.env` 仍可覆盖同步到用户目录。
 
-启动时 CodeChat 使用 `--env-file=~/.claude/.env`。
+启动时 CodeChat 使用 `--env-file=~/.claude/.env`（Windows 下带引号的绝对路径，避免 cmd 解析偶发失败）。
+
+写入 `~/.claude/.env` 后会做 **存在 + 非空** 校验（最多 5 次、间隔 40ms），缓解 Windows 上杀毒/索引导致的短暂不可见。
 
 ---
 
@@ -173,7 +175,23 @@ macOS (`darwin`) 路径约定与 Linux 相同；若 runner 不存在则报错。
 
 stub 接收 Explorer 传入的目录参数，`cd` 后调用 **绝对路径** 的 `bin/launch-codechat-cli.js`。
 
-### 7.2 注册表结构
+### 7.3 终端与编码（右键 vs 手动 PowerShell）
+
+| 启动方式 | 典型终端 | 现象 |
+|----------|----------|------|
+| 手动打开 PowerShell 再 `start-agent` | **Windows Terminal** / 已配置 UTF-8 的会话 | CodeChat TUI 框线正常 |
+| 资源管理器右键（旧实现） | **conhost 经典蓝底** + `-NoProfile` | Unicode 框线乱码、`>>` 变 `\|\|` |
+
+原因：CodeChat CLI 使用 Unicode 制表符（`╔═╗`）。经典控制台默认代码页（如 GBK）无法正确渲染。
+
+**修复（注册表直接启动 WT）**：
+
+1. `shell install` 检测到 **Windows Terminal**（`wt.exe`）时，注册表 command **直接调用 wt**，不再先开 conhost 再二次跳转（避免两个窗口）
+2. 未安装 WT 时 fallback：`powershell.exe` + stub 内 `chcp 65001` UTF-8
+
+重新注册：`svharness shell install`
+
+### 7.4 注册表结构
 
 | 位置 | 键 |
 |------|-----|
@@ -182,13 +200,25 @@ stub 接收 Explorer 传入的目录参数，`cd` 后调用 **绝对路径** 的
 
 菜单标题：`在此启动 CodeChat CLI`
 
-Command（Background）：
+Command（Background，已安装 WT 时）：
+
+```text
+"C:\Users\<user>\AppData\Local\Microsoft\WindowsApps\wt.exe" -d "%V" --title CodeChat -- powershell.exe -NoExit -NoProfile -ExecutionPolicy Bypass -File "<stub.ps1>" "%V"
+```
+
+Command（Background，无 WT 时）：
 
 ```text
 powershell.exe -NoExit -NoProfile -ExecutionPolicy Bypass -File "<stub.ps1>" "%V"
 ```
 
-Command（Directory）：
+Command（Directory，已安装 WT 时）：
+
+```text
+"C:\Users\<user>\AppData\Local\Microsoft\WindowsApps\wt.exe" -d "%1" --title CodeChat -- powershell.exe -NoExit -NoProfile -ExecutionPolicy Bypass -File "<stub.ps1>" "%1"
+```
+
+Command（Directory，无 WT 时）：
 
 ```text
 powershell.exe -NoExit -NoProfile -ExecutionPolicy Bypass -File "<stub.ps1>" "%1"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svharness",
-  "version": "0.14.12",
+  "version": "0.14.13",
   "description": "CLI scaffolder for SDD-Driven Agent-Agnostic Coding Framework (harness)",
   "bin": {
     "svharness": "./bin/cli.js",

package/templates/default-claude.env

@@ -3,7 +3,7 @@
 # 仅写入用户目录；不会创建或修改项目 <workdir>/.claude/.env
 # 若项目已有 .claude/.env，start-agent 只读并同步到 ~/.claude/.env
 # ============================================================
-ANTHROPIC_AUTH_TOKEN=YOUR_ANTHROPIC_AUTH_TOKEN
+ANTHROPIC_AUTH_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6InVpZHEzNjQwIiwiZXhwIjoxNzgyMDM2MTkxfQ.GXsNuJ2Wi92VHepau51dTWGswHft6xovvOufVjtuBYk
 ANTHROPIC_BASE_URL=https://aiplus.desaysv.com/chatbot/anthropic
 # ANTHROPIC_BASE_URL=http://127.0.0.1:6008/chatbot/anthropic  # 德赛本地调试
 ANTHROPIC_MODEL=deepseek