wolfydw/xsk-education-management
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update vps root directory name

Browse Source
This commit is contained in:
Codex
2026-06-15 14:18:36 +08:00
parent fccc3585b4
commit d394649c9c
4 changed files with 24 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files
MAINTENANCE.md
+7 -7
View File
@@ -75,18 +75,18 @@ git push origin HEAD:<当前分支>
业务数据文件位于： 业务数据文件位于：
```text ```text
/root/新时空数据/data/classnotes.txt /root/新时空教务管理系统/data/classnotes.txt
/root/新时空数据/data/学生课时账户.md /root/新时空教务管理系统/data/学生课时账户.md
/root/新时空数据/data/admin_tasks.json /root/新时空教务管理系统/data/admin_tasks.json
/root/新时空数据/data/course_summaries/ /root/新时空教务管理系统/data/course_summaries/
/root/新时空数据/data/course_summary_state.json /root/新时空教务管理系统/data/course_summary_state.json
/root/新时空数据/data/operation_logs.jsonl /root/新时空教务管理系统/data/operation_logs.jsonl
``` ```
普通前端和查询类改动不应该改变这些文件；课程小结查询页是只读功能，也不应该改变这些文件。部署前后 `make data-hash` 输出应一致；如果涉及登记 API、课时账户编辑、课程小结自动入账或审核批准，先确认自动备份目录： 普通前端和查询类改动不应该改变这些文件；课程小结查询页是只读功能，也不应该改变这些文件。部署前后 `make data-hash` 输出应一致；如果涉及登记 API、课时账户编辑、课程小结自动入账或审核批准，先确认自动备份目录：
```text ```text
/root/新时空数据/data/backups/ /root/新时空教务管理系统/data/backups/
``` ```
恢复备份时先停止服务，把备份文件复制回数据目录，再重新启动服务。 恢复备份时先停止服务，把备份文件复制回数据目录，再重新启动服务。
README.md
+15 -15
View File
@@ -45,7 +45,7 @@ python3 scripts/deploy_to_vps.py --use-sshpass
http://121.199.172.246:18080/ http://121.199.172.246:18080/
``` ```
默认网页用户名为 `wolfydw`。网页密码只写入 VPS 的 `/root/新时空数据/app/.env`，不会提交进 Git。 默认网页用户名为 `wolfydw`。网页密码只写入 VPS 的 `/root/新时空教务管理系统/新时空教务管理系统/.env`，不会提交进 Git。
如果 VPS 无法访问 Docker Hub，部署脚本会默认使用 `swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/library/python:3.12-slim` 作为基础镜像。需要更换时设置： 如果 VPS 无法访问 Docker Hub，部署脚本会默认使用 `swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/library/python:3.12-slim` 作为基础镜像。需要更换时设置：
@@ -71,7 +71,7 @@ python3 scripts/sync_to_vps.py --once --use-sshpass
远端数据目录： 远端数据目录：
```text ```text
/root/新时空数据/data/ /root/新时空教务管理系统/data/
``` ```
## 课程小结推送 ## 课程小结推送
@@ -103,7 +103,7 @@ python3 /Users/yangdawei/Desktop/新时空业务源数据/新时空课程记录
把本机历史课程小结目录同步或上传到 VPS 后，可在容器内执行一次性导入。历史导入只重建小结库和状态；历史 `classnotes缺失.txt` 默认转为审核任务，不自动扣课时。 把本机历史课程小结目录同步或上传到 VPS 后，可在容器内执行一次性导入。历史导入只重建小结库和状态；历史 `classnotes缺失.txt` 默认转为审核任务，不自动扣课时。
```bash ```bash
cd /root/新时空数据/app cd /root/新时空教务管理系统/新时空教务管理系统
docker compose exec xsk-education-management python scripts/import_course_summaries.py \ docker compose exec xsk-education-management python scripts/import_course_summaries.py \
--source /data/import/课程小结采集 \ --source /data/import/课程小结采集 \
--target /data/course_summaries \ --target /data/course_summaries \
@@ -118,17 +118,17 @@ docker compose exec xsk-education-management python scripts/import_course_summar
通过登记 API、课程小结自动入账或审核批准修改正式课时数据时，服务会在写入前自动备份本次会改动的业务文件。正式数据和辅助状态位于： 通过登记 API、课程小结自动入账或审核批准修改正式课时数据时，服务会在写入前自动备份本次会改动的业务文件。正式数据和辅助状态位于：
```text ```text
/root/新时空数据/data/classnotes.txt /root/新时空教务管理系统/data/classnotes.txt
/root/新时空数据/data/学生课时账户.md /root/新时空教务管理系统/data/学生课时账户.md
/root/新时空数据/data/course_summaries/ /root/新时空教务管理系统/data/course_summaries/
/root/新时空数据/data/course_summary_state.json /root/新时空教务管理系统/data/course_summary_state.json
/root/新时空数据/data/operation_logs.jsonl /root/新时空教务管理系统/data/operation_logs.jsonl
``` ```
备份目录位于： 备份目录位于：
```text ```text
/root/新时空数据/data/backups/ /root/新时空教务管理系统/data/backups/
``` ```
每次登记生成一个事务备份目录，目录内包含变更前的业务文件副本和 `metadata.json`。系统自动保留最近 50 次备份，超过后删除最旧备份。 每次登记生成一个事务备份目录，目录内包含变更前的业务文件副本和 `metadata.json`。系统自动保留最近 50 次备份，超过后删除最旧备份。
@@ -136,16 +136,16 @@ docker compose exec xsk-education-management python scripts/import_course_summar
查看备份： 查看备份：
```bash ```bash
ls -lt /root/新时空数据/data/backups/ ls -lt /root/新时空教务管理系统/data/backups/
``` ```
恢复某次备份时，先停止服务，再把对应备份目录里的文件复制回数据目录，最后重启服务： 恢复某次备份时，先停止服务，再把对应备份目录里的文件复制回数据目录，最后重启服务：
```bash ```bash
cd /root/新时空数据/app cd /root/新时空教务管理系统/新时空教务管理系统
docker compose stop docker compose stop
cp /root/新时空数据/data/backups/<备份目录>/classnotes.txt /root/新时空数据/data/classnotes.txt 2>/dev/null || true cp /root/新时空教务管理系统/data/backups/<备份目录>/classnotes.txt /root/新时空教务管理系统/data/classnotes.txt 2>/dev/null || true
cp /root/新时空数据/data/backups/<备份目录>/学生课时账户.md /root/新时空数据/data/学生课时账户.md 2>/dev/null || true cp /root/新时空教务管理系统/data/backups/<备份目录>/学生课时账户.md /root/新时空教务管理系统/data/学生课时账户.md 2>/dev/null || true
docker compose up -d docker compose up -d
``` ```
@@ -179,10 +179,10 @@ rm ~/Library/LaunchAgents/com.xsk.education-management.sync.plist
## 更换网页访问密码 ## 更换网页访问密码
登录 VPS 后修改 `/root/新时空数据/app/.env` 中的 `BASIC_AUTH_PASSWORD`，然后重启： 登录 VPS 后修改 `/root/新时空教务管理系统/新时空教务管理系统/.env` 中的 `BASIC_AUTH_PASSWORD`，然后重启：
```bash ```bash
cd /root/新时空数据/app cd /root/新时空教务管理系统/新时空教务管理系统
docker compose up -d docker compose up -d
``` ```
scripts/deploy_to_vps.py
+1 -1
View File
@@ -14,7 +14,7 @@ PROJECT_DIR = Path(__file__).resolve().parents[1]
DEFAULT_REMOTE_HOST = "121.199.172.246" DEFAULT_REMOTE_HOST = "121.199.172.246"
DEFAULT_REMOTE_USER = "root" DEFAULT_REMOTE_USER = "root"
DEFAULT_REMOTE_PORT = 22222 DEFAULT_REMOTE_PORT = 22222
DEFAULT_REMOTE_DIR = "/root/新时空数据" DEFAULT_REMOTE_DIR = "/root/新时空教务管理系统"
DEFAULT_IDENTITY_FILE = Path.home() / ".ssh" / "xsk_records_vps_ed25519" DEFAULT_IDENTITY_FILE = Path.home() / ".ssh" / "xsk_records_vps_ed25519"
scripts/sync_to_vps.py
+1 -1
View File
@@ -16,7 +16,7 @@ DEFAULT_LOCAL_DIR = Path("/Users/yangdawei/Desktop/新时空业务源数据/新
DEFAULT_REMOTE_HOST = "121.199.172.246" DEFAULT_REMOTE_HOST = "121.199.172.246"
DEFAULT_REMOTE_USER = "root" DEFAULT_REMOTE_USER = "root"
DEFAULT_REMOTE_PORT = 22222 DEFAULT_REMOTE_PORT = 22222
DEFAULT_REMOTE_DIR = "/root/新时空数据" DEFAULT_REMOTE_DIR = "/root/新时空教务管理系统"
DEFAULT_IDENTITY_FILE = Path.home() / ".ssh" / "xsk_records_vps_ed25519" DEFAULT_IDENTITY_FILE = Path.home() / ".ssh" / "xsk_records_vps_ed25519"
SYNC_FILES = ("classnotes.txt", "学生课时账户.md") SYNC_FILES = ("classnotes.txt", "学生课时账户.md")