# cbc-it-here

**Repository Path**: z168w/cbc-it-here

## Basic Information

- **Project Name**: cbc-it-here
- **Description**: cbc-it-here
- **Primary Language**: JavaScript
- **License**: CC-BY-4.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-23
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cbc-it-here

全局 Node.js CLI 工具，在任意项目目录下读取 `task.md` 文件，通过 [CodeBuddy Agent SDK](https://github.com/Tencent-ai/agent-sdk) 自动执行任务。

## 功能特性

- 读取当前目录 `task.md` 作为任务描述，自动提交给 CodeBuddy AI 代理执行
- 支持批量执行 `task/task{id}.md` 文件，按顺序执行多个任务
- 流式实时输出 AI 回复内容
- 执行完成后显示耗时和费用
- 以自动授权模式运行，无需手动确认
- 支持配置文件自定义执行选项

## 前置条件

- [Node.js](https://nodejs.org/) >= 18（需要 ES Module 和 async iterator 支持）
- 已配置 CodeBuddy API Key 环境变量

## 安装

```bash
pnpm add -g cbc-it-here
```

或使用 npm/yarn：

```bash
npm install -g cbc-it-here
yarn global add cbc-it-here
```

## 使用说明

### 方式一：单个任务文件

#### 1. 在项目根目录创建 `task.md`

使用 Markdown checkbox 列表格式编写任务：

```markdown
- [ ] 将现在时间写入当前目录time4.txt
- [ ] 将现在时间写入当前目录time5.txt
- [ ] 将现在时间写入当前目录time6.txt
```

#### 2. 运行命令

```bash
cbc-it
```

### 方式二：批量执行多个任务

#### 1. 创建 `task` 目录并添加多个任务文件

在项目根目录创建 `task` 目录，并添加 `task1.md`、`task2.md` 等文件：

```
project/
├── task/
│   ├── task1.md
│   ├── task2.md
│   └── task3.md
└── ...
```

工具将按数字顺序依次执行 `task1.md`、`task2.md`、`task3.md`...

#### 2. 运行命令

```bash
cbc-it
```

工具会输出每个任务的执行进度：

```
========== 执行 task1.md ==========
... AI 输出 ...
完成！耗时： 1805 ms
费用： 0 USD

========== 执行 task2.md ==========
... AI 输出 ...
完成！耗时： 1234 ms
费用： 0 USD
```

### （可选）创建配置文件

在项目根目录创建配置文件来自定义行为。支持以下文件名（按优先级排序）：

- `.cbc-it.json`
- `.cbc-it.js`
- `cbc-it.config.js`
- `cbc-it.config.json`

**JSON 配置示例 (`.cbc-it.json`)**:

```json
{
  "options": {
    "permissionMode": "bypassPermissions"
  }
}
```

**JS 配置示例 (`.cbc-it.js`)**:

```js
export default {
  options: {
    permissionMode: 'bypassPermissions'
  }
}
```

如未创建配置文件，将使用默认配置（`permissionMode: 'bypassPermissions'`）。

### 查看输出

工具会流式输出 AI 代理的回复文本，任务完成后显示：

```
完成！耗时：xxxx ms
费用：x.xxxx USD
```

## 工作原理

1. 检查当前目录是否存在 `task.md` 文件或 `task/` 目录及 `task{id}.md` 文件
2. 读取任务文件内容
3. 调用 CodeBuddy Agent SDK 的 `query()` 方法，将任务提交给 AI 代理
4. 批量模式下，按数字顺序依次执行任务（task1.md、task2.md 等）
5. 以 `bypassPermissions` 模式运行，AI 代理自动获得操作权限
6. 流式接收并输出 AI 代理的回复内容
7. 每个任务完成后输出耗时（毫秒）和费用（美元）

## 许可证

[CC BY 4.0](LICENSE)