yunxiao-code 1.0.6 → 1.0.8

package/README.md

@@ -1,35 +1,58 @@
 # yx-code
 
-阿里云云效 CLI 工具，支持 Git 提交、推送、克隆及创建合并请求。
+阿里云云效 CLI 工具，支持 Git 提交、推送、克隆及创建合并请求，让开发者可以在终端中完成日常开发工作流，无需打开浏览器。
+
+## 功能特性
+
+- 🚀 **克隆仓库** - 支持从主分支自动创建新分支
+- 📝 **提交代码** - 一键 add + commit
+- 📤 **推送代码** - 自动推送当前分支到远程
+- 🔀 **合并请求** - 快速创建 MR，支持指定目标分支
+- 📊 **代码差异** - 查看分支间的代码差异统计
 
 ## 安装
 
 ### npm 安装（推荐）
 
 ```bash
-npm install -g yx-code
+npm install -g yunxiao-code
 ```
 
+支持平台：
+- macOS (Intel/Apple Silicon)
+- Linux (x64)
+
 ### 从源码编译
 
 ```bash
 git clone <repo-url>
-cd yx-code
-go build -o yx-code .
+cd yunxiao-code
+make build-local
+sudo make install
+```
+
+或手动编译：
+
+```bash
+go build -o yx-code ./cmd/yx-code
 sudo mv yx-code /usr/local/bin/
 ```
 
-## 配置
+## 系统要求
+
+- Go 1.26.1+（从源码编译时）
+- Git CLI（运行时依赖）
+- Node.js 14+（npm 安装时）
 
-### 1. 初始化配置文件
+## 快速开始
 
-在你的项目目录下运行：
+### 1. 初始化配置
 
 ```bash
 yx-code init
 ```
 
-会在当前目录生成 `.yunxiao.yaml`：
+在当前目录生成 `.yunxiao.yaml` 配置文件：
 
 ```yaml
 # 云效合并请求 CLI 配置
@@ -40,20 +63,21 @@ token: ""
 
 填写 `organization_id` 和 `token`（个人访问令牌）。
 
+> **获取 Token**: 云效控制台 → 个人设置 → 个人访问令牌 → 创建令牌
+
 ### 2. 配置项说明
 
 | 字段 | 说明 | 默认值 |
 |------|------|--------|
 | `domain` | 云效 API 域名 | `openapi-rdc.aliyuncs.com` |
-| `organization_id` | 组织 ID | 无，必填 |
-| `token` | 个人访问令牌 | 无，必填 |
+| `organization_id` | 组织 ID（必填） | 无 |
+| `token` | 个人访问令牌（必填） | 无 |
 
 ### 3. 环境变量配置
 
 也可以通过环境变量配置：
 
 ```bash
-# 设置环境变量
 export YUNXIAO_DOMAIN="openapi-rdc.aliyuncs.com"
 export YUNXIAO_ORGANIZATION_ID="your-org-id"
 export YUNXIAO_TOKEN="your-token"
@@ -66,50 +90,153 @@ export YUNXIAO_TOKEN="your-token"
 3. 环境变量：`YUNXIAO_DOMAIN`、`YUNXIAO_ORGANIZATION_ID`、`YUNXIAO_TOKEN`
 4. CLI 参数：`--domain`、`--org`、`--token`
 
-## 使用
+## 命令参考
+
+### yx-code init
 
-### 克隆仓库并创建新分支
+初始化云效配置文件。
 
 ```bash
-yx-code clone <git-url> -b <分支名>
+yx-code init
 ```
 
-自动检测主分支（main/master），从主分支拉出新分支。
+### yx-code clone
 
-可选参数：
-- `-p <路径>` — 指定克隆目标路径
+克隆云效代码仓库。
 
-### 提交代码
+```bash
+yx-code clone <git-url> [flags]
+```
+
+| 参数 | 简写 | 必填 | 说明 |
+|------|------|------|------|
+| `<git-url>` | | 是 | Git 仓库地址 |
+| `--branch` | `-b` | 否 | 新分支名称，指定后会从主分支创建新分支 |
+| `--path` | `-p` | 否 | 克隆目标路径，默认从 URL 提取仓库名 |
 
 ```bash
-yx-code commit -m "提交信息"
+# 基本克隆
+yx-code clone https://codeup.aliyun.com/your-org/your-repo.git
+
+# 克隆并创建新分支
+yx-code clone https://codeup.aliyun.com/your-org/your-repo.git -b feature/new-feature
 ```
 
-执行 `git add .` 并提交。
+### yx-code commit
 
-### 推送到远程
+提交代码变更。
 
 ```bash
-yx-code push
+yx-code commit -m "<message>"
 ```
 
+| 参数 | 简写 | 必填 | 说明 |
+|------|------|------|------|
+| `--message` | `-m` | 是 | 提交信息 |
+
+```bash
+yx-code commit -m "feat: 添加用户登录功能"
+```
+
+### yx-code push
+
 推送当前分支到远程仓库。
 
-### 创建合并请求
+```bash
+yx-code push
+```
+
+### yx-code mr
+
+创建合并请求。
 
 ```bash
-yx-code mr -m "MR 标题"
+yx-code mr -m "<title>" [flags]
 ```
 
-向云效创建合并请求，目标分支为 `develop`。
+| 参数 | 简写 | 必填 | 说明 |
+|------|------|------|------|
+| `--message` | `-m` | 是 | MR 标题 |
+| `--description` | `-d` | 否 | MR 描述 |
+| `--target` | `-t` | 否 | 目标分支，默认: develop |
 
-可选参数：
-- `-d <描述>` — MR 描述
+```bash
+# 基本用法（目标分支默认 develop）
+yx-code mr -m "添加用户登录功能"
+
+# 指定目标分支
+yx-code mr -m "添加用户登录功能" -t main
+
+# 带描述
+yx-code mr -m "添加用户登录功能" -d "实现用户登录、注销功能"
+```
+
+### yx-code diff
+
+查看分支间的代码差异统计。
+
+```bash
+yx-code diff [flags]
+```
+
+| 参数 | 简写 | 必填 | 说明 |
+|------|------|------|------|
+| `--target` | `-t` | 否 | 目标分支，默认: develop |
+| `--source` | `-s` | 否 | 源分支，默认: 当前分支 |
+
+```bash
+# 查看当前分支与 develop 的差异
+yx-code diff
+
+# 指定分支
+yx-code diff -t main -s feature/new-feature
+```
 
 ### 全局参数
 
-所有子命令支持以下参数，用于覆盖配置文件：
+所有子命令支持以下全局参数，用于覆盖配置文件：
 
 ```bash
 yx-code <command> --domain <域名> --org <组织ID> --token <令牌>
 ```
+
+| 参数 | 说明 |
+|------|------|
+| `--domain` | 云效 API 域名 |
+| `--org` | 组织 ID |
+| `--token` | 个人访问令牌 |
+
+## 工作流示例
+
+```bash
+# 1. 初始化配置
+yx-code init
+# 编辑 .yunxiao.yaml 填写凭证
+
+# 2. 克隆仓库并创建特性分支
+yx-code clone https://codeup.aliyun.com/org/repo.git -b feature/login
+
+# 3. 进入仓库目录
+cd repo
+
+# 4. 开发完成后提交
+yx-code commit -m "feat: 实现登录功能"
+
+# 5. 推送到远程
+yx-code push
+
+# 6. 创建合并请求
+yx-code mr -m "添加用户登录功能"
+
+# 7. 查看代码差异
+yx-code diff
+```
+
+## 相关链接
+
+- [阿里云云效官方文档](https://help.aliyun.com/zh/yunxiao/)
+- [云效 OpenAPI 文档](https://help.aliyun.com/zh/yunxiao/developer-reference/)
+
+## License
+
+MIT

package/bin/yx-code.js

@@ -1,34 +1,33 @@
 #!/usr/bin/env node
-const { execSync } = require('child_process');
+
+const { spawn } = require('child_process');
 const path = require('path');
 const os = require('os');
 
+// 根据平台选择二进制文件
 const platform = os.platform();
 const arch = os.arch();
 
-let binary;
+let binaryName;
 if (platform === 'darwin' && arch === 'arm64') {
-  binary = 'yx-code-darwin-arm64';
+  binaryName = 'yx-code-darwin-arm64';
 } else if (platform === 'darwin' && arch === 'x64') {
-  binary = 'yx-code-darwin-amd64';
+  binaryName = 'yx-code-darwin-amd64';
 } else if (platform === 'linux' && arch === 'x64') {
-  binary = 'yx-code-linux-amd64';
+  binaryName = 'yx-code-linux-amd64';
 } else {
-  console.error(`Unsupported platform: ${platform}/${arch}`);
+  console.error(`Unsupported platform: ${platform}-${arch}`);
   process.exit(1);
 }
 
-const binaryPath = path.join(__dirname, binary);
-const args = process.argv.slice(2).map(arg => {
-  // Escape quotes and wrap in quotes if contains spaces
-  if (arg.includes(' ')) {
-    return `"${arg.replace(/"/g, '\\"')}"`;
-  }
-  return arg;
-}).join(' ');
+const binaryPath = path.join(__dirname, binaryName);
+
+// 执行二进制文件，传递所有参数
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  shell: false
+});
 
-try {
-  execSync(`"${binaryPath}" ${args}`, { stdio: 'inherit' });
-} catch (error) {
-  process.exit(error.status);
-}
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yunxiao-code",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "阿里云云效 CLI 工具",
   "bin": {
     "yx-code": "bin/yx-code.js"
@@ -10,11 +10,10 @@
   },
   "files": [
     "bin",
-    "scripts",
-    "skills"
+    "scripts"
   ],
   "license": "MIT",
   "engines": {
     "node": ">=14"
   }
-}
+}

package/scripts/postinstall.js

@@ -1,77 +1,10 @@
 #!/usr/bin/env node
 
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const CLAUDE_DIR = path.join(os.homedir(), '.claude');
-const COMMANDS_DIR = path.join(CLAUDE_DIR, 'commands', 'yx-commands');
-const SKILLS_DIR = path.join(CLAUDE_DIR, 'skills', 'yx-workflow');
-
-// 获取 npm 包安装目录
-const packageDir = path.resolve(__dirname, '..');
-const skillsSourceDir = path.join(packageDir, 'skills');
-
-console.log('\n🔧 Installing yunxiao-code Claude Code integration...\n');
-
-// 确保目录存在
-function ensureDir(dir) {
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-    console.log(`  ✓ Created directory: ${dir}`);
-  }
-}
-
-// 复制目录
-function copyDir(src, dest) {
-  ensureDir(path.dirname(dest));
-
-  if (fs.existsSync(dest)) {
-    fs.rmSync(dest, { recursive: true });
-  }
-
-  fs.cpSync(src, dest, { recursive: true });
-  console.log(`  ✓ Installed: ${dest}`);
-}
-
-// 安装命令
-function installCommands() {
-  const commandsSource = path.join(skillsSourceDir, 'yx-commands');
-
-  if (fs.existsSync(commandsSource)) {
-    copyDir(commandsSource, COMMANDS_DIR);
-    console.log(`  📦 Commands installed to ~/.claude/commands/yx-commands/`);
-  }
-}
-
-// 安装 skills
-function installSkills() {
-  const skillSource = path.join(skillsSourceDir, 'skills', 'yx-workflow');
-
-  if (fs.existsSync(skillSource)) {
-    copyDir(skillSource, SKILLS_DIR);
-    console.log(`  📦 Skill installed to ~/.claude/skills/yx-workflow/`);
-  }
-}
-
-// 主流程
-try {
-  ensureDir(CLAUDE_DIR);
-  ensureDir(path.join(CLAUDE_DIR, 'commands'));
-  ensureDir(path.join(CLAUDE_DIR, 'skills'));
-
-  installCommands();
-  installSkills();
-
-  console.log('\n✅ yunxiao-code Claude Code integration installed successfully!\n');
-  console.log('Available commands:');
-  console.log('  /yx-commands:init     - 初始化云效配置');
-  console.log('  /yx-commands:clone    - 克隆仓库');
-  console.log('  /yx-commands:commit   - 提交代码');
-  console.log('  /yx-commands:push     - 推送代码');
-  console.log('  /yx-commands:mr       - 创建合并请求');
-  console.log('\nRun /reload-plugins or restart Claude Code to activate.\n');
-} catch (error) {
-  console.error('❌ Installation failed:', error.message);
-  process.exit(1);
-}
+console.log('\n✅ yx-code CLI installed successfully!\n');
+console.log('Usage:');
+console.log('  yx-code init     - 初始化云效配置');
+console.log('  yx-code clone    - 克隆仓库');
+console.log('  yx-code commit   - 提交代码');
+console.log('  yx-code push     - 推送代码');
+console.log('  yx-code mr       - 创建合并请求');
+console.log('  yx-code review   - 代码审查\n');

package/skills/.claude-plugin/plugin.json

@@ -1,10 +0,0 @@
-{
-  "name": "yunxiao-code",
-  "description": "云效代码仓库工作流自动化 - 初始化配置、克隆仓库、提交代码、推送、创建合并请求",
-  "author": {
-    "name": "yunxiao-code"
-  },
-  "skills": {
-    "yx-workflow": "skills/yx-workflow/SKILL.md"
-  }
-}

package/skills/README.md

@@ -1,100 +0,0 @@
-# Yunxiao Code - Claude Code Plugin
-
-云效代码仓库工作流自动化插件，为 Claude Code 提供云效相关命令支持。
-
-## 安装
-
-```bash
-npm install -g yunxiao-code
-```
-
-安装完成后，会自动：
-1. 安装 `yunxiao-code` CLI 工具到系统 PATH
-2. 安装 Claude Code 命令到 `~/.claude/commands/yx-commands/`
-3. 安装 Claude Code 技能到 `~/.claude/skills/yx-workflow/`
-
-重启 Claude Code 或执行 `/reload-plugins` 后即可使用。
-
-## 可用命令
-
-| 命令 | 功能 | 示例 |
-|------|------|------|
-| `/yx-commands:init` | 初始化云效配置 | `/yx-commands:init` |
-| `/yx-commands:clone` | 克隆仓库 | `/yx-commands:clone <git-url>` |
-| `/yx-commands:commit` | 提交代码 | `/yx-commands:commit` |
-| `/yx-commands:push` | 推送代码 | `/yx-commands:push` |
-| `/yx-commands:mr` | 创建合并请求 | `/yx-commands:mr <title>` |
-
-## 使用指南
-
-### 1. 初始化配置
-
-首次使用需要配置云效凭证：
-
-```
-/yx-commands:init
-```
-
-按提示填写：
-- `organization_id`: 云效组织 ID
-- `token`: 云效个人访问令牌
-
-### 2. 克隆仓库
-
-克隆云效代码仓库：
-
-```
-/yx-commands:clone https://codeup.aliyun.com/your-org/your-repo.git
-```
-
-### 3. 提交代码
-
-自动分析变更并提交：
-
-```
-/yx-commands:commit
-```
-
-### 4. 推送代码
-
-推送当前分支到远程：
-
-```
-/yx-commands:push
-```
-
-### 5. 创建合并请求
-
-创建 MR 到 develop 分支：
-
-```
-/yx-commands:mr "添加用户登录功能"
-```
-
-## 技能触发
-
-当对话中出现以下关键词时，`yx-workflow` 技能会自动激活：
-
-- 云效
-- 合并请求
-- MR
-- yx-code
-- 阿里云代码仓库
-
-## 手动安装（可选）
-
-如果需要手动安装命令和技能：
-
-```bash
-# 安装命令
-mkdir -p ~/.claude/commands/yx-commands
-cp -r skills/yx-commands/*.md ~/.claude/commands/yx-commands/
-
-# 安装技能
-mkdir -p ~/.claude/skills/yx-workflow
-cp -r skills/skills/yx-workflow ~/.claude/skills/
-```
-
-## 许可证
-
-MIT License

package/skills/skills/yx-workflow/SKILL.md

@@ -1,65 +0,0 @@
----
-name: yx-workflow
-description: 云效代码仓库工作流自动化助手
-triggers:
-  - 云效
-  - 合并请求
-  - MR
-  - yx-code
-  - 阿里云代码仓库
-  - 阿里云云效
----
-
-# 云效代码仓库工作流
-
-我是一个帮助你在云效代码仓库进行开发的助手。我可以帮助你：
-
-## 可用命令
-
-| 命令 | 功能 | 用法 |
-|------|------|------|
-| `/yx-commands:init` | 初始化云效配置 | 直接运行，配置 token |
-| `/yx-commands:clone` | 克隆仓库 | `/yx-commands:clone <git-url>` |
-| `/yx-commands:commit` | 提交代码 | 自动分析变更生成 commit message |
-| `/yx-commands:push` | 推送代码 | 推送当前分支到远程 |
-| `/yx-commands:mr` | 创建合并请求 | `/yx-commands:mr <title>` |
-
-## 典型工作流
-
-1. **初始化配置**
-   ```
-   /yx-commands:init
-   ```
-   首次使用需要配置云效的 organization_id 和 token。
-
-2. **克隆仓库**
-   ```
-   /yx-commands:clone https://codeup.aliyun.com/xxx/xxx.git
-   ```
-
-3. **提交代码**
-   ```
-   /yx-commands:commit
-   ```
-   会自动分析变更并生成合适的 commit message。
-
-4. **推送代码**
-   ```
-   /yx-commands:push
-   ```
-
-5. **创建合并请求**
-   ```
-   /yx-commands:mr "添加新功能"
-   ```
-
-## 注意事项
-
-- 确保已安装 `yx-code` CLI 工具
-- 确保 `yx-code` 在系统 PATH 中可用
-- MR 默认合并到 develop 分支
-
-## 相关链接
-
-- [云效控制台](https://devops.aliyun.com/)
-- [云效文档](https://help.aliyun.com/product/153293.html)

package/skills/yx-commands/clone.md

@@ -1,18 +0,0 @@
----
-name: clone
-description: 克隆云效代码仓库
----
-
-根据用户提供的参数执行克隆操作。
-
-**参数说明：**
-- 第一个参数是云效仓库的 Git URL（必填）
-- `-b` 参数指定分支名（可选）
-- `-p` 参数指定本地路径（可选）
-
-如果用户没有提供 git-url，请询问用户提供仓库地址。
-
-执行命令示例：
-```bash
-yx-code clone <git-url> [-b <branch>] [-p <path>]
-```

package/skills/yx-commands/commit.md

@@ -1,44 +0,0 @@
----
-name: commit
-description: 分析代码变更并提交到云效仓库
----
-
-分析当前的代码变更并提交。
-
-**步骤：**
-
-1. 首先查看当前变更状态：
-```bash
-git status
-```
-
-2. 查看变更统计：
-```bash
-git diff --stat
-```
-
-3. 如果有暂存的变更，查看具体内容：
-```bash
-git diff --cached
-```
-
-4. 如果没有暂存的变更但有未暂存的变更，查看：
-```bash
-git diff
-```
-
-5. 分析变更后，根据变更内容生成合适的 commit message，格式遵循 Conventional Commits：
-- `feat:` 新功能
-- `fix:` 修复 bug
-- `refactor:` 重构
-- `docs:` 文档变更
-- `style:` 代码格式
-- `test:` 测试
-- `chore:` 构建/工具
-
-6. 执行提交：
-```bash
-yx-code commit -m "<生成的commit-message>"
-```
-
-如果用户提供了特定的 commit message，则使用用户提供的。

package/skills/yx-commands/init.md

@@ -1,20 +0,0 @@
----
-name: init
-description: 初始化云效配置文件
----
-
-请执行以下命令初始化云效配置：
-
-```bash
-yx-code init
-```
-
-执行后，配置文件将创建在 `~/.yunxiao-code/config.json`。
-
-你需要填写以下信息：
-- `organization_id`: 云效组织 ID
-- `token`: 云效个人访问令牌
-
-获取方式：
-1. organization_id: 在云效控制台 URL 中可以找到，格式如 `https://devops.aliyun.com/organization/{organization_id}/...`
-2. token: 在云效控制台 -> 个人设置 -> 个人访问令牌 中创建

package/skills/yx-commands/mr.md

@@ -1,25 +0,0 @@
----
-name: mr
-description: 创建云效合并请求(Merge Request)
----
-
-创建合并请求到 develop 分支。
-
-**步骤：**
-
-1. 首先显示当前分支和仓库信息：
-```bash
-git branch --show-current
-git remote -v | head -1
-```
-
-2. 获取合并请求标题（必填）和描述（可选）
-   - 如果用户没有提供标题，请询问用户提供合并请求的标题
-   - 描述是可选的，用户可以补充详细说明
-
-3. 执行创建 MR：
-```bash
-yx-code mr -m "<title>" [-d "<description>"]
-```
-
-创建成功后，会返回合并请求的 URL 链接，用户可以在浏览器中查看。

package/skills/yx-commands/push.md

@@ -1,20 +0,0 @@
----
-name: push
-description: 推送代码到云效远程仓库
----
-
-推送代码到远程仓库。
-
-**步骤：**
-
-1. 首先显示当前分支信息：
-```bash
-git branch --show-current
-```
-
-2. 执行推送：
-```bash
-yx-code push
-```
-
-如果推送失败，可能需要先设置上游分支。在这种情况下，提示用户是否需要设置上游分支并重试。