@melt-js/docs-bag

vue-bag-admin 的 VitePress 文档站（由上游 apps/docs 迁入），内容包含快速上手、宿主初始化、请求/组件、插件开发、官方插件和发包流程。

• 包名：@melt-js/docs-bag（可发布，unpkg 入口 dist/index.html）
• 端口：40010（dev）/ 40020（preview）
• 版本号：从 ../libs-bag-entry/package.json 读取，导航栏显示主包版本

命令

# 仓库根目录
pnpm bag:docs:dev
pnpm bag:docs:build
pnpm bag:docs:preview

# 或在本目录
pnpm dev
pnpm build
pnpm preview

构建产物在 docs-bag/dist/（已在根 .gitignore 忽略），缓存目录 .vitepress/cache/ 同样忽略。

发布到 unpkg

pnpm --filter @melt-js/docs-bag run publish:stage

build:unpkg 会用 /@melt-js/docs-bag@<version>/dist/ 作为 base 构建，保证静态资源和站内链接都落在 unpkg 的 dist 目录下。发布后地址：

https://unpkg.com/@melt-js/docs-bag@<version>/dist/index.html

部署

普通构建默认 base 为 /，部署到子路径时设置环境变量：

VITEPRESS_BASE=/docs/ pnpm bag:docs:build

文档里的包名、目录名和命令已统一改成 @melt-js/* 与仓库根目录布局；上游仓库链接（GitHub / 在线预览 / npm 包页）仍指向原项目，便于对照。