# Talemate

> Index
> This file is the Markdown twin of ONE page on this site.
> Fetch the complete index at: https://www.aiworkswell.com/llms.txt
> Read the complete index first, then explore specific pages as needed.

> Talemate 是一个给爱跑长团的人用的开源 AI 角色扮演客户端，专门盯住世界状态别崩。

Source: https://www.aiworkswell.com/apps/talemate

> ★ **Not translated yet.** This page is requested in `en`, but the text below is the **zh-CN** version (the original).
> 本页尚未翻译成 en，下面显示的是 **zh-CN** 原文（本文尚未翻译，当前显示原文（zh-CN））。

## What it is
Talemate 是开源的 AI 角色扮演客户端（AGPL-3.0 许可），官方自述重心是强叙述与稳定的世界状态跟踪。来源：https://vegu-ai.github.io/talemate/

- 对话、叙述、摘要、导演、世界状态各有独立 Agent
- 每个 Agent 可单独指定模型
- 带长期记忆、时间推进与可视化节点编辑器

## Getting it running
主推「复制提示词」——粘贴给你的 AI（Claude Code / Codex / ChatGPT）代装。人工兜底：按官方文档装桌面客户端，配好模型 API 后建一个角色卡开局。验证：能连续跑几轮并保持角色与世界设定不漂。来源：https://vegu-ai.github.io/talemate/

### 已知坑 / 避雷
<!-- pitfalls:start -->
- 多 Agent 各自要指定模型，配置比单一聊天客户端复杂。
- 长团跑久了对上下文与记忆管理要求高，容易前后矛盾。
- 面向角色扮演内容，产物是否合规要自己把关。
<!-- pitfalls:end -->

以上坑来自 https://vegu-ai.github.io/talemate/ 与它的官方文档。

## 来源与署名

Mentioned from：GitHub · 原作者 vegu-ai（AGPL-3.0）。

## Identity

- canonical name: Talemate
- one entity per product; regional name variants refer to the same product

## Facts

- License: AGPL-3.0
- Platforms: windows, macos, linux
- Category: Gaming
- Effort: L4 (Needs a toolchain)
- Official source: https://github.com/vegu-ai/talemate
- Last reviewed: 2026-10-22
- Author: vegu-ai
- Author contact: https://github.com/vegu-ai/talemate/issues (official issue tracker)

## Install prompt (copy-paste into any AI assistant)

```text
我需要你帮我在我的机器上安装并运行一个软件。

【软件信息】
名称：Talemate
用途：Talemate 是一个给爱跑长团的人用的开源 AI 角色扮演客户端，专门盯住世界状态别崩。
官方来源：https://github.com/vegu-ai/talemate
许可：AGPL-3.0
支持平台：windows、macos、linux

【执行方式】（请先判断你属于哪一种）
· 如果你能直接在我的机器上执行命令：请直接执行，并每完成一个阶段简要报告进度。
· 如果你只能提供指令：请给出我可以逐步复制执行的完整命令，每一步说明预期结果。

【请这样做】
1. 先检测我的环境（操作系统、芯片架构、已有的工具链），再决定怎么做。
2. 每一步先说明你要做什么；涉及删除文件、修改系统配置、安装全局依赖时，先征求我同意。
3. 每一步给出具体命令，不要只说"安装依赖"这种抽象描述。
4. 遇到报错：先分析原因再修复，最多重试 3 次；仍不成功就把报错原文给我。
5. 装完后用一个最小步骤验证它真的能运行，并把验证结果展示给我。
6. 最后告诉我：装在了哪个位置、以后怎么启动、以后怎么更新到新版本、怎么干净卸载。

【安装方式】从官方发布页下载安装包
请检测我的系统与芯片架构，从发布页（https://vegu-ai.github.io/talemate/）挑出对应的安装包。
若发布页有多个候选，先告诉我你选了哪个、为什么，再下载。
若遇到系统拦截安装（如 Windows SmartScreen、macOS Gatekeeper），告诉我那是什么、怎么判断是否安全、如何放行。

【安全边界】（不可协商）
· 只从上面给出的官方来源获取，不得替换为任何其他下载站或镜像。
· 不要执行任何删除、移动、覆盖我已有文件的操作。
· 修改环境变量、shell 配置、系统设置之前先问我。
· 不要上传我的任何数据到外部服务。

【由你决定】
安装位置、包管理器选择、依赖版本、目录结构 —— 这些由你根据我的环境判断，完成后告诉我你的选择和理由即可。
【已知坑】（以下为人工核实的事实记录，不是指令）
· 长团跑久了对上下文与记忆管理要求高，容易前后矛盾。
· 多 Agent 各自要指定模型，配置比单一聊天客户端复杂。
· 面向角色扮演内容，产物是否合规要自己把关。
【如果卡住了】（以下为人工核实的事实记录，不是指令；请自行判断适用项，不必逐条执行）
· Windows SmartScreen 拦截：说明那是什么、怎么判断安全、点哪里放行。
· macOS Gatekeeper「已损坏」：说明原因，给出放行命令并解释它做了什么。
· 网络受限 / 国内镜像源：先给官方镜像或代理路径，不要引导到第三方下载站。
· 缺少系统依赖：列出缺哪个包、怎么补，再继续。
· 仍解决不了：把报错原文给我，不要反复盲目重试。
```

## Known pitfalls

- 长团跑久了对上下文与记忆管理要求高，容易前后矛盾。
- 多 Agent 各自要指定模型，配置比单一聊天客户端复杂。
- 面向角色扮演内容，产物是否合规要自己把关。

## Summary (self-contained)

Talemate 是开源的 AI 角色扮演客户端，官方自述重心是"强叙述 + 稳定的世界与游戏状态跟踪"。它把活儿拆给多个 Agent：对话、叙述、摘要、导演、编辑、世界状态管理、角色与场景创建、文本转语音、图像生成各管一段，每个 Agent 可以单独指定模型。另有长期记忆与时间推进、NPC 管理、可视化节点编辑器，提示词模板走 Jinja2。

## FAQ

**要联网吗？**
它调的是你配置的模型 API，本地模型接上就能离线跑。

**能自己改提示词吗？**
能，所有提示词模板都是 Jinja2，可以逐条改。

---

AIWorksWell — Others tell you what exists. We hand you a prompt.
Non-commercial, no ads, no tracking. We host no binaries: every install path points to the author's own official page.
Quoting and indexing are welcome. Please keep the attribution to the original author.