#!/usr/bin/env node const fs = require('fs'); const os = require('os'); const path = require('path'); const { spawnSync } = require('child_process'); const SKILL_NAME = 'fmode-vision'; const SOURCE_ROOT = path.resolve(__dirname, '..'); const SKILL_SOURCE = path.join(SOURCE_ROOT, 'skills', SKILL_NAME); const WORKSPACE_ROOT = process.cwd(); const GLOBAL_TARGET = path.join(os.homedir(), '.claude', 'skills', SKILL_NAME); const WORKSPACE_TARGET = path.join(WORKSPACE_ROOT, '.claude', 'skills', SKILL_NAME); const WORKSPACE_SKILLS_ROOT = path.join(WORKSPACE_ROOT, '.claude', 'skills'); const GLOBAL_SKILLS_ROOT = path.join(os.homedir(), '.claude', 'skills'); function expandHome(value) { return String(value || '').replace(/^~(?=$|[\\/])/, os.homedir()); } function parseArgs(argv) { const first = argv[0] && !argv[0].startsWith('--') ? argv[0] : 'install'; const args = { command: first, target: GLOBAL_TARGET, smoke: false, force: false, help: false }; if (first === 'workspace' || first === 'install-workspace') { args.command = 'install'; args.target = WORKSPACE_TARGET; } for (let i = first === argv[0] ? 1 : 0; i < argv.length; i++) { const token = argv[i]; if (token === '--target' && argv[i + 1]) args.target = argv[++i]; else if (token.startsWith('--target=')) args.target = token.slice('--target='.length); else if (token === '--workspace') args.target = WORKSPACE_TARGET; else if (token === '--global') args.target = GLOBAL_TARGET; else if (token === '--smoke') args.smoke = true; else if (token === '--force') args.force = true; else if (token === '--help' || token === '-h') args.help = true; } args.target = path.resolve(expandHome(args.target)); return args; } function printHelp() { console.log([ 'fmode-vision skill installer', '', 'Usage:', ' npx fmode-vision@latest workspace [--smoke] # install into ./.claude/skills/fmode-vision', ' npx fmode-vision@latest install [--smoke] # install into ~/.claude/skills/fmode-vision', ' npx fmode-vision@latest install --target [--force]', ' npx fmode-vision@latest check', ' npx fmode-vision@latest smoke', ' npx fmode-vision@latest path', '', 'Options:', ' --workspace Install into ./.claude/skills/fmode-vision', ' --global Install into ~/.claude/skills/fmode-vision (default)', ' --target Install into a custom directory', ' --force Allow overwriting a custom target', ' --smoke Run smoke checks after install', ' --help, -h Show help' ].join('\n')); } function ensureDir(dirPath) { fs.mkdirSync(dirPath, { recursive: true }); } function isInside(parentDir, childDir) { const relative = path.relative(path.resolve(parentDir), path.resolve(childDir)); return relative === '' || (!!relative && !relative.startsWith('..') && !path.isAbsolute(relative)); } function canOverwriteTarget(targetDir, force) { return force || path.resolve(targetDir) === path.resolve(GLOBAL_TARGET) || isInside(WORKSPACE_SKILLS_ROOT, targetDir) || isInside(GLOBAL_SKILLS_ROOT, targetDir); } function copyDirRecursive(source, destination) { const stat = fs.statSync(source); if (stat.isDirectory()) { ensureDir(destination); for (const child of fs.readdirSync(source)) { if (child === 'node_modules' || child === 'outputs' || child === '.git') continue; copyDirRecursive(path.join(source, child), path.join(destination, child)); } return; } ensureDir(path.dirname(destination)); fs.copyFileSync(source, destination); } function installSkill(target, force) { if (!fs.existsSync(SKILL_SOURCE)) { throw new Error(`Skill source missing: ${SKILL_SOURCE}`); } if (fs.existsSync(target)) { if (!canOverwriteTarget(target, force)) { throw new Error(`Refusing to overwrite custom target without --force: ${target}`); } fs.rmSync(target, { recursive: true, force: true }); } ensureDir(target); copyDirRecursive(SKILL_SOURCE, target); } function checkSkill(target) { const required = ['SKILL.md', 'scripts/vision-client.mjs']; const missing = required.filter(entry => !fs.existsSync(path.join(target, entry))); if (missing.length) { throw new Error(`Install target is missing required files: ${missing.join(', ')}`); } return { status: 'ok', skill: SKILL_NAME, target, required }; } function runSmoke() { const result = spawnSync(process.execPath, ['scripts/smoke.js'], { cwd: SOURCE_ROOT, stdio: 'inherit', shell: false }); if (result.status !== 0) throw new Error('smoke failed'); } function printNextSteps(target) { const workspaceMode = isInside(WORKSPACE_SKILLS_ROOT, target); console.log(''); console.log('Install complete.'); console.log(`Skill installed at: ${target}`); console.log(''); if (workspaceMode) { console.log('Project-level skill is ready. Restart the VSCode Claude Code session if it was open.'); } else { console.log('User-level skill is ready for all Claude Code workspaces.'); } console.log(''); console.log('Token: set FMODE_API_TOKEN, or ~/.fmode/config.json -> fmodeApiToken, or rely on ANTHROPIC_AUTH_TOKEN.'); console.log(''); console.log('Try this prompt in Claude Code:'); console.log(' 帮我分析这张图片里的关键内容,输出结构化信息。'); } function main() { const args = parseArgs(process.argv.slice(2)); if (args.help || args.command === 'help') { printHelp(); return; } if (args.command === 'path') { console.log(args.target); return; } if (args.command === 'install') { installSkill(args.target, args.force); console.log(JSON.stringify(checkSkill(args.target), null, 2)); if (args.smoke) runSmoke(); printNextSteps(args.target); return; } if (args.command === 'check') { console.log(JSON.stringify(checkSkill(args.target), null, 2)); return; } if (args.command === 'smoke') { runSmoke(); return; } printHelp(); process.exitCode = 1; } try { main(); } catch (error) { console.error(`fmode-vision failed: ${error.message}`); process.exit(1); }