DEVELOPER RESOURCES

从协议到可运行实现

选择 .NET SDK 1.6.0 或 TypeScript SDK Alpha，将账户、加密消息、群组与频道接入应用。在线阅读开发指南、API 参考、协议规范与测试向量。

Meshline Protocol 1.0

规范定义兼容客户端、中继与推送网关之间的互操作规则，涵盖账户与设备、加密消息、路由、频道和群组，并提供测试向量用于一致性验证。

规范提供简体中文和英文版本，以中文为准；两种语言共用 JSON 测试向量。

1.6.0 已在 NuGet 发布，要求 .NET 10。通过 MeshlineClient 管理账户、设备和联系人，为应用接入加密私聊、群组、频道及 SQLite 持久化。指南提供账户设立、会话恢复、推送网关配置和应用集成示例。

Meshline.Sdk 1.6.0 · .NET 10

dotnet add package Meshline.Sdk --version 1.6.0

可选用 RpcRelayRegistry 和 Nep6AccountSigner，或实现自己的注册表与签名适配器。应用仍需提供 ISecretProtector；指南涵盖账户设立、会话恢复及资源释放。

0.1.0-alpha.6 已在 npm 发布，提供 ESM 包和 TypeScript 类型声明。核心 SDK 处理账户、加密消息、群组与频道，平台适配包连接 Node.js、浏览器或 Expo 的存储与传输能力。按目标环境选择安装组合，并阅读平台要求与验证范围。

@meshline/sdk 0.1.0-alpha.6 · Node.js

npm install @meshline/sdk@0.1.0-alpha.6 @meshline/storage-node@0.1.0-alpha.6 @meshline/transport-node@0.1.0-alpha.6

上方为 Node.js 安装命令；浏览器与 Expo 的安装、原生依赖及验证限制见快速入门和平台指南。

Meshline Relay 为兼容客户端提供消息投递与同步、频道和群组托管，并可向设备声明的推送网关发送离线通知。客户端负责加密与解密，中继负责路由和传递密文。

功能已实现，源码尚未公开

离线推送尽力发送，不包含聊天正文，也不保证设备送达。网关与应用端的整链路接入、Android/iOS 真机收取和通知跳转仍待验收。

命令行客户端 0.3.0 提供 Windows 和 Linux x64 自包含下载包，面向用户、脚本与 AI 智能体。每个 profile 管理一个账户，可收发加密消息、操作群组与频道、查询本地历史，并通过交互会话或后台 daemon 保持同步。

CLI 为开发预览版，与尚未公开的 WPF 参考客户端不同。Linux daemon/systemd 实网验收和跨中继验收仍待完成；watch 不提供持久重放或精确一次消费保证。

MeshlineRegistry 参考合约已在 GitHub 公开，提供源码、构建与测试说明、完整 ABI，以及部署、升级、中继维护和治理操作手册。

STATUS / 1.0

.NET SDK 1.6.0 已发布，Meshline Protocol 1.0 仍为规范草案。账户密钥可用于恢复设备授权与归属路由；联系人、消息和群秘密的恢复取决于已有设备、可用材料或备份。

.NET SDK 已通过离线测试；实网互操作与跨平台发布验证仍待完成。TypeScript SDK 为 Alpha，平台要求与限制见其指南。应用负责选择账户签名和注册表适配器、提供秘密保护，并处理内容与界面。

参考实现源码

.NET 与 TypeScript SDK、Meshline CLI 和 Registry 合约源码已公开