Skip to content

Security: BBQ2077/hermes-lean

Security

SECURITY.md

Security Policy / 安全政策

Trust boundary / 信任邊界

Use hermes-lean only with a Hermes checkout you trust. Apply verification and capture import Python modules from the selected checkout. The GUI's automatic check uses the already-running interpreter and does not execute a selected checkout's virtual-environment executable.

只對你信任的 Hermes checkout 使用本工具。套用後驗證與擷取會載入所選 checkout 的 Python 模組;GUI 自動檢查則只使用目前已啟動的 Python,不執行所選資料夾中的虛擬環境。

Built-in protections / 內建保護

  • Strict JSON schema and non-finite-value rejection
  • Python syntax preflight before any source write
  • Symlink/reparse-point rejection for managed source targets
  • Exclusive, collision-resistant backups
  • Same-directory temporary files and atomic replacement
  • All-target rollback on write or verification failure
  • GUI-managed edits restricted to the Git-ignored overrides.d/90-private.json

Read-only memory scope / 唯讀記憶範圍

memory_read_only injects frozen full snapshots of existing USER.md/MEMORY.md and hides/denies the built-in memory write tool. It is not an OS-level write lock. Generic terminal/file tools retain their filesystem permissions; malicious code or a noncompliant model may bypass the agent-layer policy. Mandatory protection requires a separate account, sandbox or OS ACL. External memory providers are not restricted by this option. Verification uses isolated synthetic files, not real user memory.

memory_read_only 提供唯讀提示詞快照並隱藏、拒絕內建記憶寫入工具,但不鎖定作業系統權限。通用 terminal/檔案工具仍有原本權限;需強制不可寫時請使用隔離帳號、沙箱或 ACL。此選項不限制外部記憶 provider,驗證僅使用隔離的合成記憶。

The full-text injector also bypasses upstream MemoryStore load-time threat scanning. It assumes the memory files are personally maintained and trusted; do not use unreviewed third-party files as prompt memory.

此外,全文注入不經過上游 MemoryStore 的載入時威脅掃描,前提是記憶檔案由使用者維護且可信,不應注入未審核的第三方內容。

Reporting a vulnerability / 回報漏洞

Please use GitHub's private security-advisory feature rather than opening a public issue with exploit details. Do not include API keys, tokens, personal paths, private configs, memory files, or user profiles in a report.

請使用 GitHub 私密安全通報功能,不要在公開 Issue 張貼利用細節。回報中請勿包含 API Key、Token、個人路徑、私有設定、記憶檔或使用者資料。

There aren't any published security advisories