@kevisual/cnb 0.0.64 → 0.0.66

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kevisual/cnb",
-  "version": "0.0.64",
+  "version": "0.0.66",
   "description": "",
   "main": "index.js",
   "basename": "/root/cnb",
@@ -20,6 +20,7 @@
   "bin": {
     "cnb": "bin/index.js",
     "cloud": "bin/index.js",
+    "cloud-live": "bin/live.js",
     "cloud-npc": "bin/npc.js"
   },
   "files": [
@@ -32,7 +33,7 @@
   "packageManager": "pnpm@10.33.0",
   "type": "module",
   "devDependencies": {
-    "@ai-sdk/openai-compatible": "^2.0.37",
+    "@ai-sdk/openai-compatible": "^2.0.38",
     "@kevisual/ai": "^0.0.28",
     "@kevisual/api": "^0.0.65",
     "@kevisual/code-builder": "^0.0.7",
@@ -40,14 +41,15 @@
     "@kevisual/dts": "^0.0.4",
     "@kevisual/remote-app": "^0.0.7",
     "@kevisual/types": "^0.0.12",
-    "@opencode-ai/plugin": "^1.3.13",
+    "@opencode-ai/plugin": "^1.3.15",
     "@types/bun": "^1.3.11",
-    "@types/node": "^25.5.0",
+    "@types/node": "^25.5.2",
     "@types/ws": "^8.18.1",
-    "ai": "^6.0.143",
+    "ai": "^6.0.146",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",
-    "dotenv": "^17.4.0",
+    "dotenv": "^17.4.1",
+    "fast-glob": "^3.3.3",
     "zod": "^4.3.6"
   },
   "publishConfig": {
@@ -60,8 +62,9 @@
     "@kevisual/query": "^0.0.55",
     "@kevisual/router": "^0.2.5",
     "@kevisual/use-config": "^1.0.30",
-    "@opencode-ai/sdk": "^1.3.13",
+    "@opencode-ai/sdk": "^1.3.15",
     "es-toolkit": "^1.45.1",
+    "form-data": "^4.0.5",
     "nanoid": "^5.1.7",
     "unstorage": "^1.17.5",
     "ws": "npm:@kevisual/ws"

package/src/index.ts

@@ -10,6 +10,7 @@ import { AiBase } from "./ai/index.ts";
 import { RepoLabel, IssueLabel } from "./labels/index.ts";
 import { RegistryPackage, PackageManagement } from "./package/index.ts";
 import { Organization } from "./org/index.ts";
+import { Release } from "./release/index.ts";
 
 type CNBOptions = CNBCoreOptions<{
 }>;
@@ -33,6 +34,7 @@ export class CNB extends CNBCore {
   };
   org!: Organization;
   dashboard!: Dashboard;
+  release!: Release;
   constructor(options: CNBOptions) {
     super({ ...options, token: options.token, cookie: options.cookie, cnb: options.cnb });
     this.init(options);
@@ -61,6 +63,7 @@ export class CNB extends CNBCore {
     };
     this.org = new Organization(options);
     this.dashboard = new Dashboard(options);
+    this.release = new Release(options);
   }
   setToken(token: string) {
     this.token = token;
@@ -76,6 +79,7 @@ export class CNB extends CNBCore {
     this.packages.package.token = token;
     this.org.token = token;
     this.dashboard.token = token;
+    this.release.token = token;
   }
   setCookie(cookie: string) {
     this.cookie = cookie;
@@ -91,6 +95,7 @@ export class CNB extends CNBCore {
     this.packages.package.cookie = cookie;
     this.org.cookie = cookie;
     this.dashboard.cookie = cookie;
+    this.release.cookie = cookie;
   }
   getCNBVersion = getCNBVersion
 }
@@ -118,5 +123,6 @@ type VersionInfo = {
 
 export * from './issue/npc/env.ts'
 export * from './labels/index.ts'
+export * from './release/index.ts'
 export * from './package/index.ts'
 export * from './org/index.ts'

package/src/release/index.ts

@@ -0,0 +1,254 @@
+import { Result } from '@kevisual/query';
+import { CNBCore, CNBCoreOptions } from "../cnb-core.ts";
+
+export type UserInfo = {
+  /** 用户登录名 */
+  login: string;
+  /** 用户 ID */
+  id: string;
+  /** 用户头像 URL */
+  avatar_url: string;
+};
+
+export type ReleaseAsset = {
+  /** 附件唯一标识符 */
+  id: string;
+  /** 附件名称 */
+  name: string;
+  /** 附件路径 */
+  path: string;
+  /** 附件大小（字节） */
+  size: number;
+  /** 附件内容类型 */
+  content_type: string;
+  /** 下载次数 */
+  download_count: number;
+  /** 附件哈希算法 */
+  hash_algo: string;
+  /** 附件哈希值 */
+  hash_value: string;
+  /** API 下载 URL（通过 API 域名，用于程序化下载） */
+  url: string;
+  /** 浏览器下载 URL（通过主域名，用于用户直接访问） */
+  brower_download_url: string;
+  /** 附件上传者信息 */
+  uploader: UserInfo;
+  /** 创建时间 */
+  created_at: string;
+  /** 更新时间 */
+  updated_at: string;
+};
+
+export type ReleaseItem = {
+  /** 版本唯一标识符 */
+  id: string;
+  /** 版本标题 */
+  name: string;
+  /** 标签名称 */
+  tag_name: string;
+  /** 标签与提交标识符 */
+  tag_commitish: string;
+  /** 版本描述 */
+  body: string;
+  /** 是否为草稿版本 */
+  draft: boolean;
+  /** 是否为预发布版本 */
+  prerelease: boolean;
+  /** 是否为最新版本 */
+  is_latest: boolean;
+  /** 作者信息 */
+  author: UserInfo;
+  /** 附件列表 */
+  assets: ReleaseAsset[];
+  /** 创建时间 */
+  created_at: string;
+  /** 版本发布时间 */
+  published_at: string;
+  /** 更新时间 */
+  updated_at: string;
+};
+
+export type PostReleaseForm = {
+  /** 标签名称 */
+  tag_name: string;
+  /** 目标提交哈希或分支名称 */
+  target_commitish?: string;
+  /** 版本标题 */
+  name?: string;
+  /** 版本描述 */
+  body?: string;
+  /** 是否为草稿版本 */
+  draft?: boolean;
+  /** 是否为预发布版本 */
+  prerelease?: boolean;
+  /** 是否设置为最新版本。可选值：`true`, `false`, `legacy` */
+  make_latest?: string;
+};
+
+export type PatchReleaseForm = {
+  /** 版本标题 */
+  name?: string;
+  /** 版本描述 */
+  body?: string;
+  /** 是否为草稿版本 */
+  draft?: boolean;
+  /** 是否为预发布版本 */
+  prerelease?: boolean;
+  /** 是否设置为最新版本。可选值：`true`, `false`, `legacy` */
+  make_latest?: string;
+};
+
+export type PostReleaseAssetUploadURLForm = {
+  /** 附件名称 */
+  asset_name: string;
+  /** 附件大小，单位为字节 */
+  size: number;
+  /** 附件存在时间，单位为天 */
+  ttl?: number;
+  /** 是否覆盖同名附件 */
+  overwrite?: boolean;
+};
+
+export type ReleaseAssetUploadURL = {
+  /** 附件上传 URL */
+  upload_url: string;
+  /** 附件上传确认验证 URL */
+  verify_url: string;
+  /** URL 过期时间，单位为秒 */
+  expires_in_sec: number;
+};
+
+export type ListReleasesParams = {
+  /** 分页页码，默认 1 */
+  page?: number;
+  /** 分页页大小，默认 10 */
+  page_size?: number;
+  query?: string;
+};
+
+export class Release extends CNBCore {
+  constructor(options: CNBCoreOptions) {
+    super(options);
+  }
+
+  /**
+   * 查询 release 列表
+   * @param repo 仓库路径
+   * @param params 分页参数
+   */
+  list(repo: string, params?: ListReleasesParams): Promise<Result<ReleaseItem[]>> {
+    return this.get({ url: `/${repo}/-/releases`, params });
+  }
+
+  /**
+   * 新增一个 release
+   * @param repo 仓库路径
+   * @param data 创建表单
+   */
+  create(repo: string, data: PostReleaseForm): Promise<Result<ReleaseItem>> {
+    return this.post({ url: `/${repo}/-/releases`, data });
+  }
+
+  /**
+   * 查询最新的 release
+   * @param repo 仓库路径
+   */
+  getLatest(repo: string): Promise<Result<ReleaseItem>> {
+    return this.get({ url: `/${repo}/-/releases/latest` });
+  }
+
+  /**
+   * 通过 tag 查询指定 release，包含附件信息
+   * @param repo 仓库路径
+   * @param tag 标签名称
+   */
+  getByTag(repo: string, tag: string): Promise<Result<ReleaseItem>> {
+    return this.get({ url: `/${repo}/-/releases/tags/${tag}` });
+  }
+
+  /**
+   * 根据 id 查询指定 release，包含附件信息
+   * @param repo 仓库路径
+   * @param releaseId 版本唯一标识符
+   */
+  getById(repo: string, releaseId: string): Promise<Result<ReleaseItem>> {
+    return this.get({ url: `/${repo}/-/releases/${releaseId}` });
+  }
+
+  /**
+   * 更新 release
+   * @param repo 仓库路径
+   * @param releaseId 版本唯一标识符
+   * @param data 更新表单
+   */
+  update(repo: string, releaseId: string, data: PatchReleaseForm): Promise<Result<any>> {
+    return this.patch({ url: `/${repo}/-/releases/${releaseId}`, data });
+  }
+
+  /**
+   * 删除指定的 release
+   * @param repo 仓库路径
+   * @param releaseId 版本唯一标识符
+   */
+  deleteRelease(repo: string, releaseId: string): Promise<Result<any>> {
+    return this.delete({ url: `/${repo}/-/releases/${releaseId}` });
+  }
+
+  /**
+   * 获取 release 附件上传 URL
+   * @param repo 仓库路径
+   * @param releaseId 版本唯一标识符
+   * @param data 附件上传表单
+   */
+  getAssetUploadURL(repo: string, releaseId: string, data: PostReleaseAssetUploadURLForm): Promise<Result<ReleaseAssetUploadURL>> {
+    return this.post({ url: `/${repo}/-/releases/${releaseId}/asset-upload-url`, data });
+  }
+
+  /**
+   * 确认 release 附件上传完成
+   * @param repo 仓库路径
+   * @param releaseId 版本唯一标识符
+   * @param uploadToken verify_url 字段提取的 upload_token
+   * @param assetPath verify_url 字段提取的 asset_path
+   * @param ttl 附件保持的天数（0 表示永久，最大 180）
+   */
+  confirmAssetUpload(repo: string, releaseId: string, uploadToken: string, assetPath: string, ttl?: number): Promise<Result<any>> {
+    const params = ttl !== undefined ? { ttl: String(ttl) } : undefined;
+    return this.post({ url: `/${repo}/-/releases/${releaseId}/asset-upload-confirmation/${uploadToken}/${assetPath}`, params });
+  }
+  async verifyUrlAsstetupload(url: string): Promise<Result<any>> {
+    return this.post({ url: url })
+  }
+
+  /**
+   * 查询指定的 release 附件
+   * @param repo 仓库路径
+   * @param releaseId 版本唯一标识符
+   * @param assetId 附件唯一标识符
+   */
+  getAsset(repo: string, releaseId: string, assetId: string): Promise<Result<ReleaseAsset>> {
+    return this.get({ url: `/${repo}/-/releases/${releaseId}/assets/${assetId}` });
+  }
+
+  /**
+   * 删除指定的 release 附件
+   * @param repo 仓库路径
+   * @param releaseId 版本唯一标识符
+   * @param assetId 附件唯一标识符
+   */
+  deleteAsset(repo: string, releaseId: string, assetId: string): Promise<Result<any>> {
+    return this.delete({ url: `/${repo}/-/releases/${releaseId}/assets/${assetId}` });
+  }
+
+  /**
+   * 获取 release 附件下载地址（302 重定向）
+   * @param repo 仓库路径
+   * @param tag 标签名称
+   * @param filename 文件名称
+   * @param share 是否生成可分享的下载地址（有效期 12 小时，最多下载 10 次）
+   */
+  getAssetDownloadURL(repo: string, tag: string, filename: string, share?: boolean): string {
+    const base = `${this.baseURL}/${repo}/-/releases/download/${tag}/${filename}`;
+    return share ? `${base}?share=true` : base;
+  }
+}

package/src/release/upload-release.ts

@@ -0,0 +1,132 @@
+import fs from 'node:fs';
+import dayjs from 'dayjs';
+import { CNB, ReleaseItem } from '../index.ts';
+import { CustomError } from '@kevisual/router';
+import { getFileSize, upload } from '@/upload/upload-base.ts';
+
+type FileItemFile = {
+  type: 'file',
+  /**
+   * 文件绝对路径
+   */
+  filepath: string;
+  name: string
+}
+type FileItemContent = {
+  type: 'content',
+  content: string | Buffer;
+  name: string
+}
+type FileItem = FileItemFile | FileItemContent;
+
+type ReleaseUploadOpts = {
+  files: FileItem[]
+  cnb: CNB
+  repo: string;
+  version?: string
+}
+export const createBodyByFileItem = (files: FileItem[]) => {
+  const createdAt = dayjs().format('YYYY-MM-DD HH:mm:ss');
+  const summary = `创建时间：${createdAt}，文件数量：${files.length}`;
+  const header = '| name | type |\n| --- | --- |';
+  const rows = files.map(f => `| ${f.name} | ${f.type} |`).join('\n');
+  const content = `${summary}\n\n${header}\n${rows}`;
+  return content;
+}
+export const uploadReleaseFiles = async (opts: ReleaseUploadOpts) => {
+  // 第一步, 获取最近 10 个，看看是否存在已有版本，存在，则获取 id；
+  const cnb = opts.cnb;
+  const repo = opts.repo;
+  const version = opts.version || '1.0.0';
+  const files = opts.files || []
+  let body = createBodyByFileItem(files)
+  const release = await getReleases({ cnb, version, repo, body });
+  if (!release) {
+    throw new CustomError({ code: 500, message: 'release id 不存在' })
+  }
+  const releaseId = release?.id;
+  type UploadResult = {
+    name: string;
+    uploadSuccess: boolean;
+    message?: string;
+  }
+  let result: UploadResult[] = [];
+  for (const file of files) {
+    try {
+      let size = 0;
+      let _fileContent: string | Buffer | File;
+      if (file.type === 'file') {
+        const stat = fs.statSync(file.filepath);
+        size = stat.size;
+        _fileContent = fs.createReadStream(file.filepath) as unknown as File;
+      } else {
+        size = getFileSize(file.content)
+        _fileContent = file.content as unknown as string;
+      }
+      const res = await cnb.release.getAssetUploadURL(repo, releaseId, {
+        asset_name: file.name,
+        size: size,
+        overwrite: false
+      })
+      const uploadUrl = res.data?.upload_url || '';
+      const verifyUrl = res.data?.verify_url || '';
+      const uploadRes = await upload({ url: uploadUrl, file: _fileContent })
+      const verifyRes = await cnb.release.verifyUrlAsstetupload(verifyUrl);
+      result.push({
+        name: file.name,
+        uploadSuccess: uploadRes.code === 200 && verifyRes.code === 200,
+      })
+    } catch (e) {
+      console.error('error:', file.name, e)
+      result.push({
+        name: file.name,
+        uploadSuccess: false,
+        message: e.message || '上传失败'
+      })
+      continue;
+    }
+  }
+  return result;
+}
+
+
+
+const getReleases = async (opts: { cnb: CNB, version?: string, repo: string, body?: string }) => {
+  const cnb = opts.cnb;
+  const repo = opts.repo;
+  const version = opts.version || '1.0.0';
+  const body = opts?.body ?? '自动部署的前端页面'
+  const res = await cnb.release.list(repo, { page: 1, page_size: 10 });
+  let releases: ReleaseItem[] = []
+  if (res.code === 200) {
+    releases = res.data || [];
+  }
+  const exist = releases.find(r => r.tag_name === version);
+  if (exist) {
+    if (exist.body !== body) {
+      await cnb.release.update(repo, exist.id, {
+        body
+      })
+    }
+    return exist;
+  }
+  // 不存在创建一个
+  const commistRes = await cnb.repo.getLastCommit(repo);
+  let sha = '';
+  if (commistRes.code === 200) {
+    sha = commistRes.data?.sha || '';
+  }
+  const releaseRes = await cnb.release.create(repo, {
+    tag_name: version,
+    name: version,
+    target_commitish: sha,
+    body: body,
+    draft: false,
+    prerelease: false,
+    make_latest: "true",
+  });
+  if (releaseRes.code === 200) {
+    return releaseRes.data;
+  }
+  return null;
+}

package/src/repo/index.ts

@@ -37,13 +37,14 @@ export class Repo extends CNBCore {
    * @returns 
    */
   async createCommit(repo: string, data: CreateCommitData): Promise<any> {
-    const commitList = await this.getCommitList(repo, {
+    const res = await this.getCommitList(repo, {
       page: 1,
       page_size: 1,
-    }, { useOrigin: true }).catch((err) => {
-      // console.error("Error fetching commit list:", err);
-      return []
     });
+    let commitList: CommitInfo[] = [];
+    if (res.code === 200) {
+      commitList = res.data;
+    }
     const preCommitSha = commitList.length > 0 ? commitList[0].sha : undefined;
     if (!data.parent_commit_sha && preCommitSha) {
       data.parent_commit_sha = preCommitSha;
@@ -89,7 +90,19 @@ export class Repo extends CNBCore {
     const url = `/${repo}/-/upload/files`
     return this.post({ url, data });
   }
-  getCommitList(repo: string, params: { author?: string, commiter?: string, page?: number, page_size?: number, sha?: string, since?: string, until?: string }, opts?: RequestOptions): Promise<any> {
+  async getLastCommit(repo: string, opts?: RequestOptions): Promise<Result<CommitInfo>> {
+    const res = await this.getCommitList(repo, { page: 1, page_size: 1 }, opts);
+    let commitList: CommitInfo[] = [];
+    if (res.code === 200) {
+      commitList = res.data;
+    }
+    return {
+      code: res.code,
+      message: res.message,
+      data: commitList.length > 0 ? commitList[0] : null,
+    }
+  }
+  getCommitList(repo: string, params?: { author?: string, commiter?: string, page?: number, page_size?: number, sha?: string, since?: string, until?: string }, opts?: RequestOptions): Promise<Result<CommitInfo[]>> {
     const url = `/${repo}/-/git/commits`;
     return this.get({ url, params, ...opts });
   }
@@ -196,4 +209,41 @@ export type RepoItem = {
   star_time: string;
   pinned: boolean;
   pinned_time: string;
+}
+
+type CommitInfo = {
+  sha: string;
+  commit: {
+    author?: {
+      name: string;
+      email: string;
+      date: string;
+    },
+    committer: {
+      name: string;
+      email: string;
+      date: string;
+    },
+    message: string;
+    tree: { sha: string }
+    comment_count: number;
+    verification: {
+      verified: boolean;
+      reason: string;
+      signature: string;
+      payload: string;
+      verified_at: string;
+    }
+  },
+  author: {
+    nickname: string;
+    email: string;
+    is_npc: boolean
+  },
+  committer: {
+    nickname: string;
+    email: string;
+    is_npc: boolean
+  },
+  parents: { sha: string }[];
 }

package/src/upload/upload-base.ts

@@ -0,0 +1,95 @@
+import FormData from 'form-data';
+
+export const DefaultIgnore = [
+  'node_modules/**/*',
+  '.git/**/*',
+  '.DS_Store',
+  '.pnpm-store/**/*'
+]
+export const handleResponse = async (err: any, res: any, opts?: { noResponse: boolean }) => {
+  const noResponse = opts?.noResponse || false;
+  return new Promise((resolve) => {
+    if (err) {
+      console.error('Upload failed:', err);
+      resolve({ code: 500, message: err });
+      return;
+    }
+    // 处理服务器响应
+    let body = '';
+    res.on('data', (chunk) => {
+      body += chunk;
+    });
+    res.on('end', () => {
+      if (noResponse) {
+        resolve({ code: 200, data: { status: res.statusCode }, message: res.statusMessage });
+        return;
+      }
+      try {
+        const res = JSON.parse(body);
+        resolve(res);
+      } catch (e) {
+        console.error('Failed to parse response:', e, body);
+        resolve({ code: 500, message: body });
+      }
+    });
+  });
+};
+export const getFormParams = (opts: UploadOptions, headers: any): FormData.SubmitOptions => {
+  const url = new URL(opts.url);
+  const value: FormData.SubmitOptions = {
+    path: url.pathname + url.search,
+    host: url.hostname,
+    method: 'POST',
+    protocol: url.protocol === 'https:' ? 'https:' : 'http:',
+    port: url.port || (url.protocol === 'https:' ? 443 : 80),
+    headers: {
+      ...headers,
+    },
+  };
+  return value;
+};
+type UploadOptions = {
+  url: string | URL;
+  file?: string | Buffer | File;
+  form?: FormData;
+};
+/**
+ * 单个文件上传
+ * @param opts
+ * @param opts.url 上传地址
+ * @param opts.file 文件路径或Buffer
+ * @param opts.form form对象
+ * @returns
+ */
+export const upload = (opts: UploadOptions): Promise<{ code?: number; message?: string;[key: string]: any }> => {
+  const form = opts?.form || new FormData();
+  if (!opts.form) {
+    let value: any;
+    let type = 'string';
+    if (typeof opts.file === 'string') {
+      value = Buffer.from(opts.file);
+    } else {
+      type = 'buffer';
+      value = opts.file;
+    }
+    form.append('file', value);
+    // const fileSize = Buffer.byteLength(value);
+  }
+  const headers = form.getHeaders();
+  return new Promise((resolve) => {
+    form.submit(getFormParams(opts, headers), (err, res) => {
+      handleResponse(err, res, { noResponse: true }).then(resolve);
+    });
+  });
+};
+
+export const getFileSize = (file: string | Buffer | File): number => {
+  if (typeof file === 'string') {
+    return Buffer.byteLength(file);
+  } else if (file instanceof Buffer) {
+    return file.length;
+  } else if (file instanceof File) {
+    return file.size;
+  }
+  return 0;
+}

package/src/workspace/keep-file-live.ts

@@ -21,7 +21,7 @@ const keepAliveFilePath = path.join(baseDir, 'keepAliveCache.json');
 
 export const runLive = (filePath: string, pm2Name: string) => {
   // 使用 npx 运行命令
-  const cmdArgs = `cnb live -c ${filePath}`;
+  const cmdArgs = `live -c ${filePath}`;
 
   // 先停止已存在的同名 pm2 进程
   const stopCmd = `pm2 delete ${pm2Name} 2>/dev/null || true`;
@@ -33,14 +33,14 @@ export const runLive = (filePath: string, pm2Name: string) => {
   }
 
   // 使用pm2启动
-  const pm2Cmd = `pm2 start ev --name ${pm2Name} --no-autorestart -- ${cmdArgs}`;
+  const pm2Cmd = `pm2 start cloud-live --name ${pm2Name} --no-autorestart -- ${cmdArgs}`;
   console.log('执行命令:', pm2Cmd);
   try {
     const result = execSync(pm2Cmd, { stdio: 'pipe', encoding: 'utf8' });
     console.log(result);
   } catch (error) {
     console.error("状态码:", error.status);
-    console.error("错误详情:", error.stderr.toString()); // 这里会显示 ev 命令报的具体错误
+    console.error("错误详情:", error.stderr.toString()); // 这里会显示 cloud-live 命令报的具体错误
   }
 }