@kevisual/cnb 0.0.1 → 0.0.2

package/agent/app.ts

@@ -0,0 +1,14 @@
+import { QueryRouterServer as App } from '@kevisual/router'
+import { useContextKey } from '@kevisual/context'
+import { useConfig } from '@kevisual/use-config'
+import { CNB } from '../src/index.ts';
+import { nanoid } from 'nanoid';
+
+export const config = useConfig()
+export const cnb = useContextKey<CNB>('cnb', () => {
+  return new CNB({ token: config.CNB_TOKEN, cookie: config.CNB_COOKIE, group: config.CNB_GROUP });
+})
+export const appId = nanoid();
+export const app = useContextKey<App>('app', () => {
+  return new App()
+})

package/agent/index.ts

@@ -0,0 +1,2 @@
+export * from './app.ts'
+import './routes/index.ts'

package/agent/opencode-plugin.ts

@@ -0,0 +1,35 @@
+import { tool } from "@opencode-ai/plugin/tool"
+import { type Plugin } from "@opencode-ai/plugin"
+import { app, cnb, appId } from './index.ts';
+
+// opencode run "请使用 cnb-login-verify 工具验证登录信信息,检查cookie"
+export const CnbPlugin: Plugin = async ({ project, client, $, directory, worktree }) => {
+  return {
+    'tool': {
+      "cnb-login-verify": {
+        name: "CNB 登录验证信息",
+        description: "验证 CNB 登录信息是否有效",
+        args: {
+          checkToken: tool.schema.boolean().describe("是否检查 Token 的有效性").default(true),
+          checkCookie: tool.schema.boolean().describe("是否检查 Cookie 的有效性").default(false),
+        },
+        async execute(args) {
+          const res = await app.run({
+            path: 'cnb',
+            key: 'user-check',
+            payload: {
+              ...args
+            }
+          }, { appId });
+          if (res.code === 200) {
+            return res.data?.output;
+          }
+          return '无法获取登录状态，请检查配置。';
+        },
+      },
+    },
+    'tool.execute.before': async (opts) => {
+      // console.log('CnbPlugin: tool.execute.before', opts.tool);
+    }
+  }
+}

package/agent/routes/cnb-env/index.ts

@@ -0,0 +1 @@
+// 根据环境变量获取当前的 cnb 启动环境

package/agent/routes/index.ts

@@ -0,0 +1,36 @@
+import { app, appId } from '@/agent/app.ts';
+import './user/check.ts'
+
+const checkAppId = (ctx: any, appId: string) => {
+  const _appId = ctx?.appId;
+  if (_appId) {
+    if (_appId !== appId) {
+      ctx.throw(403, 'Invalid App ID');
+    }
+    return true;
+  }
+  return false;
+}
+
+if (!app.hasRoute('auth')) {
+  app.route({
+    id: 'auth',
+    path: 'auth',
+  }).define(async (ctx) => {
+    // ctx.body = 'Auth Route';
+    if (checkAppId(ctx, appId)) {
+      return;
+    }
+  }).addTo(app);
+
+  app.route({
+    id: 'admin-auth',
+    path: 'admin-auth',
+    middleware: ['auth'],
+  }).define(async (ctx) => {
+    // ctx.body = 'Admin Auth Route';
+    if (checkAppId(ctx, appId)) {
+      return;
+    }
+  }).addTo(app);
+}

package/agent/routes/repo/index.ts

@@ -0,0 +1,53 @@
+import { app, cnb } from '@/agent/app.ts';
+
+app.route({
+  path: 'cnb',
+  key: 'repo-create',
+  description: '创建代码仓库, 参数name, visibility, description',
+  middleware: ['auth'],
+  metadata: {
+    tags: ['opencode']
+  }
+}).define(async (ctx) => {
+  const name = ctx.query?.name;
+  const visibility = ctx.query?.visibility ?? 'private';
+  const description = ctx.query?.description ?? '';
+
+  if (!name) {
+    ctx.throw(400, '缺少参数 name');
+  }
+
+  const res = await cnb.repo.createRepo(cnb.group, {
+    name,
+    visibility,
+    description,
+  });
+  ctx.forward(res);
+}).addTo(app);
+
+app.route({
+  path: 'cnb',
+  key: 'repo-create-file',
+  description: '在代码仓库中创建文件, 参数repoName, path, content, encoding',
+  middleware: ['auth'],
+  metadata: {
+    tags: ['opencode']
+  }
+}).define(async (ctx) => {
+  const repoName = ctx.query?.repoName;
+  const path = ctx.query?.path;
+  const content = ctx.query?.content;
+  const encoding = ctx.query?.encoding ?? 'raw';
+
+  if (!repoName || !path || !content) {
+    ctx.throw(400, '缺少参数 repoName, path 或 content');
+  }
+
+  const res = await cnb.repo.createCommit(repoName, {
+    message: `添加文件 ${path} 通过 API `,
+    files: [
+      { path, content, encoding },
+    ],
+  });
+  ctx.forward(res);
+}).addTo(app);

package/agent/routes/user/check.ts

@@ -0,0 +1,33 @@
+import { app, cnb } from '@/agent/app.ts';
+
+
+app.route({
+  path: 'cnb',
+  key: 'user-check',
+  description: '检查用户登录状态，参数checkToken,default true; checkCookie, default false',
+  middleware: ['auth'],
+  metadata: {
+    tags: ['opencode']
+  }
+}).define(async (ctx) => {
+  const checkToken = ctx.query?.checkToken ?? true;
+  const checkCookie = ctx.query?.checkCookie ?? false;
+  let output = '';
+  if (checkToken) {
+    const res = await cnb.user.getUser();
+    if (res?.code !== 200) {
+      output += `Token 无效，请检查 CNB_TOKEN 配置。\n`;
+    } else {
+      output += `Token 有效，Token用户昵称：${res.data?.nickname}\n`;
+    }
+  }
+  if (checkCookie) {
+    const res = await cnb.user.getCurrentUser();
+    if (res?.code !== 200) {
+      output += `Cookie 无效，请检查 CNB_COOKIE 配置。\n`;
+    } else {
+      output += `Cookie 有效，当前Cookie用户：${res.data?.nickname}\n`;
+    }
+  }
+  ctx.body = { output };
+}).addTo(app);

package/agent/routes/workspace/index.ts

@@ -0,0 +1,23 @@
+import { app, cnb } from '@/agent/app.ts';
+
+app.route({
+  path: 'cnb',
+  key: 'start-workspace',
+  description: '启动开发工作空间, 参数 repo',
+  middleware: ['auth'],
+  metadata: {
+    tags: ['opencode']
+  }
+}).define(async (ctx) => {
+  const repo = ctx.query?.repo;
+  const branch = ctx.query?.branch;
+  const ref = ctx.query?.ref;
+  if (!repo) {
+    ctx.throw(400, '缺少参数 repo');
+  }
+  const res = await cnb.workspace.startWorkspace(repo, {
+    branch,
+    ref
+  });
+  ctx.forward(res);
+}).addTo(app);

package/package.json

@@ -1,27 +1,51 @@
 {
   "name": "@kevisual/cnb",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "",
-  "main": "index.js",
+  "main": "mod.ts",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "code": "opencode web --hostname 0.0.0.0"
   },
   "keywords": [],
   "files": [
     "src",
     "mod.ts",
-    "agents"
+    "agent"
   ],
   "author": "abearxiong <xiongxiao@xiongxiao.me> (https://www.xiongxiao.me)",
   "license": "MIT",
-  "packageManager": "pnpm@10.25.0",
+  "packageManager": "pnpm@10.28.0",
   "type": "module",
   "devDependencies": {
-    "@types/bun": "^1.3.4",
-    "@types/node": "^25.0.2",
+    "@kevisual/context": "^0.0.4",
+    "@kevisual/types": "^0.0.10",
+    "@opencode-ai/plugin": "^1.1.13",
+    "@types/bun": "^1.3.5",
+    "@types/node": "^25.0.6",
     "dotenv": "^17.2.3"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./mod.ts",
+      "types": "./mod.d.ts"
+    },
+    "./agent": {
+      "import": "./agent/index.ts",
+      "types": "./agent/index.d.ts"
+    },
+    "./opencode": {
+      "import": "./agent/opencode-plugin.ts",
+      "types": "./agent/opencode-plugin.d.ts"
+    }
+  },
+  "dependencies": {
+    "@kevisual/query": "^0.0.35",
+    "@kevisual/router": "^0.0.52",
+    "@kevisual/use-config": "^1.0.24",
+    "es-toolkit": "^1.43.0",
+    "nanoid": "^5.1.6"
   }
 }

package/readme.md

@@ -2,4 +2,16 @@
 
 ## 简介
 
-纯粹调用api的模式去使用cnb.cool，自动化方案。
+纯粹调用api的模式去使用cnb.cool，自动化方案。
+
+## workspace
+
+工作区快速打开，编辑代码，然后运行和执行
+
+## 代码仓库
+
+快速创建代码仓库，然后打开工作区，然后运行
+
+## kevisual assistant app
+
+借用模块进行开发项目

package/src/ai/index.ts

@@ -1,16 +1,12 @@
 import { CNBCore, CNBCoreOptions, RequestOptions, Result } from "../cnb-core.ts";
-type AiOptions = CNBCoreOptions<{
-  group?: string;
-}>
+
 class AiBase extends CNBCore {
   group: string;
-  constructor(options: AiOptions) {
+  constructor(options: CNBCoreOptions) {
     super({ token: options.token, cookie: options.cookie });
-    this.group = options.group || '';
   }
   autoPr(repo: string, data: { body: string, branch?: string, title: string }): Promise<Result<any>> {
-    const group = this.group || '';
-    const url = `/${group}/${repo}/-/build/ai/auto-pr`;
+    const url = `/${repo}/-/build/ai/auto-pr`;
     const postData = {
       ...data,
       branch: data.branch || 'refs/heads/main',

package/src/build/index.ts

@@ -0,0 +1,47 @@
+import { CNBCore, CNBCoreOptions, RequestOptions, Result } from "../cnb-core.ts";
+
+
+export class Build extends CNBCore {
+  constructor(options: CNBCoreOptions ) {
+    super({ token: options.token, cookie: options.cookie });
+  }
+  startBuild(repo: string, data: StartBuildData): Promise<any> {
+    const url = `/${repo}/-/build/start`;
+    let postData: StartBuildData = {
+      ...data,
+      branch: data.branch || 'main',
+    };
+    return this.post({ url, data: postData });
+  }
+}
+
+type StartBuildData = {
+  /**
+   * 触发分支，默认为主分支
+   */
+  branch?: string;
+  /**
+   * 指定配置文件内容，yaml 格式
+   */
+  config?: string;
+  /**
+   * 环境变量，对象格式
+   */
+  env?: Record<string, string>;
+  /**
+   * 事件名，必须是 api_trigger 或以 api_trigger_ 开头，默认为 api_trigger
+   */
+  event?: string;
+  /**
+   * commit id ，优先级比 tag 高，默认为分支最新提交记录
+   */
+  sha?: string;
+  /**
+   * 是否等待构建正式触发，为false时会立刻返回 sn 和 buildLogUrl
+   */
+  sync?: string;
+  /**
+   * 触发 tag，优先级比 branch 高
+   */
+  tag?: string;
+}

package/src/cnb-core.ts

@@ -1,6 +1,10 @@
 export type CNBCoreOptions<T = {}> = {
   token: string;
+  /**
+   * 对 cnb 界面操作定制模块功能时需要传入 cookie
+   */
   cookie?: string;
+  cnb?: CNBCore;
 } & T;
 
 export type RequestOptions = {
@@ -15,11 +19,19 @@ export type RequestOptions = {
 };
 export class CNBCore {
   baseURL = 'https://api.cnb.cool';
-  token: string;
-  cookie?: string;
+  public token: string;
+  public cookie?: string;
   constructor(options: CNBCoreOptions) {
     this.token = options.token;
     this.cookie = options.cookie;
+    if (options?.cnb) {
+      if (!options.token) {
+        this.token = options.cnb.token;
+      }
+      if (!options.cookie) {
+        this.cookie = options.cnb.cookie;
+      }
+    }
   }
 
   async request({ url, method = 'GET', data, params, headers, body, useCookie, useOrigin }: RequestOptions): Promise<any> {

package/src/index.ts

@@ -3,23 +3,64 @@ import { Workspace } from "./workspace.ts";
 import { KnowledgeBase } from "./knowledge/index.ts";
 import { Repo } from "./repo/index.ts";
 import { User } from "./user/index.ts";
+import { Build } from "./build/index.ts";
+import { Issue } from "./issue/index.ts";
+import { Mission } from "./mission/index.ts";
+import { AiBase } from "./ai/index.ts";
 
-type CNBOptions = CNBCoreOptions<{}>;
+type CNBOptions = CNBCoreOptions<{
+  group?: string;
+}>;
 
 export class CNB extends CNBCore {
   workspace!: Workspace;
   knowledgeBase!: KnowledgeBase;
   repo!: Repo;
   user!: User;
+  build!: Build;
+  issue!: Issue;
+  mission!: Mission;
+  ai!: AiBase;
+  group!: string;
   constructor(options: CNBOptions) {
-    super({ token: options.token, cookie: options.cookie });
+    super({ token: options.token, cookie: options.cookie, cnb: options.cnb });
     this.init(options);
   }
-  init(options: CNBOptions) {
+  init(cnbOptions?: CNBOptions) {
+    const token = this.token;
+    const cookie = this.cookie;
+    const options = { token, cookie };
     this.workspace = new Workspace(options.token);
+    const group = cnbOptions?.group || '';
     this.knowledgeBase = new KnowledgeBase({ token: options.token, cookie: options.cookie });
     this.repo = new Repo({ token: options.token, cookie: options.cookie });
     this.user = new User({ token: options.token, cookie: options.cookie });
+    this.build = new Build({ token: options.token, cookie: options.cookie });
+    this.issue = new Issue({ token: options.token, cookie: options.cookie });
+    this.mission = new Mission({ token: options.token, cookie: options.cookie });
+    this.ai = new AiBase({ token: options.token, cookie: options.cookie });
+    this.group = group;
+  }
+  setGroup(group: string) {
+    this.group = group;
+  }
+  setToken(token: string) {
+    this.token = token;
+    this.knowledgeBase.token = token;
+    this.repo.token = token;
+    this.user.token = token;
+    this.build.token = token;
+    this.issue.token = token;
+    this.mission.token = token;
+  }
+  setCookie(cookie: string) {
+    this.cookie = cookie;
+    this.knowledgeBase.cookie = cookie;
+    this.repo.cookie = cookie;
+    this.user.cookie = cookie;
+    this.build.cookie = cookie;
+    this.issue.cookie = cookie;
+    this.mission.cookie = cookie;
   }
 }
 
@@ -27,3 +68,8 @@ export * from './workspace.ts'
 export * from './cnb-core.ts'
 export * from './knowledge/index.ts'
 export * from './repo/index.ts'
+export * from './user/index.ts'
+export * from './build/index.ts'
+export * from './issue/index.ts'
+export * from './mission/index.ts'
+export * from './ai/index.ts'

package/src/issue/index.ts

@@ -0,0 +1,121 @@
+import { CNBCore, CNBCoreOptions, RequestOptions, Result } from "../cnb-core.ts";
+
+export type IssueAssignee = {
+  nickname: string;
+  username: string;
+};
+
+export type IssueLabel = {
+  color: string;
+  description: string;
+  id: string;
+  name: string;
+};
+export type IssueState = 'open' | 'closed';
+
+export type IssueAuthor = {
+  name: string;
+  body: string;
+  comment_count: number;
+  created_at: string;
+  ended_at: string;
+};
+
+export type IssueItem = {
+  assignees: IssueAssignee[];
+  author: IssueAuthor;
+  labels: IssueLabel[];
+
+  last_acted_at: string;
+  number: string;
+  priority: string;
+  started_at: string;
+  state: string;
+  state_reason: string;
+  title: string;
+  updated_at: string;
+};
+export class Issue extends CNBCore {
+  constructor(options: CNBCoreOptions) {
+    super({ token: options.token, cookie: options.cookie });
+  }
+
+  createIssue(repo: string, data: Partial<IssueItem>): Promise<any> {
+    const url = `/${repo}/-/issues`;
+    let postData = {
+      ...data,
+    };
+    return this.post({ url, data: postData });
+  }
+  updateIssue(repo: string, issueNumber: string | number, data: Partial<IssueItem>): Promise<any> {
+    const url = `/${repo}/-/issues/${issueNumber}`;
+    let postData = {
+      ...data,
+    };
+    return this.patch({ url, data: postData });
+  }
+  getItem(repo: string, issueNumber: string | number): Promise<Result<IssueItem>> {
+    const url = `/${repo}/-/issues/${issueNumber}`;
+    return this.get({
+      url,
+      headers: {
+        'Accept': 'application/vnd.cnb.api+json',
+      }
+    });
+  }
+
+  getList(repo: string, params?: Partial<GetListParams>): Promise<Result<IssueItem[]>> {
+    const url = `/${repo}/-/issues`;
+    return this.get({
+      url,
+      params,
+      headers: {
+        'Accept': 'application/vnd.cnb.api+json',
+      }
+    });
+  }
+  getCommentList(repo: string, issueNumber: string | number): Promise<any> {
+    const url = `/${repo}/-/issues/${issueNumber}/comments`;
+    return this.get({
+      url,
+    });
+  }
+  setIssueProperty(repo: string, issueNumber: string | number, properties: { [key: string]: any }[]): Promise<any> {
+    const url = `/${repo}/-/issues/${issueNumber}/property`;
+    let postData = {
+      properties: properties,
+    };
+    return this.post({ url, data: postData });
+  }
+}
+
+type GetListParams = {
+  /** 问题指派人名称，例如: 张三, 李四, -; - 表示不指派给任何人 */
+  assignees?: string;
+  /** 问题作者名称，例如: 张三, 李四 */
+  authors?: string;
+  /** 问题关闭时间过滤-开始，例如: 2022-01-31 */
+  close_time_begin?: string;
+  /** 问题关闭时间过滤-结束，例如: 2022-01-31 */
+  close_time_end?: string;
+  /** 问题搜索关键词 */
+  keyword?: string;
+  /** 问题标签，例如: git, bug, feature */
+  labels?: string;
+  /** 问题标签操作符，例如: contains_any, contains_all，默认: contains_any */
+  labels_operator?: string;
+  /** 问题排序，例如: created_at, -updated_at, reference_count；'-' 前缀表示降序 */
+  order_by?: string;
+  /** 分页页码。如果值小于 1，将自动调整为 1，默认: 1 */
+  page?: number;
+  /** 分页每页大小。如果值大于 100，将自动调整为 100，默认: 30 */
+  page_size?: number;
+  /** 问题优先级，例如: -1P, -2P, P0, P1, P2, P3 */
+  priority?: string;
+  /** 问题状态：open 或 closed */
+  state?: string;
+  /** 问题更新时间过滤-开始，例如: 2022-01-31 */
+  updated_time_begin?: string;
+  /** 问题更新时间过滤-结束，例如: 2022-01-31 */
+  updated_time_end?: string;
+}

package/src/knowledge/index.ts

@@ -1,13 +1,8 @@
-import { CNBCore, CNBCoreOptions, RequestOptions, Result } from "../cnb-core.ts";
+import { CNBCore, CNBCoreOptions, Result } from "../cnb-core.ts";
 
-type RepoOptions = CNBCoreOptions<{
-  group?: string;
-}>
 export class KnowledgeBase extends CNBCore {
-  group: string;
-  constructor(options: RepoOptions) {
+  constructor(options: CNBCoreOptions) {
     super({ token: options.token, cookie: options.cookie });
-    this.group = options.group || '';
   }
 
   queryKnowledgeBase(repo: string, data: {
@@ -16,28 +11,24 @@ export class KnowledgeBase extends CNBCore {
     top_k?: number,
     metadata_filtering_conditions?: MetadataFilteringConditions
   }): Promise<any> {
-    const group = this.group || '';
-    const url = `/${group}/${repo}/-/knowledge/query`;
+    const url = `/${repo}/-/knowledge/base/query`;
     let postData = {
       query: data.query,
     };
     return this.post({ url, data: postData });
   }
   getEmbeddingModels(repo: string): Promise<Result<Array<{ name: string, dimensions: number }>>> {
-    const group = this.group || '';
-    const url = `/${group}/${repo}/-/knowledge/embedding/models`;
+    const url = `/${repo}/-/knowledge/embedding/models`;
     // bg3-m3 1024
     // hunyuan 1024
     return this.get({ url });
   }
   getBase(repo: string): Promise<Result<any>> {
-    const group = this.group || '';
-    const url = `/${group}/${repo}/-/knowledge/base`;
+    const url = `/${repo}/-/knowledge/base`;
     return this.get({ url });
   }
   deleteBase(repo: string): Promise<Result<any>> {
-    const group = this.group || '';
-    const url = `/${group}/${repo}/-/knowledge/base`;
+    const url = `/${repo}/-/knowledge/base`;
     return this.request({ url, method: 'DELETE' });
   }
 }

package/src/mission/index.ts

@@ -0,0 +1,190 @@
+import { CNBCore, CNBCoreOptions, RequestOptions, Result } from "../cnb-core.ts";
+
+export class Mission extends CNBCore {
+  constructor(options: CNBCoreOptions) {
+    super({ token: options.token, cookie: options.cookie });
+  }
+
+  /**
+   * 查询组织下用户有权限查看的任务集
+   * @param params 查询参数
+   * @returns 任务集列表
+   */
+  getMissions(group: string, params?: GetMissionsParams): Promise<Result<Missions4User[]>> {
+    const url = `/${group}/-/missions`;
+    return this.get({
+      url,
+      params: {
+        page: 1,
+        page_size: 10,
+        ...params,
+      },
+    });
+  }
+
+  /**
+   * 创建任务集
+   * @param data 创建任务集数据
+   * @returns 创建结果
+   */
+  createMission(repo: string, data: CreateMissionData): Promise<Result<any>> {
+    const url = `/${repo}/-/missions`;
+    return this.post({ url, data });
+  }
+
+  /**
+   * 删除任务集
+   * @param mission 任务集路径
+   * @param identityTicket 微信身份验证票据
+   * @returns 删除结果
+   */
+  deleteMission(mission: string, identityTicket?: string): Promise<Result<any>> {
+    const url = `/${mission}`;
+    return this.delete({
+      url,
+      headers: identityTicket ? { 'x-cnb-identity-ticket': identityTicket } : undefined,
+    });
+  }
+
+  /**
+   * 获取任务集视图配置
+   * @param mission 任务集 slug
+   * @param viewId 视图 ID
+   * @returns 视图配置
+   */
+  getMissionViewConfig(mission: string, viewId: string): Promise<Result<MissionViewConfig>> {
+    const url = `/${mission}/-/mission/view`;
+    return this.get({
+      url,
+      params: { id: viewId },
+    });
+  }
+
+  /**
+   * 设置任务集视图配置
+   * @param mission 任务集 slug
+   * @param config 视图配置
+   * @returns 设置结果
+   */
+  setMissionViewConfig(mission: string, config: MissionViewConfig): Promise<Result<any>> {
+    const url = `/${mission}/-/mission/view`;
+    return this.post({ url, data: config });
+  }
+
+  /**
+   * 获取任务集视图列表
+   * @param mission 任务集 slug
+   * @returns 视图列表
+   */
+  getMissionViewList(mission: string): Promise<Result<MissionView[]>> {
+    const url = `/${mission}/-/mission/view-list`;
+    return this.get({
+      url,
+      headers: {
+        'Accept': 'application/vnd.cnb.api+json',
+      }
+    });
+  }
+
+  /**
+   * 添加或修改任务集视图
+   * @param mission 任务集 slug
+   * @param view 视图数据
+   * @returns 操作结果
+   */
+  putMissionView(mission: string, view: MissionView): Promise<Result<any>> {
+    const url = `/${mission}/-/mission/view-list`;
+    return this.put({ url, data: view });
+  }
+
+  /**
+   * 排序任务集视图
+   * @param mission 任务集 slug
+   * @param data 排序数据
+   * @returns 操作结果
+   */
+  sortMissionViews(mission: string, data: MissionPostViewReq): Promise<Result<any>> {
+    const url = `/${mission}/-/mission/view-list`;
+    return this.post({ url, data });
+  }
+
+  /**
+   * 改变任务集可见性
+   * @param mission 任务集路径
+   * @param visibility 可见性 (Private 或 Public)
+   * @returns 操作结果
+   */
+  setVisibility(mission: string, visibility: 'Private' | 'Public'): Promise<Result<any>> {
+    const url = `/${mission}/-/settings/set_visibility`;
+    return this.post({
+      url,
+      params: { visibility },
+    });
+  }
+}
+
+// ==================== 类型定义 ====================
+
+type GetMissionsParams = {
+  page?: number;
+  page_size?: number;
+  filter_type?: 'private' | 'public';
+  order_by?: 'created_at' | 'name';
+  desc?: boolean;
+  descendant?: 'all' | 'sub' | 'grand';
+  search?: string;
+};
+
+type CreateMissionData = {
+  name: string;
+  description?: string;
+  visibility?: 'Private' | 'Public';
+};
+
+type Missions4User = {
+  id: string;
+  name: string;
+  slug_path: string;
+  description: string;
+  visibility: 'Private' | 'Public';
+  created_at: string;
+  updated_at: string;
+  web_url: string;
+};
+
+type MissionView = {
+  id: string;
+  name: string;
+  description?: string;
+  config?: MissionViewConfig;
+  created_at?: string;
+  updated_at?: string;
+};
+
+type MissionViewConfig = {
+  id: string;
+  name: string;
+  description?: string;
+  columns?: MissionViewColumn[];
+  filters?: MissionViewFilter[];
+  sort_by?: string;
+  sort_order?: 'asc' | 'desc';
+};
+
+type MissionViewColumn = {
+  key: string;
+  label: string;
+  width?: number;
+  visible?: boolean;
+  sortable?: boolean;
+};
+
+type MissionViewFilter = {
+  key: string;
+  operator?: 'eq' | 'ne' | 'contains' | 'gt' | 'lt' | 'gte' | 'lte';
+  value?: any;
+};
+
+type MissionPostViewReq = {
+  view_ids: string[];
+};

package/src/repo/index.ts

@@ -1,13 +1,8 @@
 import { CNBCore, CNBCoreOptions, RequestOptions, Result } from "../cnb-core.ts";
 
-type RepoOptions = CNBCoreOptions<{
-  group?: string;
-}>
 export class Repo extends CNBCore {
-  group: string;
-  constructor(options: RepoOptions) {
+  constructor(options: CNBCoreOptions) {
     super({ token: options.token, cookie: options.cookie });
-    this.group = options.group || '';
   }
   /**
    * 创建代码仓库
@@ -15,8 +10,7 @@ export class Repo extends CNBCore {
    * @param data 
    * @returns 
    */
-  createRepo(data: CreateRepoData): Promise<any> {
-    const group = this.group || '';
+  createRepo(group: string, data: CreateRepoData): Promise<any> {
     const url = `/${group}/-/repos`;
     let postData: CreateRepoData = {
       ...data,
@@ -28,7 +22,6 @@ export class Repo extends CNBCore {
     return this.post({ url, data: postData });
   }
   async createCommit(repo: string, data: CreateCommitData): Promise<any> {
-    const group = this.group || '';
     const commitList = await this.getCommitList(repo, {
       page: 1,
       page_size: 1,
@@ -40,7 +33,7 @@ export class Repo extends CNBCore {
     if (!data.parent_commit_sha && preCommitSha) {
       data.parent_commit_sha = preCommitSha;
     }
-    const url = `https://cnb.cool/${group}/${repo}/-/git/commits`;
+    const url = `https://cnb.cool/${repo}/-/git/commits`;
     const postData: CreateCommitData = {
       ...data,
       base_branch: data.base_branch || 'refs/heads/main',
@@ -56,8 +49,7 @@ export class Repo extends CNBCore {
     return this.post({ url, data: postData, useCookie: true, });
   }
   createBlobs(repo: string, data: { content: string, encoding?: 'utf-8' | 'base64' }): Promise<any> {
-    const group = this.group || '';
-    const url = `/${group}/${repo}/-/git/blobs`;
+    const url = `/${repo}/-/git/blobs`;
     const postData = {
       content: data.content,
       encoding: data.encoding || 'utf-8',
@@ -65,13 +57,11 @@ export class Repo extends CNBCore {
     return this.post({ url, data: postData });
   }
   uploadFiles(repo: string, data: { ext?: any, name?: string, path?: string, size?: number }): Promise<any> {
-    const group = this.group || '';
-    const url = `/${group}/${repo}/-/upload/files`
+    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> {
-    const group = this.group || '';
-    const url = `/${group}/${repo}/-/git/commits`;
+    const url = `/${repo}/-/git/commits`;
     return this.get({ url, params, ...opts });
   }
   getRepoList(params: {

package/src/user/index.ts

@@ -1,21 +1,29 @@
 import { CNBCore, CNBCoreOptions } from "../cnb-core.ts";
-
+import { Result } from "@kevisual/query";
 export class User extends CNBCore {
   constructor(options: CNBCoreOptions<{}>) {
     super({ token: options.token, cookie: options.cookie });
   }
 
   /**
-   * 获取当前用户信息
-   * @returns 
+   * 获取当前用户信息，使用 Cookie 认证
+   * @returns
    */
-  getCurrentUser(): Promise<any> {
+  getCurrentUser(): Promise<Result<UserInfo>> {
     const url = `https://cnb.cool/user`;
     return this.get({
       url,
       useCookie: true,
     });
   }
+  /**
+   * 使用 Token 获取用户信息
+   * @returns
+   */
+  getUser(): Promise<Result<UserInfo>> {
+    const url = '/user';
+    return this.get({ url });
+  }
   createAccessToken(data?: { description?: string, scope?: string }): Promise<AccessTokenResponse> {
     const scope = data?.scope || 'mission-manage:rw,mission-delete:rw,group-delete:rw,group-manage:rw,group-resource:rw,account-engage:rw,account-email:r,account-profile:rw,registry-delete:rw,registry-manage:rw,registry-package-delete:rw,registry-package:rw,repo-security:r,repo-delete:rw,repo-manage:rw,repo-basic-info:r,repo-cnb-detail:rw,repo-cnb-history:r,repo-cnb-trigger:rw,repo-commit-status:rw,repo-contents:rw,repo-notes:rw,repo-issue:rw,repo-pr:rw,repo-code:rw'
     const url = 'https://cnb.cool/user/personal_access_tokens'
@@ -52,4 +60,57 @@ export class User extends CNBCore {
 type AccessTokenResponse = {
   token: string;
   description: string;
+}
+
+type UserInfo = {
+  id: string;
+  username: string;
+  nickname: string;
+  type: number;
+  verified: number;
+  verified_expire_in: string;
+  created_at: string;
+  freeze: boolean;
+  locked: boolean;
+  avatar: string;
+  email: string;
+  next_updated_name_at: string;
+  updated_name_at: string;
+  updated_nick_at: string;
+  editable: {
+    avatar: boolean;
+    email: boolean;
+    logoff: boolean;
+    nickname: boolean;
+    'sync-data': boolean;
+    username: boolean;
+  };
+  language: string;
+  appearance: string;
+  gender: number;
+  bio: string;
+  company: string;
+  location: string;
+  site: string;
+  address: string;
+  wechat_mp: string;
+  wechat_mp_qrcode: string;
+  appreciate_status: number;
+  follow_count: number;
+  follower_count: number;
+  reward_count: number;
+  reward_amount: number;
+  stars_count: number;
+  group_count: number;
+  repo_count: number;
+  mission_count: number;
+  registry_count: number;
+  public_repo_count: number;
+  public_mission_count: number;
+  public_registry_count: number;
+  follow_repo_count: number;
+  follow_mission_count: number;
+  readme_repo_path: string;
+  last_login_at: string;
+  last_login_ip: string;
 }

package/src/workspace.ts

@@ -5,6 +5,7 @@
  * @createdAt 2025-12-04
  */
 
+import { Result } from "@kevisual/query/query";
 import { CNBCore } from "./cnb-core.ts";
 
 /**
@@ -75,8 +76,6 @@ export class Workspace extends CNBCore {
     return this.post({ url: '/workspace/stop', data });
   }
 
-
-
   /**
    * 根据流水线 SN 查询云原生开发访问地址
    * @param repo 仓库路径，例如：groupname/reponame
@@ -102,7 +101,7 @@ export class Workspace extends CNBCore {
    * @param params 启动参数
    * @returns 返回启动结果，包含以下字段：
    */
-  async startWorkspace(repo: string, params: { branch?: string; ref?: string }): Promise<{
+  async startWorkspace(repo: string, params: { branch?: string; ref?: string }): Promise<Result<{
     /** 仅新创建开发环境时返回，表示创建开发环境的流水线日志地址 */
     buildLogUrl?: string;
     /** 仅新创建开发环境时返回，表示创建开发环境的提示信息 */
@@ -111,7 +110,7 @@ export class Workspace extends CNBCore {
     sn?: string;
     /** 如果存在开发环境，则返回 WebIDE 访问 url；如果不存在开发环境，则返回启动云原生开发的 loading 页面 url 地址 */
     url: string;
-  }> {
+  }>> {
     const data: { branch?: string; ref?: string } = {};
 
     if (params.branch) {