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}] - 空结果时如实报告，不伪造