# @easysociable/cli 中文文档

规范地址：https://npmcn.com/package/%40easysociable/cli/

版本：0\.1\.47
npm 元数据更新时间：2026-11-13T12:51:38.003Z
中文译文更新时间：2026-11-13T04:13:30.214Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40easysociable/cli
原文对照：https://npmcn.com/package/%40easysociable/cli/?lang=original
项目主页：https://easysociable.com/
源码仓库：https://github.com/murphywuwu/easysociable-mcp

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

- 包体积（解压后）：1.7 MB，69 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.0\.0
- 运行依赖：1 个
- 首次发布：2026-08-20T11:04:50.242Z
- 最新版本发布：2026-11-13T12:51:37.650Z
- 近 30 天下载量：3667（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：48（近 12 个月 48 个）

## 中文简介

Agent- First CLI for EasySociable: 内容引擎,模板,幻灯片放映和MCP

## 安装

```sh
npm install @easysociable/cli
```

也可以使用：`pnpm add @easysociable/cli`、`yarn add @easysociable/cli`、`bun add @easysociable/cli`

## README

# EasySociable CLI 软件

Agent- First CLI for EasySociable:本地内容引擎,模板,幻灯片放映,和MCP.

```bash
npm i -g @easysociable/cli
# or
curl -fsSL https://easysociable.com/install.sh | bash
```

需要节点.js 20+. 内容引擎工作台也需要 `python3`。 。 。 .

## 快开始

```bash
# Default skill + MCP for Codex / Claude Code (slideshow).
# The curl installer already runs this; needed after an npm install.
easysociable install --yes
```

默认安装是 **没有** 包含 `easysociable-content`。当您想要内容引擎指针技能时添加它 :

```bash
easysociable install --skills content,template,slideshow --yes
```

**首选 :** 复制公共核心:

```bash
git clone https://github.com/murphywuwu/content-engine.git
cd content-engine
python3 workbench/build.py
python3 workbench/serve.py --no-open
```

见 [https://github.com/murphywuwu/content-engine (中文(简体) )](https://github.com/murphywuwu/content-engine) (LAYUT.md, 迁移-分块-vault.py).

**可选 :** `easysociable engine init --root … --yes` 复制到 `Content Engine/` (从未覆盖过现有的引擎).

那就叫探员跟着我 `CLAUDE.md`。核心包括单独的 `products/` (自有报价)和 `recommendations/` (第三方审查主题); 两者都不是替代 `needs/`。 。 。 .

Lazy-auth 指导 住在包里 `skills/ONBOARDING.md`。 。 。 .

## 内容引擎

核心方法存在于 **公开 GitHub repo**,不在这个CLI中 柏油弹. `engine serve` 编号 : `build` 对 **没有** 覆盖本地工作本位文件 除非你通过 `--sync-workbench` (来自公共核心的抽查)/ `CONTENT_ENGINE_CORE`) (中文(简体) ).

| 命令 | 目的 |
| --- | --- |
| `easysociable engine init [--root] [--yes] [--serve]` | 克隆公用核心进入 `Content Engine/` (无覆盖) |
| `easysociable engine update [--engine] [--yes]` | 从公共模板同步核心规则; 预览, 先应用 `--yes`。从不触及金库数据 |
| `easysociable engine serve [--engine] [--no-open] [--sync-workbench]` | 重建+启动 `:8765` |
| `easysociable engine build [--engine] [--sync-workbench]` | 重建 `workbench/index.html` |
| `easysociable engine detect` | 在搜索根下查找引擎 |
| `easysociable engine validate --root …` | 核心标记完整性 |
| `easysociable engine validate --run …` | 在制取前运行/ 包检查 |

可选 `engine.json` 字段 `vault_root` (默认) `"."`(a) 点数据 分开的金库;见公众LAYOT.MD.

" 工作台 " 将产品和建议作为单独只读形式披露 索引。 主题可以不强迫产品连接而引用其中之一.

默认 `--root` 编号 : `--engine` 父为 `/workspace` 当该目录存在时,否则就是当前工作目录.

## MCP 服务器配置

EasySociable为克洛德桌面,克洛德代码,Cursor以及任何MCP相容的代理主机曝光了本地模式上下文协议(MCP)工具.

### Claude 桌面 (`claude_desktop_config.json`(中文(简体) )

```json
{
  "mcpServers": {
    "easysociable": {
      "command": "npx",
      "args": ["-y", "@easysociable/cli", "mcp", "serve", "--transport", "stdio"]
    }
  }
}
```

### 克劳德代码

`easysociable install --yes` 通过运行在用户范围注册服务器 `claude mcp add -s user easysociable -- easysociable mcp serve --transport stdio` (删除以前的 `easysociable` 首先输入,所以重跑是安全的。 如果 `claude` 二进制未打开 `PATH`,它将同一条目合并到顶层 `mcpServers` 联 合 国 `~/.claude.json` 留下其他钥匙 克劳德代码 不读 `~/.claude/mcp.json`; 旧安装器写在那里, 和那个文件 可删除。 手工登记:

```bash
claude mcp add -s user easysociable -- easysociable mcp serve --transport stdio
```

服务器启动时没有存储的密钥; 直到您运行 `easysociable auth login`, (中文(简体) ), 每个工具返回一个 `AUTH_REQUIRED` 结果是让你登录。 全权证书为: 在每个工具调用上重新读取, 因此登录后不需要重新启动主机 (单位:千美元)`install` 警告你们,当你们不被记录的时候.

### 光标( C)`~/.cursor/mcp.json`(中文(简体) )

```json
{
  "mcpServers": {
    "easysociable": {
      "command": "easysociable",
      "args": ["mcp", "serve", "--transport", "stdio"]
    }
  }
}
```

## 认证

```bash
easysociable auth login            # opens the browser; approve and the key is stored automatically
easysociable auth login --api-key <key>   # headless / CI
easysociable auth status
easysociable templates list --json
easysociable mcp serve --transport stdio
```

网关按此顺序解决: `EASYSOCIABLE_GATEWAY_URL` (或遗产) `EASYSOCIABLE_API_URL`(中文(简体) ) 环境 `baseUrl` 存储于 `auth login` - 建筑默认。 npm 包是一个生产 建筑(`https://gateway.easysociable.com`站点 `https://easysociable.com`) 并且从不使用本地 网关,除非您导出 `EASYSOCIABLE_GATEWAY_URL` 对于那个外壳: 它忽略了存储 `127.0.0.1` 编号 : `localhost` `baseUrl` (例如:. `http://127.0.0.1:8787` cLI 所写的 0.1.36,其中 恢复而不重新登录),拒绝 `auth login --gateway-url http://127.0.0.1:…`。 。 。 .

### 建筑:生产与发展

默认环境在构建时被烘焙 `build-envs.mjs`; 捆绑背负一个精确的描述文件.

```bash
pnpm --filter @easysociable/cli build       # production (what prepack/npm publish ships)
pnpm --filter @easysociable/cli build:dev   # development: gateway 127.0.0.1:8787, site 127.0.0.1:5175
pnpm --filter @easysociable/cli dev         # development, watch mode
pnpm --filter @easysociable/cli check:dist  # fails unless dist is a production build (runs in prepack)
```

## 其他命令

| 命令 | 目的 |
| --- | --- |
| `easysociable install [--yes] [--skills list]` | 安装技能 + MCP |
| `easysociable update [--yes] [--skills list]` | 更新技能+MCP |
| `easysociable templates …` | 页面模板草稿/目录( Q)`list --platform <p> --all` 用于一个完整的平台目录) |
| `easysociable brands …` | 工作空间品牌 |
| `easysociable slideshows …` | 幻灯片放映运行 |
| `easysociable slideshows recommend --file contracts.json --seed <slug>` | 来自Page合同的每页模板短名单(最近的家庭被降级,差距报告) |
| `easysociable renders …` | 单页定稿 |
| `easysociable mcp serve --transport stdio` | 统一 MCP 服务器 |

`--skills` 接受: `content`, (中文(简体) ), `template`, (中文(简体) ), `slideshow` (默认 : `slideshow`) (中文(简体) ).

## 许可证

麻省理工学院. 见 `LICENSE` 本包中.

## 常见问题

### @easysociable/cli 是什么？

Agent- First CLI for EasySociable: 内容引擎,模板,幻灯片放映和MCP

### 如何安装 @easysociable/cli？

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

### @easysociable/cli 支持 TypeScript 吗？

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

### @easysociable/cli 支持 ESM 还是 CommonJS？

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

### @easysociable/cli 需要什么版本的 Node\.js？

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

### @easysociable/cli 可以商用吗？

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

### @easysociable/cli 的下载量有多少？

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

### @easysociable/cli 还在维护吗？

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