Metadata-Version: 2.4
Name: coral-cli
Version: 0.1.3
Summary: 珊瑚平台 Python CLI 示例
Author-email: "vic.lv" <17625642535@163.com>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Requires-Dist: requests>=2.31.0

# coral-cli

这是一个面向珊瑚平台的 Python CLI。当前主要用于调用珊瑚平台 API，不再依赖账号密码登录，而是直接从环境变量读取鉴权信息。

## 安装

```bash
pip install -e .
```

如果已经发布到包源，也可以直接安装：

```bash
pip install coral-cli
```

## 环境变量

CLI 启动后会优先读取以下环境变量：

- `ACCESSKEY`，也兼容 `CORAL_ACCESSKEY`
- `ACC_ID`，也兼容 `CORAL_ACC_ID`

示例：

```bash
export ACCESSKEY='your-accesskey'
export ACC_ID='vic.lv'
```

## 命令

```bash
coral-cli config
coral-cli zhipu-search --app-id 2046036834380091394 --conversation-id 2046040995337003010 --input '添可'
coral-cli project
```

`coral-cli config` 会检查当前环境变量是否存在，并以脱敏方式输出配置摘要。

`coral-cli zhipu-search` 会调用下面这个接口：

```bash
https://coral-test.ecovacs.cn/app-platform/api/app/v1/chat/completions
```

等价调用示例：

```bash
coral-cli zhipu-search \
	--app-id 2046036834380091394 \
	--conversation-id 2046040995337003010 \
	--input '添可' \
	--tools-call-enabled 1 \
	--no-stream
```

这个命令会自动注入以下请求头：

```text
accesskey: 从 ACCESSKEY 或 CORAL_ACCESSKEY 读取
ACC_ID: 从 ACC_ID 或 CORAL_ACC_ID 读取
Content-Type: application/json
```

## Agent 使用建议

像 openclaw 这样的 Agent 在调用前，不应再要求用户登录，而应先确认运行环境里已经注入了 `ACCESSKEY` 和 `ACC_ID`。然后按下面顺序执行：

```bash
coral-cli config
coral-cli zhipu-search --app-id <app-id> --conversation-id <conversation-id> --input '<query>'
```

如果环境变量不存在，Agent 应提示用户在宿主环境中设置，而不是在 CLI 内部交互式索取或持久化保存。
