pwsh-guide 0.2.0 → 0.2.1

package/README.md

@@ -18,6 +18,8 @@ npx pwsh-guide init
 npx pwsh-guide refresh
 # 只输出探测 JSON，不写文件
 npx pwsh-guide init --dry-run
+# 查看版本
+npx pwsh-guide --version
 ```
 
 生成的 skill 位于 `.agents/skills/pwsh-guide/`：

package/bin/pwsh-guide.js

@@ -4,10 +4,14 @@
 import { parseArgs } from 'node:util';
 import fs from 'node:fs';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { probeEnvironment } from '../src/probe.js';
 import { resolveSkillDir } from '../src/detect.js';
 import { renderSkill, renderEnvironment, renderCommands } from '../src/render.js';
 
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(fs.readFileSync(path.resolve(__dirname, '..', 'package.json'), 'utf8'));
+
 const USAGE = `pwsh-guide - 生成项目级 Shell 操作指南 Agent Skill（跨平台：Windows PowerShell / macOS / Linux）
 
 用法:
@@ -17,6 +21,7 @@ const USAGE = `pwsh-guide - 生成项目级 Shell 操作指南 Agent Skill（跨
 
 选项:
   --dry-run  只输出探测 JSON（用于调试）
+  -v, --version 显示版本号
   -h, --help 显示本帮助
 `;
 
@@ -25,10 +30,16 @@ async function main() {
     allowPositionals: true,
     options: {
       'dry-run': { type: 'boolean', default: false },
+      version: { type: 'boolean', short: 'v', default: false },
       help: { type: 'boolean', short: 'h', default: false },
     },
   });
 
+  if (values.version) {
+    console.log(pkg.version);
+    return;
+  }
+
   const command = positionals[0] ?? 'help';
   if (values.help || command === 'help') {
     console.log(USAGE);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pwsh-guide",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Generate a project-level Agent Skill: probe the current environment (Windows PowerShell / macOS / Linux shell) and produce a reliable command guide (SKILL.md + references) for agents such as Codex and Claude Code.",
   "type": "module",
   "bin": {

package/src/probe.js

@@ -30,6 +30,22 @@ const MARKER_NAMES = [
 const IGNORED_SUBDIRS = new Set(['.git', '.venv', 'venv', 'node_modules']);
 const VERSION_TIMEOUT_MS = 5000;
 
+// `--version` 输出命中这些模式时视为错误信息而非版本号（如 Windows py 启动器未安装 Python）
+const VERSION_ERROR_PATTERNS = [
+  /not found/i,
+  /not installed/i,
+  /no installed/i,
+  /not recognized/i,
+  /command not found/i,
+  /内部或外部命令/,
+  /找不到/,
+];
+
+function isPlausibleVersion(text) {
+  if (!text) return false;
+  return !VERSION_ERROR_PATTERNS.some((re) => re.test(text));
+}
+
 export async function probeEnvironment(cwd) {
   const platform = process.platform; // 'win32' | 'darwin' | 'linux'（其它平台按 unix 处理）
   const family = platform === 'win32' ? 'powershell' : 'unix';
@@ -124,7 +140,8 @@ async function probeTools() {
       results.push({ name, version: null, source: null });
       continue;
     }
-    const version = await runVersionCommand(toolPath);
+    const rawVersion = await runVersionCommand(toolPath);
+    const version = isPlausibleVersion(rawVersion) ? rawVersion : null;
     results.push({ name, version, source: toolPath });
   }
   return results;