Branch Delivery Manager

Branch Delivery Manager

在 Obsidian 桌面版中汇总 Git 分支、提交、关联事项、验收证据和上线检查。插件内置分支交付核心，无需安装 Codex Skill 或额外的本机脚本即可登记和扫描 Git 仓库。

使用

1. 安装并启用插件。电脑需要安装 Git，且目标仓库已经在本机克隆。
2. 从命令面板运行“分支交付中心：登记 Git 仓库”，填写本地仓库路径。
3. 运行“打开分支交付中心”，通过“扫描分支”读取远端分支和提交。

插件把交付记录保存在当前仓库的 04.项目/00.分支管理 目录。扫描会对已登记仓库执行 git fetch origin，因此可能访问相应 Git 远端；插件不会自动提交、推送或修改远端分支。

插件会读取用户登记的本地 Git 仓库（可能位于 Obsidian vault 之外），并在存在本机 Codex 同步档案时读取 ~/.codex/obsidian-sync/state 中的关联信息。仓库扫描通过 git fetch origin 使用网络；启用可选的 Codex CLI 智能关联时，提交信息会按该 CLI 的配置发送到其服务。

可选集成

• Codex CLI：安装并在设置中指定其可执行文件后，可为提交提供智能关联建议。使用该功能会由 Codex CLI 处理提交信息；明确编号的关联不要求 Codex CLI。
• 禅道：可填写禅道网页地址，以便打开关联任务和 Bug。读取 Bug 最新状态还需要在设置中指定兼容的禅道只读客户端脚本，并由用户自行配置该客户端的访问凭据。插件不附带凭据。
• Codex 会话档案：已有本机 Codex Obsidian 同步档案时，可显示提交关联的会话；没有该档案时，其他分支交付功能仍可使用。

设置保存在 Obsidian 插件数据中，不包含在 GitHub Release。旧安装的交付记录和设置会保留；升级时不要删除原插件目录中的 data.json。

手动安装与构建

下载同一版本 Release 中的 main.js、manifest.json 和 styles.css，放入 vault 的 .obsidian/plugins/branch-delivery-manager/，然后启用插件。源码构建运行 npm run build，产物为仓库根目录的上述三个文件。

许可证

MIT，见 LICENSE。