管理端配置名称、language=en、version=3.0、来源、format=wordnet-3.0-zip,上传 ZIP 并启用/停用。服务器不按输入 URL 下载或读取任意本机路径。导入限压缩32MiB/解压128MiB,验证完整结构及来源摘要;失败保留原可用资源;相同内容重复导入不重复资源或词条。
schema v4 独立共享资源表保存元数据、ZIP 与摘要(单一英语资源槽),事务提交后切换;进程按摘要缓存只读词典,重启可从 MySQL 恢复,备份不增加外部文件依赖。显式迁移,不改变已有用户/书籍/章节/任务。
Go 生成覆盖原文的 word/space/punctuation 片段,保留 cp、UTF-16 偏移和原文 SHA,片段拼接必须等于 originalText;点击范围由后端验证,不依赖浏览器自动 NLP。已有文章无需改写即可点词。
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
来源与目标
2026-09-10 用户确认 F01–F12、原型通过,并要求按四阶段建议推进。原型验收:#1 评论 7498。阶段 3;覆盖 F05 查词、F06、B03。
管理员配置并导入已验证英语资源,学习者点击正文词语查看本地释义,关闭后继续阅读。
验收标准
依赖与执行
前置:#5, #3, #4。状态:已通过用户验收,PR #25 已合入 main(见验收评论)。前置尚未通过时不得标进行中;每单完成停在待验收,由用户验收后关闭。技术验证可与不依赖其结论的工作分工,但不提前冻结未验证契约。
参考模块与设计证据
SysConfig 表单、SysDict 列表样式、角色/API 权限和迁移;新建独立语言资源模型,不能把系统枚举当自然语言词典。
简单列表/配置沿用 go-admin,字段清单即可;若引入多步资源安装/重试流程,补关键状态原型后实现。
后端不为建表/API 单独画页面原型;先写数据、接口、状态、隔离与幂等契约。学习端采用 #1 已验收 v1,未做的 LinguaCafe 对照不标完成。
工作量、范围与风险
预计 5~8 人日(8 小时/人日),包含本单设计、前后端实现、相关测试、修正和文档;是规划估算,不是交付日期或 AI 运行时间。仅 F 范围,X 系列不纳入。数据变更先在隔离测试库验证迁移/回退,保留既有数据和原型。
文档与证据
实施时按影响更新 Architecture-and-Code-Map、Business-Rules-and-Glossary、Local-Development-and-Verification;需求变化更新 Product-Requirements-Overview,交付单补实际部署恢复文档。Wiki 先写再回读同步;结束评论记录测试、未验证内容、提交及 revision。工单正文保留基线,重要变化追加评论。
Gitea MCP 指向其他站点,沿用目标 git.ilapage.cn API 回退;凭据仅进入进程。
#6 全 Go 方案与实施启动(2026-09-11)
用户明确确认“1,全go;2,更新;3,赞同”:正式 NLP/查词采用全 Go,更新本单方案,从 main 建分支实施,完成后独立审核并交用户验收。前置 #3/#4/#5 已验收,相关 PR 全部合入 main b18f9cc;本单分支 feat/6-go-dictionary-lookup。
目标:管理员导入共享英语词典,学习者在本人已就绪章节点词查看释义并继续阅读。管理列表/表单沿用 go-admin;查词面板沿用已验收 v1,桌面侧栏、手机下方面板;无需重新制作整套原型。
方案与契约
实施与验证计划
风险/回退:词形候选没有上下文消歧能力,必须如实呈现;词典 ZIP 导入内存/体积有硬上限且保留当前可用版本。v4为新增资源表,回退停API恢复旧二进制和schema标记3,保留新表、不删除既有数据;先在 lexgo_test_ 专用库验证。本单初始估算仍5~8人日,为规划值不是实际耗时。
文档影响:Project-Profile D03、Architecture-and-Code-Map、Business-Rules-and-Glossary、Local-Development-and-Verification、Product-Requirements-Overview 更新全 Go 决策与正式接口;#3 历史实验记录保留。
Gitea MCP 已核实连接其他站点,本次沿用目标 git.ilapage.cn API 回退;凭据仅从已有安全配置进入进程。
#6 全 Go 实施完成,独立复审通过,待用户验收(2026-09-11)
用户授权与方案见评论7719。实现分支 feat/6-go-dictionary-lookup 从 main
b18f9cc创建;方案文档提交8310438,实现提交 ad31ea4225f9220be6a191af92378f6050170ff6;已推送。PR #25,未合并,工单不关闭。实现与审查
实际验证
主审真实API使用 admin/src/session.mjs 的实际multipart方法经5174代理导入并查验,学习请求经5173代理:固定WordNet3.0资源id1,155287个词形/词性索引项;重复导入id不变;坏ZIP失败且原资源仍可用;停用返回resource_missing,重复导入重新启用。issue5_a/issue5_b各创建一本文本相同的虚构测试书(book3/4、chapter8/9),验证Dogs/went/Mice/Dog精确与候选、emoji/组合字符/CRLF/Tab原文拼接、跨账号章节404、普通用户管理API403。测试会话均退出,无其他用户书籍修改。
开发库显式3→4迁移,升级前后六张既有表计数一致:sys_user6、spaces6、sessions13、books2、chapters7、jobs7(以上是新增本轮fixture之前的计数)。旧Go二进制备份在忽略的.local/lexgo-pre-issue6.exe。仅重启lexgo-api与lexgo-learner,未重启无关服务。当前8000健康检查与两端入口200。学习端曾因常驻Vite未加载Vue插件/代理导致空白,重启加载既有配置后修复,默认E2E再次通过,无配置改动。
未验证与边界
文档
更新AGENTS与README;Wiki及同步镜像revision:
f317e21d651f2b5cb66810e9a4abf02831908559935630005c9b1d7103550cf09eb10edfdbf8f3afbbd6e618f4339aa45d81bba0492045b60581a735445504a7f95f9c018216f74e27d433edde521f73099f1c803ffb69edc3fe07582d22dcf9a57647a1241fa63d8141ed9f1992421346d42f9b87453b0a资源manifest与许可证位于server/wordnet-resource.json和server/WORDNET-LICENSE.txt;未提交ZIP、账号密码或测试数据库数据。Gitea工具回退原因沿用本单:MCP连接不同站点,目标API凭据仅从安全配置读取。
用户验收与合并收尾
验收时间:2026-09-11 14:47:30 +0800(Asia/Shanghai)。用户在当前会话明确确认“#6通过验收”。结论:#6 验收通过,关闭工单;按本轮约定合并 PR #25。
PR #25 已 fast-forward-only 合入 main,功能提交
ad31ea4225与用户验收版本一致。验收状态文档提交33182e584b已推送,保留功能分支;未增加产品范围或数据库变更。需要撤销时可在新工单中使用 revert,不改写历史。合并前重新验证:Go/MySQL/真实 WordNet 26 项、学习端 53 项、管理端 31 项测试通过,无跳过;合并后核对功能提交不变,文档 check --strict 与 sync --verify 通过。先前完整交付证据见评论 7725,不重复覆盖。真机触屏详细证据及完整备份恢复验证缺口保留;个人释义与状态持久化仍归 #7,本次不实施。
长期文档仅更新工程验收状态:Project-Profile、Architecture-and-Code-Map、Home 已在线回读并同步镜像;README 同步更新。Wiki revisions:
Gitea MCP 仍指向其他站点,沿用已记录的目标 git.ilapage.cn API 回退,凭据仅在进程中使用。