# @cgh567/agent 中文文档

规范地址：https://npmcn.com/package/%40cgh567/agent/

版本：2\.6\.62
npm 元数据更新时间：2026-11-05T04:23:12.960Z
中文译文更新时间：2026-11-09T09:03:36.019Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40cgh567/agent
原文对照：https://npmcn.com/package/%40cgh567/agent/?lang=original
项目主页：https://github.com/elyntic-agi/elyntic-agent#readme
源码仓库：https://github.com/elyntic-agi/elyntic-agent

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

- 包体积（解压后）：44.7 MB，2620 个文件
- TypeScript 类型：未声明
- Node.js 要求：^22\.19\.0 \|\| \>=23\.6\.0
- 运行依赖：44 个
- peer 依赖：react ^18\.3\.1 \|\| ^19\.0\.0，electron \>=30，@sinclair/typebox \*，@helios-agent/pi-ai \*，@helios-agent/pi-tui \*，@helios-agent/pi-agent-core \*，@helios-agent/pi-coding-agent \*
- 首次发布：2026-06-25T21:57:42.726Z
- 最新版本发布：2026-11-05T04:23:12.816Z
- 近 30 天下载量：10657（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：74（近 12 个月 74 个）

## 中文简介

私自改进实验室

## 安装

```sh
npm install @cgh567/agent
```

也可以使用：`pnpm add @cgh567/agent`、`yarn add @cgh567/agent`、`bun add @cgh567/agent`

## README

# 爱林特特工

Elyntic是一个多代理系统 建立在 [Pi](https://github.com/mariozechner/pi-coding-agent)它提供一名管弦乐手、工人代理人、技能和扩展.

## 快速启动

```bash
# 1. Install the Elyntic command (Node.js 22.19+)
npm install -g @cgh567/agent

# 2. Clone this repo
git clone https://github.com/elyntic-agi/elyntic-agent.git ~/elyntic-agent

# 3. Bind the CLI to this checkout, then run setup
export ELYNTIC_DIR="$HOME/elyntic-agent"
cd ~/elyntic-agent && bash setup.sh

# 4. Set an API key if using Anthropic
export ANTHROPIC_API_KEY=sk-ant-YOUR_KEY_HERE

# 5. Start Elyntic
elyntic
```

保留 `ELYNTIC_DIR` 在从新 shell 发射时设置; 否则, 全局命令会使用已安装的软件包副本。 安装器目前创建一个 `~/helios-agent` 兼容并联链接,因为它的设置和脚本仍然使用该路径. 这不是第二次离职.

## 你得到的东西

### 叶林克(Orchestrator)

Elyntic将复杂的任务分成平行子剂. 它从不直接写代码——它代表专门人员.

### 未成年人(工人)

Minion代理执行任务时使用有11个完成前门的TDD. 每个工人都接受一个单项任务,并磨到完成为止.

### 代理角色

| 探员 | 作用 |
| --- | --- |
| **侦察兵** | 快速密码库侦察 |
| **规划员** | 任务图表创建 |
| **劳动者** | TDD 实施 |
| **审查者** | 横向代码审查 |
| **法官** | 周期评价 |
| **副规划员** | 递归性子系统规划 |
| **调试工作** | 运行时错误诊断 |
| **研究员** | 网络研究 |
| **上下文构建器** | 需求分析 |

每个角色支持的模型在它的文档中被宣布 [代理人](https://npmcn.com/package/%40cgh567/agent/agents)。 。 。 .

### 调度引擎

1.  **子剂 ()** ——单项任务,并列批次,连锁管线
2.  **坐标( )** - 结构化TASK-XX与平行工人的规格+审查
3.  **乐团.sh** - 以壳为主的规划员-工人-法官循环

### 技能

-   **工程学** ——TDD工作流程,完成前闸机,设计高压
-   **私家侦探** 多周期规划员、工人、法官
-   **宫廷主义** - 代表团执行议定书
-   **私处保健** - 系统健康诊断
-   **焦点** - 提高对发展背景的认识
-   **代理护卫员** 防止代理人合并公关
-   **技能图** ——记忆知识图集成

### 扩展

软件包和扩展路径在 [设置.json](https://npmcn.com/package/%40cgh567/agent/settings.json)设置装入这些软件包和本地 [扩展](https://npmcn.com/package/%40cgh567/agent/extensions) 目录.

## 使用量

```sh
# Elyntic orchestrates (delegates to workers)
export ELYNTIC_DIR="$HOME/elyntic-agent"
elyntic "Build a REST API with JWT auth"
```

可选 [循环运行器](https://npmcn.com/package/%40cgh567/agent/skills/elyntic-orchestrator/scripts/orchestrate.sh) 需要单独的 `pi` CLI (中文(简体) )`npm install -g @cgh567/cli`),有PYAML的Python,以及一个 `timeout` 命令其核查路径。 在使用前先检查这些先决条件.

在Elyntic会话内,使用它的代理工具(这些不是 shell 命令):

```js
// Direct agent dispatch
subagent({ agent: "worker", task: "Add rate limiting to /api/login" })

// Parallel workers
subagent({ tasks: [
  { agent: "worker", task: "Task 1: Add bcrypt" },
  { agent: "worker", task: "Task 2: Create login endpoint" }
]})

// Execute an existing structured plan
coordinate({ plan: "specs/auth.md" })
```

## 结构

```
~/elyntic-agent/
├── agents/                  # Agent definitions
│   ├── worker.md            # Minion worker (TDD + 11 gates)
│   ├── planner.md           # Elyntic planner (hypothesis-driven)
│   ├── judge.md             # Cycle evaluator (semi-formal verification)
│   ├── elyntic-system.md    # Elyntic system-agent definition
│   ├── coordination/        # Variants for coordinate() engine
│   └── crew/                # Variants for pi-messenger Crew
├── docs/                    # Documentation index and references
│   ├── README.md            # Docs index
│   └── guide/               # Agent-readable installation and setup guides
│       └── installation.md  # Step-by-step installation guide
├── prompts/                 # Templates (post-mortem, adversarial-review)
├── skills/                  # Skills loaded on demand
├── extensions/              # Local extension hooks
├── scripts/                 # Utility scripts
├── .planning/               # GSD lifecycle artifacts (gitignored transient data)
│   ├── PLAN.md              # Goal-backward plan (discuss → plan)
│   ├── CONTEXT.md           # Discuss-phase findings
│   ├── VERIFICATION.md      # Verifier output
│   └── debug/               # Transient debug sessions (active/ is gitignored)
├── AGENTS.md                # Agent-readable project context (per-directory)
├── settings.json            # Pi config + extension manifest
└── setup.sh                 # Installer
```

## GSD 生命周期

每个非部落任务都遵循GSD(Get Shit Done)执行标准:

```
discuss → plan → execute → verify
```

1.  **讨论** - Elyntic确定灰色区域,提出澄清问题,并产生 `CONTEXT.md`
2.  **计划** ——规划师(惠勒)创造后进 `PLAN.md` 以波为主的任务分解
3.  **执行** ——工人(戴森)使用TDD:RED → GREEN → Refactor,并有管道核查
4.  **校验** - 验证器(汉斯)检查变量、数据流动和接受标准,生成 `VERIFICATION.md`

艺术家住在 `.planning/` 在雷波根。 临时调试会话( T)`.planning/debug/active/`)为被克.

## 代理可读安装指南

文件 `docs/guide/installation.md` 是一种结构化的,机器可读的指南,为AI代理(Elyntic,工人)在设置任务期间所消耗. 它涵盖:

-   先决条件和环境设置
-   依赖性安装令
-   延期登记
-   健康检查和吸烟检查

人类的使用者也能读取它——它是镜子 `setup.sh` 但有道理 和排除麻烦的背景.

## 桌面应用程序

这个仓库提供代理运行时间 。 桌面应用单独开发.

## 纸张参考文献

根据 ["代理代码解释"](https://arxiv.org/abs/2603.01896v2) (Anthropic 2026) (英语:

-   模糊的测试后卫(cpp 3)
-   名称分辨率审计(django-13670)
-   间接检查( Mockito 8)
-   确信错误的回答警告( py 5)
-   完成前清单中的第11-12个门

## 常见问题

### @cgh567/agent 是什么？

私自改进实验室

### 如何安装 @cgh567/agent？

在项目目录运行 npm install @cgh567/agent，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@sinclair/typebox（\*）、@helios-agent/pi-ai（\*）、@helios-agent/pi-tui（\*）、@helios-agent/pi-agent-core（\*）、@helios-agent/pi-coding-agent（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 elyntic、elyntic-rpc、elyntic-prepare-agent-store，可以用 npx elyntic 直接运行。

### @cgh567/agent 支持 TypeScript 吗？

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

### @cgh567/agent 需要什么版本的 Node\.js？

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

### @cgh567/agent 可以商用吗？

@cgh567/agent 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @cgh567/agent 的下载量有多少？

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

### @cgh567/agent 还在维护吗？

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