xiaomi-xb 1.0.0__tar.gz

xiaomi_xb-1.0.0/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# uv
+.uv/
+uv.lock
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Local dev
+*.log
+.env
+.env.local

xiaomi_xb-1.0.0/.gitlab-ci.yml

@@ -0,0 +1,39 @@
+stages:
+  - package
+
+variables:
+  PYTHON_IMAGE: "micr.cloud.mioffice.cn/dockerhub/library/python:3.10-slim"
+
+cache:
+  key: ${CI_COMMIT_REF_SLUG}
+  paths:
+    - .cache/pip
+    - .cache/uv
+
+package:wheel:
+  stage: package
+  image: ${PYTHON_IMAGE}
+  before_script:
+    - echo "替换为阿里云APT源..."
+    - sed -i 's|deb.debian.org|mirrors.aliyun.com|g' /etc/apt/sources.list.d/debian.sources
+    - sed -i 's|security.debian.org|mirrors.aliyun.com|g' /etc/apt/sources.list.d/debian.sources
+
+    - echo "安装 UV 包管理器..."
+    - apt-get update && apt-get install -y curl
+    - curl -LsSf https://astral.sh/uv/install.sh | sh
+    - export PATH="$HOME/.local/bin:$PATH"
+    - source ~/.bashrc
+  script:
+    - echo "构建 Python wheel 包..."
+    - UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple uv sync 
+    - uv build
+    - ls -lh dist/
+    - echo "构建完成！"
+  artifacts:
+    paths:
+      - dist/
+    expire_in: 30 days
+  only:
+    - branches
+    - tags
+    - merge_requests

xiaomi_xb-1.0.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: xiaomi-xb
+Version: 1.0.0
+Summary: Project management tool for UV + FastAPI + Vue3 + Electron desktop applications
+Project-URL: Homepage, https://github.com/yourusername/xb
+Project-URL: Documentation, https://github.com/yourusername/xb#readme
+Project-URL: Repository, https://github.com/yourusername/xb.git
+Project-URL: Issues, https://github.com/yourusername/xb/issues
+Author-email: XB Team <xb@example.com>
+License: MIT
+Keywords: cli,electron,fastapi,project-management,vue3
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.12
+Requires-Dist: click>=8.1.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# xb - Project Management Tool
+
+**xb** 是一个基于 `uv` 又类似 `uv` 的项目管理工具，用于快速初始化 **UV + FastAPI + Vue3 + Electron** 桌面应用。
+
+## 特性
+
+- 一键初始化完整项目结构
+- UV + FastAPI + Vue3 + Electron 开箱即用
+- 可选 sudo 免密配置
+- 内置开发、构建、版本管理脚本
+
+## 安装
+
+```bash
+# 安装 uv
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# 安装 xb
+cd xb
+uv sync
+uv tool install .
+
+xb --help
+```
+
+## 快速开始
+
+```bash
+# 初始化项目
+xb init --package myapp
+
+# 带 sudo 免密配置
+xb init --package myapp --sudoers
+
+cd myapp
+
+# 启动开发环境
+xb dev
+
+# 查看状态
+xb dev --status
+
+# 停止
+xb dev --stop
+```
+
+## 构建
+
+```bash
+# 构建所有
+xb build
+
+# 单独构建
+xb build -f    # 前端
+xb build -b    # 后端
+xb build -e    # Electron DEB
+```
+
+## 项目结构
+
+```
+myapp/
+├── pyproject.toml          # Python 依赖 (uv)
+├── backend/                # FastAPI 后端
+│   ├── main.py
+│   ├── api/
+│   └── managers/
+├── frontend/               # Vue 3 前端
+│   └── src/
+├── electron/               # Electron 主进程
+├── version/                # 版本管理
+│   ├── hooks/
+│   └── scripts/
+├── configs/                # 配置文件
+├── scripts/                # 可执行脚本
+├── dev.sh                  # 开发脚本
+├── build.sh                # 打包脚本
+└── .venv                   # Python 虚拟环境
+```
+
+## 版本管理
+
+```bash
+# 查看当前版本
+xb version
+```
+
+## 配置
+
+### Sudo 免密
+
+```bash
+# 启用 sudo 免密配置
+xb init --package myapp --sudoers
+
+# 密码存储在 configs/global_config.yaml
+# 建议设置文件权限: chmod 600 configs/global_config.yaml
+```
+
+## 技术栈
+
+| 组件 | 技术 |
+|------|------|
+| 后端 | FastAPI + Uvicorn |
+| 前端 | Vue 3 + Vite |
+| 桌面 | Electron |
+| 构建 | PyInstaller + electron-builder |
+| 依赖 | uv |
+
+## 环境要求
+
+- **Python**: 3.10+
+- **Node.js**: 16+
+- **npm**: 8+
+- **OS**: Linux
+
+## 许可证
+
+MIT
+
+## 故障排查
+
+```bash
+# 后端启动失败
+cat datas/logs/backend.log
+lsof -i :8000
+
+# 手动启动测试
+cd myapp
+.venv/bin/python backend/main.py
+
+# 前端启动失败
+cat datas/logs/frontend.log
+cd frontend && rm -rf node_modules && npm install
+```
+
+

xiaomi_xb-1.0.0/README.md

@@ -0,0 +1,137 @@
+# xb - Project Management Tool
+
+**xb** 是一个基于 `uv` 又类似 `uv` 的项目管理工具，用于快速初始化 **UV + FastAPI + Vue3 + Electron** 桌面应用。
+
+## 特性
+
+- 一键初始化完整项目结构
+- UV + FastAPI + Vue3 + Electron 开箱即用
+- 可选 sudo 免密配置
+- 内置开发、构建、版本管理脚本
+
+## 安装
+
+```bash
+# 安装 uv
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# 安装 xb
+cd xb
+uv sync
+uv tool install .
+
+xb --help
+```
+
+## 快速开始
+
+```bash
+# 初始化项目
+xb init --package myapp
+
+# 带 sudo 免密配置
+xb init --package myapp --sudoers
+
+cd myapp
+
+# 启动开发环境
+xb dev
+
+# 查看状态
+xb dev --status
+
+# 停止
+xb dev --stop
+```
+
+## 构建
+
+```bash
+# 构建所有
+xb build
+
+# 单独构建
+xb build -f    # 前端
+xb build -b    # 后端
+xb build -e    # Electron DEB
+```
+
+## 项目结构
+
+```
+myapp/
+├── pyproject.toml          # Python 依赖 (uv)
+├── backend/                # FastAPI 后端
+│   ├── main.py
+│   ├── api/
+│   └── managers/
+├── frontend/               # Vue 3 前端
+│   └── src/
+├── electron/               # Electron 主进程
+├── version/                # 版本管理
+│   ├── hooks/
+│   └── scripts/
+├── configs/                # 配置文件
+├── scripts/                # 可执行脚本
+├── dev.sh                  # 开发脚本
+├── build.sh                # 打包脚本
+└── .venv                   # Python 虚拟环境
+```
+
+## 版本管理
+
+```bash
+# 查看当前版本
+xb version
+```
+
+## 配置
+
+### Sudo 免密
+
+```bash
+# 启用 sudo 免密配置
+xb init --package myapp --sudoers
+
+# 密码存储在 configs/global_config.yaml
+# 建议设置文件权限: chmod 600 configs/global_config.yaml
+```
+
+## 技术栈
+
+| 组件 | 技术 |
+|------|------|
+| 后端 | FastAPI + Uvicorn |
+| 前端 | Vue 3 + Vite |
+| 桌面 | Electron |
+| 构建 | PyInstaller + electron-builder |
+| 依赖 | uv |
+
+## 环境要求
+
+- **Python**: 3.10+
+- **Node.js**: 16+
+- **npm**: 8+
+- **OS**: Linux
+
+## 许可证
+
+MIT
+
+## 故障排查
+
+```bash
+# 后端启动失败
+cat datas/logs/backend.log
+lsof -i :8000
+
+# 手动启动测试
+cd myapp
+.venv/bin/python backend/main.py
+
+# 前端启动失败
+cat datas/logs/frontend.log
+cd frontend && rm -rf node_modules && npm install
+```
+
+

xiaomi_xb-1.0.0/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "xiaomi-xb"
+version = "1.0.0"
+description = "Project management tool for UV + FastAPI + Vue3 + Electron desktop applications"
+readme = "README.md"
+requires-python = ">=3.12"
+license = {text = "MIT"}
+authors = [
+    {name = "XB Team", email = "xb@example.com"}
+]
+keywords = ["electron", "fastapi", "vue3", "project-management", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Build Tools",
+]
+
+dependencies = [
+    "click>=8.1.0",
+    "jinja2>=3.1.0",
+    "pyyaml>=6.0",
+    "rich>=13.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "black>=23.0",
+    "ruff>=0.1.0",
+]
+
+[project.scripts]
+xb = "xb.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/yourusername/xb"
+Documentation = "https://github.com/yourusername/xb#readme"
+Repository = "https://github.com/yourusername/xb.git"
+Issues = "https://github.com/yourusername/xb/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["xb"]
+
+[tool.black]
+line-length = 100
+target-version = ['py310']
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "B"]
+ignore = ["E501"]

xiaomi_xb-1.0.0/xb/__init__.py

@@ -0,0 +1,5 @@
+"""
+xb - Project management tool for UV + FastAPI + Vue3 + Electron desktop applications
+"""
+
+__version__ = "0.0.0"

xiaomi_xb-1.0.0/xb/cli.py

@@ -0,0 +1,55 @@
+"""
+xb CLI 入口
+提供项目初始化、开发、构建等命令
+"""
+
+import click
+from rich.console import Console
+
+from .commands.build import build
+from .commands.dev import dev
+from .commands.init import XbGroup, init_command
+from .commands.version import version
+
+console = Console()
+
+
+class ColorfulXbGroup(XbGroup):
+    def format_help(self, ctx, formatter):
+        console.print(
+            "\n[bold green]Usage:[/bold green] [cyan]xb [OPTIONS] COMMAND [ARGS]...[/cyan]\n"
+        )
+        console.print("[dim]xb - UV + FastAPI + Vue3 + Electron 桌面应用项目管理工具[/dim]")
+        console.print("[dim]类似 uv，专为 Electron 桌面应用设计。[/dim]\n")
+        console.print("[bold green]Options:[/bold green]")
+        console.print("  [cyan]--version[/cyan]  Show the version and exit.")
+        console.print("  [cyan]--help[/cyan]     Show this message and exit.\n")
+        console.print("[bold green]Commands:[/bold green]")
+        for subcommand in self.list_commands(ctx):
+            cmd = self.get_command(ctx, subcommand)
+            if cmd is None:
+                continue
+            help_text = cmd.get_short_help_str()
+            console.print(f"  [cyan]{subcommand:<10}[/cyan] {help_text}")
+        console.print()
+
+
+@click.group(cls=ColorfulXbGroup)
+@click.version_option(version="0.1.0", prog_name="xb")
+def main():
+    """
+    xb - UV + FastAPI + Vue3 + Electron 桌面应用项目管理工具
+
+    类似 uv，专为 Electron 桌面应用设计。
+    """
+    pass
+
+
+main.add_command(init_command, name="init")
+main.add_command(dev, name="dev")
+main.add_command(build, name="build")
+main.add_command(version, name="version")
+
+
+if __name__ == "__main__":
+    main()

xiaomi_xb-1.0.0/xb/commands/__init__.py

@@ -0,0 +1 @@
+"""xb commands package"""

xiaomi_xb-1.0.0/xb/commands/build.py

@@ -0,0 +1,62 @@
+"""
+xb build 命令实现
+构建项目
+"""
+
+import subprocess
+from pathlib import Path
+
+import click
+
+
+def is_project_root(path: Path) -> bool:
+    return (path / "pyproject.toml").exists() and (path / "build.sh").exists()
+
+
+def find_project_root() -> Path:
+    cwd = Path.cwd()
+    for path in [cwd] + list(cwd.parents):
+        if is_project_root(path):
+            return path
+    return None
+
+
+@click.command()
+@click.option(
+    "-f",
+    "--frontend",
+    is_flag=True,
+    default=False,
+    help="只构建前端",
+)
+@click.option(
+    "-b",
+    "--backend",
+    is_flag=True,
+    default=False,
+    help="只构建后端",
+)
+@click.option(
+    "-e",
+    "--electron",
+    is_flag=True,
+    default=False,
+    help="只构建 Electron DEB",
+)
+def build(frontend: bool, backend: bool, electron: bool):
+    """构建项目"""
+    project_root = find_project_root()
+    if not project_root:
+        click.echo("❌ 未找到项目根目录（缺少 pyproject.toml 或 build.sh）")
+        raise click.Abort()
+
+    build_script = project_root / "build.sh"
+
+    if frontend:
+        subprocess.run(["bash", str(build_script), "-f"], cwd=project_root)
+    elif backend:
+        subprocess.run(["bash", str(build_script), "-b"], cwd=project_root)
+    elif electron:
+        subprocess.run(["bash", str(build_script), "-e"], cwd=project_root)
+    else:
+        subprocess.run(["bash", str(build_script), "-a"], cwd=project_root)

xiaomi_xb-1.0.0/xb/commands/dev.py

@@ -0,0 +1,51 @@
+"""
+xb dev 命令实现
+启动/停止开发环境
+"""
+
+import subprocess
+from pathlib import Path
+
+import click
+
+
+def is_project_root(path: Path) -> bool:
+    return (path / "pyproject.toml").exists() and (path / "dev.sh").exists()
+
+
+def find_project_root() -> Path:
+    cwd = Path.cwd()
+    for path in [cwd] + list(cwd.parents):
+        if is_project_root(path):
+            return path
+    return None
+
+
+@click.command()
+@click.option(
+    "--stop",
+    is_flag=True,
+    default=False,
+    help="停止开发环境",
+)
+@click.option(
+    "--status",
+    is_flag=True,
+    default=False,
+    help="查看运行状态",
+)
+def dev(stop: bool, status: bool):
+    """启动/停止开发环境"""
+    project_root = find_project_root()
+    if not project_root:
+        click.echo("❌ 未找到项目根目录（缺少 pyproject.toml 或 dev.sh）")
+        raise click.Abort()
+
+    dev_script = project_root / "dev.sh"
+
+    if stop:
+        subprocess.run(["bash", str(dev_script), "stop"], cwd=project_root)
+    elif status:
+        subprocess.run(["bash", str(dev_script), "status"], cwd=project_root)
+    else:
+        subprocess.run(["bash", str(dev_script), "start"], cwd=project_root)