# Searchis Query

> 在内部金融调研档案（调研纪要、电话会记录、行业分析）中进行语义搜索。 输入一个自然语言的研究问题，返回匹配该问题的原文证据列表（带来源文件标题、 作者、日期、行号）。理解语义不是关键词匹配 — 问题描述越具体（研究对象、时间、 想了解的维度、已有的假设），返回的证据越精准。每次调用约 60-180 秒。

- Skill: `rectified-flow/searchis-query` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rectified-flow/searchis-query`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rectified-flow/searchis-query/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: rectified-flow (https://skillmd.com/u/rectified-flow)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rectified-flow/searchis-query

---


# Searchis 证据检索

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

## 前置检查

```bash
npx @openduo/searchis status --json
```

根据 `activated` 字段决定下一步。

### 未激活 → 引导用户

输出以下信息并**停止**：

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

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

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

## 调用

```bash
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` 输出

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