pwsh-guide 0.2.0 → 0.2.2

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,19 +4,24 @@
 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）
 
 用法:
   pwsh-guide init            探测环境并在 .agents/skills/pwsh-guide/ 生成 skill
-  pwsh-guide refresh         重新探测并更新 references（SKILL.md 保持不变）
+  pwsh-guide refresh         重新探测并重新生成 SKILL.md 与 references
   pwsh-guide init --dry-run  仅输出探测结果，不写任何文件
 
 选项:
   --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);
@@ -65,10 +76,8 @@ async function main() {
   const refsDir = path.join(skillDir, 'references');
   fs.mkdirSync(refsDir, { recursive: true });
 
-  if (command === 'init') {
-    fs.writeFileSync(path.join(skillDir, 'SKILL.md'), renderSkill(env), 'utf8');
-    console.log(`[pwsh-guide] 已生成 ${path.join(skillDir, 'SKILL.md')}`);
-  }
+  fs.writeFileSync(path.join(skillDir, 'SKILL.md'), renderSkill(env), 'utf8');
+  console.log(`[pwsh-guide] 已更新 ${path.join(skillDir, 'SKILL.md')}`);
   fs.writeFileSync(path.join(refsDir, 'environment.md'), renderEnvironment(env), 'utf8');
   fs.writeFileSync(path.join(refsDir, 'commands.md'), renderCommands(env), 'utf8');
   console.log(`[pwsh-guide] 已更新 ${path.join(refsDir, 'environment.md')}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pwsh-guide",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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;