Pathrule

什么是 Pathrule？

Pathrule 是一个面向编码助手的上下文路由系统。它将团队记忆、规则和技能存储在一个按路径索引的知识图谱中，该图谱与仓库树结构相对应，然后在首次工具调用前，把相关的上下文片段注入到 Claude Code、Cursor、Codex 和 Windsurf 等工具中。

该产品旨在减少跨会话反复阅读仓库和临时提示的需要。它结合了云端工作区、本地桌面和 CLI 运行时以及一个 MCP 服务器，使团队能够在浏览器、桌面、终端和远程 AI 客户端之间保持同一共享知识层。

主要功能

• 按路径索引的知识图谱：记忆、规则和技能附加在与仓库镜像一致的工作区树节点上，因此可以按路径接近程度检索上下文，而无需手动标记。
• 类型化知识对象：记忆用于存储事实，规则用于存储带优先级和强制模式的约束，技能用于存储助手可调用的命名流程。
• 钩子时上下文注入：Pathrule 使用 PreToolUse 和 UserPromptSubmit 钩子在首次工具调用前推送上下文，帮助助手从一开始就获得正确信息，而不是重新发现这些内容。
• 面向多助手的 MCP 接口：一个 MCP 服务器通过 stdio 向 Claude Code、Cursor、Codex 和 Windsurf 提供相同的工具接口，减少不同客户端之间的配置漂移。
• 形状感知路由：路由器会按意图对提示词分类，例如 UI 微调、修复 bug、重构或探索，并根据请求调整响应深度。
• 本地与远程部署选项：Pathrule 提供 Web、Desktop 和 CLI 版本，并为无法运行本地运行时的纯云端客户端提供 Remote MCP 选项。

如何使用 Pathrule？

典型配置流程是先创建或连接一个工作区，然后挂接一个仓库树，以便 Pathrule 按路径为其建立索引。团队会在合适的节点添加记忆、规则和技能，并在需要时为规则选择严格或建议式行为。

之后，用户可以在浏览器、桌面应用或 CLI 中运行 Pathrule，或者通过 MCP 服务器连接编码助手。系统会在工具调用前将相关上下文路由到会话中，而 CLI 还可以安装客户端、同步配套文件、运行检查，并作为 Web 应用的本地桥接。

使用场景

• 在编码助手中共享团队知识：让模型无需在每次会话中重新解释，就能获取 schema 笔记、实现决策和常见约束。
• 单体仓库中的路径级指引：将规则和记忆附加到文件夹上，这样当团队在仓库不同部分工作时，更窄的路径可以覆盖更宽泛的工作区指引。
• 强制重要约束：使用严格规则阻止违反必需模式、策略或仓库特定约定的更改。
• 在不同工具间统一助手行为：为 Claude Code、Cursor、Codex 和 Windsurf 提供相同的底层上下文和工具接口，使不同编辑器遵循同一套团队知识。
• 终端和 CI 工作流：使用 CLI 进行无头操作、JSON 输出、SSH 设备码登录、仓库挂接，以及脚本化的设置或修复任务。

常见问题

Pathrule 只能在浏览器中使用吗？
不是。该产品提供 Web 应用、macOS 桌面应用，以及适用于 macOS、Linux 和 Windows 的 CLI。它还提供用于纯云端客户端的 Remote MCP 端点。

Pathrule 可以在没有本地安装的情况下运行吗？
可以，对于纯云端 AI 客户端，来源中描述了一个托管的 Remote MCP 端点。对于 Pathrule Web，本地操作如仓库访问和钩子同步可以与您机器上的 CLI 运行时配合使用。

支持哪些编码助手？
来源中明确提到 Claude Code、Cursor、Codex 和 Windsurf。

团队可以存储哪些类型的上下文？
Pathrule 组织团队记忆、规则和技能。规则可以是建议式或严格式，技能是助手可调用的命名流程。

替代方案

• 手动提示文件或仓库笔记：可以存储团队指引，但不提供按路径范围检索、基于 hook 的注入或共享的 MCP 接口。
• 通用知识库或 wiki 工具：适合文档管理，但并非用于在工具调用前直接将上下文路由到编码助手。
• 提示管理或 agent 框架工具：可以帮助组织提示词或工作流，但 Pathrule 的定位是面向仓库感知的检索、执行和注入。
• 原生助手记忆功能：某些编码助手可能保留有限上下文，但 Pathrule 将知识集中到多个客户端和入口，而不是只保存在单一产品内。