psi6 0.1.0__tar.gz

psi6-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 modaye
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

psi6-0.1.0/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: psi6
+Version: 0.1.0
+Summary: PySide6 desktop SDK: App runtime, batch jobs, theme tokens, and window chrome.
+Keywords: pyside6,qt,desktop,gui,theme,tray
+Author: modaye
+Author-email: modaye <flywacool@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: X11 Applications :: Qt
+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.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Dist: pydantic>=2.11
+Requires-Dist: pyside6>=6.8
+Requires-Dist: pytest>=8.3 ; extra == 'dev'
+Requires-Dist: pytest-qt>=4.4 ; extra == 'dev'
+Requires-Dist: pyyaml>=6 ; extra == 'dev'
+Requires-Dist: pyyaml>=6 ; extra == 'yaml'
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/modaye/psi6
+Project-URL: Repository, https://github.com/modaye/psi6
+Project-URL: Issues, https://github.com/modaye/psi6/issues
+Project-URL: Changelog, https://github.com/modaye/psi6/releases
+Provides-Extra: dev
+Provides-Extra: yaml
+Description-Content-Type: text/markdown
+
+# psi6
+
+面向 AI Coding Agent 的 PySide6 基建：**运行时、批处理、主题、窗壳**（自定义标题栏、托盘、防多开）。
+**不包含 Excel/PDF 等业务模板，也不为某个产品堆叠首页主键。** 行业逻辑写在你的应用里。
+
+## 安装
+
+运行或依赖这个库：
+
+```powershell
+pip install psi6
+# 或
+uv add psi6
+```
+
+YAML 主题额外需要：`pip install psi6[yaml]`。
+
+`pip` **不会**安装 Cursor / Claude skill。skill 只在 Git 仓库的 `.cursor/skills/psi6-desktop/`。用 AI 写 psi6 应用时，clone 本仓库，或把该目录拷进你的项目。
+
+## 使用路线
+
+1. **运行时**：`App` + `DesktopWindow`。`app.run(window, tray=True)` 托盘；默认防多开、记住位置。参数用 Pydantic + `pydantic_form`。
+2. **批处理**：耗时工作进 `TaskRunner`（`exclusive=` / `is_busy`），或可继承的 `BatchToolWindow(..., icon=..., exclusive=...)`。
+3. **主题**：`App(..., theme="dark"|"auto"|Path)`；JSON / TOML / YAML 覆盖 token。图标放主题旁 `icons/search.svg`。不要写 QSS。
+4. **窗壳**：`TitleBar` 拖动 / 最大化 / 从最大化拖出；`TrayIcon` 随主题换色；圆角窗最大化时取消圆角。
+5. **改控件**：先构造参数；不够则子类覆盖公开钩子（如 `BatchToolWindow.present_outcome`、`DataTable.display_text`）。自绘用 `create_painter` / `token_color`。不要碰 `_` 私有实现。
+
+```python
+from psi6 import App
+from psi6.ui.desktop_window import DesktopWindow
+
+app = App("demo")
+window = DesktopWindow(title="Demo")
+raise SystemExit(app.run(window, tray=True))
+```
+
+文件索引只是 `run_job` 合同示例（扫盘、取消、失败可读），不是要复制的产品。
+
+```powershell
+uv run python -m psi6 kit
+uv run python -m psi6 shot
+```
+
+规则在 `.cursor/skills/psi6-desktop/SKILL.md`。
+
+## 从源码开发
+
+```powershell
+uv sync --extra dev
+uv run psi6
+uv run pytest
+```
+
+## 发布
+
+1. 在 GitHub 建公开仓库（默认按 `modaye/psi6` 写进了元数据；用户名不同就改 `pyproject.toml` 的 `[project.urls]`）。
+2. 在 PyPI 打开 Trusted Publishing，pending publisher 填：owner、仓库名、工作流 `publish.yml`、环境 `pypi`。
+3. GitHub 仓库 Settings → Environments 新建 `pypi`。
+4. 打与 `pyproject.toml` 相同的版本标签，例如 `git tag v0.1.0 && git push origin v0.1.0`，Actions 会 `uv build` 并 `uv publish`。
+
+本地试发 TestPyPI：`uv build` 然后 `uv publish --index testpypi`。
+
+## 测试
+
+```powershell
+uv run pytest
+```

psi6-0.1.0/README.md

@@ -0,0 +1,67 @@
+# psi6
+
+面向 AI Coding Agent 的 PySide6 基建：**运行时、批处理、主题、窗壳**（自定义标题栏、托盘、防多开）。
+**不包含 Excel/PDF 等业务模板，也不为某个产品堆叠首页主键。** 行业逻辑写在你的应用里。
+
+## 安装
+
+运行或依赖这个库：
+
+```powershell
+pip install psi6
+# 或
+uv add psi6
+```
+
+YAML 主题额外需要：`pip install psi6[yaml]`。
+
+`pip` **不会**安装 Cursor / Claude skill。skill 只在 Git 仓库的 `.cursor/skills/psi6-desktop/`。用 AI 写 psi6 应用时，clone 本仓库，或把该目录拷进你的项目。
+
+## 使用路线
+
+1. **运行时**：`App` + `DesktopWindow`。`app.run(window, tray=True)` 托盘；默认防多开、记住位置。参数用 Pydantic + `pydantic_form`。
+2. **批处理**：耗时工作进 `TaskRunner`（`exclusive=` / `is_busy`），或可继承的 `BatchToolWindow(..., icon=..., exclusive=...)`。
+3. **主题**：`App(..., theme="dark"|"auto"|Path)`；JSON / TOML / YAML 覆盖 token。图标放主题旁 `icons/search.svg`。不要写 QSS。
+4. **窗壳**：`TitleBar` 拖动 / 最大化 / 从最大化拖出；`TrayIcon` 随主题换色；圆角窗最大化时取消圆角。
+5. **改控件**：先构造参数；不够则子类覆盖公开钩子（如 `BatchToolWindow.present_outcome`、`DataTable.display_text`）。自绘用 `create_painter` / `token_color`。不要碰 `_` 私有实现。
+
+```python
+from psi6 import App
+from psi6.ui.desktop_window import DesktopWindow
+
+app = App("demo")
+window = DesktopWindow(title="Demo")
+raise SystemExit(app.run(window, tray=True))
+```
+
+文件索引只是 `run_job` 合同示例（扫盘、取消、失败可读），不是要复制的产品。
+
+```powershell
+uv run python -m psi6 kit
+uv run python -m psi6 shot
+```
+
+规则在 `.cursor/skills/psi6-desktop/SKILL.md`。
+
+## 从源码开发
+
+```powershell
+uv sync --extra dev
+uv run psi6
+uv run pytest
+```
+
+## 发布
+
+1. 在 GitHub 建公开仓库（默认按 `modaye/psi6` 写进了元数据；用户名不同就改 `pyproject.toml` 的 `[project.urls]`）。
+2. 在 PyPI 打开 Trusted Publishing，pending publisher 填：owner、仓库名、工作流 `publish.yml`、环境 `pypi`。
+3. GitHub 仓库 Settings → Environments 新建 `pypi`。
+4. 打与 `pyproject.toml` 相同的版本标签，例如 `git tag v0.1.0 && git push origin v0.1.0`，Actions 会 `uv build` 并 `uv publish`。
+
+本地试发 TestPyPI：`uv build` 然后 `uv publish --index testpypi`。
+
+## 测试
+
+```powershell
+uv run pytest
+```

psi6-0.1.0/pyproject.toml

@@ -0,0 +1,61 @@
+[project]
+name = "psi6"
+version = "0.1.0"
+description = "PySide6 desktop SDK: App runtime, batch jobs, theme tokens, and window chrome."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "modaye", email = "flywacool@gmail.com" },
+]
+requires-python = ">=3.13"
+keywords = [
+    "pyside6",
+    "qt",
+    "desktop",
+    "gui",
+    "theme",
+    "tray",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: X11 Applications :: Qt",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: User Interfaces",
+]
+dependencies = [
+    "pydantic>=2.11",
+    "pyside6>=6.8",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.3",
+    "pytest-qt>=4.4",
+    "pyyaml>=6",
+]
+yaml = ["pyyaml>=6"]
+
+[project.urls]
+Homepage = "https://github.com/modaye/psi6"
+Repository = "https://github.com/modaye/psi6"
+Issues = "https://github.com/modaye/psi6/issues"
+Changelog = "https://github.com/modaye/psi6/releases"
+
+[project.scripts]
+psi6 = "psi6.__main__:main"
+
+[build-system]
+requires = ["uv_build>=0.10.7,<0.11.0"]
+build-backend = "uv_build"
+
+[tool.pytest.ini_options]
+qt_api = "pyside6"
+testpaths = ["tests"]
+addopts = "-q"

psi6-0.1.0/src/psi6/__init__.py

@@ -0,0 +1,148 @@
+"""psi6 公开 API。"""
+
+from psi6.jobs.file_index import FILE_INDEX_COLUMNS, FileIndexParams, run_file_index
+from psi6.runtime.app import App
+from psi6.runtime.config import ConfigStore
+from psi6.runtime.job import JobOutcome
+from psi6.runtime.logs import LogLevel, LogRecord
+from psi6.runtime.notifications import NoticeLevel, Notifier
+from psi6.runtime.single_instance import SingleInstance
+from psi6.runtime.tasks import TaskHandle, TaskRunner, TaskStatus
+from psi6.templates.batch_tool import BatchToolWindow
+from psi6.theme.paint import create_painter, mix_color, rounded_rect_path
+from psi6.theme.tokens import DEFAULT_TOKENS, Tokens
+from psi6.ui.action_bar import ActionBar
+from psi6.ui.app_shell import AppShell, NavDestination
+from psi6.ui.banner import Banner
+from psi6.ui.busy import BusyOverlay
+from psi6.ui.buttons import danger_button, ghost_button, link_button, primary_button, text_button
+from psi6.ui.chat import Composer, MessageList
+from psi6.ui.check_list import CheckItem, CheckList
+from psi6.ui.chrome import PageHeader, StatCard
+from psi6.ui.collapsible import Collapsible
+from psi6.ui.command_palette import Command, CommandPalette
+from psi6.ui.content_dialog import ContentDialog
+from psi6.ui.data_table import DataTable, TableColumn
+from psi6.ui.desktop_window import DesktopWindow
+from psi6.ui.dialogs import confirm, fail, inform, warn
+from psi6.ui.diff_view import DiffView
+from psi6.ui.drop_zone import DropZone
+from psi6.ui.empty_state import EmptyState
+from psi6.ui.file_input import FileInput, FolderInput, PathState
+from psi6.ui.filters import DebugEventFilter, PressScaleFilter, install_press_scale
+from psi6.ui.flow_layout import FlowLayout
+from psi6.ui.form import FormError, FormView, field_advanced, field_dir, field_file, field_secret, field_switch, pydantic_form
+from psi6.ui.icon import Icon, IconButton
+from psi6.ui.image_well import IconPreview, ImageWell
+from psi6.ui.log_panel import LogPanel
+from psi6.ui.playlist import Playlist
+from psi6.ui.property_list import PropertyList
+from psi6.ui.search_field import SearchField
+from psi6.ui.section import Section
+from psi6.ui.segmented import SegmentedControl
+from psi6.ui.setting_row import SettingRow
+from psi6.ui.settings_page import SettingsPage, pydantic_settings
+from psi6.ui.status_badge import StatusBadge
+from psi6.ui.stepper import Stepper
+from psi6.ui.switch import Switch
+from psi6.ui.tag import Tag, TagRow
+from psi6.ui.task_panel import TaskPanel
+from psi6.ui.title_bar import TitleBar
+from psi6.ui.toast import ToastHost
+from psi6.ui.transport import TransportBar
+from psi6.ui.tray import TrayIcon
+from psi6.ui.workbench import ChangeList, ChangeRow, ToolTile
+
+__all__ = [
+    "DEFAULT_TOKENS",
+    "ActionBar",
+    "App",
+    "AppShell",
+    "Banner",
+    "BatchToolWindow",
+    "BusyOverlay",
+    "ChangeList",
+    "ChangeRow",
+    "CheckItem",
+    "CheckList",
+    "Collapsible",
+    "Command",
+    "CommandPalette",
+    "Composer",
+    "ConfigStore",
+    "ContentDialog",
+    "create_painter",
+    "DataTable",
+    "DebugEventFilter",
+    "DesktopWindow",
+    "DiffView",
+    "DropZone",
+    "EmptyState",
+    "FileInput",
+    "FlowLayout",
+    "FolderInput",
+    "FormError",
+    "FormView",
+    "FILE_INDEX_COLUMNS",
+    "FileIndexParams",
+    "Icon",
+    "IconButton",
+    "IconPreview",
+    "ImageWell",
+    "JobOutcome",
+    "LogLevel",
+    "LogPanel",
+    "LogRecord",
+    "MessageList",
+    "mix_color",
+    "NavDestination",
+    "NoticeLevel",
+    "Notifier",
+    "PageHeader",
+    "PathState",
+    "Playlist",
+    "PressScaleFilter",
+    "PropertyList",
+    "rounded_rect_path",
+    "SearchField",
+    "Section",
+    "SegmentedControl",
+    "SettingRow",
+    "SettingsPage",
+    "SingleInstance",
+    "StatCard",
+    "StatusBadge",
+    "Stepper",
+    "Switch",
+    "TableColumn",
+    "Tag",
+    "TagRow",
+    "TaskHandle",
+    "TaskPanel",
+    "TaskRunner",
+    "TaskStatus",
+    "TitleBar",
+    "ToastHost",
+    "Tokens",
+    "ToolTile",
+    "TransportBar",
+    "TrayIcon",
+    "confirm",
+    "danger_button",
+    "fail",
+    "field_advanced",
+    "field_dir",
+    "field_file",
+    "field_secret",
+    "field_switch",
+    "ghost_button",
+    "inform",
+    "install_press_scale",
+    "link_button",
+    "primary_button",
+    "pydantic_form",
+    "pydantic_settings",
+    "run_file_index",
+    "text_button",
+    "warn",
+]

psi6-0.1.0/src/psi6/__main__.py

@@ -0,0 +1,34 @@
+"""``python -m psi6`` 启动文件索引；``python -m psi6 kit`` 打开组件主题预览。"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+
+def main() -> None:
+    """按参数分发参考窗口。"""
+
+    if len(sys.argv) > 1 and sys.argv[1] in {"kit", "--kit"}:
+        from psi6.examples.kit import main as kit_main
+
+        kit_main()
+        return
+    if len(sys.argv) > 1 and sys.argv[1] in {"shot", "--screenshot"}:
+        from psi6.runtime.qt_env import install_qt_message_filter, prepare_qt_environment
+
+        prepare_qt_environment()
+        install_qt_message_filter()
+        os.environ.setdefault("QT_QPA_PLATFORM", "offscreen")
+        from psi6.examples.visual_qa import main as shot_main
+
+        sys.argv = [sys.argv[0], *sys.argv[2:]]
+        shot_main()
+        return
+    from psi6.examples.file_index import main as index_main
+
+    index_main()
+
+
+if __name__ == "__main__":
+    main()

psi6-0.1.0/src/psi6/examples/__init__.py

@@ -0,0 +1,6 @@
+"""示例脚本入口。"""
+
+from psi6.examples.file_index import main
+from psi6.examples.kit import main as kit_main
+
+__all__ = ["kit_main", "main"]

psi6-0.1.0/src/psi6/examples/file_index.py

@@ -0,0 +1,23 @@
+"""可运行参考工具：索引目录中的文件。"""
+
+from __future__ import annotations
+
+from psi6.jobs.file_index import FILE_INDEX_COLUMNS, FileIndexParams, run_file_index
+from psi6.runtime.app import App
+from psi6.templates.batch_tool import BatchToolWindow
+
+
+def main() -> None:
+    """启动文件索引窗口。上次使用的目录会写入配置。"""
+
+    app = App("psi6-file-index")
+    window = BatchToolWindow(
+        title="psi6 文件索引",
+        params=FileIndexParams(),
+        job=run_file_index,
+        app=app,
+        result_columns=FILE_INDEX_COLUMNS,
+        icon="folder",
+        exclusive="batch",
+    )
+    raise SystemExit(app.run(window, tray=True, single_instance=True))