wv-cli 0.1.0__py3-none-any.whl

wv_cli/commands/build.py

@@ -0,0 +1,113 @@
+"""wv build — production build with optional Windows installer packaging."""
+import os
+import platform
+import sys
+
+import click
+
+from ..utils import find_project_root, load_config, run_cmd, fix_router_history, ensure_npm_deps, inject_favicon
+
+
+@click.command('build')
+@click.option(
+    '--publish',
+    is_flag=True,
+    default=False,
+    help='Also create a Windows installer with Inno Setup after building.',
+)
+def build(publish: bool):
+    """Build the project for production.
+
+    Use --publish to additionally generate a Windows installer via Inno Setup.
+    """
+
+    project_root = find_project_root()
+    config = load_config(project_root)
+
+    project_name = config['project']['name']
+    version = config['project']['version']
+
+    click.echo(f'🏗  生产构建：{project_name} v{version}')
+
+    # 1. Fix Vue Router history mode
+    fix_router_history(project_root)
+
+    # 2. Build frontend
+    frontend_dir = os.path.join(project_root, 'frontend')
+    click.echo('\n📦 构建前端…')
+    ensure_npm_deps(frontend_dir)
+    run_cmd(['npm', 'run', 'build'], cwd=frontend_dir)
+    inject_favicon(project_root)
+
+    # Verify frontend/dist
+    dist_dir = os.path.join(frontend_dir, 'dist')
+    if not os.path.isdir(dist_dir):
+        raise click.ClickException(
+            "frontend/dist 不存在。\n"
+            "请检查 npm run build 是否成功执行，然后重试。"
+        )
+
+    # 3. Run PyInstaller
+    build_dir = os.path.join(project_root, 'build')
+    spec_file = os.path.join(build_dir, f'{project_name}.spec')
+
+    if not os.path.isfile(spec_file):
+        raise click.ClickException(
+            f"未找到 spec 文件：{spec_file}\n"
+            "请确认当前目录是 wv 项目根目录，且 build/ 目录完整。"
+        )
+
+    click.echo('\n📦 PyInstaller 打包…')
+    backend_dir = os.path.join(project_root, 'backend')
+    run_cmd(
+        ['uv', 'run', 'pyinstaller', spec_file, '--distpath', os.path.join(build_dir, 'dist')],
+        cwd=backend_dir,
+    )
+
+    click.echo(f'\n✔ 构建完成：build/dist/{project_name}/')
+
+    # 4. Optional: Inno Setup packaging (Windows only)
+    if publish:
+        _publish_installer(project_root, config, project_name, version, build_dir)
+
+
+def _publish_installer(
+    project_root: str,
+    config: dict,
+    project_name: str,
+    version: str,
+    build_dir: str,
+) -> None:
+    """Generate a Windows installer using Inno Setup."""
+
+    if platform.system() != 'Windows':
+        click.echo(
+            '\n⚠  --publish 仅支持 Windows 平台（需要 Inno Setup），已跳过安装包生成。'
+        )
+        return
+
+    inno_path = config.get('build', {}).get(
+        'inno_setup_path',
+        'C:/Program Files (x86)/Inno Setup 6/ISCC.exe',
+    )
+
+    if not os.path.isfile(inno_path):
+        raise click.ClickException(
+            f"未找到 Inno Setup：{inno_path}\n"
+            "请安装 Inno Setup 后在 wv.toml 中配置正确的 inno_setup_path。\n"
+            "下载：https://jrsoftware.org/isdl.php"
+        )
+
+    iss_file = os.path.join(build_dir, f'{project_name}.iss')
+    if not os.path.isfile(iss_file):
+        raise click.ClickException(
+            f"未找到 iss 文件：{iss_file}"
+        )
+
+    click.echo('\n📦 Inno Setup 打包安装程序…')
+    run_cmd([inno_path, iss_file])
+
+    installer = os.path.join(
+        build_dir, 'publish', f'{project_name}-{version}-setup.exe'
+    )
+    click.echo(f'\n✔ 安装包已生成：{installer}')

wv_cli/commands/create.py

@@ -0,0 +1,178 @@
+"""wv create — scaffold a new pywebview + Vue3 project."""
+import os
+import shutil
+
+import click
+import toml
+
+from ..utils import require_node, require_uv, run_cmd
+from ..templates import (
+    WV_TOML,
+    CONFIG_PY,
+    MAIN_PY,
+    BRIDGE_INIT_PY,
+    BRIDGE_API_PY,
+    SPEC_FILE,
+    ISS_FILE,
+    ROOT_GITIGNORE,
+    BACKEND_GITIGNORE,
+)
+
+# 包内默认图标目录：wv_cli/icon/
+_PKG_ICON_DIR = os.path.join(os.path.dirname(os.path.dirname(__file__)), 'icon')
+
+
+# ---------------------------------------------------------------------------
+# Directory / file creation helpers
+# ---------------------------------------------------------------------------
+
+def _makedirs(path: str) -> None:
+    os.makedirs(path, exist_ok=True)
+
+
+def _write_text(path: str, content: str, overwrite: bool = False) -> None:
+    """Write text to path; skip if file already exists and overwrite is False."""
+    if os.path.exists(path) and not overwrite:
+        return
+    os.makedirs(os.path.dirname(path), exist_ok=True)
+    with open(path, 'w', encoding='utf-8') as f:
+        f.write(content)
+
+
+def _copy_default_icons(project_dir: str) -> None:
+    """
+    Copy default favicon.ico and logo.png from the wv-cli package's icon/
+    directory into the project's icon/ directory.
+    Skips files that already exist (safe for `wv create .`).
+    """
+    for filename in ('favicon.ico', 'logo.png'):
+        src = os.path.join(_PKG_ICON_DIR, filename)
+        dst = os.path.join(project_dir, 'icon', filename)
+        if os.path.exists(dst):
+            continue
+        if os.path.isfile(src):
+            shutil.copy2(src, dst)
+        else:
+            click.echo(f'  ⚠ 未找到默认图标：{src}，跳过复制')
+
+
+def _scaffold_directories(project_dir: str) -> None:
+    dirs = [
+        'icon',
+        'frontend',
+        'backend/src/bridge',
+        'backend/tests',
+        'build/publish',
+    ]
+    for d in dirs:
+        _makedirs(os.path.join(project_dir, d))
+
+
+def _scaffold_files(
+    project_dir: str,
+    project_name: str,
+    version: str,
+    window_title: str,
+    author: str,
+) -> None:
+    ctx = dict(
+        project_name=project_name,
+        version=version,
+        window_title=window_title,
+        author=author,
+    )
+
+    _write_text(os.path.join(project_dir, 'wv.toml'), WV_TOML.format(**ctx))
+
+    _write_text(
+        os.path.join(project_dir, 'backend', 'src', 'config.py'),
+        CONFIG_PY.format(**ctx),
+    )
+
+    _write_text(os.path.join(project_dir, 'backend', 'src', 'main.py'), MAIN_PY)
+
+    _write_text(
+        os.path.join(project_dir, 'backend', 'src', 'bridge', '__init__.py'),
+        BRIDGE_INIT_PY,
+    )
+
+    _write_text(
+        os.path.join(project_dir, 'backend', 'src', 'bridge', 'api.py'),
+        BRIDGE_API_PY,
+    )
+
+    _write_text(
+        os.path.join(project_dir, 'build', f'{project_name}.spec'),
+        SPEC_FILE.format(**ctx),
+    )
+
+    _write_text(
+        os.path.join(project_dir, 'build', f'{project_name}.iss'),
+        ISS_FILE.format(**ctx),
+    )
+
+    # 项目根目录 .gitignore
+    _write_text(os.path.join(project_dir, '.gitignore'), ROOT_GITIGNORE)
+
+
+# ---------------------------------------------------------------------------
+# wv create command
+# ---------------------------------------------------------------------------
+
+@click.command('create')
+@click.argument('directory', required=False, default=None)
+def create(directory):
+    """Create a new pywebview + Vue3 desktop app project."""
+
+    cwd = os.path.abspath(os.getcwd())
+
+    if directory is None:
+        project_name = click.prompt('项目名称', default='my-app')
+        project_dir = os.path.join(cwd, project_name)
+    elif directory == '.':
+        default_name = os.path.basename(cwd)
+        project_name = click.prompt('项目名称', default=default_name)
+        project_dir = cwd
+    else:
+        project_dir = os.path.abspath(directory)
+        project_name = click.prompt('项目名称', default=os.path.basename(project_dir))
+
+    window_title = click.prompt('窗口标题', default=project_name)
+    version = click.prompt('版本号', default='1.0.0')
+    author = click.prompt('作者', default='')
+
+    click.echo('\n🔍 检查运行环境…')
+    require_node()
+    click.echo('  ✔ Node.js / npm')
+    require_uv()
+    click.echo('  ✔ uv')
+
+    click.echo('\n📁 创建项目结构…')
+    _scaffold_directories(project_dir)
+    _scaffold_files(project_dir, project_name, version, window_title, author)
+    _copy_default_icons(project_dir)
+    click.echo('  ✔ 目录与文件已生成')
+
+    click.echo('\n🖼  初始化前端（npm create vue@latest）…')
+    frontend_dir = os.path.join(project_dir, 'frontend')
+    _makedirs(frontend_dir)
+    run_cmd(['npm', 'create', 'vue@latest', '.'], cwd=frontend_dir)
+
+    click.echo('\n🐍 初始化后端（uv）…')
+    backend_dir = os.path.join(project_dir, 'backend')
+    run_cmd(['uv', 'init', '--no-workspace', '--vcs', 'none'], cwd=backend_dir)
+    run_cmd(['uv', 'venv'], cwd=backend_dir)
+    run_cmd(['uv', 'add', 'pywebview', 'pyinstaller'], cwd=backend_dir)
+
+    _write_text(os.path.join(backend_dir, '.gitignore'), BACKEND_GITIGNORE)
+
+    rel = os.path.relpath(project_dir, cwd)
+    cd_hint = f'\n  cd {rel}' if rel != '.' else ''
+
+    click.echo(f"""
+✔ 项目创建完成！{cd_hint}
+
+下一步：
+  wv run      # 开发模式运行（构建前端 + 启动 pywebview）
+  wv build    # 生产构建（PyInstaller 打包）
+""")

wv_cli/commands/run.py

@@ -0,0 +1,39 @@
+"""wv run — development mode: build frontend then launch pywebview."""
+import os
+
+import click
+
+from ..utils import find_project_root, load_config, run_cmd, fix_router_history, ensure_npm_deps, inject_favicon
+
+
+@click.command('run')
+def run():
+    """Run the app in development mode (builds frontend, then starts pywebview)."""
+
+    project_root = find_project_root()
+    config = load_config(project_root)
+
+    click.echo('🔧 开发模式启动…')
+
+    # 1. Fix Vue Router history mode for file:// compatibility
+    fix_router_history(project_root)
+
+    # 2. Build frontend
+    frontend_dir = os.path.join(project_root, 'frontend')
+    click.echo('\n📦 构建前端…')
+    ensure_npm_deps(frontend_dir)
+    run_cmd(['npm', 'run', 'build'], cwd=frontend_dir)
+    inject_favicon(project_root)
+
+    # 3. Verify frontend/dist exists
+    dist_dir = os.path.join(frontend_dir, 'dist')
+    if not os.path.isdir(dist_dir):
+        raise click.ClickException(
+            "frontend/dist 不存在。\n"
+            "请检查 npm run build 是否成功执行。"
+        )
+
+    # 4. Launch pywebview via uv
+    backend_dir = os.path.join(project_root, 'backend')
+    click.echo('\n🚀 启动 pywebview…')
+    run_cmd(['uv', 'run', 'src/main.py'], cwd=backend_dir)

wv_cli/main.py

@@ -0,0 +1,17 @@
+"""wv-cli: Scaffold tool for pywebview + Vue3 desktop apps."""
+import click
+from .commands.create import create
+from .commands.run import run
+from .commands.build import build
+
+
+@click.group()
+@click.version_option(version="0.1.0", prog_name="wv")
+def cli():
+    """wv-cli — pywebview + Vue3 desktop app scaffold tool."""
+    pass
+
+
+cli.add_command(create)
+cli.add_command(run)
+cli.add_command(build)

wv_cli/templates.py

@@ -0,0 +1,212 @@
+"""
+Template content for files generated by `wv create`.
+All templates are plain strings; variable substitution is done in commands/create.py.
+"""
+
+WV_TOML = """\
+[project]
+name = "{project_name}"
+version = "{version}"
+window_title = "{window_title}"
+author = "{author}"
+
+[build]
+# Windows default path; ignored on non-Windows platforms
+inno_setup_path = "C:/Program Files (x86)/Inno Setup 6/ISCC.exe"
+"""
+
+CONFIG_PY = """\
+# Development mode: load index.html directly from frontend/dist
+HTML_PATH_DEV = '../../frontend/dist/index.html'
+
+# Packaged mode: PyInstaller bundles frontend/dist contents into _f_dist
+HTML_PATH_APP = '_f_dist/index.html'
+
+# Window title (injected from wv.toml at project creation time)
+WINDOW_TITLE = "{window_title}"
+"""
+
+MAIN_PY = """\
+import sys
+import os
+import webview
+from config import WINDOW_TITLE, HTML_PATH_DEV, HTML_PATH_APP
+
+
+def get_html_path() -> str:
+    \"\"\"Resolve the correct HTML path depending on the runtime environment.\"\"\"
+    if getattr(sys, 'frozen', False):
+        # PyInstaller packaged environment: use sys._MEIPASS to locate resources
+        base = sys._MEIPASS
+        return os.path.join(base, HTML_PATH_APP)
+    else:
+        # Development / testing environment: use relative path to frontend/dist
+        base = os.path.dirname(os.path.abspath(__file__))
+        return os.path.join(base, HTML_PATH_DEV)
+
+
+def main():
+    from bridge.api import Api
+    api = Api()
+    window = webview.create_window(
+        WINDOW_TITLE,
+        url=get_html_path(),
+        js_api=api,
+    )
+    webview.start()
+
+
+if __name__ == '__main__':
+    main()
+"""
+
+BRIDGE_INIT_PY = """\
+# bridge package: pywebview JS API bridge classes live here
+"""
+
+BRIDGE_API_PY = """\
+class Api:
+    \"\"\"
+    pywebview JS API example.
+    The frontend calls methods of this class via window.pywebview.api.<method>().
+    Add your own methods below and expose them to the Vue frontend.
+    \"\"\"
+
+    def greet(self, name: str) -> str:
+        return f"Hello, {name}!"
+"""
+
+SPEC_FILE = """\
+# -*- mode: python ; coding: utf-8 -*-
+block_cipher = None
+
+a = Analysis(
+    ['../backend/src/main.py'],
+    pathex=['../backend/src'],
+    binaries=[],
+    datas=[
+        ('../frontend/dist', '_f_dist'),   # Bundle frontend build output
+        ('../icon', 'icon'),               # Icon resources
+    ],
+    hiddenimports=['webview'],
+    hookspath=[],
+    runtime_hooks=[],
+    excludes=[],
+    win_no_prefer_redirects=False,
+    win_private_assemblies=False,
+    cipher=block_cipher,
+)
+
+pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    [],
+    exclude_binaries=True,
+    name='{project_name}',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=True,
+    console=False,
+    icon='../icon/favicon.ico',
+)
+
+coll = COLLECT(
+    exe,
+    a.binaries,
+    a.zipfiles,
+    a.datas,
+    strip=False,
+    upx=True,
+    upx_exclude=[],
+    name='{project_name}',
+)
+"""
+
+ISS_FILE = """\
+[Setup]
+AppName={project_name}
+AppVersion={version}
+DefaultDirName={{autopf}}\\{project_name}
+DefaultGroupName={project_name}
+OutputDir=publish
+OutputBaseFilename={project_name}-{version}-setup
+SetupIconFile=../icon/favicon.ico
+Compression=lzma
+SolidCompression=yes
+
+[Files]
+Source: "../build/dist/{project_name}/*"; DestDir: "{{app}}"; Flags: recursesubdirs createallsubdirs
+
+[Icons]
+Name: "{{group}}\\{project_name}"; Filename: "{{app}}\\{project_name}.exe"
+Name: "{{commondesktop}}\\{project_name}"; Filename: "{{app}}\\{project_name}.exe"
+
+[Run]
+Filename: "{{app}}\\{project_name}.exe"; Description: "立即启动"; Flags: nowait postinstall skipifsilent
+"""
+
+ROOT_GITIGNORE = """\
+# ── Build output ─────────────────────────────────────────────────────────────
+build/dist/
+build/publish/
+
+# ── Frontend ──────────────────────────────────────────────────────────────────
+frontend/dist/
+frontend/node_modules/
+
+# ── Backend ───────────────────────────────────────────────────────────────────
+backend/.venv/
+backend/__pycache__/
+backend/**/__pycache__/
+
+# ── OS / IDE ──────────────────────────────────────────────────────────────────
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/
+"""
+
+BACKEND_GITIGNORE = """\
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.egg
+*.egg-info/
+
+# Virtual environment (uv)
+.venv/
+
+# uv
+.uv/
+uv.lock
+
+# Distribution
+dist/
+build/
+
+# PyInstaller
+*.spec.bak
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+"""

wv_cli/utils.py

@@ -0,0 +1,181 @@
+"""Shared utility functions for wv-cli."""
+import os
+import platform
+import re
+import shutil
+import subprocess
+import sys
+
+import click
+import toml
+
+
+# ---------------------------------------------------------------------------
+# wv.toml helpers
+# ---------------------------------------------------------------------------
+
+def load_config(project_root: str) -> dict:
+    """Load wv.toml from the project root. Raises click.ClickException on failure."""
+    config_path = os.path.join(project_root, "wv.toml")
+    if not os.path.isfile(config_path):
+        raise click.ClickException(
+            f"wv.toml not found in {project_root}. "
+            "Are you inside a wv project directory?"
+        )
+    with open(config_path, "r", encoding="utf-8") as f:
+        return toml.load(f)
+
+
+def find_project_root() -> str:
+    """Walk up from cwd until wv.toml is found. Returns the directory path."""
+    cwd = os.path.abspath(os.getcwd())
+    candidate = cwd
+    while True:
+        if os.path.isfile(os.path.join(candidate, "wv.toml")):
+            return candidate
+        parent = os.path.dirname(candidate)
+        if parent == candidate:
+            raise click.ClickException(
+                "wv.toml not found. Run this command from inside a wv project."
+            )
+        candidate = parent
+
+
+# ---------------------------------------------------------------------------
+# Environment checks
+# ---------------------------------------------------------------------------
+
+def check_command(cmd: str) -> bool:
+    """Return True if the shell command is available on PATH."""
+    return shutil.which(cmd) is not None
+
+
+def require_node():
+    """Abort with a helpful message if node/npm is missing."""
+    if not check_command("node") or not check_command("npm"):
+        raise click.ClickException(
+            "Node.js / npm not found.\n"
+            "Please install Node.js from: https://nodejs.org"
+        )
+
+
+def require_uv():
+    """Abort with a helpful message if uv is missing."""
+    if not check_command("uv"):
+        raise click.ClickException(
+            "uv not found.\n"
+            "Install it with:  pip install uv\n"
+            "  or (Windows):    winget install astral-sh.uv"
+        )
+
+
+# ---------------------------------------------------------------------------
+# Subprocess helpers
+# ---------------------------------------------------------------------------
+
+def _resolve_cmd(cmd: str) -> str:
+    """On Windows, resolve e.g. 'npm' → 'npm.cmd' so subprocess can find it."""
+    if platform.system() == "Windows":
+        resolved = shutil.which(cmd)
+        if resolved:
+            return resolved
+    return cmd
+
+
+def ensure_npm_deps(frontend_dir: str) -> None:
+    """Run `npm install` if node_modules is missing or package.json has changed."""
+    node_modules = os.path.join(frontend_dir, 'node_modules')
+    if not os.path.isdir(node_modules):
+        click.echo('  📥 安装前端依赖（npm install）…')
+        run_cmd(['npm', 'install'], cwd=frontend_dir)
+
+
+def run_cmd(args: list, cwd: str = None, shell: bool = False):
+    """Run a command, streaming output to the terminal. Raise on non-zero exit."""
+    args = [_resolve_cmd(args[0])] + args[1:]
+    click.echo(f"  $ {' '.join(args)}")
+    result = subprocess.run(args, cwd=cwd, shell=shell)
+    if result.returncode != 0:
+        raise click.ClickException(
+            f"Command failed (exit {result.returncode}): {' '.join(args)}"
+        )
+
+
+
+# ---------------------------------------------------------------------------
+# Favicon injection
+# ---------------------------------------------------------------------------
+
+def inject_favicon(project_root: str) -> None:
+    """
+    After `npm run build`, overwrite every favicon.ico found under
+    frontend/dist/ with the project's own icon/favicon.ico.
+    Idempotent and skipped gracefully when source or dist is missing.
+    """
+    src_ico = os.path.join(project_root, 'icon', 'favicon.ico')
+
+    if not os.path.isfile(src_ico):
+        click.echo('跳过 favicon 注入：icon/favicon.ico 不存在')
+        return
+
+    dist_dir = os.path.join(project_root, 'frontend', 'dist')
+    if not os.path.isdir(dist_dir):
+        click.echo('跳过 favicon 注入：frontend/dist 不存在')
+        return
+
+    replaced = 0
+    for dirpath, _, filenames in os.walk(dist_dir):
+        for filename in filenames:
+            if filename.lower() == 'favicon.ico':
+                dst = os.path.join(dirpath, filename)
+                shutil.copy2(src_ico, dst)
+                rel = os.path.relpath(dst, project_root)
+                click.echo(f'✔ 已注入 favicon：{rel}')
+                replaced += 1
+
+    if replaced == 0:
+        click.echo('跳过 favicon 注入：dist 中未找到 favicon.ico')
+
+# ---------------------------------------------------------------------------
+# Frontend router fix
+# ---------------------------------------------------------------------------
+
+def fix_router_history(project_root: str) -> None:
+    """
+    Replace createWebHistory with createWebHashHistory in the Vue Router
+    entry file so that file:// protocol works correctly after packaging.
+    This function is idempotent.
+    """
+    router_dir = os.path.join(project_root, "frontend", "src", "router")
+
+    if not os.path.isdir(router_dir):
+        click.echo("跳过路由修复：未检测到 router 目录")
+        return
+
+    target_file = None
+    for filename in ("index.ts", "index.js"):
+        candidate = os.path.join(router_dir, filename)
+        if os.path.isfile(candidate):
+            target_file = candidate
+            break
+
+    if target_file is None:
+        click.echo("跳过路由修复：未找到 router/index.ts 或 router/index.js")
+        return
+
+    with open(target_file, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    if "createWebHistory" not in content:
+        click.echo("跳过路由修复：未检测到 createWebHistory，无需修改")
+        return
+
+    # \b boundary: createWebHashHistory does NOT contain createWebHistory as a
+    # substring, so this replacement is idempotent.
+    new_content = re.sub(r"\bcreateWebHistory\b", "createWebHashHistory", content)
+
+    with open(target_file, "w", encoding="utf-8") as f:
+        f.write(new_content)
+
+    rel_path = os.path.relpath(target_file, project_root)
+    click.echo(f"✔ 已修复：{rel_path}（createWebHistory → createWebHashHistory）")

wv_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: wv-cli
+Version: 0.1.0
+Summary: CLI scaffold tool for pywebview + Vue3 desktop apps
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: toml>=0.10
+
+# wv-cli
+
+A command-line scaffold tool for building **pywebview (Python backend) + Vue 3 (frontend)** desktop apps.
+
+## Requirements
+
+- Python ≥ 3.9
+- [uv](https://docs.astral.sh/uv/) — Python package manager
+- [Node.js / npm](https://nodejs.org) — for the Vue 3 frontend
+- [Inno Setup 6](https://jrsoftware.org/isdl.php) *(Windows only, required for `--publish`)*
+
+## Installation
+
+```bash
+pip install wv-cli
+```
+
+Or install from source with `uv`:
+
+```bash
+git clone https://github.com/yourname/wv-cli
+cd wv-cli
+uv pip install -e .
+```
+
+## Quick Start
+
+### Create a new project
+
+```bash
+# Interactive — creates ./my-app/
+wv create
+
+# In the current directory
+wv create .
+
+# Explicit directory
+wv create path/to/my-app
+```
+
+You will be prompted for:
+| Prompt | Default |
+|---|---|
+| 项目名称 (project name) | directory name |
+| 窗口标题 (window title) | project name |
+| 版本号 (version) | `1.0.0` |
+| 作者 (author) | *(empty)* |
+
+After answering, the CLI will:
+1. Scaffold the full directory structure
+2. Run `npm create vue@latest` for the frontend (you drive the Vue prompts)
+3. Run `uv init / venv / add pywebview pyinstaller` for the backend
+
+### Run in development mode
+
+```bash
+cd my-app
+wv run
+```
+
+Builds the Vue frontend, then launches the pywebview window loading `frontend/dist`.
+
+### Production build
+
+```bash
+wv build
+```
+
+Builds the frontend and runs PyInstaller to produce `build/dist/<project-name>/`.
+
+### Build + Windows installer
+
+```bash
+wv build --publish
+```
+
+Runs the full build, then calls Inno Setup to produce
+`build/publish/<project-name>-<version>-setup.exe`.
+
+Configure the Inno Setup path in `wv.toml` if needed:
+
+```toml
+[build]
+inno_setup_path = "C:/Program Files (x86)/Inno Setup 6/ISCC.exe"
+```
+
+## Generated Project Structure
+
+```
+my-app/
+├── icon/
+│   ├── favicon.ico
+│   └── logo.png
+├── frontend/          ← Vue 3 (npm create vue@latest)
+│   └── dist/          ← built by wv run / wv build
+├── backend/
+│   ├── .venv/         ← uv virtual environment
+│   └── src/
+│       ├── main.py
+│       ├── config.py
+│       └── bridge/
+│           ├── __init__.py
+│           └── api.py
+├── build/
+│   ├── my-app.spec    ← PyInstaller config
+│   ├── my-app.iss     ← Inno Setup config
+│   └── publish/       ← installer output
+└── wv.toml
+```
+
+## Frontend Router Auto-Fix
+
+`wv run` and `wv build` automatically replace `createWebHistory` with
+`createWebHashHistory` in `frontend/src/router/index.{ts,js}` before building.
+This ensures the app works correctly when loaded via the `file://` protocol
+after packaging. The replacement is **idempotent** — running it multiple times
+has no side effects.
+
+## `wv.toml` Reference
+
+```toml
+[project]
+name = "my-app"
+version = "1.0.0"
+window_title = "My App"
+author = ""
+
+[build]
+inno_setup_path = "C:/Program Files (x86)/Inno Setup 6/ISCC.exe"
+```
+
+## Extending the JS Bridge
+
+Edit `backend/src/bridge/api.py`:
+
+```python
+class Api:
+    def greet(self, name: str) -> str:
+        return f"Hello, {name}!"
+
+    def read_file(self, path: str) -> str:
+        with open(path) as f:
+            return f.read()
+```
+
+Call from Vue:
+
+```js
+const result = await window.pywebview.api.greet('World')
+```
+
+## License
+
+MIT

wv_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+wv_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+wv_cli/main.py,sha256=tM7fLjlMIXaIjUdYVQaFUndTDpGR2lbX-fmczdQV2Mg,403
+wv_cli/templates.py,sha256=iY41IdQlshfD1NWVKgQP-xDozaqMkmcyfyIXjE1pWdU,5012
+wv_cli/utils.py,sha256=aj3jKsex1uoHpYp8d3JlzdWbddIcyQdCzyetq5TLdSk,6422
+wv_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+wv_cli/commands/build.py,sha256=eVeY30idUiOFGTUC3rlaqayCyXRF1TOvAnpK3ik1JP0,3498
+wv_cli/commands/create.py,sha256=29H901zFngFWd-kC0V70z4-K1w0pDUT2WUEcvBcA4_4,5468
+wv_cli/commands/run.py,sha256=dQcvTUjRuq35i_frlr71SIBAt0TeUxNcF81OmpXRMeE,1268
+wv_cli/icon/favicon.ico,sha256=rKwWhFU5Gqg1X2l8W9jMKmDm0Ss9kb4ro8CbmvpyuGE,4069
+wv_cli/icon/logo.png,sha256=EmXS4QtmafWqZtXKEgLXs1PSAzu3BDu6xqRhQ6L192A,410862
+wv_cli-0.1.0.dist-info/METADATA,sha256=h-Ju_OoRVY8Iher1XVPNBz8wWZTEQzeurJBceqPRShY,3741
+wv_cli-0.1.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+wv_cli-0.1.0.dist-info/entry_points.txt,sha256=qaE3RufSmXgg3JL_t25pKLjaRPUTxlOv8N8DceJG2R8,39
+wv_cli-0.1.0.dist-info/top_level.txt,sha256=ofuqIKjvgMWv3bm_8iT1p5EALQX4zPRXP4b0NosFbNc,7
+wv_cli-0.1.0.dist-info/RECORD,,

wv_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

wv_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+wv = wv_cli.main:cli

wv_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+wv_cli