v0.10.0 - 生产服务器、静态资源与 MDX
v0.10.0 - 生产服务器、静态资源与 MDX
生产服务器、静态资源与 MDX
v0.10.0 引入了专用的生产环境 HTTP 服务器 (docmd serve)、零配置公共静态根资源管道 (public/)、由 @docmd/lite-mdx 驱动的原生 MDX 组件支持、启动前环境体检诊断 (docmd doctor),以及跨支持库的生态系统标准化。
Added
- 专用生产服务器 (
@docmd/core):引入docmd serve命令,以零文件监听开销运行生产级文档站点。内置 Gzip 和 Deflate 压缩、标准安全响应头 (CSP、HSTS、防嵌套保护)、位于/healthz的容器存活与就绪探针,以及可配置的主机绑定。Docker 镜像现默认使用docmd serve --host 0.0.0.0。由 @svallory 在 #273 与 #279 中贡献。 - HTTP 协议可选 MCP 服务 (
@docmd/core):在docmd serve下通过POST /mcp提供模型上下文协议 (Model Context Protocol) 能力,基于独立于传输协议的 JSON-RPC 处理器,通过serve.mcp: true与 Token/请求头身份验证进行访问保护。由 @svallory 在 #278 中贡献。 - 生产环境插件动作宿主 (
@docmd/core,@docmd/api):将插件动作扩展至docmd serve,具备严格的 Origin 白名单和调用者身份准入,防止生产环境下未经授权的上下文写入。由 @svallory 在 #272 与 #277 中贡献。 - 公共静态根资源管道 (
@docmd/core):自动识别顶层public/目录(或通过docmd.config.json中的static自定义路径),将文件原样复制到构建根目录,完整保留robots.txt、favicon.ico、CNAME与.well-known/funding-manifest-urls等层级。 - MDX 组件渲染支持 (
@docmd/plugin-mdx,@docmd/lite-mdx):通过高性能@docmd/lite-mdx编译器将一流的 MDX 支持内嵌至核心中,无需额外配置即可在标准 Markdown 中混合编写交互式 JSX 组件。 - 启动前 Doctor 环境体检 (
@docmd/core,@docmd/tui):新增docmd doctor命令,通过结构化、彩色终端报告全面校验系统环境、Node.js 版本、引擎依赖、端口占用、模板与插件完整性。 - 动态无头运行标识 (
@docmd/core):为dev、serve及测试运行器新增--no-open命令行参数和DOCMD_NO_OPEN=true环境变量支持,避免在 CI 与容器等无头环境中触发浏览器弹窗。 - 动态版本回退同步 (
@docmd/parser,@docmd/ui):在解析器注册表与客户端运行时中实现docmd.version和docmd.buildYear的自动回退同步。 - 可选 Iconify 图标插件 (
@docmd/plugin-iconify):通过标准icon:iconify:<名称>语法按需解析并渲染来自 100+ 图标集的 100,000+ 开源图标。
Improved
- 网络接口绑定 (
@docmd/core):为docmd dev、docmd serve和工作区命令新增--host <地址>参数,本地开发默认绑定更安全的127.0.0.1。由 @svallory 在 #269 中贡献。 - Playground Web Worker 沙箱隔离 (
@docmd/plugin-playground):将代码运行转移到后台 Web Worker,防止耗时或死循环脚本冻结浏览器 UI 主线程。 - 构建产物工作区整洁度:确保
pnpm -r run build隔离临时文件并保持 Git 工作区整洁。由 @svallory 在 #275 中贡献。 - 测试套件独立环境隔离:为每个测试进程分配独立的临时工作根目录,彻底避免并发竞争。由 @svallory 在 #276 中贡献。
- 生态元数据与赞助标准化:统一内部插件的关键词、规范化 README 编写,并将所有代码仓库与赞助清单统一对齐至
https://docmd.io与docmd-io组织。
Fixed
- SPA 导航中 Body 内联脚本重复执行 (
@docmd/ui):防止单页应用客户端路由重复运行页面内脚本,避免 DOM 混乱与事件多次绑定。由 @MSOB7YY 在 #270 中贡献。 - Highlight.js 主题加载闪烁 (
@docmd/ui,@docmd/template-summer):首次加载页面时即时应用语法高亮样式,消除水合期间的代码闪烁。由 @MSOB7YY 在 #270 中贡献。 - 非索引文件夹相对链接解析 (
@docmd/parser):修复深层嵌套页面中指向无末尾斜杠目录的相对链接寻址异常。由 @GPT-AGI 在 #271 中贡献。 - Gitignore 祖先目录过度匹配 (
@docmd/core):将无前缀 gitignore 规则限制在其父目录内,避免祖先目录规则错误忽略项目源文件。由 @svallory 在 #274 中贡献。 - MCP 路径遍历防御加固 (
@docmd/core):严格将read_doc与list_docs限制在配置的源码目录 Markdown 文件范围内,杜绝符号链接逃逸。由 @svallory 在 #268 中贡献。 - 面包屑导航 Schema 回退 (
@docmd/plugin-seo):修复 JSON-LD 面包屑结构化数据中缺失中间层级的问题,提供自愈式层级补全。
Security & Maintenance
- Playground HTML 预览在不包含
allow-same-origin的隔离沙箱 iframe 中执行。 - 生产服务器安全响应头:
docmd serve默认强制开启 CSP、HSTS、X-Content-Type-Options 与 Frame-Options 安全标头。 - WebSocket Origin 校验:强制执行严格的来源白名单,在动作宿主执行期间屏蔽不可信消息。
- 在 PR #281 中升级
docker/login-action至 4.8.0。 - 在 PR #282 中升级工作区运行时依赖。
Links
官方文档:https://docs.docmd.io/
云平台:https://cloud.docmd.io/
开发者与写作技能:https://github.com/docmd-io/docmd-skills
New Contributors
- @svallory 在 https://github.com/docmd-io/docmd/pull/268 中完成了首次贡献
- @MSOB7YY 在 https://github.com/docmd-io/docmd/pull/270 中完成了首次贡献
- @GPT-AGI 在 https://github.com/docmd-io/docmd/pull/271 中完成了首次贡献
完整变更日志:https://github.com/docmd-io/docmd/compare/0.9.9...0.10.0