Facebook Page

核心用法

facebook-page 是一个通用的 Facebook 专页管理技能，基于 Meta Graph API v25.0 实现。它采用动态 API 调用构造机制，无需预置脚本，根据用户自然语言意图实时生成对应的 API 请求。

主要功能覆盖：

• 内容发布：文本、图片、视频、链接帖子，支持定时发布（published=false + Unix 时间戳）
• 内容管理：删除帖子、发布草稿、获取近期帖子列表
• 互动管理：点赞、评论回复、隐藏/删除评论
• 收件箱与消息：读取私信对话
• 数据分析：专页洞察（粉丝数、曝光量）和单帖数据（触达、反应类型）
• 活动管理：创建和列出活动
• 资产管理：相册列表、视频上传

技术实现特点：

• 凭证存储于 ~/.config/fb-page/credentials.json，包含永久有效的 Page Token
• 支持一次性 Token 交换流程（短效 Token → 长效用户 Token → 永久专页 Token）
• 完整支持 GET/POST/DELETE 及 multipart 文件上传
• 内置权限缺失引导机制，精确告知用户需添加的权限及操作路径

显著优点：
1. 零脚本架构：完全根据用户意图动态构建 API 调用，无需维护预设命令集
2. 权限透明化：内置完整的权限映射表（pages_manage_posts、pages_read_engagement 等 8 项核心权限），错误时精确指导修复
3. 安全设计：强制文件权限限制（Windows ACL / Unix 600），明确禁止版本控制提交凭证
4. 全功能覆盖：从基础发帖到高级洞察分析，覆盖专页运营的完整生命周期

潜在缺点与局限性：

• Meta 平台依赖：受 Meta API 政策变更影响，权限审核流程可能延长
• Token 管理成本：永久 Token 虽便利，但一旦泄露风险较高，需定期轮换
• 速率限制：高频操作可能触发 368 错误（临时封禁），需实现重试逻辑
• 无沙箱环境：错误会直接作用于真实专页，测试需谨慎

适合人群：

• 社交媒体运营人员需批量管理多专页内容
• 营销团队需要自动化发布和数据追踪
• 开发者构建专页管理工具的原型验证
• 小型企业主自助管理品牌专页

常规风险：

• 凭证泄露：credentials.json 包含高权限永久 Token，文件权限配置不当可导致专页被恶意控制
• 权限过度申请：技能建议最小权限原则，但用户可能误授不必要的高级权限
• API 变更：Meta 频繁更新 API 版本和权限要求，需持续关注 v25.0 后续迁移
• 内容合规：自动化发布需遵守平台社区准则，批量操作可能触发垃圾信息检测

核心用法

facebook-page 是一个轻量级 PowerShell 技能，通过调用 Meta Graph API v25.0 实现对 Facebook 公共主页的全面管理。用户需先完成一次性凭证配置：在 ~/.config/fb-page/credentials.json 中存储永不过期的页面访问令牌（FB_PAGE_TOKEN）和主页 ID（FB_PAGE_ID）。技能支持动态构建 API 调用，无需预设脚本即可响应多样化需求，涵盖文本/图片/视频发帖、定时发布、评论审核、洞察数据分析、活动管理等 20+ 核心功能。

显著优点

1. 官方 API 直连：所有请求仅发送至 graph.facebook.com，使用 HTTPS/TLS 加密，无第三方中转或数据转发。
2. 动态意图解析：Agent 根据自然语言指令实时构建 API 调用，无需记忆固定命令格式，交互门槛低。
3. 安全设计规范：文档强制要求设置文件权限（chmod 600 / icacls），明确指导删除临时凭证（FB_APP_SECRET），遵循最小权限原则。
4. 零外部依赖：纯 PowerShell 实现，无第三方依赖包，供应链攻击面极小。
5. 详尽错误映射：内置错误代码解析表，可精准定位权限缺失、令牌过期等问题，并给出修复指引。

潜在缺点与局限性

1. 凭证本地存储风险：访问令牌以明文形式存储在本地 JSON 文件，虽指导设置权限，但仍不如系统密钥库（Windows Credential Manager / macOS Keychain）安全。
2. 缺乏隐私政策文档：未明确说明数据使用范围、存储期限及用户权利（GDPR/CCPA 合规性不足）。
3. 无自动令牌刷新：令牌过期需用户手动重新配置，缺少临期预警机制。
4. 输入验证有限：依赖 API 层返回错误，缺乏对 pageId 格式、消息长度、文件类型的前置校验。
5. Meta 平台依赖：受 Facebook 平台政策变动影响，API 权限或端点可能调整，需持续关注版本更新。

适合的目标群体

• 社交媒体运营人员：需批量管理主页内容、定时发布、监控互动数据。
• 小型企业主：自主管理品牌主页，无需购买复杂第三方工具。
• 开发者与自动化工程师：作为 Meta API 的轻量级封装，集成至现有工作流。
• 内容创作者：快速发布多媒体内容、管理粉丝评论与私信。

使用风险

1. 性能风险：大型多媒体文件上传依赖本地内存流构建，大视频文件可能导致内存占用激增。
2. API 限流：Facebook Graph API 存在调用频次限制，高频操作可能触发临时封禁（错误代码 368）。
3. 凭证泄露：本地文件若备份至云盘或提交至版本控制，可能导致长期有效的访问令牌泄露。
4. 权限漂移：Meta 平台权限模型变更可能导致现有令牌失效，需重新授权。
5. 网络依赖：完全依赖 Meta 服务可用性，区域性网络故障或 API 维护期间功能中断。