tiangong-kb-sci-search

Tiangong KB SCI Search

此 Skill 刻意限定为单一数据源。仅搜索 sci；绝不扩展到 all、report 或 patent。访问需要部署所有者的常规密钥和权限。遇到身份验证、授权、订阅、VPN 或 服务故障时立即停止；不得尝试绕过限制。

选择执行模式

• 在受管理的工作区之外进行直接独立搜索时，按下文所述使用 scripts/sci_search.sh。在受管理的工作区内，只有用户明确要求进行隔离查询时，才可设置 "execution_mode":"standalone"；包装器会记录一条非机密的模式事件。
• 在 Tiangong Auto Research 发现包内，不得执行此脚本或其中的 CLI/curl 示例。请通过 fetch_candidate_source 使用锁定的能力 ID database.tiangong.sci-search。代理负责精确的 POST 方法、端点、区域标头、凭据注入、 响应边界、净化处理和永久证据回执。

直接搜索的先决条件

• 独立包装器默认使用单独测试过的 CLI 版本 0.0.62。这不是 Auto Research 工作区的运行时版本。受管理的研究会从不可变设置计划或 runtime-lock.json 中确定确切版本，并且必须使用代理。 仅当有意覆盖独立入口点时，才将 TIANGONG_AI_CLI_BIN 设置为一个确切的可执行文件路径，或将 TIANGONG_AI_CLI 设置为经过明确审查的命令。
• 将特定于源的密钥放入 TIANGONG_SCI_APIKEY，或使用 TIANGONG_AI_APIKEY 作为通用备用项。包装器 JSON、请求文件和 CLI 参数均不接受凭据。
• 包装器需要 jq。
• 可选端点变量包括 TIANGONG_SCI_SEARCH_URL、 TIANGONG_RESEARCH_API_BASE_URL、TIANGONG_AI_SEARCH_API_BASE_URL 或 TIANGONG_AI_API_BASE_URL；同时支持 TIANGONG_REGION 和 TIANGONG_RESEARCH_TIMEOUT。

直接查询

export TIANGONG_SCI_APIKEY='owner-authorized key'
./scripts/sci_search.sh '{
  "query": "mechanical recycling reduces lifecycle emissions",
  "top_k": 5,
  "get_meta": true
}'

包装器会调用与以下命令等效的固定版本 CLI：

npx --yes --package "@tiangong-ai/[email protected]" -- tiangong-ai research search \
  --query <query> --sources sci --json

如需写入结果，请将一个明确的输出路径作为第二个参数传入。包装器会写入一个唯一的临时文件，并且仅在 CLI 成功退出后才重命名；绝不会仅凭文件存在就报告成功。

精确请求载荷

内联的受支持边缘函数字段会转换为临时请求文件：

{
  "query": "critical metal material flows",
  "filter": {
    "journal": ["JOURNAL OF INDUSTRIAL ECOLOGY"]
  },
  "datefilter": {
    "date": { "gte": 1262304000 }
  },
  "topK": 5,
  "extK": 2,
  "getMeta": true
}

或者引用现有的常规非符号链接 JSON 文件：

./scripts/sci_search.sh '{
  "request_file": "/absolute/path/to/sci-request.json",
  "dry_run": true
}'

filter 接受元数据项数组。datefilter 接受数值型 gte/lte 范围。topK、extK 和 getMeta 是服务端原始名称；top_k、 ext_k 和 get_meta 是查询模式下的便捷名称。

可选的 dotenv 加载

明确指定的 env_file 必须存在、是常规非符号链接文件，并且仅所有者可读写（chmod 600）。若未明确指定环境文件但提供了 request_file，则仅当同目录下的 .env 存在且通过相同检查时才会加载。已有的进程变量优先。

解析器不会执行 shell 语法，且仅加载有文档说明的 Tiangong 密钥、端点、区域和超时变量名称。其他所有键都会被忽略。切勿将 Agent 密钥、浏览器 Cookie、Authorization 标头、会话令牌、代理密码或无关机密放入此文件。

接受的包装器字段

• query、input 或 claim；
• request_file 或 input_file；
• env_file；
• execution_mode，仅接受 standalone，且只有在检测到受管理工作区并收到明确的隔离查询请求后才可使用；
• filter、datefilter、topK、extK、getMeta；
• 查询模式下的 top_k、ext_k、get_meta；
• sources，仅接受 sci 或 default；
• api_base_url、sci_url、region、timeout，作为非机密路由值；
• dry_run。

任何看起来像 API 密钥、令牌、Authorization、Cookie、密码、凭据、机密或会话信息的键，都会在 CLI 启动前被递归拒绝。包装器不会回显被拒绝的值或失败命令的标准输出。

Auto Research 经纪服务调用

research setup 选定并配置此 Skill 后，发现流程使用：

{
  "capability_id": "database.tiangong.sci-search",
  "url": "<the exact manifest endpoint>",
  "request_body": {
    "query": "research claim",
    "topK": 5,
    "getMeta": true
  }
}

仅使用有文档说明的非机密请求字段。切勿将 API 密钥、请求头、 Cookie、端点覆盖值或令牌添加到 request_body。经纪服务会将逻辑 tiangong.sci.api-key 注入为 x-api-key，发送锁定的 x-region， 拒绝 POST 重定向，并仅在永久原始响应对象之外记录请求正文的 SHA-256。 此数据库是对 Auto Research 独立的公共互联网证据要求的补充，但不能取代该要求。