hermes-glass-ui-personal/RULES.md

Hermes Glass UI · 个人版

启动

• 待补充

部署事实

• 平台：Hetzner VPS 76.13.31.179 + Coolify Traefik + Incus LXC hermes-personal + Docker hermes-agent
• 发布状态：已部署
• 主站 / 前端：https://hermes.kang-kang.com
• API / 后端：同域 /api/v1 转发到 LXC hermes-personal 内的 hermes-agent:8642
• 飞书桥接：源码在 server/feishu_bridge.py；线上计划开放 /feishu/events（飞书事件）和 /feishu/notify（主动通知）
• 文档 / 解析：https://styles.kang-kang.com
• 管理后台：待定
• 代码仓：https://git.kang-kang.com/kangwan/hermes-glass-ui-personal

快捷登录

• 登录地址：https://hermes.kang-kang.com
• 用户名：kang
• 密码：elErZOoJ35ywNlq222UTQnm3IbN9pv24
• 说明：这里只写项目专属网页登录；数据库密码、API Key、服务器 root 密码不要写这里

元数据回写清单

• 新增或变更公网地址后，必须同步更新 .project.json.urls
• 如果有网页后台登录：
  • 可直接入库：写 .project.json.quick_login
  • 不应入库：写 .project.json.credentials 引用
• 部署完成后，RULES.md 和 .project.json 必须同一次任务一起更新

环境变量

• 飞书桥接服务：
  • FEISHU_APP_ID
  • FEISHU_APP_SECRET（敏感，不入库）
  • FEISHU_VERIFICATION_TOKEN（可选，建议配置）
  • FEISHU_DEFAULT_RECEIVE_ID / FEISHU_DEFAULT_RECEIVE_ID_TYPE（主动通知默认目标）
  • FEISHU_NOTIFY_TOKEN（主动通知内部鉴权，敏感，不入库）
  • HERMES_API_BASE
  • HERMES_API_KEY（敏感，不入库）
  • HERMES_MODEL

规则

• 不允许编造不存在的部署域名、账号、密码
• 没有公网地址时，.project.json.urls 保持空数组
• 任何部署或域名变化，都要先改元数据，再视为任务完成

注意事项

• 飞书 App Secret、Hermes API key、主动通知 token 只能放部署环境或忽略的 secrets 文件，不允许写入跟踪文件
• 当前飞书桥接版本按明文事件回调处理；如果飞书后台开启事件加密，需要先补充解密支持
• 主站有 cookie 门禁；部署飞书桥接时必须在 nginx/Coolify 对 /feishu/events 放行，否则飞书服务器无法完成 URL 校验和事件投递