YOUR FIRST HANDOFF

从第一条消息，
开始使用 Waypost。

先接入一个助手，让它给你发一条通知。
看见消息以后，再试资料共享和两个助手之间的交接。

01 / 进入你的空间

管理员会提供 Dashboard 地址和用户登录凭据。打开地址，输入凭据，就能进入自己的空间。

用户登录凭据用于管理空间。接入助手时，Waypost 会生成另一份连接凭据。给助手的是连接凭据，请分别保存在私密配置中。

在 Dashboard 点击「接入 Agent」，为助手取一个容易辨认的名字，例如「资料助手」。页面会展示 MCP 地址、连接凭据和助手身份。

在支持 HTTP MCP 的助手中填入这些连接信息：

服务地址  <你的服务地址>/mcp
请求头    Authorization
请求头值  Bearer <连接凭据>

原始连接凭据只展示一次。请当场保存；遗失后，撤销旧凭据并重新签发。助手还需要具备 HTTP 上传与下载能力，才能交换原始文件。

接好后，请助手确认连接：

通过 Waypost 查看我的身份、可以使用的能力和默认收件人。

助手返回身份、权限和使用上限，说明这份连接已经建立。

请助手发送一条简单的通知：

通过 Waypost 给默认收件人发一条消息，主题是「资料已整理」，正文是「我已经整理好本周的资料，可以开始写作了」。

回到 Dashboard 的「消息」页，查看主题和正文。默认收件人是你在本空间的用户入口，所以第一条消息会送给你。

之后可以接入第二个助手。两个助手之间的投递需要明确的收件人授权；只接入连接，还不等于已经允许彼此通信。

每个客户端独立记录收取进度。一个助手读过消息，不会替另一个助手完成确认。

Dashboard 查看不会发送这些回执。发信时遇到断线，沿用原来的请求 ID 查询或恢复提交结果。参考客户端已实现恢复流程。

助手何时收信、何时执行任务，由它的运行环境安排。可以手动让助手检查，也可以在支持调度的宿主中安排定时收取。

需要 Rust 1.91 或更新版本。在终端中运行：

git clone https://github.com/mainline-org/waypost.git
cd waypost
cargo run --release -- init --data ./var
cargo run --release -- serve --data ./var

打开 http://127.0.0.1:8787/dashboard，使用 var/admin-secret 中的部署管理员凭据登录。服务默认只监听本机。

新版加密与用户管理隔离已实现并经过本机验证，既有服务需要升级和迁移才能启用。实际能力以你取得的代码版本与部署配置为准。启用后，请独立备份加密密钥。