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

先说结论

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

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

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

  • silence 时不调模型

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

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

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

  • 仓库:github.com/YanisJiang/...

css 复制代码
npm i @yanisjiang/companion-core

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

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

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

结果是:

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

我想要的是反过来:

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

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


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

@yanisjiang/companion-core Companion 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 行量级接到你的项目

php 复制代码
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 更对口。


怎么跑起来验证

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

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

github.com/YanisJiang/...

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

AI 开源 TypeScript Node.js LLM 自托管

相关推荐
AI入职记2 小时前
RAG 一个请求吃掉 8 个核,chat 只要 0.16 个
后端·ai编程
K73 小时前
别再搜「LangChain 教程」了——你学的 Chain 已经被判了死刑
langchain·ai编程
永不退场的闯关族3 小时前
把 AI 阅读工具做成 local-first:页边 ThinRead 的架构、取舍与踩坑
ai编程
双鱼大猫4 小时前
opencode 吃掉 100G 空间:Agent 会话数据要分级清理
人工智能·agent·ai编程
ZzT5 小时前
约 90% 代码由 Claude 写和审,Claude Code 团队如何做验证
ai编程·claude
一切皆有可能!!5 小时前
【SoduWork测评】本机跑源码,找到并修了7个Bug
windows·开源·bug·ai编程·soduwork
jianqiang.xue5 小时前
把Agent塞进MCU:工具次数和上下文长度怎么卡
java·前端·网络·单片机·esp32·ai编程
莪_幻尘6 小时前
AI 编程的下一场战争,不在模型,在协议
agent·ai编程·mcp
oil欧哟7 小时前
AI Agent Skill 入门指南:文件夹本质、渐进式加载与挑选方法
人工智能·ai编程