mine-auto-cli 2.3.2 → 2.4.0

package/README.md

@@ -1,6 +1,6 @@
 # mine-auto-cli
 
-一个将多个命令简化成一个命令的项目 😆
+一个将多个命令简化成一个命令的工具 😆
 
 <h2 align="center">
   <a href="https://www.npmjs.com/package/mine-auto-cli"><img src="https://img.shields.io/npm/v/mine-auto-cli.svg?logo=npm" alt="版本" /></a>
@@ -11,11 +11,13 @@
 
 ## 特性
 
+- [x] [初始化配置文件](#初始化配置文件)
 - [x] [简化 `Git` 提交命令](#简化-git-提交命令)
 - [x] [简化打包提交命令](#简化打包提交命令)
 - [x] [简化手动更改版本号命令](#简化手动更改版本号命令)
 - [x] [生成工作目录结构文件](#生成工作目录结构文件)
 - [x] [检查 `package.json` 依赖版本](#检查-packagejson-依赖版本)
+- [x] [生成依赖注释文件](#生成依赖注释文件)
 
 ## 全局安装
 
@@ -37,6 +39,50 @@ auto -v
 auto -h
 ```
 
+### 初始化配置文件
+
+- 自动生成初始化 `auto-cli.jsonc` 文件
+- 带上 `-y` 或者 `--yml` 生成 `auto-cli.yml`
+- 如果两个文件都存在，则合并优先于 `auto-cli.jsonc` 文件
+- 初始化的所有字段仅是默认值和可选值，可以自定义删除
+
+```sh
+auto init
+```
+
+- 字段解析：
+
+  - `prefix`: 版本前缀，默认为 `^`
+  - `registry`: 依赖来源，默认为 `https://registry.npmmirror.com/`
+  - `check`: 是否更新 `package.json` 文件，为 `true` 时等同于 `auto check -u`, `-u` 优先级最高， 默认为 `false`
+  - `reject`: 拒绝检查的依赖，默认为 `[]`
+  - `resolve`: 指定版本检查的标签，默认为 `[]`，例如：['mine-auto-cli@beta']，默认标签为 `latest`
+  - `comment`: 配置依赖解析说明预设
+
+- auto-cli.jsonc
+
+```json
+{
+  "prefix": "^",
+  "registry": "https://registry.npmmirror.com/",
+  "check": false,
+  "reject": [],
+  "resolve": [],
+  "comment": {}
+}
+```
+
+- auto-cli.yml
+
+```yml
+prefix: ^
+registry: https://registry.npmmirror.com/
+check: false
+reject: []
+resolve: []
+comment: {}
+```
+
 ### 简化 Git 提交命令
 
 ```sh
@@ -108,36 +154,38 @@ auto check
 
 ![img](./assets/check.png)
 
-#### `check.config.json`
+#### 生成依赖注释文件
 
-- 自动生成初始化 `check.config.json` 文件
+- 可以在工作目录生成 `directory.md` 文件
 
 ```sh
-npm check -i
+auto comment
 ```
 
-- 字段解析：
-  - `prefix`: 版本前缀，默认为 `^`
-  - `registry`: 依赖来源，默认为 `https://registry.npmmirror.com/`
-  - `check`: 是否更新 `package.json` 文件，为 `true` 时等同于 `auto check -u`, `-u` 优先级最高， 默认为 `false`
-  - `reject`: 拒绝检查的依赖，默认为 `[]`
-  - `resolve`: 指定版本检查的标签，默认为 `[]`，例如：['mine-auto-cli@beta']，默认标签为 `latest`
+- `comment.md`
+- 可以在 `auto-cli.jsonc` 配置 `comment` 用来设置预设值，不设置的话默认为空
 
-```json
-{
-  "prefix": "^",
-  "registry": "https://registry.npmmirror.com/",
-  "check": false,
-  "reject": [],
-  "resolve": []
-}
+```MD
+### 依赖解析
+
+#### dependencies
+
+- `mine-h5-ui`:
+
+#### devDependencies
+
+- `mine-auto-cli`:
+
+#### optionalDependencies
+
+- `@rollup/rollup-linux-x64-gnu`:
 ```
 
 ### 技术栈
 
-- `Vite` + `TypeScript` + `Node`
+- `Vite` + `TypeScript` + `NodeJs`
 
-### 依赖特性
+### 依赖解析
 
 #### dependencies
 
@@ -160,4 +208,4 @@ npm check -i
 
 ## 贡献者们
 
-[![贡献者](https://contrib.rocks/image?repo=biaov/mine-auto-cli)](https://github.com/biaov/mine-auto-cli/graphs/contributors)
+[![贡献者们](https://contrib.rocks/image?repo=biaov/mine-auto-cli)](https://github.com/biaov/mine-auto-cli/graphs/contributors)

package/dist/{check.config.jsonc → auto-cli.jsonc}

@@ -3,5 +3,6 @@
   "registry": "https://registry.npmmirror.com/", // 依赖来源，默认为 `https://registry.npmmirror.com/`
   "check": false, // 是否更新 `package.json` 文件，为 `true` 时等同于 `auto check -u`, `-u` 优先级最 高， 默认为 `false`
   "reject": [], // 拒绝检查的依赖，默认为 `[]`
-  "resolve": [] // 指定版本检查的标签，默认为 `[]`，例如：['mine-auto-cli@beta']，默认标签为 `latest`
+  "resolve": [], // 指定版本检查的标签，默认为 `[]`，例如：['mine-auto-cli@beta']，默认标签为 `latest`
+  "comment": {} // 配置依赖解析说明预设
 }

package/dist/index.js

@@ -1,244 +1,304 @@
-import W from "update-notifier";
+import ee from "update-notifier";
 import a from "chalk";
-import { program as m } from "commander";
-import X from "ora";
-import { execSync as Y } from "child_process";
-import { readFileSync as v, writeFileSync as k, existsSync as O, readdirSync as Z } from "fs";
-import { join as b, resolve as F } from "path";
-import q from "log-symbols";
-import ee from "pacote";
-import R from "strip-json-comments";
-const U = "mine-auto-cli", G = "2.3.2", te = "./dist/index.js", ne = "./dist/index.js", oe = "module", se = {
+import { program as g } from "commander";
+import { readFileSync as h, writeFileSync as v, existsSync as j, readdirSync as te } from "fs";
+import { join as S, resolve as w } from "path";
+import R from "log-symbols";
+import ne from "ora";
+import { execSync as oe } from "child_process";
+import se from "js-yaml";
+import re from "strip-json-comments";
+import ce from "pacote";
+const G = "mine-auto-cli", _ = "2.4.0", ie = "./dist/index.js", ae = "./dist/index.js", le = "module", pe = {
   auto: "bin/mine-auto-cli.js"
-}, ie = {
+}, me = {
   name: "biaov",
   email: "biaov@qq.com",
   url: "https://biaov.cn"
-}, re = "一个将多个命令简化成一个命令的项目 😆", ce = {
+}, ge = "一个将多个命令简化成一个命令的工具 😆", de = {
   start: "npm run dev",
   dev: "npm run build -- --watch",
-  build: "node scripts/build && vite build",
+  build: "vite build",
   prettier: "prettier --write '**/*.{js,ts,md,json}'",
-  ncu: "ncu --configFileName .ncurc.json && npm i"
-}, ae = {
+  tag: "node scripts/tag"
+}, ue = {
   registry: "https://registry.npmjs.org/",
   "engine-strict": !0,
   provenance: !0
-}, pe = {
+}, fe = {
   node: ">=20.12"
-}, le = [
+}, he = [
   "auto",
   "cli",
   "vite",
   "typescript"
-], ge = {
+], ye = {
   type: "git",
   url: "git+https://github.com/biaov/mine-auto-cli.git"
-}, me = "https://github.com/biaov/mine-auto-cli.git", ue = {
+}, $e = "https://github.com/biaov/mine-auto-cli.git", ve = {
   url: "https://github.com/biaov/mine-auto-cli/issues"
-}, de = "ISC", fe = [
+}, be = "ISC", je = [
   {
     name: "biaov",
     email: "biaov@qq.com"
   }
-], he = {
+], we = {
   chalk: "^5.3.0",
   commander: "^12.0.0",
+  "js-yaml": "^4.1.0",
   "log-symbols": "^6.0.0",
   ora: "^8.0.1",
-  pacote: "^18.0.2",
+  pacote: "^18.0.6",
   "strip-json-comments": "^5.0.1",
   "update-notifier": "^7.0.0"
-}, ye = {
-  "@types/node": "^20.12.7",
+}, ke = {
+  "@types/js-yaml": "^4.0.9",
+  "@types/node": "^20.12.12",
   "@types/pacote": "^11.1.8",
   "@types/update-notifier": "^6.0.8",
   prettier: "^3.2.5",
   typescript: "^5.4.5",
-  vite: "^5.2.10"
-}, x = {
-  name: U,
+  vite: "^5.2.11"
+}, O = {
+  name: G,
   private: !1,
-  version: G,
-  exports: te,
-  main: ne,
-  type: oe,
-  bin: se,
-  author: ie,
-  description: re,
-  scripts: ce,
-  publishConfig: ae,
-  engines: pe,
-  keywords: le,
-  repository: ge,
-  homepage: me,
-  bugs: ue,
-  license: de,
-  contributors: fe,
-  dependencies: he,
-  devDependencies: ye
-}, h = (e) => {
-  console.log(`${q.success} ${a.green("SUCCESS")} ${e}`);
-}, N = (e) => {
-  console.log(`${U} ${q.error} ${a.red("ERROR")} ${e}`);
-}, p = (e) => {
+  version: _,
+  exports: ie,
+  main: ae,
+  type: le,
+  bin: pe,
+  author: me,
+  description: ge,
+  scripts: de,
+  publishConfig: ue,
+  engines: fe,
+  keywords: he,
+  repository: ye,
+  homepage: $e,
+  bugs: ve,
+  license: be,
+  contributors: je,
+  dependencies: we,
+  devDependencies: ke
+}, u = (e) => {
+  console.log(`${R.success} ${a.green("SUCCESS")} ${e}`);
+}, J = (e) => {
+  console.log(`${G} ${R.error} ${a.red("ERROR")} ${e}`);
+}, l = (e) => {
   console.log(e ?? "");
-}, $e = (e) => ["git add -A", `git commit -m ${e}`, "git push"], ve = (e, t) => [`npm run ${e}`, "git add -A", `git commit -m ${t}`, "git push"], _ = (e) => {
-  p(`开始执行 ${a.cyanBright(e)} 命令`);
-  const t = X({ text: "正在执行命令中...", color: "yellow" });
+}, B = (e) => {
+  l(`开始执行 ${a.cyanBright(e)} 命令`);
+  const t = ne({ text: "正在执行命令中...", color: "yellow" });
   t.start();
-  const r = Y(e, { cwd: process.cwd() });
-  p(r.toString()), t.succeed(`${a.green(e)} 命令执行成功`), p();
-}, be = async (e = "更新代码") => {
-  p(), p(`${a.yellow(">>")} 开始依次执行命令...`), p(), $e(e).forEach(_), h("全部命令执行完成"), p();
-}, ke = async (e, t = "打包") => {
-  p(), p(`${a.yellow(">>")} 开始依次执行命令...`), p(), ve(e, t).map(_), h("全部命令执行完成"), p();
-}, D = (e) => {
-  p(), N(`\`${e}\` 命令错误，请检查你的命令`), p(), m.help();
+  const o = oe(e, { cwd: process.cwd() });
+  l(o.toString()), t.succeed(`${a.green(e)} 命令执行成功`), l();
+}, Se = (e) => ["git add -A", `git commit -m ${e}`, "git push"], xe = (e, t) => [`npm run ${e}`, "git add -A", `git commit -m ${t}`, "git push"], Ce = async (e, t = "打包") => {
+  l(), l(`${a.yellow(">>")} 开始依次执行命令...`), l(), xe(e, t).map(B), u("全部命令执行完成"), l();
+}, P = (e) => {
+  l(), J(`\`${e}\` 命令错误，请检查你的命令`), l(), g.help();
 }, I = (e) => {
-  const t = ["package.json", "README.md"].map((s) => {
-    const i = b(process.cwd(), s), c = v(i).toString();
-    return { path: i, content: c };
-  }), [r, n] = t, o = JSON.parse(r.content);
+  const t = ["package.json", "README.md"].map((r) => {
+    const c = S(process.cwd(), r), i = h(c).toString();
+    return { path: c, content: i };
+  }), [o, n] = t, s = JSON.parse(o.content);
   if (e)
-    o.version = e;
+    s.version = e;
   else {
-    const s = o.version.split(".").reduce((i, c, l, g) => i + (l === g.length - 1 ? +c + 1 : `${c}.`), "");
-    o.version = s;
+    const r = s.version.split(".").reduce((c, i, p, m) => c + (p === m.length - 1 ? +i + 1 : `${i}.`), "");
+    s.version = r;
   }
-  k(r.path, JSON.stringify(o, null, 2)), n.content = n.content.replace(/version\-v.+\-blue/, () => `version-v${o.version}-blue`), k(n.path, n.content);
-}, we = async (e) => {
+  v(o.path, JSON.stringify(s, null, 2)), n.content = n.content.replace(/version\-v.+\-blue/, () => `version-v${s.version}-blue`), v(n.path, n.content);
+}, Oe = async (e) => {
   const t = e.split("version")[1];
   if (!t)
-    return D(e);
-  const r = JSON.parse(v(b(process.cwd(), "package.json"), "utf-8"));
+    return P(e);
+  const o = JSON.parse(h(S(process.cwd(), "package.json")).toString());
   if (t === "++") {
-    const o = r.version.split(".").reduce((s, i, c, l) => s + (c === l.length - 1 ? +i + 1 : `${i}.`), "");
-    I(o), p(), h("命令执行完成");
+    const s = o.version.split(".").reduce((r, c, i, p) => r + (i === p.length - 1 ? +c + 1 : `${c}.`), "");
+    I(s), l(), u("命令执行完成");
     return;
   }
   const n = t.split("@")[1];
-  n ? (I(n), p(), h("命令执行完成")) : D(e);
-}, Se = (e, t) => {
+  n ? (I(n), l(), u("命令执行完成")) : P(e);
+}, Je = (e, t) => {
   if (e.includes("build"))
-    return ke(e, t);
+    return Ce(e, t);
   if (e.includes("version"))
-    return we(e);
-  N(a.hex("#f56c6c")(`\`auto ${e}${t ? ` ${t}` : ""}\` 命令不存在`)), m.help();
-}, A = ["dist", "node_modules", ".git", "miniprogram_npm"];
-let V = 0, B = !1, J = !1, z = 20;
-const P = ({ prev: e, i: t, index: r, arr: n, curText: o }) => {
-  const s = Array.from({ length: t }).reduce((g) => g + `${t === 1 && r === n.length - 1 ? "└ " : "│ "}   `, ""), i = e + s, c = (s + o).length, l = Array.from({ length: z + V - c }).reduce((g) => `${g}-`, " ");
-  return !B && (V = Math.max(V, c)), `${i}${o}${J ? l : ""}
+    return Oe(e);
+  J(a.hex("#f56c6c")(`\`auto ${e}${t ? ` ${t}` : ""}\` 命令不存在`)), g.help();
+}, $ = "https://gitee.com/biaovorg/project-template.git", Ne = {
+  vue: $,
+  react: $,
+  "uni-app": $,
+  electron: $,
+  node: $,
+  "node-simple": $
+}, Ve = Object.keys(Ne);
+Ve.reduce((e, t, o) => e + (o ? ", " : "") + t, "");
+const f = (e = "jsonc") => `auto-cli.${e}`;
+w(import.meta.dirname, "./presetData.json");
+const Y = (e, t = !1) => {
+  if (!j(e))
+    return t ? {} : "";
+  const o = h(e).toString();
+  return t ? JSON.parse(re(o)) : o;
+}, Ee = (e) => {
+  if (!j(e))
+    return {};
+  const t = h(e).toString();
+  try {
+    return se.load(t);
+  } catch {
+    return {};
+  }
+}, z = (e = !1) => Y(w(import.meta.dirname, f()), e), H = () => {
+  const [e, t] = [f(), f("yml")].map((n) => w(process.cwd(), n)), o = z(!0);
+  try {
+    Object.assign(o, Ee(t), Y(e, !0));
+  } catch {
+  }
+  return o;
+}, De = (e, t = !1) => {
+  let o = z(t);
+  return t && (o = JSON.stringify(o, null, 2)), e.includes(".yml") ? o.trim().split(`
+`).slice(1, -1).reduce((n, s) => n + s.trim().replace(/[",]/g, "").replace("// ", "# ") + `
+`, "") : o;
+}, Le = ({ yml: e, uncomment: t, force: o }) => {
+  l();
+  const n = f(e ? "yml" : "jsonc"), s = w(process.cwd(), n);
+  if (j(s) && !o) {
+    l(a.yellow(`${n} 文件已存在`)), l(), l(a.yellow(`文件目录  ${s}`));
+    return;
+  }
+  v(s, De(n, t)), u(`${n} 文件创建成功`), l(), l(a.green(`文件目录  ${s}`));
+};
+g.command("init").option("-f, --force", `强制替换 ${f()} 文件内容`, !1).option("-unc, --uncomment", `取消生成 ${f()} 带注释`, !1).option("-y, --yml", `生成 ${f("yml")} 文件`, !1).description("初始化配置文件").action(Le);
+const Pe = async (e = "更新代码") => {
+  l(), l(`${a.yellow(">>")} 开始依次执行命令...`), l(), Se(e).forEach(B), u("全部命令执行完成"), l();
+};
+g.command("git [描述]").description("简化 Git 提交命令").action(Pe);
+const A = ["dist", "node_modules", ".git", "miniprogram_npm"];
+let N = 0, K = !1, E = !1, Q = 20;
+const M = ({ prev: e, i: t, index: o, arr: n, curText: s }) => {
+  const r = Array.from({ length: t }).reduce((m) => m + `${t === 1 && o === n.length - 1 ? "└ " : "│ "}   `, ""), c = e + r, i = (r + s).length, p = Array.from({ length: Q + N - i }).reduce((m) => `${m}-`, " ");
+  return !K && (N = Math.max(N, i)), `${c}${s}${E ? p : ""}
 `;
-}, E = (e, t = 0) => e.reduce((r, n, o, s) => {
-  let i;
-  return n.children ? (i = `├── ${n.name}`, P({ prev: r, i: t, index: o, arr: s, curText: i }) + E(n.children, t + 1)) : (i = `${o === s.length - 1 ? "└── " : "├── "}${n.name}`, P({ prev: r, i: t, index: o, arr: s, curText: i }));
-}, ""), M = (e) => Z(e, { withFileTypes: !0 }).sort((t, r) => +r.isDirectory() - +t.isDirectory()), je = ({ line: e, name: t }) => {
-  J = !!e, typeof e == "string" && (z = +e);
-  const r = process.cwd(), n = b(r, ".gitignore");
-  if (O(n)) {
-    const l = v(n, { encoding: "utf-8" }).split(`\r
+}, D = (e, t = 0) => e.reduce((o, n, s, r) => {
+  let c;
+  return n.children ? (c = `├── ${n.name}`, M({ prev: o, i: t, index: s, arr: r, curText: c }) + D(n.children, t + 1)) : (c = `${s === r.length - 1 ? "└── " : "├── "}${n.name}`, M({ prev: o, i: t, index: s, arr: r, curText: c }));
+}, ""), F = (e) => te(e, { withFileTypes: !0 }).sort((t, o) => +o.isDirectory() - +t.isDirectory()), Ie = ({ line: e, name: t }) => {
+  E = !!e, typeof e == "string" && (Q = +e);
+  const o = process.cwd(), n = S(o, ".gitignore");
+  if (j(n)) {
+    const p = h(n).toString().split(`\r
 `);
-    A.push(...l);
+    A.push(...p);
   }
-  const o = r.split("\\").at(-1), i = M(r).map((l) => {
-    const { name: g } = l, u = { name: g };
-    return !A.includes(g) && l.isDirectory() && (u.children = M(b(l.path, g)).map(({ name: d }) => ({ name: d }))), u;
-  }), c = [{ name: o, children: i }];
-  J && (E(c), B = !0), k(b(r, `${typeof t == "string" && t || "directory"}.md`), E(c));
+  const s = o.split("\\").at(-1), c = F(o).map((p) => {
+    const { name: m } = p, d = { name: m };
+    return !A.includes(m) && p.isDirectory() && (d.children = F(S(p.path, m)).map(({ name: k }) => ({ name: k }))), d;
+  }), i = [{ name: s, children: c }];
+  E && (D(i), K = !0), v(S(o, `${typeof t == "string" && t || "directory"}.md`), D(i));
 };
-m.command("mkdir").option("-l, --line [数量]", "数量", !1).option("-n, --name [文件名称]", "文件名称", !1).option("-d, --depth [深度值]", "深度值", "3").description("生成目录结构文件").action(je);
-const T = { encoding: "utf-8" }, H = v(F(import.meta.dirname, "./check.config.jsonc")).toString(), f = JSON.parse(R(H.toString())), w = "check.config.jsonc", xe = [w, "package.json"], [$, C] = xe.map((e) => F(process.cwd(), e)), Oe = () => {
-  if (p(), O($)) {
-    p(a.yellow(`${w} 文件已存在`)), p(), p(a.yellow(`文件目录  ${$}`));
-    return;
-  }
-  k($, H), h(`${w} 文件创建成功`), p(), p(a.green(`文件目录  ${$}`));
-}, Ve = (e, t) => {
-  const r = Array.from({ length: t }, (i, c) => c < e ? "=" : " ").join(""), n = ~~(e / t * 100), o = `\r查找进度：[${r}] ${e}/${t} ${n}%\r`, s = e === t ? a.green(o) : a.yellow(o);
-  process.stdout.write(s);
-}, Ce = (e, t, r) => {
+g.command("mkdir").option("-l, --line [数量]", "数量", !1).option("-n, --name [文件名称]", "文件名称", !1).option("-d, --depth [深度值]", "深度值", "3").description("生成目录结构文件").action(Ie);
+const b = H(), [V] = ["package.json"].map((e) => w(process.cwd(), e)), Ae = (e, t) => {
+  const o = Array.from({ length: t }, (c, i) => i < e ? "=" : " ").join(""), n = ~~(e / t * 100), s = `\r查找进度：[${o}] ${e}/${t} ${n}%\r`, r = e === t ? a.green(s) : a.yellow(s);
+  process.stdout.write(r);
+}, Me = (e, t, o) => {
   let n = "latest";
-  f.resolve.some((s) => {
-    const i = s.lastIndexOf("@");
-    if (i <= 0)
+  b.resolve.some((r) => {
+    const c = r.lastIndexOf("@");
+    if (c <= 0)
       return !0;
-    const c = s.slice(0, i), l = s.slice(i + 1);
-    if (e === c)
-      return n = l, !0;
+    const i = r.slice(0, c), p = r.slice(c + 1);
+    if (e === i)
+      return n = p, !0;
   });
-  const o = f.prefix + r[n];
-  return { name: e, value: t, newVersion: o, tag: n };
-}, Je = (e, t) => Array.from({ length: t - e }, () => " ").join(""), Ee = (e, t) => (+!t + 1) * e.length, Ne = (e, t) => {
-  const r = e.match(/\d.+/g)[0].split("."), n = t.match(/\d.+/g)[0].split("."), o = n.slice(0, -1).findIndex((i, c) => +i > +r[c]), s = f.prefix + n[0];
-  switch (o) {
+  const s = b.prefix + o[n];
+  return { name: e, value: t, newVersion: s, tag: n };
+}, Fe = (e, t) => Array.from({ length: t - e }, () => " ").join(""), Te = (e, t) => (+!t + 1) * e.length, T = (e) => e.match(/\d.+/g)[0].split("."), Ue = (e, t) => {
+  const o = T(e), n = T(t), s = n.slice(0, -1).findIndex((c, i) => +c > +o[i]), r = b.prefix + n[0];
+  switch (s) {
     case 0:
       return a.red(t);
     case 1:
-      return `${s}.${a.yellow(n[1])}.${a.yellow(n[2])}`;
+      return `${r}.${a.yellow(n[1])}.${a.yellow(n[2])}`;
     default:
-      const i = r.at(-1), c = n.at(-1);
-      return i !== c && parseInt(c) >= parseInt(i) ? `${s}.${n[1]}.${a.green(n[2])}` : !1;
+      const c = o.at(-1), i = n.at(-1);
+      return c !== i && parseInt(i) >= parseInt(c) ? `${r}.${n[1]}.${a.green(n[2])}` : !1;
   }
-}, Le = (e) => {
+}, qe = (e) => {
   const t = {};
   e.forEach((n) => {
-    Object.entries(n).forEach(([o, s]) => {
-      t[o] = Math.max(s.length, t[o] ?? 0);
+    Object.entries(n).forEach(([s, r]) => {
+      t[s] = Math.max(r.length, t[s] ?? 0);
     });
   }), e.unshift({ name: "包名", value: "版本", newVersion: "新版本", tag: "标签" });
-  const r = [];
-  e.forEach(({ name: n, value: o, newVersion: s, tag: i }, c) => {
-    const [l, g, u, d] = Object.entries({ name: n, value: o, newVersion: s, tag: i }).map(([S, Q]) => Je(Ee(Q, c), t[S]));
+  const o = [];
+  e.forEach(({ name: n, value: s, newVersion: r, tag: c }, i) => {
+    const [p, m, d, k] = Object.entries({ name: n, value: s, newVersion: r, tag: c }).map(([x, Z]) => Fe(Te(Z, i), t[x]));
     let y = a.yellow("→"), L = !0;
-    if (c) {
-      const S = Ne(o, s);
-      S ? s = S : L = !1;
+    if (i) {
+      const x = Ue(s, r);
+      x ? r = x : L = !1;
     } else
-      n = a.green(n), o = a.green(o), s = a.green(s), i = a.green(i), y = " ";
-    const K = `${n + l}  ${g + o}  ${y}  ${u + s}  ${d + i}`;
-    L && r.push(K);
-  }), r.length > 1 ? r.forEach(p) : h("所有版本已是最新");
-}, De = async (e, t, r) => {
-  p();
+      n = a.green(n), s = a.green(s), r = a.green(r), c = a.green(c), y = " ";
+    const X = `${n + p}  ${m + s}  ${y}  ${d + r}  ${k + c}`;
+    L && o.push(X);
+  }), o.length > 1 ? o.forEach(l) : u("所有版本已是最新");
+}, Re = async (e, t, o) => {
+  l();
   let n = 0;
-  const o = [], s = Object.entries(e), i = s.map(async ([c, l]) => {
-    const g = await ee.packument(c, { registry: f.registry }), u = Ce(c, l, g["dist-tags"]);
-    o.push(u), t.forEach((d) => {
-      const y = r[d];
-      y && y[c] && (y[c] = u.newVersion);
-    }), n++, await Ve(n, s.length);
+  const s = [], r = Object.entries(e), c = r.map(async ([i, p]) => {
+    const m = await ce.packument(i, { registry: b.registry }), d = Me(i, p, m["dist-tags"]);
+    s.push(d), t.forEach((k) => {
+      const y = o[k];
+      y && y[i] && (y[i] = d.newVersion);
+    }), n++, await Ae(n, r.length);
   });
-  return await Promise.all(i), p(), p(), o;
-}, Ie = async ({ update: e, init: t }) => {
-  if (t)
-    return Oe();
-  if (!O(C))
-    return N("package.json 文件不存在");
-  O($) && Object.assign(f, JSON.parse(R(v($, T).toString())));
-  const r = e || f.check, n = v(C, T).toString(), o = JSON.parse(n), s = ["dependencies", "devDependencies", "optionalDependencies"], i = {}, c = JSON.parse(n);
-  s.forEach((g) => {
-    o[g] && Object.entries(o[g]).forEach(([u, d]) => {
-      !f.reject.includes(u) && (i[u] = d);
+  return await Promise.all(c), l(), l(), s;
+}, Ge = async ({ update: e }) => {
+  if (!j(V))
+    return J("package.json 文件不存在");
+  const t = e || b.check, o = h(V).toString(), n = JSON.parse(o), s = ["dependencies", "devDependencies", "optionalDependencies"], r = {}, c = JSON.parse(o);
+  s.forEach((p) => {
+    n[p] && Object.entries(n[p]).forEach(([m, d]) => {
+      !b.reject.includes(m) && (r[m] = d);
     });
   });
-  const l = await De(i, s, c);
-  r && (k(C, JSON.stringify(c, null, 2)), h("文件 package.json 已更新"), p()), Le(l);
+  const i = await Re(r, s, c);
+  t && (v(V, JSON.stringify(c, null, 2)), u("文件 package.json 已更新"), l()), qe(i);
+};
+g.command("check").option("-u, --update", "更新 package.json 依赖内容", !1).description("升级 package.json 依赖版本").action(Ge);
+const _e = H(), W = "comment.md", Be = ["package.json", W], [U, q] = Be.map((e) => w(process.cwd(), e)), Ye = () => {
+  if (!j(U))
+    return J("package.json 文件不存在");
+  const e = h(U).toString(), t = JSON.parse(e), o = ["dependencies", "devDependencies", "optionalDependencies"];
+  let n = `### 依赖解析
+
+`;
+  o.forEach((s) => {
+    t[s] && (n += `#### ${s}
+
+`, Object.keys(t[s]).forEach((r) => {
+      n += `- \`${r}\`: ${_e.comment[r] || ""}
+`;
+    }), n += `
+`);
+  }), n = n.slice(0, -1), v(q, n), l(), u(`${W} 文件创建成功`), l(), l(a.green(`文件目录  ${q}`));
 };
-m.command("check").option("-u, --update", `更新 package.json 依赖内容 或者配置 ${w} 文件`, !1).option("-i, --init", `仅初始化 ${w} 文件，不检查依赖版本`, !1).description("升级 package.json 依赖版本").action(Ie);
-m.usage("[commands] [options]").version(G, "-v, --version", "输出版本号").helpOption("-h, --help", "输出所有命令");
-m.command("git [描述]").description("简化 Git 提交命令").action(be);
-m.command("build[:环境] [描述]").description("简化打包提交命令");
-m.command("version<[++]|[@<版本号>]>").description("例如：version++ 或者 version@1.0.0；自动更新 package.json 版本号，自动更新 `README.md` 中的 `version-v<version>-blue` 图标版本");
-m.arguments("<cmd> [env]").action((e, t) => {
-  Se(e, t);
+g.command("comment").description("生成依赖注释文件").action(Ye);
+g.usage("[commands] [options]").version(_, "-v, --version", "输出版本号").helpOption("-h, --help", "输出所有命令");
+g.command("build[:环境] [描述]").description("简化打包提交命令");
+g.command("version<[++]|[@<版本号>]>").description("例如：version++ 或者 version@1.0.0；自动更新 package.json 版本号，自动更新 `README.md` 中的 `version-v<version>-blue` 图标版本");
+g.arguments("<cmd> [env]").action((e, t) => {
+  Je(e, t);
 });
-process.argv.length < 3 ? m.help() : m.parse(process.argv);
-const j = W({ pkg: x });
-if (j.update && j.update.latest !== x.version) {
+process.argv.length < 3 ? g.help() : g.parse(process.argv);
+const C = ee({ pkg: O });
+if (C.update && C.update.latest !== O.version) {
   let e = "";
-  switch (j.update.type) {
+  switch (C.update.type) {
     case "major":
       e = a.red("{latestVersion}");
       break;
@@ -249,8 +309,8 @@ if (j.update && j.update.latest !== x.version) {
       e = a.green("{latestVersion}");
       break;
   }
-  const t = `https://github.com/biaov/${x.name}/compare/v${x.version}...v{latestVersion}`;
-  j.notify({
+  const t = `https://github.com/biaov/${O.name}/compare/v${O.version}...v{latestVersion}`;
+  C.notify({
     defer: !1,
     isGlobal: !0,
     message: `有更新 ${a.dim("{currentVersion}")}${a.reset(" → ")}${e}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mine-auto-cli",
   "private": false,
-  "version": "2.3.2",
+  "version": "2.4.0",
   "exports": "./dist/index.js",
   "main": "./dist/index.js",
   "type": "module",
@@ -13,11 +13,12 @@
     "email": "biaov@qq.com",
     "url": "https://biaov.cn"
   },
-  "description": "一个将多个命令简化成一个命令的项目 😆",
+  "description": "一个将多个命令简化成一个命令的工具 😆",
   "scripts": {},
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
-    "provenance": false
+    "engine-strict": true,
+    "provenance": true
   },
   "engines": {
     "node": ">=20.12"
@@ -46,9 +47,10 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
+    "js-yaml": "^4.1.0",
     "log-symbols": "^6.0.0",
     "ora": "^8.0.1",
-    "pacote": "^18.0.2",
+    "pacote": "^18.0.6",
     "strip-json-comments": "^5.0.1",
     "update-notifier": "^7.0.0"
   },