总览 · RAGSpine

纯 Python 双通道 RAG、工作流互操作、安全预览，以及可选的服务化执行边界。

RAGSpine 的引擎是普通的 Python：带类型的接缝、dataclass、显式的存储，以及可读的控制流。answer_question(...) 是问答的组合入口。一个独立的工作流领域负责解析、脚手架生成、预览、转换和编译 Dify 兼容配置；一个可选的 FastAPI 服务暴露这些操作，以及一个刻意默认关闭的执行器。

这个区分很重要。RAGSpine 拥有 Dify 和 n8n 的互换面，但它不内嵌任一平台的运行时，不在运行时下载它们的应用市场，也不需要图框架就能回答问题。

架构承诺

代码强制的证据

结构化数值来自事实存储；未命中会变成显式拒答。叙事回答保留来源定位符。

领域包

十五个顶层领域让编排、存储、检索、互操作、服务和 CLI 的职责清晰可见。

带类型的边界

Provider、embedding、存储、分块器、重排器、队列、连接器和匹配器都通过 Protocol 注入。

默认不执行

目录、脚手架、解析、转换、编译、拓扑和预览操作都不会执行工作流。运行路由默认禁用。

问答请求生命周期

question
  → deterministic security/intent screening
  → clarification gateway
  → optional service-edge FAQ short-circuit
  → structured | narrative | composite route
       structured: normalize → query fact store → found/not_found/unrecognized
       narrative: filter → retrieve/fuse → rerank/postprocess → cited generation
       composite: execute both evidence paths and merge
  → anti-fabrication/provenance checks
  → answer + sources

可选的 history 只会插入到最终的生成消息序列中。它绝不改变确定性的意图/安全判定、检索查询，也不改变什么可以算作证据。

叙事路径可以使用元数据过滤、带 RRF 融合的按库路由，以及存储层的父块/窗口扩展。引用字段始终是子命中的字段；扩展文本是独立的生成上下文。受限（restricted）的子块会在扩展之前被移除。

工作流生命周期

description or JSON/YAML/TOML
  → normalize to JSON-compatible mapping
  → explicit template or catalog match
  → reuse safe Dify workflow | generate fixed start→llm→end graph
  → deterministic YAML/JSON + preview schema v1
  → optional analyze / convert / compile
  → explicit server-controlled execution gate (off by default)

目录是包数据：7 个精选模板加 993 个生成的描述符。上游的 Dify/n8n URL 仅作为研究元数据；不会再分发任何上游工作流文本或凭证。