@cordis-tavern/cordis-tavern

SillyTavern 式的通用 AI 聊天平台，基于 Cordis 插件化内核。本包提供 ct 命令行与启动层。

要求：Node >= 22.18；本机需有 pnpm。

快速开始

npm install -g @cordis-tavern/cordis-tavern   # 或项目内 npx / pnpm dlx
ct init            # 交互输入数据目录（$CT_HOME）：建骨架 + registry org API 发现并 pnpm 逐个下载
ct plugin add -g @cordis-tavern/ct-host-web   # 安装并登记插件（-g 系统级 / -p <环境> 环境级）
ct web             # 启动 web 环境（= ct <环境名>），Ctrl+C 退出

命令

| 命令 | 说明 | | --- | --- | | ct init | 初始化数据目录（.env 记录 CT_HOME）；registry.npmjs.org/-/org/cordis-tavern/package 发现包后逐个 pnpm add，ct-* 登记进 ct.profile | | ct plugin add / remove / update -g \| -p <环境> <包名> | 管理插件；安装前先契约预检（$CT_HOME/tmp 内 npm pack 验包），不合格黄警中止、不落安装 | | ct plugin list <环境> | 列出该环境的 ct.profile | | ct update | 按内核版本表升级 $CT_HOME 里的内核副本 | | ct <环境名> | 启动对应环境（注册表未命中时严格匹配环境名） |

数据目录布局

$CT_HOME/
  cordis.patch.yml         # 用户级配置（覆盖环境级，整行替换）
  node_modules/            # 系统级插件（ct plugin add -g 落点）
  profile/<环境名>/
    package.json           # ct.profile 登记表
    cordis.patch.yml        # 环境级配置
    commands.yml           # 环境级命令注册表
    node_modules/          # 环境级插件（ct plugin add -p 落点）

装载解析锚在环境目录、按 Node 向上检索：先环境级、后回退 $CT_HOME 系统级。

程序化使用

import { start, startWithTable, assembleTable } from '@cordis-tavern/cordis-tavern'

类型声明见 dist/index.d.ts（手写受控副本，与导出面同步维护）。

License

ISC