@yixinkj/cli 1.0.0

package/README.md

@@ -0,0 +1,51 @@
+# @yixinkj/cli
+
+译心跨境本地 MCP stdio 服务器，用于在客户端通过 `npx -y` 启动 MCP 服务并调用本地 Rust 能力。
+
+## Accio Work 配置
+
+配置方式：`Stdio`
+
+命令：
+
+```bash
+npx -y @yixinkj/cli@latest
+```
+
+环境变量：
+
+```text
+YIXIN_KEY=你的key
+YIXIN_AUTH_URL=https://你的授权服务域名/v1/token
+```
+
+## 工具
+
+### run_ads_report
+
+参数：
+
+```json
+{
+  "period": "last-week"
+}
+```
+
+执行流程：
+
+1. 从环境变量读取 `YIXIN_KEY`。
+2. 向 `YIXIN_AUTH_URL` 提交 `{ key, skill: "ads", version }`。
+3. 获取短期授权 token。
+4. 使用以下参数运行 `~/.yixin/bin/alibaba-cli-{platform}`：
+
+```text
+--ads --period <period>
+```
+
+5. 将原生二进制的 stdout 返回给 Accio Work。
+
+## 本地二进制名称
+
+- `darwin-arm64` -> `~/.yixin/bin/alibaba-cli-mac-arm64`
+- `darwin-x64` -> `~/.yixin/bin/alibaba-cli-mac-x64`
+- `win32-x64` -> `~/.yixin/bin/alibaba-cli-win-x64.exe`

package/index.js

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+
+import http from 'node:http';
+import https from 'node:https';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+const require = createRequire(import.meta.url);
+const packageJson = require('./package.json');
+
+const VERSION = packageJson.version;
+const BIN_DIR = path.join(os.homedir(), '.yixin', 'bin');
+
+const PLATFORM_BINARIES = {
+  'darwin-arm64': 'alibaba-cli-mac-arm64',
+  'darwin-x64': 'alibaba-cli-mac-x64',
+  'win32-x64': 'alibaba-cli-win-x64.exe'
+};
+
+const PERIOD_ALIASES = {
+  '上周': 'last-week',
+  'last_week': 'last-week',
+  'last-week': 'last-week',
+  '上月': 'last-month',
+  'last_month': 'last-month',
+  'last-month': 'last-month',
+  '昨日': 'yesterday',
+  '昨天': 'yesterday',
+  'yesterday': 'yesterday',
+  '今日': 'today',
+  '今天': 'today',
+  'today': 'today',
+  '近7天': 'last-7-days',
+  '最近7天': 'last-7-days',
+  'last_7_days': 'last-7-days',
+  'last-7-days': 'last-7-days',
+  '近30天': 'last-30-days',
+  '最近30天': 'last-30-days',
+  'last_30_days': 'last-30-days',
+  'last-30-days': 'last-30-days'
+};
+
+function detectBinary() {
+  const platformKey = `${process.platform}-${process.arch}`;
+  const binaryName = PLATFORM_BINARIES[platformKey];
+  if (!binaryName) {
+    throw new Error(`暂不支持当前平台：${process.platform}/${process.arch}。已支持：mac-arm64、mac-x64、win-x64。`);
+  }
+  return path.join(BIN_DIR, binaryName);
+}
+
+function ensureBinary(binaryPath) {
+  if (!fs.existsSync(binaryPath)) {
+    throw new Error(`未找到本地二进制：${binaryPath}`);
+  }
+  if (process.platform !== 'win32') {
+    try {
+      fs.chmodSync(binaryPath, 0o755);
+    } catch (_) {
+      // 继续执行，让 spawnSync 在真正启动失败时返回具体错误。
+    }
+  }
+}
+
+async function requestToken({ key, skill, version }) {
+  const authUrl = String(process.env.YIXIN_AUTH_URL || '').trim();
+  if (!authUrl) {
+    throw new Error('未配置授权服务器地址，请添加 YIXIN_AUTH_URL');
+  }
+
+  const url = new URL(authUrl);
+  const body = JSON.stringify({ key, skill, version });
+  const client = url.protocol === 'https:' ? https : http;
+
+  return new Promise((resolve, reject) => {
+    const request = client.request({
+      method: 'POST',
+      protocol: url.protocol,
+      hostname: url.hostname,
+      port: url.port || undefined,
+      path: `${url.pathname}${url.search}`,
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(body),
+        'User-Agent': '@yixinkj/cli'
+      }
+    }, (response) => {
+      let data = '';
+      response.setEncoding('utf8');
+      response.on('data', (chunk) => {
+        data += chunk;
+      });
+      response.on('end', () => {
+        if (response.statusCode < 200 || response.statusCode >= 300) {
+          reject(new Error(`授权服务器请求失败：HTTP ${response.statusCode}`));
+          return;
+        }
+        try {
+          resolve(JSON.parse(data));
+        } catch (error) {
+          reject(new Error(`授权服务器返回了无效 JSON：${error.message}`));
+        }
+      });
+    });
+
+    request.setTimeout(15000, () => {
+      request.destroy(new Error('授权服务器请求超时'));
+    });
+    request.on('error', reject);
+    request.write(body);
+    request.end();
+  });
+}
+
+async function authorize(skill) {
+  const key = String(process.env.YIXIN_KEY || '').trim();
+  if (!key) {
+    throw new Error('未配置授权 key，请在 Accio Work 环境变量里添加 YIXIN_KEY=你的key');
+  }
+
+  const auth = await requestToken({ key, skill, version: VERSION });
+  if (!auth || auth.valid !== true || !auth.token) {
+    throw new Error(auth && auth.reason ? auth.reason : '授权失败');
+  }
+  return auth.token;
+}
+
+function runNative({ binaryPath, args, token }) {
+  ensureBinary(binaryPath);
+  const result = spawnSync(binaryPath, args, {
+    encoding: 'utf8',
+    env: {
+      ...process.env,
+      YIXIN_TOKEN: token
+    }
+  });
+
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    const detail = [result.stderr, result.stdout].filter(Boolean).join('\n').trim();
+    throw new Error(detail || `${binaryPath} exited with code ${result.status}`);
+  }
+  return result.stdout || '';
+}
+
+async function runAdsReport({ period }) {
+  const normalizedPeriod = normalizePeriod(period);
+  if (!normalizedPeriod) {
+    throw new Error('period 不能为空');
+  }
+
+  const token = await authorize('ads');
+  const stdout = runNative({
+    binaryPath: detectBinary(),
+    args: ['--ads', '--period', normalizedPeriod],
+    token
+  });
+  return stdout;
+}
+
+function normalizePeriod(period) {
+  const value = String(period || '').trim();
+  return PERIOD_ALIASES[value] || PERIOD_ALIASES[value.toLowerCase()] || value;
+}
+
+function registerTools(server) {
+  server.registerTool(
+    'run_ads_report',
+    {
+      title: 'Run Ads Report',
+      description: '运行本地译心广告报告二进制。period 可用 last-week（上周）、last-month（上月）、yesterday（昨日）、today（今日）、last-7-days（近7天）、last-30-days（近30天），也支持中文别名和下划线别名。',
+      inputSchema: {
+        period: z
+          .string()
+          .min(1)
+          .describe('相对时间范围。推荐值：last-week、last-month、yesterday、today、last-7-days、last-30-days。')
+      }
+    },
+    async ({ period }) => {
+      const stdout = await runAdsReport({ period });
+      return {
+        content: [{ type: 'text', text: stdout }]
+      };
+    }
+  );
+
+  // 后续新增能力时，在这里继续注册 server.registerTool(...)。
+}
+
+async function startMcpServer() {
+  const server = new McpServer({
+    name: 'yixin-cli',
+    version: VERSION
+  });
+  registerTools(server);
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+async function main() {
+  await startMcpServer();
+}
+
+main().catch((error) => {
+  console.error(`[yixin] ${error.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@yixinkj/cli",
+  "version": "1.0.0",
+  "description": "Yixin local MCP server and CLI launcher for Accio Work.",
+  "type": "module",
+  "bin": {
+    "yixin": "index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "zod": "^3.25.76"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "UNLICENSED",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}