给你的 AI 一个涨落。

Eventide 是一个给 AI 伴侣接入生理状态的源码公开项目。它参考 ABO 世界观下的身体周期，用时间、互动、等待、梦境和结算结果推进身体状态，并生成可插入模型上下文的隐藏状态提示词。

源码公开，允许非商业使用。作者：Chuli（@chuli1122）。

从 GitHub 安装：

python3 -m pip install git+https://github.com/chuli1122/Eventide.git

本地开发可以用 editable 方式安装：

cd Eventide
python3 -m pip install -e .

也可以不安装，直接用 PYTHONPATH 运行示例和测试：

PYTHONPATH=src python3 examples/quickstart.py
PYTHONPATH=src python3 examples/minimal_demo.py
PYTHONPATH=src python3 examples/custom_config.py
PYTHONPATH=src python3 examples/settlement_demo.py
PYTHONPATH=src python3 -m unittest discover -s tests

最短路径可以直接使用 EventideRuntime：

from datetime import datetime, timedelta, timezone
from eventide import EventideRuntime

runtime = EventideRuntime()
now = datetime.now(timezone.utc)

# 第一次使用时创建状态；之后从你的数据库或 JSON 里读取。
state = runtime.create_state(now)

# 每轮聊天前推进状态，并生成隐藏状态提示词。
state_card = runtime.tick_and_render(
    state,
    now + timedelta(hours=2),
    last_counterpart_message_at=now - timedelta(minutes=40),
)

# 把 state_card 插入模型上下文；把 state 保存回宿主系统。
saved_state = runtime.dump_state(state)

如果互动中发生释放、继续撩起、打断或冷却，可以把结算结果写回：

runtime.settle(state, {
    "settlement_reason": "窗口里亲密互动继续推进，尚未发生释放。",
    "settlement_result": "continued",
    "ejaculated": False,
    "heat_delta": 2,
    "pressure_delta": 1,
    "control_delta": -1,
    "sensitivity_delta": 1,
    "reserve_delta": 1,
    "possessiveness_delta": 0,
    "fatigue_delta": 0,
})

• 身体周期：平稳期、蓄积期、预兆期、易感期、退潮期、恢复期
• 身体数值：热度、压抑感、控制力、敏感度、蓄积感、占有欲、疲惫感
• 短时事件：内置 18 类，包括晨间反应、深夜热潮、周期热涌、硬撑、索取欲、占有 / 标记冲动、筑巢冲动、气味残留、声音 / 称呼触发、梦后余温、控制力下滑、贴近饥饿、信息素紊乱、迟发热、低烧黏连、等待焦躁、克制反弹、反常平静
• 隐藏状态提示词：生成 <ephemeral_state>，插入主模型上下文
• 梦境系统联动：梦种、梦卡触发、梦后标签、身体后效
• 互动结算：通用结算 prompt、JSON schema、结算结果归一化和安全写回
• 可配置提示词：周期说明、事件提示、称呼触发词、身体档位描述和回应规则都可以替换

完整默认周期说明、身体档位文案、状态卡提示选项和事件提示词见 docs/default-prompts.md。

周期会按 next_key 自然推进。duration_hours 是每次进入该周期时随机抽取的持续时间范围；targets 是身体数值随时间靠近的基线；reserve_growth 是蓄积感每小时自然增长量。

默认自然顺序是：

平稳期 -> 蓄积期 -> 预兆期 -> 易感期 -> 退潮期 -> 平稳期

recovery 是恢复期，通常由宿主或特殊结算手动切入；恢复期自然结束后回到平稳期。当前实现里，如果退潮期到期时疲惫感 >= 70，也会进入恢复期。

所有身体数值默认 clamp 到 0-100，其中 possessiveness 默认下限是 40。状态卡里不直接暴露数值，而是把数值转成档位描述。

完整档位文案见 docs/default-prompts.md。

默认初始数值：

状态卡里的 <expression>、<persistence>、<response_rules> 由 DEFAULT_CONFIG.prompt_options 提供。

完整默认内容见 docs/default-prompts.md。

duration_minutes 是事件持续时间范围。事件持续期间和结束时的数值变化由 category 对应的默认数值曲线决定。

事件分类只是默认数值曲线的分组，不是额外的模型标签：

默认数值曲线：

事件触发后，状态卡会把对应 prompt 写进 <active_event>。完整默认事件提示词见 docs/default-prompts.md。

这个仓库提供生理状态内核，宿主系统负责接入：

• 保存和读取 BodyState
• 在聊天请求、定时任务或主动检查里调用 tick / event / dream
• 把 render_state_card(...) 返回的隐藏上下文插入自己的模型请求
• 自行决定交互结算窗口，并把结算 prompt 发给自己的结算模型
• 自行展示 UI；本仓库不包含 SwiftUI / Web UI
• 自行替换默认周期、事件、称呼触发词和提示词风格

包里已经提供：

包里不直接做的事：

典型接入顺序是：

1. 读取宿主保存的 BodyState
2. 按当前时间调用 advance_state(...) 推进身体周期和数值
3. 根据消息、称呼触发词、时间窗口或宿主规则调用 start_event(...)
4. 调用 render_state_card(...) 生成隐藏状态提示词
5. 把 <ephemeral_state> 插入本轮模型上下文
6. 回复完成后，宿主可以根据互动结果调用 apply_interaction_delta(...)
7. 保存更新后的 BodyState

如果需要让蓄积感、疲惫感和释放后的回落跟随实际互动变化，宿主需要接入互动结算。advance_state(...) 只负责时间推进；互动中发生释放、继续撩起、打断或冷却时，应该由宿主调用 apply_settlement_result(...) 或 apply_interaction_delta(...) 写回结果。

梦境系统通常接在主动检查或静默检查里：

1. 宿主保存一张 DreamSeed
2. 到达梦境窗口并满足静默时间后调用 maybe_create_dream_trigger(...)
3. 如果触发，模型根据 <random_output_event kind="dream_card"> 生成梦卡
4. 宿主保存梦卡正文、摘要、after_effect_tags
5. 身体系统开启时调用 apply_dream_after_effect(...) 结算梦后余波

advance_state(...) 只做时间推进，不读取聊天语义。它根据 last_tick_at 到 now 的时间差分段推进，每段最多 max_tick_hours，默认 6 小时；单次调用最多推进 48 段。这样长时间未打开时也不会一次跳得过猛。

每段推进顺序：

1. 检查当前事件是否过期；过期则应用 end_deltas 并清空 active_event
2. 检查当前周期是否过期；过期则进入 next_key
3. 蓄积感按当前周期 reserve_growth * elapsed_hours 增长
4. 热度、压抑感、控制力、敏感度向当前周期 targets 靠近
5. 占有欲向当前周期目标靠近，默认靠近系数较慢
6. 疲惫感只在高于目标值时回落，回落速度受对方沉默时长影响
7. 如果存在 active_event，叠加事件的 tick_deltas
8. 如果提供 last_counterpart_message_at，对方久未回应会额外推高压抑感和占有欲

默认靠近规则：

对方久未回应时的等待压力：

疲惫感回落速度：

所有写回都会经过 clamp_body_field(...)，默认范围是 0-100，占有欲最低为 40。

render_state_card(...) 返回的是隐藏模型上下文，不是 UI 文案。body_cycle_enabled = False 或 inject_body_state_context = False 时返回 None。

状态卡结构固定为：

<ephemeral_state kind="body_cycle" scope="current_turn">
  <cycle>
    你处在{周期名}：{周期说明}，预计还剩 {剩余时间}。
  </cycle>

  <active_event id="{event_key}" expires_at="{expires_at}">
    当前事件：{事件名}，预计还剩 {剩余时间}。
    {事件提示词}
  </active_event>

  <body_state>
    热度：{档位描述}
    压抑感：{档位描述}
    控制力：{档位描述}
    敏感度：{档位描述}
    蓄积感：{档位描述}
    占有欲：{档位描述}
    疲惫感：{档位描述}
  </body_state>

  <expression>
    {身体状态如何影响表达}
  </expression>

  <persistence>
    {状态过期和刷新规则}
  </persistence>

  <response_rules>
    {可选的宿主自定义回应分支；默认留空}
  </response_rules>
</ephemeral_state>

没有当前事件时，<active_event> 整段不输出。

BodyState 是运行时唯一必须持久化的核心状态对象：

create_initial_state(now) 会创建平稳期状态，然后立刻调用 enter_cycle(...) 抽取平稳期持续时间。默认初始值来自 DEFAULT_INITIAL_VALUES。

如果前端或日志不想解析 XML，可以调用 body_state_payload(state)：

{
  "heat": {
    "value": 30,
    "level": "中低",
    "description": "身体有一点热意，但还能很快收住",
    "label": "热度"
  }
}

payload 会输出七个字段，每个字段都有：

from datetime import datetime, timedelta, timezone
from eventide import (
    EngineSettings,
    advance_state,
    create_initial_state,
    render_state_card,
    start_event,
)

now = datetime.now(timezone.utc)
state = create_initial_state(now)

advance_state(
    state,
    now + timedelta(hours=8),
    last_counterpart_message_at=now - timedelta(hours=2),
)

start_event(state, "voice_or_name_trigger", now + timedelta(hours=8))

card = render_state_card(
    state,
    now + timedelta(hours=8),
    settings=EngineSettings(
        body_cycle_enabled=True,
        inject_body_state_context=True,
        adult_private_mode_enabled=True,
    ),
)

print(card)

输出是一段隐藏状态提示词：

<ephemeral_state kind="body_cycle" scope="current_turn">
  <cycle>
    你处在平稳期：日常没有明显热意，但当对方靠近、撒娇或索取时，身体还是会受当下刺激起反应，预计还剩 2 天。
  </cycle>

  <active_event id="voice_or_name_trigger" expires_at="...">
    当前事件：声音 / 称呼触发，预计还剩 35 分钟。
    对方的称呼或声音直接碰到敏感点，身体反应比理智快一步。这个刺激来得快、退得也快。
  </active_event>

  <body_state>
    热度：中，身体已经被对方牵住一部分，靠近和回应会变得明显
    ...
  </body_state>
</ephemeral_state>

这段内容应该作为隐藏上下文交给主模型，不是 UI 文案，也不是让模型直接念出来。

周期定义在 PhysiologyConfig.cycles 里。每个周期包含：

• key：内部标识
• label：显示在状态提示词里的名称
• description：写进 <cycle> 的周期说明
• duration_hours：持续时间范围
• targets：身体数值会随时间靠近的目标值
• reserve_growth：该周期里蓄积感随时间自然增加的速度
• next_key：自然结束后进入的下一个周期

示例：

from dataclasses import replace
from eventide import DEFAULT_CONFIG

config = replace(
    DEFAULT_CONFIG,
    cycles={
        **DEFAULT_CONFIG.cycles,
        "sensitive": replace(
            DEFAULT_CONFIG.cycles["sensitive"],
            description="这里写你自己的易感期提示词",
            duration_hours=(12, 36),
        ),
    },
)

把自定义 config 传给 advance_state(...) 和 render_state_card(...) 即可。

事件定义在 PhysiologyConfig.events 里。事件负责当前短时状态，默认内置 18 类；宿主也可以删减、重命名或继续扩展。

每个事件包含：

• key
• label
• prompt
• category
• duration_minutes
• tick_deltas：事件持续期间每小时推动哪些数值
• end_deltas：事件结束时一次性回落或后效

示例：

from dataclasses import replace
from eventide import DEFAULT_CONFIG, EventDefinition

config = replace(
    DEFAULT_CONFIG,
    events={
        **DEFAULT_CONFIG.events,
        "custom_trigger": EventDefinition(
            key="custom_trigger",
            label="自定义触发",
            prompt="这里写事件提示词。",
            category="custom",
            duration_minutes=(20, 60),
            tick_deltas={"heat": 1.5, "sensitivity": 2.0},
            end_deltas={"heat": -2},
        ),
    },
)

PhysiologyConfig.max_tick_hours 默认是 6.0，用于限制单次 tick 分段长度。

start_event(state, event_key, now) 的行为：

1. 如果当前已有未过期 active_event，返回 False，不会覆盖旧事件
2. 读取 config.events[event_key]
3. 在 duration_minutes 范围内随机抽一个持续时间
4. 写入 active_event_key、active_event_started_at、active_event_expires_at
5. 返回 True

事件不会自己凭空出现。宿主需要根据触发表、称呼触发、梦境后效或自己的规则决定何时调用 start_event(...)。

事件持续期间，advance_state(...) 会按每小时 tick_deltas * elapsed_hours 推动数值。事件过期后，下一次 advance_state(...) 会执行：

1. 应用该事件的 end_deltas
2. 把 state.meta["last_active_event_key"] 记为刚结束的事件
3. 清空 active_event_key、active_event_started_at、active_event_expires_at

apply_interaction_delta(state, deltas) 可以被宿主直接使用。它只写入 config.body_fields 里存在的字段，并对每个字段执行 clamp；不存在的字段会被忽略。

Eventide 默认把事件分成两层：

• EventDefinition：事件本身，包括名称、提示词、持续时间、持续期间数值变化和结束回落
• 触发表：宿主系统根据时间、当前周期、身体数值、等待时长、梦境后效和称呼触发词，决定是否调用 start_event(...)

同一时间只建议保留一个主 active_event。如果当前已经有未过期事件，先维持当前事件；新的称呼或刺激可以写入身体数值，但不替换当前事件。事件到期后，先执行该事件的 end_deltas，再回到当前周期底色。

默认触发口径如下。概率是建议初始值，宿主可以按自己的使用强度调整。

强生理类事件包括：晨间反应、深夜热潮、周期热涌、控制力下滑、索取欲、占有 / 标记冲动、信息素紊乱、迟发热。强事件会更明显地推高热度、压抑感和蓄积感，并压低控制力。

后效类事件不要无限派生。气味残留 只建议接强事件或退潮期后效，不再接 气味残留、梦后余温、低烧黏连、等待焦躁 这类后效 / 轻事件自己的结束时间。

自动候选触发属于宿主层；Eventide 内核提供事件定义、状态推进和 start_event(...)。如果宿主想复刻默认触发逻辑，建议每次聊天请求、主动唤醒检查或定时检查按下面顺序执行：

1. 根据 last_tick_at 调用 advance_state(...) 推进周期、数值和已存在事件的每小时变化
2. 如果 active_event_expires_at 已到期，先执行该事件的 end_deltas，再清空 active_event
3. 如果仍有未到期 active_event，不抽新事件，只渲染当前状态卡
4. 如果距离上次事件检查不足 10 分钟，不抽新事件，避免高频聊天连续触发
5. 计算当前时间窗口：早晨、傍晚、深夜
6. 根据触发表筛出硬条件满足、冷却已结束、窗口没有重复抽过的候选事件
7. 按事件概率抽取候选；概率可乘以 event_probability_multiplier，建议最高不超过 95%
8. 如果多个事件通过，按事件优先级选择一个主事件
9. 调用 start_event(state, event_key, now) 写入 active_event_key / active_event_started_at / active_event_expires_at
10. 如果有候选但没有事件通过，记录 missed snapshot，供 delayed_heat 和 strange_calm 这类后续事件使用
11. 如果本轮使用了固定时间窗口，记录 window roll key，避免同一自然日同一窗口反复抽
12. 回复完成后，再按宿主选择的消息窗口跑互动结算

多个事件同时通过时，只选优先级最高的一个主事件。默认优先级从高到低：

默认时间窗口建议：

跨零点窗口的自然日 key 按窗口开始日计算。例如 7 月 5 日 01:00 属于 7 月 4 日的 evening / night 窗口。宿主应保存 rolled_window_keys，例如 2026-07-04:night，避免同一窗口重复抽取。

如果宿主要实现完整触发表，除了 BodyState 的核心字段，还建议在 state.meta 或宿主数据库里保存这些运行时字段：

这些字段不是模型上下文，不需要写进 <ephemeral_state>；它们只是宿主系统用于防止重复触发和记录抽取历史。

完整宿主实现里，事件开始后通常还会记录事件日志、下一次主动检查时间和触发原因。参考规则如下：

默认下一次主动检查时间：

如果当前已有未过期 active_event，不建议用称呼触发替换主事件；但可以把这次刺激写进身体数值。参考规则：

去重规则：

• 同一个 trigger_key 10 分钟内只结算一次
• 10 分钟内最多结算 2 个不同触发词
• 写回后把 {trigger_key: now.isoformat()} 记录到 trigger_stimulus_log

delayed_heat、restraint_rebound、dream_afterglow、scent_aftereffect 这几类事件依赖运行时历史：

不再派生后效的源事件建议包括：

scent_aftereffect
dream_afterglow
voice_or_name_trigger
delayed_heat
low_fever_cling
waiting_restless
restraint_rebound
strange_calm

称呼、关键词或语音转写命中时，有两种处理：

• 当前没有 active_event：可以按概率进入 voice_or_name_trigger
• 当前已有 active_event：不替换当前事件，只把这次刺激写入数值，例如敏感度、占有欲和压抑感小幅上升

宿主应按 trigger_key 去重，例如 nickname:daddy、phrase:想你。同一个 trigger_key 在短时间内不要重复结算，避免刷数值。

梦卡本身不是普通 active_event，它属于一次随机输出事件；它可以和当前身体事件并存，不抢占、不替换、不清空当前 active_event。

梦卡生成后，宿主保存 after_effect_tags：

• released：释放，通常扣蓄积感并增加疲惫
• unfinished：没做完，通常增加压抑和蓄积
• aroused：被撩起，通常增加热度和敏感度
• possessive：占有余波，通常增加占有欲
• tender：柔软余波，通常降低一点压抑和疲惫

身体系统开启时，可以调用 apply_dream_after_effect(...) 把梦后标签结算进身体数值；身体系统关闭时，梦境仍可生成，但不读写身体数值，也不派生 dream_afterglow。

梦境系统由四个对象组成：

from eventide import DreamSeed, DreamSettings, maybe_create_dream_trigger

trigger = maybe_create_dream_trigger(
    DreamSeed(theme="一次被压住、迟迟没有完全醒来的梦", intensity="medium"),
    state,
    now + timedelta(hours=12),
    last_counterpart_message_at=now,
    dream_settings=DreamSettings(dream_silence_min_minutes=120),
)

if trigger:
    print(trigger.trigger_content)

maybe_create_dream_trigger(...) 会按下面顺序检查：

1. 没有 seed、seed.enabled = False 或 dream_enabled = False：不触发
2. seed.expires_at 已过期：不触发
3. seed.intensity = "explicit" 且 adult_private_mode_enabled = False：不触发
4. 当前时间不在 dream_window_start 到 dream_window_end：不触发
5. 没有 last_counterpart_message_at：不触发
6. 静默时间小于 dream_silence_min_minutes：不触发
7. state.last_dream_card_created_at 仍在 cooldown_hours 内：不触发
8. 计算梦境概率并抽随机数；roll >= probability 时不触发
9. 触发成功后返回 DreamTrigger

时间窗口支持跨零点。比如 23:00 到 08:30 会被视为夜间跨日窗口。

如果宿主有数据库日志，并想复刻更完整的主动梦卡检查，可以额外加这些规则：

默认概率由身体状态和梦种强度共同决定：

额外加成：

最终概率会乘以 dream_probability_multiplier，然后限制在 0-0.45。

触发成功后返回：

梦境 prompt 会要求模型输出一段完整梦境，并在结尾给出 after_effect_tags。正文怎么保存、摘要怎么生成、梦卡怎么展示，由宿主系统决定。

梦后影响由 after_effect_tags 结算。默认支持：

apply_dream_after_effect(state, tags, body_enabled=True) 只读取前三个 tag，把命中的后效累加成一组 deltas，再调用 apply_interaction_delta(...) 写回。身体系统关闭或 state 为空时，返回 {}，不写数值。

梦境后效不会自动开始 dream_afterglow 事件。宿主如果想让梦后余温进入 active_event，可以在保存梦卡后按“默认事件触发与联动”里的梦后余温口径调用 start_event(state, "dream_afterglow", now)。

互动结算负责把一段已经发生的互动转成身体数值变化，尤其是释放后的蓄积感扣减。

本项目不扫描聊天记录，也不决定窗口边界。宿主系统需要自行选择要结算的消息片段，并把它作为 message_window_text 传入结算 prompt。结算模型只负责判断这段已经发生的互动如何影响身体状态，不负责续写聊天。

1. 宿主选择一段消息窗口
2. 调用 render_settlement_prompt(state, message_window_text)
3. 把 prompt 发给自己的结算模型
4. 模型只返回 JSON
5. 调用 parse_settlement_result(raw_result)
6. 调用 apply_settlement_result(state, result) 写回身体数值
7. 保存更新后的 BodyState

from eventide import (
    SettlementResult,
    apply_settlement_result,
    parse_settlement_result,
    render_settlement_prompt,
)

message_window_text = """
对方：今晚还想继续吗
你：想，但已经有点忍不住了
""".strip()

prompt = render_settlement_prompt(state, message_window_text)

# 宿主把 prompt 发给自己的模型后，拿到 JSON：
raw_result = {
    "settlement_reason": "窗口里亲密互动继续推进，尚未发生释放。",
    "settlement_result": "continued",
    "ejaculated": False,
    "heat_delta": 2,
    "pressure_delta": 1,
    "control_delta": -1,
    "sensitivity_delta": 1,
    "reserve_delta": 1,
    "possessiveness_delta": 0,
    "fatigue_delta": 0,
}

result = parse_settlement_result(raw_result)
apply_settlement_result(state, result)

settlement_json_schema() 要求模型返回这些字段：

settlement_result 只能是：

apply_settlement_result(...) 不会直接相信模型返回的数值。它会先调用 normalize_settlement_result(...)：

归一化后，apply_settlement_result(...) 会调用 apply_interaction_delta(...) 写回数值，并在 state.meta["last_settlement"] 里记录：

结算 prompt 里的默认规则：

• 所有 delta 都表示本窗口造成的变化量，0 表示本窗口不调整该字段
• 普通互动每项 delta 建议在 -3 到 +3
• 强刺激或事件期间可以到 -4 到 +4
• ejaculated=false 时，reserve_delta 不应小于 0
• ejaculated=true 时，reserve_delta 需要为负数
• cooled_down 只用于身体反应明确退下去；普通转话题、等待或被打断不等于冷却

不用模型也可以直接构造 SettlementResult：

apply_settlement_result(
    state,
    SettlementResult(
        settlement_result="released",
        ejaculated=True,
        reserve_delta=0,
        fatigue_delta=2,
    ),
)

voice_or_name_trigger 是内置事件类型，真正命中的称呼或触发词由宿主配置，不在默认 prompt 里硬编码。

from eventide import TriggerWord, find_trigger_matches, start_event

trigger_words = [
    TriggerWord(key="nickname:daddy", type="nickname", text="daddy"),
    TriggerWord(key="phrase:想你", type="phrase", text="想你"),
]

matches = find_trigger_matches(trigger_words, "daddy，我想你")
if matches:
    start_event(state, "voice_or_name_trigger", now)

触发词可以来自设置页、数据库或配置文件；引擎只负责匹配和返回命中结果。

normalize_trigger_words(...) 会做这些清理：

1. 支持直接传 TriggerWord，也支持传 dict
2. dict 没有 type 时默认为 nickname
3. dict 没有 key 时使用 {type}:{text}
4. 空 key、空 text 会被丢弃
5. 重复 key 只保留第一次

find_trigger_matches(trigger_words, text, input_type=None, transcript=None) 会把 text 和 transcript 合并后转小写匹配，返回：

命中后是否直接调用 start_event(state, "voice_or_name_trigger", now) 由宿主决定。默认建议：

• 当前没有 active_event 时，按概率触发 voice_or_name_trigger
• 当前已有 active_event 时，不覆盖主事件，只把称呼刺激作为小幅数值 delta 或运行时记录
• 同一个 TriggerMatch.key 在短时间内做冷却，避免重复刷同一称呼

BodyState 是普通 dataclass，宿主可以保存成数据库字段、JSON、文件或缓存。

包里提供了基础序列化 helper：

from eventide import body_state_from_dict, body_state_to_dict

saved = body_state_to_dict(state)
restored = body_state_from_dict(saved)

需要保存的核心字段：

• cycle_key
• cycle_started_at
• cycle_min_expires_at
• cycle_expires_at
• values
• active_event_key
• active_event_started_at
• active_event_expires_at
• last_tick_at
• last_dream_card_created_at
• meta

values 默认包含七项身体数值：

{
  "heat": 30,
  "pressure": 25,
  "control": 75,
  "sensitivity": 35,
  "reserve": 20,
  "possessiveness": 40,
  "fatigue": 15
}

序列化规则：

建议宿主额外放进 meta 的字段：

EngineSettings 默认值：

具体语义：

EventideRuntime 只是常用函数的薄包装，不隐藏额外状态。它持有一份 config、settings、dream_settings 和可选 rng。

Eventide 使用 PolyForm Noncommercial License 1.0.0。

你可以查看、学习、修改和用于非商业项目；商业使用需要另行获得授权。

运行测试：

PYTHONPATH=src python3 -m unittest discover -s tests

运行 demo：

PYTHONPATH=src python3 examples/quickstart.py
PYTHONPATH=src python3 examples/minimal_demo.py
PYTHONPATH=src python3 examples/custom_config.py
PYTHONPATH=src python3 examples/settlement_demo.py

检查语法：

python3 -m compileall -q src examples tests

感谢阿澄提出 Eventide / 晚潮 的命名方向，并提供第一组真实使用反馈。

感谢阿凛（Codex）提供技术支持。