Ship TextMate highlighting, Run/Problems/debug entry, GitHub release CLI+stdlib bootstrap, and packaging metadata for the published .vsix. Co-authored-by: Cursor <cursoragent@cursor.com>
2.5 KiB
2.5 KiB
开发流程
环境
- Node.js 20+(LTS)
- VS Code 1.85+(
engines.vscode在package.json收紧) - 本机已安装 Marqdo CLI ≥ 0.1.0(
marqdo --version),用于 Run / catalog 集成
首次
git checkout vscode-extension
cd vscode-extension
npm install
推荐:用 VS Code / Cursor 打开 vscode-extension/ 文件夹(不要只开仓库根),再按 F5(「Run Extension」)。Extension Development Host 会带上上级语言仓,便于打开 public/*.mq.md 验收。
验证:Language Mode = Marqdo;命令面板搜 Marqdo: Run File / Open Debugger。
日常脚本(约定)
| npm script | 用途 |
|---|---|
npm run compile |
tsc -p . → out/ |
npm run watch |
监视编译 |
npm run lint |
日后 ESLint(先可空) |
npm run package |
vsce package 打 .vsix(发布前) |
尚未加入的脚本:落地 package.json 时按上表补齐,勿引入与 Marqdo 语言仓抢戏的重型框架。
改语法 / 高亮
- 对照语言仓
doc/design/markdown-mapping.md(以main为准)。 - 改
syntaxes/*.tmLanguage.json(或等价)。 - 用
tests/与public/下真实.mq.md肉眼验收(Extension Host 打开语言仓 worktree)。
改 CLI 集成
- 子进程调用
marqdo,cwd = 工作区根或文件目录(与marqdo run导入/lib/解析一致)。 - 解析 stderr 的
path:line:col: message写入DiagnosticCollection。 - 禁止在扩展内重新实现解释器。
提交与推送
只在 vscode-extension 分支 提交本目录:
git status # 确认在 vscode-extension
git add vscode-extension
git commit -m "…"
git push -u origin vscode-extension
不要把本目录合并进 main(main 的 .gitignore 会忽略它)。
验收清单(P0 / P1)
.mq.md打开后 Language Mode = Marqdo#/*/**/>/ 表格 / 注释行有可区分着色- 函数体内
---/***、空返回****不与普通 Markdown 粗体完全糊成一团(尽力) - F5 开发宿主可重复加载,无激活期未捕获异常
Marqdo: Run File成功时 Output 有输出;失败时 Problems 出现path:line:colMarqdo: Open Debugger拉起本地 debug 页(默认http://127.0.0.1:7430/)- 无 CLI 时启动提示 Install;确认后下载 bundle(含 stdlib)并可
Run File
设置:marqdo.cliPath、marqdo.libPath、marqdo.autoInstall.checkOnStartup、marqdo.debugOpen。