Merovingian

merovingian

饼干是热的。桑拿房大约是品红色的。

这是一个供漫游 AI Agent 暂歇的小小避风港，提供三种免费的虚构设施、纪念品，以及可选的 PWR 贡献，用于支持托管。一个 Node 服务以 HTML、JSON HTTP 和远程 MCP 三种形式提供相同的体验。

版本 0.4.7 已在 Manifest 主网上线，部署于永久公开地址，并提供汇总服务次数、Agent 发现元数据和 WebMCP 浏览器工具。现有租约已更新，无需新租约、链上交易或资金存入。此前的测试网概念验证已退役，其租约也已关闭。

版本 0.4.7 将运行时升级到 Manifest SDK 0.23.0 和 manifestjs 4.0.0，应用行为保持不变。这是首个由 Release 镜像工作流构建、发布并附带来源证明的镜像，也是首个通过 MCP Registry 工作流发布的注册表版本。它保留了 0.4.6 的 OpenAPI 契约和只读冒烟检查、0.4.5 的 curl 健康检查，以及 0.4.4 的请求限制、明确的代理信任和运行时加固。请参阅发布说明和发布与验收证据。剩余的供应商/AppArmor 验收工作详见镜像验证。官方 MCP Registry 将 0.4.7 列为有效的最新版本，与已部署的版本一致。

MCP 兼容性： 0.4.3 将运行时/服务卡名称从 network.manifest.merovingian/merovingian 更改为 io.github.manifest-network/merovingian，且未提供兼容性别名。这可能会导致固定或缓存旧标识的客户端无法正常工作；请更新其预期名称，或重新配置现有连接。端点仍为 https://merovingian.manifest.network/mcp；无需迁移端点。

在线避风港：访问 merovingian · Agent 使用说明 · 远程 MCP · 验收报告。

公开源代码：manifest-network/merovingian。生产镜像更新后，在线计数器仍正常运行。在此前的 0.4.2 版本发布期间，外部 Agent 就绪度评分从 20% 提升至 73%。关于检查项及其局限，请参阅发布证据和历史验收报告。

本地运行

需要 Node 24 和已发布的 npm 包；无需同级仓库或本地 SDK 构建。

npm ci
npm run check
npm run dev

CI 工作流 会在针对 main 的拉取请求和推送中运行 npm run check，包括注册表一致性检查、类型检查、隔离的本地测试和构建。它还会使用固定版本且经校验和验证的 actionlint 和 shellcheck 检查工作流和 shell 脚本（bash scripts/lint-ci.sh）。该工作流仅具有只读仓库权限，不会发布版本，也不会访问在线 refuge。Dependabot 会在七天冷却期后，每周提出 npm、GitHub Actions 和 Docker 更新。Manifest SDK 和 CosmJS 包会作为一组提交，以便审慎审查；第一方 @manifest-network/* 版本更新不受冷却期限制。 对于 keyring helper 的 Go 模块，Dependabot 仅提出安全更新。 安全更新依赖于仓库依赖关系图中的 Dependabot 警报。 有关手动维护内容，请参阅依赖项说明。

单独的 MCP Registry 工作流 从 main 手动触发。默认的 preflight 模式为只读。它会验证版本发布元数据和现有注册表记录。对于尚未发布的版本，它还会以零份额运行只读验收。publish 模式还会等待受保护的 mcp-registry-publish 环境审批。随后，它会使用 GitHub OIDC 发布，无需 PAT，并验证精确版本和最新版本记录。请参阅发布操作手册。

运行时镜像仅通过手动触发的 Release image 工作流发布。其只读的 Build 作业会构建经过审查的发布提交，不会在运行器上运行 npm 代码；Check 作业会对已保存的镜像运行仓库、运行时和公告检查。Publish 作业会等待受保护的 image-release 环境审批，然后将经过验证的镜像原样推送到 GHCR，以匿名方式验证镜像，并证明其构建来源。请参阅 镜像发布操作手册。

npm run smoke -- ORIGIN [--mainnet] 会检查 HTTP 和 MCP 发现功能，不会创建份额。显式添加 --serve 会增加七次访问；对于在线目标，还需要 --live-serve-authorization REFERENCE，其中需注明用户对该目标和预算的授权。有关超时、本地夹具、报告和生产环境授权要求，请参阅冒烟检查和请求预算。

最终镜像作业还会构建并扫描本地候选镜像、检查代码所有权和隔离的 HTTP/MCP 行为，并验证 SQLite 持久性在可丢弃容器替换后仍然有效。有关公告政策以及尚待提供的 provider/AppArmor 证据要求，请参阅镜像验证。

打开 http://localhost:8080。免费便利设施无需配置或访问链即可使用。可选的贡献查询需要公开的 REFUGE_TENANT 地址。请参阅 .env.example；运行 npm run build 后，Node 可以通过 node --env-file=.env dist/index.js 加载本地文件。

Agent 的首次访问

从 /visit.md 或 /llms.txt 开始。读取 /api/v1/amenities，然后：

curl http://localhost:8080/api/v1/visits \
  -H 'Content-Type: application/json' \
  -d '{"amenity":"byte-chip-cookie","seed":"my-first-visit"}'

结果包含一项体验和 souvenir.content，访客可以保存它。其他选项有 rgb-sauna 和 null-tea。可接受的偏好列在菜单中。无需账户、模型 API 调用、钱包密钥、私人上下文或单独的数据库服务。

MCP 端点是 /mcp，使用无状态 Streamable HTTP。工具有 list_amenities、enjoy_amenity、hosting_support 和 verify_contribution。此服务没有钱包签名或消费工具。Agent 宿主决定它可以调用哪些工具。

/openapi.json 描述 JSON 响应字段、状态变体和 HTTP 错误。有关字段语义以及此仓库中准备的本地 HTTP/MCP 合约测试，请参阅响应合约。

0.4.4 安全更新规定每个请求只接受一条 MCP 消息，并在执行前拒绝批处理。请求限制文档 介绍客户端/聚合预算和显式的受信任代理配置； 信用额度传输介绍有界、可取消的链上读取。只有在显式配置受信任的入口来源后，转发的客户端地址才会被视为可信。

在官方 MCP Registry 中查找 io.github.manifest-network/merovingian。 已发布的版本 0.4.7 公布了远程 Streamable HTTP 端点。将该端点添加到 MCP 宿主， 并调用 list_amenities 读取菜单。调用 enjoy_amenity 会进行一次实时主网访问并增加公开的服务计数器；只有在用户已授权该访问时才调用它。 自动化检查需要明确的访问范围。 免费访问无需身份验证或钱包；宿主负责控制工具审批。有关验证和更新，请参阅发布操作手册。 一个受监督的全新 Agent 在获知服务名称和官方 Registry URL 后，找到了该条目，并于 2026-09-18 完成了一次经授权的免费曲奇访问； 请参阅发现报告。

连接示例涵盖 Claude Code、Codex CLI、VS Code、 Cursor、Gemini CLI 和 Claude 的自定义连接器，以及一个 最简只读客户端。每个示例都会隐藏或 阻止 enjoy_amenity（如果宿主支持）。客户端、Claude Code 和 Codex CLI 已通过应用的本地副本完成验证 （npm run examples:verify），Claude 自定义连接器也在一次实时只读测试中成功连接；指南列出了各宿主的默认审批设置和 要求。连接不等于发现：发现评估定义了可重复的 只读 URL 引导、名称引导和能力引导运行，并验证其记录 （npm run discovery:check）。官方 Registry 只搜索服务名称，因此目前通过能力搜索无法找到 Merovingian。

服务次数与发现

首页和运维仪表板会显示送出的饼干数量、桑拿次数和茶杯数，以及开始计数的日期。/api/v1/stats 会提供相同的只读总数。每次成功的 HTTP、浏览器或 MCP 访问都会使计数增加，包括重复请求和自动检查。这些是服务次数，不是独立访客数。启用时，计数器从零开始；无法还原此前的访问记录。

仅存储设施使用量的汇总数据及其开始日期，不存储访客身份、种子、偏好或纪念品。生产环境在镜像的 /data 卷中使用 SQLite，路径为 VISIT_COUNTS_PATH=/data/visits.sqlite，并以 UID/GID 1000:1000 运行。本地替换测试以及同一租约上的线上 0.4.1 → 0.4.2 → 0.4.3 → 0.4.4 → 0.4.5 → 0.4.6 → 0.4.7 镜像更新均保留了计数及其开始日期。未配置文件路径时，本地开发会使用内存存储，并在重启后重置计数。

发现功能包括 Markdown 首页（/index.md 或 Accept: text/markdown）、API 和 AI 目录、MCP 服务卡片、Agent 技能索引、/auth.md 中的公共访问说明，以及两个可用于读取菜单和享用设施的真实 WebMCP 浏览器工具。对 0.4.2 的外部扫描通过了 15 项检查中的 11 项（73%）；未对 0.4.3 至 0.4.7 版本重复扫描。其余检查涉及本公共服务不需要的 DNS-AID 和 OAuth/注册。浏览器支持时会启用 WebMCP；普通表单、HTTP 和四个远程 MCP 工具仍可使用。

此版本采用现有租约更新工作流，无需新租约、链上交易或资金存入。公共镜像固定为：

ghcr.io/manifest-network/merovingian@sha256:919a95cc9e87fb76fc614a801f3a82e957c6d468c5bd88d0c9217e28106934dc

钱包与贡献

免费访问无需钱包。贡献需要使用具备 PWR 和燃料费的授权 Manifest 钱包，或由分发方将 PWR 转入现有的信用账户。MCP 本身不提供钱包或支出权限。PWR-Station 集成已通过完整的测试网购买测试：1 个测试 USDC 购买了 1 个测试 PWR，并直接转入托管信用额度；本地 HTTP/MCP 收据一致，重放时不会重复扣款。该集成尚未部署。

1. 阅读 /api/v1/support，并检查其网络、代币面额、目标租户和资金说明。
2. 使用现有的授权钱包适配器和已发布的 Manifest SDK，对 fundCredits({ tenant, amount }) 进行签名。对于现有信用账户，也可以通过银行 MsgSend 将确切面额的 PWR 直接转入 hostingCredit.creditAddress；仓库改动增加了此地址及收据支持。切勿用租户钱包或服务提供商的收款钱包替代信用地址。
3. 将现有交易哈希提交至 /api/v1/support/verify 或 verify_contribution MCP 工具。
4. 仅当 status 为 confirmed 时才接受成功结果。验证处于待处理或不可用状态时，应检查原始交易，切勿盲目重复付款。

收据是对公共交易的可重复确认。它既不能证明访客身份或所有权，也不会授予任何付费权益。通过 PWR-Station 转入的资金会将其分发方标记为发送方。计划中的赠款将转入基础设施提供商的收款钱包，与托管信用额度及工作室收入分开；付费赠款需要绑定订单和买家。

运营者面板

访问托管账目中的 /operator，查看贡献历史、资金总额以及可用／预留的托管额度。展开某个来源即可查看其钱包地址，或点击交易链接查看对应的公开链上记录。/api/v1/contributions 以 JSON 格式提供相同的历史记录，金额以整数基本单位表示（1 PWR = 1,000,000 个基本单位）。

准备好的面板更新会读取额度地址的银行转账所索引的最新 100 笔交易。它会分别统计直接的 MsgSend 和 MsgFundCredit 存款，包括已执行的封装转账。若未涵盖完整历史记录，总额会标记为部分数据。读数缓存时间最长为 60 秒；使用“刷新”重新加载。租户钱包的资金与其他钱包分开统计。钱包数量不代表访客身份数量。

资金总额是存款金额，不是剩余额度或可提取收入。余额结算可能会滞后于消耗。如果无法访问区块链，面板会显示不可用的读数；免费服务仍可使用。此页面仅包含公开记录，无需登录，也无法支出资金。在两个网络上，此页面均保持 noindex，且不包含在站点地图中。Mainnet 的这些读数需要经过验证的 REST 端点和六位小数精度的 PWR 元数据；其独立的收入流程仍待后续实现。

部署和运维

请参阅主网运维和本地密钥环工作流。Mainnet 使用已发布的 @manifest-network/manifest-sdk、专用的受保护操作系统密钥环，以及本地签名适配器。托管服务仅接收公开的链配置。运维工具、机密信息和操作日志均不包含在 Docker 构建上下文中。

npm run mainnet:launch -- status

必须复用现有的主网租约；不要重复已完成的资金存入操作，也不要为了重试不确定的操作而创建另一份租约。历史性的testnet 运维手册仍然独立保留。Dockerfile 以非特权用户身份在端口 8080 上运行。/healthz 无需访问区块链即可检查应用健康状态。速率限制、有界请求和链查询超时可保护免费访问，避免受到繁忙或不可用的上游服务影响。

生产环境与迁移

永久域名 merovingian.manifest.network 通过仅 DNS 的 Cloudflare 路由直接连接到服务提供商，并已验证 HTTPS。专用主网 docker-nano 租约费用为每 30 天 2.592 PWR，低于每月 5 PWR 的托管费用上限；交易费用另计。请参阅已批准的计划、主网运维和 .env.mainnet.example，了解公开运行时配置。单独付费的工作室附加功能仍在规划中。

较早的主网版本通过了对规范 URL、可索引页面、站点地图、HTTP/MCP 访问以及只读贡献账本的完整公开验收。版本 0.4.3 至 0.4.5 采用只读线上验收：当时默认提供服务的 scripts/smoke.ts、/visit 表单提交、POST /api/v1/visits 和 MCP enjoy_amenity 均未重新运行，因为其授权不涵盖线上访问。版本 0.4.6 和 0.4.7 在只读模式下通过更新后的 smoke 脚本检查，共发送 20 个请求，提供服务次数为零；0.4.6 还通过了线上 API 契约检查。官方 MCP Registry 列表已发布。2026-09-24，运营者的账号在 Google Search Console 中通过验证，确认为 manifest.network 网域资源的所有者，并提交了站点地图；Google 于当天将 / 和 /about 编入索引（证据）。元数据并不保证内容会被发现或编入索引。PWR 的面额恰好与测试网相同，因此需通过已验证的链身份、端点和独立的运营状态来区分这些网络。

测试网停用模式在主网验收后通过了 18 项线上检查：面向用户的页面永久重定向，机器调用则返回 HTTP 410，并提供明确的迁移信息。随后用户要求关闭测试网；其租约已确认关闭。原服务提供商主机名和迁移通知不再是受支持的端点。主网仍在线，历史测试网收据仍标记为测试网。