一个私人离线助手，用于选择任务、采取下一个行动、关闭未完成的循环以及在开始漂移之前审查你的方向。地球游戏使用 Python 的标准库和 SQLite。它没有第三方依赖、账户、外部请求、评分或 AI 生成的建议。 **要求** - Python 3.8 或更高版本 - 类 Unix 终端 **快速开始** ```bash ./earth init ./earth character edit ./earth quest add ./earth quest list ./earth quest start 1 ./earth today ``` **喜欢浏览器吗？** 以本地仅用的 web 界面开始同样的应用： ```bash ./earth web ``` 它会在 http://127.0.0.1:8765/ 上打开一个私密会话 URL，并使用与 CLI 相同的数据库。使用 Ctrl-C 停止。它从不绑定到你的局域网或发出外部请求。 **命令** 提示缺少的文本。选项亦支持非交互式使用： ```bash ./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` 启动本地浏览器 UI。使用 `--no-open` 或通过 `--port PORT` 选择端口。 **典型循环** ```bash ./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` 以使用其他路径： ```bash EARTH_GAME_DB=/path/to/earth.db ./earth init ``` 数据库和 JSON 导出在 Unix 上以私有权限创建。地球游戏不发出外部网络请求；web 命令只在本地环回地址上监听，并要求在启动时打印的私密会话 URL。要备份或恢复，请在没有运行任何 Earth Game 命令时复制 SQLite 数据库。`./earth --help` 打印确切的活动数据路径。 **测试** ```bash 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 以获取产品决策和未来更改的规则。