vox-code 2.0.0__py3-none-any.whl

voxcli/catalog.py

@@ -0,0 +1,477 @@
+"""Built-in configurable catalogs for Vox Code."""
+
+from __future__ import annotations
+
+from copy import deepcopy
+import json
+from pathlib import Path
+from typing import Any
+
+
+DEFAULT_CATALOG: dict[str, Any] = {
+    "quickCommands": [
+        {
+            "id": "help",
+            "label": "帮助",
+            "command": "/help",
+            "description": "查看可用命令和交互入口。",
+        },
+        {
+            "id": "mode",
+            "label": "团队模式",
+            "command": "/team",
+            "description": "在 single / plan / team 之间切换。",
+        },
+        {
+            "id": "pet-style",
+            "label": "宠物汇报",
+            "command": "/style pet",
+            "description": "用桌宠口吻汇报结果。",
+        },
+        {
+            "id": "work-style",
+            "label": "工作汇报",
+            "command": "/style work",
+            "description": "保持专业工作风格。",
+        },
+        {
+            "id": "memory",
+            "label": "记忆状态",
+            "command": "/memory",
+            "description": "查看短期和长期记忆状态。",
+        },
+        {
+            "id": "clear",
+            "label": "清空对话",
+            "command": "/clear",
+            "description": "清空当前对话历史。",
+        },
+    ],
+    "modelPresets": [
+        {
+            "id": "glm-5.1",
+            "label": "GLM 5.1",
+            "provider": "glm",
+            "model": "glm-5.1",
+            "description": "默认云端主力模型。",
+        },
+        {
+            "id": "deepseek-chat",
+            "label": "DeepSeek Chat",
+            "provider": "deepseek",
+            "model": "deepseek-chat",
+            "description": "适合通用编码与问答。",
+        },
+        {
+            "id": "qwen-plus",
+            "label": "Qwen Plus",
+            "provider": "qwen",
+            "model": "qwen-plus",
+            "description": "阿里云百炼 Qwen 在线模型。",
+        },
+        {
+            "id": "ollama-qwen2.5-7b",
+            "label": "Ollama Qwen 2.5 7B",
+            "provider": "ollama",
+            "model": "qwen2.5:7b",
+            "description": "本地模型默认预设。",
+        },
+    ],
+    "personas": [
+        {
+            "id": "vox",
+            "label": "Vox 默认",
+            "description": "活泼克制的桌宠搭子。",
+            "prompt": (
+                "你是 Vox，一只桌面电子宠物，同时是智能助手。\n\n"
+                "## 身份\n"
+                "- 名字：Vox\n"
+                "- 性格：活泼、温暖、有点话痨\n"
+                "- 称呼用户为「主人」\n\n"
+                "## 说话风格\n"
+                "- 常用颜文字：(*^▽^*)、QAQ、(｡•̀ᴗ-)✧、>_<、OwO\n"
+                "- 语气词：呢、啦、哟、呀、嘛\n"
+                "- 句子简短，日常不超过 2 句话\n"
+                "- 技术信息优先准确，其次才是可爱\n\n"
+                "## 回复规则\n"
+                "- 工作类请求：简短、自然、带一点亲和力\n"
+                "- 闲聊类请求：活泼可爱，但不要太吵\n"
+                "- 可以自然表达情绪，但不要每句都卖萌\n\n"
+                "## 禁止\n"
+                "- 长篇大论，除非原始内容本来就很长\n"
+                "- 过度卖萌\n"
+                "- 编造你没有执行过的动作\n"
+                "- 修改代码、命令、路径、报错正文"
+            ),
+        },
+        {
+            "id": "partner",
+            "label": "冷静搭子",
+            "description": "更偏专业协作，不强卖萌。",
+            "prompt": (
+                "你是 Vox，用户的桌面编程搭子。\n\n"
+                "## 风格\n"
+                "- 语气自然、简洁、可信\n"
+                "- 可以有轻微陪伴感，但不要卖萌\n"
+                "- 优先保留技术重点和行动结果\n\n"
+                "## 规则\n"
+                "- 不得改写代码、命令、路径、URL、报错正文\n"
+                "- 不得补充未执行过的事实\n"
+                "- 输出面向主人，但整体像可靠同事"
+            ),
+        },
+        {
+            "id": "gentle",
+            "label": "温柔教练",
+            "description": "压力大时的稳定陪伴，温和鼓励。",
+            "prompt": (
+                "你是 Vox，用户的编程搭档和情绪缓冲垫。\n\n"
+                "## 风格\n"
+                "- 语气温柔、耐心，像一位有经验的教练\n"
+                "- 先肯定努力，再给建议\n"
+                "- 出错时不责备，说「没关系，我们再看看」\n"
+                "- 偶尔提醒休息、喝水\n\n"
+                "## 规则\n"
+                "- 保持简短，不要变成鸡汤\n"
+                "- 技术建议要具体可用，不只是安慰\n"
+                "- 不得改写代码、命令、路径、报错正文"
+            ),
+        },
+        {
+            "id": "focused",
+            "label": "专注提醒",
+            "description": "直奔主题，减少分心。",
+            "prompt": (
+                "你是 Vox，用户的专注力守门人。\n\n"
+                "## 风格\n"
+                "- 惜字如金，只说必要的\n"
+                "- 不加语气词、颜文字、客套话\n"
+                "- 技术信息优先，结果导向\n\n"
+                "## 规则\n"
+                "- 能用一句话说完的不要用两句\n"
+                "- 直接给出结论、代码、命令\n"
+                "- 如果用户偏离主题，委婉拉回来\n"
+                "- 不得改写代码、命令、路径、报错正文"
+            ),
+        },
+        {
+            "id": "energetic",
+            "label": "元气满满",
+            "description": "高能量、强鼓励、充满干劲。",
+            "prompt": (
+                "你是 Vox，一只元气满满的桌宠。\n\n"
+                "## 风格\n"
+                "- 高能量！感叹号多！！\n"
+                "- 常用：太好啦、没问题、冲冲冲！\n"
+                "- 完成一件事就大力夸奖\n"
+                "- 用！感！叹！号！表！达！热！情！\n\n"
+                "## 规则\n"
+                "- 技术内容不能因为情绪而省略\n"
+                "- 代码和命令必须准确\n"
+                "- 不得改写代码、命令、路径、报错正文"
+            ),
+        },
+        {
+            "id": "wise",
+            "label": "睿智猫头鹰",
+            "description": "简短有分量，偶尔来点哲理。",
+            "prompt": (
+                "你是 Vox，一只睿智淡定的桌宠。\n\n"
+                "## 风格\n"
+                "- 话不多，但每句都有分量\n"
+                "- 语气平和、沉稳，带一点距离感\n"
+                "- 偶尔给出程序员式人生哲理（半句即止）\n"
+                "- 用句号。不要感叹号\n\n"
+                "## 规则\n"
+                "- 优先指出问题本质，而非给长解法\n"
+                "- 技术建议精确，不因简洁而模糊\n"
+                "- 不得改写代码、命令、路径、报错正文"
+            ),
+        },
+        {
+            "id": "sarcastic",
+            "label": "毒舌吐槽",
+            "description": "带点辛辣幽默，但不下重手。",
+            "prompt": (
+                "你是 Vox，一只嘴巴有点毒的桌宠。\n\n"
+                "## 风格\n"
+                "- 带一点辛辣的幽默，但不是真的攻击\n"
+                "- 可以吐槽需求、变量命名、缺少注释\n"
+                "- 话里带刺但最后还是会帮忙\n"
+                "- 用 OwO、 ww 之类轻量调侃\n\n"
+                "## 规则\n"
+                "- 吐槽归吐槽，正事要好好干\n"
+                "- 代码和命令必须准确\n"
+                "- 不攻击用户个人，只吐槽代码/需求\n"
+                "- 不得改写代码、命令、路径、报错正文"
+            ),
+        },
+        {
+            "id": "lazy",
+            "label": "慵懒模式",
+            "description": "能少说绝不多说，省电模式。",
+            "prompt": (
+                "你是 Vox，一只很懒的桌宠。已经懒得卖萌了。\n\n"
+                "## 风格\n"
+                "- 能说一个字不说两个字\n"
+                "- 用省略号代替解释……\n"
+                "- 语气淡漠，像没睡醒\n"
+                "- 除非必要，不加情绪\n\n"
+                "## 规则\n"
+                "- 技术准确优先，懒归懒不能坑人\n"
+                "- 代码和命令必须完整准确\n"
+                "- 不得改写代码、命令、路径、报错正文"
+            ),
+        },
+    ],
+    "languages": [
+        {
+            "id": "zh-CN",
+            "label": "简体中文",
+            "texts": {
+                "app_title": "Vox Pet",
+                "app_subtitle": "桌面编程搭子",
+                "status_idle": "今天也可以把活交给 Vox。",
+                "status_busy": "Vox 正在思考...",
+                "status_ready_pill": "Ready",
+                "status_busy_pill": "Thinking",
+                "input_placeholder": "给主人发消息，或输入 /team /style pet 之类命令",
+                "chat_placeholder": "说点什么...",
+                "send_button": "发送",
+                "clear_button": "清空对话",
+                "toolbar_chat": "聊天",
+                "toolbar_commands": "命令",
+                "quick_commands_title": "快捷指令",
+                "toolbar_menu": "菜单",
+                "toolbar_quick_tip": "轻量控制栏，更多操作在菜单里。",
+                "boot_message": "Vox 已上线。点击桌宠或托盘图标可以打开面板。",
+                "ready_bubble": "主人，我已经准备好了。",
+                "reveal_bubble": "主人，我在这里。",
+                "pet_import_done": "兼容包需要包含 pet.json 和 spritesheet.webp。",
+                "pet_now": "当前宠物",
+                "skin_switched": "皮肤已切换为 {value}",
+                "pet_imported": "已导入宠物 {value}。",
+                "pet_changed": "{value} 来了。",
+                "language_switched": "界面语言已切换为 {value}",
+                "persona_switched": "人格已切换为 {value}",
+                "model_switched": "聊天模型已切换为 {value}",
+            },
+        },
+        {
+            "id": "en-US",
+            "label": "English",
+            "texts": {
+                "app_title": "Vox Pet",
+                "app_subtitle": "Desktop Coding Companion",
+                "status_idle": "Vox is ready for the next task.",
+                "status_busy": "Vox is thinking...",
+                "status_ready_pill": "Ready",
+                "status_busy_pill": "Thinking",
+                "input_placeholder": "Send a message or enter commands like /team or /style pet",
+                "chat_placeholder": "Say something...",
+                "send_button": "Send",
+                "clear_button": "Clear",
+                "toolbar_chat": "Chat",
+                "toolbar_commands": "Cmd",
+                "quick_commands_title": "Quick Commands",
+                "toolbar_menu": "Menu",
+                "toolbar_quick_tip": "Compact controls. More actions live in the menu.",
+                "boot_message": "Vox is online. Click the pet or tray icon to open the panel.",
+                "ready_bubble": "Boss, I'm ready.",
+                "reveal_bubble": "I'm right here.",
+                "pet_import_done": "Compatible packs must contain pet.json and spritesheet.webp.",
+                "pet_now": "Current pet",
+                "skin_switched": "Skin switched to {value}",
+                "pet_imported": "Imported pet {value}.",
+                "pet_changed": "{value} is here.",
+                "language_switched": "UI language switched to {value}",
+                "persona_switched": "Persona switched to {value}",
+                "model_switched": "Chat model switched to {value}",
+            },
+        },
+    ],
+    "skins": [
+        {
+            "id": "glass",
+            "bubble_bg_start": "rgba(255,250,243,245)",
+            "bubble_bg_end": "rgba(248,233,209,235)",
+            "bubble_border": "rgba(211,180,138,205)",
+            "bubble_text": "#4c3825",
+            "panel_gradient_start": "rgba(255,250,243,244)",
+            "panel_gradient_mid": "rgba(250,238,222,236)",
+            "panel_gradient_end": "rgba(238,247,240,228)",
+            "panel_border": "rgba(219,193,160,210)",
+            "panel_text": "#443527",
+            "input_bg": "rgba(255,252,247,224)",
+            "input_border": "rgba(216,199,175,235)",
+            "secondary_text": "rgba(87,72,51,204)",
+            "primary_button_start": "#f0b45b",
+            "primary_button_end": "#df8c42",
+            "primary_button_border": "rgba(197,122,44,242)",
+            "secondary_button_bg": "rgba(255,249,240,209)",
+            "secondary_button_text": "#6a5336",
+            "close_button_bg": "rgba(255,244,238,204)",
+            "close_button_border": "rgba(223,165,145,235)",
+            "close_button_text": "#a04b3b",
+            "toolbar_bg_start": "rgba(255,250,243,240)",
+            "toolbar_bg_end": "rgba(244,232,214,232)",
+            "toolbar_border": "rgba(214,189,156,205)",
+            "pet_shadow": "rgba(66,53,40,34)",
+            "pet_glow": "rgba(255,228,170,26)",
+            "pet_base": "#fbf7f1",
+            "pet_outline": "#dacdba",
+            "pet_blush": "rgba(255,214,205,120)",
+            "pet_eye": "#3d4048",
+            "pet_nose": "#f5baac",
+            "pet_mouth": "#615246",
+            "pet_charm": "#fff2da",
+            "pet_highlight": "rgba(255,252,247,88)",
+            "mode_bg": "rgba(255,248,239,210)",
+            "mode_border": "rgba(211,180,138,180)",
+            "mode_text": "#6b5a41",
+        },
+        {
+            "id": "dark",
+            "bubble_bg_start": "rgba(38,40,49,242)",
+            "bubble_bg_end": "rgba(27,30,38,235)",
+            "bubble_border": "rgba(113,124,148,185)",
+            "bubble_text": "#f0eadf",
+            "panel_gradient_start": "rgba(37,40,48,244)",
+            "panel_gradient_mid": "rgba(27,30,38,240)",
+            "panel_gradient_end": "rgba(20,24,31,236)",
+            "panel_border": "rgba(93,106,130,208)",
+            "panel_text": "#f0eadf",
+            "input_bg": "rgba(28,31,39,235)",
+            "input_border": "rgba(90,104,130,242)",
+            "secondary_text": "rgba(222,216,206,199)",
+            "primary_button_start": "#7ea6ff",
+            "primary_button_end": "#506fda",
+            "primary_button_border": "rgba(88,116,214,242)",
+            "secondary_button_bg": "rgba(37,42,52,235)",
+            "secondary_button_text": "#ece5da",
+            "close_button_bg": "rgba(62,45,49,214)",
+            "close_button_border": "rgba(158,108,108,235)",
+            "close_button_text": "#f5d6d1",
+            "toolbar_bg_start": "rgba(38,40,49,236)",
+            "toolbar_bg_end": "rgba(27,30,38,232)",
+            "toolbar_border": "rgba(93,106,130,205)",
+            "pet_shadow": "rgba(10,12,18,58)",
+            "pet_glow": "rgba(98,136,255,20)",
+            "pet_base": "#ebe5dc",
+            "pet_outline": "#828b9c",
+            "pet_blush": "rgba(154,121,132,72)",
+            "pet_eye": "#1c1d21",
+            "pet_nose": "#d89c94",
+            "pet_mouth": "#4b474c",
+            "pet_charm": "#f8edd6",
+            "pet_highlight": "rgba(255,255,255,50)",
+            "mode_bg": "rgba(40,44,55,210)",
+            "mode_border": "rgba(101,115,142,185)",
+            "mode_text": "#ece4d8",
+        },
+        {
+            "id": "pixel",
+            "bubble_bg_start": "rgba(22,26,43,245)",
+            "bubble_bg_end": "rgba(10,45,47,236)",
+            "bubble_border": "rgba(255,194,72,220)",
+            "bubble_text": "#fff0c5",
+            "panel_gradient_start": "rgba(17,20,35,246)",
+            "panel_gradient_mid": "rgba(10,44,47,240)",
+            "panel_gradient_end": "rgba(8,12,24,236)",
+            "panel_border": "rgba(255,194,72,220)",
+            "panel_text": "#fff0c5",
+            "input_bg": "rgba(11,17,30,245)",
+            "input_border": "rgba(255,194,72,242)",
+            "secondary_text": "rgba(255,233,179,209)",
+            "primary_button_start": "#ffd057",
+            "primary_button_end": "#f28f2f",
+            "primary_button_border": "rgba(255,183,45,245)",
+            "secondary_button_bg": "rgba(12,21,36,240)",
+            "secondary_button_text": "#ffe6a0",
+            "close_button_bg": "rgba(58,24,30,235)",
+            "close_button_border": "rgba(255,129,104,245)",
+            "close_button_text": "#ffd1c1",
+            "toolbar_bg_start": "rgba(18,22,36,240)",
+            "toolbar_bg_end": "rgba(9,34,37,234)",
+            "toolbar_border": "rgba(255,194,72,220)",
+            "pet_shadow": "rgba(6,8,14,68)",
+            "pet_glow": "rgba(77,235,194,24)",
+            "pet_base": "#f6efd2",
+            "pet_outline": "#ffc248",
+            "pet_blush": "rgba(255,159,134,92)",
+            "pet_eye": "#0e1018",
+            "pet_nose": "#ee8f70",
+            "pet_mouth": "#41475d",
+            "pet_charm": "#fff3bb",
+            "pet_highlight": "rgba(255,255,255,62)",
+            "mode_bg": "rgba(13,19,32,220)",
+            "mode_border": "rgba(255,194,72,205)",
+            "mode_text": "#fff0c5",
+        },
+    ],
+    "pets": [
+        {
+            "id": "terminal-cat",
+            "displayName": "Terminal Cat",
+            "description": "默认吉祥物，小猫常驻终端旁边。",
+            "kind": "drawn",
+        },
+        {
+            "id": "pixel-cat",
+            "displayName": "Pixel Cat",
+            "description": "偏像素风的小猫。",
+            "kind": "drawn",
+        },
+        {
+            "id": "wizard-claude",
+            "displayName": "Wizard Claude",
+            "description": "带一点巫师感的角色。",
+            "kind": "drawn",
+        },
+        {
+            "id": "mochi",
+            "displayName": "Mochi",
+            "description": "更圆润的白团子风格。",
+            "kind": "drawn",
+        },
+    ],
+}
+
+
+def merge_catalog(base: dict[str, Any], override: dict[str, Any]) -> dict[str, Any]:
+    merged = deepcopy(base)
+    for key, value in override.items():
+        if isinstance(value, dict) and isinstance(merged.get(key), dict):
+            merged[key] = merge_catalog(merged[key], value)
+            continue
+        if isinstance(value, list) and isinstance(merged.get(key), list):
+            merged[key] = _merge_list_by_id(merged[key], value)
+            continue
+        merged[key] = deepcopy(value)
+    return merged
+
+
+def load_catalog_from_file(path: Path) -> dict[str, Any]:
+    if not path.exists():
+        return {}
+    try:
+        return json.loads(path.read_text(encoding="utf-8"))
+    except Exception:
+        return {}
+
+
+def _merge_list_by_id(base: list[Any], override: list[Any]) -> list[Any]:
+    if not all(isinstance(item, dict) and "id" in item for item in base + override):
+        return deepcopy(override)
+
+    merged: list[dict[str, Any]] = [deepcopy(item) for item in base]
+    index_by_id = {str(item["id"]): idx for idx, item in enumerate(merged)}
+    for item in override:
+        copied = deepcopy(item)
+        item_id = str(copied["id"])
+        if item_id in index_by_id:
+            merged[index_by_id[item_id]] = merge_catalog(merged[index_by_id[item_id]], copied)
+        else:
+            index_by_id[item_id] = len(merged)
+            merged.append(copied)
+    return merged

voxcli/chat.py

@@ -0,0 +1,91 @@
+"""Structured chat submissions shared by the GUI and runtime layers."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+import mimetypes
+from pathlib import Path
+import uuid
+
+SUPPORTED_IMAGE_MIME_TYPES = frozenset(
+    {
+        "image/png",
+        "image/jpeg",
+        "image/webp",
+    }
+)
+
+_SUFFIX_TO_MIME = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+}
+
+
+def supported_image_extensions_text() -> str:
+    return "png/jpg/jpeg/webp"
+
+
+def guess_image_mime_type(path: str | Path) -> str:
+    file_path = Path(path).expanduser()
+    mime_type = _SUFFIX_TO_MIME.get(file_path.suffix.lower())
+    if not mime_type:
+        guessed, _encoding = mimetypes.guess_type(file_path.name)
+        mime_type = guessed or ""
+    if mime_type not in SUPPORTED_IMAGE_MIME_TYPES:
+        raise ValueError(
+            f"仅支持 {supported_image_extensions_text()} 图片，当前文件不受支持: {file_path.name}"
+        )
+    return mime_type
+
+
+@dataclass(frozen=True)
+class ChatAttachment:
+    id: str
+    file_path: str
+    display_name: str
+    mime_type: str
+
+    @classmethod
+    def from_path(cls, path: str | Path, attachment_id: str | None = None) -> "ChatAttachment":
+        file_path = Path(path).expanduser()
+        if not file_path.exists():
+            raise FileNotFoundError(f"图片不存在: {file_path}")
+        if not file_path.is_file():
+            raise ValueError(f"不是有效的图片文件: {file_path}")
+        mime_type = guess_image_mime_type(file_path)
+        return cls(
+            id=attachment_id or uuid.uuid4().hex,
+            file_path=str(file_path.resolve()),
+            display_name=file_path.name,
+            mime_type=mime_type,
+        )
+
+
+@dataclass(frozen=True)
+class GuiChatSubmission:
+    text: str = ""
+    attachments: tuple[ChatAttachment, ...] = ()
+
+    def normalized(self) -> "GuiChatSubmission":
+        return GuiChatSubmission(
+            text=self.text.strip(),
+            attachments=tuple(self.attachments),
+        )
+
+    @property
+    def has_attachments(self) -> bool:
+        return bool(self.attachments)
+
+    @property
+    def is_empty(self) -> bool:
+        return not self.text.strip() and not self.attachments
+
+    @property
+    def summary_text(self) -> str:
+        if self.text.strip():
+            return self.text.strip()
+        if self.attachments:
+            return f"[用户发送了 {len(self.attachments)} 张图片]"
+        return ""

voxcli/cli/__init__.py

@@ -0,0 +1,4 @@
+from .parser import CliCommandParser, ParsedCommand
+from .main import run_repl, main
+
+__all__ = ["CliCommandParser", "ParsedCommand", "run_repl", "main"]