# @bashbop/solumbe 中文文档

规范地址：https://npmcn.com/package/%40bashbop/solumbe/

版本：4\.10\.0
npm 元数据更新时间：2026-10-31T19:56:22.752Z
中文译文更新时间：2026-11-07T20:59:32.995Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bashbop/solumbe
原文对照：https://npmcn.com/package/%40bashbop/solumbe/?lang=original
项目主页：https://bashbop.github.io/solumbe/
源码仓库：https://github.com/BASHBOP/solumbe

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.9 MB，296 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.18
- 运行依赖：1 个
- 首次发布：2026-09-30T18:42:59.805Z
- 最新版本发布：2026-10-31T19:56:22.433Z
- 近 30 天下载量：2582（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

Solumbe:确定本地寄存器的背景,影响分析,以及合并证据.

## 安装

```sh
npm install @bashbop/solumbe
```

也可以使用：`pnpm add @bashbop/solumbe`、`yarn add @bashbop/solumbe`、`bun add @bashbop/solumbe`

## README

# 索伦贝

**模型产生变化。 索伦贝证明合并是否安全.**

原为 **时间轴:** (单位:千美元)`@bashbop/otito`),在4.0.0中更名 [变化](https://npmcn.com/package/%40bashbop/solumbe/CHANGELOG.md) 将每个旧名都映射到它的新名中.

[![CI](https://img.shields.io/github/actions/workflow/status/BASHBOP/solumbe/solumbe-ci.yml?style=flat-square&label=CI)](https://github.com/BASHBOP/solumbe/actions/workflows/solumbe-ci.yml) [![npm](https://img.shields.io/npm/v/@bashbop/solumbe?style=flat-square)](https://www.npmjs.com/package/@bashbop/solumbe) [![license: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://npmcn.com/package/%40bashbop/solumbe/LICENSE) [![node](https://img.shields.io/badge/node-%E2%89%A518.18-339933?style=flat-square)](https://nodejs.org/) [![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/bashbop/otito) [![Solumbe MCP server – quality and maintenance score on Glama](https://glama.ai/mcp/servers/BASHBOP/solumbe/badges/score.svg)](https://glama.ai/mcp/servers/BASHBOP/solumbe)

![solumbe demo](https://npmcn.com/package/%40bashbop/solumbe/solumbe-demo.gif)

[![Solumbe MCP server – quality and maintenance score on Glama](https://glama.ai/mcp/servers/BASHBOP/solumbe/badges/card.svg)](https://glama.ai/mcp/servers/BASHBOP/solumbe)

Solumbe是本地第一,具有决定力,模式不可知性的信任层,用于AI辅助开发. 它在代理编辑前构建了任务感知寄存器上下文,对一个变化实际触及多少进行评分,而闸门则会将准备状态与确切的相接相接相接,没有服务器,没有账户,也没有代码离开机器.

它不会取代克洛德代码,代码,Cursor,双子座,或者任何本地特工的牵引. 它运行在他们旁边 并不断工作 随着模型在下面的变化.

一个经过的地方大门从来不是自动的合并批准:托管的CI,GitHub审查,CODEOWNERS,以及人类释放决定仍然是独立的当局.

## 安装

```bash
npm install -g @bashbop/solumbe
solumbe doctor
solumbe install --host all
```

上个命令将Solumbe的MCP服务器连接到它找到的每个代理主机:克洛德代码,克洛德桌面,Codex CLI,Cursor,VS代码,双子座CLI和Kimi代码CLI. 添加 `--dry-run` 或名称主机 `--host claude-code,cursor`。随后重新启动每个主机.

或者不安装: `npx -y @bashbop/solumbe doctor`。 。 。 .

## 它会做什么

**排名什么变化 实际触及**,单从请求,没有模型,没有嵌入,也没有网络:

```console
$ solumbe impact . "add refund handling to checkout" --top 3

  concepts: money flow

   1.  src/payment/checkout.service.ts    score 155
       |- role: required
       |- path matches: checkout
       |- symbol matches: checkout, refund
       |- concept match: money flow (×1.4 + 6.0)
       |- risk: money flow

   2.  src/payment/stripe.webhook.ts    score 6
       |- role: advisory
       |- concept match: money flow (×1.4 + 6.0)
```

**打开整棵树**,并准确说明原因:

```console
$ solumbe gate . --staged --base origin/main --request "add refund handling to checkout" --min-convergence 80

  [OK]    Changed files          1 changed file found.
  [OK]    Staged snapshot        Changed-file scope and convergence evidence are captured from the exact staged Git tree.
     |- Tree: 7d0b513dd256877d6bd309a6406468a9b1eaeedc
     |- Base: b776f04fcfbd02c8ce8d63e1a0c2450be58de039
  [OK]    Secret safety          No secret file paths and no credential values found in the changed content.
  [WARN]  Risk review            Risk-sensitive files changed; maintainer review should be explicit.
     |- src/payment/checkout.service.ts
  [OK]    Convergence            Task and diff satisfy the convergence requirement.
     |- Score: 100/100 (aligned)
     |- Receipt handle: rcpt_a8d31efae06e
     |- Subject tree: 7d0b513dd256877d6bd309a6406468a9b1eaeedc

  VERDICT  WARN
```

趋同分数是模型本身无法分级的部分:它将声明的意向与diff实际被更改的文件进行比较,并产生一个与准确的基数,父数,和舞台树身份相接的收受.

**保留更改内容.** 记录文件 请求在编辑前要触摸, 而门名则指定任何从未声明的文件 :

```console
$ solumbe declare . "add refund handling to checkout"
$ # ... the agent edits ...
$ solumbe gate . --staged --base HEAD --intent .solumbe/intent.json

  [FAIL]  Scope contract         Touched `src/auth/session.ts`, which was never declared. Amend the intent with the reason it belongs (`solumbe amend <file> --reason "<why>"`), or take it out of the change.
     |- Request: "add refund handling to checkout"
     |- Contract: fe655c2af2b31b7e3edec6aedd248b379235811d1228c829f87ff73796ace487
     |- Changed files: 3 (1 declared, 0 amended, 1 implied, 1 undeclared)
     |- Implied: tests/checkout.service.test.ts (owner-test of src/payment/checkout.service.ts)
     |- Undeclared on a risk-sensitive path: src/auth/session.ts [auth/security]
```

一项修正案增加了一个有其理由的文件,并附在了合同上,因此一名审查者解释了范围扩大的原因。 超过MCP是 `change_impact` 与 `declare: true`,以及 `review_gate` 与 `intent`。 。 。 .

## 核心内容

四令为出品. 他们称没有模型,没有打开套接字, 并读到没有寄存器.

| 步骤 | 命令 | 证明什么 |
| --- | --- | --- |
| 编辑前 | `solumbe context "add refund handling" --path .` | 请求需要哪些文件、测试和命令 |
| 编辑后 | `solumbe converge . "add refund handling" --base origin/main --staged` | 迪夫离请求有多远 有收据 |
| 在合并之前 | `solumbe gate . --staged --base origin/main --request "add refund handling"` | PASS / WARN / 错误在准确的相机树上 |
| 合并后 | `solumbe attest . --verdict verdict.json --merge <sha>` | 一份散装货品链记录,根据该判决 |

`solumbe help` 展示这些和如何设置; `solumbe help --all` 列出每个命令,包括支持它们的命令(`impact`, (中文(简体) ), `declare`, (中文(简体) ), `pr`, (中文(简体) ), `review`, (中文(简体) ), `map`, (中文(简体) ), `calibrate`, (中文(简体) ), `route`, (中文(简体) ), `ax`, (中文(简体) ), `dashboard` 以及别的。 没有被移除.

不需要任何托管,任何托管都不能改变判决. [本地核心, 可选主机](https://bashbop.github.io/solumbe/19-local-core-optional-hosted/) 列出可选部件发送的确切内容和地点.

## 支持命令

| 目标 | 命令 |
| --- | --- |
| 军衔变化爆炸半径 | `solumbe impact . "add refund handling" --top 12` |
| 记分意图与执行 | `solumbe converge "add refunds" --path . --base HEAD --staged` |
| 准确的评分承诺的改变 | `solumbe converge "add refunds" --path . --base HEAD~1 --head HEAD` |
| 打开产品改变的大门 | `solumbe workspace-gate ../web ../api --request "ship change"` |
| 等级风险旗与历史对照 | `solumbe calibrate . --window 30` |
| 等级路由级对历史 | `solumbe regret . --window 30 --offline` |
| 重分类保存的运行, 相同的答案 | `solumbe regret --rescore run.json` |
| 记分代理经验 | `solumbe ax . "add a new MCP tool"` |
| 建议一个模式级别 | `solumbe route . "add a new MCP tool"` |
| 用模型读取的简洁上下文 | `solumbe context "add a new MCP tool" --path . --online` |
| 检查一回波 | `solumbe repo . --json` |
| 构建代码映射 | `solumbe map . --json` |
| 索引和搜索本地项目 | `solumbe index ~/projects --discover` 接下来 `solumbe search "events controller"` |
| 生成代理吊带 | `solumbe harness . --out .solumbe/harness.md` |
| 运行 MCP 服务器 | `solumbe mcp` |

每个命令都用 `--json`,以及 `solumbe help` 列出带有旗帜的完整集.

## MCP 磁共振

Solumbe号飞船的MCP服务器曝光 **14个工具**数字 : `repo_inspect`, (中文(简体) ), `repo_map`, (中文(简体) ), `repo_index`, (中文(简体) ), `repo_search`, (中文(简体) ), `context_pack`, (中文(简体) ), `change_impact`, (中文(简体) ), `agent_experience`, (中文(简体) ), `model_route`, (中文(简体) ), `convergence_score`, (中文(简体) ), `review_context`, (中文(简体) ), `review_gate`, (中文(简体) ), `review_verdict`, (中文(简体) ), `workspace_report`,以及 `repo_harness`。 。 。 .

```json
{
  "mcpServers": {
    "solumbe": {
      "command": "npx",
      "args": ["-y", "@bashbop/solumbe", "mcp"]
    }
  }
}
```

`solumbe install --host all` 为您写此条目, 使用绝对路径, 所以主机不会继承您的 shell `PATH` 仍然可以开始。 在MCP登记处公布为 `io.github.BASHBOP/solumbe`. Repo-map 检查使用外部的每个用户缓存,从不写入被检查的仓库. Claude 代码、 Claude 桌面、 Codex 、 Cursor 、 VS 代码、 双子座 CLI 和 Kimi 代码的特定主机设置在 [MCP和代理工作流程](https://bashbop.github.io/solumbe/02-mcp-agent-workflows/)。 。 。 .

## 如何比较

| 方针 | 强度 | 音响不同的地方 |
| --- | --- | --- |
| 来源图 / Cody 上下文 | 强大的主机代码搜索和基于嵌入上下文 | 本地第一和确定性:没有服务器,没有账户,没有代码离开机器,同样的查询总是产生相同的包 |
| 手写 `CLAUDE.md` / 规则文件 | 明确、意图丰富的指导 | 手写上下文会僵化; solume 重现了每次运行时实际代码的上下文(符号、导入、路径、测试),并补充了短字符 `CLAUDE.md` |
| `grep` 编号 : `ripgrep` | 快速、 通用文本匹配 | solumbere按照任务意图排列整个文件的分路径、符号、导出和测试,然后添加模式和验证命令,生成上下文包而不是匹配行列表 |

## 文档

完整指令参考,代理工作流程,发布过程,评价方法,以及信任层后方的设计主题:

**[bashbop.github.io/solumbe (英语)](https://bashbop.github.io/solumbe/)**

## 捐款

```bash
git clone https://github.com/BASHBOP/solumbe.git
cd solumbe && npm ci && npm run ci
```

`npm run ci` 是全门:格式、用意、打字、版本检查、测试、覆盖层(70%行/60%分行/75%的功能)、三个评价公司、依赖性审计和包装-tarball烟雾测试。 在请求审查前运行它 .

开始 [捐款额](https://npmcn.com/package/%40bashbop/solumbe/CONTRIBUTING.md) 编辑 [行为守则](https://npmcn.com/package/%40bashbop/solumbe/CODE_OF_CONDUCT.md)。所有更改都需要维护者审查; `main` 需要通过大门 和有决心的对话。 Solumbe遵循语义版,所以说一个PR是无影响,补丁,次要,还是主要.

* * *

## 工具链的一部分

**音响** 是构成AI辅助开发的决定性信任层的四个工具之一. 每个都使用静态分析来回答一个问题,人们不断将问题交给LLM.

-   **音响** (本工具),用于上下文:这个变化实际触及什么?
-   [领带](https://www.npmjs.com/package/@nugehs/tieline),对于合同:前端和后端是否悄悄地停止同意?
-   [保镖](https://www.npmjs.com/package/@nugehs/bouncer),为了遵守:你能为Ofcom辩护吗?
-   [阿伊格尔](https://www.npmjs.com/package/@nugehs/aiglare),对于治理:模型在哪里可以做一些你无法扭转的事情?

更多时间 [segunolumbe.com (英语)](https://segunolumbe.com/)。 。 。 . _静态分析,永远不要模型._

## 常见问题

### @bashbop/solumbe 是什么？

Solumbe:确定本地寄存器的背景,影响分析,以及合并证据\.

### 如何安装 @bashbop/solumbe？

在项目目录运行 npm install @bashbop/solumbe，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 solumbe，可以用 npx solumbe 直接运行。

### @bashbop/solumbe 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bashbop\_\_solumbe 是否存在。

### @bashbop/solumbe 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @bashbop/solumbe 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @bashbop/solumbe 可以商用吗？

@bashbop/solumbe 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bashbop/solumbe 的下载量有多少？

根据 npm 官方下载统计，@bashbop/solumbe 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,582 次，日均约 86 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bashbop/solumbe 还在维护吗？

最新版本 4\.10\.0 发布于 2026/11/01（7 天前）；至今共发布 14 个版本，其中过去 12 个月发布了 14 个；首次发布于 2026/10/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。