帮助文档 Documentation

快速上手 Getting Started

下载安装 Download & Install

从官网下载页获取最新安装包。运行 NSIS 安装向导，按提示完成安装。安装完成后可从桌面或开始菜单启动卡匠。 Download the latest installer from the Download page. Run the NSIS setup wizard and follow the prompts. After installation, launch 卡匠KaCraft from the desktop or Start Menu.

激活软件 Activate Software

1. 首次启动进入激活页面 On first launch, you will enter the activation page
2. 输入激活码（格式：KJ-YYYYMMDD-XXXXXX）和注册邮箱 Enter your license code (format: KJ-YYYYMMDD-XXXXXX) and registered email
3. 点击激活，联网验证后即可使用 Click Activate — online verification will complete the process
4. 激活后可离线使用，但需定期联网验证授权状态 After activation, offline use is supported, but periodic online verification is required

创建第一张卡片 Create Your First Card

1. 进入 Creator Studio Open Creator Studio
2. 点击"新建卡片"，填写卡片名称 Click "New Card" and enter a card name
3. 在"基础提示词"中编写角色设定 Write character settings in "Basic Prompts"
4. 在"角色信息"中添加角色（姓名、性格、外貌等） Add characters under "Character Info" (name, personality, appearance, etc.)
5. 配置输出格式模块 Configure output format modules
6. 保存卡片 Save the card

开始游玩 Start Playing

1. 切换到 Play Mode Switch to Play Mode
2. 选择已创建的卡片 Select a card you created
3. 开始与 AI 角色对话 Start chatting with the AI character
4. 使用侧栏查看角色状态、记忆等信息 Use the sidebar to view character status, memories, and more

Creator Studio Creator Studio

基础提示词 Basic Prompts

基础提示词采用分块编辑系统，将提示词拆分为多个区块，每个区块拥有名称和内容，可自由排序。支持变量注入（如 主角_姓名），在游玩时动态替换为实际值。 Basic Prompts use a block editing system that splits prompts into multiple blocks. Each block has a name and content, and can be freely reordered. Variable injection is supported (e.g. Protagonist_Name), dynamically replaced with actual values during play.

角色管理 Character Management

• 支持创建多个角色 Create multiple characters
• 每个角色可配置：姓名、性格、外貌描述、初始关系值 Each character can be configured with: name, personality, appearance description, initial relationship value
• 可为角色设置头像 Set avatars for characters
• 游玩时可切换活跃角色 Switch active character during play

输出格式编辑器 Output Format Editor

• 拖拽式模块编排：自由排列输出模块的顺序 Drag-and-drop module layout: Freely arrange the order of output modules
• 系统预置"正文叙述"模块（不可删除） Built-in "Narrative Text" module (cannot be deleted)
• 可添加自定义模块：互动日记、状态栏、环境窗口等 Add custom modules: Interactive Diary, Status Bar, Environment Window, etc.
• 每个模块可设置默认展开/折叠、字数限制 Each module can be set to default expand/collapse and word limit
• 一键预览生成示例回复 One-click preview to generate a sample reply

记忆系统 Memory System

卡匠采用三层记忆架构，模拟人类的记忆机制： 卡匠KaCraft uses a three-layer memory architecture that simulates human memory:

• STM（短期记忆）：自动记录最近对话要点，FIFO 队列，默认加载最近 3 条 STM (Short-Term Memory): Automatically records recent dialogue points, FIFO queue, loads the latest 3 entries by default
• LTM（长期记忆）：STM 固化后生成，保留重要事件，默认加载 5 条 LTM (Long-Term Memory): Generated from STM consolidation, retains important events, loads 5 entries by default
• CM（核心记忆）：手动晋升的关键记忆，始终加载，位于系统提示词之后，具有最高优先级 CM (Core Memory): Manually promoted key memories, always loaded, positioned after the system prompt with the highest priority

固化规则 Consolidation Rules

当 STM 达到固化周期（默认 5 条）时，取最老的 3 条 STM（先进先出），合并为一条 LTM；若超过字数限制则从尾部截断。可配置固化周期和字数限制。 When STM reaches the consolidation cycle (default 5 entries), the oldest 3 STM entries are merged (FIFO) into one LTM entry; if exceeding the word limit, truncated from the tail. Consolidation cycle and word limit are configurable.

世界书编辑器 World Book Editor

世界书通过关键词触发规则，在对话中动态注入世界观设定，让 AI 了解你的故事背景。 The World Book uses keyword trigger rules to dynamically inject world-building settings into conversations, helping the AI understand your story background.

• 关键词触发：支持多关键词（逗号分隔） Keyword triggers: Supports multiple keywords (comma-separated)
• 触发区域选择：系统消息 / 用户输入 / AI 回复 Trigger zone selection: System message / User input / AI reply
• 匹配模式：OR（任一匹配）/ AND（全部匹配） Match mode: OR (any match) / AND (all match)
• 优先级排序：高优先级条目优先注入 Priority sorting: Higher priority entries are injected first
• 正则表达式支持：高级匹配模式 Regex support: Advanced pattern matching
• 可视化助手：快速生成常用条目 Visual assistant: Quickly generate common entries

Play Mode Play Mode

界面介绍 Interface Overview

• 中央聊天区：流式模块渲染，支持展开/折叠 Central Chat Area: Streaming module rendering with expand/collapse support
• 左侧栏：当前卡片信息、世界书触发状态、记忆摘要、Token 统计 Left Sidebar: Current card info, World Book trigger status, memory summary, Token stats
• 右侧栏：角色状态、伙伴状态 Right Sidebar: Character status, companion status
• 顶部：角色切换下拉菜单 Top Bar: Character switch dropdown

对话交互 Dialogue Interaction

• 在输入框中发送消息，AI 将流式回复 Send messages in the input box, and the AI will reply in streaming mode
• 回复按模块渲染：正文叙述和状态栏默认展开 Replies are rendered by module: Narrative Text and Status Bar are expanded by default
• 互动日记、环境窗口等模块默认折叠，点击可展开查看 Interactive Diary, Environment Window, etc. are collapsed by default — click to expand

侧栏功能 Sidebar Features

• 世界书触发实时显示当前激活的条目 World Book triggers display currently active entries in real time
• 记忆查看和管理：查看 STM、LTM、CM 内容，手动晋升核心记忆 Memory viewing and management: View STM, LTM, CM content; manually promote core memories
• Token 使用统计：监控当前对话的 Token 消耗 Token usage statistics: Monitor Token consumption of the current conversation

工具栏操作 Toolbar Actions

• 新游戏：重置当前对话，重新开始 New Game: Reset the current conversation and start over
• 保存/加载存档：保存或恢复对话进度 Save/Load: Save or restore conversation progress
• 导出对话记录：将对话导出为文件 Export Dialogue: Export the conversation as a file
• AI 模型切换：在对话中切换 AI 模型 AI Model Switch: Switch AI models during conversation

AI生图配置 AI Image Generation

支持的服务商 Supported Providers

API Key 配置 API Key Setup

• 在全局设置中配置各服务商的 API Key Configure API Keys for each provider in Global Settings
• API Key 加密存储在本地，不上传到任何服务器 API Keys are encrypted and stored locally, never uploaded to any server
• 每个服务商有独立的配置区域，互不干扰 Each provider has its own independent configuration section

生图功能使用 Using Image Generation

• 在 Play Mode 对话中触发生图 Trigger image generation during Play Mode conversations
• 支持多视角立绘生成（1-4 个场景） Supports multi-view character illustration (1-4 scenes)
• 支持参考图（img2img）功能 Supports reference image (img2img) functionality
• 生成图片自动插入聊天，并保存到本地 Generated images are automatically inserted into the chat and saved locally

联系支持 Contact Support

如果你遇到任何问题或有建议，欢迎通过以下方式联系我们： If you encounter any issues or have suggestions, feel free to reach out: