saycoder 0.1.1 → 0.1.3

package/README.md

@@ -5,8 +5,8 @@ A small CLI that configures OpenCode to use SayCoder as the model layer, plus pr
 ## Setup flow
 
 1. Checks whether `opencode` is installed.
-2. If missing, asks whether to install it with `npm install -g opencode-ai --foreground-scripts`.
-3. Optionally enables China mirror optimization, measures available mirrors, and lets the user choose with arrow keys.
+2. If missing, asks whether to install it with `npm install -g opencode-ai --foreground-scripts --verbose --loglevel verbose`.
+3. Optionally enables China mirror optimization, measures available mirrors, and lets the user choose with arrow keys or number input on Windows.
 4. Installs OpenCode and verifies `opencode --version` before continuing.
 5. Prompts the user for a SayCoder API key.
 6. Validates the key with `GET https://jstapi.xinbai.icu/v1/models`.
@@ -25,13 +25,25 @@ SayCoder's base URL is only used for the OpenAI-compatible model channel, not fo
 
 ## China mirror
 
-When OpenCode is missing, setup asks whether to install through China mirror optimization. If enabled, it measures common npm mirrors and lets you choose one with arrow keys. If OpenCode installation or verification fails, setup stops and prints the manual install command.
+When OpenCode is missing, setup asks whether to install through China mirror optimization. If enabled, it measures common npm mirrors and lets you choose one with arrow keys, or number input on Windows/non-TTY terminals. Mirror probes use the package metadata endpoint and fall back from `HEAD` to `GET` for registries that reject `HEAD`.
+
+If OpenCode installation or verification fails, setup stops before writing OpenCode config and prints the npm exit code, any npm spawn error, a detected npm debug log path when npm reports one, and the manual install command.
 You can also force it with:
 
 ```bash
 node bin/saycoder.js setup --npm-registry https://registry.npmmirror.com
 ```
 
+## Windows PowerShell troubleshooting
+
+If automatic `opencode-ai` installation fails on Windows, rerun the printed command in a fresh PowerShell window as the same user. For example:
+
+```powershell
+npm install -g opencode-ai --foreground-scripts --verbose --loglevel verbose --registry https://registry.npmmirror.com
+```
+
+Then check the npm debug log shown by `saycoder` or the newest log under your npm cache `_logs` directory. After a successful manual install, close and reopen PowerShell so the global npm bin path is refreshed, verify with `opencode --version`, then run `npx saycoder` again.
+
 ## Installed skills
 
 - `saycoder-lite-superpowers`: clarify user intent, split logical goals, implement production code, and report completed/not completed work.
@@ -44,6 +56,8 @@ node bin/saycoder.js setup --npm-registry https://registry.npmmirror.com
 node bin/saycoder.js setup --dry-run --skip-install-check --skip-validate --api-key test-key
 ```
 
+Dry-run output redacts API keys and other token-like fields.
+
 ## Intended usage
 
 ```bash

package/bin/saycoder.js

@@ -103,6 +103,15 @@ function sortObject(value) {
   return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, nested]) => [key, sortObject(nested)]));
 }
 
+function redactSecrets(value) {
+  if (Array.isArray(value)) return value.map(redactSecrets);
+  if (!value || typeof value !== "object") return value;
+  return Object.fromEntries(Object.entries(value).map(([key, nested]) => {
+    if (/api[-_]?key|authorization|token|secret/i.test(key)) return [key, "<redacted>"];
+    return [key, redactSecrets(nested)];
+  }));
+}
+
 function unique(values) {
   return [...new Set(values.filter(Boolean))];
 }
@@ -115,18 +124,42 @@ function commandExists(command) {
   return result.status === 0;
 }
 
+function shellQuote(value) {
+  if (/^[A-Za-z0-9_/:=@.%+-]+$/.test(value)) return value;
+  return JSON.stringify(value);
+}
+
+function findNpmDebugLogs(outputText) {
+  const matches = outputText.match(/(?:[A-Z]:)?[^\r\n]*npm[^\r\n]*(?:debug|eresolve-report)[^\r\n]*\.log/gi) || [];
+  return unique(matches.map((item) => item.trim().replace(/^['"]|['"]$/g, "")));
+}
+
 function installOpenCode(registry) {
-  const args = ["install", "-g", "opencode-ai", "--foreground-scripts"];
+  const args = ["install", "-g", "opencode-ai", "--foreground-scripts", "--verbose", "--loglevel", "verbose"];
   if (registry) args.push("--registry", registry);
   step(`Installing OpenCode with npm${registry ? ` using ${registry}` : ""}...`);
-  const result = spawnSync("npm", args, { stdio: "inherit" });
-  return result.status === 0;
+  const result = spawnSync("npm", args, {
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "pipe"],
+    shell: process.platform === "win32",
+  });
+
+  if (result.stdout) output.write(result.stdout);
+  if (result.stderr) process.stderr.write(result.stderr);
+
+  return {
+    ok: result.status === 0,
+    status: result.status,
+    signal: result.signal,
+    error: result.error,
+    output: `${result.stdout || ""}\n${result.stderr || ""}`,
+  };
 }
 
 function npmInstallOpenCodeCommand(registry) {
-  const command = ["npm", "install", "-g", "opencode-ai", "--foreground-scripts"];
+  const command = ["npm", "install", "-g", "opencode-ai", "--foreground-scripts", "--verbose", "--loglevel", "verbose"];
   if (registry) command.push("--registry", registry);
-  return command.join(" ");
+  return command.map(shellQuote).join(" ");
 }
 
 function pathRefreshHint() {
@@ -169,10 +202,11 @@ async function measureMirror(mirror) {
   const timeout = setTimeout(() => controller.abort(), 5000);
 
   try {
-    const response = await fetch(`${mirror.url.replace(/\/+$/, "")}/opencode-ai`, {
-      method: "HEAD",
-      signal: controller.signal,
-    });
+    const url = `${mirror.url.replace(/\/+$/, "")}/opencode-ai`;
+    let response = await fetch(url, { method: "HEAD", signal: controller.signal });
+    if (response.status === 405 || response.status === 403) {
+      response = await fetch(url, { method: "GET", signal: controller.signal });
+    }
     if (!response.ok) throw new Error(`HTTP ${response.status}`);
     return { ...mirror, latency: Date.now() - started, ok: true };
   } catch {
@@ -200,13 +234,32 @@ function renderMirrorChoices(mirrors, selected) {
   });
 }
 
+async function selectMirrorByNumber(mirrors) {
+  console.log(color.blue("选择 npm 镜像源"));
+  console.log(color.dim("输入序号并回车。\n"));
+
+  mirrors.forEach((mirror, index) => {
+    const latency = mirror.ok ? color.green(formatLatency(mirror.latency)) : color.red("不可用");
+    console.log(`${index + 1}. ${mirror.name} ${latency} ${color.dim(mirror.url)}`);
+  });
+
+  while (true) {
+    const answer = await prompt("请选择镜像序号: ");
+    const selected = Number.parseInt(answer, 10) - 1;
+    if (mirrors[selected]?.ok) return mirrors[selected];
+    warn("请输入可用镜像的序号。");
+  }
+}
+
 async function selectMirror(mirrors) {
   const available = mirrors.filter((mirror) => mirror.ok);
   if (available.length === 0) throw new Error("No npm mirror is reachable. Please retry later or use the default npm registry.");
   if (!input.isTTY || !output.isTTY) return available[0];
+  if (process.platform === "win32" || typeof input.setRawMode !== "function") return await selectMirrorByNumber(available);
 
   let selected = 0;
   emitKeypressEvents(input);
+  input.resume();
   input.setRawMode(true);
   renderMirrorChoices(available, selected);
 
@@ -216,12 +269,14 @@ async function selectMirror(mirrors) {
       else if (key.name === "down") selected = (selected + 1) % available.length;
       else if (key.name === "return") {
         input.setRawMode(false);
+        input.pause();
         input.off("keypress", onKeypress);
         console.log(`\nSelected: ${available[selected].name} (${available[selected].url})`);
         resolve(available[selected]);
         return;
       } else if (key.ctrl && key.name === "c") {
         input.setRawMode(false);
+        input.pause();
         process.exit(130);
       }
       renderMirrorChoices(available, selected);
@@ -468,8 +523,8 @@ async function setup(flags) {
 
     flags["npm-registry"] = await chooseNpmRegistry(flags);
 
-    const installed = installOpenCode(flags["npm-registry"]);
-    if (installed) {
+    const installResult = installOpenCode(flags["npm-registry"]);
+    if (installResult.ok) {
       success("OpenCode installed.");
       const version = verifyOpenCode();
       if (version) success(`OpenCode verified: ${version}`);
@@ -479,8 +534,14 @@ async function setup(flags) {
       }
     } else {
       warn("OpenCode installation failed. SayCoder setup cannot continue until OpenCode is installed.");
+      warn(`npm exit code: ${installResult.status ?? "unknown"}${installResult.signal ? `, signal: ${installResult.signal}` : ""}`);
+      if (installResult.error) warn(`npm spawn error: ${installResult.error.message}`);
+      const debugLogs = findNpmDebugLogs(installResult.output);
+      if (debugLogs.length > 0) warn(`npm debug log: ${debugLogs[0]}`);
+      else warn("npm did not print a debug log path. Check the latest npm debug log under your npm cache/_logs directory.");
       warn(`Manual install command: ${npmInstallOpenCodeCommand(flags["npm-registry"])}`);
-      throw new Error("Please install OpenCode manually, reopen PowerShell if needed, then rerun `npx saycoder`.");
+      if (process.platform === "win32") warn("On Windows, run the manual command in a fresh PowerShell as the same user; if it succeeds, close and reopen PowerShell so PATH refreshes.");
+      throw new Error("OpenCode installation failed; config was not written. Fix npm/OpenCode install, then rerun `npx saycoder`.");
     }
   } else if (!flags["skip-install-check"]) {
     success("OpenCode is installed.");
@@ -516,7 +577,7 @@ async function setup(flags) {
   const skillPaths = installSkills(configDir, Boolean(flags["dry-run"]));
 
   if (flags["dry-run"]) {
-    console.log(JSON.stringify(merged, null, 2));
+    console.log(JSON.stringify(redactSecrets(merged), null, 2));
     console.log(`\nDry run only. Skills would be installed to:\n${skillPaths.map((item) => `- ${item}`).join("\n")}`);
     return;
   }
@@ -529,12 +590,13 @@ async function setup(flags) {
   console.log(color.green("\n模型选择中意模型，即可开始编程了！\n"));
 }
 
-const flags = parseArgs(process.argv.slice(2));
-
-try {
+async function main() {
+  const flags = parseArgs(process.argv.slice(2));
   if (flags.command === "setup") await setup(flags);
   else usage();
-} catch (error) {
+}
+
+main().catch((error) => {
   console.error(color.red(`saycoder: ${error.message}`));
   process.exitCode = 1;
-}
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saycoder",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "SayCoder setup helper for OpenCode models, MCP servers, and skills.",
   "type": "module",
   "bin": {