skorotkiewicz/earth-game

来源：https://github.com/skorotkiewicz/earth-game

Earth Game

Earth Game：一个带有发光任务路径的连接星球

Python 3.8+（https://www.python.org/） 依赖项：标准库 存储：本地 SQLite 网络：无外部请求

一款私密、离线的伴侣应用，用于选择任务、执行下一步行动、关闭未完成事项，并在偏离方向前回顾你的路线。

Earth Game 使用 Python 标准库和 SQLite。它没有第三方依赖项、账户、出站请求、评分或 AI 生成的建议。

系统要求

• Python 3.8 或更新版本
• 类 Unix 终端

在 Arch Linux 上安装

Earth Game 可通过 AUR（https://aur.archlinux.org/packages/earth-game）获取：

yay -S earth-game

安装后，从任何位置运行 earth 或 earth-game。

快速开始

./earth init
./earth character edit
./earth quest add
./earth quest list
./earth quest start 1
./earth today

更喜欢浏览器？以仅限本地的 Web UI 方式启动同一应用：

./earth web

它会在 http://127.0.0.1:8765/ 上打开一个私有会话 URL，并使用与 CLI 相同的数据库。使用 Ctrl-C 停止。它永远不会绑定到你的局域网或发出外部请求。

命令会提示输入缺失的文本。选项也支持非交互式使用：

./earth quest add \
  --title "与老朋友重新联系" \
  --next "给 Sam 发条消息" \
  --pillar connection \
  --driver purpose

./earth quest start 1
./earth today

运行 ./earth --help 或 ./earth COMMAND --help 查看完整界面。完整实际操作示例请参阅 USAGE.md。

命令

• earth init 创建本地存储，不会覆盖现有数据库。
• earth character show|edit 管理价值观、优势、摩擦点、目标和反愿景。
• earth quest add|list|start|done|drop 管理任务。一次只能有一个当前任务。
• earth loop add|list|close 捕获并关闭未解决的任务或关注点。
• earth today 显示当前任务、下一步行动、未完成事项计数和回顾状态。
• earth review 记录五条简短反思。传递 --update-quest 可将 --next 的回答设为当前任务的下一步行动。
• earth export [PATH] 将所有数据导出为可读 JSON。从不覆盖现有文件。
• earth web 启动本地浏览器界面。使用 --no-open 或通过 --port PORT 选择端口。

典型循环

./earth loop add --text "预约牙医"
./earth today
./earth quest done 1
./earth review
./earth export earth-export.json

数据与隐私

默认数据库位于：

${XDG_DATA_HOME:-$HOME/.local/share}/earth-game/earth.db

设置 EARTH_GAME_DB 使用其他路径：

EARTH_GAME_DB=/path/to/earth.db ./earth init

数据库和 JSON 导出在 Unix 上以私有权限创建。Earth Game 不发出任何外部网络请求；web 命令仅监听本地回环地址，并需要启动时打印的私有会话 URL。

要备份或恢复，在没有任何 Earth Game 命令运行的状态下复制 SQLite 数据库。./earth --help 会打印确切的当前数据路径。

测试

python3 -m unittest -v
python3 -m py_compile earth earth_core.py earth_web.py

结构

• earth 包含 CLI 解析和终端交互。
• earth_core.py 包含 SQLite 和共享领域操作。
• earth_web.py 包含本地 HTTP 服务器和 HTML 界面。

产品决策和未来更改规则请参见 ROADMAP.md。