@rectified-flow/thesis

Thesis 投研语料库客户端（Go 单二进制，零运行时依赖，agent-native）。

前置

本客户端复用共享身份池凭据（~/.searchis/credentials.json，由 searchis CLI 激活时写入）， 自身不做激活。未激活时请先用 searchis CLI 激活，再回来 login。

安装

npx -y @rectified-flow/thesis version
# 或全局安装
npm i -g @rectified-flow/thesis

npm 包内含 5 个平台的预编译二进制（linux/darwin × amd64/arm64 + windows/amd64）， 安装时按本机平台就地复制，不联网下载。

用法

thesis login               # 铸一次性浏览器登录 URL：打印到 stdout 并自动打开浏览器
thesis login --no-browser  # 只打印 URL，不开浏览器
thesis login --json        # 失败时输出结构化错误信封（见下）
thesis version             # 打印版本

query — 语料 agentic 检索（弱检索+强推理）

在某 ticker 的语料库里做多轮 agentic 检索，SSE 流式返回证据清单（verbatim 引用 + 来源 + 日期 + 证据分级，无答案合成）。

thesis query --ticker 300693 "最近有什么关联事件"
thesis query --ticker 300693 "回款风险" --asof 2026-06-30           # 时间窗上界（回测防泄露）
thesis query --ticker 300693 "毛利率变化" --range 2026-01-01..2026-06-30
thesis query --ticker 300693 "外部见证" --strict                   # 只召回 L1 证据
thesis query --ticker 300693 "营收" --json                         # 原始 JSON 到 stdout

• --asof YYYY-MM-DD 与 --range start..end 互斥；unknown（无公开日期）永不进窗。
• 只设 --dial-timeout（默认 30s）+ --idle-timeout（默认 60s）两层网络超时，故意无 wall-clock 总超时——agent 检索循环天然 60-180s。进度打到 stderr，结果打到 stdout。
• 断流兜底：连接中途断开时先尝试一次 GET jobs/<id> 恢复完整结果，失败则拼已收证据输出 部分结果 + resume_command（见下 result）。

result — 按 job_id 续取（断流恢复的另一半）

thesis result --ticker 300693 <job_id>          # completed→完整结果；running→稍后再取

服务端地址解析链：--server flag > THESIS_SERVER_URL env > 默认 https://thesis-snapshot.platx.ai。

输出契约（agent-native）

• stdout = 结果（登录 URL / 证据清单）；stderr = 进度与诊断信息。
• exit code：0 成功 / 1 语义错误（凭据、权限、服务端拒绝、error 事件、断流部分结果）/ 2 网络层故障（拨号/DNS/TLS 失败）。
• --json 时失败输出结构化信封到 stdout： {"command","error","recoverable","resume_command","instruction"}；query/result 成功时 --json 输出 {"job_id","evidences","stats"}。