feat: 扩展优化重构

2026-03-03 02:19:14 +08:00
parent c686d81d30
commit 1d17ac03e0
15 changed files with 904 additions and 692 deletions
--- a/docs/USER_GUIDE.md
+++ b/docs/USER_GUIDE.md
@@ -1,7 +1,8 @@
-# InsightReply 用户使用指南
+# InsightReply 用户使用指南 💎

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

 ---

@@ -20,63 +21,67 @@

 ### 1.2 首次设置 (Onboarding)

-安装后首次点击扩展图标，会进入 **3 步引导**：
+安装后首次点击扩展图标，会进入 **Pro Max 引导流程**：

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

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

 ---

-## 二、核心功能使用
+## 二、核心功能：Spatial Sidebar

-### 2.1 生成评论（主流程）
+### 2.1 沉浸式生成（主流程）

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

-### 2.2 评论策略一览
+### 2.2 顶级策略库

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

-| 策略 | 图标 | 适用场景 | 典型开头 |
-|------|------|---------|---------|
-| **认知升级型** | 🧠 | 对话题提出更深层的洞察 | "Most people miss this part..." |
-| **反向观点型** | 🔥 | 提出不同角度，引发讨论 | "Unpopular opinion:" |
-| **数据补充型** | 📊 | 用数据/案例补充论点 | "Data shows that..." |
-| **共鸣支持型** | ❤️ | 表达认同并延伸讨论 | "This resonates deeply..." |
-| **创始人经验型** | 🚀 | 以自身实战经验为论据 | "We faced this building our product..." |
+| 策略 | 深度目标 | 适用场景 | 典型 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 发的行业观点 → 用「认知升级型」或「反向观点型」更容易获得关注
-> - 有人吐槽痛点 → 用「创始人经验型」分享你的解决方案
-> - 行业数据/报告 → 用「数据补充型」让你的评论更有说服力
+> - 大 V 发的行业观点 → 用「Cognitive Lift」或「Sharp Critique」更容易获得关注
+> - 有人吐槽痛点 → 用「Empathetic」分享你的解决方案
+> - 行业数据/报告 → 用「Pro Rigor」让你的评论更有说服力

-### 2.3 识别高价值推文
+### 2.3 识别高价值推文（智能标签）

-InsightReply 会在推文旁显示提示标签，帮你快速判断：
+InsightReply 会在推文旁自动显示提示标签，帮你快速判断互动价值：

-| 标签 | 含义 | 建议 |
-|------|------|------|
-| 🔥 **Trending** | 高热度推文（Likes > 1000，发帖 < 2h） | 快速评论，争取高曝光 |
-| ⚡ **Rising** | 增长中的推文（Likes > 100，发帖 < 1h） | 黄金窗口期，强烈建议评论 |
-| 🎯 **High Relevance** | 与你的产品领域高度相关 | 最适合你评论的推文！ |
+| 标签 | 触发条件 | 建议 |
+|------|---------|------|
+| 🔥 **Trending** | 综合热度 > 50,000（Likes×1 + Retweets×2 + Replies×3） | 流量巅峰，快速评论争取高曝光 |
+| ⚡ **Rising** | 综合热度 > 5,000 | 黄金窗口期，强烈建议评论 |
+| 🎯 **Relevant** | 推文内容匹配你在产品档案中设置的关键词 | **最适合你评论的推文！** |
+
+> [!NOTE]
+> 热度公式：`heatScore = likes × 1 + retweets × 2 + replies × 3`
+> 关键词匹配基于你在 Dashboard → Product DNA 中配置的竞品名与相关关键词。

 ---

@@ -84,9 +89,9 @@ InsightReply 会在推文旁显示提示标签，帮你快速判断：

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

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

-在扩展设置中填写你的产品信息，AI 会自动从你的产品领域出发生成评论：
+在 Dashboard 中填写你的产品信息，AI 会自动从你的产品领域出发生成评论：

 | 配置项 | 填什么 | 作用 |
 |-------|-------|------|
@@ -103,24 +108,24 @@ InsightReply 会在推文旁显示提示标签，帮你快速判断：

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

-为了满足成本、速度、质量等不同维度的需求，InsightReply 支持四大主流平台，并允许**完全自定义模型**。
+InsightReply 支持四大主流平台，并允许**完全自定义模型**。

 在产品档案的「重写 AI 引擎」设置中：
-1. **下拉选择**：你可以从系统管理员预设的模型列表中快速选择（如 `gpt-4o-mini`, `claude-3-5-haiku-latest`）。
-2. **手动输入 (支持本地/代理)**：如果你使用的平台兼容 OpenAI（如 Groq、vLLM、Ollama），或者你想使用列表中没有的最新模型（如刚刚发布的 `gpt-4.5-turbo`），可以直接在框内**手动打字输入任意模型名称**。
+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` | 速度快，多语言处理能力强。 |
+| **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 种策略，你可以创建专属策略：
+除了内置的 5 种策略，你可以在 Dashboard → Custom Logic 中创建专属策略：

 **示例：创建「Builder Story」策略**

@@ -148,7 +153,7 @@ Few-shot 示例:
 | `{language}` | 输出语言 |
 | `{max_length}` | 最大字符数 |

-### 3.3 推广效果最大化小贴士
+### 3.4 推广效果最大化小贴士

 1. **优化你的 X Profile**
   - Bio 中明确写 "Building @YourProduct"
@@ -161,7 +166,7 @@ Few-shot 示例:

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

 4. **不要硬推产品**
   - ❌ "Check out my product SwiftBiu!"
@@ -169,9 +174,13 @@ Few-shot 示例:

 ---

-## 四、评论历史与效果追踪
+## 四、Dashboard (macOS 风格)

-### 4.1 查看评论历史
+InsightReply 的管理后台采用 **macOS Settings 侧边栏布局**，操作直观高效。
+
+打开方式：点击扩展图标 → 点击「Launch Dashboard」按钮，或直接使用快捷键。
+
+### 4.1 评论历史

 点击扩展图标 → `History` Tab：
 - 查看所有生成过的评论
@@ -179,18 +188,28 @@ Few-shot 示例:
 - 搜索关键词
 - 查看复制/跳过状态

-### 4.2 效果追踪
+### 4.2 效果追踪 (24h Performance Feedback)

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

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

 ---

-## 五、版本与定价
+## 五、快捷键 (Shortcuts)
+
+| 功能 | Mac 快捷键 | Win 快捷键 | 状态 |
+|------|------|------|------|
+| **唤起/隐藏 Sidebar** | `Cmd + Shift + I` | `Ctrl + Shift + I` | ✅ 已实现 |
+| **快速生成** | `Alt + G` | `Alt + G` | 📋 规划中 |
+| **一键复制** | `Alt + C` | `Alt + C` | 📋 规划中 |
+
+---
+
+## 六、版本与定价

 | 版本 | 价格 | 包含功能 |
 |------|------|---------|
@@ -200,7 +219,7 @@ InsightReply 会自动追踪你发布的评论效果：

 ---

-## 六、常见问题 (FAQ)
+## 七、常见问题 (FAQ)

 ### Q: InsightReply 会自动发布评论吗？
 **不会**。InsightReply 只生成评论建议，你决定是否复制和发布。我们是 AI 写作增强工具，不是自动化机器人。
@@ -217,21 +236,14 @@ Chrome 和 Edge（基于 Manifest V3）。Firefox 支持规划中。
 - 我们不会代替你操作你的 X 账号

 ### Q: 如何修改已保存的设置？
-点击扩展图标 → 齿轮图标 ⚙️ → 可修改身份标签、语言偏好、产品档案、自定义策略。
+点击扩展图标 → 「Launch Dashboard」→ 在 macOS 风格的侧边栏中选择对应模块修改。

 ### Q: 竞品关键词如何工作？
-在产品档案中添加竞品名称后，当 Timeline 中出现包含竞品关键词的推文，InsightReply 会在推文旁显示 🎯 标签，提示你这是一条高价值评论机会。
+在 Dashboard → Product DNA 中添加竞品名称后，当 Timeline 中出现包含竞品关键词的推文，InsightReply 会在推文旁显示 🎯 标签，提示你这是一条高价值评论机会。
+
+### Q: 界面被推文遮挡怎么办？
+我们已升级为 **Shadow DOM 最高优先级渲染**（z-index: 2147483647），面板将永远浮于页面最顶层。

 ---

-## 七、快捷键
-
-| 快捷键 | 功能 |
-|-------|------|
-| `Alt + I` | 打开/关闭 InsightReply 面板 |
-| `Alt + G` | 快速生成评论 |
-| `Alt + C` | 复制选中的评论 |
-
---
-
-> **反馈与建议**：如果你有功能建议或遇到问题，欢迎在我们的 Gitea 仓库提交 Issue。
+> **反馈与建议**：如果你有功能建议或遇到问题，欢迎在我们的 [Gitea 仓库](https://git.buildapp.eu.org/) 提交 Issue。