chatup 0.2.15__tar.gz → 0.2.16__tar.gz

{chatup-0.2.15/src/chatup.egg-info → chatup-0.2.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chatup
-Version: 0.2.15
+Version: 0.2.16
 Summary: ChatArch setup CLI extracted from ChatTool
 Author-email: rexwzh <1073853456@qq.com>
 License-Expression: MIT
@@ -62,6 +62,8 @@ chatup playwright install 1.61.1 -I
 chatup workspace default ~/Playground
 ```
 
+`chatup uv` 默认更新已有 `~/.bashrc`、`~/.zshrc` 的自动激活块；使用 `chatup uv --no-activate` 可保持启动配置不变。不会创建缺失的 rc 文件，Windows 跳过此项。
+
 常见安装命令：
 
 ```bash
@@ -74,16 +76,29 @@ chatup nginx proxy-pass ./gitea-local.conf --set SERVER_NAME=gitea.local.example
 chatup crs --install-dir ~/.chatarch/crs/local --port 12392 --redis-port 6379
 ```
 
+## ChatGPT / Codex 桌面应用
+
+```bash
+chatup chatgpt --dry-run
+chatup chatgpt
+chatup chatgpt --yes  # Windows 首次安装时接受 Store 协议
+```
+
+安装包含 Codex 的新版官方 ChatGPT 桌面应用。macOS 需要 Homebrew，Windows 需要 WinGet；Linux preview 暂按[官方说明](https://learn.chatgpt.com/docs/linux/linux-app)手动安装。现有 `chatup codex` 仍安装/配置 Codex CLI。不会自动启动、登录或升级已有应用；[完整约定](https://arch.gh.wzhecnu.cn/ChatUp/commands/#chatgpt-desktop)。
+
+`chatup codex`、`chatup hermes` 未配置模型时默认使用 `gpt-5.6-terra`；用户指定的模型和已有配置仍优先。
+
 ## 当前能力
 
 | 能力组 | 命令 |
 | --- | --- |
 | 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`playwright`、`frp` |
 | 工作区脚手架 | `workspace` |
+| 官方桌面应用 | `chatgpt`（含 Codex） |
 | 本地服务安装 | `gitea`、`discourse`、`zulip`、`mysql`、`nginx`、`crs` |
 | Agent 工具链 | `cc-connect`、`claude`、`codex`、`cursor-agent`、`opencode`、`hermes`、`lark-cli` |
 
-所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/playwright`、`~/.chatarch/chattea`、`~/.chatarch/discourse`、`~/.chatarch/zulip`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。`cursor-agent` 额外注册 ChatEnv `CursorAgent` profile，`discourse`/`zulip` 注册管理员凭据 profile，并支持 `-e/--env` 从 env 文件或 profile 快速配置；显式选择 profile 时不会混入进程环境中的其他账号凭据。CLI 树由 ChatStyle 的注册表渲染。更完整的能力边界见 `docs/capability-map.md`。
+桌面应用使用系统包管理器的原生目录；ChatArch 自管安装项默认目录收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/playwright`、`~/.chatarch/chattea`、`~/.chatarch/discourse`、`~/.chatarch/zulip`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。`cursor-agent` 额外注册 ChatEnv `CursorAgent` profile，`discourse`/`zulip` 注册管理员凭据 profile，并支持 `-e/--env` 从 env 文件或 profile 快速配置；显式选择 profile 时不会混入进程环境中的其他账号凭据。CLI 树由 ChatStyle 的注册表渲染。更完整的能力边界见 `docs/capability-map.md`。
 
 ## 开发
 

{chatup-0.2.15 → chatup-0.2.16}/README.md

@@ -31,6 +31,8 @@ chatup playwright install 1.61.1 -I
 chatup workspace default ~/Playground
 ```
 
+`chatup uv` 默认更新已有 `~/.bashrc`、`~/.zshrc` 的自动激活块；使用 `chatup uv --no-activate` 可保持启动配置不变。不会创建缺失的 rc 文件，Windows 跳过此项。
+
 常见安装命令：
 
 ```bash
@@ -43,16 +45,29 @@ chatup nginx proxy-pass ./gitea-local.conf --set SERVER_NAME=gitea.local.example
 chatup crs --install-dir ~/.chatarch/crs/local --port 12392 --redis-port 6379
 ```
 
+## ChatGPT / Codex 桌面应用
+
+```bash
+chatup chatgpt --dry-run
+chatup chatgpt
+chatup chatgpt --yes  # Windows 首次安装时接受 Store 协议
+```
+
+安装包含 Codex 的新版官方 ChatGPT 桌面应用。macOS 需要 Homebrew，Windows 需要 WinGet；Linux preview 暂按[官方说明](https://learn.chatgpt.com/docs/linux/linux-app)手动安装。现有 `chatup codex` 仍安装/配置 Codex CLI。不会自动启动、登录或升级已有应用；[完整约定](https://arch.gh.wzhecnu.cn/ChatUp/commands/#chatgpt-desktop)。
+
+`chatup codex`、`chatup hermes` 未配置模型时默认使用 `gpt-5.6-terra`；用户指定的模型和已有配置仍优先。
+
 ## 当前能力
 
 | 能力组 | 命令 |
 | --- | --- |
 | 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`playwright`、`frp` |
 | 工作区脚手架 | `workspace` |
+| 官方桌面应用 | `chatgpt`（含 Codex） |
 | 本地服务安装 | `gitea`、`discourse`、`zulip`、`mysql`、`nginx`、`crs` |
 | Agent 工具链 | `cc-connect`、`claude`、`codex`、`cursor-agent`、`opencode`、`hermes`、`lark-cli` |
 
-所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/playwright`、`~/.chatarch/chattea`、`~/.chatarch/discourse`、`~/.chatarch/zulip`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。`cursor-agent` 额外注册 ChatEnv `CursorAgent` profile，`discourse`/`zulip` 注册管理员凭据 profile，并支持 `-e/--env` 从 env 文件或 profile 快速配置；显式选择 profile 时不会混入进程环境中的其他账号凭据。CLI 树由 ChatStyle 的注册表渲染。更完整的能力边界见 `docs/capability-map.md`。
+桌面应用使用系统包管理器的原生目录；ChatArch 自管安装项默认目录收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/playwright`、`~/.chatarch/chattea`、`~/.chatarch/discourse`、`~/.chatarch/zulip`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。`cursor-agent` 额外注册 ChatEnv `CursorAgent` profile，`discourse`/`zulip` 注册管理员凭据 profile，并支持 `-e/--env` 从 env 文件或 profile 快速配置；显式选择 profile 时不会混入进程环境中的其他账号凭据。CLI 树由 ChatStyle 的注册表渲染。更完整的能力边界见 `docs/capability-map.md`。
 
 ## 开发
 

{chatup-0.2.15 → chatup-0.2.16}/src/chatup/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.15"
+__version__ = "0.2.16"

chatup-0.2.16/src/chatup/setup/chatgpt.py

@@ -0,0 +1,132 @@
+"""Install the official ChatGPT desktop app (the successor to Codex App).
+
+The OS package manager owns downloads, signatures, application paths and state.
+This module never launches the app or changes Codex CLI configuration/auth.
+"""
+from __future__ import annotations
+
+import platform
+import shutil
+import subprocess
+from typing import Any
+
+CHATGPT_CASK = "homebrew/cask/chatgpt"
+CHATGPT_STORE_ID = "9PLM9XGG6VKS"
+DOWNLOAD_URL = "https://chatgpt.com/download/"
+LINUX_GUIDE_URL = "https://learn.chatgpt.com/docs/linux/linux-app"
+
+
+def plan_chatgpt_install(*, yes: bool = False) -> dict[str, Any]:
+    """Return a side-effect-free install plan for the current OS.
+
+    ``yes`` explicitly accepts Microsoft Store source/package agreements.
+    Homebrew/WinGet resolve the current release and enforce OS/CPU requirements.
+    Linux preview installation is deliberately not automated here.
+    """
+    system = platform.system()
+    if system == "Darwin":
+        manager = "brew"
+        package = CHATGPT_CASK
+        command = [manager, "install", "--cask", package]
+        verify_command = [manager, "list", "--cask", "--versions", package]
+        manager_url = "https://brew.sh/"
+    elif system == "Windows":
+        manager = "winget"
+        package = CHATGPT_STORE_ID
+        selector = ["--id", package, "--exact", "--source", "msstore", "--disable-interactivity"]
+        command = [manager, "install", *selector, "--no-upgrade"]
+        verify_command = [manager, "list", *selector]
+        if yes:
+            command += ["--accept-package-agreements", "--accept-source-agreements"]
+            verify_command += ["--accept-source-agreements"]
+        manager_url = "https://aka.ms/getwinget"
+    else:
+        guide = LINUX_GUIDE_URL if system == "Linux" else DOWNLOAD_URL
+        raise RuntimeError(
+            f"ChatUp automates ChatGPT desktop installation on macOS and Windows only; "
+            f"current platform: {system}. Official downloads/instructions: {guide}"
+        )
+    return {
+        "app": "ChatGPT (includes Codex)",
+        "platform": system,
+        "manager": manager,
+        "manager_url": manager_url,
+        "package": package,
+        "command": command,
+        "verify_command": verify_command,
+        "download_url": DOWNLOAD_URL,
+    }
+
+
+def _is_installed(plan: dict[str, Any], executable: str) -> bool:
+    result = subprocess.run(
+        [executable, *plan["verify_command"][1:]],
+        capture_output=True,
+        text=True,
+        encoding="utf-8",
+        errors="replace",
+        check=False,
+        timeout=60,
+    )
+    if result.returncode != 0 or not result.stdout.strip():
+        return False
+    if plan["manager"] == "brew":
+        for line in result.stdout.splitlines():
+            parts = line.split()
+            if len(parts) < 2 or parts[0] != "chatgpt":
+                continue
+            if any(version.startswith("1.") for version in parts[1:]):
+                raise RuntimeError(
+                    "An older ChatGPT Classic cask is registered as chatgpt. "
+                    "Migrate it manually with Homebrew before installing the new "
+                    f"ChatGPT/Codex app: {DOWNLOAD_URL}"
+                )
+            return True
+        return False
+    # WinGet's exact Store selector exits zero only when a matching package exists.
+    return True
+
+
+def setup_chatgpt(*, dry_run: bool = False, yes: bool = False) -> dict[str, Any]:
+    """Install if absent, then verify registration with the package manager.
+
+    Returns the plan plus ``status`` (planned/already_installed/installed) and
+    ``verified``. Dry-run does not require or invoke a package manager. Existing
+    installations are not upgraded, overwritten or migrated; authentication and
+    launching remain user actions. Raises RuntimeError on failed/unknown results.
+    """
+    plan = plan_chatgpt_install(yes=yes)
+    result = {**plan, "status": "planned", "verified": False}
+    if dry_run:
+        return result
+    executable = shutil.which(plan["manager"])
+    if not executable:
+        raise RuntimeError(
+            f"Required package manager {plan['manager']} is not on PATH. "
+            f"Install it first: {plan['manager_url']} or download manually: {DOWNLOAD_URL}"
+        )
+    try:
+        if _is_installed(plan, executable):
+            return {**result, "status": "already_installed", "verified": True}
+        installed = subprocess.run(
+            [executable, *plan["command"][1:]], check=False, timeout=1800,
+        )
+        if installed.returncode != 0:
+            hint = " Use --yes to accept Store agreements." if plan["manager"] == "winget" and not yes else ""
+            raise RuntimeError(
+                f"ChatGPT installer failed (exit {installed.returncode}). "
+                f"Check the package manager output above.{hint}"
+            )
+        if not _is_installed(plan, executable):
+            raise RuntimeError(
+                "ChatGPT installation verification failed. Check the package manager "
+                "state before retrying; installation success is not confirmed."
+            )
+    except subprocess.TimeoutExpired as exc:
+        raise RuntimeError(
+            "ChatGPT package manager timed out; the installation state is unknown. "
+            "Check the package manager before retrying."
+        ) from exc
+    except OSError as exc:
+        raise RuntimeError(f"Cannot execute {plan['manager']}: {exc}") from exc
+    return {**result, "status": "installed", "verified": True}

{chatup-0.2.15 → chatup-0.2.16}/src/chatup/setup/codex.py

@@ -30,7 +30,7 @@ from chatup.setup.nodejs import (
 from chatup.utils.custom_logger import setup_logger
 from chatup.utils.platforming import chmod_private
 
-DEFAULT_MODEL = "gpt-5.5"
+DEFAULT_MODEL = "gpt-5.6-terra"
 DEFAULT_BASE_URL = "https://api.openai.com/v1"
 DEFAULT_AUTH_METHOD = "apikey"
 _ENV_VAR_REF_RE = re.compile(r"\$(?:\{[^}]+\}|[A-Za-z_][A-Za-z0-9_]*)")

{chatup-0.2.15 → chatup-0.2.16}/src/chatup/setup/elements.py

@@ -6,7 +6,8 @@ import click
 from chatstyle import INTERACTIVE_OPTION_HELP
 
 from chatup.setup.claude import setup_claude
-from chatup.setup.codex import setup_codex
+from chatup.setup.codex import DEFAULT_MODEL as DEFAULT_CODEX_MODEL, setup_codex
+from chatup.setup.chatgpt import setup_chatgpt
 from chatup.setup.cursor_agent import CREDENTIAL_STORE_CHOICES, setup_cursor_agent
 from chatup.setup.cc_connect import setup_cc_connect
 import chatup.setup.crs as crs_module
@@ -37,7 +38,7 @@ from chatup.setup.gitea import (
     DEFAULT_WORK_DIR as DEFAULT_GITEA_WORK_DIR,
     setup_gitea,
 )
-from chatup.setup.hermes import setup_hermes
+from chatup.setup.hermes import DEFAULT_MODEL as DEFAULT_HERMES_MODEL, setup_hermes
 from chatup.setup.lark_cli import setup_lark_cli
 from chatup.setup.mysql import (
     DEFAULT_MYSQL_BIND_ADDRESS,
@@ -102,8 +103,14 @@ def nodejs_setup(interactive, log_level):
     setup_nodejs(interactive=interactive, log_level=log_level)
 
 
-def uv_setup(venv, python_version, force, log_level):
-    setup_uv(venv=venv, python_version=python_version, force=force, log_level=log_level)
+def uv_setup(venv, python_version, force, log_level, shell_activate):
+    setup_uv(
+        venv=venv,
+        python_version=python_version,
+        force=force,
+        log_level=log_level,
+        shell_activate=shell_activate,
+    )
 
 
 def docker_setup(sudo, interactive, log_level):
@@ -120,6 +127,20 @@ def zsh_setup(omz, aliases, login_shell, interactive, log_level):
     )
 
 
+def chatgpt_setup(dry_run, yes):
+    try:
+        result = setup_chatgpt(dry_run=dry_run, yes=yes)
+    except RuntimeError as exc:
+        raise click.ClickException(str(exc)) from exc
+    click.echo(result["app"])
+    if result["status"] == "planned":
+        click.echo("预览安装命令（未执行）：" + " ".join(result["command"]))
+    elif result["status"] == "already_installed":
+        click.echo("已安装，并已通过包管理器回读确认；未升级或启动应用。")
+    else:
+        click.echo("安装完成，已通过包管理器回读确认。请手动打开 ChatGPT 并登录。")
+
+
 def codex_setup(api_key, base_url, model, env, interactive, install_only, log_level):
     setup_codex(
         api_key=api_key,
@@ -1251,6 +1272,29 @@ SETUP_COMMAND_ELEMENTS = (
                     "help": "Clear and recreate the target environment if it already exists.",
                 },
             ),
+            SetupOptionElement(
+                param_decls=("--activate/--no-activate", "shell_activate"),
+                kwargs={
+                    "default": True,
+                    "show_default": True,
+                    "help": "Update auto-activation in existing ~/.bashrc and ~/.zshrc (POSIX only).",
+                },
+            ),
+        ),
+    ),
+    SetupCommandElement(
+        name="chatgpt",
+        help="Install the official ChatGPT desktop app (includes Codex), not the Codex CLI.",
+        callback=chatgpt_setup,
+        options=(
+            SetupOptionElement(
+                param_decls=("--dry-run",),
+                kwargs={"is_flag": True, "help": "Show the install plan without executing or downloading anything."},
+            ),
+            SetupOptionElement(
+                param_decls=("--yes", "-y"),
+                kwargs={"is_flag": True, "help": "Accept Microsoft Store source/package agreements on Windows."},
+            ),
         ),
     ),
     SetupCommandElement(
@@ -1282,7 +1326,10 @@ SETUP_COMMAND_ELEMENTS = (
             ),
             SetupOptionElement(
                 param_decls=("--model",),
-                kwargs={"default": None, "help": "Optional default model name."},
+                kwargs={
+                    "default": None,
+                    "help": f"Optional model override; fallback: {DEFAULT_CODEX_MODEL}.",
+                },
             ),
             SetupOptionElement(
                 param_decls=("-e", "--env"),
@@ -1545,7 +1592,7 @@ SETUP_COMMAND_ELEMENTS = (
             ),
             SetupOptionElement(
                 param_decls=("--model",),
-                kwargs={"default": None, "help": "Hermes default model."},
+                kwargs={"default": None, "help": f"Hermes model override; fallback: {DEFAULT_HERMES_MODEL}."},
             ),
             SetupOptionElement(
                 param_decls=("--with-webui-env",),

{chatup-0.2.15 → chatup-0.2.16}/src/chatup/setup/hermes.py

@@ -23,7 +23,7 @@ logger = setup_logger("setup_hermes")
 CHATARCH_HERMES_INSTALLER_URL = (
     "https://raw.githubusercontent.com/ChatArch/hermes-agent/main/scripts/install.sh"
 )
-DEFAULT_MODEL = "gpt-5.4-mini"
+DEFAULT_MODEL = "gpt-5.6-terra"
 DEFAULT_BASE_URL = "https://api.openai.com/v1"
 DEFAULT_WEBUI_HOST = "127.0.0.1"
 DEFAULT_WEBUI_PORT = 8787

{chatup-0.2.15 → chatup-0.2.16}/src/chatup/setup/uv.py

@@ -3,8 +3,11 @@ from __future__ import annotations
 import os
 import shlex
 import shutil
+import stat
 import subprocess
+import tempfile
 from pathlib import Path
+from typing import Any
 
 import click
 
@@ -16,6 +19,11 @@ DEFAULT_VENV_PATH = Path("~/.chatarch/venv")
 UV_INSTALLER_URL = "https://astral.sh/uv/install.sh"
 UV_WINDOWS_INSTALLER_URL = "https://astral.sh/uv/install.ps1"
 
+# Share ChatUV's markers so switching bootstrap tools replaces the same block.
+SHELL_ACTIVATE_BEGIN = "# >>> chatuv activate >>>"
+SHELL_ACTIVATE_END = "# <<< chatuv activate <<<"
+SHELL_RC_NAMES = (".zshrc", ".bashrc")
+
 logger = setup_logger("setup_uv")
 
 
@@ -140,12 +148,88 @@ def create_chatarch_python_env(
         raise click.ClickException(f"Failed to create ChatArch Python env at {venv_path}: {message}")
 
 
+def _upsert_activation_block(text: str, block: str) -> str:
+    lines = text.splitlines(keepends=True)
+    starts = [i for i, line in enumerate(lines) if line.rstrip("\r\n") == SHELL_ACTIVATE_BEGIN]
+    ends = [i for i, line in enumerate(lines) if line.rstrip("\r\n") == SHELL_ACTIVATE_END]
+    if starts or ends:
+        if len(starts) != 1 or len(ends) != 1 or starts[0] >= ends[0]:
+            raise ValueError("Incomplete or duplicate activation block; repair the marked block first")
+        return "".join(lines[:starts[0]]) + block + "".join(lines[ends[0] + 1:])
+    separator = "" if not text else ("\n" if text.endswith("\n") else "\n\n")
+    return text + separator + block
+
+
+def _atomic_write_rc(rc_path: Path, text: str) -> None:
+    # Replace the resolved target, not a dotfiles symlink itself.
+    target = rc_path.resolve(strict=True)
+    mode = stat.S_IMODE(target.stat().st_mode)
+    fd, name = tempfile.mkstemp(prefix=f".{target.name}.chatup-", dir=target.parent)
+    temporary = Path(name)
+    try:
+        with os.fdopen(fd, "w", encoding="utf-8", newline="") as rc:
+            rc.write(text)
+            rc.flush()
+            temporary.chmod(mode)
+            os.fsync(rc.fileno())
+        os.replace(temporary, target)
+    finally:
+        temporary.unlink(missing_ok=True)
+
+
+def configure_shell_activation(venv_path: Path, *, home: Path | None = None) -> dict[str, Any]:
+    """Update existing Bash/Zsh rc files without creating missing ones.
+
+    Reuse ChatUV's managed markers; preserve all text outside the block and
+    leave unchanged files untouched. Paths are absolute and shell-quoted.
+    """
+    result: dict[str, Any] = {"updated": [], "unchanged": [], "missing": [], "skipped": False}
+    if is_windows():
+        click.echo("Shell activation update is skipped on Windows.")
+        result["skipped"] = True
+        return result
+
+    activate = shlex.quote(str(venv_path.expanduser().absolute() / "bin" / "activate"))
+    block = "\n".join((
+        SHELL_ACTIVATE_BEGIN,
+        "# Managed by ChatUV / ChatUp. Remove this block to stop auto-activation.",
+        f"if [ -f {activate} ]; then",
+        f"  source {activate}",
+        "fi",
+        SHELL_ACTIVATE_END,
+        "",
+    ))
+    home_path = Path(home).expanduser() if home is not None else Path.home()
+    for name in SHELL_RC_NAMES:
+        rc_path = home_path / name
+        if not rc_path.is_file():
+            result["missing"].append(str(rc_path))
+            continue
+        try:
+            with rc_path.open("r", encoding="utf-8", newline="") as rc:
+                text = rc.read()
+            updated = _upsert_activation_block(text, block)
+            if updated == text:
+                result["unchanged"].append(str(rc_path))
+                continue
+            _atomic_write_rc(rc_path, updated)
+        except (OSError, ValueError) as exc:
+            raise click.ClickException(f"Cannot update shell activation block in {rc_path}: {exc}") from exc
+        result["updated"].append(str(rc_path))
+        click.echo(f"Updated shell activation: {rc_path}")
+    if not result["updated"] and not result["unchanged"]:
+        click.echo("No existing shell rc file found; skipped auto-activation update.")
+    return result
+
+
 def setup_uv(
     venv: str | None = None,
     python_version: str = DEFAULT_PYTHON_VERSION,
     force: bool = False,
     log_level: str = "INFO",
-) -> dict[str, str]:
+    *,
+    shell_activate: bool = True,
+) -> dict[str, Any]:
     _configure_logger(log_level)
     target = Path(venv or str(DEFAULT_VENV_PATH)).expanduser()
     python_version = str(python_version).strip() or DEFAULT_PYTHON_VERSION
@@ -156,12 +240,14 @@ def setup_uv(
 
     if is_chatarch_python_ready(target, python_version) and not force:
         click.echo("ChatArch Python environment already ready.")
+        activation = configure_shell_activation(target) if shell_activate else None
         return {
             "uv": uv_bin,
             "venv": str(target),
             "python": str(_venv_python_path(target)),
             "python_version": python_version,
             "status": "ready",
+            "activation": activation,
         }
 
     python_bin = _venv_python_path(target)
@@ -191,6 +277,7 @@ def setup_uv(
             f"ChatArch Python env was created at {target}, but Python {python_version} with pip was not verified."
         )
 
+    activation = configure_shell_activation(target) if shell_activate else None
     python_bin = _venv_python_path(target)
     click.echo(f"ChatArch Python environment ready: {target}")
     click.echo(f"Activate with: {venv_activate_hint(target)}")
@@ -201,4 +288,5 @@ def setup_uv(
         "python": str(python_bin),
         "python_version": python_version,
         "status": "created",
+        "activation": activation,
     }

{chatup-0.2.15 → chatup-0.2.16/src/chatup.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chatup
-Version: 0.2.15
+Version: 0.2.16
 Summary: ChatArch setup CLI extracted from ChatTool
 Author-email: rexwzh <1073853456@qq.com>
 License-Expression: MIT
@@ -62,6 +62,8 @@ chatup playwright install 1.61.1 -I
 chatup workspace default ~/Playground
 ```
 
+`chatup uv` 默认更新已有 `~/.bashrc`、`~/.zshrc` 的自动激活块；使用 `chatup uv --no-activate` 可保持启动配置不变。不会创建缺失的 rc 文件，Windows 跳过此项。
+
 常见安装命令：
 
 ```bash
@@ -74,16 +76,29 @@ chatup nginx proxy-pass ./gitea-local.conf --set SERVER_NAME=gitea.local.example
 chatup crs --install-dir ~/.chatarch/crs/local --port 12392 --redis-port 6379
 ```
 
+## ChatGPT / Codex 桌面应用
+
+```bash
+chatup chatgpt --dry-run
+chatup chatgpt
+chatup chatgpt --yes  # Windows 首次安装时接受 Store 协议
+```
+
+安装包含 Codex 的新版官方 ChatGPT 桌面应用。macOS 需要 Homebrew，Windows 需要 WinGet；Linux preview 暂按[官方说明](https://learn.chatgpt.com/docs/linux/linux-app)手动安装。现有 `chatup codex` 仍安装/配置 Codex CLI。不会自动启动、登录或升级已有应用；[完整约定](https://arch.gh.wzhecnu.cn/ChatUp/commands/#chatgpt-desktop)。
+
+`chatup codex`、`chatup hermes` 未配置模型时默认使用 `gpt-5.6-terra`；用户指定的模型和已有配置仍优先。
+
 ## 当前能力
 
 | 能力组 | 命令 |
 | --- | --- |
 | 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`playwright`、`frp` |
 | 工作区脚手架 | `workspace` |
+| 官方桌面应用 | `chatgpt`（含 Codex） |
 | 本地服务安装 | `gitea`、`discourse`、`zulip`、`mysql`、`nginx`、`crs` |
 | Agent 工具链 | `cc-connect`、`claude`、`codex`、`cursor-agent`、`opencode`、`hermes`、`lark-cli` |
 
-所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/playwright`、`~/.chatarch/chattea`、`~/.chatarch/discourse`、`~/.chatarch/zulip`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。`cursor-agent` 额外注册 ChatEnv `CursorAgent` profile，`discourse`/`zulip` 注册管理员凭据 profile，并支持 `-e/--env` 从 env 文件或 profile 快速配置；显式选择 profile 时不会混入进程环境中的其他账号凭据。CLI 树由 ChatStyle 的注册表渲染。更完整的能力边界见 `docs/capability-map.md`。
+桌面应用使用系统包管理器的原生目录；ChatArch 自管安装项默认目录收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/playwright`、`~/.chatarch/chattea`、`~/.chatarch/discourse`、`~/.chatarch/zulip`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。`cursor-agent` 额外注册 ChatEnv `CursorAgent` profile，`discourse`/`zulip` 注册管理员凭据 profile，并支持 `-e/--env` 从 env 文件或 profile 快速配置；显式选择 profile 时不会混入进程环境中的其他账号凭据。CLI 树由 ChatStyle 的注册表渲染。更完整的能力边界见 `docs/capability-map.md`。
 
 ## 开发
 

{chatup-0.2.15 → chatup-0.2.16}/src/chatup.egg-info/SOURCES.txt

@@ -29,6 +29,7 @@ src/chatup/runtime/chromedriver.py
 src/chatup/runtime/playwright.py
 src/chatup/setup/__init__.py
 src/chatup/setup/cc_connect.py
+src/chatup/setup/chatgpt.py
 src/chatup/setup/claude.py
 src/chatup/setup/cli.py
 src/chatup/setup/codex.py
@@ -71,12 +72,14 @@ src/chatup/utils/custom_logger.py
 src/chatup/utils/pathing.py
 src/chatup/utils/platforming.py
 tests/test_browser_backend_cli.py
+tests/test_chatgpt_setup.py
 tests/test_chrome_for_testing.py
 tests/test_chromedriver.py
 tests/test_cli_tree_docs.py
 tests/test_codex_setup.py
 tests/test_crs_setup.py
 tests/test_cursor_agent_setup.py
+tests/test_hermes_model_defaults.py
 tests/test_playwright.py
 tests/test_playwright_cli.py
 tests/test_publish_workflow.py
@@ -84,6 +87,7 @@ tests/test_pyproject_metadata.py
 tests/test_service_installers.py
 tests/test_setup_cli.py
 tests/test_twikoo_setup.py
+tests/test_uv_activation.py
 tests/test_version.py
 tests/test_windows_compat.py
 tests/test_workspace_setup.py