编辑器选择与开发工具链

核心需求：纯文本编辑器

KAG scenario（.ks）和 TJS2 脚本（.tjs）都是纯文本文件，任何文本编辑器都能写。但好用的编辑器能大幅提升效率，因为：

• .ks 里大量使用 [tag attribute=value] 格式的标签
• .tjs 是类 JavaScript 语法
• 都需要代码高亮、括号匹配、自动补全

推荐的编辑器

VS Code / Cursor / Trae

首选。优势：

• 通过插件市场安装 KAG 语法高亮插件（搜索 "kirikiri" 或 "kag"）
• TJS2 可以用 JavaScript 语法高亮替代
• 内置文件浏览器、Git 集成、终端
• 支持多光标、正则替换、宏录制
• 可以装 Emmet 快速生成标签模板

在 settings.json 里把 .ks 关联到 KAG 或 HTML 语法高亮：

"files.associations": {
    "*.ks": "html",
    "*.tjs": "javascript"
}

Sublime Text

轻量、启动快、包管理强大。社区有 KAG 语法包，功能类似 VS Code 的插件。适合不需要 Git 集成的纯写作场景。

记事本++（Notepad++）

老牌免费编辑器，有 KAG 语法插件。Windows 原生、绿色便携，适合写短脚本或在没有其他工具时救急。

专用工具

• KAG3 Editor：官方/社区出品的专用编辑器，内置完整的 KAG 标签补全和参数提示。但比较老，仅 Windows。
• TyranoScript Studio 风格工具：某些第三方工具提供可视化编辑，但吉里吉里社区不太流行这种。

实用插件推荐

必装

• KAG Syntax Highlighting：给 .ks 文件上色
• Indent-Rainbow：缩进可视化，KAG 标签嵌套多时排查层级错误很好用
• Error Lens：如果有 TJS2 语法检查插件，错误直接显示在行尾

可选

• Regex Previewer：写复杂标签解析正则时预览效果
• Bracket Pair Colorizer：KAG 标签里方括号 [ ] 配对检查

图片处理工具

吉里吉里2 支持 TLG5/TLG6 格式。图片处理：

• Photoshop / GIMP：正常处理 PNG/JPG，最后用 TLG 转换工具转格式
• TLG Converter（SDK 自带 tlgcon.exe）：PNG → TLG5/TLG6 批量转换
• IrfanView：轻量看图，支持 TLG 格式

XP3 打包工具

• Releaser（SDK 自带）：图形界面，拖拽资源就能打包
• xp3pack / xp3dump：命令行版本，适合脚本化打包流程
• KrkrExtract：第三方 XP3 解包工具，支持 TJS2 反编译、图片解码

调试技巧

• 带 /DEV 参数启动：打开开发者控制台，可以实时执行 TJS2 语句
• 控制器模式：双击 exe 不指定项目，打开内置的 TJS2 REPL
• [tjs] 标签：在 scenario 里嵌入测试 TJS2 代码，改完保存就能热重载（部分引擎版本支持）

版本控制

用 Git 管理项目文件时注意：

• .tjs 和 .ks 都是纯文本，diff 友好
• 图片、音频、XP3 包是二进制，建议用 Git LFS
• 存档文件不要进版本库（加 .gitignore）

一句话工具链

VS Code（编辑）+ TLG Converter（转图）+ Releaser（打包）+ Git（版本控制）——这就是社区最常见的组合。