# MSG Chain Whitepaper Integration Examples

本目录提供给第三方机器人、RAG 服务和 FAQ 路由器的接入示例。

## 推荐入口

- 稳定入口: `../agent_entry.json`
- 版本清单: `../whitepaper_manifest.json`
- 检索提示: `../retrieval_hints.json`
- 模块索引: `../module_exports/index.json`
- Chunk 索引: `../module_chunks/index.json`

## 示例文件

- `telegram_bot_crawl_flow.json`
  - 面向 Telegram 或群机器人
  - 先走主题路由，再拉模块和 chunk
  - 适合问答型机器人

- `rag_ingest_flow.json`
  - 面向向量库或检索增强生成服务
  - 先抓模块索引，再抓 chunk，最后建立引用映射
  - 适合批量入库

- `faq_router_prompt_template.md`
  - 面向 FAQ 路由器和工具调用型模型
  - 把用户问题先路由到最相关主题，再下钻到模块和 chunk

- `demo_clients/`
  - 提供最小可运行 Python 与 Node 示例
  - 适合第三方团队先本地验证接入流

## 使用边界

- `modules/*.html` 仍是正文权威来源
- `module_exports/*.json` 和 `module_chunks/*.json` 是机器友好派生层
- 回答涉及经济、治理、Explorer、live/public 时，必须保留边界说明
- 不得把 `partial`、`planned` 或本地子门禁关闭解释成主网 ready

## 最小接入建议

1. 先读取 `../agent_entry.json`
2. 再读取 `../retrieval_hints.json`
3. 按主题选择推荐模块和推荐 chunk
4. 若需要完整上下文，再补抓对应 `modules/*.html`
5. 最终回答时引用 `boundary_clauses` 与 `evidence_refs`