From 789696aa31ef5f2b29260c1024334b7441297c2e Mon Sep 17 00:00:00 2001
From: Menghuan1918 <menghuan2003@outlook.com>
Date: Thu, 3 Sep 2026 12:07:23 +0800
Subject: [PATCH] =?UTF-8?q?build(dev):=20=E5=BC=95=E5=85=A5=20Makefile=20?=
 =?UTF-8?q?=E5=91=BD=E4=BB=A4=E9=9D=A2=E8=96=84=E5=B0=81=E8=A3=85=E4=B8=8E?=
 =?UTF-8?q?=20.editorconfig=20=E5=9F=BA=E7=BA=BF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Makefile 仅转发 package.json scripts（唯一事实源），补 help 自说明、
  clean 清理与 check / mount / mount-aggregate / registry 四个聚合目标；
  check 用单条 recipe 串 typecheck → build → test → check:consumer-types，
  避免 make 前置依赖在 -j 下乱序；lint 目标留给引入 ESLint 的后续 PR
- .editorconfig：root + utf-8/lf/末尾换行/去尾随空格，默认 2 空格，
  Makefile recipe 保持 tab
---
 .editorconfig | 15 +++++++++++++++
 Makefile      | 42 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 57 insertions(+)
 create mode 100644 .editorconfig
 create mode 100644 Makefile

diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 0000000..17b1a28
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,15 @@
+# EditorConfig — https://editorconfig.org
+# 仓库统一编辑器基线；缩进等风格细节以各文件的既有约定为准。
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+# Makefile 的 recipe 必须用真实 tab（GNU Make 硬性要求）。
+[Makefile]
+indent_style = tab
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..f703433
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,42 @@
+# dsh-better-sidebar 命令面薄封装：目标仅转发 package.json scripts（唯一事实源），
+# 新增/改名 script 不需要动这里；本文件只补目标发现（help）与 CI 门禁聚合
+# （check / mount / mount-aggregate / registry）。
+# 注：lint 目标留给引入 ESLint 的后续 PR。
+
+.DEFAULT_GOAL := help
+
+help: ## 列出所有可用目标
+	@awk -F':.*## ' '/^[a-zA-Z0-9_-]+:.*## / {printf "  \033[36m%-18s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
+
+install: ## 安装依赖（pnpm install）
+	pnpm install
+
+build: ## 构建（清 lib/ → tsc → tsdown）
+	pnpm build
+
+typecheck: ## 类型检查（tsc --noEmit）
+	pnpm typecheck
+
+test: ## 单元测试（vitest run）
+	pnpm test
+
+check: ## 聚合校验门禁：typecheck → build → test → check:consumer-types（对齐 CI）
+	pnpm typecheck && pnpm build && pnpm test && pnpm check:consumer-types
+
+clean: ## 清理构建产物与测试报告（lib/、*.tgz、playwright-report/、test-results/）
+	rm -rf lib playwright-report test-results
+	rm -f *.tgz
+
+pack: ## 打 npm tarball（pnpm pack）
+	pnpm pack
+
+mount: ## 真机挂载冒烟：build + pack → Playwright Chromium → pnpm test:mount
+	pnpm build && pnpm pack && pnpm exec playwright install chromium && pnpm test:mount
+
+mount-aggregate: ## 聚合双挂载回归：build + pack → pnpm test:mount:aggregate
+	pnpm build && pnpm pack && pnpm test:mount:aggregate
+
+registry: ## 组装 plugin-registry 暂存（registry/，不入库）：build → node scripts/package-registry.mjs
+	pnpm build && node scripts/package-registry.mjs
+
+.PHONY: help install build typecheck test check clean pack mount mount-aggregate registry