已确认：DevHarness 轻量模式、MySQL 8、go-admin 管理端。工程基础 #2 已通过验收：两端用户名登录、学习账号管理、可撤销会话和本人英语空空间。管理端基于指定 go-admin/go-admin-ui 选用模块，学习端为独立 Vue 3 + TypeScript + Vite 工程，共用 Go 后端和 MySQL 8.4.3。#18 登录日志与操作审计已通过用户验收，支持管理员查询和 90 天保留清理。阅读、导入、词典与复习尚未实现。MVP 定位为“支持多账号、数据独立的自托管学习工具”，先邀请少量用户使用；F01～F12 已确认，X 系列后置。

文档入口 · 线上 Wiki
项目档案 · 需求总览
工作量估算：#2 验收后原范围剩余 46～75 人日，新增 #18 的 3～5 人日计划后为 49～80 人日；技术验证后重估，旧全量研究仅供参考。
四阶段实施总览 #16：14 张单元工单，工程基础 → 技术验证 → 首条学习闭环 → 补齐 MVP；原型 v1 已获用户验收。两端使用账号（用户名）＋密码登录，不要求邮箱。
原型工单 #1：Quant-UX 桌面/手机原型 v1，预览入口与审核记录见工单及需求总览。
工作流 · 开发与验证

本地工程基础

运行前在 MySQL 8 中准备项目专用空库，复制 .env.example 为忽略的 .env.local 并填写本机连接及初始管理员密码。首次执行 python scripts/server.py migrate、python scripts/server.py bootstrap；随后执行 python scripts/server.py serve。两端分别通过 npx --yes pnpm@9.15.1 --dir admin dev、npx --yes pnpm@9.15.1 --dir learner dev 启动，首次需安装锁定依赖。

本地入口：学习端 http://127.0.0.1:5173，管理端 http://127.0.0.1:5174。完整安装与测试命令见开发与验证。账号使用用户名，无需邮箱；没有随代码交付的默认密码。

本机三个服务已由 D:/supervisord/supervisord.conf 中的 lexgo-learner、lexgo-admin、lexgo-api 托管，使用时不要重复手动启动同端口。当前 schema v2；从 #2 升级时停止 API，执行 build、migrate 后再启动。审计过期清理可执行 python scripts/server.py audit-cleanup，只影响超过 90 天的日志。

文档与治理

远端为 https://git.ilapage.cn/OPC/lexgo.git，默认分支 main。需要工单的任务以 Gitea 工单为单次任务事实来源；轻量直接实施项通过 Git 提交和结果报告留痕。长期规则以 Wiki 为主源，docs 为单向镜像；默认不创建任务归档。

新项目接入顺序：创建 Gitea 远端仓库并推送当前引导提交，启用工单和 Wiki；优先使用已配置的 Gitea MCP。Home 不存在时先创建并回读 Home，再逐页发布并读取 revision，最后运行下列验证。本地 docs/ 的存在不能证明线上 Wiki 已初始化。

python dev_scripts/harness.py sync --verify
python -m unittest discover -s tests -v

预期同步/严格检查成功且治理测试全部通过。产品验证另见开发与验证页面，治理测试不代表学习业务已实现。当前 MCP 指向另一 Gitea 站点，本轮回退目标站点 API，原因与证据边界见初始化记录。凭据只使用安全配置或环境变量，不写入仓库。

README.md Unescape Escape

LexGo

本地工程基础

文档与治理

README.md