@znmin/claude-remote-cli 0.3.0 → 0.3.1

package/README.md

@@ -25,10 +25,10 @@ npm install -g git+https://github.com/znmin/claude-remote-cli.git
 也可以从已下载的分发包安装：
 
 ```bash
-npm install -g ./znmin-claude-remote-cli-0.3.0.tgz
+npm install -g ./znmin-claude-remote-cli-0.3.1.tgz
 ```
 
-若系统 npm 全局目录不可写，可使用 `npm install -g --prefix "$HOME/.local" ./znmin-claude-remote-cli-0.3.0.tgz`，并确保 `~/.local/bin` 在 PATH 中；卸载时也使用相同的 `--prefix`。
+若系统 npm 全局目录不可写，可使用 `npm install -g --prefix "$HOME/.local" ./znmin-claude-remote-cli-0.3.1.tgz`，并确保 `~/.local/bin` 在 PATH 中；卸载时也使用相同的 `--prefix`。
 
 npm 中不带作用域的 `claude-remote-cli` 属于其他项目。本项目使用独立的 `@znmin/claude-remote-cli` 作用域包名；请安装完整包名，或使用上述 GitHub 地址及本项目分发的 `.tgz` 文件。
 
@@ -52,7 +52,7 @@ claude
 - 文件工具在 Windows 上按不区分大小写的方式判断路径是否位于项目内。CRLF 换行的文件读取和搜索时不显示 `\r`，`edit_file` 按 LF 文本匹配时会保留原有 CRLF 换行（适用于所有平台）。
 - 卸载、配置和缓存目录与其他平台相同，分别位于 `%USERPROFILE%\.config\claude-remote`、`%USERPROFILE%\.cache\claude-remote` 和 `%USERPROFILE%\.ssh\claude-remote`。
 
-如果用户已经安装其他提供 `claude` 命令的软件，应先卸载旧客户端，避免 npm 命令冲突或 PATH 指向旧程序。无需使用 `--force` 覆盖。
+如果用户已经安装其他提供 `claude` 命令的软件，应先卸载旧客户端，避免 npm 命令冲突或 PATH 指向旧程序。无需使用 `--force` 覆盖。Windows 上如果 `where.exe claude` 指向本工具，运行 `claude` 却报错（如 `claude.exe not found on PATH`），通常是 PowerShell 配置文件中残留了同名函数或别名；`claude-remote doctor` 会列出它及其所在文件。
 
 ## 开始使用
 
@@ -256,7 +256,7 @@ npm run test:windows   # Windows 上运行的客户端测试（CI 在 windows-la
 CLAUDE_REMOTE_INTEGRATION=1 CLAUDE_REMOTE_BROWSER_TEST=1 npm test
 
 npm pack
-npm install -g ./znmin-claude-remote-cli-0.3.0.tgz
+npm install -g ./znmin-claude-remote-cli-0.3.1.tgz
 
 # 确定包名、版本和使用条款后，使用有发布权限的 npm 账号发布
 npm login

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@znmin/claude-remote-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Run Claude Code on an SSH server from macOS, Linux or Windows with local filesystem, terminal and browser tools, or remote bidirectional sync",
   "type": "module",
   "license": "UNLICENSED",

package/src/cli.js

@@ -127,6 +127,8 @@ export async function main(asClaude, args = process.argv.slice(2), client = new
       const { describeShell, findShell } = await import('./local/shell.js');
       const shell = await findShell(client.env);
       console.log(`本地终端：${describeShell(shell)}（${shell.file}）${shell.kind === 'powershell' ? '；安装 Git for Windows 后改用 Git Bash' : ''}`);
+      const { conflictReport } = await import('./powershell-conflicts.js');
+      for (const line of await conflictReport(client.env)) console.log(line);
     }
     try {
       const { browserReady } = await import('./local/browser.js');

package/src/powershell-conflicts.js

@@ -0,0 +1,67 @@
+import path from 'node:path';
+import { execute, which } from './system.js';
+
+const MARKER = 'CLAUDE_REMOTE_JSON:';
+
+// Runs with the user's profile loaded, as an interactive window would. Only
+// aliases and functions are reported: they win over programs on PATH, so a
+// leftover `function claude` hides this tool while where.exe shows nothing wrong.
+const SCRIPT = [
+  "$ErrorActionPreference = 'SilentlyContinue'",
+  'try { [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 } catch {}',
+  '$items = @(Get-Command claude -All -CommandType Alias,Function,Filter | ForEach-Object {',
+  "  $alias = $_.CommandType -eq 'Alias'",
+  '  [pscustomobject]@{ type = [string]$_.CommandType; target = $(if ($alias) { [string]$_.Definition } else { $null });',
+  '    file = $(if ($alias) { $null } else { [string]$_.ScriptBlock.File }); module = [string]$_.ModuleName }',
+  '})',
+  `'${MARKER}' + (ConvertTo-Json -Compress -Depth 3 -InputObject ([pscustomobject]@{ profile = [string]$PROFILE; items = $items }))`
+].join('\n');
+
+const encoded = Buffer.from(SCRIPT, 'utf16le').toString('base64');
+
+export async function powershellHosts(env = process.env) {
+  const hosts = [{ name: 'Windows PowerShell',
+    file: path.win32.join(env.SystemRoot || env.SYSTEMROOT || 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe') }];
+  const pwsh = await which('pwsh', env.PATH || env.Path || '', { platform: 'win32' });
+  if (pwsh) hosts.push({ name: 'PowerShell 7', file: pwsh });
+  return hosts;
+}
+
+export function parseConflicts(stdout) {
+  const line = stdout.split(/\r?\n/).reverse().find(text => text.startsWith(MARKER));
+  if (!line) throw new Error('没有得到检查结果');
+  const result = JSON.parse(line.slice(MARKER.length));
+  const items = result.items == null ? [] : [].concat(result.items);
+  return { profile: result.profile || '', items };
+}
+
+export async function findClaudeConflicts(host, { env = process.env, run = execute, timeout = 20000 } = {}) {
+  const { stdout } = await run(host.file, ['-NoLogo', '-NonInteractive', '-EncodedCommand', encoded],
+    { capture: true, check: false, timeout, env });
+  return parseConflicts(stdout);
+}
+
+export function describeConflict(item) {
+  if (item.type === 'Alias') return `别名 → ${item.target}`;
+  const kind = item.type === 'Filter' ? '筛选器' : '函数';
+  if (item.file) return `${kind}（定义于 ${item.file}）`;
+  if (item.module) return `${kind}（来自模块 ${item.module}）`;
+  return kind;
+}
+
+// Lines for `claude-remote doctor`.
+export async function conflictReport(env = process.env, options = {}) {
+  const lines = [];
+  for (const host of await powershellHosts(env)) {
+    try {
+      const { profile, items } = await findClaudeConflicts(host, { env, ...options });
+      if (!items.length) { lines.push(`${host.name} 中的 claude：无冲突`); continue; }
+      lines.push(`${host.name} 中的 claude：被占用，在该终端输入 claude 不会运行本工具`);
+      for (const item of items) lines.push('  - ' + describeConflict(item));
+      lines.push(`  处理：删除上述定义（配置文件 ${profile}，可用 notepad $PROFILE 打开）后重新打开终端；临时可运行 claude.cmd`);
+    } catch (error) {
+      lines.push(`${host.name} 中的 claude：无法检查（${error.message}）`);
+    }
+  }
+  return lines;
+}