使用文档

CNB SSH 连接助手 v0.10.2

CNB 增强助手：SSH 连接弹窗一键在 Trae / TraeCN / Qoder / MobaXterm 中打开；首页工作台「用量面板」标签页查看组织资源用量（额度 + 用量 + 历史月份）。

安装脚本 获取 Tampermonkey 插件
CNB SSH 连接助手 预览图

功能特性

  • 自动检测 SSH 连接信息
  • 支持 Trae IDE 一键连接（黑绿配色）
  • 支持 TraeCN IDE 一键连接并打开 /workspace 目录（蓝灰配色）
  • 支持 Qoder IDE 一键连接（黑绿渐变配色）
  • 支持 MobaXterm 一键连接（蓝色配色）
  • 首页工作台「用量面板」标签页：追加在「本周已完成」之后，点击查看管理员（Master）及以上组织的各资源额度与用量
  • 点击组织名称直接跳转该组织余量设置页（/-/settings/charge）
  • 访问令牌认证：首次使用引导创建只读令牌，令牌仅保存在浏览器 localStorage
  • 用量看板支持月份切换，可查看历史月份用量
  • 看板 UI 采用官方组件样式，与 CNB 站点风格一致
  • 智能防重复添加，避免界面混乱
  • 现代化 UI 设计，完美融入 CNB 风格

如何使用

  1. 安装 Tampermonkey 浏览器插件
  2. 点击下载按钮安装脚本
  3. 在 CNB 工作空间点击 SSH 连接，点击对应按钮在 Trae / TraeCN / Qoder / MobaXterm 中打开
  4. 访问 CNB 首页，首次使用按引导创建只读访问令牌并粘贴保存
  5. 点击工作台「用量面板」标签页即可查看组织资源用量，支持切换月份查看历史用量

常见问题 (FAQ)

看板通过访问令牌调用 CNB 官方 OpenAPI：/user/groups（你有权限的组织及角色）与 /{slug}/-/charge/quota（当月各资源额度：总额度 + 免费额度）、/{slug}/-/charge/volume（当月各资源用量汇总，可指定月份查历史）。展示范围是你在组织中角色为管理员（Master）及以上的组织——实测仅有权查看余量的组织才会返回数据，低于管理员角色（开发者/助手/访客）的组织会自动隐藏。数据仅在浏览器内请求，不会上传到任何第三方。
浏览器的跨域限制导致页面无法直接携带登录态调用 OpenAPI，因此需要一个只读访问令牌。首次打开首页时，看板会引导你：
  1. 点击「前往创建令牌」进入官方页面 cnb.cool/profile/token/create
  2. 在授权范围中勾选组织资源只读（group-resource:r）与账户用户资源列表只读（account-engage:r）
  3. 创建后把令牌粘贴到看板输入框保存
令牌仅保存在本浏览器 localStorage，只请求只读接口；随时可点击看板右上角「🔑 令牌」清除重配。
「令牌无效或已过期」表示令牌输错或已到期，请重新创建；「权限不足」表示创建令牌时未勾选所需授权范围，需要勾选组织资源只读（group-resource:r）与账户用户资源列表只读（account-engage:r）后重新创建。点击提示旁的「重新配置令牌」即可更换。
确保已安装 Trae IDE，安装后脚本会自动添加「在 Trae 中打开」按钮。点击按钮即可一键唤起 Trae 并自动连接远程开发环境。如果点击无反应，请确认 Trae IDE 已正确安装且 trae:// 协议已注册。
确保已安装 TraeCN IDE，安装后脚本会自动添加蓝灰配色的「在 TraeCN 中打开 (/workspace)」按钮。点击按钮即可一键唤起 TraeCN 并自动连接远程开发环境，同时打开 /workspace 目录。如果点击无反应，请确认 TraeCN IDE 已正确安装且 trae-cn:// 协议已注册。
确保已安装 Qoder IDE，安装后脚本会自动添加黑绿渐变配色的「在 Qoder 中打开」按钮。点击按钮即可一键唤起 Qoder 并自动连接远程开发环境。如果点击无反应，请确认 Qoder IDE 已正确安装且 qoder:// 协议已注册。
脚本会自动添加「在 MobaXterm 中打开」按钮，但首次使用需要配置：
配置步骤：
  1. 下载配置工具：点击下载 MobaRemoteTool.bat
  2. 安装协议：右键点击下载的文件，选择「以管理员身份运行」，在菜单中选择 [1] Install 进行安装
  3. 测试连接：安装完成后选择 [3] Test Protocol 测试协议是否正常工作
  4. 使用：在 CNB 工作空间点击 SSH 连接后，点击蓝色的「在 MobaXterm 中打开」按钮即可

注意事项：
• 安装后会在同级目录生成 launch-moba-remote.vbs 文件，请勿删除
• 如需卸载，运行工具选择 [2] Uninstall
• 如果移动了工具文件位置，需要重新运行 [1] Install 进行修复

更新日志

v0.10.2 2026-08-20

  • - 重构：看板改为首页工作台独立「用量面板」标签页，追加在「本周已完成」之后，点击才展示用量
  • - 点击标签即时加载（无令牌时展示配置引导）；切回原生标签自动恢复原状
  • - 组织名称点击跳转该组织的余量设置页（/{组织}/-/settings/charge）

v0.10.1 2026-08-20

  • - 修复：组织列表接口返回字符串数组被当作对象解析，导致看板一直提示「没有你是负责人的组织」（0.10.0 仍存在的问题）
  • - 组织列表改用 /user/groups 一次拉全并按角色过滤管理员（Master）及以上，无权限查看余量的组织自动隐藏
  • - 看板从页面顶部移入首页工作台 Tab 内容区（动态/待办等 Tab 下方），不再占用顶部空间
  • - 新增数据缓存：Tab 切换导致看板重建时直接复用已拉取数据，避免重复请求
  • - 若全部组织均返回无权限，则提示检查访问令牌的授权范围（需勾选组织资源只读）

v0.10.0 2026-08-19

  • - 移除：公共头「⌂ 返回首页」按钮（logo 本身即可返回首页/工作台，功能冗余）
  • - 调整：组织用量看板范围从负责人（Owner）改为管理员（Master）及以上（含 Owner）

v0.9.2 2026-08-20

  • - 看板组织范围扩大到管理员（Master）及以上的所有组织：只要你能查看该组织余量就会展示
  • - 组织列表改用 /user/groups 一次拉全并按角色过滤，替换原先 Owner 三类资源归并的查询方式
  • - 对无权限查看余量的组织静默隐藏并汇总提示；若全部组织 403 则提示检查令牌的授权范围

v0.9.1 2026-08-20

  • - 修复：组织列表接口返回字符串数组被当作对象解析，导致永远提示「没有你是负责人的组织」
  • - 看板组织范围扩大：除你负责的根组织外，你负责的仓库/子组织所在的根组织也会展示（费用按根组织结算）
  • - 看板移动位置：从页面顶部改为插入首页工作台 Tab 内容区（动态/待办等 Tab 下方），不再占用顶部空间
  • - 新增数据缓存：Tab 切换导致看板重建时直接复用已拉取数据，避免重复请求
  • - 组织列表与用量接口支持分页拉全，组织显示名通过 /user/groups 接口补充

v0.9.0 2026-08-19

  • - 新增：公共头「⌂ 返回首页」按钮，任意页面一键回到首页（首页自动隐藏）
  • - 新增：首页组织资源用量看板，展示负责人及以上组织的各资源额度与用量
  • - 看板通过访问令牌调用官方 OpenAPI：/{slug}/-/charge/quota（总额度+免费额度）与 /{slug}/-/charge/volume（用量汇总）
  • - 首次使用检测 localStorage 令牌，缺失时展示「前往创建令牌」引导，令牌仅存本浏览器
  • - 看板支持月份切换查看历史用量、手动刷新与一键更换令牌
  • - 看板 UI 采用官方 TDesign 组件与站点工具类样式，与 CNB 风格一致
  • - 适配 CNB SPA 路由切换，按钮与看板随页面自动增删

v0.8.0 2026-06-29

  • - Trae/Qoder 按钮也默认打开 /workspace 目录

v0.7.0 2026-06-27

  • - 新增 TraeCN IDE 连接按钮，使用 trae-cn:// 协议
  • - TraeCN 按钮默认打开 /workspace 目录
  • - TraeCN 按钮采用蓝灰配色方案

v0.6.0 2026-06-23

  • - 重新添加 Qoder IDE 连接按钮
  • - Qoder 官方已移除原生 SSH 远程连接支持，恢复 qoder:// 协议按钮
  • - Qoder 按钮采用经典黑-绿-白渐变配色方案
  • - 同时支持 Trae IDE、Qoder IDE 和 MobaXterm 三种连接方式

v0.5.0 2026-06-23

  • - 重新添加 Trae IDE 连接按钮
  • - Trae 官方已移除原生 SSH 远程连接支持，恢复 trae:// 协议按钮
  • - Trae 按钮采用经典黑绿配色方案
  • - 同时支持 Trae IDE 和 MobaXterm 两种连接方式

v0.4.0 2026-05-19

  • - 移除 Qoder IDE 连接按钮
  • - Qoder IDE 官方已原生支持 CNB SSH 连接，无需此脚本
  • - 保留 MobaXterm 连接功能

v0.3.0 2026-04-11

  • - 新增 Qoder IDE 远程开发支持
  • - 添加「在 Qoder 中打开」按钮，使用 qoder://vscode-remote/ 协议
  • - Qoder 按钮采用黑-绿-白渐变配色方案
  • - 脚本更名为 CNB SSH 连接助手

v0.1.0 2026-03-18

  • - 移除 Trae 连接按钮（CNB 官方已支持 Trae/Trae 国际版链接）
  • - 保留 MobaXterm 连接功能
  • - 脚本重命名为 CNB MobaXterm 连接助手
  • - 更新文档说明

v0.0.5 2026-02-07

  • - 脚本更新：发布 v0.0.2 版本
  • - 新增：MobaXterm 连接支持 (mobaxterm-remote://)
  • - 优化：按钮样式升级，增加悬停动效
  • - 优化：改进 SSH 连接信息提取逻辑

v0.0.4 2026-02-06

  • - 更新：导航栏 GitHub 链接替换为 CNB 链接
  • - 新增：FAQ 添加 trae:// 协议未注册处理程序的解决方案
  • - 优化：代码块样式和一键复制功能

v0.0.3 2026-02-06

  • - 修复：本地化 Alpine.js 资源，解决部分网络环境下无法加载的问题
  • - 优化：提升页面加载稳定性

v0.0.2 2026-02-06

  • - 修复：FAQ 样式在部分浏览器中背景色显示异常的问题
  • - 优化：文档页面按钮交互体验
  • - CI：验证自动部署流水线

v0.0.1 2026-02-06

  • - 优化：防止按钮重复添加的逻辑升级
  • - 样式：更新为黑绿主题，更加现代化
  • - 修复：组件复用时链接更新不及时的问题