UniFuncs 深度搜索技能

使用此工具对特定主题执行深度搜索与深度调研，并生成完整的搜索报告。当任务需要多轮搜索与阅读，或用户明确要求“深度搜索”/“深度挖掘”时，适合调用该技能。这是一个相对高开销的操作，通常耗时 1–5 分钟。若用户未明确要求对某一主题执行深度搜索，请在运行前主动确认。若用户意图模糊，可进行简要的目标澄清，但避免过度提问；一旦用户给出清晰指令，应立即执行。

首次配置

1. 前往 https://unifuncs.com/account 获取您的 API 密钥。
2. 设置环境变量：export UNIFUNCS_API_KEY="sk-your-api-key"

适用场景

您需要比标准网页搜索更深入、更广泛、更全面的信息。 您希望针对复杂或多部分的问题，获得整合后的调研结果。 典型深度搜索完成时间约为 1–5 分钟，具体取决于主题的复杂程度。

使用指南

该技能分为 3 个独立入口：

• deep-search-report.py — 同步获取搜索报告。由于可能耗时较长，请设置足够大的超时值。
• deep-search-create-task.py — 异步创建搜索任务并返回 task_id。请妥善保存该任务 ID，以便后续查询状态或结果，避免重复创建任务。
• deep-search-query-task.py — 查询任务状态，并返回任务结果/报告内容。

1）同步获取结果：deep-search-report.py

python3 deep-search-report.py "query"

2）异步创建任务：deep-search-create-task.py

python3 deep-search-create-task.py "query"

该命令返回 task_id。

3）异步查询任务：deep-search-query-task.py

python3 deep-search-query-task.py "task_id"

选项说明

用法: deep-search-report.py [-h] [--model {s1,s2,s3}]
                             [--timeout TIMEOUT]
                             [--stream-file STREAM_FILE]
                             [--read-stream-file] [--language {zh,en}]
                             [--reference-style {link,character,hidden}]
                             [--max-depth MAX_DEPTH]
                             [--domain-scope DOMAIN_SCOPE]
                             [--domain-blacklist DOMAIN_BLACKLIST]
                             [--output-prompt OUTPUT_PROMPT]
                             [--important-urls IMPORTANT_URLS]
                             [--important-keywords IMPORTANT_KEYWORDS]
                             [--important-prompt IMPORTANT_PROMPT]
                             [--introduction INTRODUCTION]
                             [--push-to-share] [--set-public]
                             [--raw-response]
                             [query]

UniFuncs 深度搜索客户端

位置参数：
  query                 发送给深度搜索的用户查询。

选项：
  -h, --help            显示此帮助信息并退出
  --model {s1,s2,s3}    使用的模型（默认：s3）
  --timeout TIMEOUT     流式响应最大等待时间（秒，默认：900）
  --stream-file STREAM_FILE
                        用于持久化或读取流式分块数据的文件路径。若未指定且当前目录可写，则自动创建临时文件
  --read-stream-file    从 --stream-file 中读取并渲染已接收的内容，不调用 API
  --language {zh,en}    输出语言
  --reference-style {link,character,hidden}
                        参考文献标记样式
  --max-depth MAX_DEPTH
                        最大研究深度
  --domain-scope DOMAIN_SCOPE
                        逗号分隔的域名白名单
  --domain-blacklist DOMAIN_BLACKLIST
                        逗号分隔的域名黑名单
  --output-prompt OUTPUT_PROMPT
                        自定义输出提示模板
  --important-urls IMPORTANT_URLS
                        逗号分隔的重要 URL 列表
  --important-keywords IMPORTANT_KEYWORDS
                        逗号分隔的重要关键词列表
  --important-prompt IMPORTANT_PROMPT
                        重要提示内容
  --introduction INTRODUCTION
                        研究员角色/语气介绍
  --push-to-share       将结果推送至共享空间
  --set-public          将结果设为公开
  --raw-response        打印完整 API 响应 JSON，而非简洁文本输出