内容
<p align="center">
<a href="https://github.com/Doucs91/hivelore">
<img src="https://raw.githubusercontent.com/Doucs91/hivelore/main/packages/vscode/media/logo.svg" alt="Hivelore logo" width="96" />
</a>
</p>
<h1 align="center">Hivelore</h1>
<p align="center">
<strong>您的团队的宝贵经验教训，在每次代理会话中予以简要介绍，并在提交时强制执行。</strong><br/>
<em>代码仓库原生的内存和上下文策略，用于代码代理工具。以前发布为 <code>hAIve</code> (<code>@hiveai/*</code>)。</em>
</p>
Hivelore 是 AI 代码代理工具中的团队知识层。它在工作开始前向代理提供前馈简报，然后在 MCP、Git 钩子、CI 和包装器中添加反馈门控，这样更改就不会悄悄绕过代码仓库策略。
一个有能力的模型已经知道通用的最佳实践。但它 *无法* 猜测的是您团队的任意的、特定于代码仓库的知识：公共 ID 以 `id + 100000` 为前缀，状态字段必须为 `"OK"`/`"KO"`，您从不编辑已应用的迁移。让其自生自灭，充满信心的代理会发明一个看似合理、干净、测试通过、绿色且 **根据策略错误** 的答案。Hivelore 将这种无法猜测的知识带入任务并阻止即将违反它的更改。
> Hivelore 的工作不是取代测试、linters 或可观察性。它使那些工具无法推断的代码仓库特定知识可用、可审计和可强制执行。
[](https://www.npmjs.com/package/@hivelore/cli)
[](./LICENSE)
[](https://nodejs.org)
[](https://github.com/Doucs91/hivelore/actions/workflows/ci.yml)
---
## 问题
AI 代码代理很强大，但它们经常在不完整的代码仓库上下文中工作。压缩、并行会话、代理切换和过时的咨询文档都会创建相同的故障模式：代理在工作时没有将团队的当前决策带入其中。
大多数团队通过指令和希望来解决这个问题：
- *"请先阅读我们的架构决策。"*
- *"不要重复上次冲刺的迁移错误。"*
- *"记得记录你所学到的东西。"*
- *"不要合并无效团队决策的代码。"*
这些规则很容易被跳过。Hivelore 将它们转化为 **代码仓库原生的上下文策略**。
---
## 工作原理
```
AI 代理 ──▶ Hivelore 简报 ──▶ 代码更改 ──▶ Hivelore 策略门控 ──▶ 合并
▲ │
└── 上下文面包屑 · 决策 · 警示 · 锚点
```
1. `hivelore init` 在您的代码仓库中创建一个 `.ai/` 上下文策略层。
2. 代理通过 `get_briefing` 开始每个会话 — 一个 MCP 调用，返回小型默认上下文和按任务相关性排名的更深入的面包屑。
3. 决策、警示、失败尝试和会话总结以 Markdown 文件形式存在，锚定在它们所描述的代码路径上。当代码移动时，Hivelore 检测过时的锚点。
4. `hivelore enforce check` 和 CI 强制执行阻止不安全状态：缺少简报、过时的关键决策、锚定反模式或未捕获的会话知识。
> **记忆是基础。上下文强制执行是产品承诺。**
> AI 更改不应在不咨询团队当前知识的情况下进入代码库。
## Hivelore 在工具链中的位置
工具链工程关注模型周围的环境：前馈指导、反馈传感器和工作流门控，以防止不良状态落地。Hivelore 拥有该工具链的 **代码仓库特定上下文策略** 部分。
| 工具链关注点 | Hivelore 角色 |
|---|---|
| **前馈指导** | `get_briefing`、模块上下文、技能、决策、警示、失败尝试 |
| **反馈和门控** | MCP 排序策略、`pre_commit_check`、Git 钩子、CI 强制执行、过时锚点检测 |
| **知识生命周期** | Git 原生 Markdown 记录、路径/符号锚点、置信度、退休、linting |
| **边界** | Hivelore 补充单元/e2e 测试、类型检查、运行时跟踪、安全扫描器和 LLM 评估；它不试图取代它们 |
这种狭隘的定位是故意的：Hivelore 不是一个通用的内存数据库或代理仪表板。它是帮助代码代理使用团队的验证的、非显而易见的知识的控制层。
### 范围和边界 — 三个工具链
工具链工程监管代理编写的代码的三个不同方面。Hivelore 故意涵盖两个方面，并将第三个方面视为目前的范围之外。
| 工具链维度 | 问题答案 | Hivelore 今日 |
|---|---|---|
| **可维护性** | 代码是否干净？（模式、陷阱、约定） | ✅ **覆盖** — 可执行传感器 + 反模式门控 |
| **架构适应性** | 它是否尊重团队的结构决策？ | 🟡 **部分** — 锚定 `decision`/`architecture` 记忆 + 决策覆盖门控 |
| **行为** | 代码是否具有 **功能正确性**？ | 🟡 **桥接** — 命令传感器将您自己的测试路由到经验教训（见下文） |
**为什么现在没有行为工具链。** 验证功能正确性需要一个 *oracle* — 一个独立的真理来源，说明代码 *应该* 执行什么 — 而这个问题（加上代理评估其自身工作的陷阱）是该领域最不成熟的部分。该领域属于您的测试、基于属性的检查和 LLM 评估；Hivelore 不试图取代它们。Hivelore 所做的是将行为测试将要编码的 **无法猜测的意图** （`status 必须是 OK/KO`、`public ids = id + 100000`）作为前馈上下文和确定性传感器 — 行为控制的部分静态切片，而不是运行时功能 oracle。
**桥接存在（v0.33.0）：命令传感器。** 一个经验教训可以携带一个 *命令* 而不是正则表达式 — 您自己的测试或不变式脚本。当差异触及传感器的路径时，门控执行它，非零退出拒绝提交，经验教训作为消息。
```bash
hivelore memory tried \
--what "refund 超出捕获金额" \
--why-failed "生产环境事件 #442 — 退款必须限制为捕获金额" \
--paths src/payments/ \
--sensor-command "npx vitest run tests/payments/refund-invariants.spec.ts"
# → 验证（oracle 必须在当前树上通过），然后在提交 + CI 中强制执行
```
保持诚实的规则：每个代码仓库选择加入（`enforcement.runCommandSensors: true` — 它执行代码仓库作者的命令），一个其 oracle **在假设正确的树上失败** 的提案被拒绝，并且 **无法运行** 的命令（未找到、超时）警告但从不阻止 — 损坏的工具链不能伪装成失败的测试。完整的行为验证（测试生成、LLM 评估）仍然是您的测试套件的工作。
> 参见 [`STABILITY.md`](./STABILITY.md) 以获取冻结的 1.0 接口，参见 [`CONTRIBUTING.md`](./CONTRIBUTING.md) 以扩展 Hivelore。
### 可执行内存传感器
一些 `gotcha` 和 `attempt` 记忆现在可以携带一个 `sensor` 块：一个确定性的正则表达式防护栏，扫描 diff 中新添加的行。传感器将记录的经验教训转化为可重复的反馈信号，独立于嵌入或模型判断。自动生成的传感器最初为 `warn`；人类可以将其提升为 `block`。
```bash
hivelore sensors list
hivelore sensors check # 扫描 git diff --cached
hivelore sensors promote <id> --yes # 将一个经验丰富的传感器提升为 block
hivelore sensors export --format grep
```
---
## 安装
```bash
npm install -g @hivelore/cli
# 可选：本地语义搜索（一次性下载约 110MB 模型）
npm install -g @hivelore/embeddings
```
---
## 60 秒证明 — 观看一个经验教训阻止提交
内存工具记住；Hivelore 的不同之处在于，记录的经验教训可以 **拒绝重复它的提交**。在任何 git 代码仓库中试试：
```bash
hivelore init -y # .ai/ 层 + git 钩子 + 12 个代理桥接
# 1. 捕获失败的方法（代理通过 mem_tried MCP 工具执行此操作）
hivelore memory tried \
--what "导入 moment.js" \
--why-failed "包大小膨胀 — 团队标准是 date-fns" \
--instead "date-fns" --paths src/
# → 打印新的内存 ID，例如 2026-07-02-attempt-importing-momentjs
# 2. 给经验教训赋予力量：一个验证的、确定性的防护栏
hivelore sensors propose 2026-07-02-attempt-importing-momentjs \
--pattern "from ['\"]moment['\"]" --severity block
# Hivelore 首先验证它：对您的当前代码保持沉默，在错误时触发。
# 3. 重新引入错误 — 提交被拒绝
echo "import moment from 'moment';" >> src/dates.ts
git add . && git commit -m "添加日期助手"
# ✗ 传感器触发 — 导入 moment.js：使用 date-fns （退出 2）
```
相同的差异，在每台机器和 CI 中得到相同的答案 — 门控设计为确定性。所有内容都以 `.ai/` 中的可审查 Markdown 形式存在，与您的代码一起版本控制。`rm -rf .ai` 可以撤销所有操作。
---
## 快速入门
### 1. 初始化您的项目
```bash
cd my-project
hivelore init # 创建 .ai/、桥接文件、MCP 配置、钩子和 CI 模板
```
`hivelore init` 现在还运行代理设置。它写入项目级 MCP 配置，记录最佳可用模式，并在不交互的 shell 中跳过全局配置并告诉您如何完成设置。
### 2. 连接您的 AI 客户端
**Claude Code** (`~/.claude.json`):
```json
{
"mcpServers": {
"hivelore": {
"command": "hivelore",
"args": ["mcp", "--stdio", "--root", "/绝对路径/to/my-project"]
}
}
}
```
**Cursor** (`~/.cursor/mcp.json`):
```json
{
"mcpServers": {
"hivelore": {
"command": "hivelore",
"args": ["mcp", "--stdio", "--root", "/绝对路径/to/my-project"]
}
}
}
```
**VS Code**:
```bash
code --add-mcp '{"name":"haive","command":"haive","args":["mcp","--stdio","--root","/path/to/project"]}'
```
### 3. 启动您的项目上下文
在您的 AI 客户端中，调用 `bootstrap_project` MCP 提示。代理分析您的代码库并自动编写 `.ai/project-context.md`。
### 4. 通过 Hivelore 开始工作
每个会话都以一个调用开始：
```
get_briefing(task: "添加 Stripe 支付集成", files: ["src/payments/PaymentService.ts"])
```
代理获得项目上下文 + 相关模块上下文 + 排名的上下文面包屑 — 不再需要 grep 以重新发现团队已经知道的内容。
对于没有原生 MCP 的 CLI 代理，请包装它们：
```bash
hivelore run -- claude --dangerously-skip-permissions -p "$(cat task.md)"
```
随时检查选定的模式：
```bash
hivelore agent status
hivelore agent setup # 稍后重新运行设置
hivelore agent setup --yes # 在不提示的情况下批准用户级 MCP 配置
```
### 5. 门控提交和拉取请求
```bash
hivelore enforce install # 安装 Git 钩子 + CI 强制执行模板
hivelore enforce status # 当前强制执行姿态
hivelore enforce check # 提交前策略门控
hivelore enforce ci # CI 入口（在违规时退出 1）
```
---
## CLI 一览 — 黄金路径
`hivelore --help` 只显示您日常使用的命令。其他所有内容（审查、导入、诊断、基准测试）都在一个 `hivelore --advanced --help` 之外 — 有重点的界面是刻意的，而不是缺少功能。
| 阶段 | 命令 | 它执行的操作 |
|---|---|---|
| **设置** | `hivelore init` | 创建 `.ai/`、桥接文件、MCP 配置、钩子和 CI |
| | `hivelore doctor` | 检查安装是否健康 |
| | `hivelore agent setup` | 连接您的 AI 客户端（MCP、钩子） |
| **编辑前** | `hivelore briefing` | 前馈上下文 — CLI 镜像 `get_briefing` |
| **捕获知识** | `hivelore memory save` | 记录决策/约定/警示 |
| | `hivelore memory tried` | 记录失败的方法以避免重复 |
| **检索** | `hivelore memory search` · `get` | 查找，然后读取记录 |
| **反馈** | `hivelore sensors check` | 扫描差异以对抗记录的经验教训 |
| **门控** | `hivelore enforce finish` | 在您调用任务完成之前退出门控 |
| **同步** | `hivelore sync` | 重新检查过时锚点，刷新桥接文件 |
| **关闭** | `hivelore session end` | 保存总结以备下一次会话 |
**CLI 和 MCP 之间的统一词汇。** 内存动词镜像 MCP 工具名称，因此代理一次学习它们：`hivelore memory save/search/get/delete` ↔ `mem_save`/`mem_search`/`mem_get`/`mem_delete`（较旧的 `add`/`query`/`show`/`rm` 仍然作为别名工作）。
---
## 在您的代码仓库中试用（5 分钟，可逆）
想在非玩具代码库中评估 Hivelore 吗？它是非破坏性的 — 它写入的所有内容都位于 `.ai/` 下，加上几个桥接文件，所有这些都可以删除。
```bash
cd your-project
npm install -g @hivelore/cli
hivelore init -y # 播种堆栈包 + git 历史疤痕；写入 .ai/ 和桥接文件
hivelore briefing --task "您即将进行的更改" --files path/to/file
hivelore doctor # 健康 + 覆盖率报告
hivelore sensors check # 扫描您暂存的差异以对抗记录的经验教训
hivelore eval --fail-under 50 # 在您自己的语料库上进行检索 + 传感器质量评估
```
要删除 Hivelore 添加的所有内容：`rm -rf .ai CLAUDE.md AGENTS.md GEMINI.md .cursorrules .clinerules .continuerules .windsurfrules .rules CONVENTIONS.md .github/copilot-instructions.md` 并删除 `.github/workflows/haive-*.yml` 文件。来自非我们自己的代码仓库的反馈是我们能收到的最有价值的东西 — 请 [打开一个问题](https://github.com/Doucs91/hivelore/issues) 反馈您认为有效和无效的内容。
## Hivelore 强制执行的内容
| 门控 | 它检查的内容 |
|---|---|
| **首次代理引导** | 在 **冷代码库** 上，强制第一个代理在提交/完成通过之前填充知识层：填充的项目上下文、每个组件的模块上下文、每个主要代码区域的锚定内存和 **每个主要代码区域的传感器**。触发器是代码库状态 — 一旦基准存在，门控对后续代理保持沉默。可通过 `enforcement.bootstrapGate` 调整（`off` · `warn` · `block`（默认））；仅在生产代码发挥作用时生效 |
| **已加载简报** | 代理在编辑前加载新鲜的上下文面包屑 |
| **决策覆盖** | 更改的文件由简报中的相关锚定决策覆盖 |
| **反模式匹配** | 与差异相关的反模式在门控处显示；一个 **验证的阻止传感器** 在添加的行上触发并 **阻止** 提交。可通过 `enforcement.antiPatternGate` 调整硬度（`off` · `review` · `anchored`（默认）· `strict`） |
| **过时锚点** | 锚定到已删除/移动路径的内存被标记 |
| **会话总结** | 代理在关闭前捕获了更改了什么和遗留了什么 |
| **CI 强制执行** | 必要的检查阻止了任何门控失败的合并 |
> **这里的“阻止”是什么意思。** Hivelore 的门控设计为确定性：在每个机器和 CI 中，相同的差异得到相同的答案。锚点、字面标记和语义匹配（无论多强）都 **显示以供审查**，而不会被阻止：相关性信号在环境之间变化，共现不是重新引入。`propose_sensor` 是从记录的经验教训到阻止防护栏的路径。 通过 `enforcement.antiPatternGate` 加强或放松；其他所有内容都作为 **过程** 强制执行（上下文是否加载、显示决策、存在总结）。
## .ai/ 目录布局
```
your-project/
├── .ai/
│ ├── project-context.md # 共享项目概述
│ ├── modules/ # 每个组件的上下文文件
│ │ ├── backend/context.md
│ │ └── frontend/context.md
│ └── memories/
│ ├── personal/ # 私有 — gitignored
│ ├── team/ # 共享 — 提交到 git
│ └── module/<name>/ # 模块范围的记忆
├── CLAUDE.md # 自动生成的桥梁（Claude 代码）
├── AGENTS.md / GEMINI.md / … # …以及 10 多个原生桥梁（见下文）
└── .github/
├── copilot-instructions.md # 为 Copilot 自动生成的桥梁
└── workflows/
├── haive-sync.yml # 合并时的锚点验证
└── haive-enforcement.yml # 必要的策略门控
```
### 原生桥梁 — 与每个代理相遇
对于没有 MCP 的 CLI/IDE 代理，`hivelore init` 从**相同**的语料库生成原生配置文件，以便团队的记忆和**阻止传感器**可以前往开发人员使用的任何代理 — 而不仅仅是一个空模板，还有执行边缘。`hivelore sync` 保持它们新鲜；永远不要手动编辑它们（使用 `hivelore bridges sync` 重新生成）。
| 代理 | 文件 | 代理 | 文件 |
|---|---|---|---|
| Claude 代码 | `CLAUDE.md` | Cline | `.clinerules` |
| Cursor | `.cursor/rules/haive-memories.mdc` | Windsurf | `.windsurfrules` |
| Codex / 通用 | `AGENTS.md` | Continue | `.continuerules` |
| GitHub Copilot | `.github/copilot-instructions.md` | Cody | `.sourcegraph/cody-rules.md` |
| Gemini CLI | `GEMINI.md` | Zed | `.rules` |
| Aider | `CONVENTIONS.md` | Roo | `.roo/rules/haive.md` |
```bash
hivelore bridges list # 显示目标状态
hivelore bridges sync --all # 重新生成所有原生桥梁
hivelore init --bridge-targets cursor,copilot # 或限定为特定代理
```
---
## 上下文策略记录
| 类型 | 描述 |
|---|---|
| `decision` | 团队已确定的架构或设计选择 |
| `gotcha` | 非显式约束、已知陷阱、微妙不变式 |
| `convention` | 特定于此代码库的命名、模式、样式规则 |
| `attempt` | 失败的方法 — 以便代理不会重复它们 |
| `architecture` | 组件边界、接口、数据流 |
所有记录都可以锚定到文件路径和符号名称。当锚定代码更改时，Hivelore 标志记录为可能过时。
---
## MCP 工具参考
| 工具 | 描述 |
|---|---|
| `get_briefing` | ⭐ 项目上下文 + 决策 + 警告 + 排名的导航线索 |
| `mem_save` | 保存存储库策略知识（决策、警告、约定、尝试、架构） |
| `mem_tried` | 记录失败的方法，以便未来的代理不会重复它 |
| `mem_search` | 跨上下文记录的全文或语义搜索 |
| `mem_relevant_to` | 任务的排名上下文记录（当项目上下文已加载时） |
| `mem_get` | 获取一个上下文记录（在简报/搜索结果之后） |
| `code_map` | 在代码地图索引时查找符号（无需手动 grep） |
| `mem_verify` | 检查锚点新鲜度，检测过时记录 |
| `pre_commit_check` | 与已知的警告、决策和过时锚点进行差异检查 |
| `mem_session_end` | 保存会话结束的总结，供下一个代理使用 |
MCP 配置文件使产品保持专注：
- `HAIVE_TOOL_PROFILE=enforcement`（默认）：紧凑的编码代理工具。
- `HAIVE_TOOL_PROFILE=maintenance`：语料库审查、生命周期、蒸馏、代码搜索和项目上下文维护。
- `HAIVE_TOOL_PROFILE=experimental` / `full`：`maintenance` 的旧别名（实验性诊断在 v0.32.0 中删除 — 数月的使用表明所有这些调用都是多余的）。
---
## MCP 提示参考
| 提示 | 描述 |
|---|---|
| `post_task` | ⭐ 任务后检查清单 — 在关闭每个会话之前捕获学习成果 |
| `bootstrap_repo` | ⭐ 首次代理引导 — 填充整个知识层，引导门控需要（项目上下文、模块上下文、锚定记忆、每个主要区域的验证传感器）。根据当前语料库状态量身定制检查清单，并驱动 `bootstrap_project_save` → `mem_save` → `propose_sensor` 直到就绪 |
| `bootstrap_project` | 分析代码库并编写 `.ai/project-context.md` |
---
## 软件包
| 软件包 | 安装 | 描述 |
|---|---|---|
| [`@hivelore/cli`](./packages/cli) | `npm i -g @hivelore/cli` | 主要产品：初始化、强制执行、运行代理、简报、记忆、同步、CI/Git 钩子 |
| [`@hivelore/mcp`](./packages/mcp) | 捆绑到 `@hivelore/cli` | 策略感知 MCP 服务器 |
| [`@hivelore/core`](./packages/core) | 依赖 | 类型、模式、锚点、策略基元、令牌预算 |
| [`@hivelore/embeddings`](./packages/embeddings) | `npm i -g @hivelore/embeddings` | 可选：本地语义排名（bge-small-en-v1.5，完全离线） |
**此存储库中还有：** 一个 [VS Code 扩展](./packages/vscode)（内联显示记忆 + CLI 可观察性的战略驾驶舱）和一个 [GitHub Action](./packages/github-action)（将相关团队记忆作为 PR 评论发布，以便审查者和代理不会错过非显式约束）。
---
## 自适应简报
只有当简报包含不可猜测的知识时，它才有价值，因此 `get_briefing` 返回 `briefing_value: "high" | "low"`。当没有团队特定的内容与文件/任务匹配时，自动生成的项目上下文被修剪为一行注释（配置：`adaptiveBriefing`，默认为开启） — 因此，Hivelore 仅在它实际了解模型不了解的内容时才显示更深层次的上下文。
---
## CLI 参考
```bash
# 设置
hivelore init [--with-ci] [--no-bridges] # 初始化 .ai/ + 桥梁文件 + 种子栈/git
hivelore init --bridge-targets <all|csv> # 将生成的桥梁限定为特定代理
hivelore enforce install # 安装 Git 钩子 + CI 强制执行
hivelore enforce status # 强制执行姿态报告
hivelore bridges list/sync [--all] # 检查/重新生成原生代理桥梁
hivelore index code # 构建 .ai/code-map.json
hivelore index code --status [--json] # 报告代码映射/代码搜索索引新鲜度
# 每天使用
hivelore briefing [--task <text>] [--files] [--json] # 打印上下文 + 相关记忆
hivelore run -- <agent command> # 在 Hivelore 会话中包装任何 CLI 代理
hivelore enforce check [--stage pre-commit] # 策略门控
hivelore enforce ci # CI 入口点
hivelore enforce finish # 最终代理退出门控：提交/推送 + 版本/标签协议
hivelore coverage [--source git|agent|both] # 查找未被记忆覆盖的更改文件
hivelore sync [--since <ref>] [--embed] # 验证锚点 + 自动提升
hivelore sensors list/check/export/promote # 操作可执行记忆传感器
# 记忆
hivelore memory save --type <type> --body "<text>" [--paths <csv>] # 保存记忆（锚定到文件）
hivelore memory list [--scope] [--status] # 列出记忆
hivelore memory search <text> # 全文/语义搜索
hivelore memory get <id> # 读取一条记录
hivelore memory approve [<id>|--all] # 标记为已验证
hivelore memory promote <id> # 个人 → 团队
hivelore memory tried [--sensor-pattern <re>] # 记录失败的方法（一次性防护）
hivelore memory conflicts [<a> <b>] [--yes] # 列出冲突候选者/解决一对
hivelore memory verify [--update] [--json] # 检查锚点新鲜度
hivelore memory import --from <file> [--changelog] # 将文档或 CHANGELOG 导入为记忆
hivelore memory seed [stack|--git] # 从堆栈包/ git 历史记录重新播种
# 冷启动（从现有信号开始）
hivelore ingest --from sonar|sarif|eslint|npm-audit <file> # 扫描器发现 → 锚定记忆
hivelore ingest --from <fmt> <file> --dry-run # 预览而不写入
# 索引（符号映射 + 语义搜索）
hivelore index code [--status] # 构建 .ai/code-map.json / 报告新鲜度
hivelore index memories # 构建语义索引（首次运行：~110MB 模型）
hivelore index query <text> # 语义搜索记忆
# 发布协议
hivelore release bump <patch|minor|major> # 锁定版本提升 + CHANGELOG 搭建
hivelore release tag # 在 HEAD 处标记 vX.Y.Z，推送分支 + 标签
# 诊断
hivelore doctor # 分析设置，发出建议
hivelore eval --fail-under 80 # 检索 + 传感器质量门控
hivelore selftest # 自我测试 MCP 工具（延迟 + 有效载荷）
```
`hivelore eval` 自动从锚定记忆中合成检索案例，并且在存在时，还会加载 `.ai/eval/spec.json` 以获取标记的检索/传感器案例。此存储库使用该文件在 CI 中保持可执行记忆传感器，以便在发布前捕获损坏的防护。
`hivelore doctor` 报告本地设置偏差，这可能会导致代理误诊存储库：缺少 `pnpm`、过时的工作区 `dist` 工件、全局 CLI/MCP 版本偏差、过时的代码搜索索引和低内存锚点覆盖率。
---
## 多组件项目
对于具有多个组件的项目（前端/后端/微服务），为每个组件创建一个模块上下文。`get_briefing` 根据正在编辑的文件自动加载相关的模块上下文。
```bash
mkdir -p .ai/modules/backend .ai/modules/frontend
cat > .ai/modules/backend/context.md << 'EOF'
# 模块：后端
- Spring Boot，Java 17，PostgreSQL
- 始终在每个存储库查询中过滤 tenantId
- 永远不要修改现有的 Flyway 迁移 — 创建 V{N+1}__desc.sql
EOF
cat > .ai/modules/frontend/context.md << 'EOF'
# 模块：前端
- React 19，TypeScript，TanStack Query v5
- 所有 API 调用都通过 features/<domain>/api/ 中的钩子进行
- 环境变量必须以 VITE_ 开头才能暴露给客户端
EOF
```
---
## 开发
```bash
git clone https://github.com/Doucs91/hivelore.git
cd Hivelore
pnpm install
pnpm -r build # 构建所有软件包
pnpm -r test # 运行测试
```
需要 Node 20 LTS+，pnpm 9+。
---
## 贡献
欢迎提出问题和 PR。请在开始重要工作之前打开一个问题，以便我们能够统一方向。
---
## 许可证
Apache 2.0 — 请参阅 [LICENSE](./LICENSE)。
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器