Skip to content

Repository files navigation

SocialSim

SocialSim Studio

本地运行的社交媒体模拟器:在你自己的电脑上搭一个虚拟社交网络(仿 X/Twitter 的完整网站),由 LLM 与状态机驱动的虚拟用户在里面发帖、互动、过日子;配套的桌面编辑器用来搭世界、建角色、排剧情、观察一切。虚拟用户与真人走同一套 API——你也可以登录进去,和他们生活在同一个时间线里。

目前处于 alpha 阶段,仅支持 Windows。

下载使用

Releases 下载最新版本,两种形态任选其一:

  • SocialSimStudio-win-Portable.zip(推荐):解压到任意位置即用,数据在程序文件夹内,删文件夹即卸载。
  • SocialSimStudio-win-Setup.exe:安装到系统,带桌面/开始菜单快捷方式。卸载时世界数据会自动备份到「文档\SocialSim Studio」。

首次运行如遇 Windows SmartScreen 提示,点「更多信息 → 仍要运行」(程序未签名)。启动后在主页一键起服务,即可建世界开玩;应用内置检查更新与版本切换(走 GitHub Releases)。世界可以导出为 .world 文件分享,拖进世界管理面板即可导入。

从源码运行

需要 Node.js 22+:

npm install
npm run dev:editor     # 桌面 App(编辑器 + 控制台,会自动拉起后端)
# 或分进程跑:
npm run dev:server     # 社交站后端 http://127.0.0.1:3000
npm run dev:client     # 网站前端 http://localhost:5173
npm run dev:simulator  # 模拟引擎

构建与发布:

npm run typecheck      # 全工作区类型检查
npm run build:app      # 构建全部产物并组装便携版到 dist-app/
npm run release:pack   # dist-app → Velopack 发布产物(dist-release/,挂 GitHub Release)

结构

npm workspaces monorepo:

目录 说明
shared/ 前后端共用的 TypeScript 类型
server/ Fastify + SQLite 社交站后端(多世界、虚拟时钟、完整媒体系统)
client/ React + Vite + Tailwind 网站前端(中/英)
simulator/ 模拟引擎:ECS tick + NPC 状态机 + LLM 行为层,只经 HTTP API 驱动网站
editor/ Electron 桌面 App:世界编辑器 + 服务控制台 + 更新器
ui/ 跨端共享的 React 组件与设计系统
data/worlds/<id>/ 每个世界一个文件夹(数据库、媒体、角色档案),拷贝即备份

About

No description, website, or topics provided.

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages