Files
InsightReply/docs/USER_GUIDE.md
zs 8cf6cb944b
Some checks failed
Extension Build & Release / build (push) Failing after 1m5s
Backend Deploy (Go + Docker) / deploy (push) Failing after 1m40s
Web Console Deploy (Vue 3 + Vite) / deploy (push) Has been cancelled
feat: 部署初版测试
2026-03-02 21:25:21 +08:00

238 lines
9.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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。