devassist-agent 1.0.0 → 1.0.2

package/bin/devassist.js

@@ -134,8 +134,10 @@ 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, c });
+        return require(path.join(cmdDir, 'watch'))(projectRoot, args.slice(1), { printHeader, printFinding, printStats, c });
       case 'report':
         return require(path.join(cmdDir, 'report'))(projectRoot, args.slice(1), { printHeader, printFinding, c });
       case 'diff':
@@ -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,9 +195,12 @@ 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              # 开发时实时监控`);
+  console.log(`  ${c.gray('$')} devassist watch --ai --compare # 实时监控+AI多引擎对比`);
   console.log(`  ${c.gray('$')} devassist diff --staged       # 提交前检查暂存文件`);
   console.log(`  ${c.gray('$')} devassist report --open       # 生成并查看 HTML 报告`);
   console.log(`  ${c.gray('$')} devassist convention add --id naming-list --rule "使用 data.list 而非 data.items" --severity block`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devassist-agent",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "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,82 @@
+/**
+ * devassist start - One-command quick start
+ *
+ * Automatically:
+ *   1. Initialize project (if not already initialized)
+ *   2. Verify AI config (global or project-level)
+ *   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 ─────────────────────
+  const projectAIConfig = path.join(projectRoot, '.devassist', 'ai-config.json');
+  const globalAIConfig = path.join(os.homedir(), '.devassist', 'ai-config.json');
+
+  let aiReady = false;
+  let configSource = '';
+
+  if (fs.existsSync(projectAIConfig)) {
+    aiReady = true;
+    configSource = '项目配置';
+  } else if (fs.existsSync(globalAIConfig)) {
+    aiReady = true;
+    configSource = '全局配置';
+  }
+
+  if (aiReady && !noAI) {
+    console.log(`  ${c.green('2/3')} AI 引擎已就绪 ✓ (${configSource}：通义千问 + 腾讯混元)`);
+  } else if (!aiReady && !noAI) {
+    console.log(`  ${c.yellow('2/3')} 未检测到 AI 配置`);
+    console.log(`         ${c.gray('将仅使用规则引擎检查（28条规则）')}`);
+    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);
+  }
+};

package/src/cli/commands/watch.js

@@ -32,12 +32,14 @@ const SKIP_DIRS = ['node_modules', '.git', '.devassist', 'dist', 'build', 'vendo
 module.exports = async function watch(projectRoot, args, ui) {
   const { printHeader, printFinding, c } = ui;
   const useAI = args.includes('--ai');
+  const useCompare = args.includes('--compare');
   const watchDir = args.includes('--dir') ? args[args.indexOf('--dir') + 1] : null;
 
   printHeader('监控模式');
 
   console.log(`  ${c.gray('监控目录：')} ${watchDir || '整个项目'}`);
   console.log(`  ${c.gray('AI 分析：')} ${useAI ? '已启用' : '已禁用'}`);
+  console.log(`  ${c.gray('多引擎对比：')} ${useCompare ? '已启用' : '已禁用'}`);
   console.log(`  ${c.gray('按 Ctrl+C 停止')}\n`);
 
   // Initialize convention store
@@ -166,7 +168,10 @@ module.exports = async function watch(projectRoot, args, ui) {
   // Initial full check
   console.log(`  ${c.gray('正在执行初始检查...')}`);
   const checkCmd = require('./check');
-  await checkCmd(projectRoot, useAI ? ['--ai'] : [], ui);
+  const checkArgs = [];
+  if (useAI) checkArgs.push('--ai');
+  if (useCompare) checkArgs.push('--compare');
+  await checkCmd(projectRoot, checkArgs, ui);
   console.log(`\n  ${c.cyan('开始监控变更...')}`);
 
   // Handle new files being added (watch parent dirs for new entries)