chatup 0.2.22__tar.gz → 0.2.24__tar.gz

{chatup-0.2.22/src/chatup.egg-info → chatup-0.2.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chatup
-Version: 0.2.22
+Version: 0.2.24
 Summary: ChatArch setup CLI extracted from ChatTool
 Author-email: rexwzh <1073853456@qq.com>
 License-Expression: MIT
@@ -18,6 +18,7 @@ Requires-Dist: chatstyle[tui]<0.3.0,>=0.2.0
 Requires-Dist: chatenv<0.3.0,>=0.2.11
 Requires-Dist: ChatGlance<0.4.0,>=0.3.0
 Requires-Dist: python-dotenv<2.0,>=1.0
+Requires-Dist: tomlkit<1.0,>=0.13
 Requires-Dist: colorama
 Provides-Extra: dev
 Requires-Dist: build; extra == "dev"
@@ -46,6 +47,7 @@ ChatUp 是 ChatArch 的独立环境与工具安装 CLI。它承接原来 `chatto
 | 阅读完整顶层 CLI 树和独立 CFT/ChromeDriver/Playwright contract | `docs/cli-tree.md` |
 | 查看命令分组、参数边界和服务默认路径 | `docs/commands.md` |
 | 校对哪些 ChatArch setup 流程已经有一等命令 | `docs/capability-map.md` |
+| 预览或配置 Linux X11 Computer Use 执行端 | `docs/computer-use.md` |
 | 理解 `chatup workspace` 创建的目录和项目记录约定 | `docs/workspace.md` |
 | 安装 ChatTea-compatible Gitea、Discourse/Zulip 社区服务配置、ChatData-compatible MySQL、user-level NGINX 和 CRS | `docs/commands.md` |
 
@@ -65,6 +67,8 @@ chatup workspace ~/Playground
 
 `chatup uv` 默认更新已有 `~/.bashrc`、`~/.zshrc` 的自动激活块；使用 `chatup uv --no-activate` 可保持启动配置不变。不会创建缺失的 rc 文件，Windows 跳过此项。
 
+Linux Debian/Ubuntu x86_64 X11 执行端可运行 `chatup computer-use` 只读预览；明确使用 `chatup computer-use --sudo` 才应用。支持显式选择同用户桌面并复用普通 Chrome 默认 profile，生成独立 MCP/Chrome/terminal/status 入口。它不修改 Agent 配置，也不修复 Hermes 按话题 SSH 绑定的默认截图路由。详见 [Computer Use](docs/computer-use.md)。
+
 常见安装命令：
 
 ```bash
@@ -133,11 +137,12 @@ chatup chatgpt --yes  # Windows 首次安装时接受 Store 协议
 | 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`playwright`、`frp` |
 | 工作区脚手架 | `workspace` |
 | 桌面应用 | `macos`（Snipaste/iTerm2/Chrome/Blender 多选）、`chrome`、`snipaste`（macOS/Windows）、`iterm`（仅 macOS）、`chatgpt`（含 Codex） |
+| Linux X11 Computer Use | `computer-use`（默认只读预览，`--sudo` 应用） |
 | 视频项目 | `remotion` |
 | 本地服务安装 | `gitea`、`glance`、`discourse`、`zulip`、`mysql`、`nginx`、`crs` |
+| Agent 工具链 | `cc-connect`、`claude`、`codex`、`cursor-agent`、`opencode`、`hermes`、`lark-cli` |
 
 `chatup glance` 裸命令安装 `ChatArch/glance` 最新稳定维护版到有效 ChatArch home 下的 `glance`。当前仅支持 Linux amd64；严格验证归档、`SHA256SUMS`、`BUILDINFO.txt`、source SHA 和原始二进制版本，复用 ChatGlance portable API 初始化 loopback 配置。它不启动服务、不建立公网入口、不写密码；重复运行保留配置和数据，版本变更请使用 `chatglance runtime update`。
-| Agent 工具链 | `cc-connect`、`claude`、`codex`、`cursor-agent`、`opencode`、`hermes`、`lark-cli` |
 
 桌面应用使用系统原生应用目录；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.22 → chatup-0.2.24}/README.md

@@ -14,6 +14,7 @@ ChatUp 是 ChatArch 的独立环境与工具安装 CLI。它承接原来 `chatto
 | 阅读完整顶层 CLI 树和独立 CFT/ChromeDriver/Playwright contract | `docs/cli-tree.md` |
 | 查看命令分组、参数边界和服务默认路径 | `docs/commands.md` |
 | 校对哪些 ChatArch setup 流程已经有一等命令 | `docs/capability-map.md` |
+| 预览或配置 Linux X11 Computer Use 执行端 | `docs/computer-use.md` |
 | 理解 `chatup workspace` 创建的目录和项目记录约定 | `docs/workspace.md` |
 | 安装 ChatTea-compatible Gitea、Discourse/Zulip 社区服务配置、ChatData-compatible MySQL、user-level NGINX 和 CRS | `docs/commands.md` |
 
@@ -33,6 +34,8 @@ chatup workspace ~/Playground
 
 `chatup uv` 默认更新已有 `~/.bashrc`、`~/.zshrc` 的自动激活块；使用 `chatup uv --no-activate` 可保持启动配置不变。不会创建缺失的 rc 文件，Windows 跳过此项。
 
+Linux Debian/Ubuntu x86_64 X11 执行端可运行 `chatup computer-use` 只读预览；明确使用 `chatup computer-use --sudo` 才应用。支持显式选择同用户桌面并复用普通 Chrome 默认 profile，生成独立 MCP/Chrome/terminal/status 入口。它不修改 Agent 配置，也不修复 Hermes 按话题 SSH 绑定的默认截图路由。详见 [Computer Use](docs/computer-use.md)。
+
 常见安装命令：
 
 ```bash
@@ -101,11 +104,12 @@ chatup chatgpt --yes  # Windows 首次安装时接受 Store 协议
 | 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`playwright`、`frp` |
 | 工作区脚手架 | `workspace` |
 | 桌面应用 | `macos`（Snipaste/iTerm2/Chrome/Blender 多选）、`chrome`、`snipaste`（macOS/Windows）、`iterm`（仅 macOS）、`chatgpt`（含 Codex） |
+| Linux X11 Computer Use | `computer-use`（默认只读预览，`--sudo` 应用） |
 | 视频项目 | `remotion` |
 | 本地服务安装 | `gitea`、`glance`、`discourse`、`zulip`、`mysql`、`nginx`、`crs` |
+| Agent 工具链 | `cc-connect`、`claude`、`codex`、`cursor-agent`、`opencode`、`hermes`、`lark-cli` |
 
 `chatup glance` 裸命令安装 `ChatArch/glance` 最新稳定维护版到有效 ChatArch home 下的 `glance`。当前仅支持 Linux amd64；严格验证归档、`SHA256SUMS`、`BUILDINFO.txt`、source SHA 和原始二进制版本，复用 ChatGlance portable API 初始化 loopback 配置。它不启动服务、不建立公网入口、不写密码；重复运行保留配置和数据，版本变更请使用 `chatglance runtime update`。
-| Agent 工具链 | `cc-connect`、`claude`、`codex`、`cursor-agent`、`opencode`、`hermes`、`lark-cli` |
 
 桌面应用使用系统原生应用目录；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.22 → chatup-0.2.24}/pyproject.toml

@@ -15,6 +15,7 @@ dependencies = [
     "chatenv>=0.2.11,<0.3.0",
     "ChatGlance>=0.3.0,<0.4.0",
     "python-dotenv>=1.0,<2.0",
+    "tomlkit>=0.13,<1.0",
     "colorama",
 ]
 authors = [{name = "rexwzh", email = "1073853456@qq.com"}]

{chatup-0.2.22 → chatup-0.2.24}/src/chatup/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.22"
+__version__ = "0.2.24"

{chatup-0.2.22 → chatup-0.2.24}/src/chatup/cli.py

@@ -6,6 +6,7 @@ from chatstyle import add_tree_option
 from chatup import __version__
 from chatup.commands.chrome_for_testing import cli as chrome_for_testing_cli
 from chatup.commands.chromedriver import cli as chromedriver_cli
+from chatup.commands.computer_use import cli as computer_use_cli
 from chatup.commands.desktop import chrome_cli, iterm_cli, snipaste_cli
 from chatup.commands.macos import macos_cli
 from chatup.commands.playwright import cli as playwright_cli
@@ -33,6 +34,7 @@ def doctor() -> None:
 
 register_setup_commands(main)
 main.add_command(chrome_for_testing_cli)
+main.add_command(computer_use_cli)
 main.add_command(chromedriver_cli)
 main.add_command(playwright_cli)
 main.add_command(chrome_cli)

chatup-0.2.24/src/chatup/commands/computer_use.py

@@ -0,0 +1,29 @@
+"""Top-level Linux Computer Use planner and opt-in installer."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+import subprocess
+
+import click
+
+from chatup.computer_use import apply_computer_use, plan_computer_use
+
+
+@click.command(name="computer-use")
+@click.option("--sudo", is_flag=True, help="Apply the completed plan; sudo is used only for OS packages.")
+@click.option("--dry-run", is_flag=True, help="Show the read-only plan, including when --sudo is present.")
+@click.option("--display", help="Attach to an explicitly selected local X11 display, e.g. :20.")
+@click.option("--xauthority", type=click.Path(path_type=Path), help="Same-user Xauthority for --display.")
+@click.option("--state", type=click.Path(path_type=Path), help="Select existing same-user desktop metadata JSON.")
+@click.option("--home", type=click.Path(path_type=Path), help="Override the effective ChatArch home for this runtime.")
+def cli(sudo: bool, dry_run: bool, display: str | None, xauthority: Path | None,
+        state: Path | None, home: Path | None) -> None:
+    """Plan Linux X11 Computer Use; apply only with --sudo."""
+    try:
+        plan = plan_computer_use(home=home, display=display, xauthority=xauthority, state=state)
+        result = apply_computer_use(plan) if sudo and not dry_run else plan.to_dict()
+    except (OSError, ValueError, RuntimeError, subprocess.SubprocessError) as exc:
+        raise click.ClickException(str(exc)) from exc
+    click.echo(json.dumps(result, ensure_ascii=False, indent=2, sort_keys=True))