loopover

# LoopOver _Formerly LoopOver._ <p align="center"> <a href="https://github.com/JSONbored/loopover/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/JSONbored/loopover/actions/workflows/ci.yml/badge.svg" /></a> <a href="https://www.npmjs.com/package/@loopover/mcp"><img alt="MCP package" src="https://img.shields.io/npm/v/@loopover/mcp?label=mcp" /></a> <a href="https://github.com/JSONbored/loopover/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/JSONbored/loopover" /></a> <a href="https://gittensory.aethereal.dev/docs"><img alt="Docs" src="https://img.shields.io/badge/docs-gittensory.aethereal.dev-0b6bcb" /></a> <a href="https://gittensor.io/miners/repository?name=JSONbored/loopover"><img alt="Gittensor impact" src="https://api.gittensor.io/repos/JSONbored%2Floopover/badge.svg" /></a> </p> LoopOver 是一款用于 Gittensor 开源贡献工作的确定性控制平面。 它帮助贡献者计划更清洁的工作，帮助维护者审查时减少公开噪音，并将私有评分、钱包、热键和审查上下文从公共 GitHub 输出中保持私密。 它是原生审查系统的唯一汇聚中心；不再是独立的审查机器人仓库/运行时。 它不是 Gittensor 资源管理器、公开排行榜、奖励农场机器人、钱包仪表盘或自主 PR 代理。 ## 隐私边界 LoopOver 默认保持敏感上下文的私密性。 - MCP 本地分支分析发送元数据，而不是源代码内容。 - 公共 GitHub 评论永远不会包含钱包、热键、奖励估计、私有排名、原始信任分数或审查上下文。 - 可选的 AI 摘要接收紧凑的确定性信号包，而不是原始源代码。 - 维护者数据包和评分上下文保留在受保护的 API/MCP 接口上。 有关完整的隐私边界，请参阅 [隐私和安全](https://gittensory.aethereal.dev/docs/privacy-security)。 ## 审查能力 LoopOver CI 和 LoopOver 审查评分、门控和评论拉取请求。审查算法是开源的；操作员通过每个仓库的设置和 `LOOPOVER_REVIEW_*` 功能标志进行调整，这些标志默认情况下都是关闭的，需要逐一开启。 - **安全扫描** — 在 AI 审查者读取之前，消除不受信任的 PR 标题/正文/差异（提示注入中和），并扫描差异中泄露的秘密，显示一个 `secret_leak` 阻止器。 - **CI + 全文件接地** — 用 PR 的完成 CI 状态和更改文件的完整内容为 AI 审查者提供基础，以便将声明与现实进行验证，而不是预测。 - **代码库 RAG** — 查询代码库矢量索引以获取相关的调用者、模块和约定，并将它们附加到审查者提示中（仅添加；如果索引不存在则无效）。 - **提交者声誉门控** — 一种内部的支出控制措施，将新的/突发性的/低声誉的提交者降级为确定性审查，从不显示在任何公共评论、标签或检查中。 - **统一审查评论** — 将公共 PR 反馈作为一个位置评论渲染，而不是多个面板。使用 `.loopover.yml` 的 `review.changed_files_summary` 也开启时，它会获得一个确定性的、无 AI 的“更改文件”可折叠部分：每个文件类别（源/测试/文档/配置/生成）一行，文件计数和 +/- 总数。 - **每个仓库激活** — 功能逐步推进（和回滚）一个标志和一个仓库，通过 `LOOPOVER_REVIEW_REPOS` 允许列表。 **检查运行和评论界面，区分开来** （一个常见的混淆点 - 这些是三个独立的、单独配置的事项，而不是同一功能的层级）： - **`LoopOver Orb 审查代理`** （`gate.*` / `settings.reviewCheckMode`，默认关闭）— 带有门控通过/失败判决的权威 GitHub 检查运行。这是值得作为必填状态检查的。 - **`LoopOver 上下文`** （`settings.checkRunMode` / `settings.checkRunDetailLevel`，默认关闭）— 一个单独的、纯粹的咨询检查运行。在其默认的 `checkRunDetailLevel: minimal` 下，它根本不会发布任何发现；即使在 `standard`/`deep` 下，它也只会重新渲染已经在其他地方显示的内容。永远不要将其设置为必填。 - **内联审查评论** （`LOOPOVER_REVIEW_INLINE_COMMENTS` + `.loopover.yml` 的 `review.inline_comments`，两者默认关闭）— 真实的、可回复的行锚定 PR 审查评论线程（CodeRabbit 样式）。这是三个中唯一发布交互式逐行线程的；上述两个检查运行永远不会。与 `.loopover.yml` 的 `review.suggestions` 开启时，还会将精确的行锚定修复作为一个单击、可提交的 GitHub 建议更改块渲染。与 `review.finding_categories` 开启时（默认关闭），每个发现还会根据类别进行标记 - 安全/正确性/性能/可维护性/测试/样式 - 在内联评论标签和统一评论的“发现类别”可折叠部分中；一个确定性的路径/关键词回退涵盖模型遗漏的任何内容。 有关完整的标志、设置和 `.loopover.yml` 参考，请参阅 [调整您的审查](https://gittensory.aethereal.dev/docs/tuning)。 ## 从这里开始 | 受众 | 开始 | 有用的下一个链接 | | ------------------------- | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 矿工和贡献者 | [快速开始](https://gittensory.aethereal.dev/docs/quickstart) | [MCP 客户端设置](https://gittensory.aethereal.dev/docs/mcp-clients)、[矿工工作流程](https://gittensory.aethereal.dev/docs/miner-workflow)、[可评分性](https://gittensory.aethereal.dev/docs/scoreability) | | 维护者 | [GitHub 应用](https://gittensory.aethereal.dev/docs/github-app) | [维护者工作流程](https://gittensory.aethereal.dev/docs/maintainer-workflow)、[自托管审查](https://gittensory.aethereal.dev/docs/maintainer-self-hosting)、[隐私和安全](https://gittensory.aethereal.dev/docs/privacy-security) | | 仓库所有者和操作员 | [Beta 上线](https://gittensory.aethereal.dev/docs/beta-onboarding) | [上游漂移](https://gittensory.aethereal.dev/docs/upstream-drift)、[故障排除](https://gittensory.aethereal.dev/docs/troubleshooting)、[路线图](https://gittensory.aethereal.dev/roadmap) | | 代理作者 | [代理](https://gittensory.aethereal.dev/agents) | [API 浏览器](https://gittensory.aethereal.dev/api)、[MCP 客户端设置](https://gittensory.aethereal.dev/docs/mcp-clients) | ## 界面 | 界面 | 链接 | | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | 网站 | [gittensory.aethereal.dev](https://gittensory.aethereal.dev/) | | 文档 | [gittensory.aethereal.dev/docs](https://gittensory.aethereal.dev/docs) | | MCP 软件包 | [@loopover/mcp](https://www.npmjs.com/package/@loopover/mcp) | | 引擎软件包 | [`@loopover/engine`](packages/loopover-engine/README.md) — 审查堆栈和矿工的共享确定性逻辑 | | 矿工软件包 | [`@loopover/miner`](packages/loopover-miner/README.md) — 自主矿工运行时的本地基础 CLI | | API | [API 浏览器](https://gittensory.aethereal.dev/api) 和 [OpenAPI JSON](https://gittensory-api.aethereal.dev/openapi.json) | | GitHub 应用 | [设置文档](https://gittensory.aethereal.dev/docs/github-app) — 自托管是唯一可用的路径 | | 浏览器扩展 | [扩展页面](https://gittensory.aethereal.dev/extension) | ## MCP 安装 ```sh npm install -g @loopover/mcp@latest loopover-mcp login loopover-mcp doctor loopover-mcp --stdio ``` 打印编辑器/客户端代码片段： ```sh loopover-mcp init-client --print codex loopover-mcp init-client --print claude loopover-mcp init-client --print cursor ``` 有关完整的编辑器设置和 stdio 配置，请使用 [MCP 客户端设置](https://gittensory.aethereal.dev/docs/mcp-clients)。 运行基础代理命令： ```sh loopover-mcp agent plan --login jsonbored --json loopover-mcp agent packet --login jsonbored --json loopover-mcp agent status <run-id> --json ``` ## 本地开发 ```sh npm install npm run cf-typegen npm run db:migrate:local npm run dev ``` ```sh npm run test:ci ``` 仅发布验证： ```sh npm run test:release npm run test:release:mcp ``` 前端： ```sh npm run ui:dev npm run ui:build ``` ## Gittensor 贡献者影响力 <p align="center"> <a href="https://gittensor.io/miners/repository?name=JSONbored/loopover"> <img src="https://raw.githubusercontent.com/JSONbored/loopover/gittensor-impact-assets/gittensor-impact-dark.svg" alt="Gittensor 贡献者影响力" width="600"> </a> </p> 每周由 [`.github/workflows/gittensor-impact.yml`](.github/workflows/gittensor-impact.yml) 刷新。 ## 项目链接 | 需要 | 链接 | | ------------ | ---------------------------------- | | 贡献 | [CONTRIBUTING.md](CONTRIBUTING.md) | | 安全 | [SECURITY.md](SECURITY.md) | | 支持 | [SUPPORT.md](SUPPORT.md) | | 更新日志 | [CHANGELOG.md](CHANGELOG.md) | 普通的特性/修复 PR 不编辑更新日志。更新日志是发布准备的产物。