tars-cli 0.1.10__tar.gz → 1.0.1__tar.gz

{tars_cli-0.1.10 → tars_cli-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tars-cli
-Version: 0.1.10
+Version: 1.0.1
 Summary: tars 平台命令行工具
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -32,7 +32,7 @@ pip install tars-cli
 
 ```bash
 $ tars --version
-tars-cli 0.1.10
+tars-cli 1.0.0
 ```
 
 ### 升级
@@ -72,6 +72,8 @@ $ tars plugin export-report <plugin_id>
 
 ### 认证
 
+#### 用户名密码登录
+
 ```bash
 $ tars auth login -s <server_url>
 登录 tars 平台
@@ -85,6 +87,18 @@ $ tars auth logout
 ✓ 已登出，本地凭证已清除
 ```
 
+#### API 密钥登录
+
+适用于 CLI 和 CI/CD 场景。先在 Web 端「个人设置 → API 密钥」中创建密钥，然后使用 `--token` 参数登录：
+
+```bash
+$ tars auth login -s <server_url> --token trs_xxxxxxxxxxxx
+✓ 登录成功
+  服务器: <server_url>
+```
+
+> **注意**: API 密钥明文只展示一次，创建后请立即复制保存。密钥不会过期，无需刷新。
+
 ### 插件管理
 
 > Git 导入可选参数：`--branch`（分支，默认 main）、`--path`（子目录路径）、`--auth-type`（认证方式：none/token/ssh-key）、`--auth-token`（认证凭证）。本地文件导入支持 `--overwrite` 覆盖。
@@ -297,3 +311,56 @@ tars -o json -q eval run <plugin_id> \
 |--------|------|
 | 0 | 成功 |
 | 2 | 执行错误（网络、参数、认证等） |
+
+## Claude Code 集成
+
+tars-cli 提供了 Claude Code Plugin（技能说明书），安装后可在 Claude Code 中使用自然语言调用 tars 命令（如"帮我评估 xxx 插件"），无需记忆 CLI 参数。
+
+### 安装
+
+tars-cli 的 Skill 作为独立 Plugin 分发，与 pip 包完全解耦。Plugin 源码位于仓库 `apps/plugins/tars-cli/` 目录。
+
+```bash
+# 第1步：安装 CLI 命令
+pip install tars-cli
+
+# 第2步：从 GitLab 仓库下载 skill 文件到全局 skill 目录
+cd /tmp
+git -c http.sslVerify=false clone --depth 1 --sparse https://git.easyops.local/anyclouds/tars-p.git /tmp/tars-plugin
+cd /tmp/tars-plugin && git sparse-checkout set apps/plugins/tars-cli
+mkdir -p ~/.claude/skills && cp -r apps/plugins/tars-cli/skills/tars-cli ~/.claude/skills/tars-cli
+rm -rf /tmp/tars-plugin
+```
+
+> 也可直接从 GitLab 网页下载 `apps/plugins/tars-cli/skills/tars-cli` 目录后手动放置到 `~/.claude/skills/tars-cli`。
+
+安装后的目录结构：
+
+```
+~/.claude/skills/tars-cli/
+├── SKILL.md              # Skill 主文件（命令映射 + 执行流程）
+└── references/
+    ├── auth.md            # 登录/登出流程
+    └── workflows.md       # 完整评估工作流 + 错误处理
+```
+
+已有同名 skill 时直接覆盖即可更新。
+
+### 支持的自然语言指令
+
+| 示例 | 实际执行的命令 |
+|------|---------------|
+| "登录 tars" | `tars auth login` |
+| "导入插件 https://github.com/xxx/xxx.git" | `tars plugin import <git_url>` |
+| "帮我评估 xxx 插件" | 完整评估流程（生成数据集 → 发布 → 运行评估 → 导出报告） |
+| "生成数据集" | `tars dataset generate ...` |
+| "查看评估状态" | `tars eval status ...` |
+| "下载模板" | `tars template download ...` |
+| "导出报告" | `tars plugin export-report ...` |
+
+### 前置条件
+
+- 已安装 tars-cli：`pip install tars-cli`
+- 已安装 tars-cli skill：从 GitLab 仓库下载到 `~/.claude/skills/tars-cli`
+- 已登录：`tars auth login -s <server_url>`
+- Claude Code 版本 >= 1.0（支持 Skill 功能）

{tars_cli-0.1.10 → tars_cli-1.0.1}/README.md

@@ -12,7 +12,7 @@ pip install tars-cli
 
 ```bash
 $ tars --version
-tars-cli 0.1.10
+tars-cli 1.0.0
 ```
 
 ### 升级
@@ -52,6 +52,8 @@ $ tars plugin export-report <plugin_id>
 
 ### 认证
 
+#### 用户名密码登录
+
 ```bash
 $ tars auth login -s <server_url>
 登录 tars 平台
@@ -65,6 +67,18 @@ $ tars auth logout
 ✓ 已登出，本地凭证已清除
 ```
 
+#### API 密钥登录
+
+适用于 CLI 和 CI/CD 场景。先在 Web 端「个人设置 → API 密钥」中创建密钥，然后使用 `--token` 参数登录：
+
+```bash
+$ tars auth login -s <server_url> --token trs_xxxxxxxxxxxx
+✓ 登录成功
+  服务器: <server_url>
+```
+
+> **注意**: API 密钥明文只展示一次，创建后请立即复制保存。密钥不会过期，无需刷新。
+
 ### 插件管理
 
 > Git 导入可选参数：`--branch`（分支，默认 main）、`--path`（子目录路径）、`--auth-type`（认证方式：none/token/ssh-key）、`--auth-token`（认证凭证）。本地文件导入支持 `--overwrite` 覆盖。
@@ -277,3 +291,56 @@ tars -o json -q eval run <plugin_id> \
 |--------|------|
 | 0 | 成功 |
 | 2 | 执行错误（网络、参数、认证等） |
+
+## Claude Code 集成
+
+tars-cli 提供了 Claude Code Plugin（技能说明书），安装后可在 Claude Code 中使用自然语言调用 tars 命令（如"帮我评估 xxx 插件"），无需记忆 CLI 参数。
+
+### 安装
+
+tars-cli 的 Skill 作为独立 Plugin 分发，与 pip 包完全解耦。Plugin 源码位于仓库 `apps/plugins/tars-cli/` 目录。
+
+```bash
+# 第1步：安装 CLI 命令
+pip install tars-cli
+
+# 第2步：从 GitLab 仓库下载 skill 文件到全局 skill 目录
+cd /tmp
+git -c http.sslVerify=false clone --depth 1 --sparse https://git.easyops.local/anyclouds/tars-p.git /tmp/tars-plugin
+cd /tmp/tars-plugin && git sparse-checkout set apps/plugins/tars-cli
+mkdir -p ~/.claude/skills && cp -r apps/plugins/tars-cli/skills/tars-cli ~/.claude/skills/tars-cli
+rm -rf /tmp/tars-plugin
+```
+
+> 也可直接从 GitLab 网页下载 `apps/plugins/tars-cli/skills/tars-cli` 目录后手动放置到 `~/.claude/skills/tars-cli`。
+
+安装后的目录结构：
+
+```
+~/.claude/skills/tars-cli/
+├── SKILL.md              # Skill 主文件（命令映射 + 执行流程）
+└── references/
+    ├── auth.md            # 登录/登出流程
+    └── workflows.md       # 完整评估工作流 + 错误处理
+```
+
+已有同名 skill 时直接覆盖即可更新。
+
+### 支持的自然语言指令
+
+| 示例 | 实际执行的命令 |
+|------|---------------|
+| "登录 tars" | `tars auth login` |
+| "导入插件 https://github.com/xxx/xxx.git" | `tars plugin import <git_url>` |
+| "帮我评估 xxx 插件" | 完整评估流程（生成数据集 → 发布 → 运行评估 → 导出报告） |
+| "生成数据集" | `tars dataset generate ...` |
+| "查看评估状态" | `tars eval status ...` |
+| "下载模板" | `tars template download ...` |
+| "导出报告" | `tars plugin export-report ...` |
+
+### 前置条件
+
+- 已安装 tars-cli：`pip install tars-cli`
+- 已安装 tars-cli skill：从 GitLab 仓库下载到 `~/.claude/skills/tars-cli`
+- 已登录：`tars auth login -s <server_url>`
+- Claude Code 版本 >= 1.0（支持 Skill 功能）

{tars_cli-0.1.10 → tars_cli-1.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tars-cli"
-version = "0.1.10"
+version = "1.0.1"
 description = "tars 平台命令行工具"
 requires-python = ">=3.11"
 dependencies = [
@@ -28,6 +28,7 @@ dev = [
     "build>=1.0",
 ]
 
+
 [project.scripts]
 tars = "tars_cli.app:app"
 

tars_cli-1.0.1/tars_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.1"

{tars_cli-0.1.10 → tars_cli-1.0.1}/tars_cli/client.py

@@ -82,13 +82,16 @@ class TarsAPIClient:
         self._log_response(resp)
 
         if resp.status_code == 401:
-            if self._refresh_token():
-                kwargs["headers"].update(self._headers())
-                self._log_request(method, url, **kwargs)
-                resp = self._client.request(method, url, **kwargs)
-                self._log_response(resp)
+            if self._credentials.refresh_token:
+                if self._refresh_token():
+                    kwargs["headers"].update(self._headers())
+                    self._log_request(method, url, **kwargs)
+                    resp = self._client.request(method, url, **kwargs)
+                    self._log_response(resp)
+                else:
+                    raise AuthExpiredError("认证已过期，请重新执行 tars auth login")
             else:
-                raise AuthExpiredError("认证已过期，请重新执行 tars auth login")
+                raise AuthExpiredError("API 密钥已过期或被撤销，请重新生成密钥后执行 tars auth login --token <新密钥>")
 
         return resp
 

{tars_cli-0.1.10 → tars_cli-1.0.1}/tars_cli/commands/auth_cmd.py

@@ -16,11 +16,47 @@ from tars_cli.output import render
 @auth_app.command()
 def login(
     server: str = typer.Option("", "--server", "-s", help="服务端地址"),
+    token: str = typer.Option("", "--token", "-t", help="API 密钥（trs_ 开头），跳过密码登录"),
 ) -> None:
     """登录 tars 平台"""
     output_fmt, quiet, verbose, global_server = get_global_options()
     server_url = resolve_server_url(server or global_server)
 
+    # FEAT-053: API 密钥登录模式
+    if token:
+        if not token.startswith("trs_"):
+            typer.echo("API 密钥格式错误：应以 trs_ 开头", err=True)
+            raise typer.Exit(code=2)
+
+        client = httpx.Client(base_url=f"{server_url}/api/v1", timeout=30.0, transport=HTTPTransport(proxy=None))
+        try:
+            resp = client.get("/user/profile", headers={"Authorization": f"Bearer {token}"})
+            if resp.status_code != 200:
+                detail = resp.json().get("detail", f"HTTP {resp.status_code}") if resp.headers.get("content-type", "").startswith("application/json") else f"HTTP {resp.status_code}"
+                typer.echo(f"API 密钥无效或已过期: {detail}", err=True)
+                raise typer.Exit(code=2)
+        finally:
+            client.close()
+
+        creds = Credentials(
+            server_url=server_url,
+            access_token=token,
+            refresh_token="",
+            expires_at="",
+        )
+        save_credentials(creds)
+
+        result = {
+            "message": "登录成功（API 密钥）",
+            "server": server_url,
+        }
+        web_url, next_step = print_hints(server_url, "auth_login", quiet=quiet)
+        render(result, output_format=output_fmt, quiet=quiet, web_url=web_url, next_step=next_step)
+        if next_step and not quiet:
+            typer.echo(f"👉 下一步: {next_step}")
+        return
+
+    # 原有密码登录流程
     username = typer.prompt("用户名")
     password = typer.prompt("密码", hide_input=True)
 
@@ -33,6 +69,14 @@ def login(
             except Exception:
                 detail = resp.text or f"HTTP {resp.status_code}"
             typer.echo(f"登录失败: {detail}", err=True)
+
+            # FEAT-053: sso_only 模式下密码登录失败时提示生成 API 密钥
+            if resp.status_code in (400, 401, 403):
+                typer.echo("", err=True)
+                typer.echo("提示：密码登录不可用时，可使用 API 密钥登录：", err=True)
+                typer.echo("  tars auth login --server <服务地址> --token <API密钥>", err=True)
+                typer.echo("  或在 Web 端个人设置中生成 API 密钥", err=True)
+
             raise typer.Exit(code=2)
 
         data = resp.json()

{tars_cli-0.1.10 → tars_cli-1.0.1}/tars_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tars-cli
-Version: 0.1.10
+Version: 1.0.1
 Summary: tars 平台命令行工具
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -32,7 +32,7 @@ pip install tars-cli
 
 ```bash
 $ tars --version
-tars-cli 0.1.10
+tars-cli 1.0.0
 ```
 
 ### 升级
@@ -72,6 +72,8 @@ $ tars plugin export-report <plugin_id>
 
 ### 认证
 
+#### 用户名密码登录
+
 ```bash
 $ tars auth login -s <server_url>
 登录 tars 平台
@@ -85,6 +87,18 @@ $ tars auth logout
 ✓ 已登出，本地凭证已清除
 ```
 
+#### API 密钥登录
+
+适用于 CLI 和 CI/CD 场景。先在 Web 端「个人设置 → API 密钥」中创建密钥，然后使用 `--token` 参数登录：
+
+```bash
+$ tars auth login -s <server_url> --token trs_xxxxxxxxxxxx
+✓ 登录成功
+  服务器: <server_url>
+```
+
+> **注意**: API 密钥明文只展示一次，创建后请立即复制保存。密钥不会过期，无需刷新。
+
 ### 插件管理
 
 > Git 导入可选参数：`--branch`（分支，默认 main）、`--path`（子目录路径）、`--auth-type`（认证方式：none/token/ssh-key）、`--auth-token`（认证凭证）。本地文件导入支持 `--overwrite` 覆盖。
@@ -297,3 +311,56 @@ tars -o json -q eval run <plugin_id> \
 |--------|------|
 | 0 | 成功 |
 | 2 | 执行错误（网络、参数、认证等） |
+
+## Claude Code 集成
+
+tars-cli 提供了 Claude Code Plugin（技能说明书），安装后可在 Claude Code 中使用自然语言调用 tars 命令（如"帮我评估 xxx 插件"），无需记忆 CLI 参数。
+
+### 安装
+
+tars-cli 的 Skill 作为独立 Plugin 分发，与 pip 包完全解耦。Plugin 源码位于仓库 `apps/plugins/tars-cli/` 目录。
+
+```bash
+# 第1步：安装 CLI 命令
+pip install tars-cli
+
+# 第2步：从 GitLab 仓库下载 skill 文件到全局 skill 目录
+cd /tmp
+git -c http.sslVerify=false clone --depth 1 --sparse https://git.easyops.local/anyclouds/tars-p.git /tmp/tars-plugin
+cd /tmp/tars-plugin && git sparse-checkout set apps/plugins/tars-cli
+mkdir -p ~/.claude/skills && cp -r apps/plugins/tars-cli/skills/tars-cli ~/.claude/skills/tars-cli
+rm -rf /tmp/tars-plugin
+```
+
+> 也可直接从 GitLab 网页下载 `apps/plugins/tars-cli/skills/tars-cli` 目录后手动放置到 `~/.claude/skills/tars-cli`。
+
+安装后的目录结构：
+
+```
+~/.claude/skills/tars-cli/
+├── SKILL.md              # Skill 主文件（命令映射 + 执行流程）
+└── references/
+    ├── auth.md            # 登录/登出流程
+    └── workflows.md       # 完整评估工作流 + 错误处理
+```
+
+已有同名 skill 时直接覆盖即可更新。
+
+### 支持的自然语言指令
+
+| 示例 | 实际执行的命令 |
+|------|---------------|
+| "登录 tars" | `tars auth login` |
+| "导入插件 https://github.com/xxx/xxx.git" | `tars plugin import <git_url>` |
+| "帮我评估 xxx 插件" | 完整评估流程（生成数据集 → 发布 → 运行评估 → 导出报告） |
+| "生成数据集" | `tars dataset generate ...` |
+| "查看评估状态" | `tars eval status ...` |
+| "下载模板" | `tars template download ...` |
+| "导出报告" | `tars plugin export-report ...` |
+
+### 前置条件
+
+- 已安装 tars-cli：`pip install tars-cli`
+- 已安装 tars-cli skill：从 GitLab 仓库下载到 `~/.claude/skills/tars-cli`
+- 已登录：`tars auth login -s <server_url>`
+- Claude Code 版本 >= 1.0（支持 Skill 功能）

tars_cli-0.1.10/tars_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.1.10"