# 云屿成页 MCP · Agent installation guide

本页供收到用户安装请求的桌面 AI 使用。用户把官网链接或这页的安装请求发给你后，由你在用户当前使用的电脑上执行安装并接入当前客户端。只收到链接、尚不清楚用户要做什么时，先说明它的用途。安装范围为当前用户，服务名为 `chengye_local`，协议为本地 stdio。

Current release: **1.1.0**, providing **17 tools**, including PDF to a single image, mixed page/image order, size estimates, resumable signing and JPEG/PNG verification.

## 1. Identify the host

Run on the user's Mac under their desktop account. This release supports macOS 13.5 or later on Apple Silicon, with Google Chrome in /Applications. The package includes Node and the document engines. Use the client's normal installation permissions. If Chrome is missing and the user authorizes installing this prerequisite, use the official browser distribution and then resume this guide. If you have only a cloud sandbox, or the OS is unsupported, tell the user what is required. Do not install in the sandbox on behalf of their desktop.

## 2. Install the official release

For **Codex**, run the following block as one command using the local POSIX shell (/bin/sh). For **another local stdio MCP client**, use the same block with `set -- --stdio` in place of `set --`. Allow up to ten minutes for the 53 MB download, verification and installation. Do not send these shell commands back to the user to run.

```sh
(
  set -eu
  set --
  work=$(/usr/bin/mktemp -d /private/tmp/chengye-agent.XXXXXXXX)
  trap '/bin/rm -f "$work/install.sh"; /bin/rmdir "$work"' EXIT
  /usr/bin/curl -q --fail --silent --show-error --proto '=https' --tlsv1.2 \
    --max-time 90 --output "$work/install.sh" \
    https://yyt.yunyulai.com/downloads/install-macos-arm64.sh
  (cd "$work" && printf '%s  install.sh\n' '6a091042a664bb16df0c0dbfe3d723159b659825a472672cfce13c6af34fb2c0' | /usr/bin/shasum -a 256 -c - >&2)
  /bin/sh "$work/install.sh" "$@"
)
```

The bootstrap verifies the release image against the pinned SHA-256 `3717e81ef48ddb0159fc82ac21ec2dc2e87a1e647e448a93d65e16a7202ab9c6`, mounts it read-only and invokes the bundled installer. Run without sudo. Respect system security prompts and existing disabled entries. On a verification error, stop and report it. A repeated installation verifies the existing release. The default materials folder is `~/Documents/云屿成页 AI 文件`. An existing Codex source installation keeps its authorized folder when migrated.

The last stdout line is JSON. Status `configured` means Codex registration was written. Status `registration_required` means the current stdio client still needs registration. For both, `tool_count` and `tools` are from a real protocol handshake using the installed server and an isolated empty file scope. If the status is `disabled`, preserve that setting and tell the user.

## 3. Register and discover tools

- **Codex:** a successful run configures the user’s `chengye_local` server and prints its actual authorized folder. Use the active client’s MCP refresh if available, then request its tool list. If the current chat cannot refresh, explain that a new chat may be needed. A separate probe proves the installed server runs; only the current client’s list proves that client has loaded it.
- **Other clients:** in `--stdio` mode, read the returned JSON and register its exact `name`, `command` and `args` using the current client's supported local MCP registration mechanism. Pass args as an array and preserve paths with spaces. Preserve other servers and the user's chosen file scope. If the client requires a settings confirmation, bring the user to that step. After refreshing or reopening the client, request the tool list. Report registration as pending if you could only install the executable.
- Tell the user what is installed, whether this chat can already use it, and where to put their files. Verify by discovery alone. Do not create documents, orders or charges during installation.

## 4. Use the installed tools when relevant

| User intent | Tools |
| --- | --- |
| Arrange images, preview a PDF, export or resume | `preview_image_pdf`, `images_to_pdf`, `resume_image_pdf` |
| Combine PDF pages and images into one JPEG/PNG, estimate size or resume | `preview_pdf_image`, `pdf_to_image`, `resume_pdf_image` |
| Inspect, preview, insert, replace or reorder pages | `inspect_pdf_pages`, `preview_pdf_edit`, `edit_pdf_pages`, `resume_pdf_edit` |
| Estimate savings or compress a PDF | `estimate_pdf_compression`, `compress_pdf` |
| Find and redact private content | `scan_pdf_privacy`, `redact_pdf` |
| Check a registered file or selected page proofs | `verify_document`, `export_verified_pages`, `verify_page_proof` |

Read the current client’s tool descriptions for parameters. Work on files in the authorized folder. When the user supplies a specific file elsewhere and the host has access, you may copy that file into the authorized folder without changing the configured scope. Image-to-PDF and page-edit previews return the selected page image to the AI client; `preview_pdf_image` returns dimensions and estimated bytes without sending source imagery. PDF-to-image output is one JPEG/PNG, with signing enabled by default. `verify_document` accepts PDF, DOCX, JPEG and PNG; page proofs apply only to PDF. When an explicitly requested export requires payment under the website rules, present the amount and checkout link; the user completes checkout, and you resume the original task.

## Removal on request

In Codex mode, use the release disk image’s bundled uninstall command for the current user. In generic stdio mode, first remove only `chengye_local` from the current client. Other generic clients share the same generic program installation. If another generic client still uses it, keep the files. To remove the common generic installation as well, run the verified DMG’s `卸载.command` with `--profile "$HOME/Library/Application Support/YunyuChengye/AgentStdio"`, using the real desktop home. Leave the materials folder in place.
