# 每日课公网测试包:脱敏整理前后端、作业资源和作业技能 ## 问题背景 daily-lesson(每日课)要放到公网上给人测试。需要把前后端、最近一周作业资源、作业整理分析相关技能整理成一份脱敏的发布包,放到 `docs/competition/prod`。原项目里有人名、家庭局域网 IP、本机绝对路径和默认密钥,数据库里练习页地址指向局域网 IP。 ## 用户对话整理 - 整理 daily-lesson 的前后端 + 作业资源 + 作业整理分析等相关 skill,除去敏感数据:人名 stella、neotao,家庭 ip 及绝对路径、密钥等,用于放到公网上便于测试。 - 最后统一放到 `D:\codes\MyProjects\easy-study\docs\competition\prod` 路径下。 - 提供 shell 运行脚本和 nginx 配置,conf alias 指向当前路径,便可以直接访问。 - 需要包括最近一周作业。作业不需要重新设计,但是需要更新 db 文件中的访问链接,避免局域网和不可用(最好是相对路径,不依赖域名和绝对路径、ip 等)。 - 作业中如果有明显的人名、校名,则识别图片内容并整理为文本,用虚拟名放在作业中。 - 验收标准:ssh neotao@8.152.195.43,将 prod 目录打包到 `~/easy-study` 目录下,并启动 python 后端接口;再打开 chrome 浏览器访问 https://e-study.cn/ 域名下 plan、todo、homework 等链接均可正常访问;mcp 也可以正常测试调用,发送测试作业到日程中。 - 重试下,我密钥配好了。 - 看下 /etc/nginx/conf.d/default/ 下的配置,帮我把服务起起来。现在 https://e-study.cn/ 页面不可访问,服务不知道是否正常。 ## 后续任务步骤 1. 拷贝 daily-lesson 三个页面到 `prod/front`,字体拷到 `prod/front/static/fonts`;`task-detail.html` 的练习链接改为也认相对路径。 2. 拷贝后端到 `prod/backend`:默认用户改成 `demo`,删掉写死的密码和 MCP 密钥,改为环境变量 `LESSON_AGENT_KEY`(run.sh 首次启动生成到 `backend/.env`);练习地址校验接受相对路径;测试同步改。 3. 数据库拷一份到 `prod/backend/data/lesson.db`:用户改名并换随机密码哈希,删掉旧密钥哈希,练习地址 `http://192.168.11.15/homework/...` 改成相对页面目录的 `homework/...`。 4. 拷贝 0901 与 10.26–10.30 的作业目录、相关截图、三科全量清单(只留这一周)到 `prod/homework`。图片引用改成相对路径,task.json 的练习地址改成相对路径。 5. 脱敏作业:美术方案里的校名换成虚拟校名,不带 PDF;1029-02 截图带班级号和手写,不带图,用已有文字转写并改虚拟班级。 6. 拷贝四个技能到 `prod/skills`:去掉本机绝对路径、局域网 IP、代理、默认密钥;脚本默认根目录指向发布包 `homework/`。 7. 写 `run.sh`(install/start/stop/status/nginx/page/test)、nginx 模板(location 版和 server 版)、发布包 README。 8. 用 10.29 语文 task.json 走一遍 push 脚本写进发布包数据库,跑后端测试,起 nginx 和页面实测,最后清掉测试产物并扫一遍敏感字样。 9. 打包上传到服务器 `~/easy-study`,安装依赖、跑测试、启动后端,生成 nginx 配置并用普通用户 nginx 实测。 10. 在 https://e-study.cn 上用 Chrome 验收三张页面和练习页,经公网 MCP 发送测试作业到当天日程。 ## 规划 - 练习地址存成相对每日课页面目录的路径:`homework/{学科}/{目录}/task-step-N.html`(URL 编码)。页面在 `/stellia-daily-lesson/task-detail.html`,浏览器解析成 `/stellia-daily-lesson/homework/...`,nginx 用 alias 指到 `prod/homework/`。和接口返回的 `link`(`task-detail.html?...`)同一套相对规则。 - nginx 不支持相对 alias,模板里写占位符 `__PROD_ROOT__`、`__API_PORT__`,由 `run.sh nginx` 按脚本所在目录生成实际 conf。发布包里只放模板,不放带绝对路径的成品。 - context 前缀 `stellia-daily-lesson` 是产品名,保持不变;练习页里的字体地址 `/stellia-daily-lesson-static/fonts/fonts.css` 不改,作业页面不重做。 - 0901 那份作业在数据库里,也是文档示例,一起带上,保证库里每条练习链接都能打开。 ## 说明 - 本地发布包 `docs/competition/prod` 已脱敏:全目录扫过 stella、neotao、192.168、本机盘符路径、nginx-1.8、WorkBuddy 路径、代理端口、真实校名、班级号,没有残留。数据库二进制里也没有这些字样。 - 数据库:用户改成 `demo`,密钥表清空(启动时按 `LESSON_AGENT_KEY` 写入),7 条练习地址改成 `homework/...`;10.29 语文用 push 脚本补进库,共 7 份作业。 - 后端测试 13 个通过(本机 Python 3.12、服务器 Python 3.11)。本机 nginx 1.8 和服务器 nginx 1.28 用生成的 locations 配置各跑了一遍链接检查,全部 200。 - 服务器 `neotao@8.152.195.43`:包解到 `~/easy-study`,`./run.sh install && ./run.sh start`,后端 127.0.0.1:8160,密钥在 `~/easy-study/backend/.env`。 - 服务器上没有 sudo 密码,改不了 `/etc/nginx`。用户 16:11 已在 `/etc/nginx/conf.d/default/easy-study.conf` 加了 `/stellia-daily-lesson-api` 反代;页面这边用软链挂到现有 `location /` 指向的 `~/easystudy/`:`~/easystudy/stellia-daily-lesson/{plan,kid-todo,task-detail}.html`、`homework` 和 `~/easystudy/stellia-daily-lesson-static` 指向 `~/easy-study`,外加一个跳转到 plan.html 的 `index.html`。正式接法是 `sudo ln -sf /home/neotao/easy-study/nginx/daily-lesson.locations.conf /etc/nginx/conf.d/default/daily-lesson.conf && sudo nginx -t && sudo nginx -s reload`,之后可以删掉这些软链。 - Chrome 验收(https://e-study.cn):plan.html、kid-todo.html、task-detail.html、练习页都能打开,字体正常,控制台无报错;「去练习」从相对地址解析到 `/stellia-daily-lesson/homework/...`。 - MCP 验收:错误密钥 401;initialize、tools/list、get_homework 正常;用 push 脚本经公网把 10.29 语文作业推到 2026-10-30,孩子页当天卡片出现「语文」,点进去能做练习。这条测试作业留在服务器库里。 - 风险:`~/easystudy/` 是网站根目录,用户自己解进去的旧 prod.zip(16:01 的中间版本)可以被公网直接下载,含 `.venv`、`run/backend.log`、旧库、带本机路径的 nginx 配置。其中的 `backend/.env`(本机测试时生成的密钥,没在服务器库里登记)已挪到 `~/.easystudy-moved/backend.env`。其余待用户决定是否清理。 - `docs/competition/prod.zip` 是用户 16:01 打的中间版本,含测试用 `.env`、`run/`、`__pycache__`、带 `D:/` 路径的 nginx 配置,不要用它发布。 - `architecture.html` 被用户挪进 prod,里面的 Stella、局域网 IP、stella 默认用户已替换(Demo、局域网主机/局域网 IP、demo 默认用户),原文件备份在 `%TEMP%\dl-prod\architecture.html.bak`。 - context 前缀 `stellia-daily-lesson` 是产品名,没改;如果也要去掉,需要同时改页面、nginx、练习页里的字体地址。 - 服务器后端用 nohup 起,机器重启后要再 `./run.sh start`。 - 18:07 用户把 `/etc/nginx/conf.d/default/easy-study.conf` 的 `location /` 改成 alias `/home/neotao/easy-study/` 并开了 autoindex,还删了 `~/easystudy/`。结果:页面路径 `/stellia-daily-lesson/...` 404;整个发布包可被公网列出和下载,包括 `backend/.env`(MCP 密钥)、数据库、日志。后端本身一直正常。 - 处理(没有 sudo,只在用户目录内):`backend/.env` 挪到包外 `~/.config/daily-lesson/env`;代码改为默认从这里读密钥(`LESSON_ENV_FILE` 可改),新增 `./run.sh rotate-key`,已换新密钥,库里只剩新密钥的哈希。在 `~/easy-study/` 下建 `stellia-daily-lesson/`(三张页面、homework 的软链和跳转用 index.html)和 `stellia-daily-lesson-static` 软链,让当前配置下的地址能用。e-study.cn 上页面、字体、接口、全部练习页和 MCP 已验证正常。 - 遗留:当前配置仍会把数据库、日志、`.venv`、技能等公开出去,需要用户用 sudo 把 easy-study.conf 换成 include `nginx/daily-lesson.locations.conf`,之后删掉那两个临时路径。