@kunlv/atdc 1.0.0

package/install.sh

@@ -0,0 +1,276 @@
+#!/usr/bin/env bash
+# atdc 安装脚本
+# 用法：bash ~/atdc/install.sh
+# 可重复执行，幂等。
+
+set -e
+
+ATDC_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOME_DIR="$HOME"
+
+echo "atdc 目录：$ATDC_DIR"
+echo "Home 目录：$HOME_DIR"
+echo ""
+
+# ── Step 1：替换 commands/ 下的 {{ATDC_DIR}} 占位符 ──────────────────
+
+echo "Step 1：修正命令文件中的路径..."
+
+if grep -rq '{{ATDC_DIR}}' "$ATDC_DIR/commands" --include="*.md"; then
+  find "$ATDC_DIR/commands" -name "*.md" -type f -exec sed -i '' "s|{{ATDC_DIR}}|$ATDC_DIR|g" {} +
+  echo "  ✓ {{ATDC_DIR}} → $ATDC_DIR"
+else
+  echo "  路径已是最新，无需替换。"
+fi
+
+echo ""
+
+# ── Step 2：创建 memory 目录 ────────────────────────────────────────────────
+
+echo "Step 2：创建 memory 目录..."
+mkdir -p "$HOME_DIR/.atdc/memory"
+echo "  ✓ ~/.atdc/memory/"
+
+echo ""
+
+# ── Step 2.5：检测 RTK ─────────────────────────────────────────────────
+
+echo "Step 2.5：检测 RTK..."
+
+if command -v rtk &>/dev/null; then
+  RTK_VER=$(LC_ALL=C rtk --version 2>/dev/null | head -1)
+  echo "  ✓ RTK 已安装（$RTK_VER）"
+
+  # 检测 OpenCode 插件
+  if [ -f "$HOME_DIR/.config/opencode/plugins/rtk.ts" ]; then
+    echo "  ✓ OpenCode RTK 插件已配置"
+  else
+    echo "  ⚠️  RTK 已安装但 OpenCode 插件未配置，运行：rtk init -g --opencode"
+  fi
+
+  # 检测 Claude Code hook
+  if [ -f "$HOME_DIR/.claude/hooks/rtk-rewrite.sh" ]; then
+    echo "  ✓ Claude Code RTK hook 已配置"
+  else
+    echo "  ⚠️  Claude Code RTK hook 未配置，运行：rtk init -g"
+  fi
+else
+  echo "  ⚠️  RTK 未安装（可选，用于压缩 AI 工具 shell 输出、节省 60-90% token）"
+  echo "  安装方式：brew install rtk && rtk init -g --opencode"
+fi
+
+echo ""
+
+# ── Step 2.6：Migrate old flow-kit symlinks ─────────────────────────────
+
+echo "Step 2.6：检查旧 flow-kit symlink 迁移..."
+
+MIGRATED=0
+
+# Claude Code
+if [ -L "$HOME_DIR/.claude/commands/atd.md" ]; then
+  rm -f "$HOME_DIR/.claude/commands/atd.md"
+  echo "  ✓ 移除旧 symlink ~/.claude/commands/atd.md"
+  MIGRATED=1
+fi
+if [ -L "$HOME_DIR/.claude/commands/atd" ]; then
+  rm -rf "$HOME_DIR/.claude/commands/atd"
+  echo "  ✓ 移除旧 symlink ~/.claude/commands/atd/"
+  MIGRATED=1
+fi
+
+# OpenCode
+if [ -L "$HOME_DIR/.config/opencode/commands/atd.md" ]; then
+  rm -f "$HOME_DIR/.config/opencode/commands/atd.md"
+  echo "  ✓ 移除旧 symlink ~/.config/opencode/commands/atd.md"
+  MIGRATED=1
+fi
+if [ -L "$HOME_DIR/.config/opencode/commands/atd" ]; then
+  rm -rf "$HOME_DIR/.config/opencode/commands/atd"
+  echo "  ✓ 移除旧 symlink ~/.config/opencode/commands/atd/"
+  MIGRATED=1
+fi
+
+# Codex skills
+if [ -d "$HOME_DIR/.agents/skills" ]; then
+  for old in "$HOME_DIR/.agents/skills"/flow "$HOME_DIR/.agents/skills"/flow-*; do
+    if [ -L "$old" ]; then
+      rm -rf "$old"
+      echo "  ✓ 移除旧 symlink $old"
+      MIGRATED=1
+    fi
+  done
+fi
+
+# Memory directory
+if [ -d "$HOME_DIR/.flow-kit/memory" ] && [ ! -d "$HOME_DIR/.atdc/memory" ]; then
+  mkdir -p "$HOME_DIR/.atdc"
+  mv "$HOME_DIR/.flow-kit/memory" "$HOME_DIR/.atdc/memory"
+  echo "  ✓ 迁移 memory: ~/.flow-kit/memory/ → ~/.atdc/memory/"
+  MIGRATED=1
+fi
+
+[ "$MIGRATED" -eq 1 ] && echo "  检测到旧 flow-kit symlink/memory，已自动迁移到 atdc。" || echo "  无旧 symlink，跳过。"
+
+echo ""
+
+# ── Step 3：Claude Code symlinks ────────────────────────────────────────────
+
+echo "Step 3：Claude Code 命令..."
+CLAUDE_CMD="$HOME_DIR/.claude/commands"
+
+if [ ! -d "$CLAUDE_CMD" ]; then
+  echo "  ⚠️  未检测到 Claude Code（~/.claude/commands 不存在），跳过。"
+else
+  mkdir -p "$CLAUDE_CMD"
+
+  # atd.md
+  if [ -L "$CLAUDE_CMD/atd.md" ] || [ -f "$CLAUDE_CMD/atd.md" ]; then
+    rm -f "$CLAUDE_CMD/atd.md"
+  fi
+  ln -s "$ATDC_DIR/commands/claude/atd.md" "$CLAUDE_CMD/atd.md"
+
+  # atd/ 子命令目录
+  if [ -L "$CLAUDE_CMD/atd" ] || [ -d "$CLAUDE_CMD/atd" ]; then
+    rm -rf "$CLAUDE_CMD/atd"
+  fi
+  ln -s "$ATDC_DIR/commands/claude/atd" "$CLAUDE_CMD/atd"
+
+  echo "  ✓ ~/.claude/commands/atd.md → atdc/commands/claude/atd.md"
+  echo "  ✓ ~/.claude/commands/atd/   → atdc/commands/claude/atd/"
+fi
+
+echo ""
+
+# ── Step 4：OpenCode symlinks ───────────────────────────────────────────────
+
+echo "Step 4：OpenCode 命令..."
+OPENCODE_CMD="$HOME_DIR/.config/opencode/commands"
+
+if [ ! -d "$HOME_DIR/.config/opencode" ]; then
+  echo "  ⚠️  未检测到 OpenCode（~/.config/opencode 不存在），跳过。"
+else
+  mkdir -p "$OPENCODE_CMD"
+
+  if [ -L "$OPENCODE_CMD/atd.md" ] || [ -f "$OPENCODE_CMD/atd.md" ]; then
+    rm -f "$OPENCODE_CMD/atd.md"
+  fi
+  ln -s "$ATDC_DIR/commands/opencode/atd.md" "$OPENCODE_CMD/atd.md"
+
+  if [ -L "$OPENCODE_CMD/atd" ] || [ -d "$OPENCODE_CMD/atd" ]; then
+    rm -rf "$OPENCODE_CMD/atd"
+  fi
+  ln -s "$ATDC_DIR/commands/opencode/atd" "$OPENCODE_CMD/atd"
+
+  echo "  ✓ ~/.config/opencode/commands/atd.md → atdc/commands/opencode/atd.md"
+  echo "  ✓ ~/.config/opencode/commands/atd/   → atdc/commands/opencode/atd/"
+fi
+
+echo ""
+
+# ── Step 5：Codex skills symlinks ───────────────────────────────────────────
+
+echo "Step 5：Codex skills..."
+AGENTS_SKILLS="$HOME_DIR/.agents/skills"
+
+if [ ! -d "$HOME_DIR/.agents" ]; then
+  echo "  ⚠️  未检测到 Codex（~/.agents 不存在），跳过。"
+else
+  mkdir -p "$AGENTS_SKILLS"
+
+  for skill in atd atd-1-spec atd-1-update atd-2-qa atd-3-impl atd-3-impl-skip-spec atd-4-verify atd-5-done atd-add-to-hc atd-article atd-compound atd-context atd-health atd-review atd-strategy atd-diagnose atd-grill-with-docs atd-zoom-out atd-handoff atd-git-guardrails atdc-simplifier atd-test-plan atd-table2xlsx atd-xlsx2sql-insert atd-xlsx2sql-update atd-add-command atd-commit atd-travel-planner atd-learn atd-search atd-bugfix atd-analysis-cls-log; do
+    if [ -L "$AGENTS_SKILLS/$skill" ] || [ -d "$AGENTS_SKILLS/$skill" ]; then
+      rm -rf "$AGENTS_SKILLS/$skill"
+    fi
+    ln -s "$ATDC_DIR/commands/codex/$skill" "$AGENTS_SKILLS/$skill"
+    echo "  ✓ ~/.agents/skills/$skill → atdc/commands/codex/$skill"
+  done
+fi
+
+echo ""
+
+# ── Step 6：Cursor skills symlinks ───────────────────────────────────────────
+
+echo "Step 6：Cursor skills..."
+CURSOR_PROJECT_DIR="${1:-$PWD}"
+CURSOR_SKILLS="$CURSOR_PROJECT_DIR/.cursor/skills"
+
+if [ ! -d "$CURSOR_PROJECT_DIR/.cursor" ]; then
+  mkdir -p "$CURSOR_PROJECT_DIR/.cursor"
+fi
+
+if [ -L "$CURSOR_SKILLS" ]; then
+  echo "  ✓ .cursor/skills 已存在"
+elif [ -d "$CURSOR_SKILLS" ]; then
+  echo "  ⚠️  .cursor/skills 已存在（非symlink），跳过"
+else
+  ln -sf "$ATDC_DIR/commands/cursor" "$CURSOR_SKILLS"
+  echo "  ✓ .cursor/skills → atdc/commands/cursor"
+fi
+
+echo ""
+
+# ── Step 7：Git Guardrails hook ───────────────────────────────────────────
+
+echo "Step 6：Git Guardrails..."
+
+if git rev-parse --git-dir > /dev/null 2>&1; then
+  HOOK_PATH="$(git rev-parse --git-dir)/hooks/pre-push"
+
+  if [ -L "$HOOK_PATH" ]; then
+    EXISTING_TARGET=$(readlink "$HOOK_PATH")
+    if [ "$EXISTING_TARGET" = "$ATDC_DIR/hooks/guardrails.sh" ]; then
+      echo "  ✓ git-guardrails 已安装"
+    else
+      echo "  ⚠️  已有其他 pre-push hook ($EXISTING_TARGET)，跳过。手动安装：ln -sf $ATDC_DIR/hooks/guardrails.sh $HOOK_PATH"
+    fi
+  elif [ -f "$HOOK_PATH" ]; then
+    echo "  ⚠️  已有自定义 pre-push hook，跳过。手动合并：参考 $ATDC_DIR/hooks/guardrails.sh"
+  else
+    ln -sf "$ATDC_DIR/hooks/guardrails.sh" "$HOOK_PATH"
+    echo "  ✓ git-guardrails 已安装 → .git/hooks/pre-push"
+  fi
+else
+  echo "  ⚠️  当前目录不是 git 仓库，跳过 hook 安装。进入项目后运行：bash ~/atdc/install.sh"
+fi
+
+echo ""
+
+# ── Step 6：安装 puppeteer（SVG→PNG CJK 渲染） ────────────────────────
+
+echo "Step 6：安装 puppeteer（图表 PNG 导出）..."
+
+if [ -d "$ATDC_DIR/node_modules/puppeteer" ]; then
+  echo "  ✓ puppeteer 已安装"
+else
+  echo "  正在安装 puppeteer（含 Chromium，约 300MB，首次较慢）..."
+  cd "$ATDC_DIR"
+  npm install puppeteer --save 2>&1 | tail -1
+  echo "  ✓ puppeteer 安装完成"
+fi
+
+echo ""
+echo "✅ atdc 安装完成！"
+echo ""
+echo "三端触发方式："
+echo "  Claude Code  /atd:1-spec <需求>"
+echo "  OpenCode     /atd:1-spec <需求>"
+echo "  Codex        atd:1-spec <需求>"
+echo ""
+echo "横向命令："
+echo "  /atd:diagnose       结构化调试（复现→最小化→假设→插桩→修复→回归）"
+echo "  /atd:grill-with-docs 深度拷问 + 更新 CONTEXT.md + 生成 ADR"
+echo "  /atd:zoom-out        代码全景分析（定位、数据流、影响面）"
+echo "  /atd:handoff          会话交接文档生成"
+echo "  /atd:git-guardrails   Git 安全防护（已自动安装）"
+echo ""
+echo "Token 压缩（推荐）：rtk init -g --opencode"
+echo ""
+echo "代码搜索（推荐）："
+if command -v semble &>/dev/null; then
+  echo "  ✓ Semble 已安装（代码语义搜索引擎，省 98% Token vs grep）"
+else
+  echo "  💡 推荐安装 Semble 代码搜索引擎："
+  echo "     uv tool install semble && semble install --agent opencode --type mcp --yes"
+  echo "     安装后可使用 /atd:search 快速搜索代码"
+fi

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@kunlv/atdc",
+  "version": "1.0.0",
+  "description": "AI coding workflow orchestration kit — team edition",
+  "bin": {
+    "atdc": "bin/atdc.js",
+    "cls": "packages/cls/bin/cls.js"
+  },
+  "files": [
+    "bin/", "src/", "hooks/", "prompts/", "templates/",
+    "central/", "scripts/", "config/", "packages/cls/",
+    "GO.md", "install.sh", "commands/", "AGENTS.md", "reference/"
+  ],
+  "scripts": {
+    "postinstall": "echo '📋 atdc 已安装。运行: atdc install --all'"
+  },
+  "keywords": ["ai", "workflow", "coding", "spec-driven"],
+  "license": "MIT",
+  "engines": { "node": ">=16" }
+}

package/packages/cls/bin/cls.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+'use strict';
+
+const client = require('../src/client');
+
+const HELP = `cls — CLS 日志查询 CLI
+
+用法:
+  cls --init                          初始化配置文件
+  cls --list-accounts                 列出可用账号
+  cls <account> <query> [options]     查询 CLS 日志
+
+选项:
+  --limit N        返回条数（默认 200，最大 1000）
+  --out DIR        输出目录（默认当前目录）
+  --from TIME      开始时间（默认 15m 前，支持 "2026-07-17 10:00"）
+  --to TIME        结束时间（默认当前）
+  --type TYPE      topic 类型（默认 error）
+  --regions R      地域（默认 gz,bj）
+  --format FORMAT  输出格式 json|jsonl（默认 jsonl）
+  --fetch          全量落地（调 cls_fetch_bulk.py）
+  --max N          全量最大条数（默认 5000）
+  --quiet          静默模式（不输出进度）
+  --help           显示此帮助
+
+示例:
+  cls tcs "callTencentMusicAPI AND done"
+  cls tcs "order AND pay*" --limit 500 --out /tmp/logs/
+  cls tcs "order AND pay*" --fetch --max 10000`;
+
+function usage() {
+  console.log(HELP);
+  process.exit(0);
+}
+
+function fail(msg) {
+  console.error(`cls: ${msg}`);
+  process.exit(1);
+}
+
+const args = process.argv.slice(2);
+
+let emptyConfig = false;
+try {
+  const cfg = client.loadConfig();
+  if (!cfg.skill_dir || Object.keys(cfg.accounts).length === 0) emptyConfig = true;
+} catch (e) {
+  emptyConfig = true;
+}
+if (emptyConfig && args[0] !== '--init' && args[0] !== '--help') {
+  const msg = '🔧 首次运行，请完成配置:\n\n  cls --init\n\n  按提示输入:\n    1. cls-log-query 所在目录\n    2. 账号（别名=凭证名=项目ID）\n    3. SecretId（可选）\n    4. SecretKey（可选）\n';
+  require('fs').writeSync(1, msg);
+  process.exit(0);
+}
+
+if (args.length === 0 || args.includes('--help')) {
+  if (args.length === 0) {
+    try { client.loadConfig(); } catch { client.initConfig(); console.log('配置已生成: ~/.cls/config.json'); process.exit(0); }
+  }
+  usage();
+}
+
+if (args[0] === '--init') {
+  const fs = require('fs'), path = require('path'), os = require('os');
+  let tty;
+  try { tty = fs.openSync('/dev/tty', 'r'); } catch (e) {
+    console.error('❌ 当前终端不支持交互输入。\n  手动创建 ~/.cls/config.json：\n  https://www.npmjs.com/package/cls-log-cli');
+    process.exit(1);
+  }
+  const buf = Buffer.alloc(1024);
+  function prompt(q) {
+    process.stdout.write(q);
+    let data = '';
+    while (true) {
+      const n = fs.readSync(tty, buf, 0, buf.length, null);
+      data += buf.toString('utf8', 0, n);
+      if (data.includes('\n')) return data.split('\n')[0].trim();
+    }
+  }
+  process.stdout.write('\n📋 cls-log-cli 初始化配置\n\n');
+  const skillDir = prompt('cls-log-query 所在目录: ');
+  if (!skillDir) { console.error('❌ 必须填写'); process.exit(1); }
+  const resolved = skillDir.replace(/^~/, os.homedir());
+  if (!fs.existsSync(resolved)) { console.error(`❌ 目录不存在: ${resolved}`); process.exit(1); }
+  const entry = prompt('账号（别名=凭证名=项目ID）: ');
+  const parts = entry.split('=');
+  if (parts.length !== 3) { console.error('❌ 格式: 别名=凭证名=项目ID'); process.exit(1); }
+  const sid = prompt('SecretId (留空跳过): ');
+  const skey = prompt('SecretKey (留空跳过): ');
+  fs.closeSync(tty);
+
+  const dir = path.join(os.homedir(), '.cls');
+  fs.mkdirSync(dir, { recursive: true });
+  const config = { skill_dir: resolved, python: 'python3', accounts: { [parts[0]]: { account: parts[1], project_id: parts[2] } }, defaults: { limit: 200, out_dir: '~/.cls/logs', topic_type: 'error', regions: 'gz,bj', time_range: '15m' }, output: { format: 'jsonl', filename: '{account}_{query}_{ts}-{suffix}.jsonl' } };
+  fs.writeFileSync(path.join(dir, 'config.json'), JSON.stringify(config, null, 2) + '\n');
+  if (sid && skey) {
+    fs.writeFileSync(path.join(dir, 'credentials.json'), JSON.stringify({ [parts[1]]: { secret_id: sid, secret_key: skey, project_ids: [parts[2]] } }, null, 2) + '\n');
+    fs.chmodSync(path.join(dir, 'credentials.json'), 0o600);
+  }
+  process.stdout.write('\n✅ ~/.cls/ 配置完成\n\n');
+  process.exit(0);
+}
+
+if (args[0] === '--list-accounts') {
+  try {
+    const accounts = client.listAccounts();
+    console.log('可用账号:');
+    Object.entries(accounts).forEach(([alias, name]) => console.log(`  ${alias} → ${name}`));
+  } catch (e) { fail(e.message); }
+  process.exit(0);
+}
+
+const [account, query] = args;
+if (!account || !query) fail('用法: cls <account> <query> [options]');
+
+const opts = {};
+for (let i = 2; i < args.length; i++) {
+  const a = args[i];
+  if (a === '--limit') opts.limit = parseInt(args[++i]);
+  else if (a === '--out') opts.out_dir = args[++i];
+  else if (a === '--from') opts.from = args[++i];
+  else if (a === '--to') opts.to = args[++i];
+  else if (a === '--type') opts.type = args[++i];
+  else if (a === '--regions') opts.regions = args[++i];
+  else if (a === '--format') opts.format = args[++i];
+  else if (a === '--max') opts.max = parseInt(args[++i]);
+  else if (a === '--fetch') opts.fetch = true;
+  else if (a === '--quiet') opts.quiet = true;
+}
+
+try {
+  if (opts.fetch) {
+    const result = client.fetchSync(account, query, opts);
+    console.log(`→ ${result.output_file} (${result.total} 条)`);
+  } else {
+    const result = client.searchSync(account, query, opts);
+    console.log(`→ ${result.output_file} (${result.count} 条)`);
+  }
+} catch (e) {
+  if (e.message && e.message.includes('配置文件') && e.message.includes('不存在')) {
+    client.initConfig();
+    console.log('配置已生成: ~/.cls/config.json，请重试命令');
+  } else {
+    fail(e.stderr || e.message);
+  }
+}

package/packages/cls/config/defaults.json

@@ -0,0 +1,17 @@
+{
+  "_comment": "模板文件，安装时 postinstall 脚本会自动生成 ~/.cls/config.json",
+  "skill_dir": "",
+  "python": "python3",
+  "accounts": {},
+  "defaults": {
+    "limit": 200,
+    "out_dir": "~/.cls/logs",
+    "topic_type": "error",
+    "regions": "gz,bj",
+    "time_range": "15m"
+  },
+  "output": {
+    "format": "jsonl",
+    "filename": "{account}_{query}_{ts}-{suffix}.jsonl"
+  }
+}

package/packages/cls/mcp/server.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+'use strict';
+
+const readline = require('readline');
+const client = require('../src/client');
+
+const TOOLS = [
+  {
+    name: 'cls_search',
+    description: '搜索 CLS 日志并落地到文件。返回输出文件路径、结果数量和样本日志。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        account: { type: 'string', description: '账号别名（如 tcs）' },
+        query: { type: 'string', description: 'CLS 查询语句' },
+        limit: { type: 'number', description: '返回条数（默认 200）' },
+        out_dir: { type: 'string', description: '输出目录（默认当前）' },
+        from: { type: 'string', description: '开始时间（默认 15m 前）' },
+        to: { type: 'string', description: '结束时间（默认 现在）' },
+        type: { type: 'string', description: 'topic 类型（默认 error）' },
+        regions: { type: 'string', description: '地域（默认 gz,bj）' },
+      },
+      required: ['account', 'query'],
+    },
+  },
+  {
+    name: 'cls_fetch',
+    description: '全量落地 CLS 日志到本地 jsonl 文件。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        account: { type: 'string', description: '账号别名' },
+        query: { type: 'string', description: 'CLS 查询语句' },
+        max: { type: 'number', description: '最大条数（默认 5000）' },
+        out_dir: { type: 'string', description: '输出目录' },
+        from: { type: 'string', description: '开始时间' },
+        to: { type: 'string', description: '结束时间' },
+      },
+      required: ['account', 'query'],
+    },
+  },
+  {
+    name: 'cls_histogram',
+    description: '查看 CLS 日志量时间分布（直方图）。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        account: { type: 'string', description: '账号别名' },
+        query: { type: 'string', description: 'CLS 查询语句' },
+        from: { type: 'string', description: '开始时间（必填）' },
+        to: { type: 'string', description: '结束时间（必填）' },
+        interval: { type: 'string', description: '时间桶间隔（默认 30m）' },
+      },
+      required: ['account', 'query', 'from', 'to'],
+    },
+  },
+  {
+    name: 'cls_context',
+    description: '拉取某条日志的前后上下文。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        account: { type: 'string', description: '账号别名' },
+        pkg_id: { type: 'string', description: '日志 PkgId' },
+        pkg_log_id: { type: 'number', description: '日志 PkgLogId' },
+        time: { type: 'string', description: '日志时间（毫秒时间戳）' },
+        prev: { type: 'number', description: '往前 N 条（默认 10）' },
+        next: { type: 'number', description: '往后 N 条（默认 10）' },
+      },
+      required: ['account', 'pkg_id', 'pkg_log_id', 'time'],
+    },
+  },
+  {
+    name: 'cls_list_accounts',
+    description: '列出可用账号别名及其映射。',
+    inputSchema: { type: 'object', properties: {} },
+  },
+];
+
+function send(id, result) {
+  process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id, result }) + '\n');
+}
+
+function sendError(id, code, message) {
+  process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id, error: { code, message } }) + '\n');
+}
+
+async function handleCall(id, name, args) {
+  try {
+    switch (name) {
+      case 'cls_search': {
+        const r = await client.searchAsync(args.account, args.query, { ...args, quiet: true });
+        send(id, { content: [{ type: 'text', text: JSON.stringify(r, null, 2) }] });
+        break;
+      }
+      case 'cls_fetch': {
+        const r = await client.fetchAsync(args.account, args.query, args);
+        send(id, { content: [{ type: 'text', text: JSON.stringify(r, null, 2) }] });
+        break;
+      }
+      case 'cls_histogram':
+      case 'cls_context': {
+        send(id, { content: [{ type: 'text', text: JSON.stringify({ note: `${name} 模式待实现，请直接用 CLI: cls ${args.account} "${args.query}" --histogram/--context` }) }] });
+        break;
+      }
+      case 'cls_list_accounts': {
+        const accounts = client.listAccounts();
+        send(id, { content: [{ type: 'text', text: JSON.stringify(accounts, null, 2) }] });
+        break;
+      }
+      default:
+        sendError(id, -32601, `Unknown tool: ${name}`);
+    }
+  } catch (e) {
+    sendError(id, -32000, e.message);
+  }
+}
+
+const rl = readline.createInterface({ input: process.stdin });
+rl.on('line', line => {
+  try {
+    const msg = JSON.parse(line);
+    const { id, method, params } = msg;
+    if (method === 'initialize') {
+      send(id, {
+        protocolVersion: '2024-11-05',
+        capabilities: { tools: {} },
+        serverInfo: { name: 'cls-mcp-server', version: '1.0.0' },
+      });
+    } else if (method === 'tools/list') {
+      send(id, { tools: TOOLS });
+    } else if (method === 'tools/call') {
+      handleCall(id, params.name, params.arguments || {});
+    } else if (method === 'notifications/initialized') {
+      // no response needed
+    } else {
+      sendError(id, -32601, `Unknown method: ${method}`);
+    }
+  } catch (e) {
+    sendError(null, -32700, `Parse error: ${e.message}`);
+  }
+});

package/packages/cls/package.json

@@ -0,0 +1,29 @@
+{
+"name": "cls-log-cli",
+"version": "1.2.6",
+  "description": "一行命令查腾讯云 CLS 日志 — CLI + MCP Server",
+  "bin": {
+    "cls": "bin/cls.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "mcp/",
+    "config/",
+    "scripts/"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "keywords": [
+    "cls",
+    "tencent-cloud",
+    "log",
+    "cli",
+    "mcp"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=16"
+  }
+}

package/packages/cls/scripts/postinstall.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CONFIG_DIR = path.join(os.homedir(), '.cls');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+if (fs.existsSync(CONFIG_FILE)) {
+  process.exit(0);
+}
+
+const config = { skill_dir: '', python: 'python3', accounts: {}, defaults: { limit: 200, out_dir: '~/.cls/logs', topic_type: 'error', regions: 'gz,bj', time_range: '15m' }, output: { format: 'jsonl', filename: '{account}_{query}_{ts}-{suffix}.jsonl' } };
+fs.mkdirSync(CONFIG_DIR, { recursive: true });
+fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n');
+
+console.log('\n📋 cls-log-cli 已安装。输入 cls 自动进入配置向导。\n');