用途：通过已安装的 polygres 命令操作 Polygres 项目，并将 CLI 作为操作与安全边界，不调用私有控制面路由，也不臆测未公开的请求负载。
主要能力：认证与项目选择、同步项目模式处理、数据库与 Runtime API 密钥、CSV/TSV/JSON/JSONL 数据导入、单行写入、迁移与 SQL 安全、图与文本/向量检索、Polygres AI Context 集合与点操作、JSON 输出与自动化。若当前会话提供 Polygres MCP 工具，优先读取 references/mcp-tool-contract.md 并使用兼容工具，调用 whoami 并遵守固定或多项目边界；仅在用户明确要求 CLI、MCP 缺失或不兼容，或操作属于 CLI 范围（迁移、Runtime 密钥、交互式数据库、导入启动、旧版向量/文本配置）时使用 CLI 工作流，不得用 MCP 工具镜像 CLI 命令。
使用方式：运行前先执行 polygres --version 与 polygres --help；命令缺失时告知用户如何安装 polygres-cli 并由其批准，不静默安装。认证用 polygres login，身份或组织不确定时先运行 polygres whoami。项目通过 polygres projects list、显式 --project 或 polygres projects use <project> 解析，破坏性、涉密或改结构操作前需说明目标项目。需机器解析时使用 polygres --json，stdout 为 JSON，stderr 为诊断。按任务读取对应 references 文件，如 authentication-and-projects.md、synced-projects.md、database-and-keys.md、data-imports.md、rows.md、migrations.md、retrieval.md、context.md、automation-and-errors.md。
限制：replace_existing 导入、应用 SQL 迁移、创建或更新文本配置、重建文本索引、撤销 Runtime 密钥、删除向量/文本配置、所有持久 pgContext 变更、--yes 及难以撤销的操作前必须获得明确同意，且 --yes 仅在针对同一操作与目标获批后添加。禁止请求、检索、存储、记录或传递原生数据库密码，禁止把同步源连接放入参数、生成文件或记录；优先使用 CLI 隐藏式交互 URL 提示，非交互场景用 --connection-env 引用用户环境变量；psql 密码由用户自行输入；不得索取 POLYGRES_ACCESS_TOKEN。创建 Runtime 密钥前需警告密钥仅显示一次，建议由用户自行终端执行。TSV、JSON 数组、JSONL 数据集应使用 scripts/prepare_import.py 本地转换并人工复核后导入，不得静默扁平化嵌套 JSON 或改列名。退出码含义：2 校验、3 重新认证、4 缺权限、5 缺资源、6 冲突或项目不明确、7 限流、8 远端失败或超时、9 缺本地依赖。超时后先查已知资源或任务状态再重试。其他未提供细节暂未说明。