# Demo Clients

本目录提供最小可运行的 demo 客户端，帮助第三方团队直接验证白皮书机器层的接入方式。

## 文件

- `python_whitepaper_demo.py`
  - 读取本地白皮书目录
  - 根据问题匹配 `retrieval_hints.json`
  - 输出推荐主题、模块和 chunk

- `node_faq_router_demo.mjs`
  - 面向 FAQ 路由或群机器人
  - 读取本地白皮书目录
  - 生成结构化回答建议

- `.env.example`
  - 统一示例环境变量
  - 可按需改成本地路径或未来公网路径

## 快速开始

### Python

```bash
cd docs/architecture_diagrams/integration_examples/demo_clients
python3 python_whitepaper_demo.py "MSG 的发行规则是什么"
```

### Node

```bash
cd docs/architecture_diagrams/integration_examples/demo_clients
node node_faq_router_demo.mjs "Explorer 现在支持什么"
```

## 当前默认模式

- 默认读取仓库内本地白皮书目录
- 不依赖第三方包
- 不直接访问网络

## 使用边界

- 这两个 demo 只演示“如何读取和路由”，不是完整生产机器人
- 最终生产接入仍应保留 `boundary_clauses` 与 `evidence_refs`
- 若迁移到公网模式，应继续以 `agent_entry.json` 作为稳定入口