环境准备与命令
环境准备与命令
Section titled “环境准备与命令”本文档说明开发环境配置标准以及开发服务器的生命周期管理规范。
- Node.js 运行环境:
^18.18.0或>=20.0.0 - 包管理器:
npm - 支持操作系统: Windows / macOS / Linux
安装项目依赖
Section titled “安装项目依赖”在项目根目录下执行:
npm install开发服务器生命周期管理
Section titled “开发服务器生命周期管理”按照项目开发规范,本地开发服务器应使用后台管理模式,并通过锁文件控制进程。
1. 启动开发服务
Section titled “1. 启动开发服务”推荐使用后台模式启动:
astro dev --background若 astro 未在全局环境变量 PATH 中,可执行以下命令:
node node_modules/astro/bin/astro.mjs dev --background2. 查询运行状态
Section titled “2. 查询运行状态”查询进程 PID 与当前监听端口:
astro dev status3. 查看实时日志
Section titled “3. 查看实时日志”实时输出服务器运行日志:
astro dev logs4. 停止开发服务
Section titled “4. 停止开发服务”优雅关闭进程并释放端口:
astro dev stop校验与自动化工具命令
Section titled “校验与自动化工具命令”在提交变更或发布前,可调用以下脚本校验代码与产物:
# 扫描校验指定目录下的 MDX 语法与 KaTeX 编译是否符合规范node scripts/scan-mdx.mjs src/content/docs/collections/<collection>/<book>
# 执行全书 EPUB 打包流程node scripts/build-epub.mjs模块索引
书籍模块索引
正在扫描全书模块结构...
解析章节卡片并构建索引
本书智能问答
针对本书提问
默认基于本书知识片段生成答案并可跳转原文溯源;在设置中选择「深度讨论」则 AI 不默认检索,基于理解深入讨论、需要原文时按需查书。
Enter 发送 · Shift+Enter 换行
设置
「检索本书」总是把命中的 topK 片段注入答案;「深度讨论」不注入片段,AI 基于理解与上文深入讲解,需要原文时才按需调用检索工具。
模型、API Key 与端点仅保存在本机浏览器 localStorage,与全站偏好设置和习题推导统一实时同步。
历史会话
暂无历史
新高考数学你真的掌握了吗(第二版) · 章节内联关系图谱
0 章节0 跨章引用0 关联边
正在分析并生成全书章节关系拓扑...
核心知识枢纽章节
被全书其他章节引用频次最高的基石章节:
图谱交互提示
- 视角放大/缩小:使用左下角工具栏 +/- 或鼠标滚轮;
- 大书防混淆:顶部选择“按篇章/大章聚合”或“聚焦当前章”;
- 视图平移与拖拽:拖动画布或节点;双击节点直达原文。
界面显示偏好
关闭后按钮隐藏,您随时可按 Alt+G 或在此开启。