@cannbot-plugin/cannbot

中文文档
1.10.1发布于 2026/11/05SEE LICENSE IN LICENSEES Module零依赖近 30 天下载 2372

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

中文使用文档

CANNBot npm 安装器

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

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用户收到自成一体的软件包,从不克隆源寄存器. 构建软件包需要初始化的子模块;软件包构建保存出站修改而不是取取主.

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两个安装中都拥有其技能,代理,钩和知识设置.

见 工作流程安装和使用指南 用于所有支持的命令并提示示例.

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

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 没有整合。 见 共享源指南。 。 。 .

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

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

版本与发布记录

@cannbot-plugin/cannbot 共发布 23 个版本,首次发布于 2026/08/19;过去 12 个月发布了 23 个版本。

版本发布日期距今
1.10.1latest2026/11/054 天前
1.10.02026/11/045 天前
1.9.12026/10/2218 天前
1.9.02026/10/1228 天前
1.8.12026/10/081 个月前
1.8.02026/09/221 个月前

关于 @cannbot-plugin/cannbot 的常见问题

@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 和提交记录判断。