WorkspaceGuard

WorkspaceGuard 是一款专为自托管 AI 助手设计的轻量级用量控制工具，旨在为多用户共享环境提供精确的配额管理与监控能力。它无需替换现有基础设施，而是以 MIT 许可证 的 npm/pip 包形式，作为旁路组件（sidecar）无缝集成到 Odysseus 及其他兼容后端中，为每个工作区（workspace）提供消息计量和月度硬性配额限制，确保资源公平分配，防止滥用。

核心功能

WorkspaceGuard 的核心在于其 fail-closed 的配额机制：当用户达到月度上限时，系统会自动阻止后续请求，避免超额使用。它通过 CLI 和库两种方式提供接口，支持 agent-native 的 --json 输出，方便集成到自动化工作流中。作为一款轻量级网关，它专注于用量控制，不干扰现有 AI 助手的核心功能。

主要特性

• 按工作区计量：精确追踪每个工作区的消息数量，实现细粒度管理。
• 月度配额硬限制：设定月度上限，超限即自动停止服务，杜绝超支。
• 无缝集成：无需替换现有系统，作为旁路组件快速部署。
• 开源免费：MIT 许可证，可自由使用、修改和分发。
• 开发者友好：提供 CLI 和库接口，支持 JSON 输出，便于脚本化操作。

适用场景

WorkspaceGuard 特别适合以下场景：

• 企业内部共享 AI 助手：为不同部门或团队设置独立配额，平衡资源使用。
• 教育机构：为学生或教师提供受限的 AI 访问，控制成本。
• 开源社区：为公共实例提供公平使用保障，防止个别用户占用过多资源。

总之，WorkspaceGuard 为自托管 AI 助手带来了企业级的用量治理能力，让资源管理变得简单高效。