1. 为什么我要在 VS Code 里做一个自动提交推送插件写代码的人大概都有过这种时刻改了一堆文件跑通了测试结果忘了git commit第二天打开电脑发现昨天的改动还躺在工作区里或者更糟切分支的时候把未提交的改动带了过去冲突一堆。市面上的 Git 插件不少但大多要么功能太重要么触发时机不贴合自己的习惯。我想要的其实很简单在 VS Code 里有一个命令点一下就把当前工作区的改动add、commit、push一条龙做完提交信息自动带上时间戳而且这个插件调用外部 AI 服务做提交信息润色时鉴权配置能统一走一个 Key不用在每个项目里散落一堆 token。这就是本篇要交付的东西一个 VS Code 插件开发案例聚焦 git 自动提交推送能力同时用 TaoToken 统一 Key 管理插件调用外部 AI 服务的鉴权配置。适合谁看有 TypeScript 基础、想自己写插件提效的开发者被多项目多 Key 管理折磨、想收敛鉴权入口的团队以及想理解 VS Code 插件从package.json命令注册到child_process调用链完整闭环的人。下面从零开始每一步都可复制。2. TaoToken 前置统一 Key 与 API 通道准备插件本身不复杂复杂的是「调用外部 AI 服务」这一环。如果每个项目、每个插件都各自维护一份 API Key时间一长就是灾难Key 轮换要改 N 个地方权限边界模糊日志也追不清。我的做法是把鉴权收敛到 TaoToken 这一层插件只认一个统一 Key 和一个 API 通道。你需要先拿到两样东西一个统一 Key在 TaoToken 控制台的 API Keys 页面创建建议按「插件用途」命名比如vscode-git-auto方便后续审计和吊销。API 通道地址https://taotoken.net/api插件里所有外部请求都走这个 base URL。创建 Key 的入口在这里API Keys 管理页https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入文档参数、鉴权头、错误码都在里面接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite如果你只是想先验证模型能不能通可以用模型对话页面直接试一条请求确认 Key 和通道没问题再写进插件模型对话https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite长期做编码类插件、Agent 类工具的话Coding Plan 会更省心额度模型和调用方式都更贴合这类高频场景Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite拿到 Key 之后不要硬编码进源码。VS Code 插件有自己的配置体系我们把它放进settings.json插件通过vscode.workspace.getConfiguration读取。这样 Key 不进 Git 仓库团队成员各自配置自己的。3. 可复制配置package.json 命令注册与 settings.json 骨架3.1 初始化插件项目先装脚手架然后生成项目npm i -g yo generator-code yo code交互式问答里选New Extension (TypeScript)名字填git-auto-push其余默认即可。生成后的目录结构里src/extension.ts是逻辑入口package.json是配置入口这两个是核心。3.2 package.json 里注册命令与激活事件打开package.json重点改三处activationEvents、contributes.commands、contributes.configuration。{ name: git-auto-push, displayName: Git Auto Push, version: 0.0.1, engines: { vscode: ^1.85.0 }, activationEvents: [onStartupFinished], main: ./out/extension.js, contributes: { commands: [ { command: gitAutoPush.commitAndPush, title: Git Auto: 提交并推送 } ], configuration: { title: Git Auto Push, properties: { gitAutoPush.taoTokenKey: { type: string, default: , description: TaoToken 统一 Key用于调用外部 AI 服务 }, gitAutoPush.apiBase: { type: string, default: https://taotoken.net/api, description: TaoToken API 通道地址 }, gitAutoPush.intervalMinutes: { type: number, default: 10, description: 自动提交推送间隔分钟0 表示关闭定时 } } } } }activationEvents用onStartupFinished保证 VS Code 启动完成后插件就绪定时器才能挂上。命令 ID 用gitAutoPush.commitAndPush命名空间清晰避免和其他插件撞车。3.3 settings.json 配置骨架在项目根目录的.vscode/settings.json或用户级 settings里写入{ gitAutoPush.taoTokenKey: sk-你的统一Key, gitAutoPush.apiBase: https://taotoken.net/api, gitAutoPush.intervalMinutes: 10 }注意taoTokenKey只放在本地 settings不要提交到仓库。团队协作时把它写进.gitignore覆盖的本地配置文件或者用环境变量注入。4. 核心实现git add/commit/push 调用链与 AI 提交信息4.1 用 child_process 封装 git 命令VS Code 插件运行在 Node 环境直接child_process.spawn调 git 最稳。先写两个小工具函数一个检查是否有改动一个执行任意 git 命令。import * as vscode from vscode; import * as child_process from child_process; function checkForChanges(cwd: string): Promiseboolean { return new Promise((resolve, reject) { const p child_process.spawn(git, [status, --porcelain], { cwd }); let out ; p.stdout.on(data, (d) (out d.toString())); p.on(close, (code) { if (code ! 0) reject(new Error(git status 执行失败)); else resolve(out.trim().length 0); }); p.on(error, reject); }); } function runGit(args: string[], cwd: string): Promisevoid { return new Promise((resolve, reject) { const p child_process.spawn(git, args, { cwd }); let stderr ; p.stderr.on(data, (d) (stderr d.toString())); p.on(close, (code) code 0 ? resolve() : reject(new Error(git ${args.join( )} 失败: ${stderr})) ); p.on(error, reject); }); }git status --porcelain的输出为空就说明工作区干净直接跳过避免产生空提交。这是很多人写自动提交时踩的第一个坑没改动也 commit结果报nothing to commit。4.2 调用 TaoToken 生成提交信息提交信息如果只是时间戳回看历史时毫无信息量。我让插件把git diff --stat的结果发给 TaoToken让它生成一句人话摘要。请求走统一 Keyasync function generateCommitMessage(diffStat: string): Promisestring { const cfg vscode.workspace.getConfiguration(gitAutoPush); const key cfg.getstring(taoTokenKey); const base cfg.getstring(apiBase) || https://taotoken.net/api; if (!key) return Auto commit at ${new Date().toLocaleString()}; const resp await fetch(${base}/v1/chat/completions, { method: POST, headers: { Content-Type: application/json, Authorization: Bearer ${key} }, body: JSON.stringify({ model: gpt-4o-mini, messages: [ { role: system, content: 你是 Git 提交信息助手只输出一行简洁的中文提交摘要不超过 50 字。 }, { role: user, content: 以下是本次改动统计\n${diffStat} } ] }) }); if (!resp.ok) throw new Error(TaoToken 请求失败: ${resp.status}); const data: any await resp.json(); return data.choices?.[0]?.message?.content?.trim() || Auto commit at ${new Date().toLocaleString()}; }这里用 Node 18 内置的fetch省掉额外依赖。model字段按你账号下可用的模型填具体可用列表在接入文档里查。4.3 串起完整调用链把检查、生成信息、add、commit、push 串起来async function autoCommitAndPush() { const folder vscode.workspace.workspaceFolders?.[0]; if (!folder) { vscode.window.showErrorMessage(未找到工作区文件夹); return; } const cwd folder.uri.fsPath; try { if (!(await checkForChanges(cwd))) { vscode.window.showInformationMessage(没有代码改动跳过提交); return; } const diff await new Promisestring((resolve) { const p child_process.spawn(git, [diff, --stat], { cwd }); let out ; p.stdout.on(data, (d) (out d.toString())); p.on(close, () resolve(out)); }); const msg await generateCommitMessage(diff); await runGit([add, .], cwd); await runGit([commit, -m, msg], cwd); await runGit([push], cwd); vscode.window.showInformationMessage(已提交并推送${msg}); } catch (err: any) { vscode.window.showErrorMessage(自动提交失败 err.message); } }4.4 注册命令与定时器在activate里注册手动命令并按配置挂定时器export function activate(context: vscode.ExtensionContext) { const cmd vscode.commands.registerCommand(gitAutoPush.commitAndPush, autoCommitAndPush); context.subscriptions.push(cmd); const cfg vscode.workspace.getConfiguration(gitAutoPush); const minutes cfg.getnumber(intervalMinutes) || 0; if (minutes 0) { const timer setInterval(autoCommitAndPush, minutes * 60 * 1000); context.subscriptions.push({ dispose: () clearInterval(timer) }); } } export function deactivate() {}把定时器注册进context.subscriptions插件停用时自动清理避免内存泄漏。5. 验证请求手动触发一次自动提交推送代码写完按F5启动扩展开发宿主窗口会弹出一个新的 VS Code 实例里面已经加载了你的插件。第一步在新窗口里打开一个配置好远程仓库的 Git 项目随便改一个文件保存。第二步按CtrlShiftP打开命令面板输入Git Auto: 提交并推送回车。第三步观察右下角通知。如果一切正常会看到「已提交并推送xxx」的提示提交信息是 TaoToken 生成的中文摘要。打开终端执行git log --oneline -3能看到最新一条提交。第四步验证定时能力。把intervalMinutes设为 1重启宿主窗口改一个文件等一分钟看是否自动触发。实测下来定时器在窗口失焦时依然工作因为setInterval跑在扩展宿主进程里不受编辑器焦点影响。如果只想先验证 TaoToken 通道是否通可以单独用模型对话页面发一条请求确认 Key 有效、返回正常再回到插件里排查。6. 本篇常见错排查报错git push failed九成是远程仓库没配好或者当前分支没有 upstream。先在终端手动执行git push -u origin main建立追踪关系插件里的git push才能直接跑通。报错nothing to commit说明checkForChanges判断有误或者你在两次触发之间没有实际改动。检查git status --porcelain的输出是否被正确 trim。TaoToken 请求返回 401Key 没读到。确认settings.json里的gitAutoPush.taoTokenKey拼写正确且作用域是当前工作区或用户级。插件里读的是gitAutoPush.taoTokenKey不是taoTokenKey。请求返回 404base URL 写错了。正确值是https://taotoken.net/api注意结尾不要多加/v1路径拼接在代码里已经带了/v1/chat/completions。定时器不触发检查activationEvents是否为onStartupFinished以及intervalMinutes是否大于 0。改完package.json要重新按F5启动宿主窗口热重载不会重新读激活事件。提交信息是英文或乱码模型返回内容没做 trim或者 system prompt 没生效。确认messages数组里 system 角色在前且model字段是你账号下真实可用的模型。7. 下一步把 Key 管理和编码工作流都收进来插件跑通之后你会发现真正的收益不只是「自动提交」这个动作而是鉴权入口收敛了。以前每个项目各自维护 Key现在插件只认gitAutoPush.taoTokenKey一个配置项轮换时改一处即可。如果你后续要加更多 AI 能力比如自动生成 PR 描述、代码审查摘要都复用同一个 Key 和同一个 base URL不用再折腾鉴权。需要管理或新建 Key 的时候直接去控制台API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite参数细节和错误码对照在接入文档接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite如果你打算把这个插件往团队里推或者继续做更重的编码 AgentCoding Plan 的额度模型会更合适Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite我自己的习惯是插件里所有外部调用都走统一通道本地只留一个 Key 配置项提交信息生成失败时降级到时间戳保证提交动作本身永远不阻塞。这样即使某天 API 不通你的代码也不会因为插件卡住而丢改动。
