Fuyao MarketMate
Duet 用户手册
1. 产品简介
Fuyao MarketMate — Duet 是装在 Codex 里的 Duet App KOL 营销助手。
它帮你两件事：
- 选人（F1）：这个短视频达人，值不值得和 Duet 试合作？
- 改创意（F2）：已经要合作了，brief / 脚本 / 钩子 / CTA 怎么改更合适？
备注：F1 = Feature 1。
你可以把它想成：懂 Duet KOL 投放规则的同事坐在你旁边，而不是一个什么都能聊、但也什么都泛泛而谈的通用聊天机器人。
2. 产品功能
| 能力 | 你怎么问 | 它大致会给你什么 |
|---|---|---|
| F1 人选评估 | 「这个 TikTok 账号值不值得合作？」 | 合作结论、硬门槛（Gate）、Duet 适配、风险、下一步建议 |
| F1 合作方向 | 「直接给这个博主的三个合作创意方向」 | 三个高层合作方向（不做完整指标评估时） |
| F2 创意顾问 | 「这段脚本 / brief 怎么改更适合 Duet？」 | 诊断问题、改法路线、可继续迭代的改写 |
| 产品反馈 | 消息以 反馈给admin / report to admin 等固定开头 | 把反馈提交给管理员（不是业务分析） |
安装后你通常会看到三个入口（Skills）：
- KOL Candidate Evaluation —— 选人
- KOL Content Advisor —— 改创意
- Feedback —— 向管理员反馈产品问题（需用指定口令）
使用建议：不建议绕过 Plugin 直接调用单个 Skill。建议在请求中显式写明「使用 Fuyao MarketMate — Duet Plugin」，由 Plugin 根据任务意图路由到对应的 Skills。
3. 产品使用方法
准备
- 你有可用的 Codex 环境。
- 管理员已邀请你的 Google 账号，并开通了使用权限。
- 安装 Plugin：Fuyao MarketMate — Duet（技术包名
fuyao-duet）。 - 第一次做正式分析时，按提示完成 Authenticate / Google 登录（一般只需做一次）。
你不需要自己配 API Key、后端地址或复杂终端命令——这些由 Plugin 和权限系统处理。
选人（F1）怎么开口
直接把达人信息丢进对话，例如：
- 「帮我评估这个账号值不值得和 Duet 合作：
https://www.tiktok.com/@xxx，报价 $xxx」 - 「只有一条视频链接，但我想知道这个达人整号值不值得测」
尽量附上你已有的公开证据（粉丝、播放、受众、报价截图等）。流程会：
- 启动受保护的评估任务（拿品牌原则 + 规则版本）
- 补齐必要公开证据（含需要时的检索）
- 服务端算出硬指标 / Gate
- 据此写成一份可读报告
改创意（F2）怎么开口
在已有人选或明确要做 Duet 合作内容时，例如：
- 「这是合作 brief / 脚本，按 Duet 帮我诊断并给改写路线」
- 「Hook 太弱，帮我改两版不同路线」
需要有可讨论的内容：脚本、字幕、摘要、关键帧，或已看过的内容描述。只丢一个普通视频链接、又不说明要改成 Duet 合作创意时，通常不够启动 F2。
反馈产品问题（口令入口）
产品 bug、使用建议请走固定口令，完整说明见下一章「如何反馈产品 Bug 和产品建议」。「评估结论不对、想重跑」仍在 F1/F2 里改，不必走反馈。
4. 如何反馈产品 Bug 和产品建议
封闭 Beta 期间，请用固定开头口令提交产品反馈。系统只认这些入口，不认「帮我反馈一下」「有个建议」「结果不对」这类自然语言。
固定反馈入口（请整句照抄开头）
中文（区分大小写，必须一字不差）：
| 口令 | 示例 |
|---|---|
反馈给admin | 反馈给admin 登录后一直转圈 |
反馈给管理员 | 反馈给管理员 F1 报告里 Gate 名称看不懂 |
反馈给Jack | 反馈给Jack 希望支持批量评估多个账号 |
英文（不区分大小写，但单词必须是这两句之一）：
| 口令 | 示例 |
|---|---|
report to admin | report to admin OAuth keeps spinning |
report to jack | Report to Jack please add Instagram quote tips |
口令后面可以空格、换行或标点，冒号可有可无。
怎么发才算成功
- 新开一条用户消息，开头就是上面某一句口令。
- 口令后面写清楚：出了什么问题 / 你期望怎样 / 有什么产品建议。
- 助手会先给你看一版反馈预览；确认无误后回复
确认提交。 - 不要在反馈里贴密码、Cookie、token、完整脚本、达人私密链接等敏感信息。
什么时候不该走反馈
| 你的情况 | 正确做法 |
|---|---|
| 觉得这次人选结论或脚本改写不对 | 继续在 F1 / F2 对话里纠正证据、要求重跑或修改 |
| 想随便聊聊产品想法，但还没决定提交 | 可以讨论，但没有口令就不会写入管理员后台 |
| 只在旧消息里提过「反馈」，当前消息没有口令 | 不会触发提交；请用口令重新发一条 |
提交后会发生什么
反馈会绑定你当时已登录的账号，进入管理员后台，供 Jack / admin 查看。你通常不需要再留联系方式；若需要补充，管理员会另循既有渠道联系你。
5. 和「自己直接问 LLM」有什么区别
很多人第一反应是：「我直接把账号丢给 ChatGPT / Codex 不行吗？」
可以聊，但两者不是一类东西：
| 维度 | 自己随便问通用 LLM | 使用本 Plugin |
|---|---|---|
| 懂不懂 Duet | 靠模型常识 + 你临时粘贴的说明，容易空泛或过时 | 下发当前维护的 Brand Core 与 F1/F2 任务规则 |
| 门槛稳不稳 | 同一组数据，不同对话可能结论漂 | F1 硬指标 / Gate 走服务端确定性计算 |
| 流程完不完整 | 你自己记得问粉丝、受众、报价、风险…… | Skill 按固定工作流催证据、出结构、给下一步 |
| 版本能不能回溯 | 基本没有「这次用的是哪版规则」 | 任务带 knowledge / policy 版本信息 |
| 权限与审计 | 无产品级邀请 / 停用 / 到期 | Google 身份 + 产品 entitlement |
| 会不会越界乱答 | 很容易帮你「点评任意视频」「做投放复盘」 | 明确拒绝不属于能力的请求 |
6. 产品边界（什么不要找它）
诚实边界是信任的一部分。下面这些不属于本 Plugin：
| 你想做的事 | 正确预期 |
|---|---|
| 评价一条普通、非 Duet 视频「本身拍得好不好」 | 不做。会明确告知不属于 Plugin 能力 |
| 评估已发布 Duet 合作视频的表现 / 写复盘报告 | 不做。需要找 Jack 使用扶摇工作台（Fuyao Workbench） |
| 飞书、评论采集、DOCX 报告、视频处理流水线 | 不做（那是 Owner 本机 Workbench 能力） |
| 当通用营销顾问 / 任意品牌投放顾问 | 不做。当前版本只服务 Duet 这一个品牌场景 |
| 不登录、不鉴权就当离线本地秘籍永久使用 | 不行。正式 F1/F2 必须走受保护 MCP 启动 |
适合找它的时刻
- 合作前：这个人值不值得测、报价虚不虚、和 Duet 合不合
- 合作中（发布前）：brief / 脚本 / Hook / CTA 怎么改更贴 Duet
不适合找它的时刻
- 视频拍完上线后的效果复盘
- 和 Duet 无关的「帮我看看这个视频」
- 需要采集器、飞书、成套复盘报告的内部工作台场景
7. FAQ
1. 会不会把我的脚本都存到你们服务器？
产品设计默认：不把完整合作脚本、对话内容当业务库持久化；后端侧重权限、版本、最小审计与 F1 确定性计算。具体以当前隐私与部署说明为准。
2. 装了会不会变成另一个 ChatGPT？
不会。它是 Duet KOL 营销插件，能力窄、标准深；越界的问题它应该拒绝，而不是硬答。
3. 为什么要做这个产品，能给我带来什么好处？
Fuyao 把 Duet KOL 合作中最容易反复确认的两件事整理成固定流程：合作前判断人选是否值得测试，发布前检查创意是否适合 Duet。
4. 每次调用都需要显式调用 Plugin 吗？
不需要手动寻找或直接调用单个 Skill。建议在请求中显式写明“使用 Fuyao MarketMate — Duet Plugin”，由 Plugin 根据任务意图路由。
5. 觉得回答的偏差很大，怎么办？
不要直接采用结果。在同一个任务里指出具体偏差，补充达人链接、报价、受众信息、后台截图、brief 或品牌限制，并要求重新回答。
6. 回复说“正式分析暂时不可用”，应该怎么办？
先确认 Plugin 已启用、使用的是获邀 Google 账号，然后刷新 Plugin 或新建 Codex 任务再试；如果仍然出现，再提交产品反馈。
7. 怎么辨别本地 Codex 成功安装了这个 Plugin，且能正常工作？
先在 Plugins → Installed 中确认 Plugin 已启用并能看到三个 Skills。再在新任务里发起一次有效 F1 或 F2 请求，完成鉴权并返回正式结果。
8. 遇到新功能建议或者 Bug，应该如何反馈？
新开一条消息，用固定反馈口令开头，说明发生了什么、预期结果和能否复现。不要放入密码、API Key、Cookie、Token 或个人敏感信息。
9. 给的 KOL 创意方向我觉得不靠谱，应该听谁的？
最终应听负责结果的人，并以品牌目标、达人真实风格、平台事实和可验证证据为准。Fuyao 是决策辅助，不是最终裁决者。
10. Plugin 如果更新了，我应该做什么操作？
更新后先刷新 MCP，并新建 Codex 任务再使用；如果仍显示旧版本，再重启 Codex，并重新确认 Plugin 与三个 Skills 已启用。
11. 什么时候需要登录 Google 账号鉴权？
第一次调用受保护的正式能力时需要登录；请使用管理员邀请的 Google 账号。会话失效、权限撤销或更换账号时也可能再次要求鉴权。
12. 重启电脑、浏览器或 Codex，需要重新鉴权吗？
通常不需要。会话过期、主动退出、清除应用数据、撤销授权、切换 Google 账号或连接被重置时，才可能需要重新登录。
13. 使用 Fuyao 和直接问 ChatGPT 或 Codex，有什么区别？
Fuyao 使用当前维护的 Duet 品牌原则和固定工作流，F1 硬指标由服务端确定性计算，并保留规则版本，结果更容易比较和回溯。
14. 做 F1 人选评估时，最好提供哪些信息？
至少提供达人账号或公开视频链接，并尽量补充报价、粉丝量、播放表现、受众地区或年龄、后台截图和其他公开证据。
15. 只有一条视频链接，也能判断这个达人整号值不值得合作吗？
可以作为入口，但要明确评估账号整体。关键指标仍缺失时，结论会保持为需要补充信息。
16. 只想先看三个合作方向，可以不做完整 F1 评估吗？
可以。这是高层方向探索，不等同于完整人选评估，也不会替代硬指标、Gate、报价和受众判断。
17. 做 F2 创意建议时，需要提供什么？
提供合作 brief、脚本、字幕、内容摘要、关键帧或已经看过的内容描述，并说明人选、发布目标和重点优化部分。
18. 只发一个普通视频链接，为什么没有启动 F2？
F2 服务 Duet 合作内容的发布前优化。请补充合作意图、brief、脚本或希望优化的具体部分。
19. 哪些事情不属于这个 Plugin？
它不负责普通视频点评、其他品牌通用咨询、评论采集、飞书流程、视频处理或成套复盘报告。
20. Duet 合作视频已经发布了，还能用它做效果复盘吗？
当前 Plugin 不负责发布后的表现复盘。需要复盘时应使用 Fuyao Workbench，或联系 Jack 走内部流程。
21. 使用前需要自己配置 API Key、后端地址或终端命令吗？
不需要。用户侧通常只需安装 Plugin、使用获邀 Google 账号完成鉴权，然后用自然语言提出 F1 或 F2 请求。
22. 我的完整脚本和对话会被保存到产品后台吗？
后台不会把完整合作脚本和整段对话作为业务资料库长期保存，主要处理权限、规则版本、最小必要审计和 F1 确定性计算。
23. 回答问题的模型是谁提供的？
推理使用你自己的 Codex。Fuyao 提供 Duet 专用 Skills、受保护权限连接、品牌原则、规则版本和必要的确定性计算。
24. 确认提交产品反馈后，会发生什么？
反馈会绑定当前已登录账号，并进入管理员后台供 Jack 或 admin 查看。