Files
InsightReply/docs/USER_GUIDE.md
zs 1d17ac03e0
Some checks failed
Extension Build & Release / build (push) Failing after 56s
feat: 扩展优化重构
2026-03-03 02:19:14 +08:00

10 KiB
Raw Blame History

InsightReply 用户使用指南 💎

InsightReply 是一款专为独立开发者与数字游民设计的 AI 驱动 X (Twitter) 自动化营销套件。 它采用 Apple Pro Max 玻璃态美学macOS Settings 交互规范,为你提供丝滑、专业的社交增长体验。 所有评论由你决定是否发布 —— 我们是社交表达增强系统,不是自动化机器人。


一、快速开始

1.1 安装扩展

  1. Gitea Release 下载最新的 insight-reply-extension.zip
  2. 打开 Chrome → 地址栏输入 chrome://extensions/
  3. 开启右上角开发者模式
  4. 点击「加载已解压的扩展程序」→ 选择解压后的文件夹
  5. 扩展图标出现在工具栏中

Tip

Edge 浏览器同样支持,操作路径为 edge://extensions/

1.2 首次设置 (Onboarding)

安装后首次点击扩展图标,会进入 Pro Max 引导流程

步骤 设置内容 说明
Step 1 🧑‍💻 身份定义 AI 创始人 / SaaS Builder / 投资人 / 独立开发者 / 技术分析者
Step 2 🌐 语言智能 English / 中文 / 跟随原推文 (Auto)
Step 3 🎨 风格倾向 专业严谨 / 轻松幽默 / 犀利锐评

这些设置会影响 AI 生成评论的语气和风格,后续可随时在设置中修改。


二、核心功能Spatial Sidebar

2.1 沉浸式生成(主流程)

打开 X (Twitter) → 浏览 Timeline → 找到想评论的推文
    ↓
点击推文操作栏旁的紫色 ✦ Insight 按钮(或 Cmd+Shift+I 唤起面板)
    ↓
右侧滑出 Spatial Sidebar高斯模糊玻璃态设计
    ↓
选择评论策略 → 点击「Generate Pro Reply」
    ↓
AI 返回多条备选评论 → 选择最满意的一条
    ↓
点击「COPY」→ 粘贴到推文评论框 → 发布

2.2 顶级策略库

系统内置 5 种策略,适用于不同场景:

策略 深度目标 适用场景 典型 AI 开头
Cognitive Lift 🧠 认知升级 对话题提出更深层的洞察 "Most people miss this part..."
Witty & Fun 😄 幽默破冰 提出不同角度,引发讨论 "I can't be the only one who thinks..."
Pro Rigor 💼 专业严谨 用数据/案例补充论点 "Based on our engineering data..."
Empathetic ❤️ 情感共鸣 表达认同并延伸讨论 "This resonates deeply..."
Sharp Critique 🔥 犀利锐评 以自身实战经验为论据 "Unpopular opinion, but..."

Tip

选择策略的技巧

  • 大 V 发的行业观点 → 用「Cognitive Lift」或「Sharp Critique」更容易获得关注
  • 有人吐槽痛点 → 用「Empathetic」分享你的解决方案
  • 行业数据/报告 → 用「Pro Rigor」让你的评论更有说服力

2.3 识别高价值推文(智能标签)

InsightReply 会在推文旁自动显示提示标签,帮你快速判断互动价值:

标签 触发条件 建议
🔥 Trending 综合热度 > 50,000Likes×1 + Retweets×2 + Replies×3 流量巅峰,快速评论争取高曝光
Rising 综合热度 > 5,000 黄金窗口期,强烈建议评论
🎯 Relevant 推文内容匹配你在产品档案中设置的关键词 最适合你评论的推文!

Note

热度公式:heatScore = likes × 1 + retweets × 2 + replies × 3 关键词匹配基于你在 Dashboard → Product DNA 中配置的竞品名与相关关键词。


三、产品推广进阶

如果你是创始人/独立开发者,正在用 InsightReply 提升产品曝光,以下功能专为你设计。

3.1 配置你的产品档案 (Product DNA)

在 Dashboard 中填写你的产品信息AI 会自动从你的产品领域出发生成评论:

配置项 填什么 作用
产品名称 SwiftBiu 创始人策略中可能自然提及
所属领域 AI Video Creation AI 以此领域专家角度撰写
核心功能 例:视频生成, 多语言配音 让评论与产品技术相关
竞品列表 CapCut, Descript 竞品被讨论时收到 🎯 提醒
相关关键词 short video, AI dubbing Timeline 推文自动标注 🎯
自定义上下文 任意补充说明 原样注入 AI 的 Prompt

Important

InsightReply 不会自动发布评论或硬推你的产品。 产品档案的作用是让 AI 从你的领域视角出发写评论,引发读者好奇心 → 点击你的 Profile → 发现你的产品。

3.2 切换与自定义 AI 引擎 (多模型支持)

InsightReply 支持四大主流平台,并允许完全自定义模型

在产品档案的「重写 AI 引擎」设置中:

  1. 下拉选择:从系统预设的模型列表中快速切换(如 gpt-4o-mini, claude-3-5-haiku-latest)。
  2. 手动输入 (支持本地/代理):如果你使用兼容 OpenAI 的平台(如 Groq、vLLM、Ollama可以直接手动输入任意模型名称
引擎 推荐模型 适用场景特点
Anthropic claude-3-5-haiku-latest 默认推荐。语气最自然,不易产生"AI味"
OpenAI (或兼容接口) gpt-4o-mini 表现稳定,成本极低,适合大批量生成
DeepSeek deepseek-chat 逻辑分析强,中文语感极佳,价格优势明显
Google gemini-2.5-flash 速度快,多语言处理能力强

注:切换平台需要系统后台配置了相应的 API Key 或 Base URL。管理员可将 OpenAI Base URL 指向任意兼容代理,实现模型的无限扩展。

3.3 创建自定义策略

除了内置的 5 种策略,你可以在 Dashboard → Custom Logic 中创建专属策略:

示例创建「Builder Story」策略

策略名: 🚀 Builder Story
描述: 以自身产品经验为论据,自然关联到产品
Prompt 模板:
  "以 {identity} 的身份,结合你在 {domain} 领域开发 {product_name} 的经验,
   对这条推文写一条有价值的评论。
   评论应让读者感受到你是该领域的实践者,而非理论派。"
Few-shot 示例:
  - "We faced this exact problem building SwiftBiu. What worked..."

自定义策略的 Prompt 模板支持以下变量,运行时自动替换:

变量 说明
{tweet_content} 目标推文原文
{identity} 你的身份标签
{product_name} 你的产品名
{domain} 你的产品领域
{key_features} 产品核心功能
{competitors} 竞品列表
{language} 输出语言
{max_length} 最大字符数

3.4 推广效果最大化小贴士

  1. 优化你的 X Profile

    • Bio 中明确写 "Building @YourProduct"
    • Pin 一条产品介绍/演示推文
    • InsightReply 让读者好奇 → 点击 Profile 后必须能看到你的产品
  2. 评论时机很重要

    • 推文发出后 30 分钟内评论,曝光是 2 小时后的 5-10 倍
    • 关注 🔥 Trending 和 Rising 标签
  3. 评论质量 > 数量

    • 一条有深度的评论 > 十条"Great post!"
    • 用「Sharp Critique」或「Pro Rigor」更容易引发讨论 → 更多曝光
  4. 不要硬推产品

    • "Check out my product SwiftBiu!"
    • "We solved this by building a multi-language pipeline. The key insight was..."

四、Dashboard (macOS 风格)

InsightReply 的管理后台采用 macOS Settings 侧边栏布局,操作直观高效。

打开方式:点击扩展图标 → 点击「Launch Dashboard」按钮或直接使用快捷键。

4.1 评论历史

点击扩展图标 → History Tab

  • 查看所有生成过的评论
  • 按策略类型筛选
  • 搜索关键词
  • 查看复制/跳过状态

4.2 效果追踪 (24h Performance Feedback)

InsightReply 会自动追踪你发布的评论效果:

  1. 你复制并发布了一条评论
  2. 24 小时后系统自动回查该评论的互动数据Likes、Replies
  3. 互动数据会记录到你的个人面板

效果数据积累越多 → AI 越懂你的风格 → 生成质量越高 → 形成正向飞轮 🔄


五、快捷键 (Shortcuts)

功能 Mac 快捷键 Win 快捷键 状态
唤起/隐藏 Sidebar Cmd + Shift + I Ctrl + Shift + I 已实现
快速生成 Alt + G Alt + G 📋 规划中
一键复制 Alt + C Alt + C 📋 规划中

六、版本与定价

版本 价格 包含功能
Free $0 每日 10 次生成 · 3 个监控关键词 · 3 个监控账号 · 内置策略
Pro $29/月 无限生成 · 20 个关键词 · 20 个账号 · 自定义策略 · 热度雷达
Premium $59/月 Pro 全部功能 + 50 个关键词 · 效果分析看板 · 风格优化建议 · 个人品牌报告

七、常见问题 (FAQ)

Q: InsightReply 会自动发布评论吗?

不会。InsightReply 只生成评论建议,你决定是否复制和发布。我们是 AI 写作增强工具,不是自动化机器人。

Q: 支持哪些浏览器?

Chrome 和 Edge基于 Manifest V3。Firefox 支持规划中。

Q: AI 生成的评论会不会都一样?

不会。评论基于推文内容、你的身份标签、风格偏好和产品档案动态生成 —— 每次都是独特的。随着效果数据积累AI 会越来越像你自己的写作风格。

Q: 我的数据安全吗?

  • 产品档案和策略模板存储在我们的加密数据库中
  • 我们不会读取或存储你的 X 密码
  • 我们不会代替你操作你的 X 账号

Q: 如何修改已保存的设置?

点击扩展图标 → 「Launch Dashboard」→ 在 macOS 风格的侧边栏中选择对应模块修改。

Q: 竞品关键词如何工作?

在 Dashboard → Product DNA 中添加竞品名称后,当 Timeline 中出现包含竞品关键词的推文InsightReply 会在推文旁显示 🎯 标签,提示你这是一条高价值评论机会。

Q: 界面被推文遮挡怎么办?

我们已升级为 Shadow DOM 最高优先级渲染z-index: 2147483647面板将永远浮于页面最顶层。


反馈与建议:如果你有功能建议或遇到问题,欢迎在我们的 Gitea 仓库 提交 Issue。