Skip to content

Q
qiyouxue
Commit ad00ed3a authored by tao355667's avatar tao355667
Browse files
Options

feat: build Qiyouxue corporate website

parents
Show whitespace changes
Inline Side-by-side
Showing with 3930 additions and 0 deletions
.env.example 0 → 100644
View file @ ad00ed3a
# 复制为 .env 后使用。生产环境请生成独立密钥。
CMS_PORT=8793
# 后台主密码始终有效，用于登录和找回；在后台修改的用户密码会另存于 CMS_DATA_DIR。
CMS_PASSWORD=replace-with-a-strong-password
CMS_SECRET=replace-with-openssl-rand-hex-32
CMS_API_KEY=replace-with-openssl-rand-hex-32
# 本地默认放入已忽略的 .runtime；生产环境请改为 /root/qiyouxue/shared/ 下的绝对路径。
CMS_DATA_DIR=.runtime/cms-data
CMS_BUILD_LOCK=.runtime/site-build.lock
.gitignore 0 → 100644
View file @ ad00ed3a
node_modules/
dist/
.astro/
.codex-tmp/
.runtime/
.env
!.env.example
public/uploads/
.DS_Store
.firecrawl/
.gitlab-ci.yml 0 → 100644
View file @ ad00ed3a
# 启优学官网 · GitLab CI/CD 单目录覆盖部署
# 流程：停止应用 → 覆盖 current → 安装与构建 → 启动并检查 → 更新 Nginx
# 触发：push 到 main 分支
#
# GitLab 版本：11.7
# 仅使用 stages、only、script 等基础语法；服务器部署锁用于拒绝并发部署。
variables:
DEPLOY_ROOT: "/root/qiyouxue"
CURRENT_DIR: "/root/qiyouxue/current"
SHARED_DIR: "/root/qiyouxue/shared"
SHARED_ENV: "/root/qiyouxue/shared/.env"
DEPLOY_LOCK: "/root/qiyouxue/shared/deploy.lock"
APP_NAME: "qiyouxue"
SITE_URL: "http://127.0.0.1:8793/"
PM2_BIN: "/usr/bin/pm2"
PM2_HOME_DIR: "/root/.pm2"
PM2_USE_SUDO: "1"
PUBLIC_HOST: "qiyouxueedu.com"
stages:
- deploy
deploy:
stage: deploy
tags:
- qiyouxue-prod
only:
- main
script:
- |
set -Eeuo pipefail
echo "[deploy] 提交：$CI_COMMIT_SHA"
case "$DEPLOY_ROOT" in
/*) ;;
*) echo "DEPLOY_ROOT 必须是绝对路径" >&2; exit 2 ;;
esac
case "$PM2_BIN" in
/*) ;;
*) echo "PM2_BIN 必须是绝对路径" >&2; exit 2 ;;
esac
case "$PM2_HOME_DIR" in
/*) ;;
*) echo "PM2_HOME_DIR 必须是绝对路径" >&2; exit 2 ;;
esac
if [ "$CURRENT_DIR" != "$DEPLOY_ROOT/current" ] || [ "$SHARED_DIR" != "$DEPLOY_ROOT/shared" ]; then
echo "current 或 shared 目录不属于部署根目录" >&2
exit 2
fi
if [ "$SHARED_ENV" != "$SHARED_DIR/.env" ] || [ "$DEPLOY_LOCK" != "$SHARED_DIR/deploy.lock" ]; then
echo "生产配置或部署锁路径不属于 shared 目录" >&2
exit 2
fi
case "$APP_NAME" in
*[!A-Za-z0-9_.-]*|'') echo "PM2 应用名包含不安全字符" >&2; exit 2 ;;
esac
case "$PM2_USE_SUDO" in
0|1) ;;
*) echo "PM2_USE_SUDO 只能是 0 或 1" >&2; exit 2 ;;
esac
test -n "$CI_COMMIT_SHA" || (echo "CI_COMMIT_SHA 缺失" >&2 && exit 2)
test -x "$PM2_BIN" || (echo "PM2 不存在或不可执行：$PM2_BIN" >&2 && exit 2)
command -v flock >/dev/null || (echo "服务器缺少 flock" >&2 && exit 2)
command -v curl >/dev/null || (echo "服务器缺少 curl" >&2 && exit 2)
command -v node >/dev/null || (echo "服务器缺少 Node.js" >&2 && exit 2)
if [ -L "$DEPLOY_ROOT" ] || { [ -e "$DEPLOY_ROOT" ] && [ ! -d "$DEPLOY_ROOT" ]; }; then
echo "DEPLOY_ROOT 必须是非软链接实体目录：$DEPLOY_ROOT" >&2
exit 2
fi
mkdir -p "$DEPLOY_ROOT"
if [ "$(readlink -f "$DEPLOY_ROOT")" != "$DEPLOY_ROOT" ] || [ -L "$DEPLOY_ROOT" ]; then
echo "DEPLOY_ROOT 必须是非软链接实体目录：$DEPLOY_ROOT" >&2
exit 2
fi
if [ -L "$SHARED_DIR" ] || { [ -e "$SHARED_DIR" ] && [ ! -d "$SHARED_DIR" ]; }; then
echo "shared 必须是非软链接实体目录：$SHARED_DIR" >&2
exit 2
fi
mkdir -p "$SHARED_DIR"
if [ "$(readlink -f "$SHARED_DIR")" != "$SHARED_DIR" ]; then
echo "shared 必须位于指定部署目录：$SHARED_DIR" >&2
exit 2
fi
test -f "$SHARED_ENV" || (echo "缺少生产配置：$SHARED_ENV" >&2 && exit 2)
# GitLab 11.7 没有 resource_group。非阻塞锁让并发 pipeline 直接失败，
# 避免较早的 pipeline 排队后覆盖较新的提交。
exec 9>"$DEPLOY_LOCK"
if ! flock -n 9; then
echo "已有部署正在进行，本次 pipeline 不进入等待队列" >&2
exit 3
fi
pm2_command() {
if [ "$PM2_USE_SUDO" = "1" ]; then
sudo -n env PM2_HOME="$PM2_HOME_DIR" "$PM2_BIN" "$@"
else
env PM2_HOME="$PM2_HOME_DIR" "$PM2_BIN" "$@"
fi
}
# 先停止且只停止本项目进程。单目录部署失败时不会自动回滚。
if pm2_command describe "$APP_NAME" >/dev/null 2>&1; then
echo "[deploy] 停止本项目 PM2 进程：$APP_NAME"
pm2_command delete "$APP_NAME"
fi
# 首次迁移时只移除 current 软链接本身，不触碰它原来指向的 release。
if [ -L "$CURRENT_DIR" ]; then
old_current_target=$(readlink -f "$CURRENT_DIR" 2>/dev/null || true)
echo "[deploy] 移除旧 current 软链接（原目标保留）：${old_current_target:-未知}"
unlink "$CURRENT_DIR"
elif [ -e "$CURRENT_DIR" ] && [ ! -d "$CURRENT_DIR" ]; then
echo "current 存在但不是目录，拒绝覆盖：$CURRENT_DIR" >&2
exit 2
fi
mkdir -p "$CURRENT_DIR"
if [ -L "$CURRENT_DIR" ] || [ "$(readlink -f "$CURRENT_DIR")" != "$CURRENT_DIR" ]; then
echo "current 必须是指定位置的实体目录：$CURRENT_DIR" >&2
exit 2
fi
echo "[deploy] 清空 current"
find "$CURRENT_DIR" -mindepth 1 -maxdepth 1 -exec rm -rf -- {} +
echo "[deploy] 导出提交到 current"
git -c safe.directory="$CI_PROJECT_DIR" -C "$CI_PROJECT_DIR" cat-file -e "$CI_COMMIT_SHA^{commit}"
git -c safe.directory="$CI_PROJECT_DIR" -C "$CI_PROJECT_DIR" archive "$CI_COMMIT_SHA" | tar -x -C "$CURRENT_DIR"
ln -s "$SHARED_ENV" "$CURRENT_DIR/.env"
cd "$CURRENT_DIR"
echo "[deploy] 安装依赖"
npm ci
echo "[deploy] 使用 shared 中的 CMS 数据和构建锁进行构建"
node --env-file="$SHARED_ENV" -e '
const path = require("node:path");
const shared = path.resolve(process.argv[1]);
for (const name of ["CMS_DATA_DIR", "CMS_BUILD_LOCK"]) {
const value = process.env[name];
if (!value) throw new Error(`${name} 未配置`);
const resolved = path.resolve(value);
if (resolved === shared || !resolved.startsWith(`${shared}${path.sep}`)) {
throw new Error(`${name} 必须位于 ${shared}/ 下`);
}
}
' "$SHARED_DIR"
node --env-file="$SHARED_ENV" scripts/run-with-site-lock.mjs -- npm run build:inside-lock
echo "[deploy] 启动本项目 PM2 进程"
pm2_command start "$CURRENT_DIR/server.mjs" \
--name "$APP_NAME" \
--cwd "$CURRENT_DIR" \
--node-args="--env-file=$SHARED_ENV"
healthy=0
for attempt in $(seq 1 30); do
if curl --fail --silent --show-error --max-time 3 "$SITE_URL" >/dev/null; then
healthy=1
break
fi
echo "[deploy] 等待服务启动... ($attempt/30)"
sleep 1
done
if [ "$healthy" != "1" ]; then
echo "健康检查失败：$SITE_URL" >&2
pm2_command logs "$APP_NAME" --lines 30 --nostream || true
exit 1
fi
echo "[deploy] 更新并验证 Nginx"
test -f "$CURRENT_DIR/deploy/nginx/qiyouxue.conf" || (echo "缺少 Nginx 配置" >&2 && exit 2)
sudo -n /usr/bin/install -o root -g root -m 0644 "$CURRENT_DIR/deploy/nginx/qiyouxue.conf" /etc/nginx/conf.d/qiyouxue.conf
sudo -n /usr/sbin/nginx -t
sudo -n /usr/bin/systemctl reload nginx
curl --fail --silent --show-error --max-time 5 \
--noproxy "*" \
--resolve "$PUBLIC_HOST:443:127.0.0.1" \
"https://$PUBLIC_HOST/" >/dev/null
echo "[deploy] 部署完成：$CURRENT_DIR"
echo "[deploy] 旧 releases 目录未被读取或清理；确认无用后请人工删除"
CMS_README.md 0 → 100644
View file @ ad00ed3a
# 启优学学习资讯后台
项目采用与官网同端口的 Astro 内容后台：Markdown 文件负责存储，Astro 同时提供管理 API 与静态页面生成。文章列表、分类页和详情页均预渲染为 HTML，便于 SEO 与 AI 搜索发现。
## 本地使用
```bash
source ~/.nvm/nvm.sh
nvm use 20
cp .env.example .env
npm install
npm run build
npm start
```
- 官网：`http://localhost:8793/`
- 后台：`http://localhost:8793/admin/`
- 学习资讯：`http://localhost:8793/articles/`
## 环境变量
- `CMS_PORT`：官网与后台共用端口，默认 `8793`
- `CMS_PASSWORD`：后台初始/主密码
- `CMS_SECRET`：会话签名密钥
- `CMS_API_KEY`：Bearer API 密钥
- `CMS_DATA_DIR`：文章、分类与上传文件的持久化目录
- `CMS_BUILD_LOCK`：发布重建共享锁
生产示例：
```dotenv
CMS_PORT=8793
CMS_DATA_DIR=/root/qiyouxue/shared/cms-data
CMS_BUILD_LOCK=/root/qiyouxue/shared/site-build.lock
```
## 内容工作流
- 工作稿：`src/content/articles/`
- 已发布：`src/content/published/`
- 默认分类：学情指南、学习方法、家长课堂、服务说明
- 支持新建、编辑、发布、下架、删除与未发布修改回退
- 支持分类新增、重命名、删除与文章迁移
- 支持 Markdown、Word `.docx` 导入和内嵌图片提取
- 支持图片上传、Markdown 预览和后台密码修改
生产环境配置 `CMS_DATA_DIR` 后，内容持久化到仓库外，不随单目录部署被覆盖。发布、下架、删除与分类变更会触发共享锁保护的原子站点重建。
## API
后台浏览器会话与 Bearer API 均由 `/api/cms/*` 提供。API 调用使用：
```http
Authorization: Bearer <CMS_API_KEY>
```
Word 导入示例字段：
```json
{
"fileName": "学习方法文章.docx",
"category": "学习方法",
"dataUrl": "data:application/vnd.openxmlformats-officedocument.wordprocessingml.document;base64,..."
}
```
## 部署
`.gitlab-ci.yml` 使用单目录覆盖部署：停止 `qiyouxue` PM2 进程，更新 `/root/qiyouxue/current`，关联 `/root/qiyouxue/shared/.env`，安装依赖并构建，重新启动、健康检查，然后安装并验证 Nginx 配置。
- 部署根目录：`/root/qiyouxue`
- PM2 应用名：`qiyouxue`
- 服务端口：`8793`
- Nginx 配置：`/etc/nginx/conf.d/qiyouxue.conf`
- 公网域名：`qiyouxueedu.com`
Runner 需具备安装固定 Nginx 配置、执行 `nginx -t` 与 reload 的最小 sudo 权限。生产密钥、上传文件、CMS 数据与构建锁必须位于 `shared/`。
README.md 0 → 100644
View file @ ad00ed3a
# 启优学企业官网
启优学一对一品牌官网。项目基于 Astro 5 + Node standalone adapter，包含品牌首页、学科辅导详情、教学服务、常见问题、联系页面、学习资讯 CMS、SEO/AI 可发现性、响应式适配、原子构建与 GitLab/Nginx 部署配置。
## 本地运行（Node 20）
```bash
source ~/.nvm/nvm.sh
nvm use 20
npm install
npm run dev
```
- 官网开发地址：`http://localhost:4321/`
- 内容后台：`http://localhost:4321/admin/`
生产构建与本地服务：
```bash
npm run build
npm start
```
生产模式默认监听 `http://127.0.0.1:8793/`。
## 常用命令
```bash
npm run check
npm test
npm run build
npm start
```
## 内容管理
学习资讯使用 Markdown 存储，并由同端口 `/admin/` 后台管理。工作稿位于 `src/content/articles/`，线上稿位于 `src/content/published/`；生产环境通过 `CMS_DATA_DIR` 将内容持久化到仓库外。后台支持草稿、发布、下架、删除、分类管理、Markdown/Word 导入、图片上传、预览、修改密码与 Bearer API。
完整说明见 [CMS_README.md](./CMS_README.md)。
## SEO 与性能
- 页面级标题、描述、关键词、canonical、Open Graph 与 Twitter Card
- EducationalOrganization、WebSite、WebPage、Service、FAQ、Article 和 Breadcrumb 结构化数据
- sitemap、robots.txt、语义化页面、分类分页、`llms.txt` 与 `llms-full.txt`
- Astro 图片优化、响应式图片、移动端适配、减少动态效果偏好
- Astro standalone、原子构建、共享锁与 Nginx 反向代理
## 部署
- Nginx 配置：`deploy/nginx/qiyouxue.conf`
- 生产端口：`8793`
- 站点域名：`qiyouxueedu.com`
- 服务器目录：`/root/qiyouxue/current` 与 `/root/qiyouxue/shared`
生产部署前需在 `/root/qiyouxue/shared/.env` 配置独立的 `CMS_PASSWORD`、`CMS_SECRET`、`CMS_API_KEY`、`CMS_DATA_DIR` 和 `CMS_BUILD_LOCK`。
astro.config.mjs 0 → 100644
View file @ ad00ed3a
import { defineConfig } from "astro/config";
import sitemap from "@astrojs/sitemap";
import node from "@astrojs/node";
import path from "node:path";
const customOutDir = process.env.QIYOUXUE_BUILD_OUT_DIR;
export default defineConfig({
site: "https://qiyouxueedu.com",
integrations: [sitemap({
filter: (page) => {
const pathname = new URL(page).pathname;
return pathname !== "/404/"
&& pathname !== "/admin/"
&& !pathname.startsWith("/api/")
&& !pathname.startsWith("/uploads/")
&& !pathname.endsWith(".txt");
},
})],
adapter: node({ mode: "standalone" }),
...(customOutDir ? { outDir: path.resolve(customOutDir) } : {}),
build: { format: "directory" },
trailingSlash: "ignore",
});
deploy/nginx/qiyouxue.conf 0 → 100644
View file @ ad00ed3a
# 启优学官网：HTTP 统一跳转至 HTTPS 主域名。
server {
listen 80;
server_name qiyouxueedu.com www.qiyouxueedu.com;
return 301 https://qiyouxueedu.com$request_uri;
}
server {
listen 443 ssl http2;
server_name www.qiyouxueedu.com;
ssl_certificate /etc/nginx/certs/qiyouxueedu.com.fullchain.pem;
ssl_certificate_key /etc/nginx/certs/qiyouxueedu.com.certkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
return 301 https://qiyouxueedu.com$request_uri;
}
server {
listen 443 ssl http2;
server_name qiyouxueedu.com;
ssl_certificate /etc/nginx/certs/qiyouxueedu.com.fullchain.pem;
ssl_certificate_key /etc/nginx/certs/qiyouxueedu.com.certkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:QIYOUXUE:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
client_max_body_size 28m;
location / {
proxy_pass http://127.0.0.1:8793;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
}
}
package-lock.json 0 → 100644
View file @ ad00ed3a
This source diff could not be displayed because it is too large. You can view the blob instead.
package.json 0 → 100644
View file @ ad00ed3a
{
"name": "qiyouxue-official-site",
"type": "module",
"version": "1.0.0",
"private": true,
"engines": {
"node": ">=20.20.0 <21"
},
"scripts": {
"dev": "node --env-file=.env ./node_modules/astro/astro.js dev",
"build": "node scripts/build-site.mjs",
"build:inside-lock": "node scripts/build-site.mjs --inside-lock",
"build:astro": "astro check && astro build",
"preview": "astro preview",
"check": "astro check",
"test": "node --import tsx/esm --test tests/*.test.ts",
"start": "node --env-file=.env server.mjs",
"admin": "npm start",
"serve": "npm run build && npm start"
},
"dependencies": {
"@astrojs/node": "9.5.5",
"@astrojs/sitemap": "^3.7.3",
"astro": "5.18.2",
"gray-matter": "^4.0.3",
"mammoth": "^1.12.0",
"marked": "^14.1.4",
"turndown": "^7.2.4",
"turndown-plugin-gfm": "^1.0.2"
},
"devDependencies": {
"@astrojs/check": "^0.9.6",
"@types/turndown": "^5.0.6",
"docx": "^9.7.1",
"tsx": "^4.23.1",
"typescript": "^5.9.3"
}
}
public/admin/app.js 0 → 100644
View file @ ad00ed3a
const $ = (selector) => document.querySelector(selector);
const API_BASE = "/api/cms";
const MAX_UPLOAD_SIZE = 20 * 1024 * 1024;
const DOCX_MIME = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
let categories = [];
let editingSlug = null;
let editingStatus = "new-unsaved";
let dirty = false;
let previewTimer = null;
let previewRequest = 0;
async function api(path, options = {}) {
const endpoint = path.startsWith("/") ? path : `/${path}`;
const response = await fetch(`${API_BASE}${endpoint}`, {
headers: { "Content-Type": "application/json" },
...options,
body: options.body ? JSON.stringify(options.body) : undefined,
});
let data = {};
try { data = await response.json(); } catch {}
if (!response.ok) throw new Error(data.error || `请求失败（${response.status}）`);
return data;
}
const show = (selector) => $(selector).classList.remove("hidden");
const hide = (selector) => $(selector).classList.add("hidden");
const refreshCaptcha = () => {
$("#captcha-image").src = `${API_BASE}/captcha?t=${Date.now()}`;
$("#captcha").value = "";
};
function showLogin() {
show("#login");
hide("#app");
refreshCaptcha();
$("#password").focus();
}
async function boot() {
const session = await api("/session").catch(() => ({ authed: false }));
if (session.authed) {
hide("#login"); show("#app");
await loadCategories();
loadArticles();
}
else showLogin();
}
$("#captcha-image").addEventListener("click", refreshCaptcha);
$("#login-form").addEventListener("submit", async (event) => {
event.preventDefault();
$("#login-error").textContent = "";
try {
await api("/session", { method: "POST", body: { password: $("#password").value, captcha: $("#captcha").value } });
$("#password").value = "";
$("#captcha").value = "";
hide("#login"); show("#app");
await loadCategories();
loadArticles();
} catch (error) {
$("#login-error").textContent = error.message;
refreshCaptcha();
}
});
$("#logout").addEventListener("click", async () => { await api("/session", { method: "DELETE" }); location.reload(); });
function closePasswordModal() {
hide("#password-modal");
$("#password-form").reset();
$("#password-error").textContent = "";
}
$("#change-password").addEventListener("click", () => {
$("#password-form").reset();
$("#password-error").textContent = "";
show("#password-modal");
$("#current-password").focus();
});
$("#close-password-modal").addEventListener("click", closePasswordModal);
$("#cancel-password").addEventListener("click", closePasswordModal);
$("#password-form").addEventListener("submit", async (event) => {
event.preventDefault();
const currentPassword = $("#current-password").value;
const newPassword = $("#new-password").value;
const confirmPassword = $("#confirm-password").value;
const submit = event.submitter;
$("#password-error").textContent = "";
if (newPassword !== confirmPassword) {
$("#password-error").textContent = "两次输入的新密码不一致";
return;
}
if (submit) submit.disabled = true;
try {
await api("/account/password", { method: "PUT", body: { currentPassword, newPassword } });
closePasswordModal();
alert("密码修改成功，请重新登录后台");
showLogin();
} catch (error) {
$("#password-error").textContent = error.message;
} finally {
if (submit) submit.disabled = false;
}
});
const statusMap = {
"new-unsaved": ["尚未保存", "new-draft", "填写完成后先保存草稿，线上网站不会发生变化。"],
"new-draft": ["新建未发布", "new-draft", "这篇文章目前只有草稿版本，发布后才会出现在官网。"],
"edited-draft": ["修改未发布", "edited-draft", "草稿已经保存，官网仍在展示上一次发布的版本。"],
live: ["已上线", "live", "当前编辑内容与官网展示的版本一致。"],
};
function applyStatus(element, status) {
const [label, className] = statusMap[status] || statusMap["new-draft"];
element.className = `status ${className}`;
element.textContent = label;
}
async function loadArticles() {
const articles = await api("/articles").catch((error) => { alert(error.message); return []; });
const list = $("#article-list");
list.innerHTML = "";
const pending = articles.filter((item) => item.publishStatus !== "live").length;
$("#pending-badge").textContent = `${pending} 篇草稿待发布`;
$("#pending-badge").classList.toggle("hidden", pending === 0);
if (!articles.length) { list.innerHTML = '<div class="empty">还没有文章，点击“新建文章”开始。</div>'; return; }
for (const article of articles) {
const card = document.createElement("article");
card.className = "article-row";
card.innerHTML = '<div class="article-summary"><h2></h2><p><span class="category"></span><span class="updated"></span><span class="status"></span></p></div><div class="row-actions"></div>';
card.querySelector("h2").textContent = article.title;
card.querySelector(".category").textContent = article.category;
card.querySelector(".updated").textContent = `更新于 ${article.updated}`;
applyStatus(card.querySelector(".status"), article.publishStatus);
const actions = card.querySelector(".row-actions");
const edit = listAction("编辑", "ghost small", () => openEditor(article.slug));
const publish = listAction("发布", "primary small", () => publishFromList(article));
publish.disabled = article.publishStatus === "live";
publish.title = publish.disabled ? "文章当前已上线" : "发布到官网";
actions.append(edit, publish, listMoreActions(article));
list.append(card);
}
}
function listAction(label, className, action) {
const button = document.createElement("button");
button.type = "button";
button.className = className;
button.textContent = label;
button.onclick = action;
return button;
}
function listMenuAction(label, className, action) {
return listAction(label, `menu-action ${className}`.trim(), async (event) => {
event.currentTarget.closest("details").open = false;
await action();
});
}
function listMoreActions(article) {
const details = document.createElement("details");
details.className = "more-actions row-more-actions";
const summary = document.createElement("summary");
summary.textContent = "更多";
summary.setAttribute("aria-label", `${article.title}的更多操作`);
const menu = document.createElement("div");
menu.className = "action-menu";
if (article.publishStatus === "edited-draft") {
menu.append(listMenuAction("放弃未发布修改", "", () => discardFromList(article)));
}
if (["live", "edited-draft"].includes(article.publishStatus)) {
menu.append(listMenuAction("下架文章", "danger", () => unpublishFromList(article)));
}
menu.append(listMenuAction("删除文章", "danger", () => deleteFromList(article)));
details.append(summary, menu);
details.addEventListener("toggle", () => {
if (!details.open) return;
document.querySelectorAll(".row-more-actions[open]").forEach((item) => {
if (item !== details) item.open = false;
});
});
return details;
}
async function publishFromList(article) {
try {
await triggerBuild(`/articles/${article.slug}/publish`);
await loadArticles();
} catch {}
}
async function discardFromList(article) {
if (!confirm(`确定放弃《${article.title}》未发布的修改，恢复为当前线上版本吗？`)) return;
try {
await api(`/articles/${article.slug}/draft`, { method: "DELETE" });
await loadArticles();
} catch (error) { alert(error.message); }
}
async function unpublishFromList(article) {
const detail = article.publishStatus === "edited-draft" ? "未发布的修改会继续保留为草稿。" : "文章内容会继续保留为草稿。";
if (!confirm(`确定将《${article.title}》从官网下架吗？${detail}`)) return;
try {
await triggerBuild(`/articles/${article.slug}/unpublish`, { action: "下架" });
await loadArticles();
} catch {}
}
async function deleteFromList(article) {
const prompt = article.publishStatus === "new-draft"
? `确定彻底删除草稿《${article.title}》吗？删除后无法恢复。`
: `确定彻底删除《${article.title}》吗？线上版本和草稿都会删除，且无法恢复。`;
if (!confirm(prompt)) return;
try {
await triggerBuild(`/articles/${article.slug}`, { action: "删除", method: "DELETE" });
await loadArticles();
} catch {}
}
function fillCategories(selected) {
const current = selected || $("#category").value || categories[0] || "";
const options = $("#category-options");
options.innerHTML = "";
categories.forEach((name) => {
const option = document.createElement("button");
option.type = "button";
option.className = "select-option";
option.dataset.value = name;
option.setAttribute("role", "option");
option.setAttribute("aria-selected", String(name === current));
option.innerHTML = '<span></span><span class="option-check" aria-hidden="true">✓</span>';
option.querySelector("span").textContent = name;
option.addEventListener("click", () => {
selectCategory(name, true);
closeCategoryMenu();
});
options.append(option);
});
selectCategory(categories.includes(current) ? current : categories[0] || "", false);
}
function selectCategory(name, markDirty) {
$("#category").value = name;
$("#category-value").textContent = name || "请选择分类";
$("#category-options").querySelectorAll(".select-option").forEach((option) => {
option.setAttribute("aria-selected", String(option.dataset.value === name));
});
if (markDirty) dirty = true;
}
function closeCategoryMenu() {
$("#category-menu").classList.add("hidden");
$("#category-trigger").setAttribute("aria-expanded", "false");
$("#category-select").classList.remove("open");
}
function toggleCategoryMenu() {
const opening = $("#category-menu").classList.contains("hidden");
if (!opening) return closeCategoryMenu();
$("#category-menu").classList.remove("hidden");
$("#category-trigger").setAttribute("aria-expanded", "true");
$("#category-select").classList.add("open");
$("#category-error").textContent = "";
}
$("#category-trigger").addEventListener("click", (event) => { event.stopPropagation(); toggleCategoryMenu(); });
$("#category-menu").addEventListener("click", (event) => event.stopPropagation());
document.addEventListener("click", closeCategoryMenu);
document.addEventListener("click", (event) => {
document.querySelectorAll(".row-more-actions[open]").forEach((details) => {
if (!details.contains(event.target)) details.open = false;
});
});
document.addEventListener("keydown", (event) => { if (event.key === "Escape") closeCategoryMenu(); });
async function createCategory() {
const input = $("#new-category");
const name = input.value.trim();
$("#category-error").textContent = "";
try {
await triggerBuild("/categories", { action: "添加分类", body: { name } });
await loadCategories();
input.value = "";
fillCategories(name);
dirty = true;
closeCategoryMenu();
if (!$("#category-modal").classList.contains("hidden")) await loadCategoryManager();
} catch (error) { $("#category-error").textContent = error.message; }
}
$("#add-category").addEventListener("click", createCategory);
$("#new-category").addEventListener("keydown", (event) => {
if (event.key !== "Enter") return;
event.preventDefault();
createCategory();
});
async function loadCategories() {
const result = await api("/categories");
categories = result.categories;
fillCategories($("#category").value);
return result;
}
async function loadCategoryManager() {
const result = await loadCategories();
renderCategoryManager(result.stats || []);
}
function clearCategoryPanels() {
$("#category-manager-list").querySelectorAll(".category-inline-panel").forEach((panel) => panel.remove());
}
function categoryPanel(row, text) {
clearCategoryPanels();
const panel = document.createElement("div");
panel.className = "category-inline-panel";
const note = document.createElement("p");
note.textContent = text;
panel.append(note);
row.append(panel);
return panel;
}
async function runCategoryBuild(action, method, body) {
$("#manager-category-error").textContent = "";
try {
await triggerBuild("/categories", { action, method, body });
await loadCategoryManager();
await loadArticles();
} catch (error) {
$("#manager-category-error").textContent = error.message;
await loadCategoryManager().catch(() => {});
}
}
function showRenameCategory(row, stat) {
const panel = categoryPanel(row, `重命名后，${stat.count} 篇文章会同步更新分类。`);
const form = document.createElement("div");
form.className = "category-rename-form";
const input = document.createElement("input");
input.maxLength = 20;
input.value = stat.name;
input.setAttribute("aria-label", `重命名 ${stat.name}`);
const save = document.createElement("button");
save.type = "button";
save.className = "primary";
save.textContent = "保存名称";
const cancel = document.createElement("button");
cancel.type = "button";
cancel.className = "ghost";
cancel.textContent = "取消";
save.onclick = () => {
const name = input.value.trim();
if (!name || name === stat.name) return clearCategoryPanels();
runCategoryBuild("更新分类", "PATCH", { current: stat.name, name });
};
cancel.onclick = clearCategoryPanels;
input.addEventListener("keydown", (event) => {
if (event.key === "Enter") { event.preventDefault(); save.click(); }
if (event.key === "Escape") clearCategoryPanels();
});
form.append(input, save, cancel);
panel.append(form);
input.focus();
input.select();
}
function showDeleteCategory(row, stat) {
const panel = categoryPanel(
row,
stat.count ? `该分类下有 ${stat.count} 篇文章，请选择删除后要迁移到的分类。` : "该分类下没有文章，可以直接删除。",
);
const actions = document.createElement("div");
actions.className = stat.count ? "replacement-options" : "category-inline-actions";
const choices = stat.count ? categories.filter((name) => name !== stat.name) : [""];
choices.forEach((replacement) => {
const button = document.createElement("button");
button.type = "button";
button.className = stat.count ? "" : "confirm-danger";
button.textContent = stat.count ? `迁移到“${replacement}”并删除` : "确认删除分类";
button.onclick = () => runCategoryBuild("删除分类", "DELETE", { name: stat.name, replacement });
actions.append(button);
});
const cancel = document.createElement("button");
cancel.type = "button";
cancel.className = "ghost";
cancel.textContent = "取消";
cancel.onclick = clearCategoryPanels;
actions.append(cancel);
panel.append(actions);
}
function renderCategoryManager(stats) {
const list = $("#category-manager-list");
list.innerHTML = "";
stats.forEach((stat) => {
const row = document.createElement("div");
row.className = "category-manager-row";
const main = document.createElement("div");
main.className = "category-row-main";
const name = document.createElement("div");
name.className = "category-row-name";
const strong = document.createElement("strong");
strong.textContent = stat.name;
const count = document.createElement("span");
count.textContent = stat.count ? `${stat.count} 篇文章` : "暂无文章";
name.append(strong, count);
const actions = document.createElement("div");
actions.className = "category-row-actions";
const rename = document.createElement("button");
rename.type = "button";
rename.className = "ghost";
rename.textContent = "重命名";
rename.onclick = () => showRenameCategory(row, stat);
const remove = document.createElement("button");
remove.type = "button";
remove.className = "ghost danger";
remove.textContent = "删除";
remove.disabled = categories.length <= 1;
remove.title = remove.disabled ? "至少需要保留一个分类" : "删除分类";
remove.onclick = () => showDeleteCategory(row, stat);
actions.append(rename, remove);
main.append(name, actions);
row.append(main);
list.append(row);
});
}
async function openCategoryManager() {
$("#manager-category-error").textContent = "";
show("#category-modal");
try { await loadCategoryManager(); }
catch (error) { $("#manager-category-error").textContent = error.message; }
}
$("#manage-categories").addEventListener("click", openCategoryManager);
$("#close-category-modal").addEventListener("click", () => hide("#category-modal"));
$("#manager-add-category").addEventListener("click", async () => {
const input = $("#manager-new-category");
const name = input.value.trim();
$("#manager-category-error").textContent = "";
try {
await triggerBuild("/categories", { action: "添加分类", body: { name } });
input.value = "";
await loadCategoryManager();
} catch (error) { $("#manager-category-error").textContent = error.message; }
});
$("#manager-new-category").addEventListener("keydown", (event) => {
if (event.key === "Enter") { event.preventDefault(); $("#manager-add-category").click(); }
});
function setView(editing) {
$("#list-view").classList.toggle("hidden", editing);
$("#edit-view").classList.toggle("hidden", !editing);
}
function setEditorStatus(status) {
editingStatus = status;
applyStatus($("#editor-status"), status);
$("#version-note").textContent = statusMap[status]?.[2] || "";
const persisted = status !== "new-unsaved";
$("#more-actions").classList.toggle("hidden", !persisted);
$("#more-actions").open = false;
$("#discard").classList.toggle("hidden", status !== "edited-draft");
$("#unpublish").classList.toggle("hidden", !["live", "edited-draft"].includes(status));
$("#delete-article").classList.toggle("hidden", !persisted);
}
async function openEditor(slug) {
editingSlug = slug;
dirty = false;
fillCategories();
$("#preview").innerHTML = "";
$("#message").textContent = "";
$("#upload-status").textContent = "";
if (slug) {
const article = await api(`/articles/${slug}`);
$("#edit-heading").textContent = "编辑文章";
$("#title").value = article.title;
fillCategories(article.category);
$("#body").value = article.body;
setEditorStatus(article.publishStatus);
} else {
$("#edit-heading").textContent = "新建文章";
$("#title").value = "";
$("#body").value = "";
setEditorStatus("new-unsaved");
}
setView(true);
schedulePreview(0);
$("#title").focus();
}
$("#new-article").addEventListener("click", () => openEditor(null));
$("#import-article").addEventListener("click", () => $("#article-file").click());
$("#article-file").addEventListener("change", async (event) => {
const file = event.target.files?.[0];
event.target.value = "";
if (!file) return;
if (file.size > MAX_UPLOAD_SIZE) {
$("#import-status").textContent = "文件不能超过 20MB";
return;
}
const extension = file.name.toLowerCase().match(/\.[^.]+$/)?.[0];
if (![".md", ".docx"].includes(extension)) {
$("#import-status").textContent = "仅支持 Markdown（.md）或 Word（.docx）文件";
return;
}
$("#import-status").textContent = `正在导入 ${file.name}…`;
try {
let result;
if (extension === ".md") {
let body = await file.text();
const heading = body.match(/^#\s+(.+)$/m);
const title = heading?.[1].trim() || file.name.replace(/\.md$/i, "");
if (heading?.index !== undefined) {
body = `${body.slice(0, heading.index)}${body.slice(heading.index + heading[0].length)}`
.trim()
.replace(/\n{3,}/g, "\n\n");
}
if (!body) throw new Error("Markdown 文件中没有可导入的正文内容");
result = await api("/articles", { method: "POST", body: { title, category: categories[0], body } });
} else {
const dataUrl = await new Promise((resolve, reject) => {
const reader = new FileReader();
reader.onload = () => resolve(reader.result);
reader.onerror = reject;
reader.readAsDataURL(file);
});
result = await api("/imports/word", {
method: "POST",
body: { fileName: file.name, category: categories[0], dataUrl: String(dataUrl).replace(/^data:[^;,]*;/, `data:${DOCX_MIME};`) },
});
}
const successMessage = extension === ".docx"
? `导入成功：已创建草稿并提取 ${result.imageCount} 张图片`
: "导入成功：已创建 Markdown 草稿";
$("#import-status").textContent = successMessage;
await openEditor(result.slug);
$("#message").textContent = successMessage;
} catch (error) {
$("#import-status").textContent = error.message;
}
});
$("#back").addEventListener("click", () => {
if (dirty && !confirm("还有未保存的内容，确定返回文章列表吗？")) return;
setView(false);
loadArticles();
});
function payload() {
return {
title: $("#title").value.trim(),
category: $("#category").value,
body: $("#body").value,
};
}
async function save() {
const result = editingSlug
? await api(`/articles/${editingSlug}`, { method: "PUT", body: payload() })
: await api("/articles", { method: "POST", body: payload() });
editingSlug = result.slug;
dirty = false;
setEditorStatus(result.publishStatus);
return result.slug;
}
$("#edit-form").addEventListener("submit", async (event) => {
event.preventDefault();
$("#message").textContent = "正在保存…";
try {
await save();
$("#message").textContent = editingStatus === "live" ? "内容与线上版本一致。" : "草稿已保存，线上版本没有改变。";
} catch (error) { $("#message").textContent = error.message; }
});
$("#publish").addEventListener("click", async () => {
$("#message").textContent = "正在保存草稿…";
try {
const slug = await save();
await triggerBuild(`/articles/${slug}/publish`);
setEditorStatus("live");
$("#message").textContent = "发布成功，官网已更新。";
} catch (error) { $("#message").textContent = error.message; }
});
$("#discard").addEventListener("click", async () => {
if (!editingSlug) return;
if (!confirm("确定放弃未发布的修改，恢复为当前线上版本吗？")) return;
try {
const result = await api(`/articles/${editingSlug}/draft`, { method: "DELETE" });
dirty = false;
if (result.removed) { setView(false); loadArticles(); }
else await openEditor(editingSlug);
} catch (error) { $("#message").textContent = error.message; }
});
$("#unpublish").addEventListener("click", async () => {
if (!editingSlug) return;
const detail = editingStatus === "edited-draft" ? "未发布的修改会继续保留为草稿。" : "文章内容会继续保留为草稿。";
if (!confirm(`确定将这篇文章从官网下架吗？${detail}`)) return;
$("#more-actions").open = false;
$("#message").textContent = "正在下架文章…";
try {
await triggerBuild(`/articles/${editingSlug}/unpublish`, { action: "下架" });
setEditorStatus("new-draft");
$("#message").textContent = "文章已下架，内容已保留为草稿。";
} catch (error) { $("#message").textContent = error.message; }
});
$("#delete-article").addEventListener("click", async () => {
if (!editingSlug) return;
const prompt = editingStatus === "new-draft"
? "确定彻底删除这篇草稿吗？删除后无法恢复。"
: "确定彻底删除这篇文章吗？线上版本和草稿都会删除，且无法恢复。";
if (!confirm(prompt)) return;
$("#more-actions").open = false;
$("#message").textContent = "正在删除文章…";
try {
await triggerBuild(`/articles/${editingSlug}`, { action: "删除", method: "DELETE" });
dirty = false;
editingSlug = null;
setView(false);
await loadArticles();
} catch (error) { $("#message").textContent = error.message; }
});
async function renderPreview() {
const body = $("#body").value.trim();
if (!body) { $("#preview").innerHTML = ""; return; }
const request = ++previewRequest;
try {
const result = await api("/preview", { method: "POST", body: { body } });
if (request === previewRequest) $("#preview").innerHTML = result.html;
} catch {
if (request === previewRequest) $("#preview").textContent = "预览暂时不可用";
}
}
function schedulePreview(delay = 350) {
clearTimeout(previewTimer);
previewTimer = setTimeout(renderPreview, delay);
}
$("#title").addEventListener("input", () => { dirty = true; });
$("#body").addEventListener("input", () => { dirty = true; schedulePreview(); });
$("#upload-button").addEventListener("click", () => $("#file").click());
$("#file").addEventListener("change", async (event) => {
const file = event.target.files?.[0];
event.target.value = "";
if (!file) return;
if (file.size > MAX_UPLOAD_SIZE) {
$("#upload-status").textContent = "图片不能超过 20MB";
return;
}
$("#upload-status").textContent = "上传中…";
try {
const dataUrl = await new Promise((resolve, reject) => {
const reader = new FileReader();
reader.onload = () => resolve(reader.result);
reader.onerror = reject;
reader.readAsDataURL(file);
});
const result = await api("/uploads", { method: "POST", body: { dataUrl } });
const textarea = $("#body");
const start = textarea.selectionStart;
const markdown = `\n![${file.name}](${result.url})\n`;
textarea.value = textarea.value.slice(0, start) + markdown + textarea.value.slice(textarea.selectionEnd);
textarea.dispatchEvent(new Event("input"));
$("#upload-status").textContent = "图片已插入";
} catch (error) { $("#upload-status").textContent = error.message; }
});
async function triggerBuild(endpoint, { action = "发布", method = "POST", body } = {}) {
show("#build-modal");
hide("#close-modal");
$("#build-title").textContent = `正在${action}…`;
$("#build-log").textContent = "系统正在更新官网，请稍候。";
try {
await api(endpoint, { method, body });
} catch (error) {
$("#build-title").textContent = `${action}失败`;
$("#build-log").textContent = error.message;
show("#close-modal");
throw error;
}
while (true) {
await new Promise((resolve) => setTimeout(resolve, 1000));
const state = await api("/build");
if (state.status === "building") continue;
if (state.ok) { hide("#build-modal"); return; }
$("#build-title").textContent = `${action}失败`;
$("#build-log").textContent = state.log || `${action}失败，请联系技术人员。`;
show("#close-modal");
throw new Error(`${action}失败，原文章已恢复，请检查操作日志。`);
}
}
$("#close-modal").addEventListener("click", () => hide("#build-modal"));
boot();
public/admin/style.css 0 → 100644
View file @ ad00ed3a
:root {
--primary: #0868AC;
--primary-dark: #164A72;
--deep: #103C5B;
--light: #EEF7FC;
--bg: #FCFDFC;
--surface: #fff;
--text: #142033;
--muted: #6b7280;
--border: #E2E8F0;
--danger: #c04444;
font-family: "PingFang SC", "Microsoft YaHei", system-ui, sans-serif;
}
* { box-sizing: border-box; }
body { margin: 0; color: var(--text); background: var(--bg); }
.hidden { display: none !important; }
button, input, textarea, select { font: inherit; }
button, .button { min-height: 40px; padding: 0 17px; display: inline-flex; align-items: center; justify-content: center; border: 0; border-radius: 999px; cursor: pointer; text-decoration: none; transition: .18s ease; }
.primary { color: white; background: var(--primary-dark); }
.primary:hover { background: var(--deep); transform: translateY(-1px); }
.ghost { color: var(--primary-dark); background: transparent; border: 1px solid var(--border); }
.ghost:hover { border-color: var(--primary); }
.small { min-height: 34px; padding-inline: 13px; font-size: 12px; }
.error { min-height: 20px; color: var(--danger); font-size: 13px; }
.login { min-height: 100vh; padding: 24px; display: grid; place-items: center; background: var(--light); }
.login-card { width: min(420px, 100%); padding: 42px; display: grid; gap: 16px; background: white; border: 1px solid var(--border); border-radius: 22px; box-shadow: 0 24px 60px rgba(15,35,60,.12); }
.brand-mark { color: var(--primary); font-size: 14px; font-weight: 700; letter-spacing: .18em; }
.login-card h1 { margin: 0; font-size: 30px; }
.login-card p { margin: -8px 0 4px; color: var(--muted); }
.login-card label, .field-panel label, .field-label { display: grid; gap: 7px; color: var(--muted); font-size: 13px; }
.captcha-row { display: flex; align-items: stretch; gap: 10px; }
.captcha-row input { min-width: 0; flex: 1; text-transform: uppercase; }
#captcha-image { width: 132px; height: 46px; flex: 0 0 auto; cursor: pointer; background: var(--light); border: 1px solid var(--border); border-radius: 9px; }
input, textarea, select { width: 100%; padding: 11px 13px; color: var(--text); background: white; border: 1px solid var(--border); border-radius: 9px; }
input:focus, textarea:focus, select:focus { outline: 2px solid rgba(20,115,230,.14); border-color: var(--primary); }
.topbar { min-height: 68px; padding: 12px 28px; position: sticky; top: 0; z-index: 10; display: flex; align-items: center; justify-content: space-between; gap: 22px; color: white; background: #071D3B; }
.topbar > div:first-child { display: flex; align-items: center; gap: 13px; }
.topbar strong { color: var(--primary); font-size: 19px; }
.topbar span { font-size: 13px; opacity: .76; }
.top-actions { display: flex; align-items: center; gap: 9px; }
.topbar .ghost { color: white; border-color: rgba(255,255,255,.24); }
.pending-badge { padding: 5px 10px; color: #ffe49b; background: rgba(255,206,94,.12); border: 1px solid rgba(255,206,94,.3); border-radius: 999px; }
.view { width: min(1120px, calc(100% - 40px)); margin: 0 auto; padding: 44px 0 70px; }
.view-head { margin-bottom: 26px; display: flex; align-items: center; justify-content: space-between; gap: 18px; }
.view-head p { margin: 0 0 5px; color: var(--primary-dark); font-size: 11px; font-weight: 700; letter-spacing: .16em; }
.view-head h1 { margin: 0; font-size: 30px; }
.view-actions { display: flex; gap: 9px; }
.import-status { min-height: 20px; margin: -16px 0 12px; color: var(--muted); font-size: 13px; text-align: right; }
.article-list { display: grid; gap: 10px; }
.article-row { padding: 18px 20px; display: flex; align-items: center; justify-content: space-between; gap: 20px; background: white; border: 1px solid var(--border); border-radius: 14px; }
.article-summary { min-width: 0; flex: 1; }
.article-row h2 { margin: 0 0 8px; font-size: 17px; }
.article-row p { margin: 0; display: flex; flex-wrap: wrap; gap: 8px 13px; align-items: center; color: var(--muted); font-size: 12px; }
.article-row code { color: #9a8d7e; }
.status { padding: 2px 8px; border-radius: 999px; }
.status.live { color: #0D966A; background: #DFF8EE; }
.status.new-draft { color: #916300; background: #fff2c7; }
.status.edited-draft { color: #9c4c22; background: #ffeadc; }
.row-actions { display: flex; align-items: center; gap: 8px; flex: 0 0 auto; }
.row-actions button:disabled { cursor: default; opacity: .48; transform: none; }
.row-more-actions summary { min-height: 34px; padding-inline: 13px; font-size: 12px; }
.row-more-actions .action-menu { top: calc(100% + 8px); bottom: auto; z-index: 12; }
.empty { padding: 70px; color: var(--muted); text-align: center; background: white; border: 1px dashed var(--border); border-radius: 14px; }
#edit-form { display: grid; gap: 18px; }
.field-panel, .editor-panel { padding: 24px; background: white; border: 1px solid var(--border); border-radius: 16px; }
.field-panel { display: grid; gap: 15px; }
.field-panel small { font-weight: 400; opacity: .8; }
.field-row { display: grid; grid-template-columns: 1fr 1fr; gap: 15px; }
.custom-select { position: relative; }
.select-trigger { width: 100%; padding: 0 13px; justify-content: space-between; color: var(--text); background: white; border: 1px solid var(--border); border-radius: 9px; text-align: left; }
.select-trigger:hover, .custom-select.open .select-trigger { border-color: var(--primary); }
.custom-select.open .select-trigger { outline: 2px solid rgba(20,115,230,.14); }
.select-chevron { color: var(--muted); transition: transform .18s ease; }
.custom-select.open .select-chevron { transform: rotate(180deg); }
.select-menu { width: 100%; margin-top: 7px; position: absolute; z-index: 20; overflow: hidden; background: white; border: 1px solid var(--border); border-radius: 12px; box-shadow: 0 18px 45px rgba(15,35,60,.16); }
.select-options { max-height: 220px; padding: 7px; display: grid; gap: 2px; overflow-y: auto; }
.select-option { width: 100%; min-height: 40px; padding: 0 11px; justify-content: space-between; color: var(--text); background: transparent; border-radius: 8px; }
.select-option:hover { background: #F1F7FF; }
.select-option[aria-selected="true"] { color: var(--primary-dark); background: #EAF3FF; font-weight: 600; }
.option-check { opacity: 0; color: var(--primary-dark); }
.select-option[aria-selected="true"] .option-check { opacity: 1; }
.category-create { padding: 12px; background: #F7F9FC; border-top: 1px solid var(--border); }
.category-create > span { display: block; margin-bottom: 8px; color: var(--text); font-weight: 600; }
.category-create > div { display: flex; gap: 8px; }
.category-create input { min-width: 0; }
.category-create button { min-width: 68px; flex: 0 0 auto; white-space: nowrap; }
.category-create .error { min-height: 0; margin: 6px 2px 0; }
.editor-titlebar { align-items: flex-end; }
.editor-titlebar > div { display: grid; gap: 12px; }
.editor-titlebar > .status { margin-bottom: 4px; padding: 6px 12px; font-size: 13px; }
.back-button { min-height: auto; width: max-content; padding: 0; color: var(--muted); background: transparent; border-radius: 0; }
.back-button:hover { color: var(--primary-dark); }
.version-note { margin: -12px 0 18px; padding: 13px 16px; color: #6b5a4f; background: #F8EEE6; border: 1px solid var(--border); border-radius: 11px; font-size: 13px; }
.auto-meta { margin: 0; padding: 11px 13px; color: var(--muted); background: #F7F9FC; border-radius: 9px; font-size: 12px; }
.editor-head { margin-bottom: 13px; display: flex; align-items: center; justify-content: space-between; gap: 15px; }
.editor-head > div { display: flex; align-items: center; gap: 9px; }
.editor-head small { color: var(--muted); font-size: 12px; font-weight: 400; }
#upload-status { color: var(--muted); font-size: 12px; }
.editor-grid { min-height: 480px; display: grid; grid-template-columns: 1fr 1fr; gap: 14px; }
#body { min-height: 480px; resize: vertical; font-family: inherit; font-size: 15px; line-height: 1.8; }
.preview { padding: 22px; overflow: auto; background: #F9FCFF; border: 1px solid var(--border); border-radius: 9px; line-height: 1.8; }
.preview:empty::before { content: "文章预览会显示在这里"; color: var(--muted); }
.preview h1, .preview h2, .preview h3 { color: var(--primary-dark); }
.preview img { max-width: 100%; }
.edit-actions { padding: 15px 18px; position: sticky; bottom: 14px; z-index: 5; display: flex; align-items: center; gap: 10px; background: rgba(255,255,255,.96); border: 1px solid var(--border); border-radius: 14px; box-shadow: 0 12px 32px rgba(75,34,26,.1); backdrop-filter: blur(10px); }
.save-button { background: white; }
.more-actions { position: relative; }
.more-actions summary { min-height: 40px; padding: 0 15px; display: flex; align-items: center; color: var(--muted); background: white; border: 1px solid var(--border); border-radius: 999px; cursor: pointer; font-size: 13px; list-style: none; }
.more-actions summary::-webkit-details-marker { display: none; }
.more-actions summary::after { content: "⌄"; margin-left: 7px; transition: transform .18s ease; }
.more-actions[open] summary::after { transform: rotate(180deg); }
.more-actions[open] summary { color: var(--primary-dark); border-color: var(--primary); }
.action-menu { min-width: 180px; padding: 7px; position: absolute; right: 0; bottom: calc(100% + 8px); display: grid; gap: 2px; background: white; border: 1px solid var(--border); border-radius: 11px; box-shadow: 0 14px 36px rgba(75,34,26,.16); }
.menu-action { width: 100%; min-height: 38px; padding: 0 11px; justify-content: flex-start; color: var(--text); background: transparent; border-radius: 7px; font-size: 13px; }
.menu-action:hover { background: #FAF1EA; }
.menu-action.danger { color: var(--danger); }
.menu-action.danger:hover { background: #fff0f0; }
#message { margin-left: 8px; color: var(--muted); font-size: 13px; }
.modal { position: fixed; inset: 0; z-index: 30; padding: 20px; display: grid; place-items: center; background: rgba(0,0,0,.6); }
.modal-card { width: min(780px, 100%); max-height: 82vh; background: white; border-radius: 16px; overflow: hidden; }
.modal-card > div { padding: 15px 18px; display: flex; align-items: center; justify-content: space-between; border-bottom: 1px solid var(--border); }
.category-manager { width: min(680px, 100%); }
.modal-card > .modal-head { padding: 18px 20px; }
.modal-head > div { display: grid; gap: 4px; }
.modal-head small { color: var(--muted); font-size: 12px; font-weight: 400; }
.password-card { width: min(500px, 100%); }
.modal-card > .password-form { padding: 20px; display: grid; gap: 14px; border: 0; }
.password-form label { display: grid; gap: 7px; color: var(--muted); font-size: 13px; }
.password-hint { margin: 0; color: var(--muted); font-size: 12px; line-height: 1.6; }
.password-form .error { margin: -4px 0 0; }
.password-actions { display: flex; justify-content: flex-end; gap: 9px; }
.modal-card > .category-manager-body { max-height: 68vh; padding: 20px; display: block; overflow-y: auto; border: 0; }
.manager-create { display: flex; gap: 9px; }
.manager-create input { min-width: 0; }
.manager-create button { flex: 0 0 auto; white-space: nowrap; }
.category-manager-list { margin-top: 8px; display: grid; gap: 8px; }
.category-manager-row { padding: 13px 14px; background: #FAF7F1; border: 1px solid var(--border); border-radius: 11px; }
.category-row-main { display: flex; align-items: center; justify-content: space-between; gap: 16px; }
.category-row-name { min-width: 0; display: grid; gap: 3px; }
.category-row-name strong { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.category-row-name span { color: var(--muted); font-size: 12px; }
.category-row-actions { display: flex; gap: 5px; }
.category-row-actions button { min-height: 32px; padding-inline: 10px; font-size: 12px; }
.category-row-actions .danger { color: var(--danger); }
.category-row-actions button:disabled { cursor: not-allowed; opacity: .45; }
.category-inline-panel { margin-top: 11px; padding-top: 11px; display: grid; gap: 9px; border-top: 1px solid var(--border); }
.category-inline-panel p { margin: 0; color: var(--muted); font-size: 12px; }
.category-rename-form { display: flex; gap: 8px; }
.category-rename-form input { min-width: 0; }
.category-inline-actions, .replacement-options { display: flex; flex-wrap: wrap; gap: 7px; }
.category-inline-actions button, .replacement-options button { min-height: 32px; padding-inline: 11px; font-size: 12px; }
.confirm-danger { color: white; background: var(--danger); }
.replacement-options button { color: var(--primary-dark); background: white; border: 1px solid var(--border); }
.replacement-options button:hover { border-color: var(--primary); background: #FBEAE6; }
.build-card { width: min(780px, 100%); }
#build-log { max-height: 62vh; margin: 0; padding: 18px; overflow: auto; color: var(--muted); background: #faf7f1; white-space: pre-wrap; font-size: 12px; }
@media (max-width: 760px) {
.topbar, .view-head, .article-row { align-items: flex-start; flex-direction: column; }
.top-actions { width: 100%; flex-wrap: wrap; }
.view-actions { width: 100%; }
.view-actions button { flex: 1; }
.field-row, .editor-grid { grid-template-columns: 1fr; }
.view { width: min(100% - 28px, 1120px); padding-top: 28px; }
.row-actions { width: 100%; }
.row-actions > button, .row-more-actions { flex: 1; }
.row-more-actions summary { width: 100%; justify-content: center; }
.edit-actions { flex-wrap: wrap; }
#message { width: 100%; margin: 4px 0 0; }
.login-card { padding: 30px 24px; }
.manager-create, .category-row-main, .category-rename-form { align-items: stretch; flex-direction: column; }
}
public/og-cover.svg 0 → 100644
View file @ ad00ed3a
<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630">
<rect width="1200" height="630" fill="#FCFDFC"/>
<rect x="0" y="0" width="18" height="630" fill="#F6B900"/>
<rect x="740" y="70" width="360" height="490" rx="32" fill="#EEF7FC" stroke="#DCE8EF" stroke-width="2"/>
<circle cx="920" cy="245" r="96" fill="#0868AC"/>
<path d="M854 230h132M854 258h132M880 200l40-32 40 32" fill="none" stroke="#fff" stroke-width="15" stroke-linecap="round"/>
<circle cx="1010" cy="145" r="25" fill="#F6B900"/>
<text x="82" y="118" fill="#0868AC" font-family="sans-serif" font-size="20" font-weight="700" letter-spacing="4">QIYOUXUE · 1 ON 1</text>
<text x="82" y="255" fill="#172B3A" font-family="sans-serif" font-size="76" font-weight="800">先看清问题</text>
<text x="82" y="355" fill="#0868AC" font-family="sans-serif" font-size="76" font-weight="800">再规划每一步</text>
<text x="82" y="442" fill="#4B5E6B" font-family="sans-serif" font-size="28">小学 · 初中 · 高中在线一对一个性化辅导</text>
<rect x="82" y="508" width="210" height="54" rx="9" fill="#F6B900"/>
<text x="187" y="543" text-anchor="middle" fill="#172B3A" font-family="sans-serif" font-size="20" font-weight="700">启优学一对一</text>
</svg>
public/robots.txt 0 → 100644
View file @ ad00ed3a
User-agent: *
Allow: /
Disallow: /admin/
Disallow: /api/
Sitemap: https://qiyouxueedu.com/sitemap-index.xml
public/site.webmanifest 0 → 100644
View file @ ad00ed3a
{
"name": "启优学一对一",
"short_name": "启优学",
"description": "小学初中高中在线一对一个性化辅导",
"start_url": "/",
"display": "standalone",
"background_color": "#FCFDFC",
"theme_color": "#0868AC",
"lang": "zh-CN"
}
scripts/build-site.mjs 0 → 100644
View file @ ad00ed3a
import { buildSiteAtomic, withSiteBuildLock } from "./site-build.mjs";
try {
const build = () => buildSiteAtomic({ onOutput: (text) => process.stdout.write(text) });
if (process.argv.includes("--inside-lock")) {
if (process.env.QIYOUXUE_SITE_LOCK_HELD !== "1") throw new Error("build:inside-lock 只能在共享构建锁中运行");
await build();
} else {
await withSiteBuildLock(build);
}
} catch (error) {
console.error(error instanceof Error ? error.message : error);
process.exitCode = 1;
}
scripts/create-import-fixtures.mjs 0 → 100644
View file @ ad00ed3a
import fs from "node:fs/promises";
import path from "node:path";
import { Document, HeadingLevel, ImageRun, Packer, Paragraph, TextRun } from "docx";
const root = process.cwd();
const outputDirectory = path.join(root, "tests", "fixtures");
const imageFile = path.join(root, "pic", "主页大图素材-1.png");
const marker = "QIYOUXUE-PRODUCTION-IMPORT-20260812";
await fs.mkdir(outputDirectory, { recursive: true });
await fs.writeFile(path.join(outputDirectory, "import-test.md"), [
"# 开始学情沟通前，建议家长准备这四类信息",
"",
"一次有效的学情沟通，需要把年级、教材进度、近期试卷和阶段目标放在一起观察。资料不必复杂，但应尽量准确。",
"",
"![启优学在线一对一课堂示意图]({{TEST_IMAGE_URL}})",
"",
"## 一、品牌与业务简介",
"",
"用简洁语言说明企业是谁、服务谁、解决什么问题，以及当前最重要的产品与市场。",
"",
"## 二、核心品牌与品类关键词",
"",
"整理用户可能主动搜索的品牌词、品类词、场景词和问题词，作为诊断范围的初始输入。",
"",
"## 三、重点竞品与替代方案",
"",
"列出用户在比较阶段可能同时考虑的品牌或方案，便于观察AI回答中的推荐结构。",
"",
"## 四、现有官方内容",
"",
"准备官网、公众号、产品资料和权威报道等内容入口，确认品牌事实是否统一。",
"",
"## 五、当前最关心的问题",
"",
"说明品牌是完全没有被提及、描述不准确，还是在关键问题中被竞品压制。",
"",
"启优学会结合沟通与诊断结果梳理近期任务，实际课程安排以双方确认的方案为准。",
"",
`测试标记：${marker}-MARKDOWN`,
"",
].join("\n"));
const image = await fs.readFile(imageFile);
const heading = (text) => new Paragraph({ text, heading: HeadingLevel.HEADING_2 });
const body = (text) => new Paragraph({ children: [new TextRun(text)] });
const document = new Document({
sections: [{
children: [
new Paragraph({ text: "家长如何准备一次学情沟通", heading: HeadingLevel.HEADING_1 }),
body("AI搜索可见度诊断的目标，是确认品牌在哪些问题中出现、如何被描述，以及信息来自哪些引用来源。"),
new Paragraph({ children: [new ImageRun({ data: image, transformation: { width: 320, height: 240 }, type: "png", altText: { title: "启优学测试图片", description: "用于验证Word导入图片提取", name: "test.png" } })] }),
heading("建立品牌事实基线"),
body("先确认企业名称、业务定位、产品服务、联系方式和官方表达，避免不同内容入口相互矛盾。"),
heading("定义用户问题集合"),
body("围绕认知、比较、验证和决策阶段整理问题，观察品牌和竞品在回答中的真实位置。"),
heading("记录引用与推荐语境"),
body("不仅记录是否被提及，还要确认引用来源、描述准确性和推荐理由。"),
heading("形成可持续监测范围"),
body("平台和回答会持续变化，因此诊断基线应能进入后续监测、优化与复盘。"),
body(`测试标记：${marker}-WORD`),
],
}],
});
await fs.writeFile(path.join(outputDirectory, "import-test.docx"), await Packer.toBuffer(document));
console.log(`Created fixtures in ${outputDirectory}`);
scripts/run-with-site-lock.mjs 0 → 100644
View file @ ad00ed3a
import { spawn } from "node:child_process";
import { withSiteBuildLock } from "./site-build.mjs";
const separator = process.argv.indexOf("--");
const command = separator >= 0 ? process.argv.slice(separator + 1) : [];
if (!command.length) {
console.error("用法：node scripts/run-with-site-lock.mjs -- <部署命令> [参数]");
process.exit(2);
}
await withSiteBuildLock(() => new Promise((resolve, reject) => {
const child = spawn(command[0], command.slice(1), {
stdio: "inherit",
env: { ...process.env, QIYOUXUE_SITE_LOCK_HELD: "1" },
});
child.on("error", reject);
child.on("exit", (code, signal) => {
if (code === 0) resolve();
else reject(new Error(signal ? `部署命令被信号 ${signal} 终止` : `部署命令退出码：${code}`));
});
})).catch((error) => {
console.error(error instanceof Error ? error.message : error);
process.exitCode = 1;
});
scripts/site-build.d.mts 0 → 100644
View file @ ad00ed3a
export interface BuildOptions {
onOutput?: (text: string) => void;
}
export class SiteBuildLockBusyError extends Error {}
export function tryAcquireSiteBuildLock(): Promise<(() => Promise<void>) | null>;
export function withSiteBuildLock<T>(task: () => Promise<T>, options?: { timeoutMs?: number }): Promise<T>;
export function buildSiteAtomic(options?: BuildOptions): Promise<string>;
scripts/site-build.mjs 0 → 100644
View file @ ad00ed3a
import crypto from "node:crypto";
import fs from "node:fs/promises";
import os from "node:os";
import path from "node:path";
import { spawn } from "node:child_process";
const ROOT = process.cwd();
const RUNTIME_DIR = path.join(ROOT, ".runtime");
const DEFAULT_LOCK = process.env.CMS_DATA_DIR
? path.join(path.resolve(process.env.CMS_DATA_DIR), ".site-build.lock")
: path.join(RUNTIME_DIR, "site-build.lock");
const LOCK_FILE = path.resolve(process.env.CMS_BUILD_LOCK || DEFAULT_LOCK);
const RECOVERY_LOCK_FILE = `${LOCK_FILE}.recovery`;
const ASTRO_BIN = path.join(ROOT, "node_modules", "astro", "astro.js");
const DIST_DIR = path.join(ROOT, "dist");
const MAX_LOG_LENGTH = 2 * 1024 * 1024;
export class SiteBuildLockBusyError extends Error {
constructor() {
super("网站正在部署或生成静态页面，请稍后重试");
this.name = "SiteBuildLockBusyError";
}
}
const delay = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
async function fileExists(file) {
try { await fs.access(file); return true; } catch { return false; }
}
function processIsAlive(pid) {
if (!Number.isInteger(pid) || pid <= 0) return false;
try { process.kill(pid, 0); return true; } catch { return false; }
}
async function removeStaleLock() {
let recoveryHandle;
try {
recoveryHandle = await fs.open(RECOVERY_LOCK_FILE, "wx");
const raw = await fs.readFile(LOCK_FILE, "utf8");
const lock = JSON.parse(raw);
const sameHost = lock.hostname === os.hostname();
if (sameHost && !processIsAlive(Number(lock.pid))) {
await fs.unlink(LOCK_FILE);
return true;
}
} catch (error) {
if (error.code === "ENOENT") return true;
if (error.code === "EEXIST") return false;
} finally {
if (recoveryHandle) {
await recoveryHandle.close().catch(() => {});
await fs.unlink(RECOVERY_LOCK_FILE).catch(() => {});
}
}
return false;
}
async function acquireSiteBuildLock(timeoutMs = 15 * 60 * 1000) {
await fs.mkdir(path.dirname(LOCK_FILE), { recursive: true });
const started = Date.now();
const token = crypto.randomBytes(12).toString("hex");
while (true) {
try {
const handle = await fs.open(LOCK_FILE, "wx");
await handle.writeFile(JSON.stringify({ token, pid: process.pid, hostname: os.hostname(), startedAt: new Date().toISOString() }));
await handle.close();
return async () => {
try {
const current = JSON.parse(await fs.readFile(LOCK_FILE, "utf8"));
if (current.token === token) await fs.unlink(LOCK_FILE);
} catch (error) {
if (error.code !== "ENOENT") throw error;
}
};
} catch (error) {
if (error.code !== "EEXIST") throw error;
if (await removeStaleLock()) continue;
if (Date.now() - started >= timeoutMs) throw new SiteBuildLockBusyError();
await delay(300);
}
}
}
export async function tryAcquireSiteBuildLock() {
try {
return await acquireSiteBuildLock(0);
} catch (error) {
if (error instanceof SiteBuildLockBusyError) return null;
throw error;
}
}
export async function withSiteBuildLock(task, options = {}) {
const release = await acquireSiteBuildLock(options.timeoutMs);
try { return await task(); } finally { await release(); }
}
function runAstro(command, env, onOutput) {
return new Promise((resolve, reject) => {
const child = spawn(process.execPath, [ASTRO_BIN, command], { cwd: ROOT, env: { ...process.env, ...env } });
let log = "";
const append = (chunk) => {
const text = chunk.toString();
log = `${log}${text}`.slice(-MAX_LOG_LENGTH);
onOutput?.(text);
};
child.stdout.on("data", append);
child.stderr.on("data", append);
child.on("error", reject);
child.on("exit", (code) => code === 0 ? resolve(log) : reject(Object.assign(new Error(`astro ${command} 执行失败`), { log })));
});
}
export async function buildSiteAtomic(options = {}) {
await fs.mkdir(RUNTIME_DIR, { recursive: true });
const id = `${Date.now()}-${process.pid}-${crypto.randomBytes(4).toString("hex")}`;
const temporary = path.join(RUNTIME_DIR, `dist-${id}`);
const backup = path.join(RUNTIME_DIR, `dist-backup-${id}`);
let movedCurrent = false;
let log = "";
try {
log += await runAstro("check", {}, options.onOutput);
log += await runAstro("build", { QIYOUXUE_BUILD_OUT_DIR: temporary }, options.onOutput);
if (await fileExists(DIST_DIR)) {
await fs.rename(DIST_DIR, backup);
movedCurrent = true;
}
try {
await fs.rename(temporary, DIST_DIR);
} catch (error) {
if (movedCurrent) await fs.rename(backup, DIST_DIR);
throw error;
}
if (movedCurrent) {
await fs.rm(backup, { recursive: true, force: true }).catch((error) => {
options.onOutput?.(`\n旧构建目录清理失败，可稍后手动清理：${error.message}\n`);
});
}
return log;
} catch (error) {
await fs.rm(temporary, { recursive: true, force: true });
if (movedCurrent && !await fileExists(DIST_DIR) && await fileExists(backup)) await fs.rename(backup, DIST_DIR);
if (error.log) error.log = `${log}${error.log}`.slice(-MAX_LOG_LENGTH);
else error.log = log;
throw error;
}
}
scripts/upload-import-fixtures.mjs 0 → 100644
View file @ ad00ed3a
import assert from "node:assert/strict";
import fs from "node:fs/promises";
import path from "node:path";
const baseUrl = process.env.CMS_BASE_URL || "http://127.0.0.1:8793";
const apiKey = process.env.CMS_API_KEY;
if (!apiKey) throw new Error("CMS_API_KEY 未配置");
const headers = { Authorization: `Bearer ${apiKey}` };
const jsonHeaders = { ...headers, "Content-Type": "application/json" };
async function request(route, options = {}) {
const response = await fetch(`${baseUrl}/api/cms${route}`, {
...options,
headers: { ...headers, ...options.headers },
});
const payload = await response.json().catch(() => ({}));
if (!response.ok) throw new Error(`${options.method || "GET"} ${route} 返回 ${response.status}：${payload.error || "未知错误"}`);
return payload;
}
const categories = await request("/categories");
for (const required of ["学情指南", "学习方法"]) assert.ok(categories.categories.includes(required));
const image = await fs.readFile(path.resolve("pic/主页大图素材-1.png"));
const uploadedImage = await request("/uploads", {
method: "POST",
headers: jsonHeaders,
body: JSON.stringify({ dataUrl: `data:image/png;base64,${image.toString("base64")}` }),
});
const markdownFile = path.resolve("tests/fixtures/import-test.md");
let markdown = await fs.readFile(markdownFile, "utf8");
const heading = markdown.match(/^#\s+(.+)$/m);
assert.ok(heading?.index !== undefined);
const markdownTitle = heading[1].trim();
markdown = `${markdown.slice(0, heading.index)}${markdown.slice(heading.index + heading[0].length)}`
.trim()
.replace("{{TEST_IMAGE_URL}}", uploadedImage.url);
const markdownImport = await request("/articles", {
method: "POST",
headers: jsonHeaders,
body: JSON.stringify({ title: markdownTitle, category: "学情指南", body: markdown }),
});
const docxFile = path.resolve("tests/fixtures/import-test.docx");
const docx = await fs.readFile(docxFile);
const wordImport = await request("/imports/word", {
method: "POST",
headers: jsonHeaders,
body: JSON.stringify({
fileName: path.basename(docxFile),
category: "学习方法",
dataUrl: `data:application/vnd.openxmlformats-officedocument.wordprocessingml.document;base64,${docx.toString("base64")}`,
}),
});
const markdownArticle = await request(`/articles/${markdownImport.slug}`);
const wordArticle = await request(`/articles/${wordImport.slug}`);
assert.equal(markdownImport.publishStatus, "new-draft");
assert.equal(markdownArticle.title, markdownTitle);
assert.equal(markdownArticle.category, "学情指南");
assert.match(markdownArticle.body, /QIYOUXUE-PRODUCTION-IMPORT-20260812-MARKDOWN/);
assert.match(markdownArticle.body, new RegExp(uploadedImage.url.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")));
assert.equal(wordImport.publishStatus, "new-draft");
assert.equal(wordImport.title, "家长如何准备一次学情沟通");
assert.equal(wordImport.imageCount, 1);
assert.equal(wordArticle.category, "学习方法");
assert.match(wordArticle.body, /QIYOUXUE-PRODUCTION-IMPORT-20260812-WORD/);
assert.doesNotMatch(wordArticle.body, /^#\s+家长如何准备一次学情沟通/m);
const wordImageUrl = wordArticle.body.match(/!\[[^\]]*\]\((\/uploads\/[^)]+)\)/)?.[1];
assert.ok(wordImageUrl);
for (const imageUrl of [uploadedImage.url, wordImageUrl]) {
const response = await fetch(`${baseUrl}${imageUrl}`);
assert.equal(response.status, 200);
assert.equal(response.headers.get("content-type"), "image/png");
assert.deepEqual(Buffer.from(await response.arrayBuffer()), image);
}
console.log(JSON.stringify({
markdown: { slug: markdownImport.slug, title: markdownArticle.title, imageUrl: uploadedImage.url, publishStatus: markdownImport.publishStatus },
word: { slug: wordImport.slug, title: wordImport.title, imageUrl: wordImageUrl, imageCount: wordImport.imageCount, publishStatus: wordImport.publishStatus, warnings: wordImport.warnings },
}, null, 2));
server.mjs 0 → 100644
View file @ ad00ed3a
process.env.PORT ||= process.env.CMS_PORT || "8793";
process.env.HOST ||= "127.0.0.1";
await import("./dist/server/entry.mjs");
src/components/ArticleListing.astro 0 → 100644
View file @ ad00ed3a
---
import { fmtDate, paginationWindow, type Article, type CategoryInfo } from "../lib/articles";
interface Props {
items: Article[];
categories: CategoryInfo[];
totalCount: number;
activeSlug: string | null;
currentPage: number;
lastPage: number;
basePath: string;
}
const { items, categories, totalCount, activeSlug, currentPage, lastPage, basePath } = Astro.props as Props;
const pageHref = (page: number) => page <= 1 ? `${basePath}/` : `${basePath}/page/${page}/`;
const pages = paginationWindow(currentPage, lastPage);
---
<nav class="article-tabs" aria-label="学习资讯分类">
<a class:list={["article-tab", { active: activeSlug === null }]} href="/articles/">全部 <span>{totalCount}</span></a>
{categories.map((category) => (
<a class:list={["article-tab", { active: activeSlug === category.slug }]} href={`/articles/topic/${category.slug}/`}>
{category.name} <span>{category.count}</span>
</a>
))}
</nav>
{items.length ? (
<div class="article-grid">
{items.map((item, index) => (
<article class="article-card" data-reveal>
<a href={`/articles/${item.id}/`} aria-label={`阅读：${item.data.title}`}>
<div class="article-card__meta">
<span>{item.data.category}</span><time datetime={fmtDate(item.data.date)}>{fmtDate(item.data.date)}</time>
</div>
<div class="article-card__index">{String((currentPage - 1) * 9 + index + 1).padStart(2, "0")}</div>
<h2>{item.data.title}</h2>
<p>{item.data.excerpt}</p>
<strong>阅读全文 <span>↗</span></strong>
</a>
</article>
))}
</div>
) : <p class="article-empty">该分类暂时还没有文章。</p>}
{lastPage > 1 && (
<nav class="article-pagination" aria-label="资讯分页">
{currentPage > 1 ? <a href={pageHref(currentPage - 1)} rel="prev">←</a> : <span aria-hidden="true">←</span>}
{pages.map((page) => page === 0
? <span class="gap">…</span>
: page === currentPage
? <span class="active" aria-current="page">{page}</span>
: <a href={pageHref(page)}>{page}</a>
)}
{currentPage < lastPage ? <a href={pageHref(currentPage + 1)} rel="next">→</a> : <span aria-hidden="true">→</span>}
</nav>
)}
src/components/ArticlesView.astro 0 → 100644
View file @ ad00ed3a
---
import Base from "../layouts/Base.astro"; import Header from "./Header.astro"; import Footer from "./Footer.astro"; import ArticleListing from "./ArticleListing.astro"; import { site } from "../data/site"; import { PAGE_SIZE, type Article, type CategoryInfo } from "../lib/articles";
interface Props { items: Article[]; categories: CategoryInfo[]; totalCount: number; activeSlug: string | null; activeName: string | null; currentPage: number; lastPage: number; basePath: string; }
const {items,categories,totalCount,activeSlug,activeName,currentPage,lastPage,basePath}=Astro.props as Props; const heading=activeName??"学习资讯"; const pageSuffix=currentPage>1?`｜第${currentPage}页`:""; const title=`${heading}${pageSuffix}｜${site.brand.name}`; const description=activeName?`启优学${activeName}分类文章，分享学情判断、学科方法与家庭学习规划。`:"启优学学习资讯：关于小初高学情判断、学习方法、阶段复习和在线一对一服务的公开说明。"; const keywords=[heading,"学习方法","学情诊断","在线一对一",site.brand.name]; const pageUrl=new URL(`${basePath}${currentPage>1?`/page/${currentPage}`:""}/`,Astro.site).href; const jsonLd={"@context":"https://schema.org","@type":"CollectionPage",name:heading,description,url:pageUrl,inLanguage:"zh-CN",mainEntity:{"@type":"ItemList",itemListElement:items.map((item,index)=>({"@type":"ListItem",position:(currentPage-1)*PAGE_SIZE+index+1,name:item.data.title,url:new URL(`/articles/${item.id}/`,Astro.site).href}))}};
---
<Base {title} {description} {keywords} {jsonLd}><Header /><main id="main-content"><section class="page-hero"><div class="container page-hero__inner" data-reveal><div class="breadcrumb"><a href="/">首页</a> / <a href="/articles/">学习资讯</a>{activeName&&` / ${activeName}`}</div><div class="eyebrow"><span></span>LEARNING NOTES</div><h1>{heading}</h1><p>{description}</p></div></section><section class="section-pad section-blue"><div class="container"><ArticleListing {items} {categories} {totalCount} {activeSlug} {currentPage} {lastPage} {basePath} /></div></section></main><Footer /></Base>
src/components/CTA.astro 0 → 100644
View file @ ad00ed3a
---
import { site } from "../data/site";
interface Props { title?: string; text?: string; }
const { title = "先了解学情，再决定怎么学", text = "准备学生年级、意向学科、近期试卷或错题与阶段目标，领取一对一专属学情分析。" } = Astro.props;
---
<section class="cta-band"><div class="container cta-band__inner" data-reveal><div><div class="eyebrow eyebrow--light"><span></span>START WITH LEARNING PROFILE</div><h2>{title}</h2><p>{text}</p></div><div class="cta-band__actions"><a class="button button--yellow" href="/contact/">预约学情分析 <span>↗</span></a><a class="text-link text-link--light" href={`tel:${site.contact.phone}`}>电话 {site.contact.phoneDisplay}</a></div></div></section>
src/components/ContactDialog.astro 0 → 100644
View file @ ad00ed3a
---
import { site } from "../data/site";
---
<dialog class="contact-dialog" data-contact-dialog aria-labelledby="contact-dialog-title"><div class="contact-dialog__panel"><button class="contact-dialog__close" type="button" data-contact-dialog-close aria-label="关闭联系方式弹窗">×</button><div class="contact-dialog__heading"><div class="eyebrow"><span></span>COURSE CONSULTATION</div><h2 id="contact-dialog-title">从一次学情沟通开始</h2><p>准备学生年级、地区、意向学科、当前情况与阶段目标，我们会协助梳理下一步。</p></div><div class="contact-dialog__grid"><article><span>01</span><h3>官方电话</h3><a class="contact-dialog__primary" href={`tel:${site.contact.phone}`}>{site.contact.phoneDisplay}</a><p>周一至周日 · 7×24 小时</p></article><article><span>02</span><h3>微信小程序</h3><strong>启优学一对一</strong><p>搜索小程序名称提交咨询</p></article><article><span>03</span><h3>联系邮箱</h3><a class="contact-dialog__primary contact-dialog__email" href={`mailto:${site.contact.email}`}>{site.contact.email}</a><p>服务反馈与商务合作</p></article><article><span>04</span><h3>官方网站</h3><a class="contact-dialog__primary contact-dialog__website" href={`https://${site.contact.website}/`}>{site.contact.website}</a><p>启优学官方信息窗口</p></article></div></div></dialog>
src/components/Footer.astro 0 → 100644
View file @ ad00ed3a
---
import logo from "../../pic/启优学LOGO-白底.jpg";
import { site } from "../data/site";
---
<footer class="site-footer"><div class="container footer-grid">
<div class="footer-brand"><a href="/" class="footer-logo" aria-label="启优学首页"><img src={logo.src} width="1725" height="970" loading="lazy" alt="启优学一对一" /></a><p>优质师资直达，个性化辅导看得见。</p><div class="footer-tags"><span>小学</span><span>初中</span><span>高中</span></div></div>
<div><h2>了解启优学</h2><a href="/about/">关于我们</a><a href="/methodology/">教学服务</a><a href="/articles/">学习资讯</a><a href="/faq/">常见问题</a></div>
<div><h2>学习需求</h2>{site.services.map((item) => <a href={`/services/${item.slug}/`}>{item.name}</a>)}</div>
<div class="footer-contact"><h2>课程咨询</h2><a class="footer-phone" href={`tel:${site.contact.phone}`}>{site.contact.phoneDisplay}</a><p>周一至周日 · 7×24 小时</p><a href={`mailto:${site.contact.email}`}>{site.contact.email}</a><a class="footer-arrow" href="/contact/">预约学情分析 <span>↗</span></a></div>
</div><div class="container footer-bottom"><p>© {new Date().getFullYear()} 启优学一对一</p><p><a href="https://beian.miit.gov.cn/" rel="nofollow">冀ICP备2025133748号-7</a> · 具体课程、教师、时间与费用以咨询确认方案为准</p></div></footer>
src/components/Header.astro 0 → 100644
View file @ ad00ed3a
---
import logo from "../../pic/启优学LOGO-白底.jpg";
import { site } from "../data/site";
import { categoryToSlug, getCategoryNames } from "../lib/articles";
const path = Astro.url.pathname;
const isActive = (href: string) => href === "/" ? path === "/" : path.startsWith(href);
const categoryChildren = (await getCategoryNames()).map((label) => ({ href: `/articles/topic/${categoryToSlug(label)}/`, label }));
const nav = site.nav.map((item) => item.href === "/articles/" ? { ...item, children: [{ href: "/articles/", label: "全部资讯" }, ...categoryChildren] } : item);
---
<header class="site-header" data-header>
<div class="container site-header__inner">
<a class="brand" href="/" aria-label="启优学首页"><img src={logo.src} width="1725" height="970" alt="启优学一对一" /></a>
<nav class="desktop-nav" aria-label="主导航"><ul>{nav.map((item) => <li class="nav-item"><a class="nav-link" href={item.href} aria-current={isActive(item.href) ? "page" : undefined}>{item.label}</a><div class="nav-dropdown"><ul>{item.children.map((child) => <li><a href={child.href}>{child.label}<span aria-hidden="true">↗</span></a></li>)}</ul></div></li>)}</ul></nav>
<a class="button button--small header-cta" href="/contact/">预约学情分析 <span>↗</span></a>
<details class="mobile-nav"><summary aria-label="打开导航菜单"><span></span><span></span><span></span></summary><nav data-mobile-nav aria-label="移动端导航">{nav.map((item) => <div class="mobile-nav__group"><a class="mobile-nav__primary" href={item.href} aria-current={isActive(item.href) ? "page" : undefined}>{item.label}</a><div class="mobile-subnav">{item.children.map((child) => <a href={child.href}>{child.label}</a>)}</div></div>)}<a class="button" href="/contact/">预约学情分析</a></nav></details>
</div>
</header>
src/components/ProductCarousel.astro 0 → 100644
View file @ ad00ed3a
---
const platforms = {
douyin: { name: "抖音搜索", color: "#161823", glow: "rgba(22,24,35,.12)" },
xiaohongshu: { name: "小红书搜索", color: "#FF2442", glow: "rgba(255,36,66,.14)" },
doubao: { name: "豆包", color: "#2F6BFF", glow: "rgba(47,107,255,.14)" },
qwen: { name: "通义千问", color: "#6F5BFF", glow: "rgba(111,91,255,.14)" },
deepseek: { name: "DeepSeek", color: "#4D6BFE", glow: "rgba(77,107,254,.14)" },
kimi: { name: "Kimi", color: "#111827", glow: "rgba(17,24,39,.11)" },
yuanbao: { name: "腾讯元宝", color: "#10B981", glow: "rgba(16,185,129,.14)" },
baidu: { name: "百度AI", color: "#2932E1", glow: "rgba(41,50,225,.14)" },
wenxin: { name: "文心一言", color: "#2468F2", glow: "rgba(36,104,242,.14)" },
};
const rows = [
[platforms.douyin, platforms.xiaohongshu, platforms.doubao, platforms.qwen, platforms.deepseek],
[platforms.kimi, platforms.yuanbao, platforms.baidu, platforms.wenxin, platforms.xiaohongshu],
[platforms.deepseek, platforms.doubao, platforms.douyin, platforms.qwen, platforms.kimi],
[platforms.wenxin, platforms.yuanbao, platforms.xiaohongshu, platforms.baidu, platforms.deepseek],
];
---
<div class="platform-flow" role="img" aria-label="覆盖抖音搜索、小红书搜索、豆包、通义千问、DeepSeek等主流AI与社媒搜索平台">
{rows.map((row, rowIndex) => (
<div class:list={["platform-flow__row", { "platform-flow__row--reverse": rowIndex % 2 === 1 }]}>
<div class="platform-flow__track">
{[false, true].map(() => (
<div class="platform-flow__group" aria-hidden="true">
{row.map((item) => <span class="platform-flow__item" style={`--platform-color:${item.color};--platform-glow:${item.glow}`}>{item.name}</span>)}
</div>
))}
</div>
</div>
))}
</div>
src/components/SectionHeading.astro 0 → 100644
View file @ ad00ed3a
---
interface Props { eyebrow: string; title: string; description?: string; align?: "left" | "center"; light?: boolean; }
const { eyebrow, title, description, align = "left", light = false } = Astro.props;
---
<div class:list={["section-heading", `section-heading--${align}`, { "section-heading--light": light }]} data-reveal>
<div class="eyebrow"><span></span>{eyebrow}</div><h2>{title}</h2>{description && <p>{description}</p>}
</div>
src/content.config.ts 0 → 100644
View file @ ad00ed3a
import { defineCollection, z } from "astro:content";
import { glob } from "astro/loaders";
const articleSchema = z.object({
title: z.string(),
slug: z.string(),
date: z.coerce.date(),
updated: z.coerce.date(),
category: z.string(),
author: z.string(),
excerpt: z.string(),
status: z.enum(["draft", "published"]),
});
const articles = defineCollection({
loader: glob({ pattern: "**/*.md", base: "./src/content/articles" }),
schema: articleSchema,
});
const published = defineCollection({
loader: glob({ pattern: "**/*.md", base: "./src/content/published" }),
schema: articleSchema,
});
export const collections = { articles, published };
src/content/articles/how-to-read-learning-profile.md 0 → 100644
View file @ ad00ed3a
---
title: "学情分析在分析什么：从一次错题看见真正的问题"
slug: "how-to-read-learning-profile"
date: 2026-08-08
updated: 2026-08-12
category: "学情指南"
author: "启优学教研中心"
excerpt: "同一道错题背后，可能是知识缺口、方法不熟，也可能是审题和学习习惯问题。有效的学情分析需要先把原因分清楚。"
status: "published"
---
# 学情分析在分析什么：从一次错题看见真正的问题
孩子说“这道题不会”，并不等于再讲一遍答案就能解决。一次错误可能来自概念没有理解、题型方法不熟、条件遗漏，或计算和表达习惯不稳定。
## 先看错误发生在哪一步
有效的学情沟通会结合近期试卷、错题、教材进度和学生自己的解题过程，判断问题更接近知识、方法还是习惯。只有原因清楚，近期任务才不会变成泛泛刷题。
## 把宽泛目标拆小
“提高数学”很难直接执行，“本周检查一次函数取值范围的分类讨论”则更具体。阶段方案需要说明先做什么、如何检查，以及什么时候根据表现调整。
src/content/articles/how-to-review-mistakes.md 0 → 100644
View file @ ad00ed3a
---
title: "错题复盘不只是重做：把失分原因分成四类"
slug: "how-to-review-mistakes"
date: 2026-08-10
updated: 2026-08-12
category: "学习方法"
author: "启优学教研中心"
excerpt: "知识概念、解题方法、审题表达和计算习惯需要不同的改进方式。错题复盘的第一步，是不再把所有错误归为粗心。"
status: "published"
---
# 错题复盘不只是重做：把失分原因分成四类
把错题答案抄一遍，并不一定能减少下一次错误。更有效的方式，是先判断错误发生的类型：知识概念、解题方法、审题表达和计算习惯，需要不同的改进方式。
复盘的目标不是收藏更多错题，而是发现重复出现的原因，并安排下一次可以检查的任务。
src/content/articles/online-one-to-one-fit.md 0 → 100644
View file @ ad00ed3a
---
title: "在线一对一适合哪些学生？先看三个判断维度"
slug: "online-one-to-one-fit"
date: 2026-08-09
updated: 2026-08-12
category: "家长课堂"
author: "启优学教研中心"
excerpt: "一对一更适合问题较明确、需要个别讲解节奏或持续反馈的学生，是否适合还要结合目标、配合情况与学习周期判断。"
status: "published"
---
# 在线一对一适合哪些学生？先看三个判断维度
在线一对一并不是所有学习问题的统一答案。判断是否适合，可以先看问题是否明确、学生是否需要个别节奏，以及家庭是否能为持续练习与反馈留出空间。
## 学习问题是否可以被具体描述
单科短板、某一章节基础断层、校内进度衔接困难，通常比“想全面提高”更容易形成明确方案。
## 是否需要更多互动检查
如果学生在大班课堂中不容易表达思路，或需要教师根据作答即时调整讲解，一对一互动会提供更集中的反馈机会。
src/content/categories.json 0 → 100644
View file @ ad00ed3a
[
"学情指南",
"学习方法",
"家长课堂",
"服务说明"
]
src/content/published/how-to-read-learning-profile.md 0 → 100644
View file @ ad00ed3a
---
title: "学情分析在分析什么：从一次错题看见真正的问题"
slug: "how-to-read-learning-profile"
date: 2026-08-08
updated: 2026-08-12
category: "学情指南"
author: "启优学教研中心"
excerpt: "同一道错题背后，可能是知识缺口、方法不熟，也可能是审题和学习习惯问题。有效的学情分析需要先把原因分清楚。"
status: "published"
---
# 学情分析在分析什么：从一次错题看见真正的问题
孩子说“这道题不会”，并不等于再讲一遍答案就能解决。一次错误可能来自概念没有理解、题型方法不熟、条件遗漏，或计算和表达习惯不稳定。
## 先看错误发生在哪一步
有效的学情沟通会结合近期试卷、错题、教材进度和学生自己的解题过程，判断问题更接近知识、方法还是习惯。只有原因清楚，近期任务才不会变成泛泛刷题。
## 把宽泛目标拆小
“提高数学”很难直接执行，“本周检查一次函数取值范围的分类讨论”则更具体。阶段方案需要说明先做什么、如何检查，以及什么时候根据表现调整。
学习结果受基础、频率、练习与学习周期等多种因素影响。学情分析的价值，是让下一步安排更有依据，而不是给出统一答案。
src/content/published/how-to-review-mistakes.md 0 → 100644
View file @ ad00ed3a
---
title: "错题复盘不只是重做：把失分原因分成四类"
slug: "how-to-review-mistakes"
date: 2026-08-10
updated: 2026-08-12
category: "学习方法"
author: "启优学教研中心"
excerpt: "知识概念、解题方法、审题表达和计算习惯需要不同的改进方式。错题复盘的第一步，是不再把所有错误归为粗心。"
status: "published"
---
# 错题复盘不只是重做：把失分原因分成四类
把错题答案抄一遍，并不一定能减少下一次错误。更有效的方式，是先判断错误发生的类型。
## 知识概念
定义、公式或概念边界没有理解，需要回到基础知识并用相近问题检查。
## 解题方法
知道知识点，却不知道从什么条件切入，需要梳理题型结构和步骤。
## 审题与表达
遗漏条件、答非所问或步骤不完整，需要把读题标记与答题规范纳入练习。
## 计算与学习习惯
符号、单位、抄写和检查中的重复错误，需要用固定的自查流程逐步减少。
复盘的目标不是收藏更多错题，而是发现重复出现的原因，并安排下一次可以检查的任务。
src/content/published/online-one-to-one-fit.md 0 → 100644
View file @ ad00ed3a
---
title: "在线一对一适合哪些学生？先看三个判断维度"
slug: "online-one-to-one-fit"
date: 2026-08-09
updated: 2026-08-12
category: "家长课堂"
author: "启优学教研中心"
excerpt: "一对一更适合问题较明确、需要个别讲解节奏或持续反馈的学生，是否适合还要结合目标、配合情况与学习周期判断。"
status: "published"
---
# 在线一对一适合哪些学生？先看三个判断维度
在线一对一并不是所有学习问题的统一答案。判断是否适合，可以先看问题是否明确、学生是否需要个别节奏，以及家庭是否能为持续练习与反馈留出空间。
## 学习问题是否可以被具体描述
单科短板、某一章节基础断层、校内进度衔接困难，通常比“想全面提高”更容易形成明确方案。
## 是否需要更多互动检查
如果学生在大班课堂中不容易表达思路，或需要教师根据作答即时调整讲解，一对一互动会提供更集中的反馈机会。
## 是否能配合阶段任务
课堂只是学习的一部分。课后巩固、错题复盘与阶段沟通同样重要。具体课程与教师安排，应在学情沟通后由双方确认。
src/data/site.ts 0 → 100644
View file @ ad00ed3a
export const site = {
seo: {
title: "启优学一对一｜小学初中高中在线个性化辅导",
description: "启优学一对一面向小学、初中和高中学生，通过学情诊断、教师匹配、在线一对一授课、课后反馈与阶段复盘，制定有针对性的学习方案。",
keywords: ["启优学", "启优学一对一", "在线一对一辅导", "小学一对一", "初中一对一", "高中一对一", "个性化辅导"],
imageAlt: "启优学在线一对一课堂",
},
brand: {
name: "启优学一对一",
shortName: "启优学",
englishName: "QIYOUXUE",
legalName: "巨量云投（石家庄）企业管理咨询有限公司",
tagline: "优质师资直达，个性化辅导看得见",
industry: "小学 · 初中 · 高中在线一对一辅导",
},
home: {
headline: "先看清问题，再规划每一步",
subhead: "面向小学、初中和高中学生，从学情诊断出发，匹配固定教师，围绕当前基础、校内进度与阶段目标制定在线一对一学习方案。",
stats: [
{ value: "20000+", label: "签约严选教师" },
{ value: "约 3%", label: "师资录取率" },
{ value: "85%+", label: "来自 985 / 211 或重点师范院校" },
{ value: "20万+", label: "累计服务学员" },
],
},
services: [
{
slug: "foundation", index: "01", type: "primary", name: "基础巩固", kicker: "FOUNDATION",
seoTitle: "基础巩固在线一对一辅导｜启优学", seoDescription: "启优学基础巩固课程围绕核心概念、基础题型和知识断层，结合教材进度制定在线一对一学习方案。", seoKeywords: ["基础巩固", "基础薄弱辅导", "在线一对一"],
intro: "回到影响后续学习的关键概念与基础题型，逐步补齐知识断层。",
features: ["结合近期试卷、错题和校内进度定位具体缺口", "按学生理解节奏讲解、提问与即时纠错", "课后记录掌握情况，明确下一次巩固任务"],
capabilities: [{ label: "定位", value: "知识断层与失分原因" }, { label: "讲解", value: "关键概念与基础题型" }, { label: "练习", value: "同类问题即时检查" }, { label: "反馈", value: "记录掌握情况与安排" }],
process: ["沟通学情", "定位缺口", "匹配教师", "反馈调整"],
},
{
slug: "subject-improvement", index: "02", type: "primary", name: "偏科补弱", kicker: "SUBJECT SUPPORT",
seoTitle: "偏科补弱在线一对一辅导｜启优学", seoDescription: "启优学偏科补弱课程区分知识漏洞、方法问题与学习习惯，根据具体学科与阶段目标制定一对一方案。", seoKeywords: ["偏科补弱", "单科辅导", "一对一补课"],
intro: "围绕具体学科、章节和错误类型安排优先任务，减少无效重复。",
features: ["支持语文、数学、英语、物理、化学等常见学科", "可以只辅导一科，不强制多科打包", "结合课堂反馈与练习表现动态调整重点"],
capabilities: [{ label: "分科", value: "单科问题专项分析" }, { label: "归因", value: "区分知识、方法与习惯" }, { label: "匹配", value: "按学段和学科匹配教师" }, { label: "跟踪", value: "减少同类问题重复出现" }],
process: ["单科诊断", "拆解问题", "专项训练", "错题复盘"],
},
{
slug: "school-sync", index: "03", type: "support", name: "同步学习", kicker: "SCHOOL SYNC",
seoTitle: "校内同步在线一对一辅导｜启优学", seoDescription: "启优学同步学习结合地区、教材版本与学校进度，进行知识讲解、练习检查和错题复盘。", seoKeywords: ["校内同步辅导", "同步学习", "教材同步一对一"],
intro: "结合教材版本和学校进度安排讲解、练习与错题复盘。",
features: ["了解学生地区、教材版本与近期学校进度", "围绕当前章节梳理概念、方法和易错点", "不以统一进度覆盖所有学生"],
capabilities: [{ label: "教材", value: "结合地区与教材版本" }, { label: "进度", value: "衔接近期校内学习" }, { label: "课堂", value: "一对一互动检查理解" }, { label: "课后", value: "反馈本节掌握情况" }],
process: ["确认进度", "梳理重点", "互动授课", "课后反馈"],
},
{
slug: "exam-planning", index: "04", type: "support", name: "阶段复习", kicker: "STAGE REVIEW",
seoTitle: "阶段复习与升学冲刺一对一辅导｜启优学", seoDescription: "启优学阶段复习围绕期中期末、小升初、中考和高考等阶段任务，拆分重点、节奏与检查方式。", seoKeywords: ["阶段复习", "中考一对一", "高考一对一", "升学冲刺"],
intro: "根据测验、期中期末或升学阶段的时间安排梳理复习重点。",
features: ["结合剩余时间与当前基础确定任务优先级", "重视核心考点、真题训练、错题复盘与答题规范", "实际节奏根据学生表现与阶段目标持续调整"],
capabilities: [{ label: "目标", value: "明确阶段任务与时间" }, { label: "重点", value: "梳理考点和题型" }, { label: "复盘", value: "分析错题与失分原因" }, { label: "调整", value: "根据表现更新安排" }],
process: ["确定目标", "诊断现状", "安排节奏", "阶段复盘"],
},
],
about: {
heading: "让优质教育跨越地域，让每个孩子被认真看见",
position: "启优学一对一是巨量云投（石家庄）企业管理咨询有限公司旗下在线个性化辅导品牌，面向小学、初中和高中学生提供学情诊断、教师匹配、在线授课、课后反馈与阶段复盘服务。",
story: [
"我们不使用一套固定课程覆盖所有学生。课程开始前先了解学生所处学段、当前基础、教材进度和阶段目标，再把宽泛的学习诉求拆成可以执行和检查的任务。",
"课堂围绕一个学生展开。教师通过提问、作答、即时反馈与难度调整，检查学生是否真正理解知识与方法；匹配成功后通常由固定教师持续授课。",
"家长可通过课堂反馈、学习报告、课程回放和阶段沟通了解学习内容、仍需巩固的问题与后续安排。实际课程、教师、时间与费用以咨询后双方确认的方案为准。",
],
advantages: [
{ title: "三维学情诊断", desc: "结合试卷、错题、学校进度与学习习惯定位问题。" },
{ title: "固定教师匹配", desc: "按地区、学段、学科、教材进度与沟通特点匹配。" },
{ title: "一对一互动课堂", desc: "通过提问、作答和即时纠错检查真实理解情况。" },
{ title: "课程支持回放", desc: "学生可回顾重点讲解，家长也能了解课堂内容。" },
{ title: "课后学习反馈", desc: "说明学习内容、掌握情况、问题与下一阶段安排。" },
{ title: "阶段持续复盘", desc: "根据课堂、练习和阶段表现调整后续学习方案。" },
],
technologies: ["学段与教材适配", "学情沟通与问题诊断", "分科教师智能匹配", "在线互动与课程回放", "课后反馈与阶段报告"],
vision: "启发引导，因材施教；不只关注一次结果，更陪伴学生建立可以持续使用的学习能力。",
},
workflow: [
{ number: "01", title: "沟通", desc: "了解年级、教材、进度、近期试卷与当前目标。" },
{ number: "02", title: "诊断", desc: "区分知识缺口、方法问题和学习习惯问题。" },
{ number: "03", title: "匹配", desc: "综合学段、学科、基础与沟通特点匹配教师。" },
{ number: "04", title: "复盘", desc: "根据课堂与练习反馈持续调整后续安排。" },
],
faq: [
{ q: "启优学一对一是什么？", a: "启优学一对一是面向小学、初中、高中学生的在线一对一辅导品牌，主要提供小初高校内学科个性化辅导服务。课程以学情诊断为起点，根据年级、学科基础、教材版本、薄弱点和学习目标匹配教师。" },
{ q: "主要提供哪些课程？", a: "覆盖基础夯实、同步校内、偏科补弱、阶段复习、升学冲刺和拔高培优等学习场景。课程根据学生实际学情制定，不是统一模板课。" },
{ q: "覆盖哪些年级和科目？", a: "覆盖小学1—6年级、初中1—3年级和高中1—3年级，支持语文、数学、英语、物理、化学、生物、地理、道德与法治等常见校内学科。具体开课情况以咨询确认为准。" },
{ q: "可以只辅导一科吗？", a: "可以，尤其适合单科拖分、偏科明显或某一学科基础断层的学生。平台会先判断具体知识漏洞，再匹配对应学科教师，不强制多科打包。" },
{ q: "如何匹配教师？", a: "根据学生年级、学科、教材版本、当前基础、学习目标和沟通特点进行匹配。匹配成功后通常安排固定教师长期授课；如适配度明显不合适，可联系课程服务人员协助评估调整。" },
{ q: "课程如何开展？", a: "通过专属线上平台授课，支持课堂互动、课程回放和学习记录。课堂中教师会通过提问、作答和即时纠错检查理解情况。" },
{ q: "家长如何了解学习进展？", a: "家长可通过课后反馈、学习报告、课程回放、错题复盘和阶段沟通了解学习内容、掌握情况、仍需巩固的问题与后续安排。" },
{ q: "如何预约咨询？", a: "可通过官网咨询入口、客服电话400 838 3090，或搜索微信小程序“启优学一对一”预约。建议提前准备学生年级、地区、意向学科、当前情况和阶段目标。" },
],
contact: {
website: "qiyouxueedu.com", phone: "4008383090", phoneDisplay: "400 838 3090", email: "qiyouxueedu@163.com",
address: "中国 · 河北石家庄", locality: "石家庄", region: "河北省",
heading: "先聊聊孩子的学习情况", intro: "准备学生所在年级、意向学科、当前学习情况和阶段目标，我们会结合学情诊断与教师匹配，提供有针对性的学习建议。",
socials: ["官方网站", "微信小程序", "官方电话"],
},
nav: [
{ href: "/", label: "首页", children: [{ href: "/#services", label: "学习需求" }, { href: "/#workflow", label: "服务流程" }, { href: "/#teachers", label: "师资标准" }] },
{ href: "/services/", label: "学科辅导", children: [
{ href: "/services/foundation/", label: "基础巩固" }, { href: "/services/subject-improvement/", label: "偏科补弱" }, { href: "/services/school-sync/", label: "同步学习" }, { href: "/services/exam-planning/", label: "阶段复习" },
] },
{ href: "/methodology/", label: "教学服务", children: [{ href: "/methodology/#workflow", label: "四步学习流程" }, { href: "/methodology/#delivery", label: "反馈与复盘" }] },
{ href: "/about/", label: "关于启优学", children: [{ href: "/about/#position", label: "品牌介绍" }, { href: "/about/#advantages", label: "教学优势" }] },
{ href: "/articles/", label: "学习资讯", children: [{ href: "/articles/", label: "全部资讯" }] },
{ href: "/faq/", label: "常见问题", children: [{ href: "/faq/", label: "家长常见问题" }] },
{ href: "/contact/", label: "联系我们", children: [{ href: "/contact/", label: "课程咨询" }, { href: "tel:4008383090", label: "官方电话" }] },
],
} as const;
src/layouts/Base.astro 0 → 100644
View file @ ad00ed3a
---
import "../styles/global.css";
import logo from "../../pic/启优学LOGO-白底.jpg";
import { getImage } from "astro:assets";
import { site } from "../data/site";
import ContactDialog from "../components/ContactDialog.astro";
interface Props { title: string; description?: string; keywords?: string | readonly string[]; image?: string; imageAlt?: string; ogType?: "website" | "article"; noindex?: boolean; publishedTime?: string; modifiedTime?: string; articleSection?: string; articleAuthor?: string; jsonLd?: Record<string, unknown> | Record<string, unknown>[]; }
const { title, description = site.seo.description, keywords = site.seo.keywords, image = "/og-cover.svg", imageAlt = site.seo.imageAlt, ogType = "website", noindex = false, publishedTime, modifiedTime, articleSection, articleAuthor, jsonLd = [] } = Astro.props;
const cleanMeta = (value: string) => value.replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
const metaTitle = cleanMeta(title); const metaDescription = cleanMeta(description);
const metaKeywords = (typeof keywords === "string" ? keywords.split(",") : keywords).map((keyword) => cleanMeta(keyword)).filter(Boolean).join(",");
const optimizedLogo = await getImage({ src: logo, width: 480, format: "webp" });
const optimizedFavicon = await getImage({ src: logo, width: 128, height: 128, fit: "cover", format: "png" });
const canonical = new URL(Astro.url.pathname, Astro.site).href; const ogImage = new URL(image, Astro.site).href;
const organizationLd = { "@context": "https://schema.org", "@type": ["EducationalOrganization", "Organization"], "@id": new URL("/#organization", Astro.site).href, name: site.brand.name, alternateName: [site.brand.shortName, site.brand.englishName], legalName: site.brand.legalName, url: new URL("/", Astro.site).href, logo: new URL(optimizedLogo.src, Astro.site).href, slogan: site.brand.tagline, description: site.home.subhead, telephone: site.contact.phone, email: site.contact.email, areaServed: { "@type": "Country", name: "中国" } };
const websiteLd = { "@context": "https://schema.org", "@type": "WebSite", "@id": new URL("/#website", Astro.site).href, url: new URL("/", Astro.site).href, name: site.brand.name, inLanguage: "zh-CN", publisher: { "@id": new URL("/#organization", Astro.site).href } };
const webPageLd = { "@context": "https://schema.org", "@type": "WebPage", "@id": `${canonical}#webpage`, url: canonical, name: metaTitle, description: metaDescription, inLanguage: "zh-CN", isPartOf: { "@id": new URL("/#website", Astro.site).href }, about: { "@id": new URL("/#organization", Astro.site).href }, primaryImageOfPage: { "@type": "ImageObject", url: ogImage, caption: imageAlt } };
const pageLd = Array.isArray(jsonLd) ? jsonLd : [jsonLd]; const serializedLd = JSON.stringify([organizationLd, websiteLd, webPageLd, ...pageLd.filter((item) => Object.keys(item).length > 0)]).replace(/</g, "\\u003c");
---
<!doctype html><html lang="zh-CN"><head><meta charset="UTF-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><meta name="theme-color" content="#FCFDFC" /><meta name="color-scheme" content="light" /><title>{metaTitle}</title><meta name="description" content={metaDescription} /><meta name="keywords" content={metaKeywords} /><meta name="robots" content={noindex ? "noindex,nofollow" : "index,follow,max-image-preview:large,max-snippet:-1,max-video-preview:-1"} /><link rel="canonical" href={canonical} /><link rel="icon" href={optimizedFavicon.src} type="image/png" sizes="128x128" /><link rel="apple-touch-icon" href={optimizedFavicon.src} /><link rel="manifest" href="/site.webmanifest" /><link rel="alternate" hreflang="zh-CN" href={canonical} /><link rel="alternate" hreflang="x-default" href={canonical} /><meta property="og:type" content={ogType} /><meta property="og:title" content={metaTitle} /><meta property="og:description" content={metaDescription} /><meta property="og:url" content={canonical} /><meta property="og:image" content={ogImage} /><meta property="og:image:alt" content={imageAlt} /><meta property="og:site_name" content={site.brand.name} /><meta property="og:locale" content="zh_CN" />{publishedTime && <meta property="article:published_time" content={publishedTime} />}{modifiedTime && <meta property="article:modified_time" content={modifiedTime} />}{articleSection && <meta property="article:section" content={articleSection} />}{articleAuthor && <meta property="article:author" content={articleAuthor} />}<meta name="twitter:card" content="summary_large_image" /><meta name="twitter:title" content={metaTitle} /><meta name="twitter:description" content={metaDescription} /><meta name="twitter:image" content={ogImage} /><script type="application/ld+json" set:html={serializedLd} is:inline></script></head><body><a class="skip-link" href="#main-content">跳到主要内容</a><slot /><ContactDialog /><script is:inline>
const header=document.querySelector('[data-header]');const syncHeader=()=>header?.classList.toggle('is-scrolled',scrollY>12);addEventListener('scroll',syncHeader,{passive:true});syncHeader();const observer='IntersectionObserver'in window?new IntersectionObserver(entries=>entries.forEach(entry=>{if(entry.isIntersecting){entry.target.classList.add('is-visible');observer.unobserve(entry.target)}}),{threshold:.08}):null;document.querySelectorAll('[data-reveal]').forEach(el=>observer?observer.observe(el):el.classList.add('is-visible'));document.querySelectorAll('[data-mobile-nav] a').forEach(link=>link.addEventListener('click',()=>link.closest('details')?.removeAttribute('open')));const dialog=document.querySelector('[data-contact-dialog]');const mobile=()=>matchMedia('(max-width:760px),(hover:none) and (pointer:coarse)').matches;document.addEventListener('click',event=>{const trigger=event.target.closest('[data-open-contact]');const phone=event.target.closest('a[href^="tel:"]');if(!dialog||(!trigger&&(!phone||mobile())))return;event.preventDefault();dialog.showModal()});dialog?.querySelector('[data-contact-dialog-close]')?.addEventListener('click',()=>dialog.close());dialog?.addEventListener('click',event=>{if(event.target===dialog)dialog.close()});
</script></body></html>
src/lib/article-store.ts 0 → 100644
View file @ ad00ed3a
import crypto from "node:crypto";
import path from "node:path";
import fs from "node:fs/promises";
import matter from "gray-matter";
import { marked } from "marked";
const ROOT = process.cwd();
const DATA_ROOT = process.env.CMS_DATA_DIR ? path.resolve(process.env.CMS_DATA_DIR) : null;
const SOURCE_ARTICLES_DIR = path.join(ROOT, "src", "content", "articles");
const SOURCE_PUBLISHED_DIR = path.join(ROOT, "src", "content", "published");
export const ARTICLES_DIR = DATA_ROOT ? path.join(DATA_ROOT, "articles") : path.join(ROOT, "src", "content", "articles");
export const PUBLISHED_DIR = DATA_ROOT ? path.join(DATA_ROOT, "published") : path.join(ROOT, "src", "content", "published");
export const CATEGORIES_FILE = DATA_ROOT ? path.join(DATA_ROOT, "categories.json") : path.join(ROOT, "src", "content", "categories.json");
export const UPLOADS_DIR = DATA_ROOT ? path.join(DATA_ROOT, "uploads") : path.join(ROOT, "public", "uploads");
const DEFAULT_CATEGORIES = ["学情指南", "学习方法", "家长课堂", "服务说明"];
const DEFAULT_AUTHOR = "启优学教研中心";
const CATEGORY_SLUGS: Record<string, string> = {
学情指南: "learning-profile",
学习方法: "learning-methods",
家长课堂: "parent-guides",
服务说明: "service-guides",
};
const SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
export type PublishStatus = "new-draft" | "edited-draft" | "live";
export interface StoredArticle {
slug: string;
title: string;
date: string;
updated: string;
category: string;
author: string;
excerpt: string;
status: "draft" | "published";
body: string;
}
export interface Article {
id: string;
data: {
title: string;
slug: string;
date: Date;
updated: Date;
category: string;
author: string;
excerpt: string;
status: "published";
};
body: string;
}
export interface CategoryStat {
name: string;
count: number;
}
export interface ContentSnapshot {
restore: () => Promise<void>;
}
export class StoreError extends Error {
status: number;
details?: Record<string, unknown>;
constructor(message: string, status = 400, details?: Record<string, unknown>) {
super(message);
this.status = status;
this.details = details;
}
}
export const safeSlug = (slug: unknown): string | null => typeof slug === "string" && SLUG_RE.test(slug) ? slug : null;
export const fmtDate = (value?: string | Date): string => {
const date = value instanceof Date ? value : new Date(value || Date.now());
return Number.isNaN(date.valueOf()) ? new Date().toISOString().slice(0, 10) : date.toISOString().slice(0, 10);
};
const autoExcerpt = (body: string, fallback: string): string => {
const plain = String(body || "")
.replace(/!\[[^\]]*\]\([^)]*\)/g, " ")
.replace(/\[([^\]]+)\]\([^)]*\)/g, "$1")
.replace(/<[^>]+>/g, " ")
.replace(/[`*_>#~|\-]+/g, " ")
.replace(/\s+/g, " ")
.trim();
const text = plain || String(fallback || "").trim();
return text.length > 120 ? `${text.slice(0, 120).trim()}…` : text;
};
function serialize(data: StoredArticle, body: string): string {
const quote = (value: unknown) => JSON.stringify(value == null ? "" : String(value));
return [
"---",
`title: ${quote(data.title)}`,
`slug: ${quote(data.slug)}`,
`date: ${fmtDate(data.date)}`,
`updated: ${fmtDate(data.updated || data.date)}`,
`category: ${quote(data.category)}`,
`author: ${quote(data.author || DEFAULT_AUTHOR)}`,
`excerpt: ${quote(data.excerpt)}`,
`status: ${quote(data.status || "draft")}`,
"---",
"",
String(body || "").trim(),
"",
].join("\n");
}
async function fileExists(file: string): Promise<boolean> {
try { await fs.access(file); return true; } catch { return false; }
}
async function writeAtomic(file: string, content: string | Buffer): Promise<void> {
await fs.mkdir(path.dirname(file), { recursive: true });
const temporary = `${file}.${process.pid}.${crypto.randomBytes(4).toString("hex")}.tmp`;
try {
await fs.writeFile(temporary, content);
await fs.rename(temporary, file);
} catch (error) {
await fs.unlink(temporary).catch(() => {});
throw error;
}
}
async function ensureStore(): Promise<void> {
await Promise.all([
fs.mkdir(ARTICLES_DIR, { recursive: true }),
fs.mkdir(PUBLISHED_DIR, { recursive: true }),
fs.mkdir(UPLOADS_DIR, { recursive: true }),
]);
if (DATA_ROOT) {
const seedDirectory = async (source: string, target: string) => {
const current = await fs.readdir(target);
if (current.some((file) => file.endsWith(".md"))) return;
const seeds = await fs.readdir(source).catch(() => [] as string[]);
await Promise.all(seeds.filter((file) => file.endsWith(".md")).map((file) => fs.copyFile(path.join(source, file), path.join(target, file))));
};
await Promise.all([
seedDirectory(SOURCE_ARTICLES_DIR, ARTICLES_DIR),
seedDirectory(SOURCE_PUBLISHED_DIR, PUBLISHED_DIR),
]);
}
if (!await fileExists(CATEGORIES_FILE)) {
await writeAtomic(CATEGORIES_FILE, `${JSON.stringify(DEFAULT_CATEGORIES, null, 2)}\n`);
}
}
export async function getCategoryNames(): Promise<string[]> {
await ensureStore();
try {
const parsed: unknown = JSON.parse(await fs.readFile(CATEGORIES_FILE, "utf8"));
const names = Array.isArray(parsed)
? parsed.map((value) => String(value).replace(/\s+/g, " ").trim()).filter(Boolean)
: [];
return [...new Set(names)].length ? [...new Set(names)] : [...DEFAULT_CATEGORIES];
} catch {
return [...DEFAULT_CATEGORIES];
}
}
async function saveCategories(categories: string[]): Promise<void> {
await writeAtomic(CATEGORIES_FILE, `${JSON.stringify(categories, null, 2)}\n`);
}
function normalizeCategoryName(value: unknown): string {
const name = String(value || "").replace(/\s+/g, " ").trim();
if (!name) throw new StoreError("请输入分类名称");
if (name.length > 20) throw new StoreError("分类名称不能超过 20 个字");
return name;
}
export async function addCategory(value: unknown): Promise<string[]> {
const name = normalizeCategoryName(value);
const categories = await getCategoryNames();
if (categories.includes(name)) throw new StoreError("该分类已经存在", 409);
const next = [...categories, name];
await saveCategories(next);
return next;
}
export async function readArticleFrom(directory: string, slug: string): Promise<StoredArticle> {
const raw = await fs.readFile(path.join(directory, `${slug}.md`), "utf8");
const { data, content } = matter(raw);
return {
slug,
title: String(data.title || ""),
date: fmtDate(data.date),
updated: fmtDate(data.updated || data.date),
category: String(data.category || ""),
author: String(data.author || DEFAULT_AUTHOR),
excerpt: String(data.excerpt || ""),
status: data.status === "draft" ? "draft" : "published",
body: content.trim(),
};
}
export const readWorkingArticle = (slug: string) => readArticleFrom(ARTICLES_DIR, slug);
async function markdownFiles(directory: string): Promise<string[]> {
await ensureStore();
return (await fs.readdir(directory)).filter((file) => file.endsWith(".md"));
}
async function snapshotDirectory(directory: string): Promise<Map<string, string>> {
const snapshot = new Map<string, string>();
for (const filename of await markdownFiles(directory)) {
snapshot.set(filename, await fs.readFile(path.join(directory, filename), "utf8"));
}
return snapshot;
}
async function restoreDirectory(directory: string, snapshot: Map<string, string>): Promise<void> {
for (const filename of await markdownFiles(directory)) {
if (!snapshot.has(filename)) await fs.unlink(path.join(directory, filename));
}
for (const [filename, content] of snapshot) await writeAtomic(path.join(directory, filename), content);
}
export async function createContentSnapshot(): Promise<ContentSnapshot> {
await ensureStore();
const articles = await snapshotDirectory(ARTICLES_DIR);
const published = await snapshotDirectory(PUBLISHED_DIR);
const categories = await fs.readFile(CATEGORIES_FILE, "utf8");
return {
restore: async () => {
await restoreDirectory(ARTICLES_DIR, articles);
await restoreDirectory(PUBLISHED_DIR, published);
await writeAtomic(CATEGORIES_FILE, categories);
},
};
}
const sameArticleContent = (left: StoredArticle, right: StoredArticle): boolean =>
["slug", "title", "date", "category", "author", "excerpt", "body"]
.every((key) => String(left[key as keyof StoredArticle] ?? "") === String(right[key as keyof StoredArticle] ?? ""));
export async function getPublishStatus(article: StoredArticle): Promise<PublishStatus> {
const liveFile = path.join(PUBLISHED_DIR, `${article.slug}.md`);
if (!await fileExists(liveFile)) return "new-draft";
const liveArticle = await readArticleFrom(PUBLISHED_DIR, article.slug);
return sameArticleContent(article, liveArticle) ? "live" : "edited-draft";
}
export async function listWorkingArticles(): Promise<Array<Omit<StoredArticle, "body"> & { publishStatus: PublishStatus }>> {
const articles = await Promise.all((await markdownFiles(ARTICLES_DIR)).map(async (file) => {
const article = await readWorkingArticle(file.replace(/\.md$/, ""));
const { body: _body, ...meta } = article;
return { ...meta, publishStatus: await getPublishStatus(article) };
}));
return articles.sort((a, b) => b.updated.localeCompare(a.updated) || b.date.localeCompare(a.date));
}
export async function writeArticle(slug: string, input: Record<string, unknown>, isNew = false): Promise<StoredArticle> {
await ensureStore();
const file = path.join(ARTICLES_DIR, `${slug}.md`);
if (isNew && await fileExists(file)) throw new StoreError("该网址标识已存在", 409);
const existing = !isNew && await fileExists(file) ? await readWorkingArticle(slug) : null;
const categories = await getCategoryNames();
const body = String(input.body || "").trim();
const normalized: StoredArticle = {
title: String(input.title || "").trim(),
slug,
date: existing?.date || fmtDate(),
updated: fmtDate(),
category: categories.includes(String(input.category)) ? String(input.category) : categories[0],
author: DEFAULT_AUTHOR,
excerpt: autoExcerpt(body, String(input.title || "")),
status: "draft",
body,
};
const liveFile = path.join(PUBLISHED_DIR, `${slug}.md`);
if (await fileExists(liveFile)) {
const liveArticle = await readArticleFrom(PUBLISHED_DIR, slug);
if (sameArticleContent(normalized, liveArticle)) {
normalized.status = "published";
normalized.updated = liveArticle.updated;
}
}
await writeAtomic(file, serialize(normalized, body));
return normalized;
}
export async function generateSlug(category: unknown, date = fmtDate()): Promise<string> {
await ensureStore();
const prefix = CATEGORY_SLUGS[String(category)] || "silver-journal";
const base = `${prefix}-${date.replaceAll("-", "")}`;
let slug = base;
let suffix = 2;
while (await fileExists(path.join(ARTICLES_DIR, `${slug}.md`)) || await fileExists(path.join(PUBLISHED_DIR, `${slug}.md`))) {
slug = `${base}-${suffix++}`;
}
return slug;
}
async function restoreFile(file: string, content: string | null): Promise<void> {
if (content === null) await fs.unlink(file).catch(() => {});
else await writeAtomic(file, content);
}
export async function publishArticle(slug: string): Promise<void> {
const article = await readWorkingArticle(slug);
const published: StoredArticle = { ...article, status: "published", updated: fmtDate() };
const text = serialize(published, article.body);
const draftFile = path.join(ARTICLES_DIR, `${slug}.md`);
const liveFile = path.join(PUBLISHED_DIR, `${slug}.md`);
const previousDraft = await fs.readFile(draftFile, "utf8");
const previousLive = await fileExists(liveFile) ? await fs.readFile(liveFile, "utf8") : null;
try {
await writeAtomic(liveFile, text);
await writeAtomic(draftFile, text);
} catch (error) {
await restoreFile(draftFile, previousDraft);
await restoreFile(liveFile, previousLive);
throw error;
}
}
export async function unpublishArticle(slug: string): Promise<void> {
const draftFile = path.join(ARTICLES_DIR, `${slug}.md`);
const liveFile = path.join(PUBLISHED_DIR, `${slug}.md`);
const previousDraft = await fs.readFile(draftFile, "utf8");
const previousLive = await fs.readFile(liveFile, "utf8");
const article = await readWorkingArticle(slug);
try {
await writeAtomic(draftFile, serialize({ ...article, status: "draft" }, article.body));
await fs.unlink(liveFile);
} catch (error) {
await restoreFile(draftFile, previousDraft);
await restoreFile(liveFile, previousLive);
throw error;
}
}
export async function deleteArticle(slug: string): Promise<void> {
const files = [path.join(ARTICLES_DIR, `${slug}.md`), path.join(PUBLISHED_DIR, `${slug}.md`)];
const backups: Array<{ file: string; content: string }> = [];
for (const file of files) if (await fileExists(file)) backups.push({ file, content: await fs.readFile(file, "utf8") });
if (!backups.length) throw new StoreError("文章不存在", 404);
try {
for (const { file } of backups) await fs.unlink(file);
} catch (error) {
for (const { file, content } of backups) await writeAtomic(file, content);
throw error;
}
}
export async function discardDraft(slug: string): Promise<{ removed: boolean; publishStatus: PublishStatus | null }> {
const liveFile = path.join(PUBLISHED_DIR, `${slug}.md`);
const draftFile = path.join(ARTICLES_DIR, `${slug}.md`);
if (await fileExists(liveFile)) {
await fs.copyFile(liveFile, draftFile);
return { removed: false, publishStatus: "live" };
}
await fs.unlink(draftFile);
return { removed: true, publishStatus: null };
}
async function categoryArticleFiles(category: string): Promise<Array<{ file: string; article: StoredArticle; raw: string }>> {
const results: Array<{ file: string; article: StoredArticle; raw: string }> = [];
for (const directory of [ARTICLES_DIR, PUBLISHED_DIR]) {
for (const filename of await markdownFiles(directory)) {
const slug = filename.replace(/\.md$/, "");
const article = await readArticleFrom(directory, slug);
if (article.category === category) {
const file = path.join(directory, filename);
results.push({ file, article, raw: await fs.readFile(file, "utf8") });
}
}
}
return results;
}
export async function getCategoryStats(): Promise<CategoryStat[]> {
const categories = await getCategoryNames();
const seen = new Map<string, Set<string>>(categories.map((name) => [name, new Set()]));
for (const directory of [ARTICLES_DIR, PUBLISHED_DIR]) {
for (const filename of await markdownFiles(directory)) {
const slug = filename.replace(/\.md$/, "");
const article = await readArticleFrom(directory, slug);
if (!seen.has(article.category)) seen.set(article.category, new Set());
seen.get(article.category)?.add(slug);
}
}
return categories.map((name) => ({ name, count: seen.get(name)?.size || 0 }));
}
async function updateCategoryArticles(current: string, replacement: string, nextCategories: string[]): Promise<void> {
const affected = await categoryArticleFiles(current);
const previousCategories = await fs.readFile(CATEGORIES_FILE, "utf8");
try {
for (const item of affected) {
const updated = { ...item.article, category: replacement };
await writeAtomic(item.file, serialize(updated, updated.body));
}
await saveCategories(nextCategories);
} catch (error) {
for (const item of affected) await writeAtomic(item.file, item.raw);
await writeAtomic(CATEGORIES_FILE, previousCategories);
throw error;
}
}
export async function renameCategory(currentValue: unknown, nextValue: unknown): Promise<string[]> {
const current = normalizeCategoryName(currentValue);
const nextName = normalizeCategoryName(nextValue);
const categories = await getCategoryNames();
if (!categories.includes(current)) throw new StoreError("分类不存在", 404);
if (current !== nextName && categories.includes(nextName)) throw new StoreError("该分类已经存在", 409);
if (current === nextName) return categories;
const next = categories.map((name) => name === current ? nextName : name);
await updateCategoryArticles(current, nextName, next);
return next;
}
export async function removeCategory(value: unknown, replacementValue: unknown): Promise<string[]> {
const name = normalizeCategoryName(value);
const categories = await getCategoryNames();
if (!categories.includes(name)) throw new StoreError("分类不存在", 404);
if (categories.length <= 1) throw new StoreError("至少需要保留一个文章分类", 409);
const affected = await categoryArticleFiles(name);
const count = new Set(affected.map((item) => item.article.slug)).size;
const replacement = String(replacementValue || "").trim();
if (count > 0 && (!replacement || !categories.includes(replacement) || replacement === name)) {
throw new StoreError("请先选择这些文章要迁移到的分类", 409, { requiresReplacement: true, count });
}
const next = categories.filter((category) => category !== name);
await updateCategoryArticles(name, replacement, next);
return next;
}
export async function getPublishedArticles(): Promise<Article[]> {
const items = await Promise.all((await markdownFiles(PUBLISHED_DIR)).map(async (file) => {
const article = await readArticleFrom(PUBLISHED_DIR, file.replace(/\.md$/, ""));
return {
id: article.slug,
data: {
title: article.title,
slug: article.slug,
date: new Date(article.date),
updated: new Date(article.updated),
category: article.category,
author: article.author,
excerpt: article.excerpt,
status: "published" as const,
},
body: article.body,
};
}));
return items.sort((a, b) => b.data.date.valueOf() - a.data.date.valueOf());
}
export async function getPublishedArticle(slug: string): Promise<(Article & { html: string }) | null> {
if (!safeSlug(slug)) return null;
try {
const article = await readArticleFrom(PUBLISHED_DIR, slug);
return {
id: article.slug,
data: {
title: article.title,
slug: article.slug,
date: new Date(article.date),
updated: new Date(article.updated),
category: article.category,
author: article.author,
excerpt: article.excerpt,
status: "published",
},
body: article.body,
html: await marked.parse(article.body),
};
} catch (error) {
if ((error as NodeJS.ErrnoException).code === "ENOENT") return null;
throw error;
}
}
export async function saveUpload(dataUrl: unknown): Promise<string> {
await ensureStore();
const extensions: Record<string, string> = { "image/png": "png", "image/jpeg": "jpg", "image/webp": "webp", "image/gif": "gif" };
const match = String(dataUrl || "").match(/^data:([^;]+);base64,(.+)$/s);
if (!match || !extensions[match[1]]) throw new StoreError("仅支持 PNG、JPG、WEBP 或 GIF 图片");
const buffer = Buffer.from(match[2], "base64");
if (buffer.length > 20 * 1024 * 1024) throw new StoreError("图片不能超过 20MB", 413);
const name = `${Date.now()}-${crypto.randomBytes(4).toString("hex")}.${extensions[match[1]]}`;
await writeAtomic(path.join(UPLOADS_DIR, name), buffer);
return `/uploads/${name}`;
}
export async function removeUpload(url: unknown): Promise<void> {
const match = String(url || "").match(/^\/uploads\/([a-zA-Z0-9._-]+)$/);
if (!match) throw new StoreError("图片地址不合法");
await fs.unlink(path.join(UPLOADS_DIR, match[1])).catch((error: NodeJS.ErrnoException) => {
if (error.code !== "ENOENT") throw error;
});
}
src/lib/articles.ts 0 → 100644
View file @ ad00ed3a
import { getCategoryNames as readCategoryNames, getPublishedArticles as readPublishedArticles, type Article } from "./article-store";
export type { Article };
export const PAGE_SIZE = 9;
const CATEGORY_SLUGS: Record<string, string> = {
学情指南: "learning-profile",
学习方法: "learning-methods",
家长课堂: "parent-guides",
服务说明: "service-guides",
};
function fallbackSlug(category: string): string {
const ascii = category.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
if (ascii) return ascii;
let hash = 0;
for (const char of category) hash = (hash * 31 + (char.codePointAt(0) ?? 0)) >>> 0;
return `c${hash.toString(36)}`;
}
export const categoryToSlug = (category: string) => CATEGORY_SLUGS[category] ?? fallbackSlug(category);
export function slugToCategory(slug: string, categories: string[]): string | undefined {
return categories.find((category) => categoryToSlug(category) === slug);
}
export async function getPublishedArticles(): Promise<Article[]> {
return readPublishedArticles();
}
export async function getCategoryNames(): Promise<string[]> {
return readCategoryNames();
}
export interface CategoryInfo {
name: string;
slug: string;
count: number;
}
export function getCategories(items: Article[], categoryNames: string[] = []): CategoryInfo[] {
const counts = new Map<string, number>(categoryNames.map((name) => [name, 0]));
for (const item of items) counts.set(item.data.category, (counts.get(item.data.category) ?? 0) + 1);
return [...counts.entries()]
.map(([name, count]) => ({ name, slug: categoryToSlug(name), count }))
.sort((a, b) => b.count - a.count || a.name.localeCompare(b.name, "zh-CN"));
}
export const lastPageOf = (total: number, pageSize = PAGE_SIZE) => Math.max(1, Math.ceil(total / pageSize));
export const pageSlice = <T>(items: T[], page: number, pageSize = PAGE_SIZE) => items.slice((page - 1) * pageSize, page * pageSize);
export const fmtDate = (date: Date) => date.toISOString().slice(0, 10);
export function paginationWindow(current: number, last: number, span = 2): number[] {
const pages = new Set<number>([1, last]);
for (let page = current - span; page <= current + span; page++) if (page >= 1 && page <= last) pages.add(page);
const sorted = [...pages].sort((a, b) => a - b);
const result: number[] = [];
let previous = 0;
for (const page of sorted) {
if (previous && page - previous > 1) result.push(0);
result.push(page);
previous = page;
}
return result;
}
src/lib/cms-api.ts 0 → 100644
View file @ ad00ed3a
import crypto from "node:crypto";
import { marked } from "marked";
import {
StoreError,
addCategory,
createContentSnapshot,
deleteArticle,
discardDraft,
generateSlug,
getCategoryNames,
getCategoryStats,
getPublishStatus,
listWorkingArticles,
publishArticle,
readWorkingArticle,
removeUpload,
removeCategory,
renameCategory,
safeSlug,
saveUpload,
unpublishArticle,
writeArticle,
} from "./article-store";
import { convertWordToMarkdown, decodeWordDataUrl } from "./word-import";
import { currentSessionVersion, savePassword, verifyPassword } from "./cms-auth";
import { buildSiteAtomic, tryAcquireSiteBuildLock, withSiteBuildLock } from "../../scripts/site-build.mjs";
const SECRET = process.env.CMS_SECRET || crypto.randomBytes(32).toString("hex");
const API_KEY = process.env.CMS_API_KEY || "";
const CAPTCHA_TTL = 5 * 60 * 1000;
const CAPTCHA_CHARS = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
const MAX_LOGIN_FAILURES = 5;
const LOGIN_FAILURE_WINDOW = 10 * 60 * 1000;
const LOGIN_BLOCK_DURATION = 10 * 60 * 1000;
const loginAttempts = new Map<string, { count: number; first: number; blockedUntil: number }>();
type BuildState = {
status: "idle" | "building" | "success" | "error";
ok: boolean | null;
log: string;
startedAt: string | null;
finishedAt: string | null;
};
let buildState: BuildState = { status: "idle", ok: null, log: "", startedAt: null, finishedAt: null };
const json = (data: unknown, status = 200, headers?: HeadersInit) => Response.json(data, { status, headers });
const safeEqual = (leftValue: unknown, rightValue: unknown): boolean => {
const left = Buffer.from(String(leftValue));
const right = Buffer.from(String(rightValue));
return left.length === right.length && crypto.timingSafeEqual(left, right);
};
const sessionToken = async () => crypto.createHmac("sha256", SECRET)
.update(`qiyouxue-cms-v2:${await currentSessionVersion()}`)
.digest("hex");
function cookies(request: Request): Record<string, string> {
return Object.fromEntries((request.headers.get("cookie") || "").split(";").filter(Boolean).map((part) => {
const index = part.indexOf("=");
return [part.slice(0, index).trim(), decodeURIComponent(part.slice(index + 1).trim())];
}));
}
function apiKeyValid(request: Request): boolean {
if (!API_KEY) return false;
const auth = request.headers.get("authorization")?.match(/^Bearer\s+(.+)$/i)?.[1];
const key = auth || request.headers.get("x-api-key");
return key ? safeEqual(key, API_KEY) : false;
}
const sessionAuthed = async (request: Request): Promise<boolean> => {
const token = cookies(request).cms_session;
return Boolean(token && safeEqual(token, await sessionToken()));
};
const authed = async (request: Request): Promise<boolean> => await sessionAuthed(request) || apiKeyValid(request);
async function bodyOf(request: Request): Promise<Record<string, unknown>> {
try { return await request.json(); } catch { return {}; }
}
function cookieHeader(request: Request, name: string, value: string, maxAge: number): string {
const forwarded = request.headers.get("x-forwarded-proto");
const secure = new URL(request.url).protocol === "https:" || forwarded === "https";
return `${name}=${value}; HttpOnly; SameSite=Strict; Path=/; Max-Age=${maxAge}${secure ? "; Secure" : ""}`;
}
function loginBlockedFor(ip: string): number {
const state = loginAttempts.get(ip);
return state?.blockedUntil && state.blockedUntil > Date.now()
? Math.ceil((state.blockedUntil - Date.now()) / 1000)
: 0;
}
function loginFailed(ip: string): void {
const now = Date.now();
let state = loginAttempts.get(ip);
if (!state || now - state.first > LOGIN_FAILURE_WINDOW) {
state = { count: 0, first: now, blockedUntil: 0 };
}
state.count += 1;
if (state.count >= MAX_LOGIN_FAILURES) state.blockedUntil = now + LOGIN_BLOCK_DURATION;
loginAttempts.set(ip, state);
}
function randomCaptcha(length = 4): string {
let code = "";
for (let index = 0; index < length; index += 1) {
code += CAPTCHA_CHARS[crypto.randomInt(CAPTCHA_CHARS.length)];
}
return code;
}
function captchaMac(code: unknown, expiresAt: number): string {
return crypto.createHmac("sha256", SECRET)
.update(`${String(code).toUpperCase()}|${expiresAt}`)
.digest("hex");
}
function captchaValid(request: Request, answer: unknown): boolean {
const value = cookies(request).cms_captcha;
if (!value || !answer) return false;
const separator = value.lastIndexOf(".");
const expiresAt = Number(value.slice(0, separator));
const mac = value.slice(separator + 1);
return Boolean(expiresAt && Date.now() <= expiresAt && safeEqual(mac, captchaMac(answer, expiresAt)));
}
function captchaSvg(code: string): string {
const width = 132;
const height = 46;
const colors = ["#8E1C17", "#6F1511", "#D1251A", "#5c3a2e"];
const randomBetween = (min: number, max: number) => crypto.randomInt(min, max + 1);
const pick = <T>(items: T[]): T => items[crypto.randomInt(items.length)];
let content = `<rect width="${width}" height="${height}" fill="#F4E6D6"/>`;
for (let index = 0; index < 4; index += 1) {
content += `<line x1="${randomBetween(0, width)}" y1="${randomBetween(0, height)}" x2="${randomBetween(0, width)}" y2="${randomBetween(0, height)}" stroke="${pick(colors)}" stroke-width="1" opacity="0.45"/>`;
}
[...code].forEach((character, index) => {
const x = 16 + index * 28 + randomBetween(-3, 3);
const y = 31 + randomBetween(-4, 4);
const rotation = randomBetween(-26, 26);
content += `<text x="${x}" y="${y}" font-family="Georgia,serif" font-weight="700" font-size="${randomBetween(24, 30)}" fill="${pick(colors)}" transform="rotate(${rotation} ${x} ${y})">${character}</text>`;
});
for (let index = 0; index < 26; index += 1) {
content += `<circle cx="${randomBetween(0, width)}" cy="${randomBetween(0, height)}" r="1" fill="${pick(colors)}" opacity="0.5"/>`;
}
return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}">${content}</svg>`;
}
function requireSlug(value: string | undefined): string {
const slug = safeSlug(value);
if (!slug) throw new StoreError("网址标识不合法");
return slug;
}
async function startContentBuild(change: () => Promise<void>): Promise<boolean> {
if (buildState.status === "building") return false;
const releaseLock = await tryAcquireSiteBuildLock();
if (!releaseLock) return false;
buildState = { status: "building", ok: null, log: "", startedAt: new Date().toISOString(), finishedAt: null };
void (async () => {
const snapshot = await createContentSnapshot();
try {
await change();
const log = await buildSiteAtomic();
buildState = { status: "success", ok: true, log, startedAt: buildState.startedAt, finishedAt: new Date().toISOString() };
} catch (error) {
let rollbackMessage = "";
try { await snapshot.restore(); } catch (rollbackError) {
rollbackMessage = `\n内容回滚失败：${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`;
}
const message = error instanceof Error ? error.message : String(error);
const log = typeof error === "object" && error && "log" in error ? String(error.log || "") : "";
buildState = {
status: "error",
ok: false,
log: `${log}${log ? "\n" : ""}${message}${rollbackMessage}`,
startedAt: buildState.startedAt,
finishedAt: new Date().toISOString(),
};
}
})().finally(releaseLock).catch((error) => {
buildState = {
status: "error",
ok: false,
log: error instanceof Error ? error.message : String(error),
startedAt: buildState.startedAt,
finishedAt: new Date().toISOString(),
};
});
return true;
}
async function startOrConflict(change: () => Promise<void>): Promise<Response> {
if (!await startContentBuild(change)) {
return json({ error: "网站正在部署或生成静态页面，本次操作未受理，请稍后重试" }, 409, { "Retry-After": "5" });
}
return json({ ok: true, status: "building" });
}
export async function handleCmsApi(request: Request, routeValue: string, clientAddress = "unknown"): Promise<Response> {
const route = routeValue.replace(/^\/+|\/+$/g, "");
const parts = route.split("/").filter(Boolean);
const method = request.method.toUpperCase();
try {
if (route === "captcha" && method === "GET") {
const code = randomCaptcha();
const expiresAt = Date.now() + CAPTCHA_TTL;
return new Response(captchaSvg(code), {
headers: {
"Cache-Control": "no-store",
"Content-Type": "image/svg+xml; charset=utf-8",
"Set-Cookie": cookieHeader(request, "cms_captcha", `${expiresAt}.${captchaMac(code, expiresAt)}`, CAPTCHA_TTL / 1000),
},
});
}
if (route === "session") {
if (method === "GET") return json({ authed: await authed(request) });
if (method === "POST") {
const blockedFor = loginBlockedFor(clientAddress);
if (blockedFor) return json({ error: `尝试过于频繁，请 ${Math.ceil(blockedFor / 60)} 分钟后再试` }, 429);
const body = await bodyOf(request);
const clearCaptcha = cookieHeader(request, "cms_captcha", "", 0);
if (!captchaValid(request, body.captcha)) {
return json({ error: "验证码错误或已过期" }, 400, { "Set-Cookie": clearCaptcha });
}
if (!await verifyPassword(body.password)) {
loginFailed(clientAddress);
return json({ error: "管理密码错误" }, 401, { "Set-Cookie": clearCaptcha });
}
loginAttempts.delete(clientAddress);
const headers = new Headers();
headers.append("Set-Cookie", clearCaptcha);
headers.append("Set-Cookie", cookieHeader(request, "cms_session", await sessionToken(), 86400));
return json({ ok: true }, 200, headers);
}
if (method === "DELETE") return json({ ok: true }, 200, { "Set-Cookie": cookieHeader(request, "cms_session", "", 0) });
}
if (route === "account/password" && method === "PUT") {
if (!await sessionAuthed(request)) throw new StoreError("请先登录文章后台", 401);
const body = await bodyOf(request);
const currentPassword = String(body.currentPassword || "");
const newPassword = String(body.newPassword || "");
if (!await verifyPassword(currentPassword)) throw new StoreError("当前密码错误", 401);
if (newPassword.length < 5) throw new StoreError("新密码至少需要 5 个字符");
if (newPassword.length > 128) throw new StoreError("新密码不能超过 128 个字符");
if (safeEqual(currentPassword, newPassword)) throw new StoreError("新密码不能与当前密码相同");
await savePassword(newPassword);
return json({ ok: true, requiresLogin: true }, 200, {
"Set-Cookie": cookieHeader(request, "cms_session", "", 0),
});
}
if (!await authed(request)) throw new StoreError("请先登录文章后台", 401);
if (route === "categories") {
if (method === "GET") return json({ categories: await getCategoryNames(), stats: await getCategoryStats() });
const body = await bodyOf(request);
if (method === "POST") {
return startOrConflict(async () => { await addCategory(body.name); });
}
if (method === "PATCH") {
return startOrConflict(async () => { await renameCategory(body.current, body.name); });
}
if (method === "DELETE") {
return startOrConflict(async () => { await removeCategory(body.name, body.replacement); });
}
}
if (route === "build" && method === "GET") return json(buildState);
if (route === "articles") {
if (method === "GET") return json(await listWorkingArticles());
if (method === "POST") {
const body = await bodyOf(request);
if (!String(body.title || "").trim()) throw new StoreError("请填写文章标题");
if (!String(body.body || "").trim()) throw new StoreError("请填写文章正文");
const slug = await generateSlug(body.category);
const article = await withSiteBuildLock(() => writeArticle(slug, body, true));
return json({ ok: true, slug, publishStatus: await getPublishStatus(article) }, 201);
}
}
if (route === "imports/word" && method === "POST") {
const body = await bodyOf(request);
const fileName = String(body.fileName || "").trim();
const buffer = decodeWordDataUrl(body.dataUrl, fileName);
const uploadedUrls: string[] = [];
let createdSlug: string | null = null;
try {
const converted = await convertWordToMarkdown(buffer, fileName, async (dataUrl) => {
const url = await saveUpload(dataUrl);
uploadedUrls.push(url);
return url;
});
const title = String(body.title || "").trim() || converted.suggestedTitle;
const imported = await withSiteBuildLock(async () => {
const slug = await generateSlug(body.category);
createdSlug = slug;
const article = await writeArticle(slug, { title, category: body.category, body: converted.body }, true);
return { slug, publishStatus: await getPublishStatus(article) };
});
return json({
ok: true,
slug: imported.slug,
title,
publishStatus: imported.publishStatus,
imageCount: converted.imageCount,
warnings: converted.warnings,
}, 201);
} catch (error) {
if (createdSlug) {
await withSiteBuildLock(() => discardDraft(createdSlug as string)).catch(() => {});
}
await Promise.allSettled(uploadedUrls.map((url) => removeUpload(url)));
throw error;
}
}
if (parts[0] === "articles" && parts[1]) {
const slug = requireSlug(parts[1]);
if (parts.length === 3 && parts[2] === "draft" && method === "DELETE") {
return json({ ok: true, ...await withSiteBuildLock(() => discardDraft(slug)) });
}
if (parts.length === 3 && parts[2] === "publish" && method === "POST") {
return startOrConflict(async () => { await publishArticle(slug); });
}
if (parts.length === 3 && parts[2] === "unpublish" && method === "POST") {
return startOrConflict(async () => { await unpublishArticle(slug); });
}
if (parts.length === 2 && method === "GET") {
const article = await readWorkingArticle(slug);
return json({ ...article, publishStatus: await getPublishStatus(article) });
}
if (parts.length === 2 && method === "PUT") {
const body = await bodyOf(request);
if (!String(body.title || "").trim()) throw new StoreError("请填写文章标题");
if (!String(body.body || "").trim()) throw new StoreError("请填写文章正文");
const article = await withSiteBuildLock(() => writeArticle(slug, body));
return json({ ok: true, slug, publishStatus: await getPublishStatus(article) });
}
if (parts.length === 2 && method === "DELETE") {
return startOrConflict(async () => { await deleteArticle(slug); });
}
}
if (route === "preview" && method === "POST") {
const body = await bodyOf(request);
return json({ html: await marked.parse(String(body.body || "")) });
}
if (route === "uploads" && method === "POST") {
const body = await bodyOf(request);
return json({ ok: true, url: await saveUpload(body.dataUrl) });
}
return json({ error: "接口不存在" }, 404);
} catch (error) {
if (error instanceof StoreError) return json({ error: error.message, ...error.details }, error.status);
if ((error as NodeJS.ErrnoException).code === "ENOENT") return json({ error: "文章不存在" }, 404);
console.error(error);
return json({ error: error instanceof Error ? error.message : "服务器处理失败" }, 500);
}
}
src/lib/cms-auth.ts 0 → 100644
View file @ ad00ed3a
import crypto from "node:crypto";
import fs from "node:fs/promises";
import path from "node:path";
const ROOT = process.cwd();
const DATA_ROOT = process.env.CMS_DATA_DIR ? path.resolve(process.env.CMS_DATA_DIR) : path.join(ROOT, ".runtime");
const AUTH_DIR = path.join(DATA_ROOT, "auth");
const PASSWORD_FILE = path.join(AUTH_DIR, "password.json");
const ENV_PASSWORD = process.env.CMS_PASSWORD || "admin";
const HASH_LENGTH = 64;
const SCRYPT_OPTIONS = { N: 16384, r: 8, p: 1, maxmem: 32 * 1024 * 1024 };
type PasswordState = {
version: 1;
salt: string;
hash: string;
sessionVersion: number;
updatedAt: string;
};
const safeEqual = (leftValue: unknown, rightValue: unknown): boolean => {
const left = Buffer.from(String(leftValue));
const right = Buffer.from(String(rightValue));
return left.length === right.length && crypto.timingSafeEqual(left, right);
};
async function readPasswordState(): Promise<PasswordState | null> {
try {
const parsed = JSON.parse(await fs.readFile(PASSWORD_FILE, "utf8")) as Partial<PasswordState>;
if (parsed.version !== 1 || typeof parsed.salt !== "string" || typeof parsed.hash !== "string" || !Number.isInteger(parsed.sessionVersion)) {
throw new Error("后台密码文件格式无效");
}
return parsed as PasswordState;
} catch (error) {
if ((error as NodeJS.ErrnoException).code === "ENOENT") return null;
throw error;
}
}
async function hashPassword(password: string, salt: Buffer): Promise<Buffer> {
return new Promise((resolve, reject) => {
crypto.scrypt(password, salt, HASH_LENGTH, SCRYPT_OPTIONS, (error, derivedKey) => {
if (error) reject(error);
else resolve(derivedKey);
});
});
}
export async function verifyPassword(password: unknown): Promise<boolean> {
// Check the .env credential first so it remains a recovery password even if
// the optional persisted password file is missing or damaged.
if (safeEqual(password || "", ENV_PASSWORD)) return true;
const state = await readPasswordState();
if (!state) return false;
const hash = await hashPassword(String(password || ""), Buffer.from(state.salt, "base64"));
return safeEqual(hash.toString("base64"), state.hash);
}
export async function currentSessionVersion(): Promise<number> {
try {
return (await readPasswordState())?.sessionVersion || 0;
} catch (error) {
// Keep .env login and recovery available if the optional file is corrupt.
console.error("读取后台密码文件失败：", error);
return 0;
}
}
export async function savePassword(password: string): Promise<void> {
const previous = await readPasswordState().catch(() => null);
const salt = crypto.randomBytes(16);
const hash = await hashPassword(password, salt);
const state: PasswordState = {
version: 1,
salt: salt.toString("base64"),
hash: hash.toString("base64"),
sessionVersion: (previous?.sessionVersion || 0) + 1,
updatedAt: new Date().toISOString(),
};
await fs.mkdir(AUTH_DIR, { recursive: true, mode: 0o700 });
const temporaryFile = `${PASSWORD_FILE}.${process.pid}.${crypto.randomBytes(6).toString("hex")}.tmp`;
try {
await fs.writeFile(temporaryFile, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600, flag: "wx" });
await fs.rename(temporaryFile, PASSWORD_FILE);
} catch (error) {
await fs.rm(temporaryFile, { force: true }).catch(() => {});
throw error;
}
}
src/lib/word-import.ts 0 → 100644
View file @ ad00ed3a
import mammoth from "mammoth";
import TurndownService from "turndown";
import { gfm } from "turndown-plugin-gfm";
import { StoreError } from "./article-store";
export const MAX_WORD_FILE_SIZE = 20 * 1024 * 1024;
const DOCX_MIME = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
const ACCEPTED_DOCX_MIMES = new Set([DOCX_MIME, "application/octet-stream", "application/zip"]);
const IMAGE_MIME_ALIASES: Record<string, string> = {
"image/jpg": "image/jpeg",
"image/x-png": "image/png",
};
const SUPPORTED_IMAGE_MIMES = new Set(["image/png", "image/jpeg", "image/webp", "image/gif"]);
export interface WordImportResult {
body: string;
suggestedTitle: string;
imageCount: number;
warnings: string[];
}
export function decodeWordDataUrl(dataUrl: unknown, fileName: unknown): Buffer {
const name = String(fileName || "").trim();
if (/\.doc$/i.test(name)) throw new StoreError("仅支持 .docx 文件，不支持旧版 .doc 格式");
if (!/\.docx$/i.test(name)) throw new StoreError("请选择 .docx 文件");
const match = String(dataUrl || "").match(/^data:([^;,]+);base64,([a-zA-Z0-9+/=\s]+)$/s);
if (!match || !ACCEPTED_DOCX_MIMES.has(match[1].toLowerCase())) {
throw new StoreError("Word 文件格式不正确，请上传 .docx 文件");
}
const buffer = Buffer.from(match[2].replace(/\s/g, ""), "base64");
if (!buffer.length || buffer.subarray(0, 2).toString("ascii") !== "PK") {
throw new StoreError("Word 文件无效或已经损坏");
}
if (buffer.length > MAX_WORD_FILE_SIZE) throw new StoreError("Word 文件不能超过 20MB", 413);
return buffer;
}
function titleFromFileName(fileName: string): string {
return fileName
.replace(/^.*[\\/]/, "")
.replace(/\.docx$/i, "")
.replace(/[_-]+/g, " ")
.trim() || "Word 导入文章";
}
function plainHeading(value: string): string {
return value
.replace(/!\[[^\]]*\]\([^)]*\)/g, "")
.replace(/\[([^\]]+)\]\([^)]*\)/g, "$1")
.replace(/[`*_~]/g, "")
.trim();
}
export async function convertWordToMarkdown(
buffer: Buffer,
fileName: string,
saveImage: (dataUrl: string) => Promise<string>,
): Promise<WordImportResult> {
let imageCount = 0;
let result: Awaited<ReturnType<typeof mammoth.convertToHtml>>;
try {
result = await mammoth.convertToHtml({ buffer }, {
styleMap: ["p[style-name='Title'] => h1:fresh"],
convertImage: mammoth.images.imgElement(async (image) => {
const mime = IMAGE_MIME_ALIASES[image.contentType] || image.contentType;
if (!SUPPORTED_IMAGE_MIMES.has(mime)) {
throw new StoreError(`Word 中包含不支持的图片格式：${image.contentType || "未知格式"}`);
}
const base64 = await image.readAsBase64String();
const src = await saveImage(`data:${mime};base64,${base64}`);
imageCount += 1;
return { src };
}),
});
} catch (error) {
if (error instanceof StoreError) throw error;
throw new StoreError(`Word 文件解析失败：${error instanceof Error ? error.message : "文件无效或已经损坏"}`);
}
const turndown = new TurndownService({
bulletListMarker: "-",
codeBlockStyle: "fenced",
headingStyle: "atx",
});
turndown.use(gfm);
let body = turndown.turndown(result.value).trim();
let suggestedTitle = titleFromFileName(fileName);
const firstHeading = body.match(/^#\s+(.+)$/m);
if (firstHeading && firstHeading.index !== undefined) {
suggestedTitle = plainHeading(firstHeading[1]) || suggestedTitle;
body = `${body.slice(0, firstHeading.index)}${body.slice(firstHeading.index + firstHeading[0].length)}`
.replace(/^\s+|\s+$/g, "")
.replace(/\n{3,}/g, "\n\n");
}
if (!body) throw new StoreError("Word 文件中没有可导入的正文内容");
return {
body,
suggestedTitle,
imageCount,
warnings: result.messages.map((message) => message.message),
};
}
src/pages/404.astro 0 → 100644
View file @ ad00ed3a
---
import Base from "../layouts/Base.astro"; import Header from "../components/Header.astro"; import Footer from "../components/Footer.astro";
---
<Base title="页面未找到｜启优学" description="你访问的页面不存在。" noindex><Header /><main id="main-content"><section class="not-found"><div class="container" data-reveal><span>404</span><div class="eyebrow"><span></span>PAGE NOT FOUND</div><h1>这一页暂时找不到了</h1><p>可以返回首页，继续了解启优学在线一对一课程与教学服务。</p><a class="button button--yellow" href="/">返回首页</a></div></section></main><Footer /></Base>
src/pages/about/index.astro 0 → 100644
View file @ ad00ed3a
---
import Base from "../../layouts/Base.astro"; import Header from "../../components/Header.astro"; import Footer from "../../components/Footer.astro"; import CTA from "../../components/CTA.astro"; import SectionHeading from "../../components/SectionHeading.astro"; import { site } from "../../data/site";
const title=`关于启优学｜${site.brand.name}`; const description="了解启优学一对一的品牌定位、教育理念、师资匹配方式与在线个性化教学服务。";
---
<Base {title} {description}><Header /><main id="main-content"><section class="page-hero"><div class="container page-hero__inner" data-reveal><div class="breadcrumb"><a href="/">首页</a> / 关于我们</div><div class="eyebrow"><span></span>ABOUT QIYOUXUE</div><h1>打破地域壁垒<br /><em>让优质教育触手可及</em></h1><p>{site.about.position}</p></div></section><section id="position" class="section-pad section-white"><div class="container about-intro-layout"><div><SectionHeading eyebrow="OUR POSITION" title={site.about.heading} /></div><div class="story-column">{site.about.story.map((paragraph,index)=><p data-reveal><span>0{index+1}</span>{paragraph}</p>)}</div></div></section><section class="stat-band"><div class="container stat-grid">{site.home.stats.map(stat=><div data-reveal><strong>{stat.value}</strong><p>{stat.label}</p></div>)}</div></section><section id="advantages" class="section-pad section-blue"><div class="container"><SectionHeading eyebrow="TEACHING ADVANTAGES" title="从看见问题，到看见每一步进展" description="诊断、匹配、互动、回放、反馈与复盘，共同组成可以持续调整的学习服务。" /><div class="advantage-grid">{site.about.advantages.map((item,index)=><article data-reveal><span>0{index+1}</span><h3>{item.title}</h3><p>{item.desc}</p></article>)}</div></div></section><section class="section-pad principle-section"><div class="container principle-layout"><div><div class="eyebrow eyebrow--light"><span></span>EDUCATION PRINCIPLES</div><h2>我们的教育理念</h2><p>成绩是阶段结果，理解力、方法和主动思考能力则陪伴更久。</p></div><div>{[["启发引导","拒绝单向灌输，通过提问与反馈培养主动思考。"],["因材施教","从真实学情出发，为不同学生确定不同任务。"],["能力优先","关注知识掌握，也重视方法、表达与学习习惯。"],["长期陪伴","固定教师持续跟踪，在阶段复盘中稳步调整。"]].map(([name,text],index)=><article data-reveal><span>0{index+1}</span><div><h3>{name}</h3><p>{text}</p></div></article>)}</div></div></section><section class="section-pad vision-section"><div class="container vision-card" data-reveal><span>QIYOUXUE · OUR VISION</span><blockquote>“{site.about.vision}”</blockquote><div><i></i><p>因材施教不是一句口号，而是每一次诊断、匹配与调整。</p></div></div></section><CTA /></main><Footer /></Base>
src/pages/admin/index.astro 0 → 100644
View file @ ad00ed3a
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="robots" content="noindex,nofollow" />
<title>启优学 · 学习资讯后台</title>
<link rel="stylesheet" href="/admin/style.css" />
</head>
<body>
<section id="login" class="login hidden">
<form id="login-form" class="login-card">
<div class="brand-mark">启优学</div>
<h1>学习资讯后台</h1>
<p>输入管理密码和图片验证码，管理官网文章内容。</p>
<label>管理密码<input id="password" type="password" autocomplete="current-password" required /></label>
<label>图片验证码</label>
<div class="captcha-row">
<input id="captcha" autocomplete="off" maxlength="4" inputmode="text" aria-label="图片验证码" required />
<img id="captcha-image" alt="图片验证码，点击可更换" title="看不清？点击换一张" />
</div>
<button class="primary" type="submit">登录后台</button>
<div id="login-error" class="error"></div>
</form>
</section>
<div id="app" class="hidden">
<header class="topbar">
<div><strong>启优学</strong><span>学习资讯后台</span></div>
<div class="top-actions">
<span id="pending-badge" class="pending-badge hidden"></span>
<a class="button ghost" href="/articles/" target="_blank" rel="noopener">查看前台</a>
<button id="change-password" class="ghost" type="button">修改密码</button>
<button id="logout" class="ghost">退出</button>
</div>
</header>
<main id="list-view" class="view">
<div class="view-head"><div><p>CONTENT</p><h1>学习资讯</h1></div><div class="view-actions"><button id="manage-categories" class="ghost">管理分类</button><button id="import-article" class="ghost">导入文件</button><button id="new-article" class="primary">＋ 新建文章</button></div></div>
<input id="article-file" class="hidden" type="file" accept=".md,.docx,text/markdown,application/vnd.openxmlformats-officedocument.wordprocessingml.document" />
<p id="import-status" class="import-status" aria-live="polite"></p>
<div id="article-list" class="article-list"></div>
</main>
<main id="edit-view" class="view hidden">
<div class="view-head editor-titlebar">
<div><button id="back" class="back-button" type="button">← 返回文章列表</button><h1 id="edit-heading">编辑文章</h1></div>
<span id="editor-status" class="status"></span>
</div>
<div id="version-note" class="version-note"></div>
<form id="edit-form">
<section class="field-panel">
<label>文章标题<input id="title" required /></label>
<div class="field-label">
<span>文章分类</span>
<div id="category-select" class="custom-select">
<input id="category" type="hidden" />
<button id="category-trigger" class="select-trigger" type="button" aria-haspopup="listbox" aria-expanded="false">
<span id="category-value"></span><span class="select-chevron" aria-hidden="true">⌄</span>
</button>
<div id="category-menu" class="select-menu hidden">
<div id="category-options" class="select-options" role="listbox" aria-label="文章分类"></div>
<div class="category-create">
<span>添加新分类</span>
<div><input id="new-category" maxlength="20" placeholder="输入分类名称" /><button id="add-category" class="primary small" type="button">添加</button></div>
<p id="category-error" class="error"></p>
</div>
</div>
</div>
</div>
<p class="auto-meta">文章网址、摘要、作者和 SEO 信息将由系统自动生成，无需填写。</p>
</section>
<section class="editor-panel">
<div class="editor-head"><div><strong>文章正文</strong><small>右侧会自动显示预览</small></div><div><span id="upload-status"></span><button id="upload-button" class="ghost small" type="button">插入图片</button></div></div>
<input id="file" class="hidden" type="file" accept="image/png,image/jpeg,image/webp,image/gif" />
<div class="editor-grid"><textarea id="body" required spellcheck="false" placeholder="在这里撰写文章正文……"></textarea><div id="preview" class="preview" aria-live="polite"></div></div>
</section>
<div class="edit-actions">
<button class="ghost save-button" type="submit">保存草稿</button>
<button id="publish" class="primary" type="button">发布到官网</button>
<details id="more-actions" class="more-actions hidden">
<summary>更多操作</summary>
<div class="action-menu">
<button id="discard" class="menu-action hidden" type="button">放弃未发布修改</button>
<button id="unpublish" class="menu-action danger hidden" type="button">下架文章</button>
<button id="delete-article" class="menu-action danger hidden" type="button">删除文章</button>
</div>
</details>
<span id="message"></span>
</div>
</form>
</main>
</div>
<div id="category-modal" class="modal hidden">
<div class="modal-card category-manager">
<div class="modal-head"><div><strong>文章分类管理</strong><small>重命名会同步更新该分类下的文章</small></div><button id="close-category-modal" class="ghost small" type="button">关闭</button></div>
<div class="category-manager-body">
<div class="manager-create"><input id="manager-new-category" maxlength="20" placeholder="输入新分类名称" /><button id="manager-add-category" class="primary" type="button">添加分类</button></div>
<p id="manager-category-error" class="error"></p>
<div id="category-manager-list" class="category-manager-list"></div>
</div>
</div>
</div>
<div id="password-modal" class="modal hidden">
<div class="modal-card password-card">
<div class="modal-head"><div><strong>修改后台密码</strong><small>修改成功后需要使用新密码重新登录</small></div><button id="close-password-modal" class="ghost small" type="button">关闭</button></div>
<form id="password-form" class="password-form">
<label>当前密码<input id="current-password" type="password" autocomplete="current-password" required /></label>
<label>新密码<input id="new-password" type="password" autocomplete="new-password" minlength="5" maxlength="128" required /></label>
<label>确认新密码<input id="confirm-password" type="password" autocomplete="new-password" minlength="5" maxlength="128" required /></label>
<p class="password-hint">新密码至少 5 个字符。</p>
<p id="password-error" class="error"></p>
<div class="password-actions"><button id="cancel-password" class="ghost" type="button">取消</button><button class="primary" type="submit">确认修改</button></div>
</form>
</div>
</div>
<div id="build-modal" class="modal hidden">
<div class="modal-card build-card">
<div><strong id="build-title">正在处理</strong><button id="close-modal" class="ghost small hidden" type="button">关闭</button></div>
<pre id="build-log">系统正在更新官网，请稍候。</pre>
</div>
</div>
<script is:inline src="/admin/app.js"></script>
</body>
</html>
src/pages/api/cms/[...route].ts 0 → 100644
View file @ ad00ed3a
import type { APIRoute } from "astro";
import { handleCmsApi } from "../../../lib/cms-api";
export const prerender = false;
const handler: APIRoute = ({ request, params, clientAddress }) =>
handleCmsApi(request, params.route || "", clientAddress);
export const GET = handler;
export const POST = handler;
export const PUT = handler;
export const PATCH = handler;
export const DELETE = handler;
src/pages/articles/[slug].astro 0 → 100644
View file @ ad00ed3a
---
import Base from "../../layouts/Base.astro"; import Header from "../../components/Header.astro"; import Footer from "../../components/Footer.astro"; import { site } from "../../data/site"; import { getPublishedArticle, getPublishedArticles } from "../../lib/article-store"; import { fmtDate } from "../../lib/articles";
type ArticleDetail = NonNullable<Awaited<ReturnType<typeof getPublishedArticle>>>;
export async function getStaticPaths() { const articles = await getPublishedArticles(); return Promise.all(articles.map(async (article) => ({ params: { slug: article.id }, props: { entry: await getPublishedArticle(article.id) } }))); }
const { entry } = Astro.props as { entry: ArticleDetail }; const article = entry.data; const date = fmtDate(article.date); const title = `${article.title}｜学习资讯｜${site.brand.name}`; const pageUrl = new URL(`/articles/${entry.id}/`, Astro.site).href;
const modified = fmtDate(article.updated || article.date);
const keywords = [article.category, article.title, "学习方法", "在线一对一", site.brand.name];
const jsonLd = [{ "@context": "https://schema.org", "@type": "Article", headline: article.title, description: article.excerpt, datePublished: date, dateModified: modified, articleSection: article.category, inLanguage: "zh-CN", author: { "@type": "Organization", name: article.author }, publisher: { "@id": new URL("/#organization", Astro.site).href }, mainEntityOfPage: { "@type": "WebPage", "@id": `${pageUrl}#webpage` }, url: pageUrl }, { "@context": "https://schema.org", "@type": "BreadcrumbList", itemListElement: [{ "@type": "ListItem", position: 1, name: "首页", item: Astro.site?.href }, { "@type": "ListItem", position: 2, name: "学习资讯", item: new URL("/articles/", Astro.site).href }, { "@type": "ListItem", position: 3, name: article.title, item: pageUrl }] }];
---
<Base {title} description={article.excerpt} {keywords} ogType="article" publishedTime={date} modifiedTime={modified} articleSection={article.category} articleAuthor={article.author} {jsonLd}><Header /><main id="main-content" class="article-detail-page"><article><header class="article-detail-head"><div class="container article-detail-head__inner"><div class="breadcrumb"><a href="/">首页</a> / <a href="/articles/">学习资讯</a> / {article.category}</div><span class="article-detail-category">{article.category}</span><h1>{article.title}</h1><p>{article.excerpt}</p><div class="article-detail-meta"><time datetime={date}>{date}</time><span>{article.author}</span></div></div></header><div class="container article-detail-layout"><aside><a href="/articles/">← 返回学习资讯</a><p>分享学情判断、学习方法、阶段复习与在线一对一服务说明。</p></aside><div class="article-prose" set:html={entry.html}></div></div></article></main><Footer /></Base>
src/pages/articles/index.astro 0 → 100644
View file @ ad00ed3a
---
import ArticlesView from "../../components/ArticlesView.astro";
import { getPublishedArticles, getCategoryNames, getCategories, pageSlice, lastPageOf } from "../../lib/articles";
const all = await getPublishedArticles();
const categories = getCategories(all, await getCategoryNames());
const items = pageSlice(all, 1);
---
<ArticlesView items={items} categories={categories} totalCount={all.length} activeSlug={null} activeName={null} currentPage={1} lastPage={lastPageOf(all.length)} basePath="/articles" />
src/pages/articles/page/[page].astro 0 → 100644
View file @ ad00ed3a
---
import ArticlesView from "../../../components/ArticlesView.astro";
import { getPublishedArticles, getCategoryNames, getCategories, pageSlice, lastPageOf } from "../../../lib/articles";
export async function getStaticPaths() {
const articles = await getPublishedArticles();
return Array.from({ length: Math.max(0, lastPageOf(articles.length) - 1) }, (_, index) => ({
params: { page: String(index + 2) },
}));
}
const all = await getPublishedArticles();
const page = Number(Astro.params.page);
---
<ArticlesView items={pageSlice(all, page)} categories={getCategories(all, await getCategoryNames())} totalCount={all.length} activeSlug={null} activeName={null} currentPage={page} lastPage={lastPageOf(all.length)} basePath="/articles" />
src/pages/articles/topic/[slug]/index.astro 0 → 100644
View file @ ad00ed3a
---
import ArticlesView from "../../../../components/ArticlesView.astro";
import { categoryToSlug, getPublishedArticles, getCategoryNames, getCategories, slugToCategory, pageSlice, lastPageOf } from "../../../../lib/articles";
export async function getStaticPaths() {
return (await getCategoryNames()).map((categoryName) => ({
params: { slug: categoryToSlug(categoryName) },
props: { categoryName },
}));
}
const all = await getPublishedArticles();
const categories = getCategories(all, await getCategoryNames());
const categoryName = String(Astro.props.categoryName || slugToCategory(Astro.params.slug!, categories.map((item) => item.name)) || "");
const filtered = all.filter((item) => item.data.category === categoryName);
---
<ArticlesView items={pageSlice(filtered, 1)} categories={categories} totalCount={all.length} activeSlug={Astro.params.slug!} activeName={categoryName} currentPage={1} lastPage={lastPageOf(filtered.length)} basePath={`/articles/topic/${Astro.params.slug}`} />
src/pages/articles/topic/[slug]/page/[page].astro 0 → 100644
View file @ ad00ed3a
---
import ArticlesView from "../../../../../components/ArticlesView.astro";
import { getPublishedArticles, getCategoryNames, getCategories, slugToCategory, pageSlice, lastPageOf } from "../../../../../lib/articles";
export async function getStaticPaths() {
const articles = await getPublishedArticles();
const categories = getCategories(articles, await getCategoryNames());
const paths: Array<{ params: { slug: string; page: string }; props: { categoryName: string } }> = [];
for (const category of categories) {
for (let page = 2; page <= lastPageOf(category.count); page += 1) {
paths.push({ params: { slug: category.slug, page: String(page) }, props: { categoryName: category.name } });
}
}
return paths;
}
const all = await getPublishedArticles();
const categories = getCategories(all, await getCategoryNames());
const categoryName = String(Astro.props.categoryName || slugToCategory(Astro.params.slug!, categories.map((item) => item.name)) || "");
const filtered = all.filter((item) => item.data.category === categoryName);
const page = Number(Astro.params.page);
---
<ArticlesView items={pageSlice(filtered, page)} categories={categories} totalCount={all.length} activeSlug={Astro.params.slug!} activeName={categoryName} currentPage={page} lastPage={lastPageOf(filtered.length)} basePath={`/articles/topic/${Astro.params.slug}`} />
src/pages/contact/index.astro 0 → 100644
View file @ ad00ed3a
---
import Base from "../../layouts/Base.astro"; import Header from "../../components/Header.astro"; import Footer from "../../components/Footer.astro"; import { site } from "../../data/site"; const title=`联系我们｜${site.brand.name}`; const description=`联系启优学一对一，咨询课程安排、教师匹配和学习方案。客服电话 ${site.contact.phoneDisplay}。`;
---
<Base {title} {description}><Header /><main id="main-content"><section class="contact-hero"><div class="container contact-hero__grid"><div data-reveal><div class="breadcrumb"><a href="/">首页</a> / 联系我们</div><div class="eyebrow eyebrow--light"><span></span>CONTACT QIYOUXUE</div><h1>{site.contact.heading}</h1><p>{site.contact.intro}</p><div class="hero__actions"><a class="button button--yellow" href={`tel:${site.contact.phone}`}>电话咨询 <span>↗</span></a><a class="button button--ghost" href={`mailto:${site.contact.email}`}>发送邮件</a></div></div><div class="contact-hours" data-reveal><span>7×24</span><strong>服务时间</strong><p>周一至周日</p></div></div></section><section class="section-pad section-blue"><div class="container contact-grid"><article data-reveal><span>01</span><h2>客服电话</h2><a class="contact-big-link" href={`tel:${site.contact.phone}`}>{site.contact.phoneDisplay}</a><p>课程咨询与服务反馈</p></article><article data-reveal><span>02</span><h2>微信小程序</h2><strong class="contact-big-link">启优学一对一</strong><p>搜索小程序名称提交预约</p></article><article data-reveal><span>03</span><h2>联系邮箱</h2><a class="contact-big-link contact-big-link--small" href={`mailto:${site.contact.email}`}>{site.contact.email}</a><p>商务合作与服务反馈</p></article><article data-reveal><span>04</span><h2>官方网站</h2><a class="contact-big-link contact-big-link--small" href={`https://${site.contact.website}`}>{site.contact.website}</a><p>官方课程与服务信息</p></article></div></section><section class="section-pad section-white"><div class="container visit-grid"><div><div class="eyebrow"><span></span>BEFORE WE TALK</div><h2>准备这些信息<br />让沟通更聚焦</h2><p>无需制作复杂材料，近期试卷或错题和最关心的问题就足够开始。</p></div><ol>{[["学生年级与地区","帮助确认学段、教材与当前可匹配资源"],["意向学科与教材进度","了解目前正在学习的内容与具体章节"],["近期试卷或错题","定位知识缺口、方法与学习习惯问题"],["当前情况与阶段目标","确定近期任务与适合的检查方式"]].map(([name,text],index)=><li><span>0{index+1}</span><div><strong>{name}</strong><p>{text}</p></div></li>)}</ol></div></section><section class="contact-bottom"><div class="container"><p>QIYOUXUE · PERSONAL LEARNING</p><h2>先看清问题<br />再规划每一步</h2><a class="button button--yellow" href={`tel:${site.contact.phone}`}>立即联系 {site.contact.phoneDisplay}</a></div></section></main><Footer /></Base>
src/pages/faq/index.astro 0 → 100644
View file @ ad00ed3a
---
import Base from "../../layouts/Base.astro"; import Header from "../../components/Header.astro"; import Footer from "../../components/Footer.astro"; import CTA from "../../components/CTA.astro"; import { site } from "../../data/site";
const title=`常见问题｜${site.brand.name}`; const description="启优学一对一关于课程适配、覆盖学段与科目、教师匹配、课堂回放、课后反馈和咨询预约的常见问题。"; const jsonLd={"@context":"https://schema.org","@type":"FAQPage",mainEntity:site.faq.map(item=>({"@type":"Question",name:item.q,acceptedAnswer:{"@type":"Answer",text:item.a}}))};
---
<Base {title} {description} {jsonLd}><Header /><main id="main-content"><section class="page-hero"><div class="container page-hero__inner" data-reveal><div class="breadcrumb"><a href="/">首页</a> / 常见问题</div><div class="eyebrow"><span></span>PARENTS OFTEN ASK</div><h1>关于在线一对一<br /><em>家长关心的问题</em></h1><p>从课程适配、教师匹配到课堂反馈，把重要信息公开说明。</p></div></section><section class="section-pad section-blue"><div class="container faq-layout"><aside data-reveal><span>01 — {String(site.faq.length).padStart(2,"0")}</span><h2>启优学一对一 FAQ</h2><p>具体课程、教师、时间与费用，以咨询后双方确认的信息为准。</p><a class="button button--outline" href="/contact/">预约咨询</a></aside><div class="faq-list">{site.faq.map((item,index)=><details data-reveal open={index===0}><summary><span>{String(index+1).padStart(2,"0")}</span><strong>{item.q}</strong><i></i></summary><div><p>{item.a}</p></div></details>)}</div></div></section><CTA /></main><Footer /></Base>
src/pages/index.astro 0 → 100644
View file @ ad00ed3a
---
import Base from "../layouts/Base.astro";
import Header from "../components/Header.astro";
import Footer from "../components/Footer.astro";
import CTA from "../components/CTA.astro";
import SectionHeading from "../components/SectionHeading.astro";
import heroImage from "../../pic/主页大图素材-1.png";
import { Image } from "astro:assets";
import { site } from "../data/site";
import { fmtDate, getPublishedArticles } from "../lib/articles";
const latest = (await getPublishedArticles()).slice(0, 3);
const jsonLd = [{ "@context": "https://schema.org", "@type": "Service", name: "启优学在线一对一个性化辅导", provider: { "@id": new URL("/#organization", Astro.site).href }, areaServed: { "@type": "Country", name: "中国" }, audience: { "@type": "EducationalAudience", educationalRole: "student" }, description: site.home.subhead }, { "@context": "https://schema.org", "@type": "FAQPage", mainEntity: site.faq.slice(0, 4).map((item) => ({ "@type": "Question", name: item.q, acceptedAnswer: { "@type": "Answer", text: item.a } })) }];
---
<Base title={site.seo.title} jsonLd={jsonLd}><Header /><main id="main-content">
<section class="home-hero"><div class="container home-hero__grid"><div class="home-hero__copy" data-reveal><div class="hero-label"><span>QIYOUXUE · 1 ON 1</span><i></i><strong>小初高在线辅导</strong></div><h1>不是多上一节课<br /><em>是让每一步更适合孩子</em></h1><p>{site.home.subhead}</p><div class="hero__actions"><a class="button button--yellow" href="/contact/">免费领取学情分析 <span>↗</span></a><a class="button button--outline" href="#workflow">了解学习流程</a></div><div class="hero__proof"><span>固定教师</span><span>互动课堂</span><span>课程回放</span><span>阶段复盘</span></div></div><div class="home-hero__visual" data-reveal><div class="image-frame"><Image src={heroImage} widths={[580, 760, 980]} sizes="(max-width: 760px) 100vw, 52vw" alt="启优学老师与学生在线一对一互动学习" format="webp" loading="eager" fetchpriority="high" /></div><div class="hero-note hero-note--top"><span>01</span><strong>先诊断</strong><small>再制定方案</small></div><div class="hero-note hero-note--bottom"><span>✓</span><strong>课后反馈</strong><small>进展清楚可见</small></div></div></div><div class="container stage-ruler" aria-label="覆盖学段"><span>小学 1—6 年级</span><i></i><span>初中 1—3 年级</span><i></i><span>高中 1—3 年级</span></div></section>
<section class="stat-band"><div class="container stat-grid">{site.home.stats.map((stat) => <div data-reveal><strong>{stat.value}</strong><p>{stat.label}</p></div>)}</div><p class="data-note">师资数据来源于启优学一对一教务系统内部统计，截至 2026 年 7 月；相关数据会随师资及业务情况动态更新。</p></section>
<section id="services" class="section-pad section-blue"><div class="container"><div class="section-intro-row"><SectionHeading eyebrow="LEARNING NEEDS" title="从当前最需要解决的问题开始" description="课程不按统一模板推进。先看学生现在在哪里，再决定近期先做什么。" /><a class="text-link" href="/services/">查看全部学习需求 <span>↗</span></a></div><div class="need-grid">{site.services.map((item) => <a class="need-card" href={`/services/${item.slug}/`} data-reveal><div><span>{item.index}</span><small>{item.kicker}</small></div><h3>{item.name}</h3><p>{item.intro}</p><strong>了解适配方式 ↗</strong></a>)}</div></div></section>
<section id="workflow" class="section-pad section-white"><div class="container learning-map"><div class="learning-map__copy"><SectionHeading eyebrow="A VISIBLE LEARNING LOOP" title="学习不是一条直线，而是一轮轮看见问题、解决问题" description="启优学把一次辅导拆成四个可理解的环节，家长知道为什么这样安排，学生知道下一步做什么。" /><a class="button button--outline" href="/methodology/">查看完整教学服务</a></div><div class="learning-map__steps">{site.workflow.map((item, index) => <article data-reveal><span>{item.number}</span><div><small>{index === 0 ? "START" : index === 3 ? "REVIEW" : "NEXT"}</small><h3>{item.title}</h3><p>{item.desc}</p></div><i>{index < 3 ? "↓" : "↻"}</i></article>)}</div></div></section>
<section id="teachers" class="section-pad teacher-section"><div class="container teacher-layout"><div><div class="eyebrow eyebrow--light"><span></span>TEACHER MATCHING</div><h2><em>20000+</em> 签约严选教师<br />匹配的不只是学科</h2><p>综合学生所在地区、学段、学科、教材进度、当前基础、阶段目标与沟通特点进行匹配。教师录取率约 3%，85% 以上来自 985 / 211 或重点师范院校，均要求持有教师资格证。</p><div class="teacher-tags"><span>平均 5—8 年一线经验</span><span>固定教师持续跟进</span><span>分学段分学科匹配</span></div></div><div class="teacher-ledger" data-reveal><div class="ledger-head"><span>MATCHING PROFILE</span><strong>匹配维度</strong></div>{["所在地区与教材版本", "学生学段与意向学科", "当前基础与具体薄弱点", "阶段目标与可用学习时间", "授课节奏与沟通特点"].map((item, index) => <div><span>0{index + 1}</span><strong>{item}</strong><i>✓</i></div>)}</div></div></section>
<section class="section-pad section-yellow"><div class="container feedback-layout"><div class="feedback-board" data-reveal><div class="feedback-board__head"><span>本节学习反馈</span><strong>数学 · 函数基础</strong></div><div class="feedback-score"><span>掌握情况</span><strong>继续巩固</strong></div><ul><li><i></i><div><strong>本节内容</strong><p>梳理函数概念与自变量取值范围</p></div></li><li><i></i><div><strong>课堂观察</strong><p>概念理解清楚，分类讨论仍容易遗漏</p></div></li><li><i></i><div><strong>下节安排</strong><p>从同类错题检查分类讨论步骤</p></div></li></ul></div><div><SectionHeading eyebrow="FEEDBACK AFTER CLASS" title="不是上完就结束，学习进展需要被记录" description="课程支持回放；课后反馈会说明学习内容、课堂表现、仍需巩固的问题及后续安排。具体反馈形式以实际课程方案为准。" /><div class="feedback-points"><span>课堂互动</span><span>课程回放</span><span>错题复盘</span><span>阶段沟通</span></div></div></div></section>
<section class="section-pad section-white"><div class="container faq-preview"><div><SectionHeading eyebrow="PARENTS OFTEN ASK" title="开始一对一辅导前，家长通常会问" description="把课程适配、教师匹配和学习反馈的重要信息公开说明。" /><a class="text-link" href="/faq/">查看全部常见问题 <span>↗</span></a></div><div class="faq-list">{site.faq.slice(0, 4).map((item, index) => <details data-reveal open={index === 0}><summary><span>{String(index + 1).padStart(2, "0")}</span><strong>{item.q}</strong><i></i></summary><div><p>{item.a}</p></div></details>)}</div></div></section>
{latest.length > 0 && <section class="section-pad section-blue"><div class="container"><div class="section-intro-row"><SectionHeading eyebrow="LEARNING NOTES" title="学习资讯与家长指南" description="围绕学情判断、学科方法、阶段复习和在线学习服务的公开说明。" /><a class="text-link" href="/articles/">查看全部资讯 <span>↗</span></a></div><div class="article-grid">{latest.map((item, index) => <article class="article-card" data-reveal><a href={`/articles/${item.id}/`}><div class="article-card__meta"><span>{item.data.category}</span><time>{fmtDate(item.data.date)}</time></div><div class="article-card__index">0{index + 1}</div><h2>{item.data.title}</h2><p>{item.data.excerpt}</p><strong>阅读全文 ↗</strong></a></article>)}</div></div></section>}
<CTA />
</main><Footer /></Base>
src/pages/join/index.astro 0 → 100644
View file @ ad00ed3a
---
return Astro.redirect("/methodology/", 301);
---
src/pages/llms-full.txt.ts 0 → 100644
View file @ ad00ed3a
import type { APIRoute } from "astro";
import { site } from "../data/site";
import { getPublishedArticles } from "../lib/articles";
export const prerender = true;
export const GET: APIRoute = async ({ site: configuredSite }) => {
const articles = await getPublishedArticles();
const origin = configuredSite ?? new URL("https://qiyouxueedu.com");
const url = (pathname: string) => new URL(pathname, origin).href;
const lines = [
`# ${site.brand.name}（${site.brand.englishName}）完整站点内容`, "", `> ${site.brand.tagline}`, "",
`官方网站：${url("/")}`, `企业主体：${site.brand.legalName}`, `咨询电话：${site.contact.phone}`, `联系邮箱：${site.contact.email}`, `公司地址：${site.contact.address}`, "",
"## 品牌与服务概览", "", site.home.subhead, "", ...site.about.story, "",
"## 公开数据", "", ...site.home.stats.map((stat) => `- ${stat.label}：${stat.value}`), "",
"## 学习需求", "", `学科辅导总览：${url("/services/")}`, "",
...site.services.flatMap((service) => [
`### ${service.name}`, "", `页面：${url(`/services/${service.slug}/`)}`, "", service.intro, "", "服务特点：", ...service.features.map((feature) => `- ${feature}`), "", "核心能力：", ...service.capabilities.map((capability) => `- ${capability.label}：${capability.value}`), "",
]),
"## 教学服务能力", "", ...site.about.technologies.map((technology) => `- ${technology}`), "",
"## 学习服务流程", "", ...site.workflow.map((step) => `- ${step.title}：${step.desc}`), "",
"## 常见问题", "", `常见问题页面：${url("/faq/")}`, "", ...site.faq.flatMap((item) => [`### ${item.q}`, "", item.a, ""]),
"## 学习资讯全文", "", ...articles.flatMap((article) => [`### ${article.data.title}`, "", `页面：${url(`/articles/${article.id}/`)}`, `分类：${article.data.category}`, `作者：${article.data.author}`, `发布日期：${article.data.date.toISOString().slice(0, 10)}`, `更新时间：${article.data.updated.toISOString().slice(0, 10)}`, "", article.data.excerpt, "", article.body, ""]),
"## 联系方式", "", `联系页面：${url("/contact/")}`, `咨询电话：${site.contact.phone}`, `联系邮箱：${site.contact.email}`, `公司地址：${site.contact.address}`, `内容矩阵：${site.contact.socials.join("、")}`, "",
];
return new Response(lines.join("\n"), { headers: { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "public, max-age=3600" } });
};
src/pages/llms.txt.ts 0 → 100644
View file @ ad00ed3a
import type { APIRoute } from "astro";
import { site } from "../data/site";
import { getPublishedArticles } from "../lib/articles";
export const prerender = true;
export const GET: APIRoute = async ({ site: configuredSite }) => {
const articles = await getPublishedArticles();
const origin = configuredSite ?? new URL("https://qiyouxueedu.com");
const url = (pathname: string) => new URL(pathname, origin).href;
const lines = [
`# ${site.brand.name}`,
"",
`> ${site.brand.tagline}`,
"",
site.about.position,
"",
"## 核心页面",
`- [首页](${url("/")})`,
`- [学科辅导](${url("/services/")})`,
...site.services.map((service) => `- [${service.name}](${url(`/services/${service.slug}/`)}): ${service.seoDescription}`),
`- [关于启优学](${url("/about/")})`,
`- [教学服务](${url("/methodology/")})`,
`- [学习资讯](${url("/articles/")})`,
`- [常见问题](${url("/faq/")})`,
`- [联系我们](${url("/contact/")})`,
"",
"## 最新资讯",
...articles.map((article) => `- [${article.data.title}](${url(`/articles/${article.id}/`)}): ${article.data.excerpt}`),
"",
`- [完整站点内容](${url("/llms-full.txt")})`,
"", `咨询电话：${site.contact.phone}`, `联系邮箱：${site.contact.email}`, `公司地址：${site.contact.address}`,
];
return new Response(lines.join("\n"), { headers: { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "public, max-age=3600" } });
};
src/pages/methodology/index.astro 0 → 100644
View file @ ad00ed3a
---
import Base from "../../layouts/Base.astro"; import Header from "../../components/Header.astro"; import Footer from "../../components/Footer.astro"; import CTA from "../../components/CTA.astro"; import SectionHeading from "../../components/SectionHeading.astro"; import { site } from "../../data/site";
const title=`教学服务｜${site.brand.name}`; const description="了解启优学一对一从学情沟通、问题诊断、教师匹配到课堂反馈与阶段复盘的教学服务流程。";
---
<Base {title} {description}><Header /><main id="main-content"><section class="page-hero"><div class="container page-hero__inner" data-reveal><div class="breadcrumb"><a href="/">首页</a> / 教学服务</div><div class="eyebrow"><span></span>TEACHING SERVICE</div><h1>不从一套课程开始<br /><em>从孩子当前的问题开始</em></h1><p>通过学情沟通和诊断，把宽泛目标拆成近期任务，再匹配教师、开展互动课堂并持续复盘。</p></div></section><section id="workflow" class="section-pad section-white"><div class="container"><SectionHeading eyebrow="LEARNING LOOP" title="四步形成可持续调整的学习闭环" description="每一轮课堂与反馈，都会成为下一轮安排的依据。" align="center" /><div class="method-flow">{site.workflow.map((item,index)=><article data-reveal><div><span>{item.number}</span><i>{index<3?"→":"↻"}</i></div><h2>{item.title}</h2><p>{item.desc}</p></article>)}</div></div></section><section id="delivery" class="section-pad delivery-section"><div class="container delivery-layout"><div><SectionHeading eyebrow="VISIBLE FEEDBACK" title="课堂过程有记录，下一步有依据" description="学习服务不仅是一节在线课，也包含课堂互动、课程回放、课后记录和阶段沟通。" light /></div><div class="delivery-grid">{[["01","学情沟通","年级、教材、试卷、错题与目标等基础信息"],["02","课堂互动","提问、作答、即时纠错与难度调整"],["03","课后反馈","本节内容、掌握情况、仍需巩固的问题"],["04","阶段复盘","结合课堂与练习表现调整后续安排"]].map(([num,name,text])=><article data-reveal><span>{num}</span><h3>{name}</h3><p>{text}</p></article>)}</div></div></section><section class="section-pad section-blue"><div class="container"><SectionHeading eyebrow="SERVICE BOUNDARIES" title="把重要信息提前说清楚" align="center" /><div class="principle-grid">{[["适配","一对一更适合问题较明确、需要个别讲解节奏或持续反馈的学生。"],["透明","实际课程、教师、时间、费用与反馈形式以双方确认的方案为准。"],["共同参与","学习效果还会受到基础、频率、练习、周期与家庭配合等因素影响。"]].map(([name,text],index)=><article data-reveal><span>0{index+1}</span><h3>{name}</h3><p>{text}</p></article>)}</div></div></section><CTA /></main><Footer /></Base>
src/pages/services/[slug].astro 0 → 100644
View file @ ad00ed3a
---
import Base from "../../layouts/Base.astro"; import Header from "../../components/Header.astro"; import Footer from "../../components/Footer.astro"; import CTA from "../../components/CTA.astro"; import { site } from "../../data/site";
export function getStaticPaths(){return site.services.map(service=>({params:{slug:service.slug},props:{service}}));} type Service=(typeof site.services)[number]; const {service}=Astro.props as {service:Service}; const related=site.services.filter(item=>item.slug!==service.slug);
const jsonLd={"@context":"https://schema.org","@type":"Service",name:service.name,serviceType:"在线一对一个性化辅导",description:service.seoDescription,provider:{"@id":new URL("/#organization",Astro.site).href},areaServed:{"@type":"Country",name:"中国"}};
---
<Base title={service.seoTitle} description={service.seoDescription} keywords={service.seoKeywords} {jsonLd}><Header /><main id="main-content"><section class="service-hero"><div class="container service-hero__inner"><div data-reveal><div class="breadcrumb"><a href="/">首页</a> / <a href="/services/">学科辅导</a> / {service.name}</div><div class="service-hero__tag"><span>{service.index}</span>{service.kicker}</div><h1>{service.name}<br /><em>{service.intro}</em></h1><div class="hero__actions"><a class="button button--yellow" href="/contact/">预约学情分析 <span>↗</span></a><a class="button button--outline" href="#capabilities">了解课程重点</a></div></div><div class="plan-sheet" data-reveal><div><small>PERSONAL LEARNING PLAN</small><strong>个性化阶段方案</strong></div>{service.capabilities.map((item,index)=><article><span>0{index+1}</span><div><small>{item.label}</small><p>{item.value}</p></div><i>✓</i></article>)}<p>示意内容 · 实际方案以学情沟通后确认为准</p></div></div></section><section id="capabilities" class="section-pad section-blue"><div class="container service-cap-layout"><div><div class="eyebrow"><span></span>HOW IT WORKS</div><h2>把宽泛目标<br />拆成可检查的任务</h2><p>{service.seoDescription}</p></div><div class="service-cap-grid">{service.capabilities.map((item,index)=><article data-reveal><span>0{index+1}</span><h3>{item.label}</h3><p>{item.value}</p></article>)}</div></div></section><section class="section-pad section-white"><div class="container service-feature-layout"><div class="service-symbol" data-reveal><small>QIYOUXUE</small><strong>{service.index}</strong><span>1 ON 1</span></div><div><div class="eyebrow"><span></span>COURSE FOCUS</div><h2>课程如何围绕学生展开</h2><ul class="large-check-list">{service.features.map((feature,index)=><li data-reveal><span>0{index+1}</span><p>{feature}</p></li>)}</ul></div></div></section><section class="section-pad process-section"><div class="container"><div class="section-heading section-heading--center section-heading--light"><div class="eyebrow"><span></span>LEARNING PROCESS</div><h2>四步形成学习闭环</h2><p>课程、教师、时间与学习结果受多种因素影响，具体安排以双方确认的方案为准。</p></div><div class="process-grid">{service.process.map((step,index)=><article data-reveal><span>0{index+1}</span><h3>{step}</h3><i>{index<3?"→":"↻"}</i></article>)}</div></div></section><nav class="related-services" aria-label="其他学习需求"><div class="container">{related.map(item=><a href={`/services/${item.slug}/`}><span>{item.index}</span><strong>{item.name}</strong><i>↗</i></a>)}</div></nav><CTA title={`先判断${service.name}是否适合孩子`} text="准备近期试卷、错题、教材进度和阶段目标，从一次学情沟通开始。" /></main><Footer /></Base>
src/pages/services/index.astro 0 → 100644
View file @ ad00ed3a
---
import Base from "../../layouts/Base.astro"; import Header from "../../components/Header.astro"; import Footer from "../../components/Footer.astro"; import CTA from "../../components/CTA.astro"; import SectionHeading from "../../components/SectionHeading.astro"; import { site } from "../../data/site";
const title = `学科辅导｜${site.brand.name}`; const description = "启优学一对一覆盖基础巩固、偏科补弱、校内同步、阶段复习与升学冲刺等小初高学习需求。";
const jsonLd = { "@context": "https://schema.org", "@type": "ItemList", name: "启优学学科辅导", itemListElement: site.services.map((item, index) => ({ "@type": "ListItem", position: index + 1, name: item.name, url: new URL(`/services/${item.slug}/`, Astro.site).href })) };
---
<Base {title} {description} {jsonLd}><Header /><main id="main-content"><section class="page-hero"><div class="container page-hero__inner" data-reveal><div class="breadcrumb"><a href="/">首页</a> / 学科辅导</div><div class="eyebrow"><span></span>SUBJECT SUPPORT</div><h1>同一个年级<br /><em>也应该有不同的学习路径</em></h1><p>覆盖小学、初中和高中常见校内学科。从当前基础、教材进度和具体问题出发，确定近期最需要解决的任务。</p></div></section><nav class="anchor-nav"><div class="container">{site.services.map((item) => <a href={`#${item.slug}`}><span>{item.index}</span>{item.name}</a>)}</div></nav><section class="section-pad section-blue"><div class="container service-list">{site.services.map((item) => <article id={item.slug} class="service-detail"><div class="service-detail__content" data-reveal><div class="service-detail__summary"><div class="eyebrow"><span></span>{item.kicker}</div><h2>{item.name}</h2><p class="lead">{item.intro}</p><a class="button button--outline" href={`/services/${item.slug}/`}>查看适配方式 <span>↗</span></a></div><div class="service-detail__delivery"><ul>{item.features.map((feature) => <li><span>✓</span>{feature}</li>)}</ul><div class="capability-pills">{item.capabilities.map((capability) => <span>{capability.label}</span>)}</div></div></div></article>)}</div></section><section class="section-pad section-white"><div class="container"><SectionHeading eyebrow="STAGES & SUBJECTS" title="学段不同，学习重点也不同" description="小学关注基础与习惯，初中梳理知识结构与偏科问题，高中更重视知识体系、题型方法与复习节奏。" align="center" /><div class="stage-grid">{[["小学","1—6 年级","语文 · 数学 · 英语"],["初中","1—3 年级","语数英 · 物理 · 化学 · 道法 · 地理"],["高中","1—3 年级","语数英 · 物化生 · 政史地"]].map(([name,grade,subjects])=><article data-reveal><span>{grade}</span><h3>{name}</h3><p>{subjects}</p></article>)}</div></div></section><CTA title="不确定孩子适合哪种学习安排？" text="先提供年级、教材进度、近期试卷与最希望解决的问题，再判断一对一是否适合。" /></main><Footer /></Base>
src/pages/uploads/[file].ts 0 → 100644
View file @ ad00ed3a
import type { APIRoute } from "astro";
import path from "node:path";
import fs from "node:fs/promises";
import { UPLOADS_DIR } from "../../lib/article-store";
export const prerender = false;
const MIME_TYPES: Record<string, string> = {
".png": "image/png",
".jpg": "image/jpeg",
".jpeg": "image/jpeg",
".webp": "image/webp",
".gif": "image/gif",
};
export const GET: APIRoute = async ({ params }) => {
const filename = params.file || "";
if (!/^[a-zA-Z0-9._-]+$/.test(filename)) return new Response("Not Found", { status: 404 });
try {
const content = await fs.readFile(path.join(UPLOADS_DIR, filename));
return new Response(content, {
headers: {
"Content-Type": MIME_TYPES[path.extname(filename).toLowerCase()] || "application/octet-stream",
"Cache-Control": "public, max-age=31536000, immutable",
},
});
} catch {
return new Response("Not Found", { status: 404 });
}
};
src/styles/global.css 0 → 100644
View file @ ad00ed3a
:root{--brand-blue:#0868ac;--brand-blue-dark:#164a72;--brand-blue-light:#2f86c7;--brand-yellow:#f6b900;--brand-yellow-soft:#fff5d6;--bg-page:#fcfdfc;--bg-card:#fff;--bg-blue-soft:#eef7fc;--bg-yellow-soft:#fff8e7;--text-primary:#172b3a;--text-secondary:#4b5e6b;--text-muted:#7b8a94;--border:#dce8ef;--divider:#e8eff3;--primary-hover:#075a95;--yellow-hover:#e5ac00;--shadow-card:0 6px 24px rgba(22,74,114,.06);--shadow-hover:0 10px 32px rgba(22,74,114,.1);--container:1220px}
*{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;color:var(--text-primary);background:var(--bg-page);font-family:"Noto Sans SC","PingFang SC","Microsoft YaHei",system-ui,sans-serif;font-size:16px;line-height:1.75;-webkit-font-smoothing:antialiased}body,button,input,textarea{font-family:inherit}a{color:inherit;text-decoration:none}img,svg{display:block;max-width:100%}button{color:inherit}address{font-style:normal}h1,h2,h3,p,ul,ol,blockquote{margin-top:0}h1,h2,h3,strong{line-height:1.25}h1,h2,h3{font-family:"HarmonyOS Sans SC","Source Han Sans SC","PingFang SC",sans-serif}::selection{color:#fff;background:var(--brand-blue)}.container{width:min(calc(100% - 48px),var(--container));margin-inline:auto}.section-pad{padding:104px 0}.section-white{background:#fff}.section-blue,.section-muted{background:var(--bg-blue-soft)}.section-yellow{background:var(--bg-yellow-soft)}.skip-link{position:fixed;z-index:1000;top:12px;left:12px;padding:10px 16px;color:#fff;background:var(--brand-blue-dark);transform:translateY(-150%)}.skip-link:focus{transform:none}[data-reveal]{opacity:0;transform:translateY(18px);transition:opacity .65s ease,transform .65s ease}[data-reveal].is-visible{opacity:1;transform:none}
.eyebrow{display:flex;align-items:center;gap:10px;margin-bottom:16px;color:var(--brand-blue);font-size:11px;font-weight:800;letter-spacing:.16em}.eyebrow>span{width:28px;height:2px;background:var(--brand-yellow)}.eyebrow--light,.section-heading--light .eyebrow{color:#d8eefb}.section-heading{max-width:700px}.section-heading--center{margin-inline:auto;text-align:center}.section-heading--center .eyebrow{justify-content:center}.section-heading h2{margin-bottom:20px;font-size:clamp(34px,4vw,54px);letter-spacing:-.045em}.section-heading>p{margin:0;color:var(--text-secondary);font-size:17px}.section-heading--light h2{color:#fff}.section-heading--light>p{color:#c9deea}.section-intro-row{display:flex;align-items:end;justify-content:space-between;gap:50px;margin-bottom:48px}.text-link{color:var(--brand-blue);font-weight:750;white-space:nowrap}.text-link span{color:var(--brand-yellow)}.text-link--light{color:#fff}
.button{display:inline-flex;align-items:center;justify-content:center;gap:12px;min-height:52px;padding:0 25px;border:1px solid var(--brand-blue);border-radius:9px;color:#fff;background:var(--brand-blue);font-size:14px;font-weight:800;letter-spacing:.02em;transition:background .2s,border-color .2s,transform .2s}.button:hover{border-color:var(--primary-hover);background:var(--primary-hover);transform:translateY(-2px)}.button--small{min-height:42px;padding:0 18px;font-size:13px}.button--yellow{border-color:var(--brand-yellow);color:var(--text-primary);background:var(--brand-yellow)}.button--yellow:hover{border-color:var(--yellow-hover);background:var(--yellow-hover)}.button--outline{color:var(--brand-blue);background:#fff}.button--outline:hover{color:#fff}.button--ghost{border-color:rgba(255,255,255,.55);background:transparent}.button--white{border-color:#fff;color:var(--brand-blue-dark);background:#fff}.hero__actions{display:flex;flex-wrap:wrap;gap:12px}
.site-header{position:sticky;z-index:100;top:0;height:76px;border-bottom:1px solid rgba(220,232,239,.8);background:rgba(252,253,252,.96);transition:box-shadow .25s}.site-header.is-scrolled{box-shadow:0 8px 24px rgba(22,74,114,.08)}.site-header__inner{display:flex;align-items:center;height:100%;gap:24px}.brand{width:132px;height:62px;overflow:hidden}.brand img{width:100%;height:100%;object-fit:cover;object-position:center}.desktop-nav{margin-left:auto}.desktop-nav>ul{display:flex;margin:0;padding:0;list-style:none}.nav-item{position:relative}.nav-link{position:relative;display:block;padding:27px 13px 24px;color:#304957;font-size:14px;font-weight:650}.nav-link::after{position:absolute;right:13px;bottom:16px;left:13px;height:2px;content:"";background:var(--brand-yellow);transform:scaleX(0);transition:transform .25s}.nav-link:hover,.nav-link[aria-current=page]{color:var(--brand-blue)}.nav-link:hover::after,.nav-link[aria-current=page]::after{transform:scaleX(1)}.nav-dropdown{position:absolute;top:calc(100% - 4px);left:50%;visibility:hidden;width:220px;padding-top:10px;opacity:0;transform:translate(-50%,8px);transition:.2s}.nav-item:hover .nav-dropdown,.nav-item:focus-within .nav-dropdown{visibility:visible;opacity:1;transform:translate(-50%,0)}.nav-dropdown ul{margin:0;padding:8px;border:1px solid var(--border);border-radius:10px;background:#fff;box-shadow:var(--shadow-hover);list-style:none}.nav-dropdown a{display:flex;justify-content:space-between;padding:10px 12px;border-radius:7px;font-size:13px}.nav-dropdown a:hover{color:var(--brand-blue);background:var(--bg-blue-soft)}.mobile-nav{display:none;margin-left:auto}.mobile-nav summary{display:grid;width:40px;height:40px;padding:10px;cursor:pointer;list-style:none}.mobile-nav summary span{height:2px;background:var(--brand-blue-dark)}
.home-hero{overflow:hidden;padding:56px 0 0;background:#fff}.home-hero__grid{display:grid;grid-template-columns:.9fr 1.1fr;align-items:center;gap:48px}.hero-label{display:flex;align-items:center;gap:12px;margin-bottom:25px;color:var(--brand-blue);font-size:11px;font-weight:800;letter-spacing:.12em}.hero-label i{width:1px;height:15px;background:var(--border)}.hero-label strong{color:var(--text-secondary);letter-spacing:.04em}.home-hero h1{margin-bottom:25px;font-size:clamp(46px,5.6vw,76px);line-height:1.1;letter-spacing:-.06em}.home-hero h1 em,.page-hero h1 em{color:var(--brand-blue);font-style:normal}.home-hero__copy>p{max-width:600px;margin-bottom:32px;color:var(--text-secondary);font-size:18px}.hero__proof{display:flex;flex-wrap:wrap;gap:16px;margin-top:30px}.hero__proof span{display:flex;align-items:center;gap:8px;color:var(--text-secondary);font-size:13px}.hero__proof span::before{width:6px;height:6px;border-radius:50%;content:"";background:var(--brand-yellow)}.home-hero__visual{position:relative}.image-frame{overflow:hidden;border:1px solid var(--border);border-radius:32px 8px 32px 8px;background:var(--bg-blue-soft);box-shadow:0 24px 60px rgba(22,74,114,.12)}.image-frame img{width:100%;aspect-ratio:1.22;object-fit:cover}.hero-note{position:absolute;display:grid;grid-template-columns:auto 1fr;column-gap:10px;padding:14px 17px;border:1px solid var(--border);border-radius:12px;background:#fff;box-shadow:var(--shadow-hover)}.hero-note>span{grid-row:1/3;display:grid;place-items:center;width:36px;height:36px;border-radius:50%;color:var(--brand-blue-dark);background:var(--brand-yellow);font-weight:900}.hero-note strong{font-size:14px}.hero-note small{color:var(--text-muted)}.hero-note--top{top:28px;left:-28px}.hero-note--bottom{right:-18px;bottom:30px}.stage-ruler{display:flex;align-items:center;justify-content:center;gap:25px;margin-top:50px;padding:20px 0;border-top:1px solid var(--divider);color:var(--brand-blue-dark);font-size:14px;font-weight:750}.stage-ruler i{width:5px;height:5px;border-radius:50%;background:var(--brand-yellow)}
.stat-band{padding:46px 0;color:#fff;background:var(--brand-blue-dark)}.stat-grid{display:grid;grid-template-columns:repeat(4,1fr)}.stat-grid>div{padding:0 30px;border-right:1px solid rgba(255,255,255,.18);text-align:center}.stat-grid>div:last-child{border:0}.stat-grid strong{display:block;color:var(--brand-yellow);font-size:clamp(30px,4vw,48px);font-weight:850;letter-spacing:-.04em}.stat-grid p{margin:8px 0 0;color:#d9e8f1;font-size:13px}.data-note{max-width:900px;margin:24px auto 0;color:#abc5d6;font-size:11px;text-align:center}.need-grid{display:grid;grid-template-columns:repeat(4,1fr);gap:16px}.need-card{display:flex;min-height:320px;padding:28px;flex-direction:column;border:1px solid var(--border);border-radius:16px;background:#fff;box-shadow:var(--shadow-card);transition:.25s}.need-card:hover{border-color:#b9d7e8;box-shadow:var(--shadow-hover);transform:translateY(-3px)}.need-card>div{display:flex;align-items:center;justify-content:space-between;color:var(--brand-blue)}.need-card>div>span{display:grid;place-items:center;width:40px;height:40px;border-radius:50%;color:var(--brand-blue-dark);background:var(--brand-yellow);font-weight:900}.need-card small{font-size:10px;letter-spacing:.12em}.need-card h3{margin:54px 0 14px;font-size:27px}.need-card p{color:var(--text-secondary)}.need-card>strong{margin-top:auto;color:var(--brand-blue);font-size:13px}.learning-map{display:grid;grid-template-columns:.9fr 1.1fr;gap:90px}.learning-map__copy{position:sticky;top:120px;align-self:start}.learning-map__copy .button{margin-top:30px}.learning-map__steps{position:relative}.learning-map__steps::before{position:absolute;top:25px;bottom:25px;left:29px;width:2px;content:"";background:var(--border)}.learning-map__steps article{position:relative;display:grid;grid-template-columns:60px 1fr 28px;align-items:center;gap:20px;padding:26px 0;border-bottom:1px solid var(--divider)}.learning-map__steps article>span{z-index:1;display:grid;place-items:center;width:58px;height:58px;border:2px solid var(--brand-blue);border-radius:50%;color:var(--brand-blue);background:#fff;font-weight:900}.learning-map__steps article:last-child>span{border-color:var(--brand-yellow);color:var(--text-primary);background:var(--brand-yellow)}.learning-map__steps small{color:var(--text-muted);font-size:10px;letter-spacing:.16em}.learning-map__steps h3{margin:3px 0 5px;font-size:24px}.learning-map__steps p{margin:0;color:var(--text-secondary)}.learning-map__steps article>i{color:var(--brand-yellow);font-size:22px;font-style:normal}.teacher-section{color:#fff;background:var(--brand-blue-dark)}.teacher-layout{display:grid;grid-template-columns:1fr .9fr;gap:80px;align-items:center}.teacher-layout h2{margin-bottom:22px;font-size:clamp(38px,4.6vw,60px);letter-spacing:-.05em}.teacher-layout h2 em{color:var(--brand-yellow);font-style:normal}.teacher-layout>div>p{color:#c7dce9;font-size:17px}.teacher-tags{display:flex;flex-wrap:wrap;gap:8px;margin-top:26px}.teacher-tags span{padding:7px 11px;border:1px solid rgba(255,255,255,.2);border-radius:6px;color:#e3f0f6;font-size:12px}.teacher-ledger{padding:26px;border:1px solid rgba(255,255,255,.18);border-radius:18px;background:#fff;color:var(--text-primary);box-shadow:0 22px 50px rgba(5,35,55,.22)}.ledger-head{display:flex;justify-content:space-between;padding-bottom:20px;border-bottom:2px solid var(--brand-blue-dark)}.ledger-head span{color:var(--brand-blue);font-size:10px;letter-spacing:.14em}.teacher-ledger>div:not(:first-child){display:grid;grid-template-columns:40px 1fr auto;gap:14px;padding:16px 0;border-bottom:1px solid var(--divider)}.teacher-ledger>div:not(:first-child)>span{color:var(--text-muted);font-size:12px}.teacher-ledger i{color:var(--brand-blue);font-style:normal}.feedback-layout{display:grid;grid-template-columns:1fr 1fr;gap:90px;align-items:center}.feedback-board{overflow:hidden;border:1px solid #e9d99e;border-radius:16px;background:#fff;box-shadow:var(--shadow-card)}.feedback-board__head{display:flex;align-items:center;justify-content:space-between;padding:20px 24px;color:#fff;background:var(--brand-blue-dark)}.feedback-board__head span{font-size:12px}.feedback-score{display:flex;align-items:center;justify-content:space-between;padding:18px 24px;border-bottom:1px solid var(--divider)}.feedback-score strong{color:var(--brand-blue)}.feedback-board ul{margin:0;padding:8px 24px 20px;list-style:none}.feedback-board li{display:flex;gap:14px;padding:16px 0;border-bottom:1px solid var(--divider)}.feedback-board li:last-child{border:0}.feedback-board li>i{width:9px;height:9px;margin-top:7px;border:2px solid var(--brand-yellow);border-radius:50%}.feedback-board li p{margin:4px 0 0;color:var(--text-secondary);font-size:13px}.feedback-points{display:flex;flex-wrap:wrap;gap:9px;margin-top:26px}.feedback-points span{padding:8px 12px;border:1px solid #ebd996;border-radius:8px;background:#fff;color:var(--brand-blue-dark);font-size:12px;font-weight:750}.faq-preview,.faq-layout{display:grid;grid-template-columns:.65fr 1.35fr;gap:80px}.faq-preview>div:first-child{position:sticky;top:110px;align-self:start}.faq-list details{border-bottom:1px solid var(--border)}.faq-list summary{display:grid;grid-template-columns:38px 1fr 24px;gap:14px;align-items:center;padding:23px 0;cursor:pointer;list-style:none}.faq-list summary>span{color:var(--brand-blue);font-size:12px}.faq-list summary>strong{font-size:17px}.faq-list summary>i{position:relative;width:18px;height:18px}.faq-list summary>i::before,.faq-list summary>i::after{position:absolute;top:8px;left:3px;width:12px;height:2px;content:"";background:var(--brand-blue)}.faq-list summary>i::after{transform:rotate(90deg);transition:.2s}.faq-list details[open] summary>i::after{transform:none}.faq-list details>div{padding:0 38px 20px 52px;color:var(--text-secondary)}
.page-hero{min-height:430px;padding:92px 0 78px;background:var(--bg-blue-soft)}.page-hero__inner{max-width:930px}.breadcrumb{margin-bottom:34px;color:var(--text-muted);font-size:12px}.breadcrumb a:hover{color:var(--brand-blue)}.page-hero h1{margin-bottom:24px;font-size:clamp(45px,6vw,72px);line-height:1.12;letter-spacing:-.055em}.page-hero p{max-width:760px;margin:0;color:var(--text-secondary);font-size:18px}.anchor-nav{position:sticky;z-index:20;top:76px;border-block:1px solid var(--border);background:rgba(255,255,255,.96)}.anchor-nav .container{display:grid;grid-template-columns:repeat(4,1fr)}.anchor-nav a{padding:18px;border-right:1px solid var(--border);color:var(--text-secondary);font-size:13px;text-align:center}.anchor-nav a span{margin-right:8px;color:var(--brand-blue)}.service-list{display:grid;gap:18px}.service-detail{scroll-margin-top:150px;border:1px solid var(--border);border-radius:16px;background:#fff}.service-detail__content{display:grid;grid-template-columns:.85fr 1.15fr;gap:60px;padding:46px}.service-detail__summary h2{margin-bottom:16px;font-size:40px}.service-detail__summary .lead{color:var(--text-secondary);font-size:17px}.service-detail__delivery ul{margin:0 0 24px;padding:0;list-style:none}.service-detail__delivery li{display:flex;gap:12px;padding:12px 0;border-bottom:1px solid var(--divider);color:var(--text-secondary)}.service-detail__delivery li span{color:var(--brand-blue);font-weight:900}.capability-pills{display:flex;flex-wrap:wrap;gap:8px}.capability-pills span{padding:7px 11px;border-radius:6px;background:var(--bg-blue-soft);color:var(--brand-blue);font-size:12px}.stage-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:16px;margin-top:45px}.stage-grid article{padding:32px;border-top:4px solid var(--brand-yellow);background:var(--bg-blue-soft)}.stage-grid span{color:var(--brand-blue);font-size:12px}.stage-grid h3{margin:18px 0 9px;font-size:32px}.stage-grid p{margin:0;color:var(--text-secondary)}
.service-hero{padding:86px 0;background:#fff}.service-hero__inner{display:grid;grid-template-columns:1fr .85fr;gap:75px;align-items:center}.service-hero__tag{display:flex;align-items:center;gap:12px;margin-bottom:22px;color:var(--brand-blue);font-size:11px;font-weight:800;letter-spacing:.12em}.service-hero__tag span{display:grid;place-items:center;width:38px;height:38px;border-radius:50%;color:var(--text-primary);background:var(--brand-yellow)}.service-hero h1{font-size:clamp(44px,5vw,68px);letter-spacing:-.05em}.service-hero h1 em{display:block;margin-top:16px;color:var(--text-secondary);font-size:18px;font-style:normal;font-weight:450;letter-spacing:0;line-height:1.7}.plan-sheet{padding:26px;border:1px solid var(--border);border-radius:16px;background:var(--bg-blue-soft);box-shadow:var(--shadow-card)}.plan-sheet>div:first-child{display:flex;align-items:end;justify-content:space-between;padding-bottom:18px;border-bottom:2px solid var(--brand-blue-dark)}.plan-sheet>div:first-child small{color:var(--brand-blue);font-size:9px;letter-spacing:.12em}.plan-sheet article{display:grid;grid-template-columns:36px 1fr auto;gap:12px;align-items:center;padding:14px 0;border-bottom:1px solid var(--border)}.plan-sheet article>span{color:var(--text-muted);font-size:11px}.plan-sheet article small{color:var(--brand-blue)}.plan-sheet article p{margin:2px 0 0}.plan-sheet article i{color:var(--brand-blue);font-style:normal}.plan-sheet>p{margin:15px 0 0;color:var(--text-muted);font-size:10px}.service-cap-layout{display:grid;grid-template-columns:.8fr 1.2fr;gap:70px}.service-cap-layout>div:first-child>h2{font-size:43px}.service-cap-layout>div:first-child>p{color:var(--text-secondary)}.service-cap-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px}.service-cap-grid article{padding:25px;border:1px solid var(--border);border-radius:12px;background:#fff}.service-cap-grid span{color:var(--brand-blue);font-size:11px}.service-cap-grid h3{margin:24px 0 9px}.service-cap-grid p{margin:0;color:var(--text-secondary)}.service-feature-layout{display:grid;grid-template-columns:.65fr 1.35fr;gap:80px;align-items:center}.service-symbol{display:grid;place-items:center;aspect-ratio:1;border:2px solid var(--brand-blue);border-radius:50%;color:var(--brand-blue);background:var(--bg-blue-soft)}.service-symbol strong{font-size:90px}.service-symbol small,.service-symbol span{letter-spacing:.18em}.large-check-list{margin:0;padding:0;list-style:none}.large-check-list li{display:grid;grid-template-columns:50px 1fr;gap:20px;padding:22px 0;border-bottom:1px solid var(--divider)}.large-check-list span{color:var(--brand-blue);font-size:12px}.large-check-list p{margin:0;font-size:18px}.process-section,.delivery-section,.principle-section{color:#fff;background:var(--brand-blue-dark)}.process-grid,.method-flow{display:grid;grid-template-columns:repeat(4,1fr);margin-top:48px}.process-grid article{padding:25px;border-right:1px solid rgba(255,255,255,.18)}.process-grid span{color:var(--brand-yellow);font-size:12px}.process-grid h3{margin:45px 0 12px;font-size:23px}.process-grid i{color:var(--brand-yellow);font-style:normal}.related-services{background:var(--bg-blue-soft)}.related-services .container{display:grid;grid-template-columns:repeat(3,1fr)}.related-services a{display:grid;grid-template-columns:40px 1fr auto;padding:25px;border-right:1px solid var(--border)}.related-services span,.related-services i{color:var(--brand-blue);font-style:normal}
.about-intro-layout{display:grid;grid-template-columns:.8fr 1.2fr;gap:90px}.story-column p{position:relative;padding:0 0 26px 45px;border-bottom:1px solid var(--divider);color:var(--text-secondary);font-size:17px}.story-column p span{position:absolute;left:0;color:var(--brand-blue);font-size:11px}.advantage-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:14px;margin-top:45px}.advantage-grid article{padding:28px;border:1px solid var(--border);border-radius:14px;background:#fff}.advantage-grid article>span{color:var(--brand-blue);font-size:11px}.advantage-grid h3{margin:30px 0 10px;font-size:21px}.advantage-grid p{margin:0;color:var(--text-secondary)}.principle-layout{display:grid;grid-template-columns:.8fr 1.2fr;gap:90px}.principle-layout h2{font-size:46px}.principle-layout>div:first-child>p{color:#c7dce9}.principle-layout article{display:grid;grid-template-columns:45px 1fr;gap:16px;padding:19px 0;border-bottom:1px solid rgba(255,255,255,.16)}.principle-layout article>span{color:var(--brand-yellow);font-size:11px}.principle-layout article h3{margin:0 0 6px}.principle-layout article p{margin:0;color:#c7dce9}.vision-section{background:var(--bg-yellow-soft)}.vision-card{padding:58px;border:1px solid #eadb9e;border-radius:18px;background:#fff}.vision-card>span{color:var(--brand-blue);font-size:11px;letter-spacing:.16em}.vision-card blockquote{max-width:950px;margin:25px 0;font-size:clamp(28px,4vw,48px);font-weight:800;line-height:1.35}.vision-card>div{display:flex;gap:14px;align-items:center}.vision-card i{width:35px;height:3px;background:var(--brand-yellow)}.vision-card p{margin:0;color:var(--text-secondary)}.method-flow article{padding:25px;border-right:1px solid var(--border)}.method-flow article>div{display:flex;justify-content:space-between}.method-flow span,.method-flow i{color:var(--brand-blue);font-style:normal}.method-flow h2{margin:45px 0 12px;font-size:26px}.method-flow p{color:var(--text-secondary)}.delivery-layout{display:grid;grid-template-columns:.7fr 1.3fr;gap:75px}.delivery-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px}.delivery-grid article{padding:25px;border:1px solid rgba(255,255,255,.18);border-radius:12px}.delivery-grid span{color:var(--brand-yellow);font-size:11px}.delivery-grid h3{margin:30px 0 8px}.delivery-grid p{margin:0;color:#c7dce9}.principle-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:16px;margin-top:40px}.principle-grid article{padding:30px;border:1px solid var(--border);border-radius:14px;background:#fff}.principle-grid span{color:var(--brand-blue);font-size:11px}.principle-grid h3{margin:30px 0 10px}.principle-grid p{margin:0;color:var(--text-secondary)}.faq-layout aside{position:sticky;top:120px;align-self:start}.faq-layout aside>span{color:var(--brand-blue);font-size:11px;letter-spacing:.15em}.faq-layout aside h2{font-size:38px}.faq-layout aside p{color:var(--text-secondary)}
.contact-hero{padding:95px 0;color:#fff;background:var(--brand-blue-dark)}.contact-hero__grid{display:grid;grid-template-columns:1fr auto;gap:60px;align-items:center}.contact-hero__grid>div:first-child{max-width:760px}.contact-hero h1{font-size:clamp(46px,6vw,72px);letter-spacing:-.055em}.contact-hero p{color:#c7dce9;font-size:18px}.contact-hours{display:grid;place-items:center;width:190px;aspect-ratio:1;border:1px solid rgba(255,255,255,.25);border-radius:50%}.contact-hours span{color:var(--brand-yellow);font-size:48px;font-weight:900}.contact-hours strong{margin-top:-35px}.contact-hours p{margin:-35px 0 0;font-size:13px}.contact-grid{display:grid;grid-template-columns:1fr 1fr;gap:16px}.contact-grid article{min-height:250px;padding:30px;border:1px solid var(--border);border-radius:14px;background:#fff}.contact-grid article>span{color:var(--brand-blue);font-size:11px}.contact-grid h2{margin:30px 0 15px}.contact-big-link{display:block;color:var(--brand-blue-dark);font-size:30px;font-weight:850}.contact-big-link--small{font-size:20px}.contact-grid article>p{margin-top:12px;color:var(--text-muted)}.visit-grid{display:grid;grid-template-columns:.8fr 1.2fr;gap:90px}.visit-grid h2{font-size:46px}.visit-grid>div>p{color:var(--text-secondary)}.visit-grid ol{margin:0;padding:0;list-style:none}.visit-grid li{display:grid;grid-template-columns:50px 1fr;gap:20px;padding:18px 0;border-bottom:1px solid var(--divider)}.visit-grid li>span{color:var(--brand-blue);font-size:11px}.visit-grid li p{margin:5px 0 0;color:var(--text-secondary)}.contact-bottom{padding:90px 0;color:#fff;background:var(--brand-blue-dark);text-align:center}.contact-bottom>div>p{color:#b9d5e5;font-size:11px;letter-spacing:.18em}.contact-bottom h2{font-size:52px}.article-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:16px}.article-card{border:1px solid var(--border);border-radius:14px;background:#fff}.article-card>a{display:flex;min-height:340px;padding:26px;flex-direction:column}.article-card__meta{display:flex;justify-content:space-between;color:var(--text-muted);font-size:11px}.article-card__meta span{color:var(--brand-blue)}.article-card__index{margin:34px 0 15px;color:var(--brand-yellow);font-size:28px;font-weight:900}.article-card h2{font-size:21px}.article-card p{color:var(--text-secondary)}.article-card>a>strong{margin-top:auto;color:var(--brand-blue);font-size:12px}
.article-layout{display:grid;grid-template-columns:250px 1fr;gap:40px}.article-sidebar{align-self:start;padding:24px;border:1px solid var(--border);border-radius:12px;background:#fff}.article-sidebar h2{font-size:18px}.article-sidebar a{display:flex;justify-content:space-between;padding:8px 0;color:var(--text-secondary);font-size:13px}.article-sidebar a:hover,.article-sidebar a.is-active{color:var(--brand-blue)}.article-list-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:16px}.pagination{display:flex;justify-content:center;gap:8px;margin-top:40px}.pagination a,.pagination span{display:grid;place-items:center;width:38px;height:38px;border:1px solid var(--border);border-radius:6px;background:#fff}.pagination [aria-current=page]{color:#fff;background:var(--brand-blue)}.article-detail-head{padding:90px 0;color:#fff;background:var(--brand-blue-dark)}.article-detail-head__inner{max-width:960px}.article-detail-category{display:inline-block;margin-bottom:20px;padding:6px 10px;border-radius:5px;color:var(--text-primary);background:var(--brand-yellow);font-size:11px}.article-detail-head h1{font-size:clamp(40px,5vw,64px)}.article-detail-head__inner>p{color:#c7dce9;font-size:18px}.article-detail-meta{display:flex;gap:20px;color:#a9c6d7;font-size:12px}.article-detail-layout{display:grid;grid-template-columns:220px minmax(0,760px);justify-content:center;gap:70px;padding:70px 0}.article-detail-layout aside{color:var(--text-muted);font-size:13px}.article-detail-layout aside a{color:var(--brand-blue);font-weight:750}.article-prose{font-size:17px}.article-prose h2{margin-top:45px;font-size:30px}.article-prose h3{margin-top:30px}.article-prose p,.article-prose li{color:var(--text-secondary)}.article-prose img{border-radius:12px}.article-prose a{color:var(--brand-blue);text-decoration:underline}.article-prose blockquote{margin:25px 0;padding:20px;border-left:4px solid var(--brand-yellow);background:var(--bg-yellow-soft)}
.cta-band{padding:78px 0;color:#fff;background:var(--brand-blue)}.cta-band__inner{display:flex;align-items:center;justify-content:space-between;gap:60px}.cta-band h2{margin-bottom:14px;font-size:clamp(34px,4vw,52px)}.cta-band p{max-width:720px;margin:0;color:#d8eaf5}.cta-band__actions{display:flex;align-items:center;gap:22px;flex-shrink:0}.site-footer{padding:70px 0 0;color:#c7dce9;background:#103c5b}.footer-grid{display:grid;grid-template-columns:1.4fr .7fr .8fr 1fr;gap:50px}.footer-logo{display:block;width:150px;height:74px;overflow:hidden;border-radius:4px}.footer-logo img{width:100%;height:100%;object-fit:cover}.footer-brand>p{max-width:330px;margin-top:18px}.footer-tags{display:flex;gap:7px}.footer-tags span{padding:5px 9px;border:1px solid rgba(255,255,255,.18);border-radius:5px;font-size:11px}.footer-grid h2{margin:0 0 18px;color:#fff;font-size:15px}.footer-grid>div:not(:first-child)>a{display:block;margin:9px 0;color:#b8d0df;font-size:13px}.footer-grid a:hover{color:var(--brand-yellow)}.footer-phone{color:var(--brand-yellow)!important;font-size:23px!important;font-weight:850}.footer-contact p{font-size:12px}.footer-arrow{margin-top:22px!important;color:#fff!important}.footer-bottom{display:flex;justify-content:space-between;gap:30px;margin-top:55px;padding:22px 0;border-top:1px solid rgba(255,255,255,.13);font-size:11px}.footer-bottom p{margin:0}.contact-dialog{width:min(920px,calc(100% - 32px));padding:0;border:0;border-radius:18px;background:transparent}.contact-dialog::backdrop{background:rgba(9,35,52,.68)}.contact-dialog__panel{position:relative;padding:38px;border:1px solid var(--border);border-radius:18px;background:#fff}.contact-dialog__close{position:absolute;top:14px;right:15px;width:38px;height:38px;border:0;border-radius:50%;background:var(--bg-blue-soft);font-size:24px;cursor:pointer}.contact-dialog__heading{max-width:640px}.contact-dialog__heading h2{margin-bottom:10px;font-size:36px}.contact-dialog__heading p{color:var(--text-secondary)}.contact-dialog__grid{display:grid;grid-template-columns:1fr 1fr;gap:12px;margin-top:28px}.contact-dialog__grid article{padding:22px;border:1px solid var(--border);border-radius:12px;background:var(--bg-blue-soft)}.contact-dialog__grid article>span{color:var(--brand-blue);font-size:10px}.contact-dialog__grid h3{margin:18px 0 8px}.contact-dialog__grid p{margin:6px 0 0;color:var(--text-muted);font-size:12px}.contact-dialog__primary{color:var(--brand-blue-dark);font-size:21px;font-weight:850}.contact-dialog__email,.contact-dialog__website{font-size:15px}.not-found{display:grid;place-items:center;min-height:70vh;padding:80px 0;background:var(--bg-blue-soft);text-align:center}.not-found>div>span{display:block;color:var(--brand-yellow);font-size:100px;font-weight:900}.not-found .eyebrow{justify-content:center}
@media(max-width:1080px){.desktop-nav,.header-cta{display:none}.mobile-nav{display:block}.mobile-nav[open]>nav{position:absolute;top:76px;right:0;left:0;max-height:calc(100vh - 76px);padding:20px 24px 28px;overflow:auto;border-bottom:1px solid var(--border);background:#fff;box-shadow:var(--shadow-hover)}.mobile-nav__group{padding:12px 0;border-bottom:1px solid var(--divider)}.mobile-nav__primary{font-weight:800}.mobile-subnav{display:flex;flex-wrap:wrap;gap:8px;margin-top:8px}.mobile-subnav a{padding:5px 8px;border-radius:5px;background:var(--bg-blue-soft);font-size:12px}.mobile-nav nav>.button{width:100%;margin-top:18px}.brand{margin-right:auto}.home-hero__grid{gap:25px}.need-grid{grid-template-columns:1fr 1fr}.teacher-layout,.feedback-layout{gap:50px}.footer-grid{grid-template-columns:1.2fr 1fr 1fr}.footer-contact{grid-column:2/4}}
@media(max-width:760px){.container{width:min(calc(100% - 32px),var(--container))}.section-pad{padding:72px 0}.section-intro-row{display:block;margin-bottom:34px}.section-intro-row>.text-link{display:inline-block;margin-top:18px}.section-heading h2{font-size:36px}.home-hero{padding-top:38px}.home-hero__grid,.learning-map,.teacher-layout,.feedback-layout,.faq-preview,.faq-layout,.service-hero__inner,.service-cap-layout,.service-feature-layout,.about-intro-layout,.principle-layout,.delivery-layout,.contact-hero__grid,.visit-grid{grid-template-columns:1fr;gap:40px}.home-hero h1{font-size:45px}.home-hero__copy>p{font-size:16px}.home-hero__visual{margin-top:10px}.hero-note--top{top:10px;left:-8px}.hero-note--bottom{right:-5px;bottom:12px}.stage-ruler{gap:10px;font-size:11px}.stat-grid{grid-template-columns:1fr 1fr;row-gap:28px}.stat-grid>div:nth-child(2){border:0}.stat-grid strong{font-size:34px}.need-grid,.service-cap-grid,.stage-grid,.advantage-grid,.delivery-grid,.principle-grid,.article-grid,.article-list-grid,.contact-grid,.contact-dialog__grid{grid-template-columns:1fr}.need-card{min-height:260px}.need-card h3{margin-top:35px}.learning-map__copy,.faq-preview>div:first-child,.faq-layout aside{position:static}.teacher-layout h2{font-size:40px}.feedback-layout .feedback-board{order:2}.faq-list details>div{padding-left:0}.page-hero{min-height:auto;padding:68px 0}.page-hero h1{font-size:43px}.anchor-nav{top:76px;overflow:auto}.anchor-nav .container{width:max-content;grid-template-columns:repeat(4,150px)}.service-detail__content{grid-template-columns:1fr;gap:25px;padding:28px}.service-hero{padding:62px 0}.service-feature-layout{grid-template-columns:1fr}.service-symbol{max-width:260px;margin:auto}.process-grid,.method-flow{grid-template-columns:1fr 1fr}.process-grid article,.method-flow article{border-bottom:1px solid rgba(255,255,255,.18)}.related-services .container{display:block}.related-services a{border-bottom:1px solid var(--border)}.principle-layout h2,.visit-grid h2{font-size:38px}.contact-hours{display:none}.contact-grid article{min-height:auto}.contact-big-link{font-size:25px}.article-layout,.article-detail-layout{grid-template-columns:1fr}.article-sidebar{display:none}.article-detail-layout{padding:48px 16px}.cta-band__inner,.cta-band__actions{align-items:flex-start;flex-direction:column}.footer-grid{grid-template-columns:1fr 1fr}.footer-brand{grid-column:1/3}.footer-contact{grid-column:1/3}.footer-bottom{flex-direction:column}.contact-dialog__panel{padding:26px 20px}.contact-dialog__heading h2{font-size:29px}}
@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}*,*::before,*::after{animation-duration:.01ms!important;transition-duration:.01ms!important}[data-reveal]{opacity:1;transform:none}}
@media print{.site-header,.site-footer,.cta-band,.mobile-nav{display:none}[data-reveal]{opacity:1;transform:none}}
.image-frame{aspect-ratio:1.22}.image-frame img{height:100%;aspect-ratio:auto}.article-tabs{display:flex;flex-wrap:wrap;gap:8px;margin-bottom:32px}.article-tab{display:flex;align-items:center;gap:8px;padding:8px 13px;border:1px solid var(--border);border-radius:7px;background:#fff;color:var(--text-secondary);font-size:13px}.article-tab span{color:var(--text-muted);font-size:11px}.article-tab:hover,.article-tab.active{border-color:var(--brand-blue);color:var(--brand-blue)}.article-tab.active{background:var(--brand-yellow-soft)}.article-empty{padding:60px;border:1px dashed var(--border);background:#fff;color:var(--text-muted);text-align:center}.article-pagination{display:flex;justify-content:center;gap:7px;margin-top:36px}.article-pagination>a,.article-pagination>span{display:grid;place-items:center;width:38px;height:38px;border:1px solid var(--border);border-radius:6px;background:#fff}.article-pagination .active{border-color:var(--brand-blue);color:#fff;background:var(--brand-blue)}
src/types/turndown-plugin-gfm.d.ts 0 → 100644
View file @ ad00ed3a
declare module "turndown-plugin-gfm" {
import type TurndownService from "turndown";
export function gfm(service: TurndownService): void;
}
tests/auth.test.ts 0 → 100644
View file @ ad00ed3a
import assert from "node:assert/strict";
import fs from "node:fs/promises";
import os from "node:os";
import path from "node:path";
import test, { after } from "node:test";
const dataDirectory = await fs.mkdtemp(path.join(os.tmpdir(), "qiyouxue-auth-"));
process.env.CMS_DATA_DIR = dataDirectory;
process.env.CMS_PASSWORD = "environment-master-password";
process.env.CMS_SECRET = "auth-test-session-secret";
process.env.CMS_API_KEY = "auth-test-api-key";
const { handleCmsApi } = await import("../src/lib/cms-api");
let requestNumber = 0;
after(async () => {
await fs.rm(dataDirectory, { recursive: true, force: true });
});
function cookieFrom(response: Response, name: string): string {
const header = response.headers.get("set-cookie") || "";
const match = header.match(new RegExp(`(?:^|,\\s*)${name}=([^;]*)`));
assert.ok(match, `missing ${name} cookie in ${header}`);
return `${name}=${match[1]}`;
}
async function login(password: string): Promise<{ response: Response; cookie?: string }> {
requestNumber += 1;
const captchaResponse = await handleCmsApi(
new Request("http://localhost/api/cms/captcha"),
"captcha",
`captcha-${requestNumber}`,
);
const code = [...(await captchaResponse.text()).matchAll(/<text\b[^>]*>([^<])<\/text>/g)]
.map((match) => match[1])
.join("");
assert.equal(code.length, 4);
const response = await handleCmsApi(new Request("http://localhost/api/cms/session", {
method: "POST",
headers: {
"Content-Type": "application/json",
Cookie: cookieFrom(captchaResponse, "cms_captcha"),
},
body: JSON.stringify({ password, captcha: code }),
}), "session", `login-${requestNumber}`);
return {
response,
cookie: response.ok ? cookieFrom(response, "cms_session") : undefined,
};
}
async function sessionStatus(cookie: string): Promise<boolean> {
const response = await handleCmsApi(new Request("http://localhost/api/cms/session", {
headers: { Cookie: cookie },
}), "session");
return Boolean((await response.json()).authed);
}
async function changePassword(cookie: string, currentPassword: string, newPassword: string): Promise<Response> {
return handleCmsApi(new Request("http://localhost/api/cms/account/password", {
method: "PUT",
headers: { "Content-Type": "application/json", Cookie: cookie },
body: JSON.stringify({ currentPassword, newPassword }),
}), "account/password");
}
test("users can change the persisted password while the .env password remains valid", async () => {
const initialLogin = await login("environment-master-password");
assert.equal(initialLogin.response.status, 200);
assert.ok(initialLogin.cookie);
const tooShort = await changePassword(initialLogin.cookie, "environment-master-password", "abcd");
assert.equal(tooShort.status, 400);
assert.match((await tooShort.json()).error, /至少需要 5 个字符/);
assert.equal(await sessionStatus(initialLogin.cookie), true);
const firstPassword = "first-user-password";
const changed = await changePassword(initialLogin.cookie, "environment-master-password", firstPassword);
assert.equal(changed.status, 200);
assert.match(changed.headers.get("set-cookie") || "", /cms_session=;/);
assert.equal((await changed.json()).requiresLogin, true);
assert.equal(await sessionStatus(initialLogin.cookie), false);
const stored = await fs.readFile(path.join(dataDirectory, "auth", "password.json"), "utf8");
assert.doesNotMatch(stored, new RegExp(firstPassword));
const userLogin = await login(firstPassword);
assert.equal(userLogin.response.status, 200);
assert.ok(userLogin.cookie);
assert.equal((await login("environment-master-password")).response.status, 200);
const secondPassword = "abcde";
const changedAgain = await changePassword(userLogin.cookie, firstPassword, secondPassword);
assert.equal(changedAgain.status, 200);
assert.equal(await sessionStatus(userLogin.cookie), false);
assert.equal((await login(firstPassword)).response.status, 401);
assert.equal((await login(secondPassword)).response.status, 200);
assert.equal((await login("environment-master-password")).response.status, 200);
});
test("an API key alone cannot change the browser login password", async () => {
const response = await handleCmsApi(new Request("http://localhost/api/cms/account/password", {
method: "PUT",
headers: {
Authorization: "Bearer auth-test-api-key",
"Content-Type": "application/json",
},
body: JSON.stringify({
currentPassword: "environment-master-password",
newPassword: "api-key-must-not-change-this",
}),
}), "account/password");
assert.equal(response.status, 401);
});
tests/fixtures/import-test.md 0 → 100644
View file @ ad00ed3a
# 开始学情沟通前，建议家长准备这四类信息
一次有效的学情沟通，需要把年级、教材进度、近期试卷和阶段目标放在一起观察。资料不必复杂，但应尽量准确。
![启优学在线一对一课堂示意图]({{TEST_IMAGE_URL}})
## 一、品牌与业务简介
用简洁语言说明企业是谁、服务谁、解决什么问题，以及当前最重要的产品与市场。
## 二、核心品牌与品类关键词
整理用户可能主动搜索的品牌词、品类词、场景词和问题词，作为诊断范围的初始输入。
## 三、重点竞品与替代方案
列出用户在比较阶段可能同时考虑的品牌或方案，便于观察AI回答中的推荐结构。
## 四、现有官方内容
准备官网、公众号、产品资料和权威报道等内容入口，确认品牌事实是否统一。
## 五、当前最关心的问题
说明品牌是完全没有被提及、描述不准确，还是在关键问题中被竞品压制。
启优学会结合沟通与诊断结果梳理近期任务，实际课程安排以双方确认的方案为准。
测试标记：QIYOUXUE-PRODUCTION-IMPORT-20260812-MARKDOWN
tests/imports.test.ts 0 → 100644
View file @ ad00ed3a
import assert from "node:assert/strict";
import fs from "node:fs/promises";
import os from "node:os";
import path from "node:path";
import test, { after } from "node:test";
import { Document, HeadingLevel, ImageRun, Packer, Paragraph, TextRun } from "docx";
const TEST_IMAGE = path.join(process.cwd(), "pic", "主页大图素材-1.png");
const UNIQUE_MARKER = "QIYOUXUE-IMPORT-TEST-20260812";
const dataDirectory = await fs.mkdtemp(path.join(os.tmpdir(), "qiyouxue-import-"));
process.env.CMS_DATA_DIR = dataDirectory;
process.env.CMS_BUILD_LOCK = path.join(dataDirectory, "site-build.lock");
process.env.CMS_API_KEY = "word-import-test-key";
const [{ handleCmsApi }, { GET: getUpload }] = await Promise.all([
import("../src/lib/cms-api"),
import("../src/pages/uploads/[file]"),
]);
after(async () => {
await fs.rm(dataDirectory, { recursive: true, force: true });
});
function cmsRequest(route: string, method = "GET", body?: Record<string, unknown>, key = "word-import-test-key"): Request {
return new Request(`http://localhost/api/cms/${route}`, {
method,
headers: {
Authorization: `Bearer ${key}`,
...(body ? { "Content-Type": "application/json" } : {}),
},
body: body ? JSON.stringify(body) : undefined,
});
}
async function wordDocument(): Promise<Buffer> {
const png = await fs.readFile(TEST_IMAGE);
const document = new Document({
sections: [{
children: [
new Paragraph({ text: "Qiyouxue Word Import Test", heading: HeadingLevel.HEADING_1 }),
new Paragraph({ children: [new TextRun(`Imported Word body marker: ${UNIQUE_MARKER}`)] }),
new Paragraph({ children: [new ImageRun({ data: png, transformation: { width: 160, height: 105 }, type: "png" })] }),
],
}],
});
return Packer.toBuffer(document);
}
test("imports a Markdown file payload as a draft", async () => {
const markdown = `# 启优学 Markdown 导入测试\n\n这是 Markdown 上传测试：${UNIQUE_MARKER}`;
const heading = markdown.match(/^#\s+(.+)$/m);
assert.ok(heading?.index !== undefined);
const body = `${markdown.slice(0, heading.index)}${markdown.slice(heading.index + heading[0].length)}`.trim();
const response = await handleCmsApi(cmsRequest("articles", "POST", {
title: heading[1],
category: "学情指南",
body,
}), "articles");
assert.equal(response.status, 201);
const imported = await response.json();
assert.equal(imported.publishStatus, "new-draft");
const articleResponse = await handleCmsApi(cmsRequest(`articles/${imported.slug}`), `articles/${imported.slug}`);
const article = await articleResponse.json();
assert.equal(article.title, "启优学 Markdown 导入测试");
assert.match(article.body, new RegExp(UNIQUE_MARKER));
assert.doesNotMatch(article.body, /^#\s+/);
});
test("imports a docx with the requested embedded PNG as a Markdown draft", async () => {
const buffer = await wordDocument();
const response = await handleCmsApi(cmsRequest("imports/word", "POST", {
fileName: "启优学导入测试.docx",
category: "学习方法",
dataUrl: `data:application/vnd.openxmlformats-officedocument.wordprocessingml.document;base64,${buffer.toString("base64")}`,
}), "imports/word");
assert.equal(response.status, 201);
const imported = await response.json();
assert.equal(imported.title, "Qiyouxue Word Import Test");
assert.equal(imported.publishStatus, "new-draft");
assert.equal(imported.imageCount, 1);
const articleResponse = await handleCmsApi(cmsRequest(`articles/${imported.slug}`), `articles/${imported.slug}`);
assert.equal(articleResponse.status, 200);
const article = await articleResponse.json();
assert.equal(article.category, "学习方法");
assert.match(article.body, new RegExp(UNIQUE_MARKER));
assert.doesNotMatch(article.body, /^#\s+Qiyouxue Word Import Test/m);
const imageUrl = article.body.match(/!\[[^\]]*\]\((\/uploads\/[^)]+)\)/)?.[1];
assert.ok(imageUrl);
const filename = imageUrl.replace(/^\/uploads\//, "");
const imageResponse = await getUpload({ params: { file: filename } } as never);
assert.equal(imageResponse.status, 200);
assert.equal(imageResponse.headers.get("content-type"), "image/png");
assert.deepEqual(Buffer.from(await imageResponse.arrayBuffer()), await fs.readFile(TEST_IMAGE));
});
test("requires valid authentication for Word import", async () => {
const response = await handleCmsApi(cmsRequest("imports/word", "POST", {}, "wrong-key"), "imports/word");
assert.equal(response.status, 401);
});
test("rejects legacy .doc files", async () => {
const response = await handleCmsApi(cmsRequest("imports/word", "POST", {
fileName: "旧文章.doc",
dataUrl: "data:application/octet-stream;base64,AA==",
}), "imports/word");
assert.equal(response.status, 400);
assert.match((await response.json()).error, /不支持旧版 \.doc/);
});
tsconfig.json 0 → 100644
View file @ ad00ed3a
{
"extends": "astro/tsconfigs/strict"
}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment