别只把 AI 聊天当成「又一个网页」:把状态驱动的陪伴内核接到你自己的项目里

0 阅读3分钟

先说结论

我开源的不是「只能打开某个聊天站才能用的陪伴」。

真正可复用的是 npm 包 @yanisjiang/companion-core:

  • 性格 × 心情等状态 → decide 出意图

  • silence 时不调模型

  • 你把 LLM 和 存储 插进去,接到 Bot / 游戏 NPC / 桌面壳 / 自己的后端都行

  • 仓库里的 Web/PWA,只是其中一个宿主示例(口令、页面、推送归宿主,不塞进内核)。

  • 包:www.npmjs.com/package/@ya…

  • 仓库:github.com/YanisJiang/…

npm i @yanisjiang/companion-core

痛点:聊天产品常把「决策」和「填字」糊在一起

很多 AI 聊天项目最后变成:

  • 前端一个对话框
  • 后端直接 chatCompletion(history)
  • 再堆一堆 if:要不要主动、沉重后禁言多久、日额度……

结果是:

  1. 行为像规则清单,不像同一个人
  2. 逻辑绑死在当前 Web 栈,换个 Telegram Bot / 游戏内对话就要重写
  3. 模型既要「想该不该说」,又要「把话说好看」——又贵又飘

我想要的是反过来:

慢变量(性格) + 快变量(精力/心情/社交欲/危机残留)
        ↓
     decide → 意图(silence / presence / life / heavy_hold …)
        ↓
  只有非 silence 才调 LLM:把意图写成话

Web 站、机器人、别的产品,都只是消费这个运行时。


内核解决什么,宿主解决什么

@yanisjiang/companion-coreCompanion Web 宿主
角色陪伴决策 + 编排运行时产品壳
有traits / state / decide / 危机 / idle·续话 / prompt 拼装 / createCompanion登录口令、React UI、Web Push、Nginx/pm2
没有品牌页、鉴权、部署脚本(决策应尽量走 core)

两个插口:

  1. LLM:createOpenAiCompatibleLlm(...) 或自己实现 LlmClient(DeepSeek / 本地 OpenAI 兼容都行)
  2. MessageStore:默认内存;要落盘用 createSqliteMessageStore(可选 better-sqlite3)
  3. 角色配置目录:persona.txt / dossier.txt / fewshots.txt / params.json

最小接入:10 行量级接到你的项目

import {
  createCompanion,
  createOpenAiCompatibleLlm,
} from "@yanisjiang/companion-core";

const app = createCompanion({
  llm: createOpenAiCompatibleLlm({
    apiKey: process.env.API_KEY!,
    baseUrl: "https://api.deepseek.com",
    model: "deepseek-chat",
  }),
  configDir: "./character", // 你的人设/五维配置目录
  // store 省略 → 内存;持久化:
  // store: createSqliteMessageStore({ path: "./data/companion.db" }),
});

// 任意入口:HTTP / 游戏事件 / IM webhook
await app.handleUserMessage("在吗");

// 进程里定时调用:idle / 主动 / 日程等
await app.tick();

然后你自己决定怎么暴露:

  • Express / Hono / 现有业务 API 包一层
  • 游戏服务器在 NPC 对话事件里调 handleUserMessage
  • 桌面端本地 Node 常驻 + tick
  • 可选:app.listen({ port: 8790 }) 仅作本地试跑的薄 HTTP(不是产品部署方案)

7×24、推送、登录、域名——全部留在你的宿主。 内核不管这些。


为什么说「不止是陪伴站」

你可以只拿走决策层,用在这些场景:

  1. 已有客服/助手 Bot:先 decide 再生成,沉默就别烧 token
  2. 游戏 NPC:性格配置进 params.json,情绪状态进 companion-state,对话口吻更稳
  3. 多端同一角色:手机 App / 网页 / 机器人共用一个 core 进程或同一套状态存储
  4. 想换模型:只换 LlmClient,不用重写节奏和主动逻辑

仓库里的聊天 UI,是为了证明「这套意图在真聊里长什么样」——日常会碎念,难受时短陪、不跑题——不是说你必须用这个 UI。


和「Agent 框架」差在哪(避免误会)

它不是通用工具调用 Agent,也不替代 LangChain / 工作流编排。

它更窄、更偏产品:关系型对话的节奏与意图(要不要出声、出声成哪一档、危机后怎么收)。
如果你要的是「查库 + 调 API + 多步工具」,请用 Agent 框架;如果你要的是「像同一个人那样决定何时开口」,core 更对口。


怎么跑起来验证

npm i @yanisjiang/companion-core
# 准备 character 配置(可用仓库 examples)
# 设 API_KEY 后按 README 调 createCompanion

完整自托管示例(含页面):

github.com/YanisJiang/…

欢迎 star / issue。单用户自托管向;模型费用与服务器自理。

AI 开源 TypeScript Node.js LLM 自托管