devassist-agent 1.0.1 → 1.0.3

package/bin/devassist.js

@@ -134,6 +134,8 @@ async function main() {
         return require(path.join(cmdDir, 'clean'))(projectRoot, args.slice(1), { printHeader, c });
       case 'fix':
         return require(path.join(cmdDir, 'fix'))(projectRoot, args.slice(1), { printHeader, c });
+      case 'start':
+        return require(path.join(cmdDir, 'start'))(projectRoot, args.slice(1), { printHeader, printFinding, printStats, c });
       case 'watch':
         return require(path.join(cmdDir, 'watch'))(projectRoot, args.slice(1), { printHeader, printFinding, printStats, c });
       case 'report':
@@ -164,6 +166,7 @@ function printHelp() {
   printHeader('开发守护 CLI');
   console.log(`${c.bold('用法：')} devassist <命令> [选项]\n`);
   console.log(`${c.bold('命令：')}`);
+  console.log(`  ${c.green('start')}                 一键启动：自动初始化 + AI多引擎实时监控`);
   console.log(`  ${c.green('init')}                  初始化项目——创建 .devassist/ 配置与基础代码`);
   console.log(`  ${c.green('check')}                 运行全部开发时检查（代码质量 + 约定 + 模式 + 架构）`);
   console.log(`  ${c.green('watch')}                 实时监控文件变更并运行检查`);
@@ -192,6 +195,8 @@ function printHelp() {
   console.log(`  ${c.gray('-v, --version')}       显示版本`);
   console.log(`  ${c.gray('-h, --help')}          显示帮助\n`);
   console.log(`${c.bold('示例：')}`);
+  console.log(`  ${c.gray('$')} devassist start                # 一键启动（自动init+AI多引擎监控）`);
+  console.log(`  ${c.gray('$')} devassist start --check        # 一键检查（不启动监控）`);
   console.log(`  ${c.gray('$')} devassist init`);
   console.log(`  ${c.gray('$')} devassist check --ai`);
   console.log(`  ${c.gray('$')} devassist watch              # 开发时实时监控`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devassist-agent",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "AI Agent 开发质量守护工具 — 30+规则检测代码缺陷/安全漏洞/性能反模式，多引擎AI根因分析，零外部依赖",
   "main": "src/index.js",
   "bin": {

package/src/cli/commands/ai.js

@@ -125,6 +125,7 @@ function printHelp(c) {
  * Returns: { ...rawConfig, engines: [{ provider, apiKey, model, baseUrl, enabled, name }] }
  *
  * Resolution order:
+ *   0. Project config .devassist/ai-config.json → fallback to global ~/.devassist/ai-config.json
  *   1. Primary engine from top-level fields (provider/apiKey/model)
  *   2. Legacy `secondary` field (if present)
  *   3. `engines` array (if present)
@@ -132,10 +133,13 @@ function printHelp(c) {
  *   5. Deduplicate by provider+model
  */
 function loadAIConfig(projectRoot) {
+  // Try project-level config first, then global config
   const configPath = path.join(projectRoot, '.devassist', 'ai-config.json');
-  if (!fs.existsSync(configPath)) return null;
+  const globalConfigPath = path.join(require('os').homedir(), '.devassist', 'ai-config.json');
+  const usePath = fs.existsSync(configPath) ? configPath : (fs.existsSync(globalConfigPath) ? globalConfigPath : null);
+  if (!usePath) return null;
   try {
-    const rawConfig = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    const rawConfig = JSON.parse(fs.readFileSync(usePath, 'utf-8'));
 
     // Build engines array
     const engines = [];
@@ -246,7 +250,12 @@ function showAIStatus(projectRoot, c) {
     console.log(`    ${c.bold('devassist ai --add-engine --provider hunyuan --key <key>')}\n`);
   }
 
-  console.log(`  配置文件:   ${path.join(projectRoot, '.devassist', 'ai-config.json')}\n`);
+  // Show which config file is in use
+  const projectConfigPath = path.join(projectRoot, '.devassist', 'ai-config.json');
+  const globalConfigPath = path.join(require('os').homedir(), '.devassist', 'ai-config.json');
+  const usedPath = fs.existsSync(projectConfigPath) ? projectConfigPath : (fs.existsSync(globalConfigPath) ? globalConfigPath : null);
+  const configSource = usedPath === globalConfigPath ? c.cyan('全局') + ' ' : '';
+  console.log(`  配置文件:   ${configSource}${usedPath || c.yellow('未配置')}\n`);
 }
 
 // ─── Setup / Add / Remove Engine ─────────────────────

package/src/cli/commands/start.js

@@ -0,0 +1,84 @@
+/**
+ * devassist start - One-command quick start
+ *
+ * Automatically:
+ *   1. Initialize project (if not already initialized)
+ *   2. Verify AI config (global or project-level, with real API keys)
+ *   3. Start watch mode with --ai --compare
+ *
+ * Usage:
+ *   devassist start              # Full auto: init + watch --ai --compare
+ *   devassist start --no-ai      # Init + watch (rules only, no AI)
+ *   devassist start --check      # Init + one-time check --ai --compare (no watch)
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+module.exports = async function start(projectRoot, args, ui) {
+  const { printHeader, printFinding, printStats, c } = ui;
+
+  const noAI = args.includes('--no-ai');
+  const checkOnly = args.includes('--check');
+
+  printHeader('一键启动');
+
+  // ─── Step 1: Auto init ────────────────────────────
+  const configDir = path.join(projectRoot, '.devassist');
+  if (!fs.existsSync(configDir)) {
+    console.log(`  ${c.gray('1/3')} 项目未初始化，正在自动初始化...`);
+    const initCmd = require('./init');
+    initCmd(projectRoot, ['--force'], ui);
+    console.log('');
+  } else {
+    console.log(`  ${c.green('1/3')} 项目已初始化 ✓`);
+  }
+
+  // ─── Step 2: Verify AI config ─────────────────────
+  // Use loadAIConfig to check if real API keys are configured
+  const aiCmd = require('./ai');
+  const config = aiCmd.loadAIConfig(projectRoot);
+  const readyEngines = config ? config.engines.filter(e => e.enabled && e.apiKey) : [];
+  const aiReady = readyEngines.length >= 2;
+
+  // Determine config source
+  const projectConfigPath = path.join(projectRoot, '.devassist', 'ai-config.json');
+  const globalConfigPath = path.join(os.homedir(), '.devassist', 'ai-config.json');
+  const configSource = fs.existsSync(projectConfigPath) ? '项目配置' :
+                       (fs.existsSync(globalConfigPath) ? '全局配置' : '');
+
+  if (aiReady && !noAI) {
+    const engineNames = readyEngines.map(e => e.name || e.provider).join(' + ');
+    console.log(`  ${c.green('2/3')} AI 引擎已就绪 ✓ (${configSource}：${engineNames})`);
+  } else if (readyEngines.length === 1 && !noAI) {
+    console.log(`  ${c.green('2/3')} AI 引擎已就绪 ✓ (${configSource}：${readyEngines[0].name}，仅单引擎)`);
+    console.log(`         ${c.gray('提示：配置第二个引擎可启用对比模式')}`);
+  } else if (!noAI) {
+    console.log(`  ${c.yellow('2/3')} 未检测到 AI 配置`);
+    console.log(`         ${c.gray('将仅使用规则引擎检查（30条规则）')}`);
+    console.log(`         ${c.gray('配置 AI：devassist ai --setup --provider qwen --key <key>')}`);
+    noAI = true; // fallback to rules-only
+  } else {
+    console.log(`  ${c.green('2/3')} 规则引擎模式 ✓`);
+  }
+
+  // ─── Step 3: Run ──────────────────────────────────
+  if (checkOnly) {
+    console.log(`  ${c.cyan('3/3')} 正在执行完整检查...\n`);
+    const checkCmd = require('./check');
+    const checkArgs = [];
+    if (!noAI) {
+      checkArgs.push('--ai', '--compare');
+    }
+    await checkCmd(projectRoot, checkArgs, ui);
+  } else {
+    console.log(`  ${c.cyan('3/3')} 启动实时监控...\n`);
+    const watchCmd = require('./watch');
+    const watchArgs = [];
+    if (!noAI) {
+      watchArgs.push('--ai', '--compare');
+    }
+    await watchCmd(projectRoot, watchArgs, ui);
+  }
+};