{"repo":"SJTdreams/Soul-Weaver","free":true,"listed":false,"github":"https://github.com/SJTdreams/Soul-Weaver","clone":"git clone https://github.com/SJTdreams/Soul-Weaver.git","description":"An AI-native roleplay engine with multi-character management, persistent memory, and collaborative world weaving. Self-hosted, OpenAI-compatible, zero database.","language":"HTML","stars":10,"topics":[],"license":"MIT","category":"self-hosted-apps","readme_excerpt":"灵魂织者 v3.0 (Soul Weaver) AI 驱动的沉浸式角色扮演与叙事管理系统。支持多角色管理、世界线构建、上下文智能压缩、以及\"世界织机\"多人冒险模式。 ✨ 核心功能 🎭 灵魂系统 (Soul System) - 角色架构参考：https://sjtdreams.github.io/p/%E5%9F%BA%E4%BA%8Eprompt%E7%9A%84llm%E4%BA%BA%E6%A0%BC%E6%A8%A1%E6%8B%9F%E6%9E%B6%E6%9E%84-%E7%81%B5%E9%AD%82%E7%BB%87%E8%80%85/ - 多角色管理 ：创建并切换多个独立角色，每个角色拥有独立的记忆、事件和上下文 - 模块化人设 ：基底设定（锁定）+ 动态模块（可变），AI 自动维护状态变化 - 上下文压缩 ：智能摘要算法，保留最近 t 条完整对话 + k 条历史摘要，突破 token 限制 🌍 世界织机 (World Weaving) - 多人冒险 ：支持多 Soul 同时进入同一世界，独立或合作模式 - 世界模型 ：AI 担任 KP（守秘人），控制世界运转、NPC 行为、状态同步 - 时间线回滚 ：任意阶段存档回退，所有在场角色状态同步还原 - 私密/公开模式 ：对立模式下各 Soul 信息隔离，合作模式下共享情报 🧠 记忆与事件 - 事件系统 ：创建长期事件，支持进入/离开事件，自动注入上下文 - 画像区 ：角色对其他实体的主观印象，动态更新 - 日记与日志 ：自动记录 + 手动撰写，支持编辑删除 ⚙️ 高级特性 - 流式输出 ：实时打字机效果，思考/动作/对话分层展示 - 指令系统 ：结构化 JSON 指令（UPDATE MODULE, CREATE EVENT, FETCH MEMORY 等） - 漫游模式 ：AI 自主连续行动，无需用户输入 - 世界封存 ：保存完整世界状态，随时恢复继续 🚀 快速开始 环境要求 - Python 3.8+ - 现代浏览器（Chrome/Firefox/Edge） 安装 启动 或指定 API 密钥（可选，也可在界面设置）： 访问 http://localhost:8765 ⚙️ 配置说明 方式一：前端设置（推荐） 1. 点击右上角「⚙ 设置」 2. 填写 API Key、Base URL、模型名称 3. 调整上下文窗口、Token 限制等参数 4. 点击「保存设置」 方式二：环境变量 方式三：命令行参数 📖 使用指南 创建角色 首次启动跟随引导创建角色： 1. 基底设定 （锁定）：核心准则与性格基底，AI 不可覆盖 2. 初始状态 （可变）：外貌、背景、心情，AI 会随剧情动态更新 基础对话 - 输入消息按 Enter 发送 - / 触发快捷指令（/new 新建对话、/clear 清空、/mood 调整心情等） - 点击消息旁「🔄 重新生成」可重试 - 「↩ 回滚」撤销上一轮，保留重新编辑按钮 世界织机使用 1. 点击顶部「🌍 世界」按钮 2. 在左侧面板配置： - 背景名称与世界观 - 选择运行模式（手动/自动/时间线） - 设置合作/对立关系 - 添加 NPC（从人物库或手动创建） - 选择同行灵魂（多 Soul 模式） 3. 点击「启动世界织机」 4. 世界模型会逐步推进剧情，点击「下一轮」或开启自动运行 指令系统（AI 使用） AI 通过 JSON 指令与系统交互： 指令 说明 ------ ------ UPDATE MODULE 更新可变模块（mood/port","default_branch":null,"files":null,"tree":[],"storefront":"/r/SJTdreams","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/SJTdreams/Soul-Weaver/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}