NotFair —— 24/7 目标驱动营销代理
用自然语言设定业务目标，NotFair 自动验证指标、建立基线、并在你确认后 24/7 自动执行改进循环。
证据显示：README 描述了用户确认流程（计划在聊天中确认后才启动循环）、支出上限、观察窗口和暂停按钮，以及代码变更通过 PR 进行。但未提供实际代码或配置来验证这些机制是否真正实现。扣分原因：缺少代码级证据，权限最小化、数据流透明度和敏感数据处理（如 OAuth 令牌未加密）仅部分说明。
证据显示：README 和 CI 工作流（typecheck、test）表明项目有一定自洽性，但未提供测试结果或依赖锁定文件。扣分原因：依赖可用性未验证，失败消息仅部分提及（如 doctor 的 Fix 行）。
证据显示：README 描述了多种使用场景（SEO、付费广告、目标循环）和平台连接，但未提供详细的边界说明或环境适配细节。扣分原因：触发精度（如目标确认）和特定环境（如 Apple Silicon）的适配仅部分说明。
证据显示：README 提供了安装说明、CLI 参考、示例和许可证，但缺少版本历史、变更日志和已知限制的详细说明。扣分原因：命名稳定性（如 toprank 重命名）和版本控制信息不完整。
证据显示：README 展示了输出示例（如审计报告、目标屏幕），但未提供实际运行结果或成本效益分析。扣分原因：边际价值和成本效益仅基于描述，缺乏实证。
证据显示：README 中的声明（如服务器验证指标）未提供可追溯的测试或数据来源。扣分原因：缺乏跨来源验证和事实与推断的明确分离。
- OAuth 令牌未加密存储，存在本地泄露风险。
- 依赖未锁定版本，存在供应链风险。
- 发布者身份未验证，需谨慎评估。
这个 Agent 能做什么，适合哪些场景？
NotFair 是一个开源的本地运行应用，结合了目标驱动代理和营销技能插件。它将模糊的野心（如“90 天内有机点击增长 30%”）转化为可验证的指标，通过服务器端验证确立基线，然后运行纪律性的改进循环——测量、评估、做出一次新动作、记录预测并重复。应用界面每个目标一屏：左侧是对话，右侧显示实时图表、目标线和检查日志。NotFair 附带一个 Claude Code 插件，提供 SEO、Google Ads 和 Meta Ads 技能，供手动审计和活动管理。所有数据本地存储在 SQLite 中，代理在您的机器上运行，使用您现有的 Codex 或 Claude Code 登录，无需额外订阅。
运行 npx notfair@latest 启动本地服务器，在 http://127.0.0.1:3327 打开 UI。用户通过 OAuth 连接平台（Google Ads、Meta Ads、Search Console 等），然后在聊天中陈述目标。代理探索数据源，编写 SQL/GAQL 查询，通过服务端重跑验证指标，回填约 30 天历史，并提议目标、节奏和预算。用户确认后，循环开始：每个检查周期，平台机械测量指标，唤醒代理审查过去的动作，并记录最多一个新动作及其可反驳的预期效果。代理可以通过 GitHub 集成以 PR 形式修改代码。CLI 命令包括 doctor、start、status、stop、logs、update、autostart。
- 营销经理希望设定一个季度业务目标（如“将有机点击量提高 30%”），让代理持续监控并优化 SEO 工作。
- PPC 专家想将广告支出降到最低，需要代理监控浪费支出并建议可逆更改。
- 增长负责人连接 Stripe 和 Google Analytics，跟踪收入或 CPA 目标，并收到代理执行的进展。
- SEO 专业人员使用插件进行一次性审计，并查找 GSC 数据中的流量下降和快速修复。
- 开发者希望将代理的目标循环扩展到自定义指标，通过
local数据源运行 shell 命令。
这个 Agent 有哪些优点和局限？
- 行为纪律：代理仅基于服务器验证的指标奖励，记录可证伪的预测，并遵守观察窗口，防止虚假活动。
- 完全本地数据：所有状态存储在 ~/.notfair/db.sqlite 中，无需新订阅，无需托管运行时。
- 广泛集成：支持第一方 MCP 服务器（Google Ads、Meta Ads、Search Console），以及 PostHog、Mixpanel、Stripe、Supabase 和自定义 MCP 端点。
- 附带全面的技能库用于手动营销任务（SEO、广告审计），与自主代理循环互补。
- 平台特定：需要 Apple Silicon Mac 和 Node 20+；不支持 Windows/Linux。
- 运行时代理依赖：依赖您已订阅的 Codex CLI 或 Claude Code；不带自己的 LLM 密钥。
- OAuth 令牌未加密存储在 SQLite 中，需要本地账户安全性。
- 繁重代理循环的验证：在文档之外，长期运行的代理循环的可靠性证据有限。
如何安装或部署这个 Agent？
前置条件：Apple Silicon Mac，Node 20+，以及已安装并认证的 Codex CLI 或 Claude Code。运行 npx notfair@latest doctor 进行预检，然后运行 npx notfair@latest 启动 UI。或者全局安装：npm install -g notfair。对于插件，在 Claude Code 中：/plugin marketplace add nowork-studio/notfair 然后 /plugin install notfair@nowork-studio。
如何使用这个 Agent？
- 在浏览器 UI 中创建一个项目，选择 harness（Codex 或 Claude Code）。2. 在 Connections 页面连接一个或多个数据源（如 Google Search Console）——使用 PKCE OAuth 一键授权。3. 在聊天中陈述目标，例如“90 天内将有机点击量提高 30%”。代理将验证指标并提出计划；您确认后循环开始。4. 使用 CLI 命令管理应用：
notfair status、notfair stop、notfair logs。5. 对于手动任务，使用插件技能，如/notfair:seo-analysis或/notfair:google-ads。
常见问题
成本如何？
需要哪些权限？
如果代理犯错怎么办？
我可以添加自定义数据源吗？
local 数据源运行 shell 命令，或使用自定义 MCP URL——任何支持 HTTP 和 OAuth 的 MCP 服务器都可以。