支持 · Pallas

安装指南

请使用 macOS、Node.js 22 及以上版本，以及 Codex 或 Claude Code。安装时需要联网。公开的 npm 安装器会复用受支持的 Python，或为项目准备独立的 Python。你无需 npm 账户，也无需另行获取 wheel 文件。

在终端运行：

npx pallas-ads install

按提示选择 Agent 和一个新建的空项目目录。安装器会准备本地运行时、项目连接、Skills 与示例数据，但不会替你授权广告账户。请勿将生成的项目与相邻的运行时目录分开移动。其他参数、诊断与更新方法见 npm 安装指南。原生插件指南介绍另一种安装路径；同一项目只使用其中一种。

配置 Agent

在安装时选择的 Agent 中打开对应项目目录，确认项目信任和本地工具权限，然后开始新任务。安装器已准备项目连接；媒体登录需要单独完成。如果 Pallas 工具没有加载，请将示例目录替换为实际项目路径，在终端运行：

npx pallas-ads doctor --directory /absolute/path/to/project

根据诊断结果处理后，再重试连接。

Codex

在 Codex 中打开已安装的项目并开始新任务，确认 Pallas 工具和 Skills 已加载。npm 安装器会为该项目创建 MCP 入口，不会让其他 Codex 项目自动获得 Pallas。

Claude Code

在 Claude Code 中打开已安装的项目。开始分析前，确认 Pallas 工具及 pallas-workflow、pallas-analysis Skills 已加载。

无需广告账户也可以运行示例

请 Agent 预览安装项目中的 samples/meta_campaign_daily.csv。先检查账户、日期、字段映射、币种与缺失数据，确认解释后再导入并生成报告。这是合成示例，不是真实账户结果。

了解 /pallas 的分析、看板、帮助与状态入口。

媒体授权

Google Ads：发布方配置的发行包包含 Desktop 应用身份，用户只需浏览器登录，无需导入配置文件。历史公开 core 构建不含该身份，需要发布方提供修正版本。Google 应用验证、API 项目准入与用户账户权限仍然适用，更充分的真实账户分析验收仍待完成。

Meta Ads：发布方配置的发行包在两端使用 Pallas 浏览器登录，由 Pallas HTTPS 页面将授权结果返回本机，无需本地证书或 /mcp 命令。此路径面向外部用户开放前仍需完成部署、平台准入和新用户验收。数据 adapter 仍待实现，登录本身不代表可生成报告。既有宿主连接继续独立保留。授权前请审阅平台同意页面与授权指南。

TikTok Ads：使用文档所述的官方 MCP 浏览器授权路径。账户及平台权限仍然适用。已有报表分析路径不代表所有实盘指标都完成对账。

授权前，请按平台与 Agent 对应的接入路径检查配置条件。

分析 CSV 或 XLSX 导出文件可跳过媒体授权。当前导入流程面向单一媒体、单账户、单币种的 campaign/day 粒度数据；导入前须预览并确认字段解释。

常见问题

支持哪些 Agent？

目前有文档依据的接入是 Codex 和 Claude Code；项目配置与媒体授权路径各有区别。图标不代表已接入 ChatGPT 对话网站。

Pallas 会调用大模型或自动优化投放吗？

不会。你的 Agent 负责推理和交互；Pallas 提供本地工具与报告，不修改广告。

授权失败怎么办？

检查 Agent、连接配置、应用准入与媒体账户权限，阅读错误信息和清理警告。重复重试不能解除平台准入限制。如需支持，请发送脱敏的错误描述，不要发送凭据。

能直接使用已有项目吗？

npm 安装器要求新建或空的专用目录，不会合并进已有代码项目。如果要将 npm 项目迁移到原生插件，请参考插件指南。

如何更新 npm 安装？

先关闭正在运行的 Pallas 任务并备份项目。将示例目录替换为实际项目路径，然后运行：

npx pallas-ads@latest update \
  --directory /absolute/path/to/project

更新会保留项目数据与配置；切换安装路径前请阅读 npm 安装指南。

如何撤销授权或删除数据？

请按数据删除页分别处理平台授权、本地或宿主凭据及报告副本。

联系支持

如需帮助，请给开发者发邮件。请说明操作系统、Agent、安装路径、媒体平台和简短的问题描述。示例中应移除 token、密码、账户标识和敏感广告数据。