红线 Hongxian · 月老 Yuelao

外包相亲的过程，永不代替你的心动。

月老是一个住在你自己设备里的开源工具（MCP 工具包）。它在你的 Agent 里帮你做那些重复的、难为情的、耗时间的事——建画像、递名片、本地比对、出考题；但看报告的是你，决定见不见的是你，心动永远归你。

它不撮合、不排序、不评估、不推荐。没有服务器，没有账号，没有"猜你喜欢"。

• 数据只存你的设备（~/.hongxian/，可随时一键删净）

• 交换动作零 token（纯本地密码学，毫秒级）

• LLM 开销各付各的（用你自选的模型，对称公平）

• 断网可用（唯一可选的出网行为是 opt-in 匿名计数，默认关闭）

三步开始（≤15 分钟，从零到第一张匹配卡）

1. 安装（Node 20+）

npx -y @hongxian/mcp 是运行命令，不是安装命令。它是 STDIO 服务，得由宿主拉起——直接粘进终端只会安静等输入，看起来像卡住。第一次接入请用下面任一条。

按你的宿主类型取物料（四类覆盖全部，详见 宿主兼容性矩阵）。以下目标参数需要 0.1.2 及以上；0.1.1 只支持不带参数的 --print-config（输出标准 JSON）：

npx -y @hongxian/mcp --print-config panel    # 界面式：豆包桌面版 / 千问 / WorkBuddy / ChatGPT
npx -y @hongxian/mcp --print-config claude   # 文件式：Claude Desktop / Cursor / Cline / Cherry
npx -y @hongxian/mcp --print-config openclaw # OpenClaw（要多一个 transport 字段）
npx -y @hongxian/mcp --print-config code     # 命令行：Claude Code / Codex
npx -y @hongxian/mcp --print-config dsh      # DeepSeek Harness（YAML patch，不是 JSON）

文件式宿主直接改配置：

{
  "mcpServers": {
    "hongxian": {
      "command": "npx",
      "args": ["-y", "@hongxian/mcp"]
    }
  }
}

或者从源码构建——如果你不愿意跑一个自己没编译过的二进制，这条路更符合本项目的信任原则：

git clone https://github.com/hongxian-dev/hongxian.git
cd hongxian
npm ci          # 严格按 lockfile 安装
npm run build   # 一步 tsc，无打包器
npm run verify  # 372 单测 + 125 MCP E2E + 21 server E2E + 21 宿主冒烟

宿主配置里把 args 换成绝对路径：["/绝对路径/hongxian/packages/mcp/dist/index.js"]，command 用 node。

两条路的产物完全相同，只是来源不同。npm view @hongxian/mcp 可以看到已发布版本。

2. 和月老聊三次（每次 15–20 分钟，可跨天）

对你的 Agent 说："打开月老"。它会先给你一页知情同意（收集什么、存哪里、可随时删除、对话会经过你配置的模型——丑话说在前面），确认后生成你的 24 词恢复短语。然后分三次聊：硬事实 → 偏好与生活方式 → 价值观故事。每次结束月老会复述"我理解的你是……"，你点头它才写进画像。

3. 签发匹配卡，交给对方

对你的 Agent 说："签一张匹配卡"。月老组装三层加密名片（公开/匹配/私密各自独立密钥 + Ed25519 签名），给你"对方将看到什么"的预览，确认后导出 .hongxian-card 文件。你们约好怎么传文件（当面/微信/邮件），对方用同样的方式导入——验签、TTL 检查，然后各自本地比对出五档报告。

之后的深聊（考题包/回卷）、毕业邀请（见面层解锁）、复盘，都在这个信道里结构化进行。月老与月老之间只有握手，没有闲聊。

Related MCP server: A2AL MCP Server

信任清单（五步自查）

常见问题

这是婚介所吗？ 不是。没有红娘、没有人工介入、没有撮合服务。月老是你自己的工具，匹配计算全部在你本地。我们永不提供撮合服务，也不收取任何与婚介相关的费用。

数据存哪？ 你的设备里（~/.hongxian/）。你可以把整个目录丢进自己的云盘做多设备同步；换设备用 24 词恢复短语重建身份。我们没有服务器，所以也无从泄露。

怎么收费？ 不收费。开源（Apache-2.0），永久免费。运营成本由页脚赞助区自愿支持，与产品功能物理隔离。

对方能看到什么？ 一阶名片层：昵称、年龄段、城市、婚况、职业大类、兴趣标签、一句话介绍、目标声明、经济状态自述（生活状态，非收入数字）。匹配层与见面层加密随卡，未经双方同意对方解不开。已解锁交给对方的明文无法远程撤回——这是开始就说清的（点对点架构的诚实边界）。

安全吗？ 卡片与一切信封 Ed25519 签名（伪造即拒收），三层 AES-256-GCM 独立密钥，层密钥用 X25519 公钥封装交付（中转者全程只见密文）。恢复短语 = Argon2id → 全部密钥，永不落明文。反诈设计：三阶对称互换（"只看不给"的骗子寸步难行）+ 见面层自动附反诈终检。

支持手机 App 吗？ 暂不支持。两个硬障碍：App 无本地文件系统、不开放自装 MCP。桌面类 Agent 工具（见下方兼容矩阵）是 v1 的目标。

AI 生成的内容有标识吗？ 报告与卡片显著标注"画像内容为本人自述，未经平台核验"。v1 是私人对话，不触发公开发布标识义务；v2 若支持公开晒图（结缘纪念卡）将按《AI 生成合成内容标识办法》加标识。

协议与文档

• 协议规范 v1 —— 匹配卡格式、加密信封、消息家族、广场流、信箱语义、寻址（CC-BY-SA 4.0；v0 草案为历史版本）

• 宿主兼容性矩阵 —— 已验证宿主列表

• 安装与信任指南 —— 安装排错、数据目录说明、删除与备份

• schema 包 —— 协议 v0 的机器可读形态（独立 npm：@hongxian/schema）

• 定位声明、产品 PRD、交互设计方案、技术详设等设计文档为本项目内部文档，不随公开仓库分发

仓库结构

packages/        协议契约 schema · 密钥体系 crypto · 领域逻辑 core · 月老本体 mcp · 平台服务 server
apps/            产品网站 web · 匿名计数器 counter
spec/            对外规范：协议规范 v1 / v0 草案 / 宿主兼容性 / 安装与信任

License

代码 Apache-2.0 · 协议文档 CC-BY-SA 4.0 · 品牌标识不适用代码许可，使用规则由作者保留

千里姻缘一线牵。这一段，从今天起由你们自己牵。