# @ai-matrx/coding-sessions 中文文档

规范地址：https://npmcn.com/package/%40ai-matrx/coding-sessions/

版本：0\.3\.637
npm 元数据更新时间：2026-10-30T13:20:52.229Z
中文译文更新时间：2026-11-05T17:53:28.427Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ai-matrx/coding-sessions
原文对照：https://npmcn.com/package/%40ai-matrx/coding-sessions/?lang=original
项目主页：https://github.com/AI-Matrix-Engine/aidream/tree/main/apps/shared/coding-sessions#readme
源码仓库：https://github.com/AI-Matrix-Engine/aidream

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

- 包体积（解压后）：41.4 MB，1351 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.18
- 运行依赖：11 个
- peer 依赖：react \>=19\.0\.0，react-dom \>=19\.0\.0
- 首次发布：2026-09-28T23:36:27.941Z
- 最新版本发布：2026-10-30T13:20:51.993Z
- 近 30 天下载量：130198（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：728（近 12 个月 728 个）

## 中文简介

从AI Matrx驱动用户自有的克洛德代码和代码(Claude Code and Codex)——在自己的订阅登录上,没有API密钥——并接管他们在别处开始的聊天. 引擎将Paperclip的麻省理工学院的司机套件包装在发现的2026-09-27个钉子(清洁环境)的每个固定器中

## 安装

```sh
npm install @ai-matrx/coding-sessions
```

也可以使用：`pnpm add @ai-matrx/coding-sessions`、`yarn add @ai-matrx/coding-sessions`、`bun add @ai-matrx/coding-sessions`

## README

# @ai-matrx/编码会话

开车的人 **拥有** Claude Code和Codex——在自己的订阅登录上,没有API 键——来自AI Matrx,并接管他们在其他地方开始的聊天. 一个干净的屏幕,没有终端.

-   **`./engine`** (节点)——开始,跟进,停止并接管编码会话. 环绕剪贴板 麻省理工学院驱动软件包(`@paperclipai/adapter-claude-local`, (中文(简体) ), `@paperclipai/adapter-codex-local`, (中文(简体) ), `@paperclipai/adapter-utils`我们的2026-09-27的钉子都在里面.
-   **`./server`** (节点) — 本地主机: HTTP + WebSocket on `127.0.0.1` 只有一次发射后 随机标记。 服务于屏幕,并把它接上引擎.
-   **`./react`** ——屏幕:运行 ——最近 ——你的其他聊天,现场录音 `@ai-matrx/chat` (马克下答,可折叠的工具卡,流出),作曲家,和New 会话流程。 光阴相克.
-   **`.`** ——纯半个:类型,提供者正常化器,投射到聊天信息中, 和WebSocket的运输.

## 运行屏幕

```sh
npx coding-sessions host start --port 4789
# CODING_SESSIONS_URL=http://127.0.0.1:4789/?token=…
```

打开打印的 URL 。 信使读出一次,只保存该分页,然后从地址取出 栏。 主机拒绝任何没有符号或来自其他来源的套接字 .

## 直接使用引擎

```ts
import { createCodingSessionsEngine } from "@ai-matrx/coding-sessions/engine";

const engine = await createCodingSessionsEngine();
engine.subscribe((event) => console.log(event)); // session · run · item (normalized, both providers)

const providers = await engine.providers();       // installed, version, signed in, subscription vs API
const others = await engine.discoverSessions();    // existing Claude Code + Codex chats on this computer

const { session, run } = await engine.start({ provider: "claude", cwd: "/path/to/repo", prompt: "Fix the flaky test" });
await engine.send(session.id, "Now add a regression test"); // queues if a run is live
await engine.stop(run!.runId);

const taken = await engine.takeover({ provider: "codex", providerSessionId: others[0].providerSessionId, cwd: others[0].cwd! });
await engine.send(taken.id, "Pick up where we left off");
```

译名保留在提供者自己的文件中(`~/.claude/projects`, (中文(简体) ), `~/.codex/sessions`; 计 数 引擎只保留一个小会话索引并运行于 `~/.matrx/coding-sessions/index.json`。 。 。 .

**账目和限额.** 与东道主 `accounts` 端口,每个账户都保持自身的健康 使用量( Claude 代码: 从其运行量” ) `rate_limit_event`; Codex: 其用法探测器),所以限制在一上 账户从不屏蔽另一个账户。 当一个会话的账户有限,另一个签入的账户 同样的应用程序是免费的, `providers()` 说吧`continueOn`)和屏幕提供"继续 " ; `engine.continueOnAccount(sessionId, accountId)` 复制聊天内容到账户 回到原地再转弯 主机的取号是引擎选项 `switchAccount: "off" | "offer"` (默认) `"offer"`) (中文(简体) ).

## 在您的应用程序中挂起屏幕

```tsx
import { createWebSocketTransport } from "@ai-matrx/coding-sessions";
import { CodingSessionsApp } from "@ai-matrx/coding-sessions/react";

<CodingSessionsApp transport={createWebSocketTransport({ url: "ws://127.0.0.1:4789/ws", token })} />;
```

一个桌面外壳通过执行将 WebSocket 替换为 IPC `CodingSessionsTransport` 在线 侧并呼叫 `createHostBridge(engine).handle(method, args)` 在另一个方面,即: 引擎永远不变.

Styling:屏幕采用设计系统的语义"Tailwind"类. 尾风 v4 主机导入 `@ai-matrx/design-system/theme.css`,聊天软件包 `tokens.css` 财务报告和审定财务报表 `styles.css`添加 这个包裹 `dist` 作为 `@source`的页面 `./server` 所有的船都编了起来.

## 它故意不这样做

-   **工具许可审批.** 绕过它们运行( Claude 的驱动默认; Codex 运行于其中) 拥有工作空间- 写有网络的沙盒 。 批准是后来的一个特点.
-   **复制笔录.** 读取聊天会读取提供者自己的文件; 没有复制内容 .

## 许可证

麻省理工学院. 装入剪纸 AI在运行时间的麻省理工学院许可驱动软件包——参见 `NOTICE`。 。 。 .

## 常见问题

### @ai-matrx/coding-sessions 是什么？

从AI Matrx驱动用户自有的克洛德代码和代码\(Claude Code and Codex\)——在自己的订阅登录上,没有API密钥——并接管他们在别处开始的聊天\. 引擎将Paperclip的麻省理工学院的司机套件包装在发现的2026-09-27个钉子\(清洁环境\)的每个固定器中

### 如何安装 @ai-matrx/coding-sessions？

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

### @ai-matrx/coding-sessions 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @ai-matrx/coding-sessions 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ai-matrx/coding-sessions 需要什么版本的 Node\.js？

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

### @ai-matrx/coding-sessions 可以商用吗？

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

### @ai-matrx/coding-sessions 的下载量有多少？

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

### @ai-matrx/coding-sessions 还在维护吗？

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