Darkatse/TT-Sync

ملف Darkatse

آخر نشاط مصدر مسجل: ٨ سبتمبر ٢٠٢٦ في ٠٠:٥٧

آخر تحديث لفهرس SkillsMP: ١٧ أكتوبر ٢٠٢٦ في ٠٠:٠٩

skills مجمعة: ١

نجوم GitHub: ٣٤
تفرعات GitHub: ١٠

ملف README للمستودع

مصدر ملف README للمستودع: README.md

قراءة الملف الأصلي

عرض ملف README كاملًا

<img src="https://img.shields.io/badge/Rust-🦀-orange?style=for-the-badge" alt="Built with Rust"/> <img src="https://img.shields.io/badge/TLS_1.3-安全-blue?style=for-the-badge" alt="TLS 1.3"/> <img src="https://img.shields.io/badge/单文件-便携-green?style=for-the-badge" alt="Portable"/> <img src="./image/tt-sync-logo.png" alt="TT-Sync" width="1100"/> TauriTavern 远程同步服务器 我要给我的角色们一个更大的家！ <img src="./image/demo.gif" alt="TT-Sync TUI demo" width="1100"/> <a href="./README_EN.md">English</a> --- ## 为什么需要 TT-Sync？你是否经常： - 想在家里和 VPS 之间同步 TauriTavern 数据，但 LAN Sync 只能在局域网用？ - 希望把 NAS 当作权威副本，随时随地 pull？ - 顺便还想和原版 SillyTavern 同步？ **TT-Sync** 就是为这个问题准备的独立远程同步服务端：把 TauriTavern 的同步端点从局域网扩展到 VPS、NAS、家庭服务器，仍然保持安全、可控、可自部署。使用 **Rust** 🦀 构建，TT-Sync 提供： - **传输加密**：TLS 1.3 + SPKI 公钥固定，支持自签名与外部证书，无需公网 CA - **单一可执行文件**：适合 VPS、NAS、容器和家庭服务器 - **Ed25519 设备身份**：每个配对设备都经过密码学验证 - **双向兼容**：同时支持 TauriTavern 和原版 SillyTavern --- ## 使用 AI 协助安装可以将 [TT-Sync Skill](./skills/tt-sync/SKILL.md) 交给 AI 助手，按手动 TUI、自动化 CLI 或 Docker 的方式完成安装与使用。支持技能的工具可加载 `skills/tt-sync` 目录，也可以直接让 AI 阅读该文件。 ## 安装 ### 一键安装只需要Ctrl+C, Ctrl+V, Easy!： ```bash curl -fsSL https://raw.githubusercontent.com/Darkatse/TT-Sync/main/scripts/install.sh | sh ``` Windows PowerShell： ```powershell iex ((iwr https://raw.githubusercontent.com/Darkatse/TT-Sync/main/scripts/install.ps1).Content) ``` ### 直接下载二进制从 [Releases](https://github.com/Darkatse/TT-Sync/releases) 下载预编译二进制，放到你的 `$PATH` 中即可。 Docker / NAS / VPS 部署说明请见：[Docker 指南](./README.md#docker-一把梭) ### 从源码编译 ```bash git clone https://github.com/Darkatse/TT-Sync.git cd TT-Sync cargo build --release ``` 编译产物位于： ```bash target/release/tt-sync ``` Windows 下为 `tt-sync.exe`。 --- ## 给爱折腾的你如果你想用Nightly版本，请用下面的命令： Nightly： ```bash curl -fsSL https://raw.githubusercontent.com/Darkatse/TT-Sync/main/scripts/install.sh | sh -s -- --nightly ``` ```powershell & ([scriptblock]::Create((iwr https://raw.githubusercontent.com/Darkatse/TT-Sync/main/scripts/install.ps1).Content)) -Nightly ``` 指定版本： ```bash curl -fsSL https://raw.githubusercontent.com/Darkatse/TT-Sync/main/scripts/install.sh | sh -s -- --version 1.0.0 ``` ```powershell & ([scriptblock]::Create((iwr https://raw.githubusercontent.com/Darkatse/TT-Sync/main/scripts/install.ps1).Content)) -Version 1.0.0 ``` 自定义安装目录： ```bash curl -fsSL https://raw.githubusercontent.com/Darkatse/TT-Sync/main/scripts/install.sh | sh -s -- --dir "$HOME/.local/bin" ``` ```powershell & ([scriptblock]::Create((iwr https://raw.githubusercontent.com/Darkatse/TT-Sync/main/scripts/install.ps1).Content)) -InstallDir "$HOME\\bin" ``` 默认安装位置： - Linux / macOS：优先可写的 `/usr/local/bin`，否则退到 `~/.local/bin` - Windows：`%LocalAppData%\\TT-Sync\\bin`，并自动写进当前用户的 `PATH` --- ## Docker 一把梭如果你准备把 TT-Sync 塞进容器里，拥抱容器化技术，仓库里现在已经自带： - `Dockerfile` - `docker-compose.yaml` - `.env.example` - `config.toml.example` 简单示例如下： ```bash cp .env.example .env mkdir -p ./.tt-sync/state cp config.toml.example ./.tt-sync/state/config.toml # 编辑 .env 和 ./.tt-sync/state/config.toml docker compose pull docker compose up -d docker compose run --rm tt-sync doctor docker compose run --rm tt-sync pair open --rw ``` 其中： - `.env` 里主要改宿主机数据目录和端口 - `env` 中的`TT_SYNC_WORKSPACE`即为服务器上你需要同步的数据目录 - `TT_SYNC_PORT`则为你的本机监听端口 - `config.toml` 里主要改 `public_url`、`layout`，以及语言 - `public_url` 需要是外网可访问的 URL，一般与 `TT_SYNC_PORT` 端口一致，但如果你在前面加了反向代理，可能会不一样哦 - `layout` 则根据你同步的目标数据目录结构选择，可选值为 `tauri-tavern`, `silly-tavern` 和 `silly-tavern-docker`，具体区别请看 [Layout Mode](./README.md#layout-mode) 小节 - 首次启动时会自动生成 `identity.json` 和 TLS 证书，不需要你手搓密钥容器目录和反向代理的约定见 [Docker 部署](./docs/Docker.md)，各项配置见 [配置示例](./config.toml.example)。 --- ## 推荐使用方式：TUI ### 首次部署首次部署建议直接运行： ```bash tt-sync onboard ``` 引导流程会按顺序带你完成： - 选择语言 - 设置监听端口与 `Public URL` - 选择 `layout mode` - 选择服务器上的数据文件夹 - 可选立即进入配对界面 - 选择服务运行方式：前台运行，或用户态 service 已支持的用户态 service： - Linux：`systemd --user` - macOS：`LaunchAgent` - Windows：`Task Scheduler`（beta） ### 日常管理完成初始化后，日常使用建议直接进入主界面： ```bash tt-sync ``` 主菜单当前覆盖： - `Onboard`：重新走一遍引导配置 - `Pair`：生成二维码 / 配对链接，等待 TauriTavern 接入 - `Peers`：查看、改名、调整权限、撤销已配对设备 - `Serve`：启动/停止前台服务，或管理用户态 service - `Doctor`：检查配置、证书、数据目录和配对状态 - `Help`：查看按键与部署提示 ### 基本按键 - `↑ ↓`：移动焦点 - `Enter`：确认 - `Esc`：返回上一级 - `q`：退出配对页面还支持： - `r`：刷新二维码 / 重新生成配对令牌配对页面会优先显示二维码，并自动把配对链接复制到剪切板；如果终端太小导致二维码无法完整显示，可以直接在客户端粘贴链接。 ### 配对流程推荐路径很简单： 1. 在服务器上运行 `tt-sync onboard` 完成初始化，或进入 `tt-sync` 主菜单选择 `Pair`。 2. 在配对界面生成二维码或配对链接。 3. 在 TauriTavern 中扫描二维码或粘贴 `tauritavern://tt-sync/pair?...` 链接完成配对。 4. 之后通过 `Peers` 页面管理权限，通过 `Serve` 页面管理服务状态。如果只想在终端直接输出配对链接： ```bash tt-sync --quiet pair open ``` --- ## Layout Mode TT-Sync v2 按客户端所选数据集同步，具体同步范围请在客户端中选择。当前支持三种数据文件夹布局： | 选项 | 适用对象 | 全局扩展映射 | |------|----------|--------------| | `tauri-tavern` | TauriTavern `data/` | `extensions/third-party` → `data/extensions/third-party` | | `silly-tavern` | SillyTavern 仓库布局 | `extensions/third-party` → `public/scripts/extensions/third-party` | | `silly-tavern-docker` | SillyTavern Docker 目录布局 | `extensions/third-party` → `./extensions` | 如果你部署的是： - TauriTavern 独立数据目录，选 `tauri-tavern` - 普通 SillyTavern 仓库，选 `silly-tavern` - Docker 卷挂载，选 `silly-tavern-docker` --- ## 安全模型 ``` ┌──────────────────────────────────────────────────────────┐ │ 第一层：传输安全 │ │ TLS 1.3 + SPKI 公钥固定 │ │ → 客户端在配对时固定服务器公钥 │ ├──────────────────────────────────────────────────────────┤ │ 第二层：设备身份 │ │ Ed25519 每设备密钥对 + 规范请求签名 │ │ → 签名验证通过后才签发短期 Session Token │ ├──────────────────────────────────────────────────────────┤ │ 第三层：授权控制 │ │ 每设备 ACL：read / write / mirror-delete │ │ 固定 allowlist 限制可见路径范围 │ └──────────────────────────────────────────────────────────┘ ``` --- ## 开发者文档从 [维护指南](./docs/README.md) 开始阅读。架构边界、运行约定和发布流程集中在这里；配置字段见 [配置示例](./config.toml.example)。 --- ## 贡献发现 bug？想要新功能？欢迎 PR！ ```bash cargo test cargo build --release ``` --- ## 许可证 MIT 许可证 — 随便同步，不过角色跑丢了别怪我们 XD --- 用 ❤️ 为 TauriTavern 社区打造。 祝同步愉快！

جارٍ تحميل ملف README للمستودع…

Skills في هذا المستودع

مديرو الشبكات وأنظمة الحاسوب

١ فئات مهنية · 100% مصنفة

skill

المهنة

الوصف

آخر تحديث

tt-sync

مديرو الشبكات وأنظمة الحاسوب

帮助用户安装、配置和使用 TT-Sync，根据需要选择手动 TUI、自动化 CLI 或 Docker，完成启动、配对和运行验证。面向用户侧部署与日常操作。

لغة النص الأصلي: الصينية

2026-09-08

عرض ١ من أصل ١ skills مجمعة.

التثبيت بمساعدة مساعد ذكي

انسخ هذا الطلب إلى المساعد الذكي الذي تستخدمه.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/Darkatse/TT-Sync.