@chuhe2640/ahsopus-cli 0.1.0 → 0.1.3

package/README.md

@@ -75,7 +75,7 @@ go test -race ./...
 go build ./cmd/ahsops
 ```
 
-依赖下载、Go 安装和正式签名需要在受控开发或 CI 环境中执行。本仓库 CI 负责格式、服务端CLI契约、测试、race 和三目标交叉构建；正式 Release 只能从`main`手工触发，要求名为`ahsops-cli-release`的受保护 GitHub Environment、人工审批以及其中配置的macOS与Windows签名Secret。同一SemVer的已发布签名产物不可覆盖。
+本仓库不再使用 GitHub Actions 做 CLI 测试或签名发行。格式、契约和 `go test` 在本机执行。用户安装走 npm：`npx @chuhe2640/ahsopus-cli@latest install`。
 
 ## 验证边界
 

package/bin/cli.js

@@ -4,8 +4,9 @@ import { existsSync } from 'node:fs'
 import { install } from '../npm/lib/install.js'
 import { nativeBinaryPath, placeBinary } from '../npm/lib/place-binary.js'
 
-const args = process.argv.slice(2)
-if (args[0] === 'install') {
+const args = process.argv.slice(2).filter((value) => value !== '--')
+const command = args.find((value) => !value.startsWith('-')) ?? 'install'
+if (command === 'install') {
   try {
     await install()
   } catch (error) {

package/internal/skills/agents.json

@@ -0,0 +1,74 @@
+[
+  {"id":"aider-desk","name":"AiderDesk","detect":["~/.aider-desk"],"skills":["~/.aider-desk/skills"]},
+  {"id":"amp","name":"Amp","detect":["~config/amp"],"skills":["~config/agents/skills"]},
+  {"id":"antigravity","name":"Antigravity","detect":["~/.gemini/antigravity"],"skills":["~/.gemini/antigravity/skills"]},
+  {"id":"antigravity-cli","name":"Antigravity CLI","detect":["~/.gemini/antigravity-cli"],"skills":["~/.gemini/antigravity-cli/skills"]},
+  {"id":"astrbot","name":"AstrBot","detect":["~/.astrbot"],"skills":["~/.astrbot/data/skills"]},
+  {"id":"autohand-code","name":"Autohand Code CLI","detect":["$AUTOHAND_HOME","~/.autohand"],"skills":["$AUTOHAND_HOME/skills","~/.autohand/skills"]},
+  {"id":"augment","name":"Augment","detect":["~/.augment"],"skills":["~/.augment/skills"]},
+  {"id":"bob","name":"IBM Bob","detect":["~/.bob"],"skills":["~/.bob/skills"]},
+  {"id":"claude-code","name":"Claude Code","detect":["$CLAUDE_CONFIG_DIR","~/.claude"],"skills":["$CLAUDE_CONFIG_DIR/skills","~/.claude/skills"]},
+  {"id":"openclaw","name":"OpenClaw","detect":["~/.openclaw","~/.clawdbot","~/.moltbot"],"skills":["~/.openclaw/skills"]},
+  {"id":"cline","name":"Cline","detect":["~/.cline"],"skills":["~/.agents/skills"]},
+  {"id":"codearts-agent","name":"CodeArts Agent","detect":["~/.codeartsdoer"],"skills":["~/.codeartsdoer/skills"]},
+  {"id":"codebuddy","name":"CodeBuddy","detect":["~/.codebuddy"],"skills":["~/.codebuddy/skills"]},
+  {"id":"codemaker","name":"Codemaker","detect":["~/.codemaker"],"skills":["~/.codemaker/skills"]},
+  {"id":"codestudio","name":"Code Studio","detect":["~/.codestudio"],"skills":["~/.codestudio/skills"]},
+  {"id":"codex","name":"Codex","detect":["$CODEX_HOME","~/.codex"],"skills":["$CODEX_HOME/skills","~/.codex/skills"]},
+  {"id":"command-code","name":"Command Code","detect":["~/.commandcode"],"skills":["~/.commandcode/skills"]},
+  {"id":"continue","name":"Continue","detect":["~/.continue"],"skills":["~/.continue/skills"]},
+  {"id":"cortex","name":"Cortex Code","detect":["~/.snowflake/cortex"],"skills":["~/.snowflake/cortex/skills"]},
+  {"id":"crush","name":"Crush","detect":["~config/crush"],"skills":["~config/crush/skills"]},
+  {"id":"cursor","name":"Cursor","detect":["~/.cursor"],"skills":["~/.cursor/skills"]},
+  {"id":"deepagents","name":"Deep Agents","detect":["~/.deepagents"],"skills":["~/.deepagents/agent/skills"]},
+  {"id":"devin","name":"Devin for Terminal","detect":["~config/devin"],"skills":["~config/devin/skills"]},
+  {"id":"dexto","name":"Dexto","detect":["~/.dexto"],"skills":["~/.agents/skills"]},
+  {"id":"droid","name":"Droid","detect":["~/.factory"],"skills":["~/.factory/skills"]},
+  {"id":"firebender","name":"Firebender","detect":["~/.firebender"],"skills":["~/.firebender/skills"]},
+  {"id":"forgecode","name":"ForgeCode","detect":["~/.forge"],"skills":["~/.forge/skills"]},
+  {"id":"gemini-cli","name":"Gemini CLI","detect":["~/.gemini"],"skills":["~/.gemini/skills"]},
+  {"id":"github-copilot","name":"GitHub Copilot","detect":["~/.copilot"],"skills":["~/.copilot/skills"]},
+  {"id":"goose","name":"Goose","detect":["~config/goose"],"skills":["~config/goose/skills"]},
+  {"id":"grok","name":"Grok","detect":["$GROK_HOME","~/.grok"],"skills":["$GROK_HOME/skills","~/.grok/skills"]},
+  {"id":"hermes-agent","name":"Hermes Agent","detect":["$HERMES_HOME","~/.hermes"],"skills":["$HERMES_HOME/skills","~/.hermes/skills"]},
+  {"id":"inference-sh","name":"inference.sh","detect":["~/.inferencesh"],"skills":["~/.inferencesh/skills"]},
+  {"id":"jazz","name":"Jazz","detect":["~/.jazz"],"skills":["~/.jazz/skills"]},
+  {"id":"junie","name":"Junie","detect":["~/.junie"],"skills":["~/.junie/skills"]},
+  {"id":"iflow-cli","name":"iFlow CLI","detect":["~/.iflow"],"skills":["~/.iflow/skills"]},
+  {"id":"kilo","name":"Kilo Code","detect":["~/.kilocode"],"skills":["~/.kilocode/skills"]},
+  {"id":"kimchi","name":"Kimchi","detect":["~config/kimchi"],"skills":["~config/kimchi/harness/skills"]},
+  {"id":"kimi-code-cli","name":"Kimi Code CLI","detect":["~/.kimi-code","~/.kimi"],"skills":["~/.agents/skills"]},
+  {"id":"kiro-cli","name":"Kiro CLI","detect":["~/.kiro"],"skills":["~/.kiro/skills"]},
+  {"id":"kode","name":"Kode","detect":["~/.kode"],"skills":["~/.kode/skills"]},
+  {"id":"lingma","name":"Lingma","detect":["~/.lingma"],"skills":["~/.lingma/skills"]},
+  {"id":"loaf","name":"Loaf","detect":["~/.loaf"],"skills":["~/.agents/skills"]},
+  {"id":"mcpjam","name":"MCPJam","detect":["~/.mcpjam"],"skills":["~/.mcpjam/skills"]},
+  {"id":"minimax-code","name":"MiniMax Code","detect":["~/.minimax"],"skills":["~/.minimax/skills"]},
+  {"id":"mistral-vibe","name":"Mistral Vibe","detect":["$VIBE_HOME","~/.vibe"],"skills":["$VIBE_HOME/skills","~/.vibe/skills"]},
+  {"id":"moxby","name":"Moxby","detect":["~/.moxby"],"skills":["~/.moxby/skills"]},
+  {"id":"mux","name":"Mux","detect":["~/.mux"],"skills":["~/.mux/skills"]},
+  {"id":"opencode","name":"OpenCode","detect":["~config/opencode"],"skills":["~config/opencode/skills"]},
+  {"id":"openhands","name":"OpenHands","detect":["~/.openhands"],"skills":["~/.openhands/skills"]},
+  {"id":"ona","name":"Ona","detect":["~/.ona"],"skills":["~/.ona/skills"]},
+  {"id":"pi","name":"Pi","detect":["~/.pi/agent"],"skills":["~/.pi/agent/skills"]},
+  {"id":"posit-assistant","name":"Posit Assistant","detect":["~/.posit"],"skills":["~/.posit/assistant/skills"]},
+  {"id":"qoder","name":"Qoder","detect":["~/.qoder"],"skills":["~/.qoder/skills"]},
+  {"id":"qoder-cn","name":"Qoder CN","detect":["~/.qoder-cn"],"skills":["~/.qoder-cn/skills"]},
+  {"id":"qwen-code","name":"Qwen Code","detect":["~/.qwen"],"skills":["~/.qwen/skills"]},
+  {"id":"reasonix","name":"Reasonix","detect":["~/.reasonix"],"skills":["~/.reasonix/skills"]},
+  {"id":"rovodev","name":"Rovo Dev","detect":["~/.rovodev"],"skills":["~/.rovodev/skills"]},
+  {"id":"roo","name":"Roo Code","detect":["~/.roo"],"skills":["~/.roo/skills"]},
+  {"id":"tabnine-cli","name":"Tabnine CLI","detect":["~/.tabnine"],"skills":["~/.tabnine/agent/skills"]},
+  {"id":"terramind","name":"Terramind","detect":["~/.terramind"],"skills":["~/.terramind/skills"]},
+  {"id":"tinycloud","name":"Tinycloud","detect":["~/.tinycloud"],"skills":["~/.tinycloud/skills"]},
+  {"id":"trae","name":"Trae","detect":["~/.trae"],"skills":["~/.trae/skills"]},
+  {"id":"trae-cn","name":"Trae CN","detect":["~/.trae-cn"],"skills":["~/.trae-cn/skills"]},
+  {"id":"warp","name":"Warp","detect":["~/.warp"],"skills":["~/.agents/skills"]},
+  {"id":"windsurf","name":"Windsurf","detect":["~/.codeium/windsurf"],"skills":["~/.codeium/windsurf/skills"]},
+  {"id":"zed","name":"Zed","detect":["~config/zed"],"skills":["~/.agents/skills"]},
+  {"id":"zcode","name":"ZCode","detect":["~/.zcode"],"skills":["~/.zcode/skills"]},
+  {"id":"zencoder","name":"Zencoder","detect":["~/.zencoder"],"skills":["~/.zencoder/skills"]},
+  {"id":"neovate","name":"Neovate","detect":["~/.neovate"],"skills":["~/.neovate/skills"]},
+  {"id":"pochi","name":"Pochi","detect":["~/.pochi"],"skills":["~/.pochi/skills"]},
+  {"id":"adal","name":"AdaL","detect":["~/.adal"],"skills":["~/.adal/skills"]}
+]

package/npm/lib/agents.js

@@ -0,0 +1,59 @@
+// INPUT: agents.json（飞书 CLI npx skills add -g 的完整客户端目录）
+// OUTPUT: 可检测的本机 Agent 与展示名
+// POS: 安装向导与飞书 skills CLI 客户端目录对齐
+
+import { existsSync, readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+function loadCatalog() {
+  const here = path.dirname(fileURLToPath(import.meta.url))
+  const candidates = [
+    path.join(here, '../../internal/skills/agents.json'),
+    path.join(here, 'agents.json'),
+  ]
+  for (const file of candidates) {
+    if (existsSync(file)) {
+      return JSON.parse(readFileSync(file, 'utf8'))
+    }
+  }
+  throw new Error('未找到 agents.json')
+}
+
+export const AGENTS = loadCatalog()
+
+function configHome(home) {
+  const value = process.env.XDG_CONFIG_HOME?.trim()
+  return value || path.join(home, '.config')
+}
+
+export function expandPath(pattern, home = homedir()) {
+  if (pattern.startsWith('$')) {
+    const slash = pattern.indexOf('/')
+    const envName = slash === -1 ? pattern.slice(1) : pattern.slice(1, slash)
+    const value = process.env[envName]?.trim()
+    if (!value) return null
+    return slash === -1 ? value : path.join(value, pattern.slice(slash + 1))
+  }
+  if (pattern.startsWith('~config/')) {
+    return path.join(configHome(home), pattern.slice('~config/'.length))
+  }
+  if (pattern.startsWith('~/')) {
+    return path.join(home, pattern.slice(2))
+  }
+  return pattern
+}
+
+export function detectedAgents(home = homedir()) {
+  return AGENTS.filter((agent) =>
+    agent.detect.some((pattern) => {
+      const resolved = expandPath(pattern, home)
+      return resolved && existsSync(resolved)
+    }),
+  )
+}
+
+export function agentName(id) {
+  return AGENTS.find((agent) => agent.id === id)?.name ?? id
+}

package/npm/lib/install.js

@@ -1,21 +1,14 @@
 // INPUT: 本机 Node、已安装的 Agent、终端是否可交互
-// OUTPUT: 全局安装 ahsops，多选写入 Skills，并按当前站点配置 profile
-// POS: npx @chuhe2640/ahsopus-cli install 的跨平台入口，对齐飞书 CLI 安装向导，不要求 Go，不打印 Token
+// OUTPUT: 安装或升级 ahsops，写入 Skills，并按当前站点配置 profile
+// POS: npx @chuhe2640/ahsopus-cli install 的跨平台入口，对齐飞书 CLI 安装向导
 
 import * as p from '@clack/prompts'
 import { spawnSync } from 'node:child_process'
 import { existsSync, readFileSync } from 'node:fs'
-import { homedir, platform } from 'node:os'
-import path from 'node:path'
+import { platform } from 'node:os'
 import { stdin } from 'node:process'
-import { packageRoot } from './place-binary.js'
-
-export const AGENTS = [
-  { id: 'claude-code', name: 'Claude Code', hint: '~/.claude' },
-  { id: 'codex', name: 'Codex', hint: '~/.codex' },
-  { id: 'cursor', name: 'Cursor', hint: '~/.cursor' },
-  { id: 'grok', name: 'Grok', hint: '~/.grok' },
-]
+import { AGENTS, detectedAgents } from './agents.js'
+import { installUserBinary, resolveInstalledAhsops } from './place-binary.js'
 
 const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'))
 
@@ -45,6 +38,17 @@ export function parseInstallFlags(argv) {
   return { server, profile }
 }
 
+export function semverLessThan(left, right) {
+  const parse = (value) => value.replace(/-.*$/, '').split('.').map((part) => Number(part) || 0)
+  const a = parse(left)
+  const b = parse(right)
+  for (let index = 0; index < 3; index += 1) {
+    if (a[index] < b[index]) return true
+    if (a[index] > b[index]) return false
+  }
+  return false
+}
+
 function execFile(command, args, options) {
   if (platform() === 'win32') {
     return spawnSync('cmd.exe', ['/c', command, ...args], options)
@@ -71,60 +75,52 @@ function runQuiet(command, args, options = {}) {
   return run(command, args, { stdio: ['ignore', 'pipe', 'pipe'], ...options })
 }
 
-export function detectedAgents(home = homedir()) {
-  return AGENTS.filter((agent) => existsSync(agent.hint.replace('~', home)))
-}
-
-function globalAhsops() {
-  const prefix = runQuiet('npm', ['prefix', '-g']).stdout.trim()
-  if (platform() === 'win32') {
-    return path.join(prefix, 'ahsops.cmd')
-  }
-  return path.join(prefix, 'bin', 'ahsops')
-}
-
-function globallyInstalledVersion() {
+function installedVersion(binary) {
+  if (!binary || !existsSync(binary)) return null
   try {
-    const out = runQuiet('npm', ['list', '-g', pkg.name], { timeout: 15000 }).stdout
-    const match = String(out).match(/@(\d+\.\d+\.\d+[^\s]*)/)
+    const out = runQuiet(binary, ['--version'])
+    const match = String(`${out.stdout}\n${out.stderr}`).match(/(\d+\.\d+\.\d+[^\s]*)/)
     return match ? match[1] : null
   } catch {
     return null
   }
 }
 
-async function installGlobally() {
-  const installed = globallyInstalledVersion()
-  if (installed === pkg.version) {
-    p.log.info(`已安装 (v${installed})，跳过`)
-    return
+async function installCliBinary() {
+  const current = resolveInstalledAhsops()
+  const currentVersion = installedVersion(current)
+  if (currentVersion && currentVersion === pkg.version) {
+    p.log.info(`已安装 (v${currentVersion})，跳过`)
+    return current
   }
   const spinner = p.spinner()
-  spinner.start(installed ? `正在升级 ${pkg.name} (v${installed} → v${pkg.version})...` : `正在安装 ${pkg.name}...`)
+  const upgrading = Boolean(currentVersion && semverLessThan(currentVersion, pkg.version))
+  spinner.start(
+    upgrading
+      ? `正在升级 ${pkg.name} (v${currentVersion} → v${pkg.version})...`
+      : `正在安装 ${pkg.name}...`,
+  )
   try {
-    try {
-      runQuiet('npm', ['install', '-g', `${pkg.name}@${pkg.version}`], { timeout: 120000 })
-    } catch {
-      runQuiet('npm', ['install', '-g', packageRoot()], { timeout: 120000 })
-    }
-    spinner.stop(installed ? `已升级到 v${pkg.version}` : '已全局安装')
-  } catch {
-    spinner.stop(`全局安装失败。运行以下命令重试: npm install -g ${pkg.name}`)
+    const file = installUserBinary()
+    spinner.stop(upgrading ? `已升级到 v${pkg.version}` : '已全局安装')
+    return file
+  } catch (error) {
+    spinner.stop(`全局安装失败。运行以下命令重试: npx ${pkg.name}@latest install`)
+    p.log.error(error instanceof Error ? error.message : String(error))
     process.exit(1)
   }
 }
 
 async function chooseAgents() {
   const found = detectedAgents()
+  const options = (found.length ? found : AGENTS).map((agent) => ({
+    value: agent.id,
+    label: agent.name,
+    hint: found.some((item) => item.id === agent.id) ? '已检测到' : undefined,
+  }))
   const selected = await p.multiselect({
-    message: found.length
-      ? `检测到本机已安装：${found.map((agent) => agent.name).join('、')}。空格多选，回车确认`
-      : '未检测到已安装的 AI Agent。空格多选要写入 Skills 的工具，回车确认',
-    options: AGENTS.map((agent) => ({
-      value: agent.id,
-      label: agent.name,
-      hint: found.some((item) => item.id === agent.id) ? '已检测到' : undefined,
-    })),
+    message: '安装 AI Skills',
+    options,
     initialValues: found.map((agent) => agent.id),
     required: false,
   })
@@ -135,35 +131,56 @@ async function chooseAgents() {
   return selected
 }
 
+function skillsInSync(binary, target) {
+  try {
+    const out = runQuiet(binary, ['skills', 'status', '--target', target, '--scope', 'user'])
+    const parsed = JSON.parse(out.stdout)
+    const items = Array.isArray(parsed.data) ? parsed.data : parsed
+    return Array.isArray(items) && items.length > 0 && items.every((item) => item.in_sync)
+  } catch {
+    return false
+  }
+}
+
 async function installSkills(binary, targets) {
   if (!targets.length) {
     p.log.info('已跳过 Skills 安装')
     return
   }
+  if (targets.every((target) => skillsInSync(binary, target))) {
+    p.log.info('已安装，跳过')
+    return
+  }
   const spinner = p.spinner()
   spinner.start('正在安装 Skills...')
-  try {
-    for (const target of targets) {
+  let failed = 0
+  for (const target of targets) {
+    try {
       runQuiet(binary, ['skills', 'install', '--target', target, '--scope', 'user', '--yes'])
+    } catch {
+      failed += 1
     }
-    spinner.stop(`Skills 已安装（${targets.map((id) => AGENTS.find((agent) => agent.id === id)?.name ?? id).join('、')}）`)
-  } catch (error) {
-    spinner.stop('Skills 安装失败')
-    p.log.error(error instanceof Error ? error.message : String(error))
-    p.log.info('可稍后执行：ahsops skills install --target claude-code --scope user --yes')
   }
+  if (failed === 0) {
+    spinner.stop('Skills 已安装')
+    return
+  }
+  if (failed < targets.length) {
+    spinner.stop('Skills 已安装')
+    return
+  }
+  spinner.stop('Skills 安装失败')
 }
 
 function writeProfile(binary, server, profile) {
   const profileName = profile || 'office'
   runQuiet(binary, ['profile', 'add', profileName, '--server', server])
   runQuiet(binary, ['profile', 'use', profileName])
-  p.log.success(`已写入 profile ${profileName} → ${server}`)
 }
 
 async function maybeLogin(binary) {
   const yes = await p.confirm({
-    message: '是否现在登录 AHSOpsHub？会打开浏览器，由你本人批准，不要打印或转发 Token',
+    message: '是否允许 AI 访问你的 AHSOpsHub 数据，并以你的名义执行操作？',
     initialValue: true,
   })
   if (p.isCancel(yes)) {
@@ -171,7 +188,7 @@ async function maybeLogin(binary) {
     process.exit(0)
   }
   if (!yes) {
-    p.log.info('跳过授权。后续运行 ahsops auth login --recommend 完成登录')
+    p.log.info('跳过授权。后续运行 ahsops auth login 完成授权')
     return
   }
   p.log.step('授权')
@@ -179,7 +196,7 @@ async function maybeLogin(binary) {
     run(binary, ['auth', 'login', '--recommend'])
     p.log.success('授权完成')
   } catch {
-    p.log.warn('授权失败。后续运行 ahsops auth login --recommend 重试')
+    p.log.warn('授权失败。运行以下命令重试: ahsops auth login')
   }
 }
 
@@ -189,24 +206,18 @@ export async function install() {
 
   if (!interactive) {
     console.error('正在设置 AHSOpsHub CLI...')
-    runQuiet('npm', ['install', '-g', packageRoot()], { timeout: 120000 })
-    const binary = globalAhsops()
-    if (server) {
-      runQuiet(binary, ['profile', 'add', profile || 'office', '--server', server])
-      runQuiet(binary, ['profile', 'use', profile || 'office'])
-    }
-    console.error('当前不是交互终端。请在终端中运行：')
-    console.error('  npx @chuhe2640/ahsopus-cli@latest install --server <当前站点> --profile <dev|office|prod>')
-    console.error('  ahsops auth login --recommend')
+    const binary = installUserBinary()
+    if (server) writeProfile(binary, server, profile)
+    console.error('要完成配置，请在终端中运行：')
+    console.error('  ahsops auth login')
     return
   }
 
   p.intro('正在设置 AHSOpsHub CLI...')
-  await installGlobally()
-  const binary = globalAhsops()
+  const binary = await installCliBinary()
   if (server) writeProfile(binary, server, profile)
   const targets = await chooseAgents()
   await installSkills(binary, targets)
   await maybeLogin(binary)
-  p.outro('安装完成！\n可以和你的 AI 工具（如 Claude Code、Codex、Cursor、Grok）说：“AHSOpsHub CLI 能帮我做什么？”')
+  p.outro('安装完成！\n可以和你的 AI 工具（如 Claude Code、Trae等）说：“AHSOpsHub CLI 能帮我做什么？结合我的情况推荐一下从哪里开始”')
 }

package/npm/lib/place-binary.js

@@ -1,9 +1,10 @@
 // INPUT: 当前平台，以及 npm 包内的 prebuilt/ 或本机 Go
 // OUTPUT: native/ahsops 可执行文件路径
-// POS: postinstall 放置预编译二进制；用户安装不要求 Go
+// POS: 把预编译 ahsops 写到用户 bin，覆盖已有同名命令；用户安装不要求 Go
 
-import { chmodSync, copyFileSync, existsSync, mkdirSync } from 'node:fs'
+import { chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, unlinkSync } from 'node:fs'
 import { spawnSync } from 'node:child_process'
+import { homedir } from 'node:os'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { currentTarget } from './platforms.js'
@@ -17,6 +18,51 @@ export function nativeBinaryPath() {
   return path.join(packageRoot(), 'native', `ahsops${ext}`)
 }
 
+export function userBinaryTarget() {
+  if (process.platform === 'win32') {
+    const dir = path.join(process.env.LOCALAPPDATA || homedir(), 'AHSOpsHub', 'bin')
+    return { dir, file: path.join(dir, 'ahsops.exe') }
+  }
+  const dir = path.join(homedir(), '.local', 'bin')
+  return { dir, file: path.join(dir, 'ahsops') }
+}
+
+export function isEphemeralBin(file) {
+  const normalized = file.replaceAll('\\', '/')
+  return (
+    normalized.includes('/.npm/_npx/') ||
+    normalized.includes('/.npm/_cacache/') ||
+    normalized.includes('/node_modules/')
+  )
+}
+
+function whichAhsops() {
+  const probe = process.platform === 'win32' ? 'where' : 'which'
+  const result = spawnSync(probe, ['ahsops'], { encoding: 'utf8', stdio: 'pipe' })
+  if (result.status !== 0) return ''
+  return result.stdout.split(/\r?\n/).map((line) => line.trim()).find(Boolean) || ''
+}
+
+export function resolveInstalledAhsops() {
+  const { file } = userBinaryTarget()
+  if (existsSync(file)) return file
+  const existing = whichAhsops()
+  if (existing && !isEphemeralBin(existing)) return existing
+  return ''
+}
+
+function copyBinary(source, destination) {
+  mkdirSync(path.dirname(destination), { recursive: true })
+  try {
+    const stat = lstatSync(destination)
+    if (stat.isFile() || stat.isSymbolicLink()) unlinkSync(destination)
+  } catch {
+    // 目标不存在时直接写入
+  }
+  copyFileSync(source, destination)
+  chmodSync(destination, 0o755)
+}
+
 export function resolvePrebuiltPath(nodePlatform = process.platform, nodeArch = process.arch) {
   const target = currentTarget(nodePlatform, nodeArch)
   return path.join(packageRoot(), 'prebuilt', target.file)
@@ -27,16 +73,12 @@ function commandExists(name) {
   return spawnSync(probe, [name], { encoding: 'utf8', stdio: 'pipe' }).status === 0
 }
 
-export function placeBinary() {
-  const destination = nativeBinaryPath()
-  mkdirSync(path.dirname(destination), { recursive: true })
+function resolveSourceBinary() {
   const prebuilt = resolvePrebuiltPath()
-  if (existsSync(prebuilt)) {
-    copyFileSync(prebuilt, destination)
-    chmodSync(destination, 0o755)
-    return destination
-  }
+  if (existsSync(prebuilt)) return prebuilt
   if (commandExists('go')) {
+    const destination = nativeBinaryPath()
+    mkdirSync(path.dirname(destination), { recursive: true })
     const result = spawnSync('go', ['build', '-o', destination, './cmd/ahsops'], {
       cwd: packageRoot(),
       stdio: 'inherit',
@@ -51,6 +93,42 @@ export function placeBinary() {
   )
 }
 
+export function placeBinary() {
+  const destination = nativeBinaryPath()
+  copyBinary(resolveSourceBinary(), destination)
+  return destination
+}
+
+export function installUserBinary() {
+  const source = resolveSourceBinary()
+  const { file: userFile } = userBinaryTarget()
+  const existing = process.platform === 'win32' ? '' : whichAhsops()
+  const destinations = [userFile]
+  if (
+    existing &&
+    !isEphemeralBin(existing) &&
+    path.resolve(existing) !== path.resolve(userFile)
+  ) {
+    destinations.push(existing)
+  }
+  const written = []
+  const errors = []
+  for (const destination of destinations) {
+    try {
+      copyBinary(source, destination)
+      written.push(destination)
+    } catch (error) {
+      errors.push(`${destination}: ${error instanceof Error ? error.message : String(error)}`)
+    }
+  }
+  if (!written.length) {
+    throw new Error(`无法写入 ahsops。${errors.join('; ')}`)
+  }
+  if (existing && written.includes(existing)) return existing
+  if (written.includes(userFile)) return userFile
+  return written[0]
+}
+
 if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
   try {
     placeBinary()

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@chuhe2640/ahsopus-cli",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Install AHSOpsHub CLI (ahsops) and Agent Skills",
   "type": "module",
   "bin": {
-    "ahsops": "bin/cli.js"
+    "ahsopus-cli": "bin/cli.js"
   },
   "scripts": {
     "prepublishOnly": "node npm/lib/build-binaries.js",
@@ -15,9 +15,11 @@
   },
   "files": [
     "bin/cli.js",
+    "npm/lib/agents.js",
     "npm/lib/install.js",
     "npm/lib/place-binary.js",
     "npm/lib/platforms.js",
+    "internal/skills/agents.json",
     "prebuilt"
   ],
   "os": [