Gemini Deep Research

通过 gemini-deep-research MCP 扩展执行完整的深度研究工作流，支持后台轮询和自动报告保存。该工作流是非阻塞的——代理设置任务后立即退出，由后台脚本处理轮询。

前置条件

请参阅 references/setup-guide.md。如果缺少任何前置条件，请告知用户并停止操作。

脚本

/scripts/ 目录下的三个脚本：

所有脚本都在任务的临时目录中读写 task.json。

工作流

步骤 1 — 启动前确认（一条消息，所有参数）

使用用户当前会话语言书写。

请确认 Deep Research 参数：

① 研究主题：[用户描述]
（将原样发给 Gemini，请确保表述清晰具体）

② 报告格式：
- Comprehensive Research Report（推荐，最全面）
- Executive Brief（精简版，1-2页）
- Technical Deep Dive（技术深度分析）

③ 保存位置：~/ObsidianVault/Default/DeepResearch/
（默认文件名：YYYYMMDD-.md，可自定义路径）

④ 轮询最大时长：40 分钟（5 分钟 × 8 次），超时后通知您手动处理

直接回复修改项，或确认以默认参数启动。

步骤 2 — 创建任务临时目录

bash
mkdir -p /tmp/gemini-deep-research/_/

写入 task.json：

json
{
input: 研究主题,
format: Comprehensive Research Report,
outputPath: /home/node/ObsidianVault/Default/DeepResearch/-.md,
pollIntervalSeconds: 300,
maxPolls: 8,
createdAt:
}

步骤 3 — 启动研究

bash
node /scripts/start-research.js /tmp/gemini-deep-research//

解析标准输出的 JSON，获取 { status: started, researchId: v1_... }。如果 status: error，告知用户并中止。

步骤 4 — 编写后台轮询脚本

写入 /poll.sh：

bash
#!/bin/bash
set -euo pipefail
cd $(dirname $0)

SKILL_DIR=/scripts
TASK_DIR=$(pwd)

log() { echo [$(date +%Y-%m-%d %H:%M:%S)] $* >> poll.log; }

log 开始轮询研究...
node $SKILLDIR/poll-research.js $TASKDIR >> poll-out.log 2>&1
RESULT=$(cat <<< $(node $SKILLDIR/poll-research.js $TASKDIR))

STATUS=$(echo $RESULT | node -pe JSON.parse(require(fs).readFileSync(/dev/stdin,utf8)).status)
log 轮询结果：$STATUS

if [[ $STATUS == completed ]]; then
log 研究完成。正在保存报告...
node $SKILLDIR/save-report.js $TASKDIR >> save-out.log 2>&1
SAVESTATUS=$(node -pe JSON.parse(require(fs).readFileSync(/dev/stdin,utf8)).status <<< $(node $SKILLDIR/save-report.js $TASK_DIR))
log 保存结果：$SAVE_STATUS
echo $SAVE_STATUS
elif [[ $STATUS == timeout ]]; then
echo timeout
else
echo failed
fi

步骤 5 — 启动后台进程

bash
cd /tmp/gemini-deep-research//
nohup bash poll.sh > /dev/null 2>&1 &
echo 后台进程 PID：$!

步骤 6 — 通知用户

🔬 Deep Research 已启动\n\n主题：[topic]\n格式：[format]\n预计完成：2–15 分钟（视主题复杂度而定）\n\n轮询后台运行，完成后我会通知您。如超时（40 分钟）未完成，我会告知并提供手动检查方法。

步骤 7 — 完成

当用户询问完成了吗？或通过新会话通知时：

bash

检查 done.flag 或 task.json 状态