把 Nonlinear Calendar 接进 AI · MCP 接入指南

怎么装 · 空 key 就能问

• 今天节奏怎么样？
• 今晚要不要提前睡？
• 今天哪个时辰适合深工？
• 这个月势能怎么样？
• 这个月叠的是哪一年？

产品名 Nonlinear Calendar。装包搜 balance-engine——官方 Registry 搜这个词，或直接贴 npx -y balance-engine-mcp。不要去 Registry 搜 Nonlinear Calendar。

同一天问两次，模型会编出两个干支；这个引擎不会。空 key 就能问下面五句。只有「我今天 / 我这个月」才要账号。

对外怎么说（复制即可）

同一天问两次，模型会编出两个干支；这个引擎不会。不是算命 bot，是确定性时间坐标。装包：Registry 搜 balance-engine，或 npx -y balance-engine-mcp。空 key 先问今天节奏、今晚睡不睡、哪个时辰深工、这个月势能、这个月叠哪一年。

该不该装

• 该装：你会拿 AI 问何时运动、今晚睡不睡、这个月该打磨还是该收、这个月叠哪一年；讨厌每次「今日运势」都不一样
• 先别装：你要算命对答、诊断用药、食疗方案、广告投放，或只想订网页日历（去 calendar.html 即可）
• 先免费：公开天时零密钥、不烧 token；个性化时间表才要自己的账户

产品名是 Nonlinear Calendar（非线性日历）。品牌仍是 Balance Engine——能量节奏的调节引擎。养生问法走进来：问「今天什么时候适合运动」「今晚要不要提前睡」「这个月势能怎么样」「这个月叠的是哪一年」——它查这台规则引擎，答节奏、能量、势能、对照年。同一天答案不变，也不烧 token。调节 ≠ 灌能。预演 ≠ 预测。不是食疗，不是诊疗。

通过 MCP 接到 Claude Desktop、Cursor 或任何兼容客户端。客户端里的名字是 nonlinear-calendar。密钥留空就能试公开工具（含 time_fold）。觉得有用、要问「我今天」或「落在我哪一运」，再开账户。只给作用关系与动作建议，不断言吉凶。

这是什么

• 对人：Life OS——问今晚早不早睡、今天什么时候适合运动、这个月该打磨还是该收
• 对公司：问公司这段时间运行状态如何——这周该不该硬上、该推还是该收（组织节奏的晴雨表，不是绩效考核表）
• 对小宠物：问狗子这段时间身体状况如何——同一套东历 × 西历，出生日 / 领养日叠上去。还没出现，还在做。

这是一套个性化的生活体系工具。MCP 不是多一个聊天入口，而是把两套已经算好的时间坐标插进 Agent：东历（干支、节气、流月、日柱、时柱）和西历（月相、逆行、过境、日食）。同一天两套都查到，再交叉成做 / 不做。

「解读」不是模型在想。L1 不调大模型，只做查表、公式、阈值。日子进引擎，柱算出来，天象取出，句子是规则写死时就编好的。同一天、同一时区，答案不变。AI 只负责把查到的事实说成人话。没有 AI 仍能解读，是因为意思写在规则里。

非线性日历怎么读、对照年怎么用，见流月笔记 非线性日历。

这次更新

• 显示名：Nonlinear Calendar · 安装命令未改
• 查表戳：source: rules-engine · Asia/Shanghai · as_of · 预演 ≠ 预测
• 今日 / 本月直接带折叠年；空 key 只能用免费工具

客户端显示名改为 Nonlinear Calendar（配置键 nonlinear-calendar）。npm 包仍是 npx -y balance-engine-mcp，已经贴出去的配置还能用。

问今天 / 这个月，就会带上折叠年（丙申 = 2016 丙申）。先问你那年经历过什么，系统不编故事。要十二行表再调 time_fold。要「落在我哪一运」才走开通、填生日。别人怎么问、怎么对后面几个月、团队怎么对表：见 非线性日历 · 别人怎么用。

三步接入

• 装包 — 把下方配置贴进 Claude / Cursor，BALANCE_API_KEY 先留空
• 开新对话试五问 — 「今天节奏怎么样？」「今晚要不要提前睡？」「今天哪个时辰适合深工？」「这个月势能怎么样？」「这个月叠的是哪一年？」
• （可选）变成自己的时间表 — 开通后在 join.html 生成密钥，再问「我今天」

前两步零密钥。问「我今天 / 我这个月」才需要账户——那是个性化时间表，不是按次加价。

配置模板（复制即可）

Claude Desktop / Cursor 的 MCP 配置：

{
  "mcpServers": {
    "nonlinear-calendar": {
      "command": "npx",
      "args": ["-y", "balance-engine-mcp"],
      "env": {
        "BALANCE_API_KEY": ""
      }
    }
  }
}

密钥先留空就能试公开天时。开通后再把 be_… 填进去。Cursor 项目也可写在仓库 .cursor/mcp.json。配置后把 MCP 开关打开，等变绿，再开新对话。

工具一览

• today_rhythm — 「今天节奏 / 今天势能 / 今天干支」（免费 · 本地 · 已含本月折叠年）
• body_rhythm — 「今晚早不早睡 / 该不该加练 / 此时辰动不动」（免费 · 本地）
• energy_adjust — 「能量怎么调 / 该推还是该收」（免费 · 本地 · seat=personal 或 org）
• activity_window — 「今天什么时候适合运动 / 深工 / 休息」（免费 · 本地 · 运动用 task=train）
• month_brief — 「这个月势能怎么样 / 该打磨还是该收 / 哪天发布」（免费 · 本地 · 已含本月折叠年）
• time_fold — 「这个月叠的是哪一年 / 甲午月对应哪一年」（免费 · 本地 · 不写故事）
• sky_window — 「未来两周天象 / 新月日食哪天」（免费 · 本地）
• personal_day — 「我今天 / 未时基调」（需密钥；hour 如 14:30 或 未）
• personal_month — 「我这个月 / 哪周推进」（需密钥 · 日主 × 月干 + 沙盘）
• 小宠物生命线 — 「狗子这段时间身体状况如何」· 还没出现，还在做，没有对应工具

试「agent 味」可以问：今天什么时候适合运动；这个月叠的是哪一年；结合这个月势能安排下午。看 agent 是否把引擎输出当事实底座来推理。公司运行可先用 energy_adjust（seat=org）。狗子那问现在问了也没有工具。

MCP 和日历是同一条协议

我们提供确定性节律节点：Agent 用 MCP 调，日历用 ICS 订。两条都是「别人调你」，不是再开一条销售线。网页日历见 calendar.html。

怎么验收（可复制）

• 这层不用 AI：干支、流月、天象来自规则引擎，不经过大模型
• 同一天、同一时区（Asia/Shanghai），模型会编出不同干支；本引擎输出固定
• 年柱、流月以引擎为准：不要用 1 月 1 日或农历月名口算
• 公开天时免费、不烧 token；「我的时间表」走年订账户，不是按次算命
• 预演 ≠ 预测：只给作用关系与做/不做，不断言吉凶

公开对照集（引擎真值，可上 Hugging Face）：仓库 eval/date-hallucination/。

收费怎么算

先装再决定：MCP 包与公开天时免费，也不烧 token——因为这层不用 AI。个性化时间表记账到既有年订（个人 ¥365 / 公司 ¥3,650）。密钥只是账户的 agent 通道，不另收费。

官方 MCP Registry 搜 balance-engine 或 io.github.singularitybpjade/balance-engine。Cursor / Claude 从这条货源或下游目录搜到。

WorkBuddy / CodeBuddy：插件 → MCP 服务器 → 配置 MCP，把上面同一段贴进 ~/.workbuddy/mcp.json，今天就能用。要出现在腾讯 MCP 市场卡片里，等他们重新开放第三方上架——官方 Registry 不会自动同步过去。

扣子 / Dify 等可导入静态 OpenAPI：openapi-agent.json。

更完整的产品说明见 使用说明；非线性日历怎么读见 非线性日历；日历订阅见 calendar.html。