跳到主要内容
    ↑↓ 选择↵ 打开esc 关闭
    gopowerteam

    Commit

    @gopowerteam/opencode-commit·v0.1.2·Git 与版本控制

    OpenCode 插件 - 根据 Git 变更自动生成中文约定式提交信息

    GitHub 星标

    0

    月装机量

    197

    综合评分

    34.1

    生态多维模型

    最近提交

    5 天前

    2026-09-30

    快速安装与配置

    opencode.json

    写入当前项目的 opencode.json,只对这个仓库生效。

    opencode.json

    {
      "$schema": "https://opencode.ai/config.json",
      "plugin": ["@gopowerteam/opencode-commit@0.1.2"]
    }

    OpenCode 启动时会通过内嵌运行时自动加载 npm 依赖并缓存至本地目录,无需手动在全局环境执行安装。

    OpenCode 插件 - 根据 Git 变更自动生成中文约定式提交信息。

    提供 /commit 命令,自动收集 git diff、status 和提交历史,结合 AI 生成符合约定式提交规范的中文提交信息,确认后一键提交。

    功能

    • 本地一次性收集上下文(status / diff / log),全程无模型参与
    • 单次 AI 调用生成提交信息,校验与失败重试在本地完成,速度远快于逐工具编排
    • 支持中文约定式提交格式(feat/fix/docs/style/refactor/perf/test/chore/revert)
    • 自动附加对应的 emoji
    • 交互式确认后再提交,-y 快速模式可跳过确认
    • --push 提交成功后自动推送(无上游分支时自动 set-upstream)
    • 存在待提交变更(含未跟踪新文件)时自动 git add -A

    安装

    仅支持 OpenCode v2。V1 的 plugin 配置键已改为 plugins。

    使用 CLI 命令安装:

    opencode plugin add @gopowerteam/opencode-commit
    

    或者在 opencode.json(全局或项目级)中手动添加:

    {
      "plugins": ["@gopowerteam/opencode-commit@latest"]
    }
    

    OpenCode 会在下次启动时自动安装。

    使用

    在 OpenCode 中输入:

    /commit
    

    插件会自动:

    1. 本地收集当前仓库的 git status、diff 和最近提交记录(无模型参与)
    2. 单次 AI 调用生成中文约定式提交信息,本地校验失败时自动带错误重试一次
    3. 展示供你确认
    4. 确认后执行 git commit

    快速模式

    日常小变更可用 -y 跳过确认,生成校验通过后直接提交:

    /commit -y
    /commit -y subject 里带上模块名
    

    再加 --push 在提交成功后自动推送(无上游分支时自动 --set-upstream):

    /commit -y --push
    

    -y/--yes 与 --push 可任意组合,其余文本作为生成的额外要求。快速模式下提交(与推送)结果以合成消息直接展示(不经确认交互),可用 git reset --soft HEAD~1 撤销。

    注:V1 的 subtask(子代理中执行命令)在 V2 插件命令上无对应字段,/commit 在当前会话内执行。如需子代理行为,可在 .opencode/commands/ 自行定义命令文件(V2 配置层支持 subagent: true)。

    提交信息格式

    <type>: <emoji> <subject>
    
    类型 说明 Emoji
    feat 新功能 ✨
    fix 修复 bug 🐛
    docs 文档更新 📝
    style 代码格式化 💄
    refactor 重构代码 ♻️
    perf 性能优化 ⚡
    test 测试相关 ✅
    chore 构建/依赖更新 🔧
    revert 回滚提交 ⏪

    示例:feat: ✨ 添加用户登录功能

    开发

    bun install
    bun dev          # 加载插件启动 OpenCode
    bun typecheck    # 类型检查
    bun test         # 运行单元测试
    

    License

    MIT

    同类生态推荐