# InsightReply 用户使用指南

> InsightReply 是一个帮助创始人和独立开发者在 X (Twitter) 行业热点中输出更有洞察力评论的 AI 助手。
> 它是**社交表达增强系统**，不是自动化机器人 —— 所有评论由你决定是否发布。

---

## 一、快速开始

### 1.1 安装扩展

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

> [!TIP]
> Edge 浏览器同样支持，操作路径为 `edge://extensions/`

### 1.2 首次设置 (Onboarding)

安装后首次点击扩展图标，会进入 **3 步引导**：

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

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

---

## 二、核心功能使用

### 2.1 生成评论（主流程）

```
打开 X (Twitter) → 浏览 Timeline → 找到想评论的推文
    ↓
点击推文操作栏旁的紫色 ✦ Insight 按钮
    ↓
右侧弹出 InsightReply 面板
    ↓
选择评论策略 → 点击「Generate High-Quality Reply」
    ↓
AI 返回多条备选评论 → 选择最满意的一条
    ↓
点击「Copy」→ 粘贴到推文评论框 → 发布
```

### 2.2 评论策略一览

系统内置 5 种策略，适用于不同场景：

| 策略 | 图标 | 适用场景 | 典型开头 |
|------|------|---------|---------|
| **认知升级型** | 🧠 | 对话题提出更深层的洞察 | "Most people miss this part..." |
| **反向观点型** | 🔥 | 提出不同角度，引发讨论 | "Unpopular opinion:" |
| **数据补充型** | 📊 | 用数据/案例补充论点 | "Data shows that..." |
| **共鸣支持型** | ❤️ | 表达认同并延伸讨论 | "This resonates deeply..." |
| **创始人经验型** | 🚀 | 以自身实战经验为论据 | "We faced this building our product..." |

> [!TIP]
> **选择策略的技巧**：
> - 大 V 发的行业观点 → 用「认知升级型」或「反向观点型」更容易获得关注
> - 有人吐槽痛点 → 用「创始人经验型」分享你的解决方案
> - 行业数据/报告 → 用「数据补充型」让你的评论更有说服力

### 2.3 识别高价值推文

InsightReply 会在推文旁显示提示标签，帮你快速判断：

| 标签 | 含义 | 建议 |
|------|------|------|
| 🔥 **Trending** | 高热度推文（Likes > 1000，发帖 < 2h） | 快速评论，争取高曝光 |
| ⚡ **Rising** | 增长中的推文（Likes > 100，发帖 < 1h） | 黄金窗口期，强烈建议评论 |
| 🎯 **High Relevance** | 与你的产品领域高度相关 | 最适合你评论的推文！ |

---

## 三、产品推广进阶

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

### 3.1 配置你的产品档案

在扩展设置中填写你的产品信息，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），或者你想使用列表中没有的最新模型（如刚刚发布的 `gpt-4.5-turbo`），可以直接在框内**手动打字输入任意模型名称**。

| 引擎 | 推荐模型 | 适用场景特点 |
|------|---------|-------------|
| **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 种策略，你可以创建专属策略：

**示例：创建「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.3 推广效果最大化小贴士

1. **优化你的 X Profile**
   - Bio 中明确写 "Building @YourProduct"
   - Pin 一条产品介绍/演示推文
   - InsightReply 让读者好奇 → 点击 Profile 后**必须能看到你的产品**

2. **评论时机很重要**
   - 推文发出后 **30 分钟内**评论，曝光是 2 小时后的 5-10 倍
   - 关注 🔥 Trending 和 ⚡ Rising 标签

3. **评论质量 > 数量**
   - 一条有深度的评论 > 十条"Great post!"
   - 用「反向观点型」或「数据补充型」更容易引发讨论 → 更多曝光

4. **不要硬推产品**
   - ❌ "Check out my product SwiftBiu!"
   - ✅ "We solved this by building a multi-language pipeline. The key insight was..."

---

## 四、评论历史与效果追踪

### 4.1 查看评论历史

点击扩展图标 → `History` Tab：
- 查看所有生成过的评论
- 按策略类型筛选
- 搜索关键词
- 查看复制/跳过状态

### 4.2 效果追踪

InsightReply 会自动追踪你发布的评论效果：
1. 你复制并发布了一条评论
2. 24 小时后，当你再次浏览 X 时，系统自动回查该评论的互动数据
3. 互动数据（Likes、Replies）会记录到你的个人面板

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

---

## 五、版本与定价

| 版本 | 价格 | 包含功能 |
|------|------|---------|
| **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: 如何修改已保存的设置？
点击扩展图标 → 齿轮图标 ⚙️ → 可修改身份标签、语言偏好、产品档案、自定义策略。

### Q: 竞品关键词如何工作？
在产品档案中添加竞品名称后，当 Timeline 中出现包含竞品关键词的推文，InsightReply 会在推文旁显示 🎯 标签，提示你这是一条高价值评论机会。

---

## 七、快捷键

| 快捷键 | 功能 |
|-------|------|
| `Alt + I` | 打开/关闭 InsightReply 面板 |
| `Alt + G` | 快速生成评论 |
| `Alt + C` | 复制选中的评论 |

---

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