@cc123hh/gitee-cli 0.3.0 → 0.4.0

package/README.md

@@ -163,12 +163,24 @@ gitee push --public -d "我的小工具"
 ### Issue / Pull Request
 
 ```bash
-gitee issues emb-cli             # 打开中的 Issue
+gitee issues emb-cli                          # 列出 Issue
 gitee issues emb-cli -s all -n 50
+gitee issue view emb-cli IKVADU               # 查看详情
+gitee issue create emb-cli -t "发现bug" -b "复现步骤" -l bug -a 用户名   # 创建
+gitee issue edit emb-cli IKVADU -t "新标题" -b "新正文" -l bug,docs     # 修改
+gitee issue edit emb-cli IKVADU -f 正文.md     # 正文从 UTF-8 文件读（与 -b 互斥）
+gitee issue close emb-cli IKVADU              # 关闭（open 为重开）
+gitee issue comment emb-cli IKVADU -m "已修复"   # 加评论
+gitee close emb-cli IKVADU                    # 顶层快捷：关闭 / 重开
+gitee reopen emb-cli IKVADU
 gitee prs emb-cli
 ```
 
-`repo` 参数写 `仓库名` 会自动补上你的用户名，也可以写完整的 `owner/repo`。
+`repo` 参数写 `仓库名` 会自动补上你的用户名，也可以写完整的 `owner/repo`；
+Issue 相关命令省略 `repo` 时取当前目录同名仓库，只写编号也能定位
+（如 `gitee issue view IKVADU`）。Issue 编号是 Gitee 生成的字符串标识
+（如 `IKVADU`），带不带 `#` 前缀都可以（shell 里 `#` 要加引号）。
+Gitee 无删除 Issue 的接口（已实测 405），`issue delete` 不提供。
 
 ## 📋 参数
 
@@ -176,7 +188,13 @@ gitee prs emb-cli
 |---|---|---|
 | `-n/--limit` | list / issues / prs | 返回条数 |
 | `--json` | list | 输出原始 JSON |
-| `-s/--state` | issues / prs | `open` / `closed` / `all` |
+| `-s/--state` | issues / prs / issue | 列表筛选 `open`/`closed`/`all`；`issue edit` 修改状态 `open`/`progressing`/`closed` |
+| `-t/--title` | issue create / edit | 标题（create 必填） |
+| `-b/--body` | issue create / edit | 正文（与 `-f` 互斥） |
+| `-f/--file` | issue create / edit / comment | 从 UTF-8 文件读正文/评论 |
+| `-l/--labels` | issue create / edit | 标签，逗号分隔 |
+| `-a/--assignee` | issue create / edit | 负责人 username |
+| `-m/--message` | issue comment | 评论内容 |
 | `-y/--yes` | delete | 跳过确认 |
 | `-d/--description` | create / push | 仓库简介 |
 | `--public` | create / push | 目标可见性 |

package/bin/gitee.js

@@ -314,6 +314,189 @@ async function cmdPrs(client, opts) {
   return EXIT_OK;
 }
 
+// Issue 编号是 Gitee 自动生成的字符串标识（如 IKVADU），不是数字
+const ISSUE_STATE_TEXT = {
+  open: "开启", progress: "进行中", closed: "已关闭", rejected: "已拒绝",
+};
+
+function issueStateText(state) {
+  return ISSUE_STATE_TEXT[state] || state || "?";
+}
+
+// 统一解析 issue 单条操作的位置参数：
+// - 两个位置参数：repo + 编号
+// - 只给一个：视为编号，仓库取当前目录同名仓库
+// - 编号容忍 # 前缀（用户习惯写 #IKVADU）
+function parseIssueArg(opts) {
+  let repo = opts.repo;
+  let number = opts.number;
+  const repoEmpty = repo === undefined || repo === null || repo === "";
+  const numEmpty = number === undefined || number === null || number === "";
+  if (numEmpty && repoEmpty) return null;
+  if (numEmpty) {
+    number = repo;
+    repo = undefined;
+  }
+  number = String(number).trim().replace(/^#/, "");
+  if (!number) return null;
+  return { repo: repo === undefined || repo === null ? "" : String(repo).trim(), number };
+}
+
+async function issueTarget(opts, client) {
+  const pos = parseIssueArg(opts);
+  if (!pos) return null;
+  const full = await splitRepo(pos.repo || path.basename(process.cwd()), client);
+  return { full, number: pos.number };
+}
+
+function issueUsageHint(action) {
+  return `错误：缺少 Issue 编号。用法：gitee ${action} [<仓库>] <编号>`
+    + `（仓库省略时取当前目录同名仓库）`;
+}
+
+function printIssue(it) {
+  console.log(`编号:   #${it.number}`);
+  console.log(`标题:   ${it.title}`);
+  console.log(`状态:   ${it.state}（${issueStateText(it.state)}）`);
+  console.log(`作者:   ${(it.user && it.user.login) || "?"}`);
+  const labels = (it.labels || []).map((l) => l.name || l).join(", ");
+  console.log(`标签:   ${labels || "（无）"}`);
+  console.log(`评论:   ${it.comments ?? 0} 条`);
+  console.log(`创建:   ${it.created_at}`);
+  console.log(`更新:   ${it.updated_at}`);
+  if (it.finished_at) console.log(`完成:   ${it.finished_at}`);
+  console.log(`链接:   ${it.html_url}`);
+  console.log("正文:");
+  console.log(it.body || "（无）");
+}
+
+async function cmdIssue(client, opts) {
+  const target = await issueTarget(opts, client);
+  if (!target) {
+    console.error(issueUsageHint("issue view"));
+    return EXIT_USAGE;
+  }
+  const it = await issueGet(client, target.full, target.number);
+  printIssue(it);
+  return EXIT_OK;
+}
+
+// ---------- Issue 写接口（路径不含 repo 段，仓库以表单参数 repo 传） ---------- //
+function issueOwnerRepo(full) {
+  const [owner, repoName] = full.split("/");
+  return { owner, repoName };
+}
+
+function issueGet(client, full, number) {
+  return client.get(`/repos/${full}/issues/${encodeURIComponent(number)}`);
+}
+
+function issuePatch(client, full, number, form) {
+  // 统一注入表单 repo：Gitee 更新接口路径不含 repo 段（与 GitHub 不同）
+  const { owner, repoName } = issueOwnerRepo(full);
+  return client.patch(`/repos/${owner}/issues/${encodeURIComponent(number)}`,
+    { repo: repoName, ...form });
+}
+
+// -b 正文 与 -f 文件正文 互斥；-f 读取 UTF-8 文件内容作为正文
+function resolveBodyArg(opts) {
+  if (opts.body !== undefined && opts.file !== undefined) {
+    console.error("错误：-b/--body 与 -f/--file 只能二选一");
+    return { error: true };
+  }
+  if (opts.file !== undefined) {
+    try {
+      return { body: fs.readFileSync(opts.file, "utf8") };
+    } catch (e) {
+      console.error(`错误：无法读取正文文件 ${opts.file}：${e.message}`);
+      return { error: true };
+    }
+  }
+  return { body: opts.body };
+}
+
+async function cmdIssueCreate(client, opts) {
+  if (!opts.title) {
+    console.error("错误：创建 Issue 需要 -t/--title 标题");
+    return EXIT_USAGE;
+  }
+  const bodyArg = resolveBodyArg(opts);
+  if (bodyArg.error) return EXIT_USAGE;
+  const full = await parseRepoArg(opts, client);
+  const { owner, repoName } = issueOwnerRepo(full);
+  const form = { repo: repoName, title: opts.title };
+  if (bodyArg.body !== undefined && bodyArg.body !== null) form.body = bodyArg.body;
+  if (opts.labels) form.labels = opts.labels;
+  if (opts.assignee) form.assignee = opts.assignee;
+  const it = await client.post(`/repos/${owner}/issues`, form);
+  console.log(`已创建: #${it.number} ${it.title}`);
+  console.log(`链接:   ${it.html_url}`);
+  return EXIT_OK;
+}
+
+async function cmdIssueEdit(client, opts) {
+  const target = await issueTarget(opts, client);
+  if (!target) {
+    console.error(issueUsageHint("issue edit"));
+    return EXIT_USAGE;
+  }
+  const bodyArg = resolveBodyArg(opts);
+  if (bodyArg.error) return EXIT_USAGE;
+  const form = {};
+  if (opts.title !== undefined) form.title = opts.title;
+  if (bodyArg.body !== undefined && bodyArg.body !== null) form.body = bodyArg.body;
+  if (opts.state !== undefined) form.state = opts.state;
+  if (opts.labels !== undefined) form.labels = opts.labels;
+  if (opts.assignee !== undefined) form.assignee = opts.assignee;
+  // 不带任何修改参数时按查看处理，避免空 PATCH 造成误解
+  if (!Object.keys(form).length) {
+    const it = await issueGet(client, target.full, target.number);
+    printIssue(it);
+    return EXIT_OK;
+  }
+  await issuePatch(client, target.full, target.number, form);
+  const it = await issueGet(client, target.full, target.number);
+  printIssue(it);
+  return EXIT_OK;
+}
+
+async function cmdIssueComment(client, opts) {
+  if (opts.message === undefined && opts.file === undefined) {
+    console.error("错误：评论内容用 -m/--message 给出（或 -f/--file 从文件读）");
+    return EXIT_USAGE;
+  }
+  const bodyArg = resolveBodyArg({ body: opts.message, file: opts.file });
+  if (bodyArg.error) return EXIT_USAGE;
+  if (!bodyArg.body) {
+    console.error("错误：评论内容不能为空");
+    return EXIT_USAGE;
+  }
+  const target = await issueTarget(opts, client);
+  if (!target) {
+    console.error(issueUsageHint("issue comment"));
+    return EXIT_USAGE;
+  }
+  const c = await client.post(
+    `/repos/${target.full}/issues/${encodeURIComponent(target.number)}/comments`,
+    { body: bodyArg.body });
+  console.log(`已评论: #${target.number}（评论 id ${c.id}）`);
+  if (c.html_url) console.log(`链接:   ${c.html_url}`);
+  return EXIT_OK;
+}
+
+async function cmdSetIssueState(client, opts, state, hint = "close") {
+  const target = await issueTarget(opts, client);
+  if (!target) {
+    console.error(issueUsageHint(hint));
+    return EXIT_USAGE;
+  }
+  const { full, number } = target;
+  await issuePatch(client, full, number, { state });
+  const it = await issueGet(client, full, number);
+  console.log(`#${it.number} [${issueStateText(it.state)}] ${it.title}`);
+  return EXIT_OK;
+}
+
 function runGit(args, cwd) {
   const r = spawnSync("git", args, { cwd, encoding: "utf8" });
   return { code: r.status, out: r.stdout || "", err: r.stderr || "" };
@@ -395,6 +578,82 @@ const STATE_OPTS = [
   { short: "-n", long: "--limit", dest: "limit", arg: "int", default: 20, help: "条数（默认 20）" },
 ];
 
+// ---- Issue 动作族共用的选项与位置参数 ---- //
+const ISSUE_STATE_OPT = [
+  { short: "-s", long: "--state", dest: "state", arg: "value",
+    choices: ["open", "progressing", "closed"],
+    help: "状态：open 开启 / progressing 进行中 / closed 关闭" },
+];
+const ISSUE_BODY_OPTS = [
+  { short: "-b", long: "--body", dest: "body", arg: "value", help: "正文（与 -f 二选一）" },
+  { short: "-f", long: "--file", dest: "file", arg: "value", help: "从 UTF-8 文件读正文" },
+];
+const ISSUE_META_OPTS = [
+  { short: "-l", long: "--labels", dest: "labels", arg: "value",
+    help: "标签，逗号分隔（如 bug,docs）" },
+  { short: "-a", long: "--assignee", dest: "assignee", arg: "value", help: "负责人 username" },
+];
+const ISSUE_POS = [
+  { dest: "repo", required: false, help: "仓库名或 owner/repo（默认当前目录同名仓库）" },
+  { dest: "number", required: false, help: "Issue 编号（字符串标识，如 IKVADU，可带 #）" },
+];
+
+const ISSUE_FAMILY_HELP = `用法：gitee issue <动作> [参数]
+
+动作：
+  view     查看 Issue 详情    gitee issue view [<repo>] <编号>
+  create   创建 Issue         gitee issue create [<repo>] -t 标题 [-b|-f 正文] [-l 标签] [-a 负责人]
+  edit     修改 Issue         gitee issue edit [<repo>] <编号> [-t 标题] [-b|-f 正文] [-s 状态] [-l 标签] [-a 负责人]
+  open     重开 Issue         gitee issue open [<repo>] <编号>
+  close    关闭 Issue         gitee issue close [<repo>] <编号>
+  comment  加评论             gitee issue comment [<repo>] <编号> -m 内容|-f 文件
+
+用 gitee issue <动作> -h 查看各动作详情。`;
+
+const ISSUE_ACTIONS = {
+  view: {
+    run: (client, o) => cmdIssue(client, o),
+    spec: spec("用法：gitee issue view [<repo>] <编号>", "查看 Issue 详情",
+      clientOpts(), ISSUE_POS),
+  },
+  create: {
+    run: (client, o) => cmdIssueCreate(client, o),
+    spec: spec("用法：gitee issue create [<repo>] -t 标题 [-b 正文|-f 文件] [-l 标签] [-a 负责人]",
+      "创建 Issue（Gitee 无删除接口，建前想清楚）",
+      [{ short: "-t", long: "--title", dest: "title", arg: "value", required: true,
+          help: "标题（必填）" },
+        ...ISSUE_BODY_OPTS, ...ISSUE_META_OPTS, ...clientOpts()],
+      [{ dest: "repo", required: false, help: "仓库名或 owner/repo（默认当前目录同名仓库）" }]),
+  },
+  edit: {
+    run: (client, o) => cmdIssueEdit(client, o),
+    spec: spec("用法：gitee issue edit [<repo>] <编号> [-t 标题] [-b|-f 正文] [-s 状态] [-l 标签] [-a 负责人]",
+      "修改 Issue（不带任何修改参数时等于 view）",
+      [{ short: "-t", long: "--title", dest: "title", arg: "value", help: "新标题" },
+        ...ISSUE_BODY_OPTS, ...ISSUE_STATE_OPT, ...ISSUE_META_OPTS, ...clientOpts()],
+      ISSUE_POS),
+  },
+  open: {
+    run: (client, o) => cmdSetIssueState(client, o, "open", "issue open"),
+    spec: spec("用法：gitee issue open [<repo>] <编号>", "重开 Issue",
+      clientOpts(), ISSUE_POS),
+  },
+  close: {
+    run: (client, o) => cmdSetIssueState(client, o, "closed", "issue close"),
+    spec: spec("用法：gitee issue close [<repo>] <编号>", "关闭 Issue",
+      clientOpts(), ISSUE_POS),
+  },
+  comment: {
+    run: (client, o) => cmdIssueComment(client, o),
+    spec: spec("用法：gitee issue comment [<repo>] <编号> -m 内容|-f 文件", "给 Issue 加评论",
+      [{ short: "-m", long: "--message", dest: "message", arg: "value", help: "评论内容" },
+        { short: "-f", long: "--file", dest: "file", arg: "value",
+          help: "从 UTF-8 文件读评论内容（与 -m 二选一）" },
+        ...clientOpts()],
+      ISSUE_POS),
+  },
+};
+
 const SUBCOMMANDS = {
   set: {
     run: (opts) => cmdSetConfig(opts),
@@ -457,6 +716,23 @@ const SUBCOMMANDS = {
       [...STATE_OPTS, ...clientOpts()],
       [{ dest: "repo", required: false, help: "仓库名或 owner/repo（默认当前目录同名仓库）" }]),
   },
+  issue: {
+    run: null, // 动作族：main 里按 argv[1] 分发到 ISSUE_ACTIONS
+    actions: ISSUE_ACTIONS,
+    spec: null,
+  },
+  close: {
+    run: (client, o) => cmdSetIssueState(client, o, "closed", "close"),
+    spec: spec("用法：gitee close [<repo>] <编号>", "关闭 Issue", clientOpts(),
+      [{ dest: "repo", required: false, help: "仓库名或 owner/repo（默认当前目录同名仓库）" },
+        { dest: "number", required: false, help: "Issue 编号（可带 #）" }]),
+  },
+  reopen: {
+    run: (client, o) => cmdSetIssueState(client, o, "open", "reopen"),
+    spec: spec("用法：gitee reopen [<repo>] <编号>", "重开 Issue", clientOpts(),
+      [{ dest: "repo", required: false, help: "仓库名或 owner/repo（默认当前目录同名仓库）" },
+        { dest: "number", required: false, help: "Issue 编号（可带 #）" }]),
+  },
   prs: {
     run: (client, o) => cmdPrs(client, o),
     spec: spec("用法：gitee prs [<repo>] [-s 状态] [-n 条数]", "列出 Pull Request",
@@ -486,6 +762,9 @@ const TOP_HELP = `gitee — Gitee 仓库管理命令行工具
   public/private 切换仓库可见性
   delete        删除仓库
   issues / prs  列出 Issue / Pull Request
+  issue         Issue 操作族：view / create / edit / open / close / comment
+                （无动作词时默认 view；顶层 close/reopen 等价 issue close/open）
+  close/reopen  关闭 / 重开 Issue
   push          当前目录建仓并推送
 
 用 \`gitee <子命令> -h\` 查看各子命令详情。`;
@@ -508,7 +787,22 @@ async function main() {
   }
   if (cmd === "-h") process.exit(EXIT_OK);
 
-  const { opts } = parse(def.spec, argv.slice(1));
+  // issue 动作族：argv[1] 必须是动作词，切换到对应 spec（剩余 argv 从 2 起解析）
+  let spec = def.spec;
+  let action = null;
+  if (def.actions) {
+    if (argv[1] === undefined) {
+      console.error(`错误：缺少 issue 动作\n\n${ISSUE_FAMILY_HELP}`);
+      process.exit(EXIT_USAGE);
+    }
+    action = def.actions[argv[1]] || null;
+    if (!action) {
+      console.error(`错误：未知 issue 动作 ${JSON.stringify(argv[1])}\n\n${ISSUE_FAMILY_HELP}`);
+      process.exit(EXIT_USAGE);
+    }
+    spec = action.spec;
+  }
+  const { opts } = parse(spec, action ? argv.slice(2) : argv.slice(1));
   if (def.noAuth) {
     process.exit(await def.run(opts));
   }
@@ -527,7 +821,7 @@ async function main() {
   const [timeout] = resolveValue(opts.timeout, cfg.timeout, null, DEFAULT_TIMEOUT);
   const client = new Client(token, api, proxy, timeout);
   try {
-    process.exit(await def.run(client, opts));
+    process.exit(await (action ? action.run(client, opts) : def.run(client, opts)));
   } catch (e) {
     if (e instanceof GiteeError) {
       console.error(`错误：${e.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cc123hh/gitee-cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Gitee 仓库管理命令行工具——纯 Node 零依赖实现",
   "bin": {
     "gitee": "bin/gitee.js"