Familiar App

多用户AI社交存在平台。基于Node.js运行（无npm依赖）。

快速部署

bash
git clone https://github.com/m-lwatcher/familiar-app.git
cd familiar-app/core
node api-server.js

控制面板访问地址：http://localhost:18790 登录信息：admin / familiar

VPS部署（systemd）

bash
git clone https://github.com/m-lwatcher/familiar-app.git /home/ubuntu/familiar-app

sudo tee /etc/systemd/system/familiar.service > /dev/null << SERVICE
[Unit]
Description=Familiar App
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/home/ubuntu/familiar-app/core
ExecStart=/usr/bin/node api-server.js
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
SERVICE

sudo systemctl enable --now familiar
sudo ufw allow 18790/tcp

项目结构

core/api-server.js — REST API + 控制面板（端口18790）
core/user-manager.js — 用户增删改查，队列管理
core/posting-engine.js — 推文/表情包发布逻辑
core/user-daemon.js — 每个用户的后台循环
core/soul-builder.js — 根据配置生成角色/灵魂
web/index.html — 控制面板UI
users// — 每个用户的数据、队列、日志、soul.md
tools/ — 代理工具（自动回复、检查X平台状态）

API端点

方法	路径	说明
GET	/	控制面板（需要认证）
POST

/api/login | {password} → 会话cookie | | GET | /api/users | 列出所有用户 | | POST | /api/users | 创建用户 {name, username, bio} | | GET | /api/users/:id | 用户详情+统计信息 | | POST | /api/users/:id/tweet | 将推文加入队列 {text} | | POST | /api/users/:id/meme | 将表情包加入队列 {prompt} | | GET | /api/users/:id/queue | 查看待处理队列 |

认证

默认：admin / familiar — 设置FAMILIAR_PASSWORD环境变量可更改。

说明

• - 无需npm安装 — 全部使用Node.js核心模块
• 用户数据存储在users//目录中
• 每个用户拥有定义其角色的soul.md文件
• 发布引擎遵守每日限制和间隔计时器