Farsight

在创业决策的关键时刻，快速获取准确、深度的市场洞察往往决定成败。然而，传统的人工调研耗时耗力，从搜索信息、阅读长文到整理对比，往往需要数小时甚至数天。

Farsight 是一款专为创业者设计的 AI 深度调研工具。只需输入一个问题，它便能自动执行 搜索 → 抓取 → 分析 → 报告 的全流程，在 60 秒内 交付一份结构严谨、数据详实、带内联引用的专业调研报告。

核心功能：从提问到洞察的极速闭环

Farsight 不仅仅是一个聊天机器人，它是一个完整的自动化调研流水线：

1. 深度调研自动化

• 智能分解：自动将复杂问题拆解为多个子任务。
• 多轮搜索：利用 Tavily 搜索引擎进行多轮迭代查询，确保覆盖全面。
• 全文抓取：内置自研高性能 HTTP 爬虫，深入网页提取正文，而非仅依赖摘要。
• 洞察生成：基于 LLM 对抓取内容进行深度分析，提炼关键洞察，生成结构化报告。

2. 智能竞品分析

• 意图识别：自动识别用户是否在进行竞品对比。
• 矩阵生成：一旦识别到竞品分析意图，立即自动生成结构化竞品对比矩阵，多维度横向评测。

3. 交互式上下文追问

• 三种模式：基于上一份报告，支持 精炼（聚焦核心）、扩展（挖掘细节）、全新（切换视角）三种追问模式。
• 持续深挖：让调研像对话一样自然深入，无需重复背景信息。

4. 可信溯源与分享

• 内联引用：报告中所有观点均标注 [n]，点击即可高亮并跳转至原始来源，确保信息可验证。
• 一键分享：生成只读分享链接 (/r/[id])，方便团队协作。
• Markdown 导出：一键下载完整报告（含竞品矩阵、来源列表），便于归档或二次编辑。

5. 本地持久化

• SQLite 存储：所有调研历史本地持久化，跨会话保留，构建专属知识库。

技术架构：高效、灵活、可控

Farsight 的核心是一个强大的 Skill 调度引擎，采用 collect → parse → analyze → output 的流水线设计：

• 并行处理：同阶段任务（如多页面抓取）并行执行。
• 串行流转：跨阶段数据有序传递。
• 模块化扩展：每个 Skill 是独立模块，添加新数据源只需新建一个文件，并在 SKILL_MAP 中注册即可。

高性能自研爬虫

为了速度与稳定性，Farsight 摒弃了沉重的 Playwright，采用纯 HTTP 方案：

• 反爬策略：4 个 User-Agent 轮换，降低被拦截概率。
• 超时保护：AbortController 严格控制每页 12 秒超时。
• 智能提取：首选 Readability 提取正文，失败则降级为 DOM 清洗。
• 并发容错：批量并发 3 个请求，使用 Promise.allSettled 确保部分失败不影响整体。
• SPA 兜底：对 JS 渲染页面，自动降级使用搜索 snippet 作为数据源。

双模型智能路由

支持 Claude 和 MiniMax 双模型，兼顾质量与成本：

• 自动路由：规划与合成任务自动调用 Claude（质量更高）；信息提取任务调用 MiniMax（成本更低）。
• 手动切换：可通过 LLM_PROVIDER 环境变量强制指定模型。

快速开始

环境要求

• Node.js 20+
• pnpm

本地开发

# 1. 克隆项目
git clone https://github.com/finvfamily/farsight
cd farsight

# 2. 安装依赖
pnpm install

# 3. 配置环境变量
cp .env.local.example .env.local
# 编辑 .env.local 填入 Tavily, MiniMax (及可选的 Claude) API Key

# 4. 启动开发服务器
pnpm dev

访问 http://localhost:3000 即可开始使用。

Docker 一键部署

# 1. 配置环境变量
cp .env.local.example .env.local

# 2. 启动容器
docker-compose up

核心环境变量

扩展性：添加自定义 Skill

Farsight 的设计哲学是“一切皆 Skill”。你可以轻松扩展其能力：

// lib/skills/my-skill.ts
import { buildContext } from '@/lib/engine/skill-runtime'

export default {
  async execute(
    inputs: Record<string, unknown>,
    ctx: ReturnType<typeof buildContext>
  ) {
    // 在此编写你的自定义逻辑
    // 例如：接入新的数据库、调用特定 API、执行特殊分析
    return { result: '...' }
  },
}

只需在 lib/engine/scheduler.ts 的 SKILL_MAP 中注册，Planner 即可自动调度该技能。