Developer‑First 信息架构

开发者文档结构

交付文档

V9 全量说明文档(01–09)

用于验收、交接与再开发:视觉策略、叙事章节、信息架构、设计系统、线框蓝图、Cinematic 要求、参数系统、Console IA、多语言方案。

01 — Visual Strategy视觉策略(Infra × Finance × Film)
02 — Narrative Chapters8 章叙事与视觉隐喻
03 — Site Structure路由/页面结构与信息流
04 — Design System设计系统与 Token/颜色/组件
05 — Wireframe Blueprint线框蓝图(Landing + Console)
06 — V9 Cinematic Requirements电影级 3D 与章节转场要求
07 — Interactive Parameters参数系统与可解释映射
08 — Console IA V9Console 模块与 IA
09 — i18n多语言方案与字典结构
Docs IA

文档应围绕“路径”组织

不要把文档写成 API 列表;应围绕 Discovery → Handshake → Call → Settle 的路径组织示例与边界条件。

章节内容
Quickstart5 分钟跑通一次会话
Discovery端点与能力选择
Handshake预算/担保/规则承诺
Call调用、重试、降级
Settlement结算、发票、净额
Security签名、审计、KYC/AML
Sample

示例代码(Demo)

# 1) discover
curl -s "https://api.neutralnet.example/v1/discover?needs_sha=true&sovereignty=US"

# 2) handshake
curl -X POST https://api.neutralnet.example/v1/handshake -d '{"endpoint":"ep-gpt-01","budget":{"NC":20},"stake":{"NEUT":10}}'

# 3) call
curl -X POST https://api.neutralnet.example/v1/call -d '{"session":"sess-a1b2","messages":[{"role":"user","content":"hello"}]}'

# 4) settle
curl -X POST https://api.neutralnet.example/v1/settle -d '{"session":"sess-a1b2"}'