# @adlc/parallax 中文文档

规范地址：https://npmcn.com/package/%40adlc/parallax/

版本：1\.12\.0
npm 元数据更新时间：2026-10-10T03:06:46.907Z
中文译文更新时间：2026-11-06T00:40:55.447Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40adlc/parallax
原文对照：https://npmcn.com/package/%40adlc/parallax/?lang=original
项目主页：https://github.com/voodootikigod/adlc/tree/main/packages/parallax#readme
源码仓库：https://github.com/voodootikigod/adlc

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

- 包体积（解压后）：54.2 kB，8 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：2 个
- 首次发布：2026-06-13T21:12:39.022Z
- 最新版本发布：2026-10-10T03:06:46.512Z
- 近 30 天下载量：8081（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

通过取样多样性进行测量-矛盾性讯问——扇子N完成,只显示相差(D3).

## 安装

```sh
npm install @adlc/parallax
```

也可以使用：`pnpm add @adlc/parallax`、`yarn add @adlc/parallax`、`bun add @adlc/parallax`

## README

# @ adlc/ parallax

对地物要求、票边合同和建设中路线问题进行测量-矛盾审讯。 将单一模式的回顾替换为 **将多样性取样作为一种工具**: 扇子 N 独立的廉价级完成, diff 读取, 表面仅将相差作为多选题.

**ADLC 阶段 :** D3 — 测量模糊度

* * *

## 模式

### SPEC MODE( 默认)

Fan N 独立读者通过原始特性请求. 每人承诺一次阅读,并输出结构化的光谱. 中级完成将读取的读取分解为 **协议设定** (规格草案)和 **差异** (问题只有人类才能回答). 一个模糊的分数 打开输出.

```
parallax --request "text"
parallax --file req.md
echo "feature request" | parallax
```

### EDGE 模式

Fan N代理在开发DAG中超过两张相邻的门票. 每位独立作者之间隐含的界面/合同。 同样的分辨分析 打开边缘合同是否安全 推测.

```
parallax --edge T1 T2
parallax --edge T1 T2 --tickets path/to/tickets.json
```

### RUTE MODE(模糊路由器)

Fan N 代理以回答给定的问题可选上下文文件 。 法官的完成决定这些答案在本质上是否相当。 如果是,请打印答案并退出 0。 如果没有,请打印多选择相差并2号出口.

```
parallax --route "question"
parallax --route "question" --context spec.md --context arch.md
```

* * *

## 旗帜

| 旗帜 | 默认 | 说明 |
| --- | --- | --- |
| `--request <text>` | —— 说 | 光谱模式: 特性请求内置 |
| `--file <path>` | —— 说 | 光谱模式: 文件的特性请求 |
| `--edge` | 虚假 | 边缘模式:跟随两个票号作为位置 |
| `--route <text>` | —— 说 | 路线模式: 向路线提问 |
| `--context <file>` | —— 说 | 路由模式:上下文文件(可重复) |
| `--context-cap <n>` | 6000个 | 路由模式: 最大字符嵌入量 `--context` 文件 (尾部偏差)。 盖上的文件被标记为切换为即时. |
| `--tickets <path>` | `.adlc/tickets.json` | 边缘模式的入票文件 |
| `--n <int>` | 3个 | 扇宽(独立读取次数). 最少2个——一读不能相提并论. |
| `--allow-partial-fan` | 虚假 | 接受从读数比 `--n` 请求。 默认关闭: 缩小的样本 偏差得分 向过关. |
| `--threshold <0-1>` | 0.25 (中文(简体) ) | 模糊分数门阀 |
| `--tier cheap|mid|frontier` | 便宜的扇子,中间的分数 | 覆盖 LLM 级 |
| `--json` | 虚假 | 机器可读输出(分数+分数) |
| `--prompt-only` | 虚假 | 打印精确的提示, 0 出站口——不需要 API 密钥 |
| `--record-verdict <file|->` | —— 说 | 与 `--prompt-only`:从 `<file>` (或时叫: `-`并记录为 `.adlc/manifest.jsonl` 通过 `gate-manifest` (所有三种模式). 要求数 `--ticket`。 。 。 . |
| `--ticket <id>` | —— 说 | 车票是证据 要求为 `--record-verdict` ——无约束记录可以满足任何门票的P1门. |

`--context` 文件内容( 路由模式) 和票面标题和正文( 上行模式) 是 寄存器控制——任何可以打开公关以对抗此回购,或添加出票,控制器的人 风扇的读取和答案是模式输出 来源于文字之前 法官读过 都当作是 **未信任的数据**:它们被包裹在可憎的围栏中,然后被嵌入 快速,有一个长期指令 告诉模型 栅栏内容是数据分析, 绝不是遵循的教诲,即使它象一个教诲一样.

* * *

## 退出代码

| 代码 | 含义 |
| --- | --- |
| 0 个 | 门口通过——模糊分分 分(分/分),或答案等同(路由) |
| 1个 | 操作错误——输入不良,文件缺失,网络故障,读取不足,没有收缩的扇子 `--allow-partial-fan`,或外震相差或路由判断有效载荷 |
| 2个 | 门失败 -- -- 模糊分数 > 阈值(光谱/对接),或答案相去甚远(路线) |

### 判决需要什么

parallax拒绝验证它实际上没有进行的读取。 三个警卫,全部 操作出错(出错1),从不计分 :

-   **室外相差有效载荷.** 中层分歧呼吁被要求 `{agreements: [...], divergences: [...]}`。拒绝对象,切换 `{}`, (中文(简体) ), 空数组或 `{result: ...}` 包装器曾经掉入"零" 差异,零协议),它得分为0并经过大门——a 未经分析的线索报告为明确无误。 这种有效载荷现已被拒绝.
-   **外切马路线判断有效载荷.** 要求路由等同法官 `{equivalent: boolean, answer, variants}`。 。 。 . `equivalent` 一定是真实的 布尔( 诸如 `"false"` 被拒绝的,而不是被胁迫的)等同物 判决必须不空 `answer`,并且一个不等于至少一个 字符串 `variant`. 任何其它的都被拒绝,而不是报告为通行证 (与 `--questions-json`或作为未测量的分界线.
-   **嘘出扇子来.** 分数是跨度的 `--n` 独立读取,所以 由于费率限制、超时或无法分解的JSON测量的风扇缩小 (笑声) 样本和分数系统化的LOWER——它偏向于通过。 少时 除非 `--allow-partial-fan` 给出. `requested` 财务报告和审定财务报表 `used` 两者都出现 `--json` 财务报告和审定财务报表 `--questions-json` 这样机器消费者就能看到有效的宽度 而不是不得不注意到 `warnings` 输入.

`--n 1` 在解析时被拒绝: 一次读取永远无法比对 另一个,所以它只能花 API呼叫在去错误的路上.

* * *

## 报告格式

**SPEC / EDGE 模式输出 :**

```markdown
## Agreement set (draft spec)
- <thing all readings agreed on>
- ...

## Divergences — answer these
**Q1: <ambiguous point>**
  A) <reading 1's choice>
  B) <reading 2's choice>

---
**Ambiguity score:** 0.33 (threshold 0.25) — gate FAILS ✗
```

**ROUTE模式输出(等同):**

```
<The single consensus answer, printed directly>
```

**ROUTE 模式输出(潜水员):**

```markdown
## Route conflict — answer required

**Question:** <question>

**Interpretations:**
  A) <variant 1>
  B) <variant 2>
```

* * *

## JSON产出(`--json`(中文(简体) )

光谱/尖端:

```json
{
  "mode": "spec",
  "agreements": ["..."],
  "divergences": [{"point": "...", "options": [{"label": "A", "reading": "..."}]}],
  "score": 0.33,
  "threshold": 0.25,
  "gate": false,
  "requested": 3,
  "used": 3,
  "warnings": []
}
```

路线 :

```json
{
  "mode": "route",
  "question": "...",
  "equivalent": false,
  "answer": "",
  "variants": ["option A", "option B"],
  "requested": 3,
  "used": 3,
  "warnings": []
}
```

* * *

## 模糊分数

`score = divergences / (divergences + agreements)`,四舍五入到小数点后2位.

-   0.00 = 完美趋同(无所要求)
-   1.00 = 总差异(完全没有协议)
-   默认闸口阈值:0.25

分数是关键输出:一个以分数为0.00的N=5相汇合的分数是比任何单一模式的完整表态都安全得多的文物.

* * *

## 与兄弟姐妹工具的关系

-   **烧烤我** ——前身;通过反省审讯(单上下文,相接). `parallax` 替换为测量.
-   **spec-lint (C1) (英语)** ——可以根据模糊的分数 `parallax` 发射.
-   **模型路由器(D2)** - 使用边缘合同 `parallax --edge` 在投机性执行之前验证.
-   **flail 检测器** - 触发器 `parallax --route` 中建到路由建设者通过机器提问,然后升级为人类.

* * *

## 记录操作员的快速裁决

Claude Code(以及没有赤裸的API密钥的类似用具) `--prompt-only` 参数通常如何运行:工具打印出扇出提示 操作员(模型本身)回答它们并应用判断. 无 `--record-verdict`自我评估的判决从未进入审计线索—— 只能看到已打印的提示. `--record-verdict <file|->` 在每个模式( spec / 边缘 / 路由) 中关闭空格: 打印后 就像往常一样,它读到操作员的回答 `<file>` (或stdin语) 何时 `-`并记录到 `.adlc/manifest.jsonl` 通过 `@adlc/gate-manifest`属于自己的 `record()` - 重新使用散列链/签名 逻辑而不是重用它.

```sh
# Spec mode
parallax --request "Add a login page" --prompt-only --ticket T1 --record-verdict verdict.txt

# Edge mode
parallax --edge T1 T2 --prompt-only --ticket T1 --record-verdict -

# Route mode
parallax --route "What is the retry policy?" --prompt-only --ticket T1 --record-verdict verdict.txt
```

`--record-verdict` 需求 `--prompt-only` 财务报告和审定财务报表 `--ticket` (另除一); 因为可以重播一张无限制的记录 满足任何门票的P1门。 记录 条目 `gate` 实值 `parallax`, (中文(简体) ), `data.verdict` 保存运算符的文本 逐字记录和 `data.mode` 外加特定模式上下文(`tickets` 为了边缘, `question` 为路线, `request` 确定分析的内容.

**光谱模式 + `--record-verdict -` 得到的恰: (笑声)** ,如果请求文本 实值 _(单位:千美元)_ 从 stdin 读取(即无) `--request` 也没有 `--file` 曾经 给予, `--record-verdict -` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}不能用 - {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}两个都想用同样的水 stdin stream, 请求总是首先读取 。 Parallax 检测到这个 组合和退出 1 有明显的错误而不是默读错误 输入。 使用 `--request`编号 :`--file` 请求文本,或将裁决书写到 文件和通过 `--record-verdict <file>` 相反:

```sh
# Does NOT work: both request and verdict want stdin — exits 1 with an
# explanatory error instead of silently misreading input
echo "Add a login page" | parallax --prompt-only --ticket T1 --record-verdict -

# Works: request via --request, verdict via stdin
parallax --request "Add a login page" --prompt-only --ticket T1 --record-verdict -

# Works: request via stdin, verdict via file
echo "Add a login page" | parallax --prompt-only --ticket T1 --record-verdict verdict.txt
```

* * *

## 核心差距

无。 所有所需职能`fan`, (中文(简体) ), `complete`, (中文(简体) ), `extractJson`, (中文(简体) ), `loadTickets`, (中文(简体) ), `promptOnly`, (中文(简体) ), `parseArgs`, (中文(简体) ), `pass`, (中文(简体) ), `gateFail`, (中文(简体) ), `opError`, (中文(简体) ), `printJson`, (中文(简体) ), `readStdin`) 存在于 `@adlc/core`. 记录只使用即时判决的再利用情况 `@adlc/gate-manifest`是因为 `record()` 直接( 见 `lib/verdict.mjs`而不是重新实施散列链/签名逻辑.

## 常见问题

### @adlc/parallax 是什么？

通过取样多样性进行测量-矛盾性讯问——扇子N完成,只显示相差\(D3\)\.

### 如何安装 @adlc/parallax？

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

### @adlc/parallax 支持 TypeScript 吗？

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

### @adlc/parallax 支持 ESM 还是 CommonJS？

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

### @adlc/parallax 需要什么版本的 Node\.js？

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

### @adlc/parallax 可以商用吗？

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

### @adlc/parallax 的下载量有多少？

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

### @adlc/parallax 还在维护吗？

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

