# Vue Markdown Next Project Structure

> vue-markdown-next monorepo 的项目结构与模块地图。用于定位 `packages/parser`、`packages/vue`、`app/markdown-next-preview`、`app/markdown-next-docs` 的代码入口，选择正确的测试/构建命令，判断依赖应修改哪个 `package.json`，或排查 Worker + Vite 兼容问题时。 Use when this capability is needed.

- Skill: `tomevault-io/vue-markdown-next-project-structure` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/vue-markdown-next-project-structure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/vue-markdown-next-project-structure/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/vue-markdown-next-project-structure

---


# Vue Markdown Next 项目结构技能

## 快速开始

- 先读取 `references/project-structure.md` 获取目录边界、入口文件和命令映射。
- 需要增删依赖时读取 `references/dependencies.md`，先复用现有依赖与封装。
- 路径不确定时先执行 `rg --files packages app readme skills`，确认真实路径后再改代码。
- 命中 Worker 报错（如 `/.vite/deps/`、`document is not defined`）时，优先检查：
  - `packages/parser/src/modules/parser.workerPool.ts`
  - `app/markdown-next-preview/vite.config.ts`
  - `app/markdown-next-docs/docs/v1/*/guide/bundler-config.md`

## 导航原则

- 先判断改动边界：
  - `packages/parser`：Markdown 解析、插件管线、Worker 池
  - `packages/vue`：Vue 组件渲染层、hooks、TSX 组件 API
  - `app/markdown-next-preview`：Vite 7 预览与真实浏览器回归场景
  - `app/markdown-next-docs`：VitePress 文档与 API 说明
- 先找入口再深入实现，避免在错误工程里修改同名文件。
- 依赖变更遵循“最小作用域”：
  - 库依赖放在对应 `packages/*/package.json`
  - 预览/文档依赖放在 `app/*/package.json`
  - 根目录只放 workspace 级开发工具。

## 执行步骤

1. 识别需求落在 `parser`、`vue`、`preview`、`docs` 中的哪一层。
2. 从入口文件沿调用链定位到改动点，不跨层盲改。
3. 修改后按命中范围选择命令，而不是只跑根目录脚本。
4. 涉及 Worker 或公共 API 的改动，额外执行浏览器 e2e 回归。
5. 需要时同步更新文档（中英文）与引用路径。

## 命令选择

- 仅改 `packages/parser`：
  - `pnpm --filter @markdown-next/parser lint`
  - `pnpm --filter @markdown-next/parser typecheck`
  - `pnpm --filter @markdown-next/parser test`
- 仅改 `packages/vue`：
  - `pnpm --filter @markdown-next/vue lint`
  - `pnpm --filter @markdown-next/vue typecheck`
  - `pnpm --filter @markdown-next/vue test`
- 命中 Worker 浏览器行为或 `MarkdownWorkerPoll`/`ParserWorkerPool`：
  - `pnpm --filter @markdown-next/vue test:e2e`
- 改动 `app/markdown-next-preview`：
  - `pnpm --filter markdown-next-preview dev`
  - `pnpm --filter markdown-next-preview build`
- 改动 `app/markdown-next-docs`：
  - `pnpm --filter markdown-next-docs dev`
  - `pnpm --filter markdown-next-docs build`
- 跨 `parser` + `vue` 的改动：
  - `pnpm lint`
  - `pnpm typecheck`
  - `pnpm test`
  - `pnpm build`

## 需要时加载的参考

- `references/project-structure.md`：目录边界、入口文件、跨包调用与命令地图。
- `references/dependencies.md`：依赖落点与新增依赖的决策规则。

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/UnboundedWeb) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-16 -->