svharness 0.14.13 → 0.14.16

package/dist/commands/shell-integration.js

@@ -3,6 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveShellMenuIconSourcePath = resolveShellMenuIconSourcePath;
+exports.installShellMenuIcon = installShellMenuIcon;
 exports.resolveLaunchScriptPath = resolveLaunchScriptPath;
 exports.resolveWindowsTerminalPath = resolveWindowsTerminalPath;
 exports.runShellInstall = runShellInstall;
@@ -19,6 +21,8 @@ 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');
 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 ICON_FILENAME = 'codechat-agent.ico';
+const ICON_STUB_PATH = path_1.default.join(STUB_DIR, ICON_FILENAME);
 function logInfo(msg, silent) {
     if (!silent)
         logger_1.logger.info(msg);
@@ -36,6 +40,28 @@ function assertWin32() {
             'Linux/macOS 请使用：launch_codechat_cli 或 svharness start-agent --work-dir <path>');
     }
 }
+/**
+ * Resolve bundled context-menu icon from the installed package.
+ */
+function resolveShellMenuIconSourcePath() {
+    const fromDist = path_1.default.resolve(__dirname, '..', '..', 'assets', ICON_FILENAME);
+    if (fs_extra_1.default.existsSync(fromDist)) {
+        return fromDist;
+    }
+    const fromCwd = path_1.default.resolve(__dirname, '..', '..', '..', 'assets', ICON_FILENAME);
+    if (fs_extra_1.default.existsSync(fromCwd)) {
+        return fromCwd;
+    }
+    throw new Error(`未找到 ${ICON_FILENAME}（预期：${fromDist}）`);
+}
+/**
+ * Copy icon to LOCALAPPDATA stub dir; return registry Icon value (`path,0`).
+ */
+async function installShellMenuIcon() {
+    const source = resolveShellMenuIconSourcePath();
+    await fs_extra_1.default.copy(source, ICON_STUB_PATH, { overwrite: true });
+    return `${ICON_STUB_PATH},0`;
+}
 /**
  * Resolve absolute path to bin/launch-codechat-cli.js in the installed package.
  */
@@ -121,8 +147,9 @@ function buildMenuCommand(ps1Path, dirPlaceholder, wtPath) {
     }
     return `powershell.exe ${psArgs}`;
 }
-function registerMenuKey(menuKey, command) {
+function registerMenuKey(menuKey, command, iconValue) {
     (0, win_registry_1.regSetDefault)(menuKey, win_registry_1.SHELL_MENU_LABEL);
+    (0, win_registry_1.regSetString)(menuKey, 'Icon', iconValue);
     (0, win_registry_1.regSetDefault)(`${menuKey}\\command`, command);
 }
 /**
@@ -136,14 +163,16 @@ async function runShellInstall(opts = {}) {
     if (await fs_extra_1.default.pathExists(LEGACY_STUB_PATH)) {
         await fs_extra_1.default.remove(LEGACY_STUB_PATH);
     }
+    const iconValue = await installShellMenuIcon();
     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);
+    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(`  icon: ${ICON_STUB_PATH}`, opts.silent);
     logInfo(`  脚本: ${launchScriptPath}`, opts.silent);
     if (wtPath) {
         logInfo(`  wt:   ${wtPath}`, opts.silent);
@@ -159,6 +188,9 @@ async function runShellUninstall(opts = {}) {
     if (await fs_extra_1.default.pathExists(STUB_PATH)) {
         await fs_extra_1.default.remove(STUB_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);
     }

package/dist/lib/win-registry.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SHELL_MENU_LABEL = exports.SHELL_MENU_KEY_DIR = exports.SHELL_MENU_KEY_BG = void 0;
 exports.regSetDefault = regSetDefault;
+exports.regSetString = regSetString;
 exports.regDeleteKey = regDeleteKey;
 exports.regKeyExists = regKeyExists;
 const child_process_1 = require("child_process");
@@ -18,6 +19,15 @@ function regSetDefault(key, value) {
         windowsHide: true,
     });
 }
+/**
+ * Set a named REG_SZ value on a registry key.
+ */
+function regSetString(key, name, value) {
+    (0, child_process_1.execSync)(`"${REG}" add "${key}" /v "${name}" /t REG_SZ /d "${quoteRegData(value)}" /f`, {
+        stdio: 'pipe',
+        windowsHide: true,
+    });
+}
 /**
  * Delete a registry key and subkeys.
  */

package/docs/agent-launcher-design.md

@@ -200,6 +200,14 @@ stub 接收 Explorer 传入的目录参数，`cd` 后调用 **绝对路径** 的
 
 菜单标题：`在此启动 CodeChat CLI`
 
+Icon（两处菜单键均设置）：
+
+```text
+C:\Users\<user>\AppData\Local\svharness\bin\codechat-agent.ico,0
+```
+
+源文件：`assets/codechat-agent.ico`（圆角边框 + `>_` 终端提示符；可用 `scripts/generate-shell-icon.ps1` 重新生成）。
+
 Command（Background，已安装 WT 时）：
 
 ```text

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svharness",
-  "version": "0.14.13",
+  "version": "0.14.16",
   "description": "CLI scaffolder for SDD-Driven Agent-Agnostic Coding Framework (harness)",
   "bin": {
     "svharness": "./bin/cli.js",
@@ -11,6 +11,7 @@
     "dist/",
     "bin/",
     "docs/",
+    "assets/",
     "scripts/postinstall.js",
     "scripts/preuninstall.js",
     "templates/",