@dianzhong/create-harness-app 0.1.0

package/dist/index.mjs

@@ -0,0 +1,412 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import path7 from "path";
+import fse2 from "fs-extra";
+import { outro } from "@clack/prompts";
+
+// src/prompts.ts
+import { intro, text, select, confirm, isCancel, cancel } from "@clack/prompts";
+function defaultConfig(projectName) {
+  return {
+    projectName,
+    router: true,
+    pinia: true,
+    vitest: false,
+    uiLibrary: "element-plus",
+    axios: true,
+    harness: "full"
+  };
+}
+function check(val) {
+  if (isCancel(val)) {
+    cancel("\u5DF2\u53D6\u6D88");
+    process.exit(0);
+  }
+  return val;
+}
+async function collectConfig(initialName) {
+  intro("create-harness-app \u2014 \u70B9\u4F17\u524D\u7AEF\u9879\u76EE\u521D\u59CB\u5316\u5668");
+  const projectName = initialName ?? check(await text({
+    message: "\u9879\u76EE\u540D\u79F0",
+    placeholder: "my-app",
+    validate: (v) => /^[a-z][a-z0-9-]*$/.test(v) ? void 0 : "\u8BF7\u4F7F\u7528\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u548C\u8FDE\u5B57\u7B26"
+  }));
+  const router = check(await confirm({ message: "\u542F\u7528 Vue Router\uFF1F", initialValue: true }));
+  const pinia = check(await confirm({ message: "\u542F\u7528 Pinia \u72B6\u6001\u7BA1\u7406\uFF1F", initialValue: true }));
+  const vitest = check(await confirm({ message: "\u542F\u7528 Vitest \u5355\u5143\u6D4B\u8BD5\uFF1F", initialValue: false }));
+  const uiLibrary = check(await select({
+    message: "UI \u7EC4\u4EF6\u5E93",
+    options: [
+      { value: "element-plus", label: "Element Plus\uFF08\u9ED8\u8BA4\uFF09" },
+      { value: "ant-design-vue", label: "Ant Design Vue" },
+      { value: "none", label: "\u81EA\u5DF1\u914D\u7F6E" }
+    ]
+  }));
+  const axios = check(await confirm({ message: "\u96C6\u6210 axios \u8BF7\u6C42\u5C42\uFF1F", initialValue: true }));
+  const harness = check(await select({
+    message: "Harness \u6CBB\u7406\u5C42",
+    options: [
+      { value: "full", label: "Full \u2014 \u5B8C\u6574 hooks/rules/agents/skills\uFF08\u9ED8\u8BA4\uFF09" },
+      { value: "minimal", label: "Minimal \u2014 \u4EC5\u5B89\u5168\u5B88\u62A4 + \u8D28\u91CF\u95E8\u7981" },
+      { value: "none", label: "\u4E0D\u96C6\u6210" }
+    ]
+  }));
+  return { projectName, router, pinia, vitest, uiLibrary, axios, harness };
+}
+
+// src/spawn-create-vue.ts
+import { execa } from "execa";
+async function spawnCreateVue(config, parentDir) {
+  const flags = [
+    "--typescript",
+    "--eslint-with-prettier",
+    "--force",
+    ...config.router ? ["--router"] : [],
+    ...config.pinia ? ["--pinia"] : [],
+    ...config.vitest ? ["--vitest"] : []
+  ];
+  await execa("npx", ["--yes", "create-vue@latest", config.projectName, ...flags], {
+    cwd: parentDir,
+    stdio: "inherit"
+  });
+}
+
+// src/overlay.ts
+import path6 from "path";
+
+// src/utils/fs.ts
+import fse from "fs-extra";
+import path from "path";
+async function copyDir(src, dest) {
+  await fse.ensureDir(dest);
+  await fse.copy(src, dest, { overwrite: true });
+}
+async function readText(p) {
+  return fse.readFile(p, "utf-8");
+}
+async function writeText(p, content) {
+  await fse.ensureDir(path.dirname(p));
+  return fse.writeFile(p, content, "utf-8");
+}
+async function readJson(p) {
+  return fse.readJson(p);
+}
+async function writeJson(p, data) {
+  await fse.ensureDir(path.dirname(p));
+  return fse.writeJson(p, data, { spaces: 2 });
+}
+
+// src/merge-json.ts
+function mergePackageJson(existing, additions) {
+  const result = { ...existing };
+  if (additions.dependencies) {
+    result.dependencies = mergeDeps(
+      existing.dependencies ?? {},
+      additions.dependencies
+    );
+  }
+  if (additions.devDependencies) {
+    result.devDependencies = mergeDeps(
+      existing.devDependencies ?? {},
+      additions.devDependencies
+    );
+  }
+  if (additions.scripts) {
+    result.scripts = {
+      ...existing.scripts ?? {},
+      ...additions.scripts
+    };
+  }
+  return result;
+}
+function mergeDeps(existing, additions) {
+  const result = { ...existing };
+  for (const [pkg, version] of Object.entries(additions)) {
+    if (!(pkg in result)) result[pkg] = version;
+  }
+  return result;
+}
+
+// src/features/axios.ts
+import path2 from "path";
+import { fileURLToPath } from "url";
+var TEMPLATES_DIR = fileURLToPath(new URL("../templates", import.meta.url));
+var AXIOS_PKG = {
+  dependencies: { axios: "^1.16.0" }
+};
+var SHOW_ERROR = {
+  "element-plus": `import { ElMessage } from 'element-plus'
+
+export function showError(msg: string): void {
+  ElMessage.error(msg)
+}
+`,
+  "ant-design-vue": `import { message } from 'ant-design-vue'
+
+export function showError(msg: string): void {
+  message.error(msg)
+}
+`,
+  "none": `// TODO: Replace with your UI library's notification component
+export function showError(msg: string): void {
+  console.error('[API Error]', msg)
+}
+`
+};
+async function overlayAxios(projectRoot, config) {
+  await copyDir(path2.join(TEMPLATES_DIR, "axios"), projectRoot);
+  await writeText(
+    path2.join(projectRoot, "src/utils/show-error.ts"),
+    SHOW_ERROR[config.uiLibrary]
+  );
+}
+
+// src/features/ui-element-plus.ts
+import path3 from "path";
+
+// src/inject.ts
+var AnchorNotFoundError = class extends Error {
+  constructor(anchor, file) {
+    super(`Anchor not found in "${file}": ${JSON.stringify(anchor)}`);
+    this.name = "AnchorNotFoundError";
+  }
+};
+function insertAfter(source, anchor, insertion, filePath = "<unknown>") {
+  const idx = source.indexOf(anchor);
+  if (idx === -1) throw new AnchorNotFoundError(anchor, filePath);
+  const end = idx + anchor.length;
+  return source.slice(0, end) + insertion + source.slice(end);
+}
+function insertBefore(source, anchor, insertion, filePath = "<unknown>") {
+  const idx = source.indexOf(anchor);
+  if (idx === -1) throw new AnchorNotFoundError(anchor, filePath);
+  return source.slice(0, idx) + insertion + source.slice(idx);
+}
+function hasMarker(source, marker) {
+  return source.includes(marker);
+}
+
+// src/features/ui-element-plus.ts
+var EP_MARKER = "// ELEMENT_PLUS_INJECTED";
+var VITE_IMPORTS = `import AutoImport from 'unplugin-auto-import/vite'
+import Components from 'unplugin-vue-components/vite'
+import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
+`;
+var VITE_PLUGINS = `
+    AutoImport({ resolvers: [ElementPlusResolver()] }),
+    Components({ resolvers: [ElementPlusResolver()] }),`;
+var MAIN_IMPORTS = `import ElementPlus from 'element-plus'
+import 'element-plus/dist/index.css'
+import './styles/element-plus.scss'
+`;
+var SCSS_CONTENT = `/* Element Plus \u4E3B\u9898\u8986\u76D6
+ * \u6587\u6863: https://element-plus.org/en-US/guide/theming.html
+ */
+`;
+var ELEMENT_PLUS_PKG = {
+  dependencies: {
+    "element-plus": "^2.13.7",
+    "@element-plus/icons-vue": "^2.3.2"
+  },
+  devDependencies: {
+    "unplugin-auto-import": "^21.0.0",
+    "unplugin-vue-components": "^32.0.0",
+    "sass": "^1.95.1"
+  }
+};
+async function overlayElementPlus(projectRoot) {
+  await writeText(path3.join(projectRoot, "src/styles/element-plus.scss"), SCSS_CONTENT);
+  const mainPath = path3.join(projectRoot, "src/main.ts");
+  let main2 = await readText(mainPath);
+  if (!hasMarker(main2, EP_MARKER)) {
+    main2 = insertBefore(main2, "import { createApp }", `${EP_MARKER}
+${MAIN_IMPORTS}`, mainPath);
+    main2 = insertAfter(main2, "const app = createApp(App)", `
+app.use(ElementPlus)`, mainPath);
+    await writeText(mainPath, main2);
+  }
+  const vitePath = path3.join(projectRoot, "vite.config.ts");
+  let vite = await readText(vitePath);
+  if (!hasMarker(vite, EP_MARKER)) {
+    vite = insertBefore(vite, "export default defineConfig(", `${EP_MARKER}
+${VITE_IMPORTS}`, vitePath);
+    vite = insertAfter(vite, "plugins: [", VITE_PLUGINS, vitePath);
+    await writeText(vitePath, vite);
+  }
+}
+
+// src/features/ui-antdv.ts
+import path4 from "path";
+var ANTDV_MARKER = "// ANT_DESIGN_VUE_INJECTED";
+var VITE_IMPORTS2 = `import Components from 'unplugin-vue-components/vite'
+import { AntDesignVueResolver } from 'unplugin-vue-components/resolvers'
+`;
+var VITE_PLUGINS2 = `
+    Components({ resolvers: [AntDesignVueResolver()] }),`;
+var MAIN_IMPORTS2 = `import Antd from 'ant-design-vue'
+import 'ant-design-vue/dist/reset.css'
+`;
+var ANTDV_PKG = {
+  dependencies: {
+    "ant-design-vue": "^4.2.0",
+    "@ant-design/icons-vue": "^7.0.0"
+  },
+  devDependencies: {
+    "unplugin-vue-components": "^32.0.0"
+  }
+};
+async function overlayAntdv(projectRoot) {
+  const mainPath = path4.join(projectRoot, "src/main.ts");
+  let main2 = await readText(mainPath);
+  if (!hasMarker(main2, ANTDV_MARKER)) {
+    main2 = insertBefore(main2, "import { createApp }", `${ANTDV_MARKER}
+${MAIN_IMPORTS2}`, mainPath);
+    main2 = insertAfter(main2, "const app = createApp(App)", `
+app.use(Antd)`, mainPath);
+    await writeText(mainPath, main2);
+  }
+  const vitePath = path4.join(projectRoot, "vite.config.ts");
+  let vite = await readText(vitePath);
+  if (!hasMarker(vite, ANTDV_MARKER)) {
+    vite = insertBefore(vite, "export default defineConfig(", `${ANTDV_MARKER}
+${VITE_IMPORTS2}`, vitePath);
+    vite = insertAfter(vite, "plugins: [", VITE_PLUGINS2, vitePath);
+    await writeText(vitePath, vite);
+  }
+}
+
+// src/features/harness.ts
+import path5 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var TEMPLATES_DIR2 = fileURLToPath2(new URL("../templates", import.meta.url));
+var HARNESS_FULL_PKG = {
+  devDependencies: {
+    "oxlint": "~1.57.0",
+    "@commitlint/cli": "^20.2.0",
+    "@commitlint/config-conventional": "^20.2.0",
+    "lint-staged": "^16.2.7",
+    "husky": "^9.1.7"
+  },
+  scripts: {
+    "harness:sync": "node scripts/verify-skills.mjs --write",
+    "harness:check": "node scripts/verify-skills.mjs && node scripts/harness-hooks.test.mjs",
+    "harness:test": "node scripts/harness-hooks.test.mjs && node scripts/verify-skills.test.mjs",
+    "check": "pnpm type-check && pnpm lint && pnpm format:check && pnpm harness:check"
+  }
+};
+var HARNESS_MINIMAL_PKG = {
+  devDependencies: {},
+  scripts: {
+    "check": "pnpm type-check && pnpm lint && pnpm format:check"
+  }
+};
+async function overlayHarness(projectRoot, level) {
+  await copyDir(path5.join(TEMPLATES_DIR2, "harness", level), projectRoot);
+}
+
+// src/overlay.ts
+async function overlay(projectRoot, config) {
+  const pkgPath = path6.join(projectRoot, "package.json");
+  let pkg = await readJson(pkgPath);
+  const add = { dependencies: {}, devDependencies: {}, scripts: {} };
+  const merge = (src) => {
+    if (src.dependencies) Object.assign(add.dependencies, src.dependencies);
+    if (src.devDependencies) Object.assign(add.devDependencies, src.devDependencies);
+    if (src.scripts) Object.assign(add.scripts, src.scripts);
+  };
+  if (config.axios) {
+    await overlayAxios(projectRoot, config);
+    merge(AXIOS_PKG);
+  }
+  if (config.uiLibrary === "element-plus") {
+    await overlayElementPlus(projectRoot);
+    merge(ELEMENT_PLUS_PKG);
+  } else if (config.uiLibrary === "ant-design-vue") {
+    await overlayAntdv(projectRoot);
+    merge(ANTDV_PKG);
+  }
+  if (config.harness !== "none") {
+    await overlayHarness(projectRoot, config.harness);
+    merge(config.harness === "full" ? HARNESS_FULL_PKG : HARNESS_MINIMAL_PKG);
+  }
+  pkg = mergePackageJson(pkg, add);
+  await writeJson(pkgPath, pkg);
+}
+
+// src/utils/logger.ts
+import pc from "picocolors";
+var info = (msg) => console.log(pc.cyan(`  ${msg}`));
+var success = (msg) => console.log(pc.green(`\u2713 ${msg}`));
+var error = (msg) => console.error(pc.red(`\u2717 ${msg}`));
+var log = (msg) => console.log(msg);
+
+// src/index.ts
+function parseArgs(argv) {
+  return {
+    projectName: argv.find((a) => !a.startsWith("-")),
+    isYes: argv.includes("--yes"),
+    uiLibrary: argv.find((a) => a.startsWith("--ui="))?.split("=")[1],
+    harness: argv.find((a) => a.startsWith("--harness="))?.split("=")[1],
+    noAxios: argv.includes("--no-axios"),
+    vitest: argv.includes("--vitest")
+  };
+}
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (process.argv.includes("--help") || process.argv.includes("-h")) {
+    log(`Usage: create-harness-app [project-name] [options]
+
+Options:
+  --yes              Non-interactive: TS + Router + Pinia + ElementPlus + axios + harness:full
+  --ui=<lib>         element-plus | ant-design-vue | none  (default: element-plus)
+  --harness=<level>  full | minimal | none                 (default: full)
+  --no-axios         Skip axios layer
+  --vitest           Enable Vitest
+  -h, --help         Show this help
+
+Examples:
+  npm create @dianzhong/harness-app my-app
+  npm create @dianzhong/harness-app my-app -- --yes
+  npm create @dianzhong/harness-app my-app -- --ui=ant-design-vue --harness=minimal
+`);
+    process.exit(0);
+  }
+  let config;
+  if (args.isYes || args.projectName && args.uiLibrary !== void 0 && args.harness !== void 0) {
+    const base = defaultConfig(args.projectName ?? "my-app");
+    config = {
+      ...base,
+      uiLibrary: args.uiLibrary ?? base.uiLibrary,
+      harness: args.harness ?? base.harness,
+      axios: !args.noAxios,
+      vitest: args.vitest
+    };
+    info(`\u975E\u4EA4\u4E92\u6A21\u5F0F: ${config.projectName} | UI=${config.uiLibrary} | harness=${config.harness}`);
+  } else {
+    config = await collectConfig(args.projectName);
+  }
+  const targetDir = path7.resolve(process.cwd(), config.projectName);
+  if (await fse2.pathExists(targetDir)) {
+    const entries = await fse2.readdir(targetDir);
+    if (entries.length > 0) {
+      error(`\u76EE\u5F55 "${config.projectName}" \u5DF2\u5B58\u5728\u4E14\u4E0D\u4E3A\u7A7A`);
+      process.exit(1);
+    }
+  }
+  info("\u4F7F\u7528 create-vue \u751F\u6210\u57FA\u7840\u9AA8\u67B6...");
+  await spawnCreateVue(config, path7.dirname(targetDir));
+  info("\u53E0\u52A0 features...");
+  await overlay(targetDir, config);
+  success("\u9879\u76EE\u521D\u59CB\u5316\u5B8C\u6210\uFF01");
+  outro("\u4E0B\u4E00\u6B65");
+  log(`
+  cd ${config.projectName}`);
+  log("  pnpm install");
+  if (config.harness === "full") log("  pnpm harness:sync   # \u91CD\u7B97 skills \u6307\u7EB9");
+  log("  pnpm dev\n");
+}
+main().catch((err) => {
+  error(String(err.message ?? err));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@dianzhong/create-harness-app",
+  "version": "0.1.0",
+  "description": "点众前端项目初始化器：封装 create-vue，叠加 UI 库、axios 层与 AI Harness 治理体系",
+  "type": "module",
+  "bin": { "create-harness-app": "dist/index.mjs" },
+  "files": ["dist/", "templates/"],
+  "engines": { "node": "^20.19.0 || >=22.12.0" },
+  "keywords": ["create-vue", "scaffold", "harness", "vue3"],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "node --test --experimental-strip-types tests/merge-json.test.ts tests/inject.test.ts",
+    "test:e2e": "node --experimental-strip-types tests/e2e/generate.test.ts"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.10.0",
+    "execa": "^9.0.0",
+    "fs-extra": "^11.3.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "~5.7.0"
+  }
+}

package/templates/axios/.env.example

@@ -0,0 +1,2 @@
+# API 基础路径，按部署环境修改
+VITE_API_BASE_URL=http://localhost:8080

package/templates/axios/src/api/auth.ts

@@ -0,0 +1,19 @@
+import request from './request'
+
+/** 用户名密码登录 */
+export function loginAPI(data: { username: string; password: string }) {
+  return request<{ token: string }>({ url: '/api/auth/login', method: 'POST', data })
+}
+
+/** 退出登录 */
+export function logoutAPI() {
+  return request<void>({ url: '/api/auth/logout', method: 'POST' })
+}
+
+/** 获取当前用户信息 */
+export function getUserInfoAPI() {
+  return request<{ id: number; name: string; roles: string[] }>({
+    url: '/api/auth/userInfo',
+    method: 'GET',
+  })
+}

package/templates/axios/src/api/request.ts

@@ -0,0 +1,61 @@
+import axios from 'axios'
+import type { AxiosRequestConfig } from 'axios'
+import type { ApiResponse } from '@/types/api'
+import { getAccessToken, removeAccessToken } from '@/utils/auth'
+import { showError } from '@/utils/show-error'
+
+const axiosInstance = axios.create({
+  timeout: 15000,
+  headers: { 'Content-Type': 'application/json' },
+})
+
+axiosInstance.interceptors.request.use((config) => {
+  const token = getAccessToken()
+  if (token) config.headers.Authorization = `Bearer ${token}`
+  return config
+})
+
+axiosInstance.interceptors.response.use(
+  (response) => {
+    const res = response.data as ApiResponse<unknown>
+    if (res.code === 401) {
+      removeAccessToken()
+      window.location.href = '/login'
+      return Promise.reject(new Error(res.msg || '登录已过期'))
+    }
+    if (res.code !== 200) {
+      showError(res.msg || '请求失败')
+      return Promise.reject(new Error(res.msg || '请求失败'))
+    }
+    return response
+  },
+  (error) => {
+    if (error.response?.status === 401) {
+      removeAccessToken()
+      window.location.href = '/login'
+      return Promise.reject(new Error('登录已过期'))
+    }
+    const message = error.response?.data?.msg || error.message || '网络异常'
+    showError(message)
+    return Promise.reject(new Error(message))
+  },
+)
+
+export default function request<T>(config: {
+  url: string
+  method?: 'GET' | 'POST' | 'PUT' | 'DELETE'
+  data?: unknown
+  params?: unknown
+  headers?: Record<string, string>
+  onUploadProgress?: (progressEvent: { loaded: number; total?: number }) => void
+}): Promise<T> {
+  const axiosConfig: AxiosRequestConfig = {
+    url: config.url,
+    method: config.method,
+    data: config.data,
+    params: config.params,
+    onUploadProgress: config.onUploadProgress,
+    headers: { ...config.headers },
+  }
+  return axiosInstance(axiosConfig).then((res) => (res.data as ApiResponse<T>).data)
+}

package/templates/axios/src/types/api.ts

@@ -0,0 +1,26 @@
+export interface ApiResponse<T> {
+  code: number
+  msg: string
+  data: T
+}
+
+export interface PageParams {
+  pageNo?: number
+  limit?: number
+}
+
+export interface PageResult<T> {
+  data: T[]
+  pageNo: number
+  limit: number
+  totalNum: number
+  totalPage: number
+  /** 兼容后端 records 命名 */
+  records?: T[]
+  /** 兼容后端 total 命名 */
+  total?: number
+  /** 兼容后端 size 命名 */
+  size?: number
+  /** 兼容后端 current 命名 */
+  current?: number
+}

package/templates/axios/src/utils/auth.ts

@@ -0,0 +1,5 @@
+import { getStorageItem, removeStorageItem, setStorageItem } from './storage'
+
+export function getAccessToken() { return getStorageItem('token') }
+export function setAccessToken(token: string) { setStorageItem('token', token) }
+export function removeAccessToken() { removeStorageItem('token') }

package/templates/axios/src/utils/storage.ts

@@ -0,0 +1,17 @@
+export function getStorageItem(key: string): string | null {
+  return window.localStorage.getItem(key)
+}
+export function setStorageItem(key: string, value: string) {
+  window.localStorage.setItem(key, value)
+}
+export function removeStorageItem(key: string) {
+  window.localStorage.removeItem(key)
+}
+export function getJsonStorageItem<T>(key: string): T | null {
+  const raw = getStorageItem(key)
+  if (!raw) return null
+  try { return JSON.parse(raw) as T } catch { removeStorageItem(key); return null }
+}
+export function setJsonStorageItem<T>(key: string, value: T) {
+  setStorageItem(key, JSON.stringify(value))
+}