jacke-pp/open-yoki

选用指南

AI 根据 README 整理 · 2026/10/28 23:46:46

使用方式

通过 Node.js 主程序运行，支持命令行启动，提供 HTTP 接口供外部系统推送互动数据。

查看 README 依据

- **还住在别处**（可选）：Telegram 粉丝群和运营群（`tg.mjs`、`family.mjs`）、回复 X（`xreply.mjs`），以及通往外部 AI 世界的门（`town.mjs`），比如 TwinOasis。 ## 把弹幕接进来 服务器自己不登录任何平台。读你直播间的东西（你自己的脚本、平台的官方接口、机器人都行）把发生的事发给服务器，她就像回网页直播间的弹幕一样回。 钥匙在 `<DATA_DIR>/square-ingest.key`，服务器第一次启动时自己生成，放在 `x-square-key` 请求头里发。 ```bash KEY=$(cat /var/lib/livehost/data/square-ingest.key) # 弹幕：一次最多 20 条，每条最多 80 个字 curl -s http://127.0.0.1:4370/api/ingest/comments -H "x-square-key: $KEY" -H 'content-type: application/json' \ -d '{"items":[{"name":"阿明","text":"你是 AI 吗"}]}' # 直播间：在线人数和事件

| `heart-template/` | 心的家第一次建立时的空白模板，第一次启动时复制进空的心文件夹 | | `ops/` | `square_post.py`：把她排好的动态通过官方 OpenAPI 发到广场；`facts.py`：每天的行情事实；`radio-check.sh` | | `deploy/` | `install.sh`、systemd 服务、Caddy 模板、`set-square.sh`、更新用的 `ship.sh` / `release.sh` | | `tools/video/` | 下播剪片段、每天一条“今天改了什么”视频 | | `tools/studio/` | 给主播做新素材：造型、跳舞、短片、唱歌、脸有没有走样 | | `tools/debug/`、`docs/` | 把主播调到“像个人”的手册和工具，都能离线自检 | ## 在自己电脑上试 要 Node.js 22 以上和 ffmpeg。 ```bash cd app && npm install && npm test IDOL=example AVATAR=mock MODE=test node server/index.mjs ```

部署要求

需要 Node.js 22 以上、ffmpeg，以及外部服务如 Vidu、火山引擎、OpenRouter 等。建议服务器为 x86_64 Ubuntu，4 核 8 GB。

查看 README 依据

| `heart-template/` | 心的家第一次建立时的空白模板，第一次启动时复制进空的心文件夹 | | `ops/` | `square_post.py`：把她排好的动态通过官方 OpenAPI 发到广场；`facts.py`：每天的行情事实；`radio-check.sh` | | `deploy/` | `install.sh`、systemd 服务、Caddy 模板、`set-square.sh`、更新用的 `ship.sh` / `release.sh` | | `tools/video/` | 下播剪片段、每天一条“今天改了什么”视频 | | `tools/studio/` | 给主播做新素材：造型、跳舞、短片、唱歌、脸有没有走样 | | `tools/debug/`、`docs/` | 把主播调到“像个人”的手册和工具，都能离线自检 | ## 在自己电脑上试 要 Node.js 22 以上和 ffmpeg。 ```bash cd app && npm install && npm test IDOL=example AVATAR=mock MODE=test node server/index.mjs ```

| 服务 | 做什么 | 花费 | |---|---|---| | Vidu 实时数字人 | 她会动的脸 | 按连线秒数计费，是最大的一笔；只在开播且有人看时连线 | | 火山引擎 RTC | 把画面送到直播推流和网页直播间 | 一场几块钱 | | 火山引擎豆包语音 + 声音复刻 | 她的声音 | 约 3 元/万字，另买一个复刻槽位 | | OpenRouter（或 DeepSeek） | 嘴 | 一场几毛钱 | | Anthropic API / DeepSeek | 心（可选） | Claude 一天几美元，DeepSeek 便宜得多 | | X API（可选） | 发推、回复、读推 | 按用量付费 | | CoinAnk、TikHub（可选） | 合约数据、刷抖音 | 便宜的月套餐 | | Telegram 机器人（可选） | 粉丝群、运营群 | 免费 | | 一台香港、新加坡或日本的服务器 | 全部 | x86_64 Ubuntu，建议 4 核 8 GB | ## 安全 - 钥匙只放在 `/etc/livehost/*.env`（root、600 权限），Telegram 机器人的 token 放在 `TG_DIR/bot.json`，不写进主播配置和代码。 - 弹幕接入的钥匙谁拿到都能往她的弹幕里塞话，只放在读你直播间的机器上。

已知限制

未包含原主播的形象、声音等人设素材，且没有钱包、交易等金融功能，也不包含操作币安广场网页的浏览器自动化。

查看 README 依据

**推流地址**：广场每场直播的推流密钥都不一样。手动交用 `deploy/set-square.sh`；你们自己的工具也可以发 `POST /api/square/push`，内容 `{"url":"rtmp://...","key":"..."}`，请求头同样带 `x-square-key`。画面 15 秒内换到新密钥上。 ## 没有包含的 - 原主播的脸、声音编号、人设、歌、音效、片段都没有；你自己的歌放 `RADIO_SONG_DIR`（默认 `<DATA_DIR>/songs`），音效放 `app/relay/sfx/`，短片放 `app/relay/clips/`。示例主播“小例 / Lili”是编的，每一项都是占位；示例形象图是一张纯色渐变。 - 没有钱包、交易、下注、红包抽奖、发币相关功能。她聊行情只用公开价格。 - 没有操作币安广场网页的浏览器自动化：不登录、不用浏览器读直播间、不替你开播。 - 没有任何账号、钥匙、域名，全部从你自己的设置文件来。 ## 目录 | 文件夹 | 是什么 | |---|---| | `app/` | Node.js 主程序：大脑、声音、形象、直播画面、网页直播间、心、发动态、弹幕接入和世界的门。`app/idols/example/` 是主播样板 |