SagaSmithAI
GitHub
导航Menu

AI 原生 TTRPG 平台AI-native TTRPG platform

让世界记得,让规则落槌。Worlds remember. Rules settle.

Agent 理解桌上的意图,领域运行时确定性结算,MCP 守住身份、权限、状态与时间线。你可以在自己的机器上运行完整 Local Agent Kit,也可以构建托管浏览器产品 SagaSmith Web。Agents understand intent at the table. Domain runtimes settle rules deterministically. MCP protects identity, authority, state, and timelines. Run the complete Local Agent Kit yourself, or build the hosted browser product, SagaSmith Web.

  • 本地优先可选Local-first option
  • 权威状态可验证Verifiable authority
  • Active AlphaActive Alpha
DEPLOYMENT MAP / MCP 2026-07-28CONTRACT LOCKED
LOCAL / YOU OPERATE

Local Agent Kit

Bot、SagaSmith Agent 或通用 MCP Host;SQLite 与本地文件。Bot, SagaSmith Agent, or a generic MCP host; SQLite and local files.

stdio · localhost HTTP
HOSTED / WEB PRODUCT

SagaSmith Web

浏览器/PWA、API/BFF、协作、Forge 与使用专用委托的 request-scoped Agent worker。Browser/PWA, API/BFF, collaboration, Forge, and request-scoped Agent workers using audience-bound delegation.

account · session · worker
ONE AUTHORITATIVE CONTRACTsagasmith.authoritative-mcp/v2

同一 handlers、schemas、errors、每请求 authority、revision 与 idempotency。The same handlers, schemas, errors, per-request authority, revisions, and idempotency.

DOMAIND&D
DOMAINCoC
DOMAINNarrative

允许不同May differ · transport / auth / storage / deployment不得分叉Must not fork · tools / rules / writes / revisions

一次选择,不止一轮对话A choice outlives a chat turn

长期战役需要真正的连续性。Long campaigns need real continuity.

SagaSmith 把主持表达与权威状态分开:模型可以提议、解释和扮演;只有领域 MCP 可以验证并写入战役账本。SagaSmith separates facilitation from authoritative state. Models may propose, explain, and portray; only the domain MCP validates and writes the campaign ledger.

记住世界Remember the world

战役 revision、分支、Snapshot、长期事实与检索来源都拥有明确身份,而不是被压进一段聊天摘要。Campaign revisions, branches, snapshots, durable facts, and retrieval sources keep explicit identities instead of disappearing into a chat summary.

STATE / TIMELINE
守住视角Protect perspective

GM、玩家、PC 与 NPC 的知识边界独立。客户端只收到服务端按 principal、actor、campaign 与 phase 过滤后的投影。GM, player, PC, and NPC knowledge stays separate. Clients receive only server-filtered projections for the current principal, actor, campaign, and phase.

ACTOR KNOWLEDGE
让规则落槌Let rules settle

Skills 指导主持流程,Agent 组织意图;确定性规则、随机流、权限与原子写入始终回到匹配的领域运行时。Skills guide facilitation and the Agent organizes intent; deterministic rules, random streams, authorization, and atomic writes return to the matching domain runtime.

MCP RECEIPT

同一平台,两种发行形态One platform, two distributions

从你的桌面开始,或构建完整 Web 产品。Start on your machine, or build the full Web product.

LOCAL AGENT KIT

你拥有运行环境。You own the runtime.

选择 D&D、CoC、Narrative 或 multi-system profile。使用 SagaSmith Agent 连接 Discord、QQ、Telegram,或让 Codex、Claude Code、OpenClaw 等 MCP Host 直接接入。Choose a D&D, CoC, Narrative, or multi-system profile. Use SagaSmith Agent for Discord, QQ, or Telegram, or connect an MCP-capable host such as Codex, Claude Code, or OpenClaw.

  • 不依赖 SagaSmith Web、账户、配额或 ForgeNo dependency on SagaSmith Web, hosted accounts, quota, or Forge
  • stdio 或仅 loopback 的 Streamable HTTPstdio or loopback-only Streamable HTTP
  • 本地 SQLite、文件与用户自有 providerLocal SQLite, files, and your own model provider
SAGASMITH WEB

托管浏览器产品。The hosted browser product.

SagaSmith Web 包含浏览器/PWA、API/BFF、托管控制面、协作房间、Forge、Module Studio、Agent 编排与运维;它不成为第二套游戏状态权威。SagaSmith Web includes the browser/PWA, API/BFF, hosted control plane, collaborative rooms, Forge, Module Studio, Agent orchestration, and operations. It never becomes a second authority for game state.

  • 账户、session、配额、邀请与云端投影属于 WebAccounts, sessions, quota, invitations, and cloud projections belong to Web
  • 每次权威写入仍由领域 MCP 结算Every authoritative write is still settled by the domain MCP
  • 当前为公开可见源码的 Active Alpha,不是生产 SLAPublicly visible Active Alpha source, not a production SLA

成熟度透明Honest maturity

当前能验证什么,就只说什么。Claim only what current evidence proves.

Active Alpha 适合本地开发、集成验证与实团测试。参考战役通过不代表每个 Pack、剧情分支或生产部署都已覆盖。Active Alpha is ready for local development, integration validation, and real-table testing. Passing reference campaigns do not prove every Pack, story branch, or production deployment.

D&D 5e

端到端参考路径:规则、内容、场景、角色知识、战斗与 Workbench。End-to-end reference path across rules, content, scenes, actor knowledge, combat, and Workbench.

Early Alpha
Call of Cthulhu 7e

调查、检定、SAN、追逐、角色知识边界与参考战役路径。Investigation, checks, SAN, chases, actor-knowledge boundaries, and a reference campaign path.

In testing
Narrative

系统无关长线叙事、权威 stdio MCP、Skills 与项目生成。System-neutral long-form play, authoritative stdio MCP, Skills, and project authoring.

Alpha
Extended ruleset import

保留来源的解析、质量报告与 Pack 校验;不等于任意规则书可直接运行。Source-preserving parsing, quality reports, and Pack validation—not arbitrary rulebook execution.

Experimental

边界就是产品Boundaries are product features

不把方便,误写成权威。Convenience never impersonates authority.

AGENT ≠ DATABASE

Agent 不拥有战役账本The Agent does not own the campaign ledger

模型、会话、渠道与主持风格属于 Agent;规则、角色权限、战役状态与 receipt 属于领域 MCP。Models, sessions, channels, and facilitation style belong to the Agent; rules, actor authority, campaign state, and receipts belong to the domain MCP.

PACK ≠ SAVE

内容包不是战役存档A content Pack is not a campaign save

Pack 不携带权限、ActorKnowledge、进度、随机流、分支或 Snapshot。导入与激活是两次独立、受权威控制的操作。Packs do not carry permissions, ActorKnowledge, progress, random streams, branches, or snapshots. Import and activation are separate authoritative operations.

PUBLIC ≠ LICENSED

仓库公开不等于内容开放Public visibility is not a content license

商业规则书、模组、图片与衍生资产必须逐项核对许可、署名和分发权。公开索引只证明可发现,不授予使用权。Commercial rulebooks, modules, images, and derived assets require item-level license, attribution, and distribution checks. A public index proves discoverability—not permission.

公开进展Public progress

变更留下时间与证据。Changes keep their dates and evidence.

VALIDATION

最新运行时完成 D&D 与 CoC 并行参考战役回归Current runtime completes parallel D&D and CoC reference regressions

长回归现会从当前 Agent 与领域依赖重建托管栈,以签名身份并发运行 D&D 和 CoC 参考战役,并保存逐战役机器可读证据。The long regression now rebuilds the hosted stack from the current Agent and domain dependencies, runs D&D and CoC reference campaigns concurrently with signed identity, and preserves machine-readable evidence per campaign.

ARCHITECTURE

D&D、CoC 与 Narrative 完成垂直仓库收敛D&D, CoC, and Narrative complete vertical repository convergence

三条领域链路现在分别在一个仓库内共同版本化 Domain、MCP、Skills、UI(如有)与创作流程;旧拆分仓库已归档为只读历史。Each domain path now versions Domain, MCP, Skills, UI where present, and authoring workflows in one repository; the former split repositories are archived read-only history.

PLATFORM

SagaSmith Web 与当前内容目录进入公开开发SagaSmith Web and the current content catalog enter public development

SagaSmith Web、D&D/CoC 多系统房间与当前 46 个 Content Pack 的校验和目录现已公开可见,同时继续保留明确的状态与内容权利边界。SagaSmith Web, hosted D&D/CoC rooms, and the checksum catalog for 46 current Content Packs are now publicly visible with explicit state and content-rights boundaries.

选择入口Choose an entry point

先决定谁来运行,再选择系统。Choose who operates it, then choose a system.

Local Agent Kit 是完整的本地发行物;SagaSmith Web 是托管产品代码库。两者不是主从关系,也不互作兼容回退。The Local Agent Kit is the complete local distribution; SagaSmith Web is the hosted product repository. Neither is a fallback for the other.

开始使用Get started