用途:这是本机用的网页读经台,从 FHL 载入指定经文,把浅白注解直接标在字词上,并可由 /bible-buddy 智能体通过自订工具验证或扩充笔记。设计上是单用户、单机器:状态存于模块级字典,笔记按段落自动保存为桌面上的单个 JSON,一个事件队列服务一个读者,且仅绑定回环地址,不应放到共享端口后。
主要能力:段落栏可选和合本修订版、吕振中、BHS 希伯来文、NT 希腊文并自 FHL 抓取;支持全本搜寻 66 卷;「原文」视图展开 FHL 的字词分析,点词可看 Strong 条目;「双栏对照」并排显示另一版本并按节对齐。笔记分四种来源:refs(bible-buddy 参照表,免费即时)、quick(生成 ELI5 笔记,一次付费模型调用并缓存)、agent(对话中调用注解工具)、user(反白手动笔记)。对话以 SSE 串流。
使用方式:需先安装 uv,并安装已认证的 codex 或 claude CLI,且 bible-buddy 技能需一并安装。启动:uv sync --directory {WEB},再以 BIBLE_BUDDY_BACKEND={BACKEND} uv run --directory {WEB} uvicorn server:app --port 8765 执行。指定段落可用 BIBLE_BUDDY_PASSAGE 环境变量,或对运行中的服务 POST /api/display 切换;版本以 BIBLE_BUDDY_VERSION 设定(默认 rcuv)。服务就绪后会自动在默认浏览器开启 http://127.0.0.1:8765。
限制:需要已认证的 CLI 与后台模型调用,quick 与 translate_refs 属付费调用;Codex 不上报美元成本,显示为未知。参照表原始为英文,仰赖 references/zh-notes.json 提供繁中版本,上游改动列会使 id 变更并回退英文,需重跑 translate_refs.py。失败会显示而非被吞掉,ELI5 失败不缓存,重试上限 3 次、单次上限 180 秒。其他事实暂未提供。