250 lines
10 KiB
Markdown
250 lines
10 KiB
Markdown
# 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。
|