Metadata-Version: 2.5
Name: web-presentation-cli
Version: 0.1.0
Summary: Web Presentation CLI - 面向 AI 演示文稿创作平台的命令行与 Agent 工具包
Project-URL: Homepage, https://github.com/LLMxPM/web-presentation-agent-kit
Project-URL: Repository, https://github.com/LLMxPM/web-presentation-agent-kit
Project-URL: Issues, https://github.com/LLMxPM/web-presentation-agent-kit/issues
Requires-Python: >=3.11
Requires-Dist: click>=8.1.7
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.7.0
Requires-Dist: rich>=13.7.0
Description-Content-Type: text/markdown

# Web Presentation CLI (`wp`)

面向 `web-presentation` AI 演示文稿创作平台的官方命令行与 Agent 工具包。

External API 路径、Scope、错误码、幂等和异步任务语义以主仓 [External Agent API v1 契约](https://github.com/LLMxPM/web-presentation/blob/main/docs/developer/reference/external-agent-api.md) 为准；CLI 命令和参数以本仓 `wp --help` 与 CLI 实施文档为准。

## 安装与快速开始

```bash
# 从 PyPI 安装公开发行版
uv tool install web-presentation-cli
# 或使用 pipx
pipx install web-presentation-cli

# 在 agent-kit 仓库根目录安装 CLI
uv pip install -e ./packages/cli

# 登录并绑定 PAT 令牌
wp login --token wp_pat_xxxxxxxx.yyyyyyyyyyyyyyyy
# 生产环境可指定 Backend 根地址（不要包含 /api/v1）
wp login --endpoint https://api.example.com --token wp_pat_xxxxxxxx.yyyyyyyyyyyyyyyy

# 检查环境与连通性
wp doctor

# 查看授权的工作空间并切换当前工作空间
wp workspace list
wp workspace use <workspace_id>

# 查看并切换默认 Profile（Profile 保存 Backend 地址、PAT 和默认工作空间）
wp profile list
wp profile use production

# 常用操作
wp system health
wp project list
wp project configuration get <project_id>
wp page list --project-id <project_id>
wp page dependencies <page_id>
wp component list --scope suggested --project-id <project_id>
wp asset content get <asset_id>
wp theme list
wp style list
wp --json guide list
wp job wait <job_id>
```

复杂写入参数使用 `--payload-file`、`--edits-file`、`--content-file`、`--route-file` 和 `--ids-file`。Build、产物下载、Agent 运行、图片能力、Restore 和 MCP 不属于当前 CLI。

写入命令支持 `--idempotency-key <key>`；网络超时后需要重放同一业务请求时复用原 key，不要把同一个 key 用于不同请求。
