# InsightReply 用户使用指南 💎

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

---

## 一、快速开始

### 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)

安装后首次点击扩展图标，会进入 **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,000（Likes×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 仓库](https://git.buildapp.eu.org/) 提交 Issue。
