集成

你的智能体、快捷指令和脚本都能获取 Devbroom 掌握的信息。但它们都不会自行清理：智能体的请求和链接会在应用中交给你处理，devbroom clean 会先展示再询问。

这些都在“设置 › 智能体与集成”中。先用“链接 devbroom”把命令行工具链接为 ~/.local/bin/devbroom；MCP 和 Raycast 都会用到它。

为智能体提供 MCP

devbroom mcp 是一个 MCP 服务器，只与在这台 Mac 上启动它的智能体通信。它从不对网络开放。它提供三个工具：

工具	作用
`devbroom_status`	读取应用的上次扫描；不会重新扫描。
`devbroom_check`	说明某个文件夹能否删除及其原因。只接受你所选文件夹内的路径。
`devbroom_request_cleanup`	附上理由，请求清理一个或多个文件夹。请求会在应用中交给你。在你确认之前不会清理任何东西，确认后每一项还会再检查一次。

命令行和 MCP 免费。把它添加到你的智能体：

Claude Code

$ claude mcp add --scope user devbroom -- ~/.local/bin/devbroom mcp

Codex · ~/.codex/config.toml

[mcp_servers.devbroom]command = "/Users/<user>/.local/bin/devbroom"args = ["mcp"]tool_timeout_sec = 180

Cursor · ~/.cursor/mcp.json

{ "mcpServers": { "devbroom": { "command": "/Users/<user>/.local/bin/devbroom", "args": ["mcp"] } } }

“设置 › 智能体与集成”会用你 Mac 上的路径填好这些行。

链接

Devbroom 认识三种链接。它们只会打开应用；清理要等你来做。

链接	作用
`devbroom://scan`	重新扫描。
`devbroom://clean`	为可清理的内容打开清理预览。
`devbroom://open`	打开应用。加上 `?tab=storage`、`worktrees` 或 `sessions` 会转到对应的标签页。

其他任何链接都会被忽略。可以在快捷指令中通过“打开 URL”操作使用它们，也可以从 Raycast 使用。

适合脚本

devbroom status --json 给出应用的上次扫描：有多少可清理、何时扫描的，以及最大的可清理项目。它不会重新扫描。详见命令行页面。

分析

“分析”显示智能体数据如何增长以及 Devbroom 清理了什么：这台 Mac 上的可用空间、今年清理了什么以及仍在废纸篓中的内容、最近 30 天的增长、什么增长最快、按智能体划分的增长，以及智能体会话的 token 数和按 API 标价估算的费用。它根据每次扫描的摘要生成；扫描三次后会显示图表。所有数据都留在你的 Mac 上。分析包含在 Pro 中。

面向组织

组织可以通过 com.devbroom.desktop 域中的配置描述文件（MDM）设置 Devbroom 的部分行为。只有描述文件强制设定的值才有效；应用会把它们显示为已锁定，用户无法更改。应用和命令行每次运行时都会重新读取它们。

键	作用
`ProtectedPaths`	在用户自己的保护之外，Devbroom 永远不会建议清理的文件夹。
`ProtectedNames`	无论位于何处，都永远不会建议清理的文件夹名称。
`AllowPermanentDelete`	`false`：只能移到废纸篓。应用和命令行中的永久删除和清倒废纸篓都会关闭。
`AllowCommandLineClean`	`false`：`devbroom clean` 不会运行；扫描可以。
`AllowAgentRequests`	`false`：不接受智能体通过 `devbroom mcp` 发出的清理请求；读取仍可使用。

这是 Devbroom 的策略，而不是安全边界：用户仍然可以手动删除文件。如需团队许可证，请写信给我们。

最后更新： 2026年10月7日