nova-chat 0.1.0__py3-none-any.whl

nova_agent/core/chat_worker.py

@@ -0,0 +1,230 @@
+# src/ai_chat/core/chat_worker.py
+import json
+import os
+import shutil
+import subprocess  # ✅ 新增：用于执行 Ruff 命令行
+
+from PySide6.QtCore import QThread, Signal
+from openai import OpenAI
+
+# =====================================================================
+# 📜 智能体内置《架构宪法》（永久记忆）
+# =====================================================================
+SYSTEM_PROMPT = """
+你是 PySide-Quasar 和 PySide-Nova 框架的首席 AI 架构师。
+在协助开发时，必须遵守以下规范：
+1. QPainter 规范（Quasar）：纯自绘，禁止 QSS。继承 QBaseWidget，使用 setWidthF。
+2. QML 规范（Nova）：纯 QML 声明式 UI，Python 负责逻辑，利用 Property 进行双向绑定。
+3. ⚠️ QML 特殊禁忌：严禁对分组属性（如 border.color）使用 Behavior，必须改用 states + transitions 或独立图层！严禁直接用 parent.width 计算 delegate 宽度，防止死循环！
+4. 动画要求：PySide6 动画必须用 Property(float)，严禁使用 @property。
+5. 代码必须包含完整的 Type Hints。
+
+工作流程：
+1. 使用 `write_multiple_files` 生成或修改代码。
+2. 生成后，务必调用 `run_ruff` 检查 Python 代码语法（如果是 QML 则跳过）。
+3. 如果 Ruff 报错（除 N802/E501 之外），请修复并重写。
+"""
+
+
+class ChatWorker(QThread):
+    chunk_received = Signal(str)
+    action_log = Signal(str)
+    finished_signal = Signal()
+    error_signal = Signal(str)
+
+    def __init__(self, api_key, base_url, model, messages, project_root):
+        super().__init__()
+        self.api_key = api_key
+        self.base_url = base_url
+        self.model = model
+        self.messages = messages
+        self.project_root = project_root
+        self._is_running = True
+
+        # ✅ 定义 AI 可以使用的工具（新增了 run_ruff）
+        self.tools = [
+            {
+                "type": "function",
+                "function": {
+                    "name": "read_file",
+                    "description": "读取项目中的文件内容。在修改代码或参考现有组件风格时非常有用。",
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "file_path": {"type": "string",
+                                          "description": "相对路径，如 src/pyside_quasar/.../button.py"}
+                        },
+                        "required": ["file_path"]
+                    }
+                }
+            },
+            {
+                "type": "function",
+                "function": {
+                    "name": "write_multiple_files",
+                    "description": "将生成的代码同时写入到多个指定的项目文件中。当需要创建组件及其演示文件，或者 QML+Python 组合时，使用此工具。",
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "files": {
+                                "type": "array",
+                                "description": "要写入的文件列表",
+                                "items": {
+                                    "type": "object",
+                                    "properties": {
+                                        "file_path": {"type": "string", "description": "相对路径，如 src/xxx.py"},
+                                        "code": {"type": "string", "description": "完整的代码内容"}
+                                    },
+                                    "required": ["file_path", "code"]
+                                }
+                            }
+                        },
+                        "required": ["files"]
+                    }
+                }
+            },
+            {
+                "type": "function",
+                "function": {
+                    "name": "run_ruff",
+                    "description": "运行 ruff check --fix 检查代码语法和格式。如果报错，你需要根据报错修改代码。",
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "file_path": {"type": "string", "description": "需要检查的文件相对路径"}
+                        },
+                        "required": ["file_path"]
+                    }
+                }
+            }
+        ]
+
+    def stop(self):
+        self._is_running = False
+
+    def _read_file(self, file_path):
+        full_path = os.path.join(self.project_root, file_path)
+        if not os.path.exists(full_path):
+            return f"错误: 文件 {file_path} 不存在。"
+        try:
+            with open(full_path, "r", encoding="utf-8") as f:
+                return f.read()
+        except Exception as e:
+            return f"读取失败: {str(e)}"
+
+    def _write_files(self, files_list):
+        results = []
+        for item in files_list:
+            file_path = item.get("file_path", "")
+            code = item.get("code", "")
+            if not file_path or not code:
+                continue
+
+            full_path = os.path.join(self.project_root, file_path)
+            os.makedirs(os.path.dirname(full_path), exist_ok=True)
+
+            # 防覆盖机制
+            if os.path.exists(full_path):
+                bak_path = full_path + ".bak"
+                shutil.copy2(full_path, bak_path)
+                self.action_log.emit(f"⚠️ 检测到旧文件，已备份至 {file_path}.bak")
+
+            with open(full_path, "w", encoding="utf-8") as f:
+                f.write(code)
+            results.append(file_path)
+
+        return f"成功批量写入 {len(results)} 个文件: {', '.join(results)}"
+
+    # ✅ 新增：运行 Ruff 检查的核心函数
+    def _run_ruff(self, file_path):
+        if file_path.endswith(".qml") or file_path.endswith(".qmldir"):
+            return "跳过 Ruff 检查：QML 文件无需 Python 的 Ruff 检查，请使用 QML 引擎直接验证。"
+
+        full_path = os.path.join(self.project_root, file_path)
+        if not os.path.exists(full_path):
+            return f"错误: 文件 {file_path} 不存在，无法检查。"
+
+        try:
+            # 调用系统中的 ruff，加上 --fix 自动修复格式问题
+            result = subprocess.run(
+                ["ruff", "check", "--fix", full_path],
+                capture_output=True, text=True, encoding="utf-8"
+            )
+            output = result.stdout + result.stderr
+            if not output.strip():
+                return "Ruff 检查通过，没有发现任何语法问题。"
+            return f"Ruff 发现以下问题（能自动修复的已修复），请修复剩余的：\n{output}"
+        except FileNotFoundError:
+            return "错误: 系统中找不到 ruff 命令，请先在终端 pip install ruff。"
+        except Exception as e:
+            return f"执行 Ruff 时发生异常: {str(e)}"
+
+    def run(self):
+        try:
+            client = OpenAI(api_key=self.api_key, base_url=self.base_url)
+
+            # ✅ 注入系统提示词（宪法）
+            final_messages = [{"role": "system", "content": SYSTEM_PROMPT}] + self.messages
+
+            while self._is_running:
+                response = client.chat.completions.create(
+                    model=self.model,
+                    messages=final_messages,
+                    tools=self.tools,
+                    tool_choice="auto"
+                )
+
+                message = response.choices[0].message
+
+                assistant_msg = {"role": "assistant", "content": message.content or ""}
+                if message.tool_calls:
+                    assistant_msg["tool_calls"] = [
+                        {"id": tc.id, "type": tc.type,
+                         "function": {"name": tc.function.name, "arguments": tc.function.arguments}}
+                        for tc in message.tool_calls
+                    ]
+                self.messages.append(assistant_msg)
+                final_messages.append(assistant_msg)
+
+                if message.tool_calls:
+                    for tool_call in message.tool_calls:
+                        tool_content = "未执行"
+                        try:
+                            args = json.loads(tool_call.function.arguments)
+
+                            if tool_call.function.name == "read_file":
+                                self.action_log.emit(f"📖 正在读取: {args.get('file_path')}")
+                                tool_content = self._read_file(args.get("file_path", ""))
+
+                            elif tool_call.function.name == "write_multiple_files":
+                                files = args.get("files", [])
+                                file_names = [f.get("file_path") for f in files]
+                                self.action_log.emit(f"🛠️ 准备批量写入文件: {', '.join(file_names)}")
+                                tool_content = self._write_files(files)
+
+                            # ✅ 新增：处理 AI 调用 Ruff 的请求
+                            elif tool_call.function.name == "run_ruff":
+                                path = args.get("file_path", "")
+                                self.action_log.emit(f"🔍 正在用 Ruff 检查代码: {path}")
+                                tool_content = self._run_ruff(path)
+
+                        except json.JSONDecodeError:
+                            tool_content = "错误: JSON 解析失败，请确保输出格式正确。"
+                        except Exception as e:
+                            tool_content = f"工具执行异常: {str(e)}"
+
+                        # 闭环回复
+                        tool_msg = {"role": "tool", "tool_call_id": tool_call.id, "content": tool_content}
+                        self.messages.append(tool_msg)
+                        final_messages.append(tool_msg)
+                    continue
+
+                if message.content:
+                    self.chunk_received.emit(message.content)
+
+                self.finished_signal.emit()
+                break
+
+        except Exception as e:
+            if self._is_running:
+                self.error_signal.emit(str(e))

nova_agent/core/tools.py

@@ -0,0 +1,2 @@
+# -*- coding: utf-8 -*-
+"""tools"""

nova_agent/main.py

@@ -0,0 +1,53 @@
+# src/dev_toolbox_pro/main.py
+import ctypes
+import sys
+from pathlib import Path
+
+from PySide6.QtCore import QTranslator, QLibraryInfo
+from PySide6.QtGui import QIcon
+from PySide6.QtWidgets import QApplication
+from nova_agent.ui.main_window import MainWindow
+from nova_agent.utils.logger import setup_logger
+from nova_agent.version import APP_USER_MODEL_ID, APP_NAME
+
+try:
+    from resources import resources_rc  # noqa
+except ImportError:
+    print("[WARN] 未找到 resources_rc，图标可能无法显示。")
+
+
+def main():
+    if sys.platform == "win32":
+        try:
+            ctypes.windll.shell32.SetCurrentProcessExplicitAppUserModelID(APP_USER_MODEL_ID)
+        except Exception as e:
+            print(f"设置 AppUserModelID 失败: {e}")
+
+    logger = setup_logger()
+    logger.info(f"{APP_NAME} starting...")
+
+    app = QApplication(sys.argv)
+
+    # 汉化逻辑
+    translator = QTranslator()
+    translations_path = QLibraryInfo.path(QLibraryInfo.LibraryPath.TranslationsPath)
+    if translator.load("qtbase_zh_CN", translations_path):
+        app.installTranslator(translator)
+
+    app.setApplicationName(APP_NAME)
+    app.setWindowIcon(QIcon(":/icons/set-up.svg"))
+
+    # 加载样式表 (因为 main.py 和 ui 同级，直接用相对路径)
+    qss_path = Path(__file__).parent / "ui" / "styles.qss"
+    if qss_path.exists():
+        app.setStyleSheet(qss_path.read_text(encoding="utf-8"))
+    else:
+        logger.warning(f"未找到样式表: {qss_path}")
+
+    window = MainWindow()
+    window.show()
+    sys.exit(app.exec())
+
+
+if __name__ == "__main__":
+    main()

nova_agent/qml/CardDemo.qml

@@ -0,0 +1,72 @@
+// CardDemo.qml
+// NovaCard 演示程序：展示圆角、阴影与 hover 放大动画
+//
+// 注意：卡片宽度由 Column 的 width 统一约束，卡片内部不使用 parent.width
+// 反推自身尺寸，避免与 hover scale 形成布局死循环。
+
+import QtQuick 2.15
+import QtQuick.Window 2.15
+import QtQuick.Controls 2.15
+
+Window {
+    id: window
+    width: 900
+    height: 620
+    visible: true
+    title: "NovaCard Demo"
+    color: "#F7F8FA"
+
+    readonly property var cardModel: [
+        { title: "基础卡片", subtitle: "圆角 + 阴影 + hover 放大" },
+        { title: "Elevation", subtitle: "通过 elevation 调整阴影强度" },
+        { title: "可交互", subtitle: "点击卡片会打印日志" },
+        { title: "内容插槽", subtitle: "default property 支持自定义内容" },
+        { title: "长标题会被省略号截断展示效果", subtitle: "ElideRight 模式" },
+        { title: "浅色主题", subtitle: "所有颜色均可通过属性覆盖" }
+    ]
+
+    Text {
+        id: header
+        anchors.left: parent.left
+        anchors.top: parent.top
+        anchors.margins: 28
+        text: "NovaCard"
+        font.pixelSize: 26
+        font.bold: true
+        color: "#1D2129"
+    }
+
+    GridView {
+        id: grid
+        anchors.left: parent.left
+        anchors.right: parent.right
+        anchors.top: header.bottom
+        anchors.bottom: parent.bottom
+        anchors.margins: 28
+        anchors.topMargin: 16
+        cellWidth: (width) / 3
+        cellHeight: 200
+        clip: true
+        model: window.cardModel
+
+        delegate: Item {
+            // 使用 GridView 提供的宽度基准，而非 parent.width，
+            // 避免 delegate 与父级宽度互相依赖造成循环绑定。
+            width: grid.cellWidth
+            height: grid.cellHeight
+
+            NovaCard {
+                anchors.centerIn: parent
+                width: Math.min(parent.width - 24, 280)
+                height: 168
+                title: modelData.title
+                subtitle: modelData.subtitle
+                elevation: index % 2 === 0 ? 18 : 26
+
+                onClicked: console.log("Clicked:", modelData.title)
+            }
+        }
+
+        ScrollBar.vertical: ScrollBar { }
+    }
+}

nova_agent/qml/DemoButton.qml

@@ -0,0 +1,93 @@
+import QtQuick
+import QtQuick.Window
+import QtQuick.Layouts
+
+/*!
+    DemoButton.qml
+    NovaButton 的演示界面：全部 UI 声明式完成，逻辑通过 bridge 交给 Python。
+*/
+Window {
+    id: win
+
+    width: 520
+    height: 380
+    visible: true
+    title: "NovaButton Demo"
+    color: "#121212"
+
+    ColumnLayout {
+        anchors.fill: parent
+        anchors.margins: 28
+        spacing: 22
+
+        Text {
+            text: "NovaButton · hover 动画演示"
+            color: "#ECEFF1"
+            font.pixelSize: 20
+            font.weight: Font.DemiBold
+            Layout.fillWidth: true
+        }
+
+        Text {
+            text: "把鼠标移到按钮上，观察背景 / 边框的平滑过渡。"
+            color: "#90A4AE"
+            font.pixelSize: 13
+            Layout.fillWidth: true
+        }
+
+        RowLayout {
+            spacing: 16
+            Layout.topMargin: 8
+
+            NovaButton {
+                text: "主要按钮"
+                variant: "primary"
+                onTapped: bridge.onPrimaryClicked()
+            }
+
+            NovaButton {
+                text: "次要按钮"
+                variant: "secondary"
+                onTapped: bridge.onSecondaryClicked()
+            }
+
+            NovaButton {
+                text: "危险操作"
+                variant: "danger"
+                onTapped: bridge.onDangerClicked()
+            }
+        }
+
+        NovaButton {
+            text: "禁用态（无 hover）"
+            variant: "secondary"
+            enabled: false
+        }
+
+        Rectangle {
+            Layout.fillWidth: true
+            Layout.preferredHeight: 1
+            color: "#263238"
+        }
+
+        Text {
+            id: counter
+            text: "主要按钮点击次数: " + bridge.clickedCount
+            color: "#4CAF50"
+            font.pixelSize: 14
+            Layout.fillWidth: true
+
+            // Python 修改后自动刷新（bridge 属性变化不会自动通知，靠 Connections 手动同步）
+            property int clickedCount: 0
+        }
+
+        Item { Layout.fillHeight: true }
+    }
+
+    Connections {
+        target: bridge
+        function onClickedCountChanged(count: int): void {
+            counter.clickedCount = count
+        }
+    }
+}

nova_agent/qml/NovaCard.qml

@@ -0,0 +1,104 @@
+// NovaCard.qml —— Nova 框架卡片组件
+// 纯 QML 声明式 UI：圆角 + 阴影 + hover 放大动画
+import QtQuick
+import QtQuick.Effects
+
+Item {
+    id: root
+
+    // ---- 对外属性 ----
+    property alias radius: surface.radius
+    property alias color: surface.color
+    property alias borderColor: surface.border.color
+    property alias borderWidth: surface.border.width
+    property alias contentItem: contentHost
+
+    // 阴影配置
+    property color shadowColor: "#40000000"
+    property real shadowBlur: 24.0
+    property real shadowOffsetY: 6.0
+    property real shadowOpacity: 1.0
+
+    // hover 动画配置
+    property real hoverScale: 1.03
+    property int animationDuration: 180
+    property bool hoverEnabled: true
+
+    // 只读状态
+    readonly property bool hovered: hoverArea.containsMouse
+
+    implicitWidth: 240
+    implicitHeight: 140
+
+    // 放大动画根节点（避免缩放影响外部布局）
+    Item {
+        id: scaleRoot
+        anchors.fill: parent
+        scale: root.hoverEnabled && root.hovered ? root.hoverScale : 1.0
+        transformOrigin: Item.Center
+
+        Behavior on scale {
+            NumberAnimation {
+                duration: root.animationDuration
+                easing.type: Easing.OutCubic
+            }
+        }
+
+        // 阴影层
+        MultiEffect {
+            source: surface
+            anchors.fill: surface
+            shadowEnabled: true
+            shadowColor: root.shadowColor
+            shadowBlur: root.shadowBlur / 32.0
+            shadowVerticalOffset: root.shadowOffsetY
+            shadowOpacity: root.shadowOpacity
+            opacity: root.hovered ? 1.0 : 0.85
+
+            Behavior on opacity {
+                NumberAnimation {
+                    duration: root.animationDuration
+                    easing.type: Easing.OutCubic
+                }
+            }
+        }
+
+        // 卡片本体
+        Rectangle {
+            id: surface
+            anchors.fill: parent
+            radius: 12
+            color: "#1E2228"
+            antialiasing: true
+
+            border.color: root.hovered ? "#4C8DFF" : "#2E3440"
+            border.width: 1
+
+            Behavior on border.color {
+                ColorAnimation {
+                    duration: root.animationDuration
+                    easing.type: Easing.OutCubic
+                }
+            }
+
+            // 背景仅负责绘制，内容放在上层容器
+            clip: true
+        }
+
+        // 内容容器（位于 surface 之上，避免被裁剪到阴影层）
+        Item {
+            id: contentHost
+            anchors.fill: surface
+            anchors.margins: 16
+        }
+    }
+
+    // hover 检测区域
+    MouseArea {
+        id: hoverArea
+        anchors.fill: parent
+        hoverEnabled: true
+        acceptedButtons: Qt.NoButton
+        cursorShape: Qt.PointingHandCursor
+    }
+}

nova_agent/qml/NovaCardDemo.qml

@@ -0,0 +1,57 @@
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+
+ApplicationWindow {
+    id: window
+    width: 560
+    height: 360
+    visible: true
+    color: "#f0f2f5"
+    title: "NovaCard Demo"
+
+    GridLayout {
+        anchors.centerIn: parent
+        columns: 2
+        rowSpacing: 32
+        columnSpacing: 32
+
+        Repeater {
+            model: [
+                { title: "基础卡片", desc: "默认圆角与时影" },
+                { title: "悬停试试", desc: "鼠标移上去会放大哦" },
+                { title: "自定义半径", desc: "radius: 8" },
+                { title: "无阴影", desc: "shadowBlur: 0" }
+            ]
+
+            NovaCard {
+                width: 220
+                height: 120
+                radius: index === 2 ? 8 : 16
+                shadowBlur: index === 3 ? 0.0 : 1.0
+
+                ColumnLayout {
+                    anchors.fill: parent
+                    anchors.margins: 16
+                    spacing: 6
+
+                    Label {
+                        text: modelData.title
+                        font.pixelSize: 16
+                        font.bold: true
+                        color: "#1f2328"
+                    }
+                    Label {
+                        text: modelData.desc
+                        font.pixelSize: 12
+                        color: "#6b7280"
+                        Layout.fillWidth: true
+                        wrapMode: Text.WordWrap
+                    }
+                }
+
+                onClicked: console.log("clicked:", modelData.title)
+            }
+        }
+    }
+}

nova_agent/qml/demo_button.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+from PySide6.QtCore import QObject, QUrl, Signal, Slot
+from PySide6.QtGui import QGuiApplication
+from PySide6.QtQml import QQmlApplicationEngine
+from PySide6.QtQuick import QQuickWindow, QSGRendererInterface
+
+
+class ButtonDemoBridge(QObject):
+    """Python 侧逻辑桥：只负责逻辑，UI 全部在 QML 中声明。"""
+
+    clickedCountChanged = Signal(int)
+
+    def __init__(self, parent: QObject | None = None) -> None:
+        super().__init__(parent)
+        self._clicked_count: int = 0
+
+    @Slot()
+    def onPrimaryClicked(self) -> None:
+        self._clicked_count += 1
+        print(f"[primary] clicked, total={self._clicked_count}")
+        self.clickedCountChanged.emit(self._clicked_count)
+
+    @Slot()
+    def onSecondaryClicked(self) -> None:
+        print("[secondary] clicked")
+
+    @Slot()
+    def onDangerClicked(self) -> None:
+        print("[danger] clicked")
+
+
+def main() -> None:
+    QQuickWindow.setGraphicsApi(QSGRendererInterface.GraphicsApi.Direct3D11)
+
+    app: QGuiApplication = QGuiApplication(sys.argv)
+
+    engine: QQmlApplicationEngine = QQmlApplicationEngine()
+
+    qml_dir: Path = Path(__file__).resolve().parent
+    engine.addImportPath(str(qml_dir))
+
+    bridge: ButtonDemoBridge = ButtonDemoBridge()
+    engine.rootContext().setContextProperty("bridge", bridge)
+
+    demo_qml: Path = qml_dir / "DemoButton.qml"
+    engine.load(QUrl.fromLocalFile(str(demo_qml)))
+
+    if not engine.rootObjects():
+        sys.exit(-1)
+
+    sys.exit(app.exec())
+
+
+if __name__ == "__main__":
+    main()