Repository navigation
Releases: luomeii/OpenGloss
Release list
OpenGloss v0.4.0-rc.3 - 发布候选(未完成正式验收)
OpenGloss v0.4.0-rc.3 — 发布候选(未完成正式验收)
⚠️ 这是预发布候选,不是正式稳定版。
安装、更新、恢复机制已实现并通过离线验证;但 全新 Windows、真实浏览器、真实模型与正式 GitHub 更新链仍待验收。
这一版做了什么
核心一致性
- 事务与锁归属连接(新增
db_access/event_batch/health/read_snapshot) - 事件先提交后发布;提交异常时用独立只读连接核对事件 ID,无法确认则隔离实例
- 故障隔离按数据库文件共享;重启是显式恢复边界
- 对话成对保存、事实插入与配额淘汰同属一个事务;超长输入先校验
- TTL 删除绑定
decision_id+expires_at,防止辅助连接误删新参数 - 统计改用受控读快照 + 有界批扫描,保持原 SQL 次序、规则与权重
- 显式配置路径收口;安装实例的配置/人格/密钥不再落回源码目录
安装与更新
- Windows 10/11 x64 自包含 ZIP:内置 Python 3.14 + 14 个固定依赖 wheel + 公开完整词典
- 目标机不需要 Python / pip / Git
Install.cmd负责安装、创建当前用户桌面快捷方式、打开管理页(扩展仍手动加载)- 程序按
versions/分版本保存,数据独立放data/;默认端口 4817,明确拒绝 4814/4815/4816 - 更新只认官方仓库的正式 GitHub Release,含固定资产名、版本次序、HTTPS 来源与 SHA256 校验
- 更新有暂存、数据库一致性备份、pending 日志、健康确认、失败恢复与手动回退
- 同安装重复启动复用已有管理器;跨进程数据所有权锁覆盖引擎退出与备份/恢复窗口
- 新版未确认前业务返回 503,防止确认前接受的数据被随后回退覆盖
文档
- 主 README 重写:以词级阅读辅助为主线,AI 为可选补充,不承诺看一次就记住
- 明确区分源码版与安装包版、端口、模型配置与数据路径
- 补充更新/回退语义、隐私外发与验证边界
已知边界(请先读这段)
- 未做:全新 Windows 安装、真实 Chrome/Edge 扩展验收、夸克兼容、真实模型、正式 GitHub 资产端到端更新、数周耐久或超大历史规模
- 引擎 API 默认无鉴权;页面桥消息可被页面伪造或监听。不要把回环 API 暴露到局域网/公网
- 配置模型后,对话/人格/近期历史/事实卡/相关词汇可能发送给你选择的模型服务;静音不关闭该路径
- LLM key 明文存于本机配置,备份可能包含它
- 诊断接口
/v1/health、/api/status会显示本实例的实际数据路径 - 统计与每日额度按 UTC 换日(中国时区为早上 8 点)
- 历史事件、判重集合与数据库会随使用增长;长期内存与历史规模尚未验收
- 引擎异常退出后需手动重启;不承诺自动崩溃重启
安装包
OpenGloss-windows-x64.zip — 解压后双击 Install.cmd。SHA256 见同页的 .sha256 资产。
不需要目标电脑装 Python / pip / Git。安装版使用 4817 端口,不会占用日用实例的 4815。
源码
本 tag 的 Source code (zip/tar.gz) 即完整源码。源码部署需要 Python 3.10+。
OpenGloss v0.3.1 - newcomer fixes + one-click helpers
Newcomer-environment fixes (15 commits over v0.3.0) plus four optional one-click helpers (quick_start / quick_stop / autostart_on / autostart_off). Dictionary matches v0.3.0 (68,612,096 bytes, sha256 ee73d182b3fa661f...). Usage: git clone this repo, then download dict.sqlite below into resources/ECDICT/.
OpenGloss v0.3.0 · 首个阶段版本
首个阶段版本(stage release)。仓库本体 + 本附件 = 完整可运行,不必再自己下 63 MB 的 csv 构建词典。
附件
dict.sqlite(65.4 MB) —— 构建好的词典。
用法:下载后放进仓库的 resources/ECDICT/ 目录(文件名保持 dict.sqlite),然后按 README 起引擎即可。
| 项 | 值 |
|---|---|
词条 dict_words |
770,611 |
变形映射 exchange_map |
58,158 |
PRAGMA integrity_check |
ok |
| 数据来源 | ECDICT(MIT)· https://github.com/skywind3000/ECDICT |
| 构建方式 | python scripts/build_dict.py --csv resources/ECDICT/ecdict.csv --out resources/ECDICT/dict.sqlite |
| SHA256 | ee73d182b3fa661f71f779dd047d9d59eaff5f9dec2108f73921f68cef18e7a8 |
完整部署(三步)
git clone https://github.com/luomeii/OpenGloss.git && cd OpenGloss
pip install -r requirements.txt
# 把本页附件 dict.sqlite 放进 resources/ECDICT/
cd pae && start_engine.bat # Windows;Linux/macOS 见 README然后浏览器打开 chrome://extensions → 开发者模式 → 「加载已解压的扩展程序」→ 选 pae/extension。
这个版本是什么
被动英语习得引擎:读英文网页时自动标注生词,词汇在真实阅读里自然积累——不背单词卡、不打卡、不测验。
能力面 42 项(41 实现 + 1 项如实标注未实现),HTTP + MCP 双传输;数据全本地(单个 pae.db),零遥测。
已知边界(详见 README「安全」一节):角色壳运行在页面主世界,桥消息可被页面伪造/监听;本地 API 默认无鉴权;悬停时那一句会送去做义项判定(日限 150 次,不配 LLM key 则完全不外发)。
词典数据来自 ECDICT(MIT);其 lemma.en.txt 另带更窄的 research/educational 声明,详见 README「许可」一节。