@optima-chat/dev-skills 0.8.1 → 0.8.2

package/.claude/commands/logs.md

@@ -50,7 +50,8 @@
   - `ci` - CI 持续集成环境（开发环境，默认）
   - `stage` - Stage 预发布环境（ECS Fargate）
   - `prod` - 生产环境（ECS Fargate）
-  - `cn-prod`（别名 `cn`）- 阿里云 cn-prod 环境（SAE，cn-beijing，经 buildbox 取日志）
+  - `cn-prod`（别名 `cn`）- 阿里云 cn-prod 环境（SAE，cn-beijing，`optima-logs` 直连 SLS）
+  - `cn-stage` - 阿里云 cn-stage 预发环境（SAE，cn-beijing，`optima-logs` 直连 SLS）
 
 ## 示例
 
@@ -72,7 +73,7 @@
 - `ci` 或未指定 → 使用 SSH + Docker Compose（第 0 节，默认）
 - `stage` → 使用 AWS CloudWatch Logs - ECS（第 1 节）
 - `prod` → 使用 AWS CloudWatch Logs - ECS（第 2 节）
-- `cn-prod` / `cn` → 阿里云 SAE，经 buildbox 调 `DescribeInstanceLog`（第 3 节）
+- `cn-prod` / `cn` / `cn-stage` → 阿里云 SLS，`optima-logs` 直连（第 3 节，免 buildbox）
 
 ### 0. CI 环境（environment = "ci" 或默认）
 
@@ -211,59 +212,38 @@ aws logs get-log-events --log-group-name /ecs/commerce-backend-prod --log-stream
 
 **注意**: `optima-store` 仅在 Stage 环境部署
 
-### 3. cn-prod 环境（environment = "cn-prod" 或 "cn"）
+### 3. cn-prod / cn-stage 环境（environment = "cn-prod"/"cn" 或 "cn-stage"）
 
-**部署方式**: 阿里云 **SAE**（Serverless App Engine，cn-beijing），不是 ECS/CloudWatch。
-**访问方式**: 经 buildbox（`root@47.94.105.163`，唯一装了 `aliyun-optima` profile + VPC 可达的机器）调 SAE OpenAPI。
+**部署方式**: 阿里云 **SAE**（cn-beijing），不是 ECS/CloudWatch。
+**访问方式**: ✅ **用 `optima-logs` CLI 直连阿里云 SLS**，不再经 buildbox。
 
-> ⚠️ SAE **未配 SLS**，stdout 日志只能用 `DescribeInstanceLog` 取实例**当前缓冲**（非历史检索；重启/滚动后旧日志丢）。要历史检索需给 SAE 配 SLS。
+> ✅ 现状更新（2026-06-16）：cn-prod / cn-stage 全部服务**已接 SLS**（含 ECI 的 `agent-runtime`）。
+> SLS `GetLogs` 是公网控制面 API，本机 `aliyun-optima` profile 直连即可，支持**历史检索 + 时间窗 + 关键词**——
+> 旧的「SSH buildbox → SAE `DescribeInstanceLog` 取当前缓冲」流程已弃用（缓冲式、重启即丢、不能检索）。
 
-**日志链**: service → AppId → GroupId → InstanceId → `DescribeInstanceLog`
-
-**关键坑**（实测）:
-- API 是 RPC-style `aliyun sae DescribeInstanceLog`，ROA 路径是 `/pop/v1/sam/**instance**/describeInstanceLog`（不是 `/sam/app/...`，写错报 "can not find api by path"）。
-- buildbox 密码在 1P `op://Optima/gdmixcizjci5bvuu3nuvgg4ooe/password`（标题带括号必须用 item ID）。
-
-**service → AppId 映射**（cn-prod，2026-06-01；新增/变动用 `aliyun sae ListApplications` 重查）:
+**推荐用法（首选）**:
+```bash
+optima-logs gateway-core                       # 默认 cn-prod，最近 1h，100 行
+optima-logs gateway-core --env cn-stage
+optima-logs agent-runtime --env cn-prod --since 2h   # ECI 容器也直接可见
+optima-logs user-auth --grep error -n 200
+optima-logs gateway-core --since 30m --json | jq .   # 机器可读
+```
 
-| service | AppId |
-|---|---|
-| `gateway-core` | `a08ce23f-3d3e-4d89-a2cf-53c8adba614e` |
-| `agentic-chat` | `6e290c73-a646-43ef-9da5-ad0b2e7eff73` |
-| `gw-admin` | `c6bc5a78-b27f-46e2-825a-eaa338c23645` |
-| `user-auth` | `d6fbf9de-fed6-4165-978f-7b3a0a456acc` |
-| `user-auth-admin` | `54093f99-37bf-4354-abd7-f6e76abdbcb6` |
-| `optima-scout` | `f5bb7e82-e57c-4bd4-83ae-2c25f8d38647` |
-| `optima-skills` | `55a63ee7-fb75-46e4-99f3-20854a699237` |
-| `infisical` | `52b33fc6-b26d-495a-8885-225d38b3d42f` |
+参数：`--env stage|prod|cn-prod|cn-stage`、`--since 30m|2h|1d`、`--grep <kw>`、`--lines/-n <N>`、`--json`。
+`service` == SLS logstore 名（同名）。列全部 logstore：
+`aliyun sls ListLogStores --project optima-cn-prod-1911493506120573 --region cn-beijing --profile aliyun-optima`
 
-**完整脚本**（本地跑、经 buildbox 中转；改 `SERVICE`/`LINES`）:
+**底层（仅参考，正常用 `optima-logs` 即可）**:
+- SLS project：`optima-cn-prod-1911493506120573` / `optima-cn-stage-1911493506120573`（`optima-<env>-<accountId>`）。
+- logstore = service 名；日志正文在 `content` 字段。
 ```bash
-SERVICE=gateway-core; LINES=80
-BBPW=$(op-win read "op://Optima/gdmixcizjci5bvuu3nuvgg4ooe/password")
-declare -A APPID=(
-  [gateway-core]=a08ce23f-3d3e-4d89-a2cf-53c8adba614e
-  [agentic-chat]=6e290c73-a646-43ef-9da5-ad0b2e7eff73
-  [gw-admin]=c6bc5a78-b27f-46e2-825a-eaa338c23645
-  [user-auth]=d6fbf9de-fed6-4165-978f-7b3a0a456acc
-  [user-auth-admin]=54093f99-37bf-4354-abd7-f6e76abdbcb6
-  [optima-scout]=f5bb7e82-e57c-4bd4-83ae-2c25f8d38647
-  [optima-skills]=55a63ee7-fb75-46e4-99f3-20854a699237
-  [infisical]=52b33fc6-b26d-495a-8885-225d38b3d42f )
-AID=${APPID[$SERVICE]}
-sshpass -p "$BBPW" ssh -o StrictHostKeyChecking=no root@47.94.105.163 "bash -s" <<REMOTE | tail -n $LINES
-P="--region cn-beijing --profile aliyun-optima"
-GID=\$(aliyun sae GET /pop/v1/sam/app/describeApplicationGroups --AppId $AID \$P 2>/dev/null | python3 -c "import sys,json;print(json.load(sys.stdin)['Data'][0]['GroupId'])")
-IID=\$(aliyun sae GET /pop/v1/sam/app/describeApplicationInstances --AppId $AID --GroupId \$GID \$P 2>/dev/null | python3 -c "import sys,json;d=json.load(sys.stdin)['Data'];print((d if isinstance(d,list) else d['Instances'])[0]['InstanceId'])")
-aliyun sae DescribeInstanceLog --InstanceId "\$IID" \$P 2>/dev/null | python3 -c "import sys,json;print(json.load(sys.stdin).get('Data',''))"
-REMOTE
+NOW=$(date +%s); FROM=$((NOW-3600))
+aliyun sls GetLogs --project optima-cn-prod-1911493506120573 --logstore gateway-core \
+  --from $FROM --to $NOW --line 100 --reverse true --query error \
+  --region cn-beijing --profile aliyun-optima
 ```
 
-**局限 / 提示**:
-- 只取第 1 个 InstanceId；多副本要遍历 `Data` 里全部 instance。
-- `agent-runtime` 不在 SAE（是 ECI 动态容器）——它的日志看 `gateway-core` 里 `eci-bridge` 的转发/错误行，或单独查对应 ECI。
-- 过滤：把上面输出 `| grep -iE 'error|eci|fail'` 即可（例：排 agentic-chat 链路 ECI 失败就 grep `gateway-core` 日志的 `eci-bridge`）。
-
 ## 完整示例脚本
 
 ### Stage 环境

package/bin/cli.js

@@ -36,7 +36,7 @@ switch (command) {
     log('  optima-generate-test-token [--env production]        Generate test token', 'cyan');
     log('  optima-grant-balance <email> --amount <usd> [--env]  Grant USD wallet balance', 'cyan');
     log('  optima-grant-subscription <email|phone|userId> --plan <p> [--env] Grant subscription', 'cyan');
-    log('  /logs <service> [lines] [env]                        View service logs (skill)', 'cyan');
+    log('  optima-logs <service> [--env] [--since] [--grep] [-n]  View logs (cn=SLS 直连/aws=CloudWatch)', 'cyan');
     log('  /restart-ecs <service> [env]                         Restart ECS service (skill)', 'cyan');
 
     log('\nSupported Services:', 'yellow');

package/bin/helpers/logs.ts

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+/**
+ * optima-logs —— 一条命令直取服务日志,四环境统一,用 --env 区分。
+ *
+ *   stage / prod     : AWS CloudWatch(`aws logs tail /ecs/<svc>-<env>`)
+ *   cn-prod / cn-stage: 阿里云 SLS 直连(`aliyun sls GetLogs`)
+ *
+ * cn 的关键改进:旧流程要 SSH 进 buildbox 再调 SAE `DescribeInstanceLog`,
+ * 只能看实例**当前缓冲**(重启即丢、不能检索)。现在 cn-prod/cn-stage 全部
+ * 服务已接 SLS,GetLogs 是公网控制面 API,本机 `aliyun-optima` profile 直连即可:
+ *   - 免 buildbox 跳板
+ *   - 支持时间窗(--since)+ 关键词检索(--grep)+ 历史(重启不丢)
+ *
+ * 前置:
+ *   AWS  → 已配 aws CLI 凭证(ap-southeast-1)
+ *   cn   → 已配 aliyun CLI profile `aliyun-optima`(cn-beijing)
+ *
+ * 用法:
+ *   optima-logs gateway-core                       # 默认 cn-prod,最近 1h,100 行
+ *   optima-logs gateway-core --env cn-stage
+ *   optima-logs user-auth --env prod --since 2h
+ *   optima-logs commerce-backend --grep error -n 200
+ *   optima-logs gateway-core --since 30m --json     # 机器可读
+ *
+ * service == SLS logstore == AWS 日志组 `/ecs/<svc>-<env>` 的 <svc>(同名)。
+ */
+import { execFileSync } from 'child_process';
+
+const ALIYUN_ACCOUNT = '1911493506120573';
+const ALIYUN_PROFILE = 'aliyun-optima';
+const ALIYUN_REGION = 'cn-beijing';
+const AWS_REGION = 'ap-southeast-1';
+
+const AWS_ENVS = ['stage', 'prod'] as const;
+const CN_ENVS = ['cn-prod', 'cn-stage'] as const;
+type Env = (typeof AWS_ENVS)[number] | (typeof CN_ENVS)[number];
+const ALL_ENVS: Env[] = [...AWS_ENVS, ...CN_ENVS];
+
+const C = { g: '\x1b[32m', y: '\x1b[33m', b: '\x1b[34m', d: '\x1b[2m', n: '\x1b[0m' };
+
+interface Args {
+  service: string;
+  env: Env;
+  lines: number;
+  since: string; // 原样字符串,如 1h / 30m / 2d
+  grep?: string;
+  json: boolean;
+}
+
+const HELP = `Usage: optima-logs <service> [options]
+
+四环境统一查日志,cn 直连阿里云 SLS(免 buildbox),AWS 走 CloudWatch。
+
+Required:
+  <service>                服务名(== SLS logstore == /ecs/<svc>-<env> 的 <svc>)
+
+Optional:
+  --env <e>                stage | prod | cn-prod | cn-stage   (default: cn-prod)
+  --lines, -n <N>          返回行数                            (default: 100)
+  --since <dur>            时间窗,如 30m / 2h / 1d / 3600(秒)  (default: 1h)
+  --grep <kw>              关键词检索(cn=SLS query / aws=filter-pattern)
+  --json                   原始 JSON 输出(接管道)
+  --help, -h               显示本帮助
+
+Examples:
+  optima-logs gateway-core
+  optima-logs user-auth --env prod --since 2h
+  optima-logs commerce-backend --env cn-prod --grep error -n 200`;
+
+/** 把 30m / 2h / 1d / 纯秒 解析成秒数;同时回填给 aws 用的带单位字符串。 */
+function parseSince(raw: string): { sec: number; awsStr: string } {
+  const m = raw.match(/^(\d+)([smhdw]?)$/);
+  if (!m) throw new Error(`--since 格式非法: ${raw}(用 30m / 2h / 1d / 纯秒)`);
+  const n = parseInt(m[1], 10);
+  const unit = m[2] || 's';
+  const mult: Record<string, number> = { s: 1, m: 60, h: 3600, d: 86400, w: 604800 };
+  return { sec: n * mult[unit], awsStr: `${n}${unit}` };
+}
+
+function parseArgs(argv: string[]): Args {
+  if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
+    console.log(HELP);
+    process.exit(0);
+  }
+  const out: Partial<Args> = { env: 'cn-prod', lines: 100, since: '1h', json: false };
+  const positional: string[] = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    const next = argv[i + 1];
+    switch (a) {
+      case '--env': out.env = next as Env; i++; break;
+      case '--lines': case '-n': {
+        const v = parseInt(next, 10);
+        if (isNaN(v) || v <= 0) throw new Error('--lines 需要正整数');
+        out.lines = v; i++; break;
+      }
+      case '--since': out.since = next; i++; break;
+      case '--grep': out.grep = next; i++; break;
+      case '--json': out.json = true; break;
+      default:
+        if (a.startsWith('-')) throw new Error(`未知参数: ${a}`);
+        positional.push(a);
+    }
+  }
+  if (positional.length === 0) throw new Error('缺少 <service>(见 --help)');
+  if (positional.length > 1) throw new Error(`多余参数: ${positional.slice(1).join(' ')}`);
+  out.service = positional[0];
+  if (!ALL_ENVS.includes(out.env as Env)) {
+    throw new Error(`--env 非法: ${out.env}(可选 ${ALL_ENVS.join(' | ')})`);
+  }
+  return out as Args;
+}
+
+function run(cmd: string, args: string[]): string {
+  return execFileSync(cmd, args, { encoding: 'utf-8', maxBuffer: 128 * 1024 * 1024 });
+}
+
+/** AWS CloudWatch:aws logs tail /ecs/<svc>-<env>。 */
+function fetchAws(args: Args): void {
+  const group = `/ecs/${args.service}-${args.env}`;
+  const { awsStr } = parseSince(args.since);
+  const cmd = ['logs', 'tail', group, '--since', awsStr, '--region', AWS_REGION, '--format', args.json ? 'json' : 'short'];
+  if (args.grep) cmd.push('--filter-pattern', args.grep);
+  process.stderr.write(`${C.d}# AWS CloudWatch ${group} (since ${awsStr}${args.grep ? `, grep "${args.grep}"` : ''})${C.n}\n`);
+  try {
+    process.stdout.write(run('aws', cmd));
+  } catch (e: any) {
+    if (/ResourceNotFoundException/.test(e.stderr || e.message || '')) {
+      throw new Error(`日志组不存在: ${group}\n  确认服务名/环境对,或该服务未部署在 ${args.env}。`);
+    }
+    throw new Error(e.stderr || e.message);
+  }
+}
+
+/** 阿里云 SLS:aliyun sls GetLogs,project=optima-<env>-<account>,logstore=service。 */
+function fetchCn(args: Args): void {
+  const project = `optima-${args.env}-${ALIYUN_ACCOUNT}`;
+  const { sec } = parseSince(args.since);
+  const now = Math.floor(Date.now() / 1000);
+  const from = now - sec;
+  const cmd = [
+    'sls', 'GetLogs',
+    '--project', project,
+    '--logstore', args.service,
+    '--from', String(from),
+    '--to', String(now),
+    '--line', String(args.lines),
+    '--reverse', 'true', // 先拿最新 N 条
+    '--region', ALIYUN_REGION,
+    '--profile', ALIYUN_PROFILE,
+  ];
+  if (args.grep) { cmd.push('--query', args.grep); }
+  process.stderr.write(`${C.d}# 阿里云 SLS ${project}/${args.service} (since ${args.since}${args.grep ? `, query "${args.grep}"` : ''})${C.n}\n`);
+
+  let raw: string;
+  try {
+    raw = run('aliyun', cmd);
+  } catch (e: any) {
+    const msg = e.stderr || e.message || '';
+    if (/LogStoreNotExist|ProjectNotExist/.test(msg)) {
+      throw new Error(`SLS logstore 不存在: ${project}/${args.service}\n  确认服务名对,或该服务未接 SLS。列全部:\n  aliyun sls ListLogStores --project ${project} --region ${ALIYUN_REGION} --profile ${ALIYUN_PROFILE}`);
+    }
+    throw new Error(msg);
+  }
+
+  const rows: Array<Record<string, string>> = JSON.parse(raw || '[]');
+  // reverse=true 取到的是新→旧,翻回旧→新便于阅读
+  rows.reverse();
+  if (args.json) {
+    console.log(JSON.stringify(rows, null, 2));
+    return;
+  }
+  if (rows.length === 0) {
+    process.stderr.write(`${C.y}(无日志:该时间窗内 ${args.service} 无输出,或 --grep 没命中)${C.n}\n`);
+    return;
+  }
+  for (const r of rows) {
+    // SLS 存的 content 已含容器时间戳 + stream(stdout/stderr)前缀,直接打印即可
+    process.stdout.write((r.content ?? JSON.stringify(r)) + '\n');
+  }
+}
+
+function main(): void {
+  let args: Args;
+  try {
+    args = parseArgs(process.argv.slice(2));
+  } catch (e: any) {
+    console.error(`${C.y}✗ ${e.message}${C.n}`);
+    process.exit(1);
+  }
+  try {
+    if (CN_ENVS.includes(args.env as any)) fetchCn(args);
+    else fetchAws(args);
+  } catch (e: any) {
+    console.error(`${C.y}✗ ${e.message}${C.n}`);
+    process.exit(1);
+  }
+}
+
+main();

package/dist/bin/helpers/logs.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * optima-logs —— 一条命令直取服务日志,四环境统一,用 --env 区分。
+ *
+ *   stage / prod     : AWS CloudWatch(`aws logs tail /ecs/<svc>-<env>`)
+ *   cn-prod / cn-stage: 阿里云 SLS 直连(`aliyun sls GetLogs`)
+ *
+ * cn 的关键改进:旧流程要 SSH 进 buildbox 再调 SAE `DescribeInstanceLog`,
+ * 只能看实例**当前缓冲**(重启即丢、不能检索)。现在 cn-prod/cn-stage 全部
+ * 服务已接 SLS,GetLogs 是公网控制面 API,本机 `aliyun-optima` profile 直连即可:
+ *   - 免 buildbox 跳板
+ *   - 支持时间窗(--since)+ 关键词检索(--grep)+ 历史(重启不丢)
+ *
+ * 前置:
+ *   AWS  → 已配 aws CLI 凭证(ap-southeast-1)
+ *   cn   → 已配 aliyun CLI profile `aliyun-optima`(cn-beijing)
+ *
+ * 用法:
+ *   optima-logs gateway-core                       # 默认 cn-prod,最近 1h,100 行
+ *   optima-logs gateway-core --env cn-stage
+ *   optima-logs user-auth --env prod --since 2h
+ *   optima-logs commerce-backend --grep error -n 200
+ *   optima-logs gateway-core --since 30m --json     # 机器可读
+ *
+ * service == SLS logstore == AWS 日志组 `/ecs/<svc>-<env>` 的 <svc>(同名)。
+ */
+const child_process_1 = require("child_process");
+const ALIYUN_ACCOUNT = '1911493506120573';
+const ALIYUN_PROFILE = 'aliyun-optima';
+const ALIYUN_REGION = 'cn-beijing';
+const AWS_REGION = 'ap-southeast-1';
+const AWS_ENVS = ['stage', 'prod'];
+const CN_ENVS = ['cn-prod', 'cn-stage'];
+const ALL_ENVS = [...AWS_ENVS, ...CN_ENVS];
+const C = { g: '\x1b[32m', y: '\x1b[33m', b: '\x1b[34m', d: '\x1b[2m', n: '\x1b[0m' };
+const HELP = `Usage: optima-logs <service> [options]
+
+四环境统一查日志,cn 直连阿里云 SLS(免 buildbox),AWS 走 CloudWatch。
+
+Required:
+  <service>                服务名(== SLS logstore == /ecs/<svc>-<env> 的 <svc>)
+
+Optional:
+  --env <e>                stage | prod | cn-prod | cn-stage   (default: cn-prod)
+  --lines, -n <N>          返回行数                            (default: 100)
+  --since <dur>            时间窗,如 30m / 2h / 1d / 3600(秒)  (default: 1h)
+  --grep <kw>              关键词检索(cn=SLS query / aws=filter-pattern)
+  --json                   原始 JSON 输出(接管道)
+  --help, -h               显示本帮助
+
+Examples:
+  optima-logs gateway-core
+  optima-logs user-auth --env prod --since 2h
+  optima-logs commerce-backend --env cn-prod --grep error -n 200`;
+/** 把 30m / 2h / 1d / 纯秒 解析成秒数;同时回填给 aws 用的带单位字符串。 */
+function parseSince(raw) {
+    const m = raw.match(/^(\d+)([smhdw]?)$/);
+    if (!m)
+        throw new Error(`--since 格式非法: ${raw}(用 30m / 2h / 1d / 纯秒)`);
+    const n = parseInt(m[1], 10);
+    const unit = m[2] || 's';
+    const mult = { s: 1, m: 60, h: 3600, d: 86400, w: 604800 };
+    return { sec: n * mult[unit], awsStr: `${n}${unit}` };
+}
+function parseArgs(argv) {
+    if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
+        console.log(HELP);
+        process.exit(0);
+    }
+    const out = { env: 'cn-prod', lines: 100, since: '1h', json: false };
+    const positional = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        switch (a) {
+            case '--env':
+                out.env = next;
+                i++;
+                break;
+            case '--lines':
+            case '-n': {
+                const v = parseInt(next, 10);
+                if (isNaN(v) || v <= 0)
+                    throw new Error('--lines 需要正整数');
+                out.lines = v;
+                i++;
+                break;
+            }
+            case '--since':
+                out.since = next;
+                i++;
+                break;
+            case '--grep':
+                out.grep = next;
+                i++;
+                break;
+            case '--json':
+                out.json = true;
+                break;
+            default:
+                if (a.startsWith('-'))
+                    throw new Error(`未知参数: ${a}`);
+                positional.push(a);
+        }
+    }
+    if (positional.length === 0)
+        throw new Error('缺少 <service>(见 --help)');
+    if (positional.length > 1)
+        throw new Error(`多余参数: ${positional.slice(1).join(' ')}`);
+    out.service = positional[0];
+    if (!ALL_ENVS.includes(out.env)) {
+        throw new Error(`--env 非法: ${out.env}(可选 ${ALL_ENVS.join(' | ')})`);
+    }
+    return out;
+}
+function run(cmd, args) {
+    return (0, child_process_1.execFileSync)(cmd, args, { encoding: 'utf-8', maxBuffer: 128 * 1024 * 1024 });
+}
+/** AWS CloudWatch:aws logs tail /ecs/<svc>-<env>。 */
+function fetchAws(args) {
+    const group = `/ecs/${args.service}-${args.env}`;
+    const { awsStr } = parseSince(args.since);
+    const cmd = ['logs', 'tail', group, '--since', awsStr, '--region', AWS_REGION, '--format', args.json ? 'json' : 'short'];
+    if (args.grep)
+        cmd.push('--filter-pattern', args.grep);
+    process.stderr.write(`${C.d}# AWS CloudWatch ${group} (since ${awsStr}${args.grep ? `, grep "${args.grep}"` : ''})${C.n}\n`);
+    try {
+        process.stdout.write(run('aws', cmd));
+    }
+    catch (e) {
+        if (/ResourceNotFoundException/.test(e.stderr || e.message || '')) {
+            throw new Error(`日志组不存在: ${group}\n  确认服务名/环境对,或该服务未部署在 ${args.env}。`);
+        }
+        throw new Error(e.stderr || e.message);
+    }
+}
+/** 阿里云 SLS:aliyun sls GetLogs,project=optima-<env>-<account>,logstore=service。 */
+function fetchCn(args) {
+    const project = `optima-${args.env}-${ALIYUN_ACCOUNT}`;
+    const { sec } = parseSince(args.since);
+    const now = Math.floor(Date.now() / 1000);
+    const from = now - sec;
+    const cmd = [
+        'sls', 'GetLogs',
+        '--project', project,
+        '--logstore', args.service,
+        '--from', String(from),
+        '--to', String(now),
+        '--line', String(args.lines),
+        '--reverse', 'true', // 先拿最新 N 条
+        '--region', ALIYUN_REGION,
+        '--profile', ALIYUN_PROFILE,
+    ];
+    if (args.grep) {
+        cmd.push('--query', args.grep);
+    }
+    process.stderr.write(`${C.d}# 阿里云 SLS ${project}/${args.service} (since ${args.since}${args.grep ? `, query "${args.grep}"` : ''})${C.n}\n`);
+    let raw;
+    try {
+        raw = run('aliyun', cmd);
+    }
+    catch (e) {
+        const msg = e.stderr || e.message || '';
+        if (/LogStoreNotExist|ProjectNotExist/.test(msg)) {
+            throw new Error(`SLS logstore 不存在: ${project}/${args.service}\n  确认服务名对,或该服务未接 SLS。列全部:\n  aliyun sls ListLogStores --project ${project} --region ${ALIYUN_REGION} --profile ${ALIYUN_PROFILE}`);
+        }
+        throw new Error(msg);
+    }
+    const rows = JSON.parse(raw || '[]');
+    // reverse=true 取到的是新→旧,翻回旧→新便于阅读
+    rows.reverse();
+    if (args.json) {
+        console.log(JSON.stringify(rows, null, 2));
+        return;
+    }
+    if (rows.length === 0) {
+        process.stderr.write(`${C.y}(无日志:该时间窗内 ${args.service} 无输出,或 --grep 没命中)${C.n}\n`);
+        return;
+    }
+    for (const r of rows) {
+        // SLS 存的 content 已含容器时间戳 + stream(stdout/stderr)前缀,直接打印即可
+        process.stdout.write((r.content ?? JSON.stringify(r)) + '\n');
+    }
+}
+function main() {
+    let args;
+    try {
+        args = parseArgs(process.argv.slice(2));
+    }
+    catch (e) {
+        console.error(`${C.y}✗ ${e.message}${C.n}`);
+        process.exit(1);
+    }
+    try {
+        if (CN_ENVS.includes(args.env))
+            fetchCn(args);
+        else
+            fetchAws(args);
+    }
+    catch (e) {
+        console.error(`${C.y}✗ ${e.message}${C.n}`);
+        process.exit(1);
+    }
+}
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/dev-skills",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Claude Code Skills for Optima development team - cross-environment collaboration tools",
   "main": "index.js",
   "bin": {
@@ -9,6 +9,7 @@
     "optima-generate-test-token": "dist/bin/helpers/generate-test-token.js",
     "optima-grant-balance": "dist/bin/helpers/grant-balance.js",
     "optima-grant-subscription": "dist/bin/helpers/grant-subscription.js",
+    "optima-logs": "dist/bin/helpers/logs.js",
     "optima-plugin": "dist/bin/helpers/plugin.js",
     "optima-discount": "dist/bin/helpers/discount.js",
     "optima-product": "dist/bin/helpers/product.js",