Metadata-Version: 2.4
Name: fcbyk-ai
Version: 1.0.0a1
Summary: fcbyk-cli plugin for AI
Author-email: fcbyk <731240932@qq.com>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fcbyk-cli==1.0.0a1
Requires-Dist: openai>=1.0.0
Requires-Dist: click>=8.0.0
Requires-Dist: rich>=13.0.0
Dynamic: license-file

# fcbyk-ai

`fcbyk-cli` 的 AI 聊天插件。

安装 `fcbyk-ai` 后，会自动安装 `fcbyk-cli`，安装完成后即可使用 `byk ai`。

## 安装

```bash
pip install fcbyk-ai
```

## 使用

启动交互式聊天：

```bash
byk ai
```

首次使用前需要配置 API Key：

```bash
byk ai -k your_api_key_here
```

然后就可以开始聊天了：

```bash
byk ai
```

## 参数说明

### 配置参数

- `-k, --api-key`：设置 API Key（必需）
- `-m, --model`：设置模型名称（默认：deepseek-chat）
- `-u, --api-url`：设置 API URL（默认：https://api.deepseek.com/v1/chat/completions）
- `-s, --stream`：启用流式输出，0 为关闭，1 为开启（默认：1）
- `-r, --rich`：启用富文本渲染，0 为关闭，1 为开启（默认：1）
- `-e, --extra-body`：设置额外的请求体（JSON 格式），例如：`'{"reasoning": {"enabled": true}}'`

### 其他选项

- `-c, --config`：显示当前配置并退出
- `-h, --help`：查看帮助信息

## 示例

### 配置 API Key 和模型

```bash
byk ai -k sk-xxx -m gpt-4
```

### 使用自定义 API URL

```bash
byk ai -k sk-xxx -u https://your-api-endpoint/v1/chat/completions
```

### 查看当前配置

```bash
byk ai -c
```

### 启用推理功能（如果模型支持）

```bash
byk ai -e '{"reasoning": {"enabled": true}}'
```

## 功能特性

- 🤖 支持所有 OpenAI 兼容的 API（DeepSeek、OpenAI、Azure OpenAI 等）
- 💬 交互式聊天界面，支持多轮对话
- 🌊 流式输出，实时显示 AI 回复
- 🎨 富文本渲染支持（代码高亮、Markdown 格式化）
- ⚙️ 灵活的配置选项，可自定义模型、API 地址等
- 💾 配置持久化保存，无需每次重复设置

## 注意事项

- API Key 是必需的，请通过 `-k` 参数设置
- 配置会保存在本地状态文件中，后续使用无需重复配置
- 在聊天中输入 `exit` 可退出聊天
- 支持 Ctrl+C 或 Ctrl+D 中断聊天

查看帮助：

```bash
byk ai -h
```
