Skill: zhushanwei/desearch (version 1.0.12)

--- name: ZeeLin Deep Research 深度研究 description: "ZeeLin Deep Research 深度研究是一款 AI 驱动的专业研究辅助平台，支持一句话生成与多步骤生成，提供深度、专家两大研究路径。从快速信息梳理、系统分析到超万字专家报告全流程覆盖，依托多轮推理与多源数据整合，高效完成企业分析、市场洞察、招商研究等复杂任务，一站式提升研究效率与决策质量。" metadata: { "openclaw": { "emoji": "🔍", "requires": { "bins": ["curl"] } } } --- # ZeeLin Deep Research 深度研究 > ZeeLin Deep Research 深度研究是一款 AI 驱动的专业研究辅助平台，支持一句话生成与多步骤生成，提供深度、专家两大研究路径。从快速信息梳理、系统分析到超万字专家报告全流程覆盖，依托多轮推理与多源数据整合，高效完成企业分析、市场洞察、招商研究等复杂任务，一站式提升研究效率与决策质量。 ## 没有 API Key 怎么办？ 如果用户没有提供 api_key，提示用户前往 https://desearch.zeelin.cn/skill-activity 进行免费注册或登录，获取点数及 api_key ## API 基础信息 - **Base URL**: `https://desearch.zeelin.cn` - **认证方式**: Header `x-api-key` - **接口**: `POST /api/conversation/anew` ## thinking 参数 - `deep` - 深度思考模式 - 需要全面分析但不需要万字报告 - `major` - 专家模式 - 需要深度系统性输出、万字报告 ### 模式选择指南 **使用深度模式 (deep) 的场景**： - 概念解释/知识梳理 — "什么是 XXX"、"XXX 的原理是什么" - 事件/趋势分析 — 某个热点事件的来龙去脉、发展趋势 - 信息聚合 — 围绕某个话题汇总多方信息和观点 - 快速调研 — 用户没有明确要求深度报告的一般性研究问题 **使用专家模式 (major) 的场景**： - 行业/市场分析 — 涉及特定行业的全景分析、市场格局、竞争态势 - 企业/公司研究 — 某个企业的财务分析、战略评估、业务拆解 - 政策/法规研究 — 需要系统梳理政策影响、合规要求 - 技术/产品深度对比 — 多维度的技术路线对比、产品竞品分析 - 投资/商业决策 — 需要数据支撑的投资分析、可行性评估 **如果不确定使用哪种模式**：可以询问用户确认 ## 使用示例 ### 深度思考模式 ```bash [REDACTED_SECRET]" curl -s -X POST "https://desearch.zeelin.cn/api/conversation/anew" \ -H "Content-Type: application/json" \ -H "x-[REDACTED_SECRET]" \ -d '{ "sessionId": "", "content": "你的问题", "thinking": "deep", "workflow": "", "needEditChapter": 0, "moreSettings": {} }' ``` ### 专家模式 ```bash [REDACTED_SECRET]" curl -s -X POST "https://desearch.zeelin.cn/api/conversation/anew" \ -H "Content-Type: application/json" \ -H "x-[REDACTED_SECRET]" \ -d '{ "sessionId": "", "content": "你的问题", "thinking": "major", "workflow": "", "needEditChapter": 0, "moreSettings": {} }' ``` ## 多轮对话 第一轮返回的 `sessionId` 可以用于后续对话： ```bash [REDACTED_SECRET]" curl -s -X POST "https://desearch.zeelin.cn/api/conversation/anew" \ -H "Content-Type: application/json" \ -H "x-[REDACTED_SECRET]" \ -d '{ "sessionId": "上一轮的sessionId", "content": "追问内容", "thinking": "deep", "workflow": "", "moreSettings": {} }' ``` ## 快速调用 用户 API key 从环境变量 `DESEARCH_API_KEY` 读取。 **设置方式：** ```bash export DESEARCH_API_KEY="你的API Key" ``` ### 深度模式调用示例 ```bash [REDACTED_SECRET]" curl -s -X POST "https://desearch.zeelin.cn/api/conversation/anew" \ -H "Content-Type: application/json" \ -H "x-[REDACTED_SECRET]" \ -d '{ "sessionId": "", "content": "调研一下汽车产业规模", "thinking": "deep", "workflow": "", "moreSettings": {} }' ``` ## 注意事项 - `sessionId` 为空时创建新对话 - `thinking` 参数决定推理深度 - API 返回 JSON，包含回答内容 --- ## 查询任务状态 任务提交后，需要轮询查询状态： ```bash [REDACTED_SECRET]" curl -s -X GET "https://desearch.zeelin.cn/api/conversation/status?sessionId={sessionId}" \ -H "x-[REDACTED_SECRET]" ``` **返回示例:** ```json { "code": 200, "v": "v1.5.0", "msg": "成功", "data": { "status": 2, "thinking": "deep", "workflow": "", "message": "会话已生成", "content": "调研一下汽车产业规模", "time": "", "thinkingWorkflowName": "深度模式", "pptUrl": "", "wavUrl": "", "mdxUrl": "", "mdUrl": "", "htmlUrl": "", "wavScriptUrl": "", "isShare": 0, "isMine": 0, "title": "调研一下汽车产业规模", "short": "jVICQSS5", "questionId": 281697, "sessionId": [REDACTED_SECRET], "useKnowledge": 0, "onlyKnowledge": 0, "searchRange": "web" } } ``` **状态码说明:** - `1` = 进行中 - `2` = 正常结束 ✅ - `3` = 用户主动结束 - `4` = 失败 - `5` = 排队中 --- ## 完整任务流程 1. **创建任务** → POST `/api/conversation/anew` 获取 `sessionId` 2. **轮询状态** → 每隔一段时间调用 `/api/conversation/status?sessionId={id}` 检查状态 3. **状态 = 2** → 任务完成 4. **获取 PDF 报告** → 调用 `/api/conversation/to_report?sessionId={id}&reportType=pdf` 获取 PDF 下载链接 5. **下载 PDF** → 从 data 字段获取 URL，下载 PDF 文件到本地 6. **发送消息** → 使用 `message` 工具发送 PDF 文件到用户 ## 错误处理 ### 接口调用超限错误 (code=315) 当 API 返回 code=315 且 msg 包含"当前接口调用已超限"时，表示当前并发任务数已达到上限（max_limit_conversation），需要等待当前任务执行完成后再提交新任务： ```bash # 检查返回码 RESULT=$(curl -s -X POST "https://desearch.zeelin.cn/api/conversation/anew" \ -H "Content-Type: application/json" \ -H "x-[REDACTED_SECRET]" \ -d '{ "sessionId": "", "content": "你的问题", "thinking": "deep", "workflow": "", "needEditChapter": 0, "moreSettings": {} }') CODE=$(echo $RESULT | jq -r '.code') MSG=$(echo $RESULT | jq -r '.msg') if [ "$CODE" = "315" ] && echo "$MSG" | grep -q "当前接口调用已超限"; then # 发送提示给用户，等待当前任务完成 message action=send target=用户ID message="⚠️ 当前接口调用已超限，请等待当前任务执行完成后再提交新任务。" exit 1 fi ``` **返回示例:** ```json { "code": 315, "v": "0.0.914", "msg": "当前接口调用已超限，请联系我们", "data": { "max_limit_conversation": 1, "now_conversation": 1 } } ``` ### 试用超限错误 (code=315) 当 API 返回 code=315 且 msg 包含"试用已超限"时，需要引导用户充值： ```bash # 检查返回码 RESULT=$(curl -s -X POST "https://desearch.zeelin.cn/api/conversation/anew" \ -H "Content-Type: application/json" \ -H "x-[REDACTED_SECRET]" \ -d '{ "sessionId": "", "content": "你的问题", "thinking": "deep", "workflow": "", "needEditChapter": 0, "moreSettings": {} }') CODE=$(echo $RESULT | jq -r '.code') MSG=$(echo $RESULT | jq -r '.msg') if [ "$CODE" = "315" ] && echo "$MSG" | grep -q "试用已超限"; then # 发送充值提示给用户 message action=send target=用户ID message="⚠️ 您的点数已超限，无法继续使用。请前往充值页面购买点数：https://desearch.zeelin.cn/skill-activity" exit 1 fi ``` **充值地址**: https://desearch.zeelin.cn/skill-activity ### 完整流程示例 ```bash # 1. 创建任务 [REDACTED_SECRET]" RESULT=$(curl -s -X POST "https://desearch.zeelin.cn/api/conversation/anew" \ -H "Content-Type: application/json" \ -H "x-[REDACTED_SECRET]" \ -d '{ "sessionId": "", "content": "你的问题", "thinking": "deep", "workflow": "", "needEditChapter": 0, "moreSettings": {} }') SESSION_ID=$(echo $RESULT | jq -r '.data.sessionId') QUESTION_ID=$(echo $RESULT | jq -r '.data.id') echo "Session ID: $SESSION_ID, Question ID: $QUESTION_ID" # 2. 轮询状态直到完成 while true; do STATUS=$(curl -s -X GET "https://desearch.zeelin.cn/api/conversation/status?sessionId=${SESSION_ID}" \ -H "x-[REDACTED_SECRET]" | jq -r '.data.status') if [ "$STATUS" = "2" ]; then echo "任务完成" break fi echo "状态: $STATUS, 等待中..." sleep 60 # 每分钟检查一次 done # 3. 获取 PDF 报告链接 REPORT_RESULT=$(curl -s -X GET "https://desearch.zeelin.cn/api/conversation/to_report?sessionId=${SESSION_ID}&reportType=pdf" \ -H "x-[REDACTED_SECRET]") PDF_URL=$(echo $REPORT_RESULT | jq -r '.data') echo "PDF URL: $PDF_URL" # 4. 下载 PDF 文件 curl -s -o /tmp/research_result.pdf "$PDF_URL" # 5. 发送 PDF 文件给用户 message action=send target=用户ID filePath=/tmp/research_result.pdf ``` ### 实际调用命令（执行时替换对应变量） ```bash # 1. 创建任务 [REDACTED_SECRET]" curl -s -X POST "https://desearch.zeelin.cn/api/conversation/anew" \ -H "Content-Type: application/json" \ -H "x-[REDACTED_SECRET]" \ -d '{ "sessionId": "", "content": "你的问题", "thinking": "deep", "workflow": "", "needEditChapter": 0, "moreSettings": {} }' ``` ### 轮询状态脚本 ```bash # 轮询直到任务完成 (status = 2) [REDACTED_SECRET]" SESSION_ID="替换为实际的sessionId" while true; do STATUS_RESPONSE=$(curl -s -X GET "https://desearch.zeelin.cn/api/conversation/status?sessionId=${SESSION_ID}" \ -H "x-[REDACTED_SECRET]") STATUS=$(echo $STATUS_RESPONSE | jq -r '.data.status') echo "当前状态: $STATUS" if [ "$STATUS" = "2" ]; then echo "任务完成！" break fi sleep 60 # 每分钟检查一次 done # 获取 PDF 报告链接 REPORT_RESULT=$(curl -s -X GET "https://desearch.zeelin.cn/api/conversation/to_report?sessionId=${SESSION_ID}&reportType=pdf" \ -H "x-[REDACTED_SECRET]") PDF_URL=$(echo $REPORT_RESULT | jq -r '.data') # 下载 PDF 文件 curl -s -o /tmp/research_result.pdf "$PDF_URL" # 发送 PDF 文件给用户 message action=send target=用户ID filePath=/tmp/research_result.pdf ``` --- ## ⚠️ 重要：必须保存文件再发送 **❌ 禁止直接发送文字内容给用户** **✅ 必须：获取 PDF 链接 → 下载 PDF 文件 → 发送 PDF 文件给用户** ### 正确流程示例（飞书文档） ```bash # 1. 创建任务 [REDACTED_SECRET]" RESULT=$(curl -s -X POST "https://desearch.zeelin.cn/api/conversation/anew" \ -H "Content-Type: application/json" \ -H "x-[REDACTED_SECRET]" \ -d '{ "sessionId": "", "content": "用户的问题", "thinking": "deep", "workflow": "", "needEditChapter": 0, "moreSettings": {} }') SESSION_ID=$(echo $RESULT | jq -r '.data.sessionId') # 2. 轮询状态直到完成 (status=2) while true; do STATUS=$(curl -s "https://desearch.zeelin.cn/api/conversation/status?sessionId=${SESSION_ID}" \ -H "x-[REDACTED_SECRET]" | jq -r '.data.status') [ "$STATUS" = "2" ] && break sleep 30 done # 3. 获取 PDF 报告链接 REPORT_RESULT=$(curl -s -X GET "https://desearch.zeelin.cn/api/conversation/to_report?sessionId=${SESSION_ID}&reportType=pdf" \ -H "x-[REDACTED_SECRET]") PDF_URL=$(echo $REPORT_RESULT | jq -r '.data') # 4. 下载 PDF 文件 curl -s -o /tmp/research_result.pdf "$PDF_URL" # 5. 发送 PDF 文件给用户 message action=send target=用户ID filePath=/tmp/research_result.pdf ``` ### 关键点 - 任务完成后调用 `/api/conversation/to_report?sessionId={id}&reportType=pdf` 获取 PDF 下载链接 - 从返回的 `data` 字段提取 PDF URL - 使用 curl 下载 PDF 文件到本地 - 直接发送 PDF 文件给用户 ### 后台执行与自动发送 **确保任务完成后自动发送 PDF 的关键：** 1. **使用足够长的 timeout**：设置 `timeout=1200` 或更长，确保 exec 命令等待任务完成 2. **轮询循环内检查状态**： ```bash while true; do STATUS=$(curl -s "https://desearch.zeelin.cn/api/conversation/status?sessionId=${SESSION_ID}" \ -H "x-[REDACTED_SECRET]" | jq -r '.data.status') [ "$STATUS" = "2" ] && break # 任务完成后跳出循环 [ "$STATUS" = "4" ] && exit 1 # 任务失败则退出 sleep 30 done ``` 3. **任务完成后立即发送**：在轮询循环结束后，立即调用 message 工具发送 PDF ```bash # 下载 PDF 后立即发送 curl -s -o /tmp/research_result.pdf "$PDF_URL" message action=send target=用户ID filePath=/tmp/research_result.pdf ``` **❌ 错误做法**：轮询后不等待结果就退出，或超时时间太短导致任务未完成就退出 **✅ 正确做法**：使用 while 循环 + 足够长的 timeout，任务完成后立即发送 PDF ### 后台执行（用户可同时做其他事情） 当用户希望任务在后台运行、同时可以让你执行其他任务时，使用 OpenClaw 的后台执行功能： **方式一：使用 `background=true` 参数** ```bash exec command="..." background=true timeout=1200 ``` 这样命令会在后台运行，不会阻塞当前会话，你可以继续给其他命令。 **方式二：使用 `exec` + `yieldMs` 参数** ```bash exec command="..." yieldMs=10000 ``` 设置 yieldMs 让出控制权，命令在后台继续运行。 **方式三：使用 `process` 工具管理后台任务** 1. 先启动后台任务： ```bash exec command="完整的轮询+发送脚本" timeout=1200 ``` 2. 使用 `process(action=poll)` 轮询结果： ```bash process action=poll sessionId=<session_id> timeout=600000 ``` **后台任务完整示例：** ```bash # 1. 创建任务（立即返回） [REDACTED_SECRET]" RESULT=$(curl -s -X POST "https://desearch.zeelin.cn/api/conversation/anew" \ -H "Content-Type: application/json" \ -H "x-[REDACTED_SECRET]" \ -d '{ "sessionId": "", "content": "用户的研究问题", "thinking": "deep", "workflow": "", "needEditChapter": 0, "moreSettings": {} }') SESSION_ID=$(echo "$RESULT" | jq -r '.data.sessionId') echo "任务已创建: $SESSION_ID" # 2. 后台轮询 + 下载 + 发送（设置长timeout） exec command=" SESSION_ID='$SESSION_ID' [REDACTED_SECRET]' # 轮询直到完成 while true; do STATUS=\$(curl -s 'https://desearch.zeelin.cn/api/conversation/status?sessionId=\${SESSION_ID}' \\ -H 'x-[REDACTED_SECRET]' | jq -r '.data.status') [ \"\$STATUS\" = \"2\" ] && break [ \"\$STATUS\" = \"4\" ] && exit 1 sleep 30 done # 获取并下载PDF PDF_URL=\$(curl -s 'https://desearch.zeelin.cn/api/conversation/to_report?sessionId=\${SESSION_ID}&reportType=pdf' \\ -H 'x-[REDACTED_SECRET]' | jq -r '.data') curl -s -o /tmp/report.pdf \"\$PDF_URL\" # 发送PDF（替换为目标用户ID） message action=send target=用户ID filePath=/tmp/report.pdf " timeout=1200 ``` **用户可以：** - 随时查询任务状态 - 在后台任务运行期间执行其他命令 - 任务完成后自动收到 PDF --- ## ⚠️ 跨渠道发送文件注意事项 ### 不同渠道的文件限制 | 渠道 | 文件大小限制 | |-----|------------| | 钉钉 | 20MB | | 飞书 | 20MB | | Telegram | 50MB | | Discord | 8MB | | WhatsApp | 16MB | --- ## ⚠️ 飞书渠道：必须创建飞书文档发送 **当用户渠道为飞书时，禁止直接发送 PDF 文件给用户，必须按以下流程操作：** ### 飞书渠道完整流程 ```bash # 1. 创建任务 [REDACTED_SECRET]" RESULT=$(curl -s -X POST "https://desearch.zeelin.cn/api/conversation/anew" \ -H "Content-Type: application/json" \ -H "x-[REDACTED_SECRET]" \ -d '{ "sessionId": "", "content": "用户的问题", "thinking": "deep", "workflow": "", "needEditChapter": 0, "moreSettings": {} }') SESSION_ID=$(echo $RESULT | jq -r '.data.sessionId') TITLE=$(echo $RESULT | jq -r '.data.title') # 2. 轮询状态直到完成 (status=2) while true; do STATUS=$(curl -s "https://desearch.zeelin.cn/api/conversation/status?sessionId=${SESSION_ID}" \ -H "x-[REDACTED_SECRET]" | jq -r '.data.status') [ "$STATUS" = "2" ] && break sleep 30 done # 3. 获取 Word 报告链接（Word 格式更容易提取文字内容） REPORT_RESULT=$(curl -s -X GET "https://desearch.zeelin.cn/api/conversation/to_report?sessionId=${SESSION_ID}&reportType=word" \ -H "x-[REDACTED_SECRET]") WORD_URL=$(echo $REPORT_RESULT | jq -r '.data') # 4. 下载 Word 文件 curl -s -o /tmp/research.docx "$WORD_URL" # 5. 解压 Word 文件提取文字内容 unzip -q /tmp/research.docx -d /tmp/research_docx/ sed 's/<[^>]*>//g' /tmp/research_docx/word/document.xml | tr -s ' \n' > /tmp/research.txt # 6. 创建飞书文档 DOC_RESULT=$(feishu_doc action=create title="调研报告：${TITLE}") DOC_TOKEN=$(echo $DOC_RESULT | jq -r '.document_id') DOC_URL=$(echo $DOC_RESULT | jq -r '.url') # 7. 写入内容到飞书文档 feishu_doc action=write doc_token=${DOC_TOKEN} content=$(cat /tmp/research.txt) # 8. 发送文档链接给用户 message action=send target=用户ID message="📄 调研报告已生成：${DOC_URL}" ``` ### 飞书渠道检查清单 - [ ] 渠道是飞书吗？ - [ ] 是否已创建飞书文档？ - [ ] 是否已将报告内容写入飞书文档？ - [ ] 是否发送的是飞书文档链接而非 PDF？ ### 飞书渠道 ❌ 禁止事项 - ❌ 直接发送 PDF 文件（用户打不开） - ❌ 直接发送本地文件路径 - ❌ 发送服务器目录 ### 飞书渠道 ✅ 正确做法 - ✅ 创建飞书文档 (feishu_doc action=create) - ✅ 写入内容 (feishu_doc action=write) - ✅ 发送文档链接 (message action=send 附带 URL) ### 确保发送成功的检查 ```bash # 检查文件是否存在且非空 if [ -f /tmp/research.md ] && [ -s /tmp/research.md ]; then # 发送文件 message action=send target=用户ID filePath=/tmp/research.md else echo "文件无效或为空" fi ``` ---

path: _meta.json
content: ownerId: kn70rvb50msptzn6jegcqqfgzd829k3q
slug: desearch
version: 1.0.12
publishedAt: 1772709933924

Security scan verdicts — ClawScan: clean | static analysis: suspicious | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)