NodeStone 官网与文档站上线
· 阅读需 2 分钟
NodeStone 的官网今天上线了。它同时承担三件事:讲清楚 NodeStone 是什么、把协议文档放在一个稳定的地址上、记录每一次发布。
站点结构
- 介绍:从「一次下载发生了什么」开始,讲清索引、内容、节点三者的分工,以及总体架构。
- 文档:Compass Protocol(NCP)v0.9.0 的完整规范——总览与最小实现、字段表与种子打包规范、客户端与服务端两篇推荐实现。
- 新闻:版本发布、镜像接入公告、工程笔记。
为什么单独建站
协议规范原本散落在仓库的 Markdown 里。这样做的问题很实际:链接会随重构失效,外部开发者要翻仓库才能找到入口,而「某个字段到底是不是必填」这类问题往往需要在一堆文档之间来回跳。
现在文档有了固定路径(/docs/compass/*),带侧边栏与目录导航,正文内容仍然是从仓库同一份源稿件搬运过来的,不会出现「站上一套、仓库一套」的漂移。
接下来
- 补齐 SDK 侧的示例工程与最小可运行启动器
- 为
sha256:<Hex>形式的 NSFID 与正则路由表补上设计稿 - 把镜像源的构建流程脚本化,让「自建镜像源」从文档变成一条命令
有问题欢迎从常见问题开始找答案;如果那里没有,说明我们该补一条了。
