如何基于Probot框架在GitHub上实现机器人编辑仓库文件的功能？

核心结论 #

GitHub平台对获得授权的机器人开放完整的仓库文件编辑能力，不存在平台层面的功能限制。

前置权限配置 #

• 机器人安装到目标仓库时，必须申请并授予contents: write范围的权限，缺失该权限会直接触发接口权限报错
• 基于Probot开发的场景中，框架内置的context.octokit实例已经集成了全部GitHub官方文件操作接口能力，不需要额外引入第三方插件即可实现文件读写

目标场景实现流程（新提交触发README末尾追加指定内容） #

• 事件触发绑定：在Probot的监听规则中关联push事件，精准匹配仓库产生新提交的执行时机
• 核心执行逻辑：
  1. 调用接口拉取目标分支下README.md的当前文本内容，同时获取该文件对应的git blob sha标识值
  2. 将预设的指定追加内容拼接在原有文件内容的末尾，生成完整的新文件文本
  3. 调用文件提交接口，传入新的文件内容、关联的目标分支名、提交说明、之前获取的blob sha值，即可完成修改，自动生成一次关联的新提交

常见实现误区澄清 #

• 多数开发者找不到Probot下的文件编辑实现路径，本质是未注意到框架内置的API调用能力，而非框架本身缺失对应功能
• 所有支持自定义逻辑的GitHub机器人框架，只要能申请到内容写入权限，都可以通过调用官方接口完成文件编辑操作，不存在某类框架天生不支持修改文件的情况

操作提示：提交文件内容时必须携带对应文件的最新sha值，否则会触发GitHub的并发冲突校验机制，导致操作失败

内容的提问来源于stack exchange，提问作者O_o