vox-code 2.0.0__py3-none-any.whl

vox_code-2.0.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,88 @@
+voxcli/__init__.py,sha256=GYrhHafo7zbdTcbAKYA7RBQukDfPCYOQ_NiJ-USyQRI,59
+voxcli/__main__.py,sha256=5fctwucrgjkuutd6qksj0xkHji8K8NQUjWFiia_--S8,82
+voxcli/catalog.py,sha256=6UJTai6Es8iuIqWvPw7GvvBlfJDTj8AxgWDBLWMhPWw,19841
+voxcli/chat.py,sha256=Ntm1H599bQcoSxQBsL8DXki6ZVshiUcvOrS-fnJ7g-4,2508
+voxcli/config.py,sha256=skFJYzSLKBM6v2w9dJqeIFHVwEiQ5hfE2QhLJfNcJLQ,18126
+voxcli/agent/__init__.py,sha256=-txM8Athdw-BUtnY6lDqkaQRk_KkVMfJh33wsxV71ZM,434
+voxcli/agent/agent.py,sha256=2-_XJRbGiYql1dII9MOufZaGDh-WMMfrPeZ_3vmBBAs,19040
+voxcli/agent/agent_budget.py,sha256=08g9H8Vme8B5t9jHdC2Ez9gco3g1CyCAaf0x81fT0C8,4741
+voxcli/agent/agent_orchestrator.py,sha256=TL1YSPXF0Ed6ro00Xb2ISDwXn10XDfQq_GTwXlu3XMw,17497
+voxcli/agent/plan_execute_agent.py,sha256=-urg6WIN2ewy_GGc-sDYC7JYC6uVhA-xUv4IRZX2RP4,21185
+voxcli/agent/roles.py,sha256=MOcafuy56K136yyHgQLjP254Mi3dUfO2mDgeMpzO0Lw,2619
+voxcli/agent/sub_agent.py,sha256=VOePDPQKIwTjgDGn1FxX1mock3hDtv3Pcclgj4HSxrQ,14516
+voxcli/cli/__init__.py,sha256=sRSOnFTyiUuTiYkhxuz8pGv-hPX21B9mHn0Xsq-Qfdo,154
+voxcli/cli/main.py,sha256=qA8Qs1se9qH7HgedLBuLzg8Luc0f6DmyCmVZcXAPurQ,16214
+voxcli/cli/parser.py,sha256=FF1j6kddtYuRkzRjfK1EJBPdHofhHqeu7Qn4TpkZvq0,2950
+voxcli/gui/__main__.py,sha256=vBQ82334kX06ImDbFlPFgiBRiLIinwNk3z8Khs6hd74,31
+voxcli/gui/main.py,sha256=f7TFs2unJsUgY6U-guEtfjjLphLVGb6IG84bXkgIS6U,534
+voxcli/gui/pet_app.py,sha256=ld1-6QdsvOqYQYwmpMHHwL94nInlQzFcUzg6pcJCeW0,177
+voxcli/gui/pet/__init__.py,sha256=XDLprMJsIgrwTfe3hdGoqz_ot_pCY3pf-g2nkGNweHg,130
+voxcli/gui/pet/base.py,sha256=8faA_Jn3q1oCiFm4byq_883MEcDS2w0yrelVoRmcAcI,2069
+voxcli/gui/pet/coordinator.py,sha256=o9tTSBMbs48CE3bVNA4Xu4lRIjCpMgdPjh-wMD8iC8w,37214
+voxcli/gui/pet/data.py,sha256=FtVL1U0lnAAvXdt2dGQ-F3Fz0U-Mk7mEkcrTJZKOUK4,15056
+voxcli/gui/pet/widgets.py,sha256=MnXWVw8cbT8tvsVLHIaFTRGhlQDGAtuRvPTtYlJewZo,26104
+voxcli/gui/pet/windows.py,sha256=fTcNGFkfZ_hPlnFSIvI1HZVC8fgO84rVbcBShFH1AB8,88614
+voxcli/gui/pet/workers.py,sha256=EeXmTUnNL7o_SGqvDjfbx6CDvffcxdUwVwqwcqUodn0,1731
+voxcli/hitl/__init__.py,sha256=z00d0b5-Ysai8_9F9zPr6pN3hxW4LV8EpxG2-o-bGQ4,370
+voxcli/hitl/handler.py,sha256=latqRQeQt-ZXQPvjpogugPYDWjw_GNxii5V_n1suiXA,244
+voxcli/hitl/policy.py,sha256=jO8AMwDF3ROVJK-dIhWVQzKnbOlyEOWMW7Pl2O7lgpE,955
+voxcli/hitl/request.py,sha256=fOprouVx51Ibiav_KQPT2z4lAGd7uG948WcCJtSA-Ps,285
+voxcli/hitl/result.py,sha256=q6eBTmhN9LdCyiAYlnRb2lQhp44U54Kl_HUFtq62vxs,217
+voxcli/hitl/terminal_handler.py,sha256=PLxb2W6aAmKpaUvQA2-YjtXNmSUURK17r_b6MGpd0L0,2410
+voxcli/hitl/tool_registry.py,sha256=in8nfal9v6lxZs_P0_Er2Gdundx4Y55qxp63MoBck4w,2268
+voxcli/llm/base.py,sha256=HuK6HE_ajw6IpTJuBXrPuSwRf7lEjapcx5esqK53cRM,2466
+voxcli/llm/factory.py,sha256=VXEzOJA62Xd19eZZ4y_i4k3Ww291zCUyL-aXeRGiGLc,5549
+voxcli/llm/ollama_client.py,sha256=dGsfwdf6O4ilHkqRFYK1kI8HeIUi5eltdPAYvnKvwQI,4422
+voxcli/llm/openai_compatible.py,sha256=_BHxflsp6OoAqcVFL2WFofrJmGALWMHDDqYoor5zUJM,8606
+voxcli/memory/base.py,sha256=j5_w3bUAJz04onBsm4y-umQ2HafKQrTqr5S_5pAAtEo,485
+voxcli/memory/budget.py,sha256=d_PLK36EPm3r0Tmdf0mUo2Vtr6TVlbsBu5PqtQHTBJM,2045
+voxcli/memory/compressor.py,sha256=xpkzKvRzU3jE7gQNzGTfmF3uAde8M918Mv3ptnrgySs,6925
+voxcli/memory/entry.py,sha256=rsrifxHDGmq4gHZLzwxJLuQwIeW51jLzgZMfnYnFIqE,848
+voxcli/memory/long_term.py,sha256=puZ5kKnpz4IjTXvM75c0hNGqOIJD6ppptT4I8HuL6Kw,4414
+voxcli/memory/manager.py,sha256=y6sBR4-2SLi2FiIrgG0hLZwe3zcdSM-f4fODHJJQF18,3644
+voxcli/memory/retriever.py,sha256=5fRf9bvvx0yZT_23TXsdqfflyGtuB2VobcduYqVhdjo,2566
+voxcli/memory/short_term.py,sha256=HuJ2rHNk6GTlNzibUPK5CfNIIw9QJVOYVONgnifyCcQ,2786
+voxcli/memory/tokenizer.py,sha256=dp2eAJHmrDCdYvsxk0FIMQmReyXCipJ4UlCKFwIxmes,579
+voxcli/plan/__init__.py,sha256=tInphORs6LntQU_E3n4ZF90_RYNkTcDHKbf-FuNtn58,216
+voxcli/plan/execution_plan.py,sha256=lYmo7GswspehtxG7mVuizElEdOh4J6pFhPTE-SBIcEk,7928
+voxcli/plan/planner.py,sha256=o-mIJngeXX67Ba5zFTJQicgkuHULLvrUyh3rTo2g_t8,7237
+voxcli/plan/task.py,sha256=DMgerJ2VJggYw_3cRAra233rPZMogmrMNhja5lREZcg,3284
+voxcli/policy/audit_log.py,sha256=5it0a70yEBeDrUg0V_B8Rmwk2wbdGQUCZ-57CZqWlPU,3424
+voxcli/policy/command_guard.py,sha256=wfeTaa7x4cSP2iF3qp2wH85gQCtM9LMDDPH4PqNykDw,1413
+voxcli/policy/exception.py,sha256=gYRA2uDTaJyPKlUv_Lt3FLIJBNOKiKt0dUrQCL-OuFQ,143
+voxcli/policy/path_guard.py,sha256=xkNeby35Pl0HZjF0K-a730krAxKawRIG2Zzi2TxA68o,984
+voxcli/prompting/__init__.py,sha256=BtNZgEXe8ge10BnxvQQ2h1ruos8Zx2cjZICHRz1NE2A,169
+voxcli/prompting/presenter.py,sha256=6M-KjZUQsisMq8BumF_qMRaOo8EMjQPi09i7MfmxV5I,5586
+voxcli/rag/__init__.py,sha256=2TmQ900SqglehECzTwUvY_wgrnaSbmqTKq1ZQOPcplg,551
+voxcli/rag/analyzer.py,sha256=8vd8RcXiFNNZ34Ldqdh_rQR3u2jh4h9U4jk3p3nICSc,3334
+voxcli/rag/chunk.py,sha256=xCzGDX6Wilqh6_Ml8JpTVg4cq_e9DaP_tCtGJzBW63U,402
+voxcli/rag/chunker.py,sha256=OGocaw7BRo9T-aumywkHX9r3EfrH4rufMWi_ukI0Prw,5046
+voxcli/rag/embedding.py,sha256=isdVMjU6px4gZvUvqQB-moi5BzQui4BprqWEvhLJ6tE,2422
+voxcli/rag/formatter.py,sha256=zMK8NZVYZyMiU3k0liOOhQdkBrkp9AH-UiKY66p5Osg,1474
+voxcli/rag/index.py,sha256=bS8MQZ9wlXfXYgh3qpIWBByK1MuUlNfXknZVL2kLK9c,3528
+voxcli/rag/relation.py,sha256=pAdEsYnhNcbOTV8_WLS5YYCZWBjUuAK4kW7GZgjmDsI,412
+voxcli/rag/retriever.py,sha256=3kBE-T18rUKZoLy7722rRFAJH7ZNbZfCdS2-qBMUHpI,1668
+voxcli/rag/store.py,sha256=tInPP6iqWXU4EE0iu98MK44nf9_WkEHM9Wd_4Z4FeGc,5582
+voxcli/rag/tokenizer.py,sha256=hcrwFM79ew8Y0XKnPNGjOzrZuCUqCTsXWrgiJHAqMR0,685
+voxcli/runtime/__init__.py,sha256=nBdlNK9X1rnFmAzJeOW1OuihfqcFGGAuNa1QWtRJwsM,124
+voxcli/runtime/session_controller.py,sha256=gE60vs2LWjAaf0dJtySoi6JIy_JzWZLx67T5qC-HRPA,16101
+voxcli/tool/__init__.py,sha256=LrqTddNuwj9EYWvVAi42ZSLXq8jYiDB91ApB4lp11u8,166
+voxcli/tool/tool_registry.py,sha256=U1NHJnYHKBte9MWJ9xWOWtvUSt0mEctym4p9P8_k4zI,18477
+voxcli/util/animation.py,sha256=aq2aIoxy7xHTt9_519SRV0XpFYQRBZOXnnygm20-gGQ,7463
+voxcli/util/ansi.py,sha256=W44xlprPDA5g1n5BNTa1eDyYNn3GWOzjrwj2eDvKDd8,1834
+voxcli/util/markdown.py,sha256=Ord3oEbuCZM9xpVwJlOM6qz7-yQ5Hc_sGxdvSJgTNcY,2907
+voxcli/web/__init__.py,sha256=Rdj_Y0x0fgeBzckRsNuImYuMQH5ezm6MJgragBw51VY,609
+voxcli/web/base.py,sha256=-kLhAAZyAuVI0PHAZBxgeVJtX1o-TuW2F9vuDSigk4c,362
+voxcli/web/extractor.py,sha256=WWSC3Nokw53nCxPuYveGD5-AymHJXnI5q7O3qmcftEA,3062
+voxcli/web/factory.py,sha256=kJ4lYgdIitGNSziVjkDzpPNNHQMU8jMkhmPdml19A98,1334
+voxcli/web/fetch_result.py,sha256=mZZspTAluCQuyHz-alNGnh2IPu22Pmhyko2muOVei34,664
+voxcli/web/fetcher.py,sha256=Ru5A-SgM9lHM36AFOR3WjW-ihicYL4Tdyoma_8ylE7w,1270
+voxcli/web/network_policy.py,sha256=Q6QF_hjjE8PXNuDJq4WdDpB9_uI-vYIaG9A41bu4Pa4,1720
+voxcli/web/result.py,sha256=iHHGiQLcy9aOL0LdFp_1Q9dexxk3F9UQqpnIYSlPrbc,391
+voxcli/web/searxng.py,sha256=ZQwhzKwwlthoAKGIgcq5RsW5wB_A-8wkuWvmYa2dEIg,1632
+voxcli/web/serpapi.py,sha256=isV0d6CQ7CTpWxF0lcPIwQxu5OdiuliRhpS3HiuoiFY,1483
+voxcli/web/zhipu.py,sha256=_KrQvlEh-T3f6AUyPnMXZek3-U70nO93pwyr4smysLk,1717
+vox_code-2.0.0.dist-info/METADATA,sha256=f4DkLzrQYI7W7x5Ui3w_I6Ix2_njagGrS8N5d0kORVc,6030
+vox_code-2.0.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+vox_code-2.0.0.dist-info/entry_points.txt,sha256=vj-Dd_XJ4t3bTKZ3rT5FZmXx2uOXa3Y9e_UTEGeDfNU,81
+vox_code-2.0.0.dist-info/RECORD,,

vox_code-2.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

vox_code-2.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+vox-code = voxcli.__main__:main
+vox-pet = voxcli.gui.main:main

voxcli/__init__.py

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

voxcli/__main__.py

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

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",
+]