一款将 CTDP 与 RSIP 方法论软件化的离线优先桌面应用，用于帮助用户把「自控」从模糊意志问题，转化为可触发、可执行、可记录、可回滚、可迭代的协议系统。
Protocol 基于知乎文章《如何提高自制力？》提出的方法论实现。
Protocol 不是一个普通的番茄钟、待办清单或习惯打卡应用。它的核心不是「提醒用户要努力」，而是为用户建立一套能够在关键行为节点上产生约束力，并可在长期生活中递归迭代的自控协议。
它包含两套核心机制：
- CTDP（链式时延协议）：围绕主链和辅助链展开，用于启动正式专注、裁定失败、保留严格的协议边界。通过「神圣座位」「下必为例」「线性时延」三项原理，将自控从意志力问题转化为协议执行问题。
- RSIP（递归稳态迭代协议）：围绕长期稳定规则建立定式树，支持点亮、熄灭、递归回滚与事件历史。通过「国策/定式节点」「国策树」「回滚机制」等概念，帮助用户在无外部压力的日常状态中逐步改善生活整体稳态。
当前版本：v0.3.0（已发布在 master 分支）
所有功能模块已合并到 master，构成完整的离线桌面版本：
| 模块 | 状态 |
|---|---|
| CTDP 主链与辅助链（专注任务、预约启动、失败裁决、判例化） | ✅ |
| 判例库管理（查看详情、编辑、废止） | ✅ |
| RSIP 定式树（节点、点亮/熄灭、递归回滚、单定式复盘） | ✅ |
| 桌面集成（系统托盘、桌面通知、全局聚焦按钮） | ✅ |
| 复盘系统（主链统计、失败模式、判例列表） | ✅ |
| 数据管理（备份/恢复/导出/重置） | ✅ |
| Dashboard 与 History（统一协议时间线） | ✅ |
| 发布质量（CHANGELOG、QA 清单、发布流程） | ✅ |
| 层 | 技术 |
|---|---|
| 桌面框架 | Tauri 2 |
| 前端 | React 19 + TypeScript |
| 路由 | React Router v7 |
| 构建工具 | Vite 8 |
| 后端 | Rust |
| 数据库 | SQLite（通过 rusqlite，bundled 模式） |
| 样式 | 纯 CSS（无第三方 UI 框架） |
| 桌面通知 | tauri-plugin-notification |
| 文件对话框 | tauri-plugin-dialog |
- 创建和管理主链，设置神圣座位触发动作、专注时长、完成条件
- 启动正式专注任务
- 完成任务 → 链长度 +1
- 任务失败 → 正式裁决（违规清零 / 判例化）
- 失败调试记录（触发动作太重、完成条件过高、时间太长等）
- 每条主链内置辅助链配置
- 预约启动（设定延迟、确认窗口）
- 到期后进入确认窗口，可履约进入正式任务
- 确认窗口结束后进入待裁决状态（非自动失败）
- 裁决：辅助链违约清零 / 判例化
- 辅助链拥有独立的当前长度和最佳长度
- 主链判例与辅助链判例统一管理
- 链详情页展示协议边界（合并展示两类判例，标签区分）
- 判例可查看详情、编辑标题/描述、废止
- 废止判例保留历史记录，但不再作为活跃协议边界
- 创建根定式 / 子定式
- 树形缩进展示定式依赖关系
- 点亮（激活）/ 熄灭（停用）定式
- 父节点熄灭时递归回滚活跃子节点
- 定式生命周期复盘面板
- 熄灭时可填写自定义备注
- 可编辑定式标题和执行说明
- 主链复盘：按主链汇总执行指标（完成/失败/判例/预约履约统计）
- 失败模式复盘：按调试类别聚合失败记录，帮助识别协议设计问题
- 判例复盘：浏览全部判例，追溯来源链与关联会话
- 支持按时间周期筛选（7天 / 30天 / 90天 / 全部）
- 查看数据库信息（路径、大小、版本、各表记录数）
- 数据库备份（导出为 SQLite 文件）
- 数据库恢复（从一次性不可变预览恢复，成功后立即生效）
- 备份文件内容检查（显示原文件信息，恢复不再重读原路径）
- 历史数据 JSON 导出
- 历史记录与进度重置（保留链定义和判例库）
- 系统托盘图标与菜单
- 桌面通知（专注任务结束、预约到期等关键节点）
- 通知权限管理
- 全局聚焦按钮（悬浮快捷入口）
- Dashboard 展示 CTDP 摘要与 RSIP 摘要
- 当前协议状态指示（无活动 / 任务进行中 / 待裁决 / 预约倒计时 / 预约确认窗口）
- History 展示 CTDP + 辅助链 + RSIP 的统一协议时间线
- 支持按事件类型、结果筛选
- 默认专注时长
- 默认预约时长
- 辅助链确认窗口时长
- 通知开关与权限管理
Protocol 目前不包含以下功能，且短期内无计划加入：
- ❌ AI 建议 / 智能分析
- ❌ 云同步 / 多设备联动
- ❌ 账号系统 / 登录注册
- ❌ 手机 App（仅桌面）
- ❌ 社区分享 / 社交功能
- ❌ 积分 / 徽章 / 排行榜等游戏化元素
- ❌ 复杂任务编组 / 精锐链 / 储君继承制
- ❌ 国策组容错（后续版本可能加入）
- ❌ 多语言支持（仅中文界面）
- ❌ 自动化 CI/CD 流水线
这些功能并非不重要，而是为了让 Protocol 在当前阶段保持产品边界清晰。
所有数据仅存储在本地，不会上传到任何服务器。
- 数据库文件：系统应用数据目录下的
protocol.db - 数据库引擎：SQLite（WAL 模式，外键约束开启）
- 不依赖任何云端服务
- 不需要网络连接即可正常使用
备份方式：
使用应用内的「数据管理」页面进行备份、恢复和导出操作。
- 应用内检查会把所选备份复制为应用
.restore目录中的一次性不可变预览；确认页仍显示原文件路径和预览统计，但恢复只读取该预览，不会因原路径随后被替换而改变内容。 - 取消、重新选择或执行恢复后会清理一次性预览；异常退出遗留的任务预览和 staging 文件会在后续检查/恢复时按安全期限清理。所选原备份不会被删除或修改。
- 在线恢复会先创建并验证恢复前安全快照，再通过 SQLite Online Backup 切换当前连接的数据；成功后立即生效，所有安全快照都会保留。
- 恢复入口只接受 Protocol 生成的自包含 SQLite 备份，不接受仍在使用的 protocol.db/WAL 文件组合。
- JSON 导出不能直接恢复应用；需要可恢复副本时请使用 SQLite 备份。
- 手工复制 protocol.db 前必须从托盘菜单真正退出 Protocol。仅关闭主窗口会隐藏到托盘，不能安全复制正在使用的 WAL 数据库。
应用数据目录位置：
- Windows:
%APPDATA%/com.kellengo.protocol/ - macOS:
~/Library/Application Support/com.kellengo.protocol/ - Linux:
~/.local/share/com.kellengo.protocol/
- Node.js ≥ 18（推荐 20+）和 npm
- Rust 工具链（通过 rustup 安装）
- Windows：需要 Microsoft Visual C++ Build Tools
- macOS / Linux：需要系统 C 编译器及相关库
npm install# 仅前端（浏览器开发）
npm run dev
# 完整桌面应用
npm run tauri dev# TypeScript 类型检查 + 前端生产构建
npm run build
# 仅 TypeScript 类型检查（不构建）
npm run typecheck
# 轻量检查（类型 + ESLint）
npm run check
# 完整检查（类型 + 构建 + Rust 编译检查）
npm run check:full
# Rust 侧单独检查
cd src-tauri
cargo check
# 构建 Windows 安装包
npm run tauri build- 确保安装了所有环境依赖（Node.js、Rust、VS Build Tools）
- 运行
npm install - 运行
npm run tauri build - 安装包生成在
src-tauri/target/release/bundle/目录下.msi安装包位于bundle/msi/- 便携版
.exe位于bundle/nsis/（如有 NSIS 配置）
src/
components/ 共享 React 组件
lib/db/ 前端数据库命令封装
pages/ 应用页面
styles/ 全局 CSS
types/ TypeScript 类型定义
src-tauri/
src/
db.rs Rust 数据库初始化与迁移
lib.rs Rust Tauri 命令
main.rs 应用入口
Cargo.toml Rust 依赖配置
tauri.conf.json 桌面应用配置
docs/
PRODUCT_SPEC.md 产品规格说明
QA_CHECKLIST.md 质量检查清单
RELEASE_PROCESS.md 发布流程
DESKTOP_INTEGRATION.md 桌面集成说明
PROTOCOL_V2_CURRENT.md 当前状态文档
NEXT_STEPS.md 后续方向
archive/ 历史规划文档
- 确保 Node.js 版本 ≥ 18
- 尝试删除
node_modules和package-lock.json后重试 - Windows 用户确保安装了 Visual C++ Build Tools
- 检查 Rust 是否安装：
rustc --version - 检查 Tauri CLI：
npx tauri --version - Windows：确保已安装 WebView2 运行时
- 运行
cargo check查看 Rust 侧编译错误
- 确保先运行
npm install - 检查
src-tauri/target/目录权限 - Windows 打包 MSI 需要 WiX Toolset（如未安装，Tauri 会提示）
- 查看
src-tauri/target/release/下的构建日志
- 数据库文件损坏：删除应用数据目录下的
protocol.db，重启应用会自动创建新数据库 - 建议定期使用「数据管理」页面进行数据库备份；恢复时仅选择应用生成的自包含 SQLite 备份
- 检查是否有其他 Protocol 实例正在运行
- 尝试删除应用数据目录（注意备份
protocol.db） - 查看系统日志或终端输出中的错误信息
详见：
CHANGELOG.md— 各版本功能摘要docs/RELEASE_PROCESS.md— 发布操作流程docs/QA_CHECKLIST.md— 质量检查清单
docs/PRODUCT_SPEC.md— 产品规格说明docs/DESKTOP_INTEGRATION.md— 桌面集成说明docs/PROTOCOL_V2_CURRENT.md— 当前状态docs/NEXT_STEPS.md— 后续方向docs/archive/— 历史规划文档