EN README

基于链式时延协议（CTDP）理论的自控力训练工具，通过"神圣座位原理"、"下必为例原理"和"线性时延原理"帮助用户建立强大的习惯链条。支持 Web（PWA）、桌面端（Windows/macOS/Linux）和移动端（iOS/Android），由 Tauri v2 驱动原生体验。

详情请见：https://www.zhihu.com/question/19888447/answer/1930799480401293785

你也可以在知乎上阅读此README：https://zhuanlan.zhihu.com/p/1932530006774505748

• tauri-desktop / tauri-mobile 首次启动默认进入 本地模式。
• 当检测到 Supabase 配置时，会出现一次非阻塞提示卡，可选“继续本地模式”或“连接云端同步”。
• 设置页可随时在 本地模式 和 云端模式 间切换。
• 切换仅更换数据源，不做自动导入、导出或合并。
• 虚拟宠物数据在两种模式下都只保存在本机，不参与多端同步。

Momentum基于Edmond在知乎上提出的链式时延协议（Chained Time-Delay Protocol, CTDP）理论，通过数学模型解决自制力问题：

$$I = \int_{0}^{\infty} V(\tau) \cdot W(\tau) d\tau$$

其中：

• V(τ) 是未来价值函数
• W(τ) 是权重贴现函数

通过指定特定的触发动作（如"戴上降噪耳机"、"坐到书房书桌前"），创建一个"神圣座位"。一旦触发这个动作，就必须以最好的状态完成专注任务。每次成功完成任务，链条记录增长（#1 → #2 → #3...），形成强大的心理约束力。

当面临疑似违规行为时，只能选择：

• 判定失败：链条清零，从#1重新开始
• 判定允许：该行为永久加入例外规则，未来必须一律允许

这种"判例法"机制防止破窗效应，让规则边界收敛到最理性的状态。

通过"预约链"解决启动困难：

• 设定预约信号（如"打响指"）
• 预约后必须在指定时间内开始主任务
• 利用时间延迟降低启动阻力

https://momentumctdp.netlify.app/

1. 点击"创建第一条链"或"新建链"
2. 设置链名称（如"学习Python"）
3. 选择神圣座位触发动作（如"戴上降噪耳机"）
4. 设定任务时长
5. 配置预约链设置：
   • 预约信号（如"打响指"）
   • 预约时长（如15分钟）
   • 预约完成条件（通常与主链触发器相同）

1. 在任务卡片上点击"预约"
2. 执行预约信号（如打响指）
3. 在预约时间内完成预约条件
4. 自动进入专注模式

1. 点击"开始任务"
2. 执行神圣座位触发动作
3. 进入全屏专注模式

4. 专注完成设定时长

当需要中断任务时：

1. 点击"中断/规则判定"
2. 描述具体行为
3. 选择处理方式：
   • 判定失败：链条清零
   • 判定允许：加入例外规则

任务组允许你将多个相关任务组合在一起，按顺序循环执行。

1. 点击"新建任务组"
2. 设置任务组名称和描述
3. 配置时间限制（可选）
4. 设置重复次数
5. 添加子任务单元

• 循环执行：子任务按顺序执行，完成后自动进入下一个
• 时间限制：可设置整组的总时间限制
• 重复控制：每个子任务可设置独立的重复次数
• 进度追踪：实时显示当前进度和剩余任务

递归稳态迭代协议（Recursive Steady-state Iteration Protocol）是一套个人规则管理系统，帮助你建立和维护生活中的各种规则。

• 国策节点：代表一条生活规则或习惯
• 层级结构：规则可以有父子关系，形成规则树
• 每日限制：默认每天只能添加一条新规则，避免过度承诺
• 违规回滚：违反规则时，该节点及其所有子节点将被删除

1. 进入 RSIP 视图
2. 创建根节点或子节点
3. 设置规则标题和描述
4. 可选配置计时器
5. 日常遵守规则，建立稳定的生活秩序

完成任务可以获得奖励，培养你的专属虚拟宠物。

1. 🥚 蛋 (Lv.1-9)
2. 🐣 幼崽 (Lv.10-24)
3. 🐥 幼年 (Lv.25-49)
4. 🐤 少年 (Lv.50-74)
5. 🐔 成年 (Lv.75-99)
6. 🦅 长者 (Lv.100)

• 饥饿度：随时间增加，需要喂食降低
• 快乐度：随时间降低，完成任务可提升
• 健康度：受饥饿和快乐影响
• 经验值：完成任务获得，升级后进化

为任务增加额外的激励机制。

• 任务开始前可以押注积分
• 成功完成任务获得奖励
• 设有每日押注上限
• 仅在 Supabase 云同步模式下可用

误删的链条可以恢复。

• 删除的链条移入回收站
• 可随时恢复或永久删除
• 自动清理过期项目

完整的数据管理功能。

• 导出所有链条、历史记录、RSIP 节点、例外规则
• 支持增量合并导入
• 智能处理 ID 冲突
• 支持本地和云端模式

• Node.js 20.19+ (or 22.12+)
• npm 或 yarn
• 桌面/移动端构建额外需要：Rust 工具链（rustup.rs）
• 启用 Supabase 云端模式时需要配置：
  • VITE_SUPABASE_URL
  • VITE_SUPABASE_ANON_KEY

1. 克隆项目

git clone https://github.com/KenXiao1/momentum.git
cd momentum

2. 安装依赖

npm install

3. 启动开发服务器（Web）

npm run dev

4. 启动桌面应用（Tauri）

npm run tauri dev

5. 构建生产版本

# Web 版本
npm run build

# 桌面安装包（Windows/macOS/Linux）
npm run tauri build

谢谢赞助者们的支持！我会继续努力哒 (≧▽≦)ゞ💖

• 旅行青呱

本项目采用 GPL-3.0-only license 许可证 - 查看 LICENSE 文件了解详情。

• 链式可嵌套工作单元（任务组）

  • 支持将多个任务组合成任务组
  • 循环执行、时间限制、重复控制

• 开箱即用的预设

  • 触发器模板和辅助信号模板
  • 中英文双语支持
  • 例外规则预设
  • still working

• RSIP 实现（递归稳态迭代协议）

  • 完整的个人规则管理系统
  • 层级结构、每日限制、违规回滚

• 虚拟宠物系统

  • 6个成长阶段，100级成长系统
  • 饥饿度、快乐度、健康度属性
  • 任务完成奖励机制

• 押注模式

  • 可选的任务激励机制
  • 积分系统和每日限制

• 回收站

  • 软删除机制
  • 恢复和永久删除功能

• 导入/导出

  • 完整数据备份与迁移
  • 增量合并支持

• 桌面端原生应用（Tauri v2） — Windows/macOS/Linux
• 移动端原生应用（Tauri v2） — iOS/Android（进行中）
• 更多宠物外观和动画
• 社交功能（排行榜、好友系统）
• 更详细的统计分析面板

如有问题或建议，发送邮件至：xiaofucheng1@gmail.com
我的知乎账号：https://www.zhihu.com/people/blues-68-53
我的个人网站：https://kenxiao.netlify.app/