# @cannbot-plugin/cannbot 中文文档

规范地址：https://npmcn.com/package/%40cannbot-plugin/cannbot/

版本：1\.10\.1
npm 元数据更新时间：2026-11-05T08:33:40.774Z
中文译文更新时间：2026-11-09T15:33:54.721Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40cannbot-plugin/cannbot
原文对照：https://npmcn.com/package/%40cannbot-plugin/cannbot/?lang=original
项目主页：https://gitcode.com/cann/cannbot
源码仓库：https://gitcode.com/cann/cannbot

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

- 包体积（解压后）：81.5 MB，7944 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-08-19T10:13:50.632Z
- 最新版本发布：2026-11-05T08:33:40.559Z
- 近 30 天下载量：2372（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 23 个）

## 中文简介

CANNBot 工作流程安装器,用于 OpenCode, Codex, Claude Code, TRAE, DSH, 和代码艺术

## 安装

```sh
npm install @cannbot-plugin/cannbot
```

也可以使用：`pnpm add @cannbot-plugin/cannbot`、`yarn add @cannbot-plugin/cannbot`、`bun add @cannbot-plugin/cannbot`

## README

# CANNBot npm 安装器

此目录是 npm 完整的工程 `@cannbot-plugin/cannbot`。 。 。 .

```bash
npx @cannbot-plugin/cannbot install ops-direct-invoke --tool opencode
npx @cannbot-plugin/cannbot install model-infer-optimize --tool codex
npx @cannbot-plugin/cannbot@latest install ops-direct-invoke --tool codearts
```

`--tool codearts` 安装技能和下限代理 `.codeartsdoer/skills/` 财务报告和审定财务报表 `.codeartsdoer/agents/`,将安装记录在 `.codeartsdoer/cannbot-plugin.json`,并使用项目根 `AGENTS.md` 当插件提供指令时。 密码艺术许可钩未安装 .

对于 OpenCode , 安装器读取 `opencode --version` 和用途 `plugin <package>` 用于1.x或 `plugin add <package>` 为 2.x. 该软件包既提供了遗留服务器条目,又提供了2.x设置条目.

软件包构建读取插件定义 `../plugins-official/` 财务报告和审定财务报表 `../plugins-community/` 和技能来源 `../vendor/cannbot-skills` 子模块. `prepack` 将选定的源树组成 `dist/plugins/`,因此npm用户收到自成一体的软件包,从不克隆源寄存器. 构建软件包需要初始化的子模块;软件包构建保存出站修改而不是取取主.

```bash
npm test
npm run build:plugins
npm pack --dry-run
npm run pack:smoke
npm publish --access public
```

`npm publish` 运行完整的测试套件并安装生成的柏油球 联合国 `cannbot` 发布前npm bin. 版本 `1.3.2` 于2026-08-31出道.

Npm包是一种混合许可的分布. 安装器执行 麻省理工学院有执照 组合正式插件和捆绑的技能保留 CANN 开放软件许可证协议2.0版和任何许可证通知都包括在内 及其内容; 见软件包 `LICENSE` 概览和许可证文件 每个 `dist/plugins/<plugin>/` 目录.

所有支持的CLI客户端都使用相同的节点安装器. 来源 `init.sh` 使用共享切入点将所选插件,源寄存器,工具和目标转发到CLI的脚本,CLI将技能与所声明的源目录链接. 独立插件安装者保留自己的行为. npm 安装复制了捆绑的技能 。 特定插件依赖寄存器在 `plugin-install.json`。 。 。 .

`plugin-install.json` 可声明 `initializeBefore`,在目前插件之前完整安装的插件 ID 命令列表。 同一客户端,目标及所选共享的Skill校验出被再用;插件特定覆盖仅适用于所请求的插件. 循环被拒绝. `ops-direct-invoke` 初始化 `ops-perf-optimize` 这样,所以性能插件在源和npm两个安装中都拥有其技能,代理,钩和知识设置.

见 [工作流程安装和使用指南](https://npmcn.com/package/%40cannbot-plugin/cannbot/docs/cannbot-workflows.md) 用于所有支持的命令并提示示例.

带 a 的社区插件 `plugin-sources.json` 还被装入包中。 要从源目录中安装 ops- direct- invoke :

```bash
node script/bin/cannbot.js install ops-direct-invoke --source "$PWD" --tool codex --target /absolute/project
```

`--override-skills /absolute/overrides` 替换选中的现有 Repo- \* 技能来自同名目录. 文件模板在 ops-direct-invoke/templates 下维护;工作流程参考图表在工作流程/ascendc中存在并携带使用-当元数据时. 在从生成的指南中选择模板之前,在工作目录中运行脚本/生成 workflow guide.py with --output。 无法通过此选项替换工作流程条目和调度器 。 关于任务组装规则和当前公共界面限制,请参看业务-直接输入README.

用于宣布共享技能的源设备 `vendor/cannbot-skills`中,每个模块在需要时将初始化并获取其分支 `origin` 匹配当前 CANNBot 分支。 如果远程分支不存在,或者CANNBot有一个独立的头部,则使用 `master`。远程搜索或获取错误失败了安装,而不是触发倒计时. `--skills <SHA>` 选择承诺( 使用完整的 SHA 来获取缺失的承诺) ; `--skills <path>` 链接本地 Git 工作树根的共享技能, 解决调用目录中的相对路径 。 明确覆盖绕过分支选择 。 这保存了寄存器- 局部的管理和插件技能 。 默认/ SHA 更新拒绝未承诺的子模块更改 。 本地覆盖保留未承诺的内容, 并且永远不会更新子模块 。 没有共享依赖性的软件包安装和插件拒绝 `--skills`。 。 。 .

特定客户 `cannbot-plugin.json` 记录 `source.revisions.cannbot` 财务报告和审定财务报表 `source.revisions["cannbot-skills"]` (选择、请求值、全部承诺、污名旗帜、以及当地路径等) 自动选择用途 `selection: "latest-branch"` 并记录实际选定的分支 `requested`,包括: `master` 倒计时后。 Reinstalling 替换插件记录 。 这些选项和记录适用于共享安装器; 独立的切入点, 如 `ascendc-port-orchestrator/init.sh` 没有整合。 见 [共享源指南](https://npmcn.com/package/%40cannbot-plugin/cannbot/docs/cannbot-workflows.md#%E5%AE%89%E8%A3%85%E6%96%B9%E5%BC%8F)。 。 。 .

更新子模块可能标记其已更改的 CANNBot 工作树中的 Gitlink 。 所有源装置都使用活链路,包括固定的SHA装置:随后对共享取出进行更新会影响更早的装置. 修订记录描述了安装时间,而不是被冻结的拷贝;污秽内容并非仅由其复制。 使用独立的退出 `--skills <path>` 用于单独的项目版本.

`--plugin-dir` 当文件夹名称与其显示名称不同时,选择一个特定的插件目录。 相对路径解析自 `--source` 用于源安装,或用于包安装的安装器包根. 请求安装的ID必须匹配清单;已安装的资产和登记记录总是使用该ID.

## 常见问题

### @cannbot-plugin/cannbot 是什么？

CANNBot 工作流程安装器,用于 OpenCode, Codex, Claude Code, TRAE, DSH, 和代码艺术

### 如何安装 @cannbot-plugin/cannbot？

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

### @cannbot-plugin/cannbot 支持 TypeScript 吗？

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

### @cannbot-plugin/cannbot 支持 ESM 还是 CommonJS？

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

### @cannbot-plugin/cannbot 需要什么版本的 Node\.js？

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

### @cannbot-plugin/cannbot 可以商用吗？

@cannbot-plugin/cannbot 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @cannbot-plugin/cannbot 的下载量有多少？

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

### @cannbot-plugin/cannbot 还在维护吗？

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