Searchis 证据检索

语义搜索工具，在内部金融调研档案中根据自然语言问题返回原文证据。

前置检查

npx @openduo/searchis status --json

根据 activated 字段决定下一步。

未激活 → 引导用户

输出以下信息并停止：

⚠️ Searchis 内部文档库未激活。

Searchis 提供内部金融调研纪要、电话会记录和行业分析的语义搜索服务。

激活步骤：
1. 联系管理员获取邀请码
2. 运行: npx @openduo/searchis activate <邀请码>

调用

npx @openduo/searchis query "<研究问题描述>"

输入是一个自然语言问题，可以是简短的，也可以是带上下文的长描述。Searchis 的内部 agent 会理解问题、拆解成内部搜索策略、检索相关文档、提取原文片段。

调用通常需要 60-180 秒完成（agent 会执行多轮内部搜索）。CLI 使用流式协议持续接收结果，stderr 上有持续的进度输出表明 agent 正在工作。遇到网络或后端真的卡住才会中断（默认 dial 30s、idle 60s），不要额外包装超时。

需要程序解析时加 --json 切换成 JSON 输出（默认是带引用的 markdown）。

输出（默认 markdown）

主要内容是带 [1] [2] 等内联引用的研究答案，下接 Sources 区列出每条证据的标题、作者、日期、行号、原文。引用编号是文件内的下标，对接给用户时用 [内部调研 {title} {date}] 这类可读形式。

--json 输出

{
  "answer": "## 标题\n... [1] ... [2] ...",
  "evidences": [
    {
      "id": "abc123",
      "date": "2026-03-27",
      "title": "光芯片专家交流-2026年EML、CW光源全球供给情况...",
      "source": { "author": "Shirley" },
      "quote": "原文引用，未经改写",
      "lineRange": [40, 45],
      "context": "该证据的一句话描述"
    }
  ],
  "stats": { "duration_ms": 65000, "files_searched": 4 }
}

字段说明

• quote — 从原始文档精确复制的文本，未经 LLM 改写
• date — 从文件名提取的文档日期
• title — 调研纪要的标题（来自 frontmatter）
• source.author — 纪要作者
• id — 文件 hash，同文件的多条证据共享
• context — 对该证据的一句话摘要
• answer — 服务内部对证据的草稿组织，仅作参考线索：可能漏关键证据、可能误读，最终结论由调用方基于 evidences 自行整理
• evidences: [] — 未找到相关证据（有效结果，不要伪造）

错误处理

返回	处理
{"error":"not_activated",...}	显示激活引导
{"error":"query_failed","message":"...401..."}	提示 npx @openduo/searchis refresh
{"error":"query_failed","message":"...429..."}	等待 30s 重试
dial / idle timeout（网络或后端卡死）	报告超时，建议用更精确的查询重试

使用证据时

• 引用 quote 字段原文，不改写
• 标注来源 [内部调研 {title} {date}]
• 空结果时如实报告，不伪造