先说结论
我开源的不是「只能打开某个聊天站才能用的陪伴」。
真正可复用的是 npm 包 @yanisjiang/companion-core:
-
性格 × 心情等状态 →
decide出意图 -
silence时不调模型 -
你把 LLM 和 存储 插进去,接到 Bot / 游戏 NPC / 桌面壳 / 自己的后端都行
-
仓库里的 Web/PWA,只是其中一个宿主示例(口令、页面、推送归宿主,不塞进内核)。
npm i @yanisjiang/companion-core
痛点:聊天产品常把「决策」和「填字」糊在一起
很多 AI 聊天项目最后变成:
- 前端一个对话框
- 后端直接
chatCompletion(history) - 再堆一堆 if:要不要主动、沉重后禁言多久、日额度……
结果是:
- 行为像规则清单,不像同一个人
- 逻辑绑死在当前 Web 栈,换个 Telegram Bot / 游戏内对话就要重写
- 模型既要「想该不该说」,又要「把话说好看」——又贵又飘
我想要的是反过来:
慢变量(性格) + 快变量(精力/心情/社交欲/危机残留)
↓
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) |
两个插口:
- LLM:
createOpenAiCompatibleLlm(...)或自己实现LlmClient(DeepSeek / 本地 OpenAI 兼容都行) - MessageStore:默认内存;要落盘用
createSqliteMessageStore(可选better-sqlite3) - 角色配置目录:
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、推送、登录、域名——全部留在你的宿主。 内核不管这些。
为什么说「不止是陪伴站」
你可以只拿走决策层,用在这些场景:
- 已有客服/助手 Bot:先
decide再生成,沉默就别烧 token - 游戏 NPC:性格配置进
params.json,情绪状态进 companion-state,对话口吻更稳 - 多端同一角色:手机 App / 网页 / 机器人共用一个 core 进程或同一套状态存储
- 想换模型:只换
LlmClient,不用重写节奏和主动逻辑
仓库里的聊天 UI,是为了证明「这套意图在真聊里长什么样」——日常会碎念,难受时短陪、不跑题——不是说你必须用这个 UI。
和「Agent 框架」差在哪(避免误会)
它不是通用工具调用 Agent,也不替代 LangChain / 工作流编排。
它更窄、更偏产品:关系型对话的节奏与意图(要不要出声、出声成哪一档、危机后怎么收)。
如果你要的是「查库 + 调 API + 多步工具」,请用 Agent 框架;如果你要的是「像同一个人那样决定何时开口」,core 更对口。
怎么跑起来验证
npm i @yanisjiang/companion-core
# 准备 character 配置(可用仓库 examples)
# 设 API_KEY 后按 README 调 createCompanion
完整自托管示例(含页面):
欢迎 star / issue。单用户自托管向;模型费用与服务器自理。
AI 开源 TypeScript Node.js LLM 自托管