AliceJump · Oct 6, 2026 · Oct 6, 2026 · Oct 6, 2026 · Oct 6, 2026 · Oct 6, 2026
diff --git a/jetbrains b/jetbrains
diff --git a/media/gettingStarted/visual-workflow.svg b/media/gettingStarted/visual-workflow.svg
diff --git a/package.json b/package.json
@@ -35,12 +35,19 @@
   "activationEvents": [
     "onLanguage:python",
     "onLanguage:json",
-    "onLanguage:jsonc"
+    "onLanguage:jsonc",
+    "workspaceContains:config.py",
+    "workspaceContains:src/config.py"
   ],
-  "main": "./out/extension.js",
+  "main": "./out/entrypoint.js",
   "l10n": "./l10n",
   "contributes": {
     "commands": [
+      {
+        "command": "okScriptToolkit.openGettingStarted",
+        "title": "%command.openGettingStarted%",
+        "category": "%command.category%"
+      },
       {
         "command": "okScriptToolkit.showTemplates",
         "title": "%command.showTemplates%",
@@ -66,6 +73,11 @@
         "title": "%command.openTemplateAssets%",
         "category": "%command.category%"
       },
+      {
+        "command": "okScriptToolkit.openResourcePublisher",
+        "title": "%command.openResourcePublisher%",
+        "category": "%command.category%"
+      },
       {
         "command": "okScriptToolkit.openAnnotationEditor",
         "title": "%command.openAnnotationEditor%",
@@ -87,6 +99,81 @@
         "category": "%command.category%"
       }
     ],
+    "walkthroughs": [
+      {
+        "id": "okScriptToolkit.getStarted",
+        "title": "%walkthrough.title%",
+        "description": "%walkthrough.description%",
+        "steps": [
+          {
+            "id": "chooseGoal",
+            "title": "%walkthrough.goal.title%",
+            "description": "%walkthrough.goal.description%",
+            "media": {
+              "image": "media/gettingStarted/visual-workflow.svg",
+              "altText": "%walkthrough.visual.mediaAlt%"
+            }
+          },
+          {
+            "id": "loadProject",
+            "title": "%walkthrough.project.title%",
+            "description": "%walkthrough.project.description%",
+            "media": {
+              "image": "media/gettingStarted/visual-workflow.svg",
+              "altText": "%walkthrough.visual.mediaAlt%"
+            },
+            "completionEvents": [
+              "onContext:okScriptToolkit.projectReady"
+            ]
+          },
+          {
+            "id": "visualResources",
+            "title": "%walkthrough.visual.title%",
+            "description": "%walkthrough.visual.description%",
+            "media": {
+              "image": "media/gettingStarted/visual-workflow.svg",
+              "altText": "%walkthrough.visual.mediaAlt%"
+            },
+            "completionEvents": [
+              "onCommand:okScriptToolkit.openTemplateAssets"
+            ]
+          },
+          {
+            "id": "publishResources",
+            "title": "%walkthrough.publish.title%",
+            "description": "%walkthrough.publish.description%",
+            "media": {
+              "image": "media/gettingStarted/visual-workflow.svg",
+              "altText": "%walkthrough.visual.mediaAlt%"
+            },
+            "completionEvents": [
+              "onCommand:okScriptToolkit.openResourcePublisher"
+            ]
+          },
+          {
+            "id": "runTask",
+            "title": "%walkthrough.run.title%",
+            "description": "%walkthrough.run.description%",
+            "media": {
+              "image": "media/gettingStarted/visual-workflow.svg",
+              "altText": "%walkthrough.visual.mediaAlt%"
+            },
+            "completionEvents": [
+              "onCommand:okScriptToolkit.showTaskLauncher"
+            ]
+          },
+          {
+            "id": "resources",
+            "title": "%walkthrough.links.title%",
+            "description": "%walkthrough.links.description%",
+            "media": {
+              "image": "media/gettingStarted/visual-workflow.svg",
+              "altText": "%walkthrough.visual.mediaAlt%"
+            }
+          }
+        ]
+      }
+    ],
     "viewsContainers": {
       "activitybar": [
         {

diff --git a/package.nls.es.json b/package.nls.es.json
@@ -2,15 +2,32 @@
   "extension.displayName": "ok-script Toolkit",
   "extension.description": "Autocompletado, sugerencias en línea, vista previa de plantillas, lanzamiento de tareas, herramientas de datos de personajes y más para proyectos ok-script.",
   "command.category": "ok-script Toolkit",
+  "command.openGettingStarted": "Primeros pasos",
   "command.showTemplates": "Abrir galería de plantillas",
   "command.screenshotToTemplate": "Capturar en Recursos de Plantilla",
   "command.openTemplatesEditor": "Abrir galería de plantillas en el editor",
   "command.showTaskLauncher": "Abrir consola",
   "command.openCharacterManager": "Abrir gestor de personajes y habilidades",
   "command.openTemplateAssets": "Abrir recursos de plantillas",
+  "command.openResourcePublisher": "Abrir publicación de recursos",
   "command.openAnnotationEditor": "Abrir editor de anotaciones",
   "command.showTempScreenshots": "Abrir capturas temporales",
   "command.showConventionSources": "Convención del proyecto vs. mi configuración",
+  "walkthrough.title": "Primeros pasos con ok-script Toolkit",
+  "walkthrough.description": "Elige lo que quieres hacer y sigue el flujo proyecto → recursos → ejecución.",
+  "walkthrough.goal.title": "¿Qué quieres hacer?",
+  "walkthrough.goal.description": "[Escribir o ejecutar tareas](command:okScriptToolkit.showTaskLauncher) · [Crear recursos visuales](command:okScriptToolkit.openTemplateAssets) · [Publicar recursos](command:okScriptToolkit.openResourcePublisher)",
+  "walkthrough.project.title": "1. Cargar un proyecto ok-script",
+  "walkthrough.project.description": "Abre un espacio de trabajo con `config.py` o `src/config.py`, o configura `okScriptToolkit.okScriptProjectPath`. Este paso se completa automáticamente al detectar un proyecto compatible.",
+  "walkthrough.visual.title": "2. Crear recursos visuales",
+  "walkthrough.visual.description": "[Abrir gestión de anotaciones](command:okScriptToolkit.openTemplateAssets) para capturar o importar imágenes y crear anotaciones Template, Rect y Point en un único editor.",
+  "walkthrough.visual.mediaAlt": "Flujo de imagen a anotaciones Template, Rect y Point y publicación",
+  "walkthrough.publish.title": "3. Publicar recursos",
+  "walkthrough.publish.description": "[Abrir publicación de recursos](command:okScriptToolkit.openResourcePublisher), selecciona Template / Rect / Point y publica. Los recursos de posición pueden exportarse como JSON o Python.",
+  "walkthrough.run.title": "4. Ejecutar y depurar",
+  "walkthrough.run.description": "[Abrir el ejecutor](command:okScriptToolkit.showTaskLauncher), elige una tarea, ajusta parámetros, ejecútala y consulta el estado y los registros.",
+  "walkthrough.links.title": "Seguir explorando",
+  "walkthrough.links.description": "[Documentación](https://github.com/AliceJump/ok-script-toolkit#readme) · [GitHub](https://github.com/AliceJump/ok-script-toolkit) · [Issues / Comentarios](https://github.com/AliceJump/ok-script-toolkit/issues) · [Notas de versión](https://github.com/AliceJump/ok-script-toolkit/releases)",
   "viewContainer.title": "Herramientas de ok-script",
   "viewContainer.tools.title": "Herramientas de ok-script",
   "viewContainer.templates.title": "Plantillas de ok-script",

diff --git a/package.nls.ja.json b/package.nls.ja.json
@@ -2,15 +2,32 @@
   "extension.displayName": "ok-script ツールキット",
   "extension.description": "ok-script プロジェクト向けの補完、インラインヒント、テンプレートプレビュー、タスク起動、キャラクターデータツールなど。",
   "command.category": "ok-script ツールキット",
+  "command.openGettingStarted": "はじめに",
   "command.showTemplates": "テンプレートギャラリーを開く",
   "command.screenshotToTemplate": "スクリーンショットをテンプレート素材へ",
   "command.openTemplatesEditor": "テンプレートギャラリーをエディターで開く",
   "command.showTaskLauncher": "コンソールを開く",
   "command.openCharacterManager": "キャラクター・スキル管理を開く",
   "command.openTemplateAssets": "テンプレートアセットを開く",
+  "command.openResourcePublisher": "リソース公開を開く",
   "command.openAnnotationEditor": "アノテーションエディターを開く",
   "command.showTempScreenshots": "一時スクリーンショットを開く",
   "command.showConventionSources": "プロジェクト規約と自分の設定",
+  "walkthrough.title": "ok-script ツールキットを始める",
+  "walkthrough.description": "やりたいことを選び、プロジェクト → リソース → 実行の流れで進めます。",
+  "walkthrough.goal.title": "何をしますか？",
+  "walkthrough.goal.description": "[タスクを書く・実行する](command:okScriptToolkit.showTaskLauncher) · [ビジュアルリソースを作る](command:okScriptToolkit.openTemplateAssets) · [リソースを公開する](command:okScriptToolkit.openResourcePublisher)",
+  "walkthrough.project.title": "1. ok-script プロジェクトを読み込む",
+  "walkthrough.project.description": "`config.py` または `src/config.py` を含むワークスペースを開くか、`okScriptToolkit.okScriptProjectPath` を設定します。対応プロジェクトを検出すると自動で完了します。",
+  "walkthrough.visual.title": "2. ビジュアルリソースを作る",
+  "walkthrough.visual.description": "[アノテーション管理を開く](command:okScriptToolkit.openTemplateAssets)と、画像のキャプチャやインポート、Template・Rect・Point の注釈を 1 つのエディターで行えます。",
+  "walkthrough.visual.mediaAlt": "画像から Template、Rect、Point の注釈を作り公開するワークフロー",
+  "walkthrough.publish.title": "3. リソースを公開する",
+  "walkthrough.publish.description": "[リソース公開を開く](command:okScriptToolkit.openResourcePublisher)から Template / Rect / Point を選択して公開します。位置リソースは JSON または Python で出力できます。",
+  "walkthrough.run.title": "4. 実行とデバッグ",
+  "walkthrough.run.description": "[ランナーを開く](command:okScriptToolkit.showTaskLauncher)からタスクを選び、パラメータを調整して起動し、実行状態とログを確認します。",
+  "walkthrough.links.title": "さらに使う",
+  "walkthrough.links.description": "[ドキュメント](https://github.com/AliceJump/ok-script-toolkit#readme) · [GitHub](https://github.com/AliceJump/ok-script-toolkit) · [Issue / フィードバック](https://github.com/AliceJump/ok-script-toolkit/issues) · [リリースノート](https://github.com/AliceJump/ok-script-toolkit/releases)",
   "viewContainer.title": "ok-script ツール",
   "viewContainer.tools.title": "ok-script ツール",
   "viewContainer.templates.title": "ok-script テンプレート",

diff --git a/package.nls.json b/package.nls.json
@@ -2,15 +2,32 @@
   "extension.displayName": "ok-script Toolkit",
   "extension.description": "IntelliSense, inline hints, template previews, task launching, character data tools, and more for ok-script projects.",
   "command.category": "ok-script Toolkit",
+  "command.openGettingStarted": "Getting Started",
   "command.showTemplates": "Open Resource Preview",
   "command.screenshotToTemplate": "Screenshot to Annotation Management",
   "command.openTemplatesEditor": "Open Resource Preview in Editor",
   "command.showTaskLauncher": "Open Console",
   "command.openCharacterManager": "Open Character & Skill Manager",
   "command.openTemplateAssets": "Open Annotation Management",
+  "command.openResourcePublisher": "Open Resource Publishing",
   "command.openAnnotationEditor": "Open Annotation Editor",
   "command.showTempScreenshots": "Open Temp Screenshots",
   "command.showConventionSources": "Project Convention vs My Settings",
+  "walkthrough.title": "Get Started with ok-script Toolkit",
+  "walkthrough.description": "Choose what you want to do and follow the project → resources → run workflow.",
+  "walkthrough.goal.title": "What do you want to do?",
+  "walkthrough.goal.description": "[Write or run tasks](command:okScriptToolkit.showTaskLauncher) · [Create visual resources](command:okScriptToolkit.openTemplateAssets) · [Publish resources](command:okScriptToolkit.openResourcePublisher)",
+  "walkthrough.project.title": "1. Load an ok-script project",
+  "walkthrough.project.description": "Open a workspace containing `config.py` or `src/config.py`, or configure `okScriptToolkit.okScriptProjectPath`. This step completes automatically when a supported project is detected.",
+  "walkthrough.visual.title": "2. Create visual resources",
+  "walkthrough.visual.description": "[Open Annotation Management](command:okScriptToolkit.openTemplateAssets) to capture or import images and create Template, Rect, and Point annotations in one editor.",
+  "walkthrough.visual.mediaAlt": "Image to Template, Rect, and Point annotation and publishing workflow",
+  "walkthrough.publish.title": "3. Publish resources",
+  "walkthrough.publish.description": "[Open Resource Publishing](command:okScriptToolkit.openResourcePublisher), select Template / Rect / Point, then publish. Position resources can be exported as JSON or Python.",
+  "walkthrough.run.title": "4. Run and debug",
+  "walkthrough.run.description": "[Open the runner](command:okScriptToolkit.showTaskLauncher), choose a task, adjust parameters, start it, and follow runtime status and logs.",
+  "walkthrough.links.title": "Keep exploring",
+  "walkthrough.links.description": "[Documentation](https://github.com/AliceJump/ok-script-toolkit#readme) · [GitHub](https://github.com/AliceJump/ok-script-toolkit) · [Issues / Feedback](https://github.com/AliceJump/ok-script-toolkit/issues) · [Release Notes](https://github.com/AliceJump/ok-script-toolkit/releases)",
   "viewContainer.title": "ok-script Tools",
   "viewContainer.tools.title": "ok-script Tools",
   "viewContainer.templates.title": "ok-script Resources",

diff --git a/package.nls.ko.json b/package.nls.ko.json
@@ -2,15 +2,32 @@
   "extension.displayName": "ok-script 툴킷",
   "extension.description": "ok-script 프로젝트용 자동 완성, 인라인 힌트, 템플릿 미리보기, 작업 실행, 캐릭터 데이터 도구 등.",
   "command.category": "ok-script 툴킷",
+  "command.openGettingStarted": "시작하기",
   "command.showTemplates": "템플릿 갤러리 열기",
   "command.screenshotToTemplate": "스크린샷을 템플릿 에셋으로",
   "command.openTemplatesEditor": "편집기에서 템플릿 갤러리 열기",
   "command.showTaskLauncher": "콘솔 열기",
   "command.openCharacterManager": "캐릭터·스킬 관리자 열기",
   "command.openTemplateAssets": "템플릿 에셋 열기",
+  "command.openResourcePublisher": "리소스 게시 열기",
   "command.openAnnotationEditor": "어노테이션 편집기 열기",
   "command.showTempScreenshots": "임시 스크린샷 열기",
   "command.showConventionSources": "프로젝트 규약과 내 설정",
+  "walkthrough.title": "ok-script 툴킷 시작하기",
+  "walkthrough.description": "원하는 작업을 선택하고 프로젝트 → 리소스 → 실행 흐름을 따라가세요.",
+  "walkthrough.goal.title": "무엇을 하시겠어요?",
+  "walkthrough.goal.description": "[작업 작성 또는 실행](command:okScriptToolkit.showTaskLauncher) · [시각 리소스 제작](command:okScriptToolkit.openTemplateAssets) · [리소스 게시](command:okScriptToolkit.openResourcePublisher)",
+  "walkthrough.project.title": "1. ok-script 프로젝트 불러오기",
+  "walkthrough.project.description": "`config.py` 또는 `src/config.py`가 있는 작업 영역을 열거나 `okScriptToolkit.okScriptProjectPath`를 설정하세요. 지원 프로젝트가 감지되면 자동으로 완료됩니다.",
+  "walkthrough.visual.title": "2. 시각 리소스 제작",
+  "walkthrough.visual.description": "[주석 관리 열기](command:okScriptToolkit.openTemplateAssets)에서 이미지를 캡처하거나 가져오고 하나의 편집기에서 Template, Rect, Point 주석을 만드세요.",
+  "walkthrough.visual.mediaAlt": "이미지에서 Template, Rect, Point 주석을 만들고 게시하는 워크플로",
+  "walkthrough.publish.title": "3. 리소스 게시",
+  "walkthrough.publish.description": "[리소스 게시 열기](command:okScriptToolkit.openResourcePublisher)에서 Template / Rect / Point를 선택해 게시하세요. 위치 리소스는 JSON 또는 Python으로 내보낼 수 있습니다.",
+  "walkthrough.run.title": "4. 실행 및 디버깅",
+  "walkthrough.run.description": "[러너 열기](command:okScriptToolkit.showTaskLauncher)에서 작업을 선택하고 매개변수를 조정해 실행한 뒤 상태와 로그를 확인하세요.",
+  "walkthrough.links.title": "더 알아보기",
+  "walkthrough.links.description": "[문서](https://github.com/AliceJump/ok-script-toolkit#readme) · [GitHub](https://github.com/AliceJump/ok-script-toolkit) · [Issue / 피드백](https://github.com/AliceJump/ok-script-toolkit/issues) · [릴리스 노트](https://github.com/AliceJump/ok-script-toolkit/releases)",
   "viewContainer.title": "ok-script 도구",
   "viewContainer.tools.title": "ok-script 도구",
   "viewContainer.templates.title": "ok-script 템플릿",
+21 −0		src/main/kotlin/com/alicejump/okscripttoolkit/GettingStartedBundle.kt
+40 −0		src/main/kotlin/com/alicejump/okscripttoolkit/tasklauncher/TaskLauncherNavigation.kt
+261 −0		src/main/kotlin/com/alicejump/okscripttoolkit/ui/GettingStartedEditor.kt
+11 −0		src/main/resources/META-INF/plugin.xml
+28 −0		src/main/resources/messages/OkScriptToolkitGettingStartedBundle.properties
+28 −0		src/main/resources/messages/OkScriptToolkitGettingStartedBundle_es.properties
+28 −0		src/main/resources/messages/OkScriptToolkitGettingStartedBundle_ja.properties
+28 −0		src/main/resources/messages/OkScriptToolkitGettingStartedBundle_ko.properties
+28 −0		src/main/resources/messages/OkScriptToolkitGettingStartedBundle_zh_CN.properties
+28 −0		src/main/resources/messages/OkScriptToolkitGettingStartedBundle_zh_TW.properties