# deepseek-pet

**Repository Path**: scp-planet/deepseek-pet

## Basic Information

- **Project Name**: deepseek-pet
- **Description**: Shows your DeepSeek API account balance directly in the IDEA status bar.
实时余额显示 在 IDEA 底部状态栏直接展示您 DeepSeek API 账户的余额。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-04
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepSeek Pet

[English](#english) | [中文](#中文)

---

## English

DeepSeek Pet is a lightweight JetBrains IDE plugin that shows your DeepSeek API balance in the status bar with a small pixel whale.

### Features

- Shows your DeepSeek API balance in the IDE status bar.
- Changes the whale color based on the current balance state:
  - Blue: balance is healthy.
  - Yellow: balance is below the warning threshold.
  - Red: balance query failed.
  - Gray: no Secret Key is configured.
- Opens the configuration dialog with `Alt+D`.
- Lets you configure the Secret Key, refresh interval, and warning threshold.
- Sends the current file path, or the selected line range, to the terminal from the toolbar or editor context menu.

### Sending File Paths to Terminal

Use **Send File Path to Terminal** when you want to pass the current file to CLI agents such as Codex, Claude Code, opencode, or similar terminal tools.

The action inserts the path into the last active terminal. If no terminal is available, it creates one using your current IDE terminal setting.

Path format:

- Project files are sent as relative paths, for example `src/main/java/App.java`.
- Files outside the project are sent as absolute paths.
- Paths use `/` as the separator for better compatibility with CLI agents.
- If you select text in the editor, the inserted path includes the selected line range, for example `README.md:12-18`.

Available from:

- Top toolbar.
- Tools menu.
- Editor context menu.
- Editor tab context menu.
- Supported code floating toolbars.

### Usage

1. Install the plugin and restart the IDE.
2. Press `Alt+D` to open the DeepSeek Pet settings.
3. Enter your DeepSeek API key if you want to show the balance.
4. Adjust the refresh interval and warning threshold.
5. Use **Send File Path to Terminal** from the toolbar or editor menu when you want to send the current file path to a terminal CLI.

### Notes

- The Secret Key is optional. If it is empty, the status bar keeps the gray whale state.
- Settings are stored per project.
- The terminal feature requires the JetBrains Terminal plugin to be available.
- Release notes are available in [CHANGELOG.md](CHANGELOG.md).

---

## 中文

DeepSeek Pet 是一个轻量级 JetBrains IDE 插件，会在状态栏用像素鲸鱼显示 DeepSeek API 余额。

### 功能

- 在 IDE 状态栏显示 DeepSeek API 余额。
- 根据余额状态改变鲸鱼颜色：
  - 蓝色：余额正常。
  - 黄色：余额低于警告阈值。
  - 红色：余额查询失败。
  - 灰色：未配置 Secret Key。
- 使用 `Alt+D` 打开配置窗口。
- 可配置 Secret Key、刷新间隔和余额警告阈值。
- 可从工具栏或编辑器右键菜单，将当前文件路径或选中的行范围发送到终端。

### 发送文件路径到终端

当你需要把当前文件传给 Codex、Claude Code、opencode 或类似终端 Agent CLI 时，可以使用 **发送文件路径到终端**。

该操作会把路径插入到最后激活的终端中。如果当前没有可用终端，会按照 IDE 当前的终端设置创建一个新终端。

路径格式：

- 项目内文件使用相对路径，例如 `src/main/java/App.java`。
- 项目外文件使用绝对路径。
- 路径统一使用 `/` 作为分隔符，以便更好地适配终端 CLI。
- 如果在编辑器中选中了文本，会附带选中的行范围，例如 `README.md:12-18`。

可用入口：

- 顶部工具栏。
- Tools 菜单。
- 编辑器右键菜单。
- 编辑器标签页右键菜单。
- 支持的代码浮动工具栏。

### 使用方式

1. 安装插件并重启 IDE。
2. 按 `Alt+D` 打开 DeepSeek Pet 设置。
3. 如果需要显示余额，输入 DeepSeek API Key。
4. 调整刷新间隔和警告阈值。
5. 需要把当前文件路径发送给终端 CLI 时，点击工具栏或编辑器菜单中的 **发送文件路径到终端**。

### 说明

- Secret Key 可留空。留空时，状态栏会保持灰色鲸鱼状态。
- 设置按项目保存。
- 发送路径到终端功能需要 JetBrains Terminal 插件可用。
- 更新日志见 [CHANGELOG.md](CHANGELOG.md)。