# @ekwo-ai/journal-items 中文文档

规范地址：https://npmcn.com/package/%40ekwo-ai/journal-items/

版本：0\.25\.2
npm 元数据更新时间：2026-11-13T14:12:15.775Z
中文译文更新时间：2026-11-13T17:55:45.303Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ekwo-ai/journal-items
原文对照：https://npmcn.com/package/%40ekwo-ai/journal-items/?lang=original
项目主页：https://github.com/Ekwo-ai/ekwo-os/tree/main/packages/formats/journal-items#readme
源码仓库：https://github.com/Ekwo-ai/ekwo-os

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

- 包体积（解压后）：63.4 kB，23 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-09-22T09:39:43.505Z
- 最新版本发布：2026-11-13T14:12:15.286Z
- 近 30 天下载量：3291（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

将日记项目导出为 CSV —— 每行一行, 包括条目、 日记、 日期、 账户、 合伙人、 借记项和贷记项, 并附有账户图和其旁出口的伙伴, 输入到 TypeScript 中的平面对象: 金额为 Decima

## 安装

```sh
npm install @ekwo-ai/journal-items
```

也可以使用：`pnpm add @ekwo-ai/journal-items`、`yarn add @ekwo-ai/journal-items`、`bun add @ekwo-ai/journal-items`

## README

# `@ekwo-ai/journal-items`

读取一个 **导出日记项目** ——每个条目的行数,每行一行 的列表视图中的 CSV 线条 ——入平面对象,在 TypeScript 中,没有依赖性。 临Τ 账户图表和从同一屏幕导出的伙伴.

```ts
import { readJournalItems } from '@ekwo-ai/journal-items';

const books = readJournalItems([items, accounts, partners]); // any order; the last two are optional

books.entries;    // [{ number: 'INV/2025/00001', journal: 'Customer Invoices', date: '2025-01-15', lines: […] }, …]
books.accounts;   // [{ code: '400000', name: 'Receivable', type: 'Receivable' }, …]
books.contacts;   // the partners, with their tax ID and e-mail when the partners file has them
books.currency;   // the company currency the export states, or null
books.violations; // an entry that does not balance, a line of a draft entry
```

## 文件

每个文件都由其标题识别,因此可以按任何顺序给出.

**日记项目** (所须. 栏名取出于其中之一 拼写导出用途——一个人读取的标签,或 再导入的导出字段写道:

| 栏 | 标签 | 字段名称 |
| --- | --- | --- |
| 条目 | `Number`,或 `Journal Entry` | `move_name`,或 `move_id` |
| 日记 | `Journal` | `journal_id` |
| 日期 | `Date` | `date` |
| 账户 | `Account` | `account_id` |
| 合作伙伴 | `Partner` | `partner_id` |
| 标签 | `Label` | `name` |
| 参考文献 | `Reference` | `ref` |
| 借记 -- -- 贷记 | `Debit`, (中文(简体) ), `Credit` | `debit`, (中文(简体) ), `credit` |
| 货币,数额 | `Currency`, (中文(简体) ), `Amount in Currency` | `currency_id`, (中文(简体) ), `amount_currency` |
| 公司货币 | `Company Currency` | `company_currency_id` |
| 应交日期 | `Due Date` | `date_maturity` |
| 匹配 | `Matching #` | `matching_number` |
| 状态 | `Status` | `parent_state` |

-   线条在共享时属于一个条目 **编号**;没有这个 栏中,其显示名称.
-   一个 **账户** 其代码和名称 (单位:千美元)`400000 Receivable`) (中文(简体) ). 用旁边的图表 显示整个; 不,代码是第一个空间之前的.
-   A 类 **合作伙伴** 以它的名义到达,并被它识别.
-   条目为 **未张贴** 拒绝在 `violations`: 过滤 在张贴的条目中导出,这是图书制作的.
-   **日期** 是 ISO, 是 ISO, 是 ISO, 是 ISO, 是 ISO, 是 ISO, 是 ISO , 是 ISO , 是 ISO , 是 ISO, `YYYY-MM-DD`· ; **金额** 有个小数点的分数, a减去负数。 负借记是借记,反之亦然 圆相.
-   带有导出 **分组** 无法保存为 CSV; 删除 先组. 电子表格导出在读取前保存为 CSV .

**会计科目表** (可选) : `Code`, (中文(简体) ), `Account Name` 或者说 `Name`, (中文(简体) ), `Type` (或 `code`, (中文(简体) ), `name`, (中文(简体) ), `account_type`) (中文(简体) ). 该类型被保留在源词中.

**合作伙伴** (可选) : `Name`, (中文(简体) ), `Tax ID`, (中文(简体) ), `Email`, (中文(简体) ), `Company ID`,则 国家作为双字母代码(`Country/Country Code`)——写作: 它的名字不会变成代码.

## 它的回报

所申报的形状 [`src/types.ts`](https://npmcn.com/package/%40ekwo-ai/journal-items/src/types.ts)字段 字段,此寄存器中会计导出每个读取器的形状 自行申报. 数量是十进制字符串, 绝不是负数; 边是 标志。 说不通的又回来了 `violations` 输入会来 返回为已写入 ; 哪些不是日记项目导出为 `BooksFileError` 带有 `code`。 。 。 .

它不知道账目表。 每个代码的哪个图表 成为进口商的业务: [电子操作系统](https://github.com/Ekwo-ai/ekwo-os), (中文(简体) ), `ekwo import journal-items <files…>`。 。 。 .

## 来源

这个读取器被写成反对输出 **日记项目** 奥多 第17和18版(会计),2026年9月22日读自:

-   [进出口数据——Odoo 17.0文件](https://www.odoo.com/documentation/17.0/applications/essentials/export_import_data.html) 财务报告和审定财务报表 [18.0 国家](https://www.odoo.com/documentation/18.0/applications/essentials/export_import_data.html)数字 : 导出的两个模式、 ISO 日期、 导出字段名称 重新进口;
-   会计单元的来源,第17.0条: [`account_move_line.py`](https://github.com/odoo/odoo/blob/17.0/addons/account/models/account_move_line.py), (中文(简体) ), [`account_account.py`](https://github.com/odoo/odoo/blob/17.0/addons/account/models/account_account.py), (中文(简体) ), [`res_partner.py`](https://github.com/odoo/odoo/blob/17.0/odoo/addons/base/models/res_partner.py) 财务报告和审定财务报表 [`export.py`](https://github.com/odoo/odoo/blob/17.0/addons/web/controllers/export.py)数字 : 上面每个字段的标签、账户的显示名称和方式 CSV被写出——逗号,双引号,UTF-8,为小数点.

`ekwo import odoo <files…>` 与 `ekwo import journal-items`。 。 。 .

固定装置 `test/fixtures/` 由这些页手写 没有真实的数据.

麻省理工学院.

## 常见问题

### @ekwo-ai/journal-items 是什么？

将日记项目导出为 CSV —— 每行一行, 包括条目、 日记、 日期、 账户、 合伙人、 借记项和贷记项, 并附有账户图和其旁出口的伙伴, 输入到 TypeScript 中的平面对象: 金额为 Decima

### 如何安装 @ekwo-ai/journal-items？

在项目目录运行 npm install @ekwo-ai/journal-items，或使用 pnpm add / yarn add / bun add。

### @ekwo-ai/journal-items 支持 TypeScript 吗？

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

### @ekwo-ai/journal-items 支持 ESM 还是 CommonJS？

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

### @ekwo-ai/journal-items 需要什么版本的 Node\.js？

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

### @ekwo-ai/journal-items 可以商用吗？

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

### @ekwo-ai/journal-items 的下载量有多少？

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

### @ekwo-ai/journal-items 还在维护吗？

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