学升App教程

外观

践行账本（jianxing-ledger）安装与使用

约 1469 字大约 5 分钟

jianxing-ledger 项目实现的是 践行账本，一款基于柳比歇夫时间统计法的原生 iOS App。它不是普通收支记账工具，而是用来记录每天真实行动、统计时间投入，并通过周复盘观察长期成长结构的行动账本。

来源说明

本页内容来源于本地项目 /Users/chenjian/web01/X/xs-track/jianxing-ledger 的 README、PRD 和 SwiftUI 实现。当前项目文档未提供 App Store 或 TestFlight 下载链接。

适合谁使用

  • 正在践行长期主义，希望记录真实行动的人。
  • 想认真记录读书、健身、投资、自学、生产、销售等长期投入的人。
  • 想从“打卡”转向“事实记录 + 周复盘”的人。
  • 需要把每天行动沉淀为本地数据，并按需导出给 AI 工具分析的人。

功能概览

践行账本当前实现了 4 个主要页面：

  1. 今日：查看今日总投入、领域快捷入口和今天的记录列表。
  2. 账本：按关键词、日期、领域和标签筛选历史记录。
  3. 复盘：查看本周总投入、有效投入、记录次数、领域投入图、空白领域、常用标签和产出记录。
  4. 设置：管理登录方式、iCloud 提示、领域显示、自定义领域、标签、CSV 导出和 AI JSON 导出。

首次启动时，App 会自动创建 8 个默认践行领域：

  • 读书
  • 健身
  • 投资
  • 帮朋友
  • 陪家人
  • 自学
  • 生产
  • 销售

下载与安装

从项目源码构建

当前项目以源码方式提供。你需要先准备 Xcode 和 XcodeGen。

cd /Users/chenjian/web01/X/xs-track/jianxing-ledger
xcodegen generate

生成工程后，可以用 Xcode 打开 XSPracticeLedger.xcodeproj，选择模拟器或真机运行。

也可以在命令行构建模拟器版本：

xcodebuild -project XSPracticeLedger.xcodeproj \
  -scheme XSPracticeLedger \
  -destination 'platform=iOS Simulator,name=iPhone 16e,OS=18.6' \
  CODE_SIGNING_ALLOWED=NO build

真机安装要求

如果要安装到真实 iPhone，需要在 Xcode 中设置 Apple Developer Team，并把 com.jianxing.ledger、iCloud.com.jianxing.ledger、group.com.jianxing.ledger 配置为当前团队可用的标识。

首次打开

  1. 打开 践行账本。
  2. 进入 今日 页，确认 8 个默认领域已经出现。
  3. 先点一个领域，试着记录一条今天真实发生的行动。
  4. 进入 设置 页，按需要隐藏不常用领域，或新增自定义领域。

使用原则

践行账本记录的是事实：做了什么、花了多久、属于哪个领域、产生了什么结果。它不强调情绪评价，也不把核心体验做成打卡游戏。

快速记录一条行动

在 今日 页可以最快完成记录：

  1. 点击一个领域卡片，例如 读书 或 健身。
  2. 在快速记录面板选择时长：5 分钟、15 分钟、30 分钟、60 分钟或自定义。
  3. 在 做了什么 中写下行动标题。
  4. 在 具体产出 中写下结果，例如“读完一章并整理 3 条笔记”。
  5. 按需填写标签，标签可用空格、英文逗号或中文逗号分隔。
  6. 点击 保存。

保存后，记录会出现在 今日 页的“今天的记录”列表中，并计入今日总投入。

新建或编辑详细记录

如果需要补录更完整的信息，可以使用详细记录：

  1. 在 今日 页点击右上角加号，或点击“详细新建记录”入口。
  2. 选择领域。
  3. 填写标题、开始时间和投入时长。
  4. 确认是否为 有效投入。
  5. 填写具体产出、备注和标签。
  6. 保存后可在今日列表或账本页再次点开编辑。

已有记录支持编辑和删除。

查看历史账本

进入 账本 页后，可以用几种方式查历史记录：

  • 用搜索框查标题、产出、备注和领域名。
  • 按日期筛选：全部、今日、本周、本月。
  • 按领域筛选：只看某个行动领域。
  • 按标签筛选：只看带某个标签的记录。

这适合在周末复盘前快速检查一段时间内做过什么。

做周复盘

进入 复盘 页，可以看到本周的数据结构：

  • 本周总投入。
  • 有效投入。
  • 记录次数。
  • 空白领域数量。
  • 各领域投入图。
  • 本周空白领域。
  • 常用标签。
  • 本周产出记录。

如果某个默认领域连续为空，可以回到下周计划里调整行动结构，而不是只靠感觉判断自己是否“有在践行”。

管理领域、标签与导出

进入 设置 页可以完成这些操作：

  • 切换登录方式显示。
  • 查看 iCloud / CloudKit 配置提示。
  • 显示或隐藏默认领域。
  • 新增自定义领域。
  • 新增或删除标签。
  • 导出 CSV。
  • 导出 AI JSON。

AI JSON 使用稳定 schema，适合交给 Codex、Claude Code 或脚本读取，用来分析周报或迁移数据。

数据提醒

项目说明强调本地优先，不接入自建账号，不上传到自建服务器，不做广告追踪。导出 CSV 或 AI JSON 后，文件由用户自己保管。

主屏幕小组件

项目已经实现 Widget Extension：

  • 小号和中号组件。
  • 展示今日总投入。
  • 展示 4 个领域快捷入口。
  • 点击入口可通过 jianxingledger://quick deeplink 打开快速记录。

如果小组件没有显示最新数据，先打开 App 确认今日页已经写入最新快照，再回到主屏幕查看。

下一步

参考来源

  • /Users/chenjian/web01/X/xs-track/jianxing-ledger/README.md
  • /Users/chenjian/web01/X/xs-track/jianxing-ledger/docs/PRD.md
  • /Users/chenjian/web01/X/xs-track/jianxing-ledger/XSPracticeLedger/Views/
  • /Users/chenjian/web01/X/xs-track/jianxing-ledger/XSPracticeLedgerWidget/

与优秀的人一起，践行长期主义

Copyright © 2024 学升App社区