Webull Teamup Tool 是一款专为提升研发团队日常工作效率而打造的 VS Code 扩展插件。它将 Teamup 任务管理系统与 VS Code 深度整合，开发者无需频繁切换浏览器窗口，即可在编辑器内完成任务查看、管理以及与 Git 工作流的无缝联动。
在线文档-Webull Teamup Tool
📥 一、插件安装
- 下载团队提供的最新版
.vsix 插件包
- 打开 VS Code，进入左侧的“扩展 (Extensions)”面板。
- 点击面板右上角的
... 菜单，选择 “从 VSIX 安装...” (Install from VSIX...)。
- 选择下载的
.vsix 文件，安装完成后即可在左侧活动栏看到 Webull Teamup 的企鹅/任务图标。
🌟 二、核心功能与使用说明
1. 🔑 智能 Token 认证与便捷获取
插件需要 Teamup 的 Auth Token 才能拉取数据。我们极大简化了 Token 的获取流程：
- 无感拦截机制：当 Token 未设置或过期（接口返回 401）时，插件会自动拦截并在 VS Code 顶部弹出鉴权输入框。
- 双模式复制脚本：
- 弹窗内提供两个快捷按钮：[仅复制脚本] 与 [复制脚本并打开 Teamup]。
- 点击后，插件会自动将一段提取 Token 的 JS 脚本复制到您的剪贴板。
- 操作步骤：
- 点击 [复制脚本并打开 Teamup]，浏览器会自动跳转到 Teamup 工作台页面。
- 按
F12 打开浏览器开发者工具，切换到 控制台 (Console)。
- 直接
Ctrl+V / Cmd+V 粘贴剪贴板中的脚本并回车。
- 此时控制台会打印绿色的成功提示，Token 已自动存入您的剪贴板！
- 返回 VS Code，将 Token 粘贴至输入框回车即可。
2. 🗂️ 侧边栏任务树状导航
在 VS Code 左侧专属的视图中，可以分类管理您的任务入口：
- 分类目录：包含 “数据看板 (Dashboards)” 和 “工作事项 (Work Items)” 两大类。
- 默认数据保护：团队内置了常用的基础看板（如“风控前端”、“我的事项”等），这些默认项带有保护机制，无法被编辑或删除。
- 自定义管理：
- 鼠标悬浮在分类目录上，点击
+ 号可新增您自己的专属看板或事项。
- 右键点击您自定义的节点，可进行 编辑 或 删除。
- 点击顶部导航栏的
刷新 按钮可随时同步最新状态。
3. 📊 主视图数据表格
左键点击侧边栏的具体节点，会在编辑器主区域打开该看板/事项的详情表格：
- 紧凑美观的展示：智能合并 IssueType 与 Key，自适应列宽，长标题自动省略（悬浮可看全称），确保大多数情况下无需横向滚动。
- 状态可视化：Status 列配备了不同颜色的精美徽标 (Badge)，直观反映任务当前进度。
- 本地快速搜索：表格顶部内置搜索框，支持对当前列表数据进行秒级的关键字过滤。
- 单行快捷操作：每行任务末尾都有一个“复制”图标，点击可一键复制该任务标准格式的 Commit Message（如
feat[FKHG-1234]: 修复登录页面的UI错位）。
4. 🚀 沉浸式 Git 工作流联动（状态栏）
插件与 VS Code 底层 Git 扩展深度打通。只需确保您的 Git 分支名包含任务 Key（例如：feature/FKHG-23422-login），即可享受以下状态栏自动化服务：
- $(repo-push) 填充Commit：
- 点击后，插件自动读取当前分支名，提取单号
FKHG-23422。
- 后台请求该任务详情（若 Token 过期会自动弹窗引导更新并无缝重试）。
- 成功后，自动将标准化的 Commit 信息填入 VS Code 左侧源代码管理 (SCM) 的提交框中！
- 降级保障：如果当前环境无法访问 SCM 输入框，会自动将 Commit 信息复制到您的剪贴板并弹窗提示。
- $(copy) 复制Commit：
- 流程同上，但只进行复制，不会填入输入框，适合习惯在终端命令行
git commit -m 的开发者。
- $(link-external) 动态 Teamup 跳转：
- 状态栏会动态实时显示当前分支对应的任务单号（例如：显示为
FKHG-23422）。
- 切换 Git 分支时，状态栏的单号会跟着自动刷新。
- 点击该按钮，可直接在外部浏览器中打开该单号对应的 Teamup 详情页。
- 降级保障：如果当前不在 Git 仓库，或分支名不含单号（如
master），按钮文案会恢复为 Teamup，点击后将为您打开 Teamup 默认工作台。
💡 三、常见问题 (FAQ)
Q: 为什么获取 Token 时，不能点击按钮直接帮我打开浏览器 F12 控制台？
A: 出于浏览器底层的安全机制（防止网页被恶意脚本执行 Self-XSS 攻击），现代浏览器严禁通过任何外部代码自动唤起开发者工具。因此需要您在网页加载完成后，手动按一下键盘的 F12 键。
Q: 点击状态栏按钮提示“无法获取当前 Git 分支名”？
A: 请确保您当前在 VS Code 中打开的是一个有效的 Git 仓库根目录。如果确认是 Git 仓库，可能是内置的 Git 插件加载延迟，稍等片刻或刷新窗口即可。
Q: 为什么某些很长的自定义状态，在表格里排序看起来是乱的？
A: 插件针对常用的生命周期状态配置了优先排序规则。对于未知的非常规状态，系统会自动降级为首字母排序，并统一归置到列表后方，以保证常用状态始终稳定在最上方。
| |
