SuperAPI AI 工具集

hermes-kanban-obsidian-integration

通用与其它

查看项目

更新于 10-15 23:41

技能介绍

用途:把 Hermes 变成自主项目执行器,通过 Obsidian 库内的看板管理任务。架构为 Hermes Agent → HTTP REST API → hermes-kanban-bridge 插件 → Obsidian Vault API → Markdown 文件 → obsidian-kanban 可视化渲染。

主要能力:通过 API 将目标拆解为结构化看板;移动卡片、更新元数据、实时查询状态;支持每日站会和每周回顾仪式;完全本地、无云依赖;在 Obsidian 中可视化渲染看板。

安装:推荐自动化安装,先 git clone https://github.com/GumbyEnder/hermes-kanban.git,设置 export VAULT_PATH="/path/to/your/ObsidianVault",再运行 bash hermes-kanban-install.sh。脚本会安装 hermes-kanban-bridge(REST API 服务)与 obsidian-kanban(可视化渲染器),并在 vault 的 community-plugins.json 中注册。手动安装需在 plugin 目录执行 npm install 与 npm run build,将 main.js、manifest.json 复制到 vault 的 .obsidian/plugins/hermes-kanban-bridge/,再下载 obsidian-kanban 的 main.js、manifest.json、styles.css(TAG=2.0.51),随后在 Obsidian 中关闭安全模式并启用两个插件,看到“Hermes Kanban Bridge started on port 27124”提示即成功。技能安装:mkdir -p ~/.hermes/profiles/$HERMES_PROFILE/skills/productivity,再 cp skills/*.md 到该目录。

配置:插件设置含端口(默认 27124)、看板文件夹(默认 Kanban)、信任模式(confirm 弹窗审批 / auto 静默)、启用服务器开关。远程访问需用 Tailscale/LAN IP 替代 localhost,并确认监听 0.0.0.0:27124;Windows 可加防火墙规则 netsh advfirewall firewall add rule name="Hermes Kanban Bridge" dir=in action=allow protocol=TCP localport=27124。

REST API:基础地址 http://localhost:27124。健康检查 GET /health;创建看板 POST /boards;添加卡片 POST /boards/{id}/cards;移动卡片 PATCH /boards/{id}/cards/{card_id};查询 GET /boards/{id}/cards(支持 column、assignee 等过滤);站会 POST /rituals/standup;周回顾 POST /rituals/weekly-review。

看板格式:Markdown 加 YAML frontmatter,kanban-plugin: board 触发可视化渲染,缺失则显示为普通 Markdown。API 创建的看板会自动包含该 frontmatter。

适用场景:项目拆解、工作流自动推进、每日站会与周回顾自动化,以及通过自然语言指令(如“把 Q3 发布拆成看板”“运行每日站会”“哪些卡片被阻塞”)驱动 Hermes 调用 API。

限制与排障:连接被拒时检查插件是否启用、端口是否占用;看板显示为列表时补 frontmatter;远程访问失败时检查绑定地址与防火墙;插件不显示需完全退出并重启 Obsidian;端口冲突可改端口并同步更新 HERMES_KANBAN_URL。项目含 105 个测试(59 单元、46 E2E),可用 pytest tests/ 运行,并提供 mock API 服务器供无 Obsidian 时开发测试。具体收费、价格与平台支持范围资料未提供。