Metadata-Version: 2.4
Name: pooh-code
Version: 2.0.0
Summary: Windows-first coding agent with OpenAI-compatible model config, CLI approvals, and a local web frontend.
Requires-Python: >=3.11
Requires-Dist: beautifulsoup4>=4.14.3
Requires-Dist: duckduckgo-search>=8.1.1
Requires-Dist: httpx>=0.28.1
Provides-Extra: audio
Requires-Dist: faster-whisper>=1.2.1; extra == 'audio'
Provides-Extra: feishu
Requires-Dist: lark-oapi>=1.5.3; extra == 'feishu'
Provides-Extra: files
Requires-Dist: openpyxl>=3.1.5; extra == 'files'
Requires-Dist: pandas>=3.0.2; extra == 'files'
Requires-Dist: pdfplumber>=0.11.9; extra == 'files'
Requires-Dist: pypdf2>=3.0.1; extra == 'files'
Requires-Dist: python-docx>=1.2.0; extra == 'files'
Requires-Dist: python-pptx>=1.0.2; extra == 'files'
Provides-Extra: image
Requires-Dist: requests>=2.33.1; extra == 'image'
Description-Content-Type: text/markdown

# Pooh Code 2.0

`pooh-code` 是一个面向 Windows 用户的本地编码代理，支持：

- `pipx install` 后直接在终端使用
- 通过 OpenAI 兼容接口接入自定义模型网关
- 本地 Web 前端工作台
- shell 命令执行前的终端审批

## 安装

```bash
pipx install pooh-code
```

如果需要更完整的文件处理能力：

```bash
pipx install "pooh-code[files,audio,image]"
```

## 首次配置

2.0 不再使用 ChatGPT OAuth。安装后先在你的项目目录里初始化配置：

```bash
cd D:\your-project
pooh-code init
```

需要填写的核心配置：

```python
model_name = "Qwen3.5-397B-A17B"
openai_api_base = "http://127.0.0.1:3000/v1"
openai_api_key = "sk-xxxx"
```

配置文件默认写入：

```text
workplace/runtime/config/settings.json
```

也可以检查配置是否完整：

```bash
pooh-code check
```

## 使用

CLI：

```bash
pooh-code
pooh-code chat
pooh-code sessions
```

Web 前端：

```bash
pooh-code web
```

或：

```bash
pooh-code-web
```

默认地址：

```text
http://127.0.0.1:8787
```

## Windows 行为

- shell 工具在 Windows 下默认使用 `cmd.exe`
- agent 执行 shell 命令前会在终端弹出审批提示
- 若用户拒绝，命令不会执行

## 运行时目录

```text
workplace/runtime/
workplace/output/
```

其中：

- `workplace/runtime/config/settings.json`：模型与运行配置
- `workplace/runtime/sessions/`：会话记录
- `workplace/output/<session_id>/`：当前会话产物

## 开发

```bash
uv sync
uv run pooh-code --help
uv build
```
