vox-code 2.0.0__tar.gz

vox_code-2.0.0/.env.example

@@ -0,0 +1,37 @@
+# Vox Code 配置示例
+# 至少配置一个 provider 即可
+# 推荐优先运行: vox-code init
+
+# GLM (默认)
+GLM_API_KEY=your_glm_api_key_here
+GLM_MODEL=glm-5.1
+GLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4/chat/completions
+
+# DeepSeek
+DEEPSEEK_API_KEY=your_deepseek_api_key_here
+DEEPSEEK_MODEL=deepseek-chat
+DEEPSEEK_BASE_URL=https://api.deepseek.com/chat/completions
+
+# Qwen API / DashScope Compatible Mode
+QWEN_API_KEY=your_qwen_api_key_here
+QWEN_MODEL=qwen-plus
+QWEN_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
+
+# 兼容阿里云官方变量命名（二选一即可）
+# DASHSCOPE_API_KEY=your_dashscope_api_key_here
+# DASHSCOPE_MODEL=qwen-plus
+# DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
+
+# Ollama (本地模型，无需 API Key)
+# OLLAMA_MODEL=qwen2.5:7b
+# OLLAMA_BASE_URL=http://localhost:11434
+
+# 默认 provider
+VOX_CODE_DEFAULT_PROVIDER=glm
+
+# 搜索引擎 (zhipu / serpapi / searxng)
+SEARCH_PROVIDER=zhipu
+# SerpAPI
+# SERPAPI_API_KEY=your_serpapi_api_key_here
+# SearXNG
+# SEARXNG_BASE_URL=http://localhost:8888

vox_code-2.0.0/.gitignore

@@ -0,0 +1,13 @@
+.DS_Store
+.env
+.venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+build/
+dist/
+*.egg-info/
+__pycache__/
+*.py[cod]
+
+voxcli/**/__pycache__/

vox_code-2.0.0/PKG-INFO

@@ -0,0 +1,258 @@
+Metadata-Version: 2.4
+Name: vox-code
+Version: 2.0.0
+Summary: Web-aware Tool CLI - 支持 ReAct、Plan-and-Execute、Memory、RAG、Multi-Agent、HITL
+Project-URL: Homepage, https://github.com/faliang1129/vox-cli
+Project-URL: Repository, https://github.com/faliang1129/vox-cli
+Project-URL: Issues, https://github.com/faliang1129/vox-cli/issues
+Keywords: agent,ai,cli,developer-tools,llm,rag
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: beautifulsoup4<5,>=4.12
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: lxml<6,>=5.1
+Requires-Dist: python-dotenv<2,>=1.0
+Requires-Dist: pyyaml<7,>=6.0
+Provides-Extra: gui
+Requires-Dist: pyside6<7,>=6.8; extra == 'gui'
+Description-Content-Type: text/markdown
+
+# Vox Code
+
+> 一个面向开发工作流的 AI CLI，带有桌宠 GUI、工具调用、记忆、RAG 和多运行模式。
+
+Vox Code 试图把“能聊天的模型”变成“能在本地开发环境里协作的助手”。  
+它既可以作为纯终端工具使用，也可以作为桌面编程搭子运行。
+
+当前版本：`2.0.0`
+
+## Highlights
+
+- `vox-code`：终端交互式 AI CLI
+- `vox-pet`：基于 `PySide6` 的桌宠 GUI
+- 支持 `GLM`、`DeepSeek`、`Qwen API`、`Ollama`
+- 支持 `/model` 动态切换模型
+- 支持 `single / plan / team` 三种运行模式
+- 内置工具调用、代码检索、Memory、RAG、HITL、安全策略和审计日志
+- 配置与源码分离，支持 `.env`、环境变量和用户目录配置
+
+## Why Vox Code
+
+和普通的聊天壳不一样，Vox Code 更偏向“本地开发协作工具”：
+
+- 不只关心对话，还关心项目上下文、命令执行和代码检索
+- 不把模型绑定死在单一厂商，支持云端和本地模型混用
+- 同时提供 CLI 和桌宠 GUI，两套交互风格可以共存
+- 适合作为个人 AI Coding Assistant 的实验场和产品原型
+
+## Quick Start
+
+### Requirements
+
+- Python `3.11+`
+
+### 1. Install
+
+CLI only:
+
+```bash
+pip install -e .
+```
+
+With GUI:
+
+```bash
+pip install -e ".[gui]"
+```
+
+### 2. Init Config
+
+推荐先运行：
+
+```bash
+vox-code init
+```
+
+它会引导你填写：
+
+- provider
+- model
+- base URL
+- API key
+
+也可以手动写 `.env` 或环境变量，示例见 [.env.example](.env.example)。
+
+### 3. Start CLI
+
+```bash
+vox-code
+```
+
+### 4. Start Desktop Pet
+
+```bash
+vox-pet
+```
+
+也支持模块方式启动：
+
+```bash
+python -m voxcli
+python -m voxcli.gui
+```
+
+## Supported Providers
+
+当前正式支持的 provider：
+
+| Provider | Mode | Default Model |
+| --- | --- | --- |
+| `glm` | Cloud API | `glm-5.1` |
+| `deepseek` | Cloud API | `deepseek-chat` |
+| `qwen` | Cloud API | `qwen-plus` |
+| `ollama` | Local Model | `qwen2.5:7b` |
+
+说明：
+
+- `qwen` 支持 `QWEN_*` 变量名
+- 同时兼容阿里云 `DASHSCOPE_*` 变量名
+- `ollama` 适合本地模型和离线/低成本场景
+
+## Configuration
+
+### Config Priority
+
+配置按下面优先级读取：
+
+1. 环境变量
+2. `.env`
+3. `~/.vox-code/config.json`
+
+默认配置目录：
+
+- macOS / Linux: `~/.vox-code/config.json`
+- Windows: `%USERPROFILE%\.vox-code\config.json`
+
+也支持自定义目录：
+
+- `VOX_CODE_HOME`
+- `VOX_HOME`
+
+### Example: GLM
+
+```bash
+export GLM_API_KEY="your_key"
+export GLM_MODEL="glm-5.1"
+export GLM_BASE_URL="https://open.bigmodel.cn/api/paas/v4/chat/completions"
+vox-code
+```
+
+### Example: DeepSeek
+
+```bash
+export DEEPSEEK_API_KEY="your_key"
+export DEEPSEEK_MODEL="deepseek-chat"
+export DEEPSEEK_BASE_URL="https://api.deepseek.com/chat/completions"
+vox-code
+```
+
+### Example: Qwen
+
+```bash
+export QWEN_API_KEY="your_key"
+export QWEN_MODEL="qwen-plus"
+export QWEN_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
+vox-code
+```
+
+兼容 DashScope 命名：
+
+```bash
+export DASHSCOPE_API_KEY="your_key"
+export DASHSCOPE_MODEL="qwen-plus"
+export DASHSCOPE_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
+vox-code
+```
+
+### Example: Ollama
+
+```bash
+export OLLAMA_MODEL="qwen2.5:7b"
+export OLLAMA_BASE_URL="http://localhost:11434"
+vox-code
+```
+
+## Common Commands
+
+| Command | Description |
+| --- | --- |
+| `vox-code init` | 初始化模型配置 |
+| `vox-code config-path` | 查看配置文件路径 |
+| `/model <preset-id\|provider[:model]>` | 切换模型 |
+| `/team` | 切换运行模式 |
+| `/style <work\|pet>` | 切换展示风格 |
+| `/memory` | 查看记忆状态 |
+| `/policy` | 查看安全策略 |
+| `/audit` | 查看最近审计日志 |
+
+## Desktop GUI
+
+`vox-pet` 会启动桌宠界面，适合偏轻量、陪伴式的交互方式。
+
+GUI 当前支持：
+
+- 跟随全局 CLI 配置
+- 独立 GUI 模型配置
+- OpenAI Compatible 网关
+- Qwen API 标签显示
+
+如果 `PySide6` 不可用，GUI 无法启动，但 CLI 仍可正常使用。
+
+如果你要把 GUI 一起装上：
+
+```bash
+pip install "vox-code[gui]"
+```
+
+## Project Layout
+
+```text
+voxcli/
+├── agent/       # Agent、Plan-and-Execute、多 Agent 协作
+├── cli/         # CLI 入口与命令解析
+├── config.py    # 配置读取与持久化
+├── gui/         # 桌宠 GUI
+├── hitl/        # 人工审批与交互控制
+├── llm/         # 模型接入层
+├── memory/      # 长短期记忆
+├── rag/         # 索引、切块、检索、嵌入
+├── runtime/     # 会话控制器
+├── tool/        # 工具注册与调用
+└── web/         # Web 搜索与抓取
+```
+
+## Development
+
+常用开发命令：
+
+```bash
+vox-code
+vox-pet
+vox-code config-path
+```
+
+如果你想快速验证配置是否生效，推荐先跑：
+
+```bash
+vox-code init
+```

vox_code-2.0.0/README.md

@@ -0,0 +1,229 @@
+# Vox Code
+
+> 一个面向开发工作流的 AI CLI，带有桌宠 GUI、工具调用、记忆、RAG 和多运行模式。
+
+Vox Code 试图把“能聊天的模型”变成“能在本地开发环境里协作的助手”。  
+它既可以作为纯终端工具使用，也可以作为桌面编程搭子运行。
+
+当前版本：`2.0.0`
+
+## Highlights
+
+- `vox-code`：终端交互式 AI CLI
+- `vox-pet`：基于 `PySide6` 的桌宠 GUI
+- 支持 `GLM`、`DeepSeek`、`Qwen API`、`Ollama`
+- 支持 `/model` 动态切换模型
+- 支持 `single / plan / team` 三种运行模式
+- 内置工具调用、代码检索、Memory、RAG、HITL、安全策略和审计日志
+- 配置与源码分离，支持 `.env`、环境变量和用户目录配置
+
+## Why Vox Code
+
+和普通的聊天壳不一样，Vox Code 更偏向“本地开发协作工具”：
+
+- 不只关心对话，还关心项目上下文、命令执行和代码检索
+- 不把模型绑定死在单一厂商，支持云端和本地模型混用
+- 同时提供 CLI 和桌宠 GUI，两套交互风格可以共存
+- 适合作为个人 AI Coding Assistant 的实验场和产品原型
+
+## Quick Start
+
+### Requirements
+
+- Python `3.11+`
+
+### 1. Install
+
+CLI only:
+
+```bash
+pip install -e .
+```
+
+With GUI:
+
+```bash
+pip install -e ".[gui]"
+```
+
+### 2. Init Config
+
+推荐先运行：
+
+```bash
+vox-code init
+```
+
+它会引导你填写：
+
+- provider
+- model
+- base URL
+- API key
+
+也可以手动写 `.env` 或环境变量，示例见 [.env.example](.env.example)。
+
+### 3. Start CLI
+
+```bash
+vox-code
+```
+
+### 4. Start Desktop Pet
+
+```bash
+vox-pet
+```
+
+也支持模块方式启动：
+
+```bash
+python -m voxcli
+python -m voxcli.gui
+```
+
+## Supported Providers
+
+当前正式支持的 provider：
+
+| Provider | Mode | Default Model |
+| --- | --- | --- |
+| `glm` | Cloud API | `glm-5.1` |
+| `deepseek` | Cloud API | `deepseek-chat` |
+| `qwen` | Cloud API | `qwen-plus` |
+| `ollama` | Local Model | `qwen2.5:7b` |
+
+说明：
+
+- `qwen` 支持 `QWEN_*` 变量名
+- 同时兼容阿里云 `DASHSCOPE_*` 变量名
+- `ollama` 适合本地模型和离线/低成本场景
+
+## Configuration
+
+### Config Priority
+
+配置按下面优先级读取：
+
+1. 环境变量
+2. `.env`
+3. `~/.vox-code/config.json`
+
+默认配置目录：
+
+- macOS / Linux: `~/.vox-code/config.json`
+- Windows: `%USERPROFILE%\.vox-code\config.json`
+
+也支持自定义目录：
+
+- `VOX_CODE_HOME`
+- `VOX_HOME`
+
+### Example: GLM
+
+```bash
+export GLM_API_KEY="your_key"
+export GLM_MODEL="glm-5.1"
+export GLM_BASE_URL="https://open.bigmodel.cn/api/paas/v4/chat/completions"
+vox-code
+```
+
+### Example: DeepSeek
+
+```bash
+export DEEPSEEK_API_KEY="your_key"
+export DEEPSEEK_MODEL="deepseek-chat"
+export DEEPSEEK_BASE_URL="https://api.deepseek.com/chat/completions"
+vox-code
+```
+
+### Example: Qwen
+
+```bash
+export QWEN_API_KEY="your_key"
+export QWEN_MODEL="qwen-plus"
+export QWEN_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
+vox-code
+```
+
+兼容 DashScope 命名：
+
+```bash
+export DASHSCOPE_API_KEY="your_key"
+export DASHSCOPE_MODEL="qwen-plus"
+export DASHSCOPE_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
+vox-code
+```
+
+### Example: Ollama
+
+```bash
+export OLLAMA_MODEL="qwen2.5:7b"
+export OLLAMA_BASE_URL="http://localhost:11434"
+vox-code
+```
+
+## Common Commands
+
+| Command | Description |
+| --- | --- |
+| `vox-code init` | 初始化模型配置 |
+| `vox-code config-path` | 查看配置文件路径 |
+| `/model <preset-id\|provider[:model]>` | 切换模型 |
+| `/team` | 切换运行模式 |
+| `/style <work\|pet>` | 切换展示风格 |
+| `/memory` | 查看记忆状态 |
+| `/policy` | 查看安全策略 |
+| `/audit` | 查看最近审计日志 |
+
+## Desktop GUI
+
+`vox-pet` 会启动桌宠界面，适合偏轻量、陪伴式的交互方式。
+
+GUI 当前支持：
+
+- 跟随全局 CLI 配置
+- 独立 GUI 模型配置
+- OpenAI Compatible 网关
+- Qwen API 标签显示
+
+如果 `PySide6` 不可用，GUI 无法启动，但 CLI 仍可正常使用。
+
+如果你要把 GUI 一起装上：
+
+```bash
+pip install "vox-code[gui]"
+```
+
+## Project Layout
+
+```text
+voxcli/
+├── agent/       # Agent、Plan-and-Execute、多 Agent 协作
+├── cli/         # CLI 入口与命令解析
+├── config.py    # 配置读取与持久化
+├── gui/         # 桌宠 GUI
+├── hitl/        # 人工审批与交互控制
+├── llm/         # 模型接入层
+├── memory/      # 长短期记忆
+├── rag/         # 索引、切块、检索、嵌入
+├── runtime/     # 会话控制器
+├── tool/        # 工具注册与调用
+└── web/         # Web 搜索与抓取
+```
+
+## Development
+
+常用开发命令：
+
+```bash
+vox-code
+vox-pet
+vox-code config-path
+```
+
+如果你想快速验证配置是否生效，推荐先跑：
+
+```bash
+vox-code init
+```

vox_code-2.0.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "vox-code"
+version = "2.0.0"
+description = "Web-aware Tool CLI - 支持 ReAct、Plan-and-Execute、Memory、RAG、Multi-Agent、HITL"
+readme = "README.md"
+requires-python = ">=3.11"
+keywords = ["ai", "cli", "agent", "rag", "developer-tools", "llm"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "httpx>=0.27,<1",
+    "python-dotenv>=1.0,<2",
+    "pyyaml>=6.0,<7",
+    "beautifulsoup4>=4.12,<5",
+    "lxml>=5.1,<6",
+]
+
+[project.optional-dependencies]
+gui = [
+    "PySide6>=6.8,<7",
+]
+
+[project.scripts]
+vox-code = "voxcli.__main__:main"
+vox-pet = "voxcli.gui.main:main"
+
+[project.urls]
+Homepage = "https://github.com/faliang1129/vox-cli"
+Repository = "https://github.com/faliang1129/vox-cli"
+Issues = "https://github.com/faliang1129/vox-cli/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["voxcli"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/README.md",
+    "/pyproject.toml",
+    "/.env.example",
+    "/voxcli",
+]

vox_code-2.0.0/voxcli/__init__.py

@@ -0,0 +1,3 @@
+"""Vox Code - Web-aware Tool CLI"""
+
+__version__ = "2.0.0"

vox_code-2.0.0/voxcli/__main__.py

@@ -0,0 +1,5 @@
+"""Vox Code - Web-aware Tool CLI 入口点"""
+
+from .cli.main import main
+
+main()

vox_code-2.0.0/voxcli/agent/__init__.py

@@ -0,0 +1,12 @@
+from .agent_budget import AgentBudget, ExitReason
+from .roles import AgentRole, AgentMessage, AgentMessageType
+from .agent import Agent
+from .sub_agent import SubAgent
+from .plan_execute_agent import PlanExecuteAgent
+from .agent_orchestrator import AgentOrchestrator
+
+__all__ = [
+    "AgentBudget", "ExitReason",
+    "AgentRole", "AgentMessage", "AgentMessageType",
+    "Agent", "SubAgent", "PlanExecuteAgent", "AgentOrchestrator",
+]