@agentplaneorg/core

中文文档
0.7.13发布于 2026/11/04MITTypeScriptES Module构建来源已验证近 30 天下载 1903

Agentplane存储器核心库 -- -- 本土任务、政策和核查工作流程.

中文使用文档
文档目录7 节
  1. 安装
  2. 所需资源
  3. 使用量
  4. 导出模块
  5. 稳定
  6. 文档
  7. 许可证

Agentplane header

@ agentplaneorg/core (英语)

npm License: MIT Node.js 20+

A. 全球环境基金使用的核心公用事业和模式 agentplane CLI(英语:CLI).

这个包赋予CLI的可重现合同:项目发现,配置加载, 承诺主体验证、任务 README 解析/移交、任务导出、代理更改记录(ACR) 计划助手和工作流程元数据公用事业。 如果您是终端用户, 请另安装 CLI :

npm install -g agentplane

安装

npm install @agentplaneorg/core

所需资源

  • 节点.js 20+
  • 仅限无害环境管理(type: module(中文(简体) )

使用量

import {
  resolveProject,
  loadConfig,
  listTasks,
  readTask,
  buildTasksExportSnapshot,
} from "@agentplaneorg/core";

const project = await resolveProject(process.cwd());
const config = await loadConfig(project.root);
const tasks = await listTasks(project.root);
const task = await readTask(project.root, tasks[0]?.id ?? "");
const snapshot = await buildTasksExportSnapshot(project.root);

console.log(config.data.workflow_mode, task?.id, snapshot.meta.version);

根导入是后相容的聚合导出. 偏好新代码的窄子路径 :

import { validateCommitSubject } from "@agentplaneorg/core/commit";
import { GitContext } from "@agentplaneorg/core/git";
import { runProcess } from "@agentplaneorg/core/process";
import { renderTaskReadme } from "@agentplaneorg/core/tasks";

导出模块

导入路径区域要点
@agentplaneorg/core完整 API向后兼容总导出
@agentplaneorg/core/commit提交提交主题解析和验证
@agentplaneorg/core/config配置配置方案、加载、验证和默认处理
@agentplaneorg/core/fs文件系统原子写入助手
@agentplaneorg/core/git图形Git 语境、 基础分支帮助和已更改的文件帮助
@agentplaneorg/core/process进程进程执行助手
@agentplaneorg/core/schemas示马斯Schema 渲染器、 ACR 计划访问和任务元数据验证器
@agentplaneorg/core/tasks任务任务文件、任务存储、任务输出和 README 提供公用事业

稳定

表面稳定
已公布的子路径导出在补丁释放之间保持稳定
根总导出向后兼容直到断开
内部文件布局不公开 API
任务/合同通过可重现光谱版本

文档

许可证

麻省理工学院

版本与发布记录

@agentplaneorg/core 共发布 111 个版本,首次发布于 2026/02/02;过去 12 个月发布了 111 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.7.13latest2026/11/044 天前
0.7.122026/09/291 个月前
0.7.112026/09/221 个月前
0.7.102026/09/201 个月前
0.6.302026/09/171 个月前
0.7.92026/09/171 个月前

关于 @agentplaneorg/core 的常见问题

@agentplaneorg/core 是什么?

Agentplane存储器核心库 -- -- 本土任务、政策和核查工作流程.

如何安装 @agentplaneorg/core?

在项目目录运行 npm install @agentplaneorg/core,或使用 pnpm add / yarn add / bun add。

@agentplaneorg/core 支持 TypeScript 吗?

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

@agentplaneorg/core 支持 ESM 还是 CommonJS?

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

@agentplaneorg/core 需要什么版本的 Node.js?

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

@agentplaneorg/core 可以商用吗?

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

@agentplaneorg/core 的下载量有多少?

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

@agentplaneorg/core 还在维护吗?

最新版本 0.7.13 发布于 2026/11/04(4 天前);至今共发布 111 个版本,其中过去 12 个月发布了 111 个;首次发布于 2026/02/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。