Nonlinear Calendar · balance-engine-mcp

English

Balance Engine = 供 AI Agent 调用的时间与节律确定性计算引擎。 LLM 会在日期边界、节气、时区、周期窗口上幻觉。这个 MCP / API 返回确定结果，并带上计算依据（source: rules-engine）。

npx -y balance-engine-mcp

可转发的一页证据（问题 · 对比 · 样例 · 错误码）：evidence.html

贴进 Claude / Cursor（空 key = 公开工具，本地跑，不用账户）：

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

空 key：today_rhythm · body_rhythm · energy_adjust · activity_window · month_brief · time_fold · sky_window。 空 key 调 personal_day / personal_month → error: personal_timetable_requires_key。

同一天问两次，模型会编出两个干支；这个引擎不会。

Nonlinear Calendar（非线性日历） · 品牌是 Balance Engine。Agent 来调用，不编造。

这也是一套个性化的生活体系工具。MCP 把两套已经算好的时间坐标插进 Agent：东历（干支、节气、流月）和西历（月相、逆行、过境）。同一天两套交叉，再给出做 / 不做。解读是查表交叉，不是生成——没有 AI，是因为意思写在规则里。

产品长文（流月笔记）：非线性日历 · 接入指南：Agent / MCP · Pilot：14 天 Pilot

| 给谁 | 是什么 | |---|---| | 个体的人 | Life OS——睡眠、运动、深工、发布窗口叠在自己的盘上 | | 公司 | 组织节奏的晴雨表（KPI 天气：该不该硬上，不是绩效考核表） | | 小宠物 | 生命线——问狗子这段时间身体状况如何；出生日 / 领养日叠上同一套坐标。还没出现，还在做。 |

养生问法走进来，引擎答节奏、能量、势能：何时做何事、这段时间怎么调、这个月该打磨还是该收。不是食疗，不是诊疗。装上以后直接问：

• 「今天什么时候适合运动？」
• 「今晚要不要提前睡？」
• 「今天节奏怎么样 / 这个月势能怎么样？」
• 「这个月叠的是哪一年？」
• 「团队这周该推还是该收？」
• 「这个月哪几天适合发布？」
• 「未来两周有哪些天象？」

它查规则引擎，同一天答案不变，也不烧 token。不是算命聊天，不是诊疗，不是投放工具。调节 ≠ 灌能。预演 ≠ 预测。

| 该装 | 先别装 | |---|---| | 你会拿 AI 问何时练、何时睡、这段时间该推还是该收 | 你要吉凶断言、诊断用药、食疗方案、算命对答 | | 你讨厌每次「今日运势」都不一样 | 你要素材、投放、买量（那是别的 MCP） | | 想先免费试，不填密钥 | 你只想订网页日历 → calendar.html，不必装 |

密钥留空就能用上面几问。觉得有用、要问「我今天」叠上自己的盘，再开账户。

天时公开，时间表私人。 这层不用 AI：规则引擎，同一天同一答案，不烧 token。公开天时免费；个性化时间表随年订账户（个人 ¥365 / 公司 ¥3,650）。

MCP 和日历订阅是同一条协议：别人调你的确定性节律节点，不是你去卖软件。

官方 Registry：io.github.singularitybpjade/balance-engine —— 搜 balance-engine，不要搜 Nonlinear Calendar。

可选密钥 · 其它客户端

配置在本 README 顶部。空 key 跑通后，再到 join.html 生成 be_… → 填进 BALANCE_API_KEY → 问「我今天」「我这个月」。公开天时仍免费。

Coze / Dify：openapi-agent.json · 14 天 Pilot：pilot.html

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

这是什么 / 解决什么

| | | |---|---| | 是什么 | 给 Agent 用的时间与节律确定性计算引擎；对人仍是 Life OS，对公司是组织节奏的晴雨表 | | 装了干什么 | 让 AI 查东历 × 西历，而不是自己编日子、自己编意思 | | 怎么收费 | 公开天时免费；「我的时间表」随年订账户（¥365 / ¥3,650） | | 不是什么 | 不是食疗 App，不是算命机器人，不是投放 / 增长 MCP |

工具（工作流语言）

| 工具 | 什么时候用 | 密钥 | |---|---|---| | today_rhythm | 「今天节奏 / 今天势能 / 适合签约吗」——姿态 × 松紧 → 做/别；已含本月折叠年 | 免费 · 本地 | | body_rhythm | 「今晚早不早睡 / 该不该加练 / 此时辰动不动」 | 免费 · 本地 | | energy_adjust | 「能量怎么调 / 该推还是该收」· seat=personal\|org | 免费 · 本地 | | activity_window | 「今天什么时候适合运动 / 深工 / 休息」· task=train\|deep_work\|meet\|ship\|rest | 免费 · 本地 | | month_brief | 「这个月势能怎么样 / 哪天发布 / 该打磨还是该收」；已含本月折叠年 | 免费 · 本地 | | time_fold | 「这个月叠的是哪一年」——本年十二流月 = 上一组同序十二年；不写个人故事 | 免费 · 本地 | | sky_window | 「未来两周天象 / 新月日食哪天」 | 免费 · 本地 | | personal_day | 「我今天 / 未时基调」 | 需密钥 | | personal_month | 「我这个月 / 哪周推进」 | 需密钥 |

免费工具零网络；付费工具调服务端 API。每条免费工具标题下有 source: rules-engine · timezone: Asia/Shanghai · as_of。空 key 调付费工具返回 error: personal_timetable_requires_key。输出自带回站链接（from=mcp）。

非线性日历

线性日历把一年拉成一条线。Nonlinear Calendar 把本年十二流月叠回上一组同序十二年：甲午月 ↔ 甲午年。人人同一张表。大运只决定这些年落在谁的哪一运里。

2026-08-18 在丙午年丙申月，对照年是 2016 丙申年。对照年里发生过什么，只有你自己记得。用自己的故事去对接下来的流月，不要编生平。预演，不是预测。

要「这些年落在我哪一运」，才需要生日。那是私人时间表。

长文：非线性日历 · 流月笔记

这次更新（0.1.10 · 2026-08-18）

• Registry / 握手带上 SIN logo（icons）。装包搜 balance-engine，不要搜 Nonlinear Calendar。
• 空 key 五问：今天节奏 / 今晚睡不睡 / 哪个时辰深工 / 这个月势能 / 这个月叠哪一年。同一天问两次，模型会编两个干支；这个引擎不会。
• 显示名 Nonlinear Calendar；npm 仍是 npx -y balance-engine-mcp。
• 免费工具标题下 source: rules-engine / Asia/Shanghai / as_of。今日/本月带折叠年。空 key 调付费 → personal_timetable_requires_key。

验收句（可复制）

• 这层不用 AI。干支、流月、天象来自规则引擎，不经过大模型。
• 同一天、同一时区（Asia/Shanghai），模型会编出不同干支；本引擎输出固定。
• 年柱、流月以引擎为准：不要用 1 月 1 日或农历月名口算。
• 公开天时免费、不烧 token；「我的时间表」叠出生盘，走年订账户，不是按次算命。
• 预演 ≠ 预测：只给作用关系与做/不做，不断言吉凶。
• 调节 ≠ 灌能：算睡眠/负荷/窗口，不算诊断、用药、食疗、绩效考核。对外讲节奏 / 能量 / 势能，不用「频率」。
• MCP 与 ICS 是同一条协议节点：Agent 和日历都可以调。
• 对照集：仓库 eval/date-hallucination/（可上 Hugging Face）。

环境变量

| 变量 | 说明 | |---|---| | BALANCE_API_KEY | 账户密钥 be_…（付费工具；免费可留空） | | BALANCE_ENGINE_API_BASE | 可选，默认 https://balance-engine.vercel.app |

License

MIT