Ponderer - 思索者

中文

新增功能

物品挂载与思索标签

• 物品标签挂载：支持用 #物品标签 批量挂载思索，并可附加 NBT 匹配条件。
• 多物品挂载：可添加、移除多组物品 ID 或标签，每组独立设置 NBT 条件。
• 物品与标签候选：悬停 ID 输入框可展开所属标签，支持点击或滚轮切换，标签图标会轮播成员物品。
• 思索分类标签：描述编辑页新增标签选择器，支持搜索、图标预览和多选，并关联全部分场景与挂载物品。
• 自定义思索标签：可创建、编辑、重命名和删除标签，设置中英文名称、说明与物品图标，并保护仍被引用的标签。
• 思索者来源标签：所有思索自动附带“思索者...”标签。

界面捕获与交互

• 从世界捕获界面：正常打开目标容器即可捕获来源、开屏数据、槽位和可见方块上下文，保存后可在思索中回放。
• 界面试用模式：新增“试一试”、重置和退出操作，可暂停教程并在独立演示环境中操作容器。
• 界面脚本：可编排槽位物品与配料、数值动画、玩家状态、点击拖动、文字按键输入及界面关闭，并显示演示光标。
• 界面练习脚本：新增 await_interface，可等待玩家完成槽位目标，并设置提示、超时或跳过。
• AE2 界面适配：支持从 AE2 方块或线缆部件创建对应的本地演示菜单。

播放与自由预览

• 进度条自由定位：支持点击和长按拖动到任意时间，并吸附附近关键帧及首尾位置，无关键帧时也可使用。
• 播放倍速：新增 0.5x、1x、2x 独立按钮，可直接选择播放速度。
• 场景缩放滑条：新增 0.2x–5x 缩放滑条，中点为 1x，悬停显示当前倍率，右键可重置。
• 暂停自由预览：可用按钮或空格暂停，悬停识别方块，并用左键旋转、右键平移和滚轮缩放，按 Q 可恢复播放与原视角。
• 预览文本开关：暂停自由预览和编辑器预览可按 T 隐藏或显示思索文本。

步骤编辑器

• 步骤列表预览：新增场景预览，滚动列表可定位到顶部步骤，拖动时间轴可同步滚动列表。
• 步骤编辑预览：步骤编辑页新增场景预览，进入时定位到当前步骤，往返列表页时保留视角与文本显隐状态。
• 编辑器预览视角：支持左键旋转、右键平移、滚轮缩放及一键重置。
• 步骤快速切换：编辑页可用上下箭头切换步骤，存在未保存修改时可选择保存、放弃或取消切换。
• 当前步骤试播：可直接试播表单中的未保存步骤，播放时暂缓后续步骤，试播不会写入场景。
• 预览内选点：可在编辑预览中旋转视角并用中键取点，自动区分方块、相邻放置位置与面中心，按 Esc 取消。
• 多步骤复制粘贴：右键复制按钮可多选步骤，再按列表顺序一次粘贴到指定步骤后。
• 坐标拖动调节：坐标与向量输入框支持长按后上下拖动，以 0.5 为步长调整。
• 时长拖动调节：时长输入框支持长按后上下拖动，以 10 tick 为步长调整且不低于零。

世界生成结构

• 世界生成结构预览：结构列表可读取服务器可用结构，预览可用的起始模板，再确认选择或清空。

远程同步与资源包

• 远程待处理更新：新增冲突列表，可逐项或一键忽略、覆盖，忽略记录跨重连保留并在远端出现新版本时重新提示。
• 自动同步客户端设置：新增自动、始终开启和始终关闭三种模式，自动模式单人关闭、联机及局域网开启。
• 源资源包多选：可在同一列表勾选多个源资源包，查看图标与内容数量，确认后统一应用。

粒子效果与 Java 导出

• 粒子预设：新增通用“粒子效果”步骤，提供成功、红石、烟雾、飞溅、物品碎屑和方块碎屑预设。
• 自定义粒子：支持填写原版或模组粒子 ID 及 SNBT 参数，保存时校验粒子与参数。
• 粒子分布与发射：可设置定点、方盒或球体分布，以及位置、范围、每刻数量、持续时间和初始速度。
• 粒子与标签导出：Java 导出支持通用粒子、思索标签与物品标签挂载，物品标签展开为当前物品列表，NBT 条件暂不保留。

改进

界面场景

• 界面槽位编辑：支持拖动已有物品、右键清空及保存数量和数据组件。
• 界面叠层定位：文本、槽位图标与 JEI 使用嵌入容器的实际范围定位，并支持槽位物品识别。

文本进度

• 文本进度默认设置：可配置进入思索时是否显示文本进度，右键“舒适阅读”按钮可切换并保存默认值。
• 文本进度面板样式：沿用思索原生对话框配色和边框，并通过箭头关联“舒适阅读”按钮。

物品选择与新建思索

• 背包物品选择：多处物品字段新增背包选择按钮，可回填物品 ID 与 NBT，点击弹窗外即可关闭。
• 新建思索物品捕获：移除“使用手持物品”选项，改用背包选择，并以“同时捕获 NBT”控制是否填入 NBT。
• 新建思索流程：先选择结构或界面场景，再编辑描述，取消类型选择时不写入本地文件。
• 新建思索 NBT 编辑：NBT 字段接入展开编辑器，可在场景创建前编辑完整 SNBT。

步骤列表与字段编辑

• 步骤操作按钮：插入、复制、粘贴和删除改用图标，复制多选状态会高亮。
• 步骤内容摘要：步骤行并列显示类型和灰色参数摘要，悬停可查看完整文本、坐标、数量及动作。
• 步骤摘要本地化：物品、方块、实体、可用音效字幕及共享文本优先显示当前语言内容。
• 步骤内容搜索：步骤列表搜索同时匹配步骤类型与参数摘要。
• 字段工具图标：背包选择、方块与 NBT 抓取、选点、展开编辑和结构选择改用独立图标。
• 字段格式提示：为物品、NBT、角度、缩放、链接和结构字段统一填写示例及悬停说明。
• 坐标类型提示：区分场景、世界、界面坐标与向量，明确整数、小数及取值范围。
• 小数方块坐标：方块范围和坐标触发条件接受小数，保存时向下取整为所在方块坐标，包含负坐标。

相机动画

• 视角平移与缩放：调整视角改为前半程缓动平移、后半程缓动缩放，并在设定时长内到达目标。
• 相机旋转：改用 Ponder 原生缓出旋转，时长控制开始旋转后的等待时间，零时长仍为瞬间切换。

结构、蓝图与选点提示

• 结构后台读取：结构预览与信息解析改为后台处理，并显示加载状态。
• 结构预览分帧构建：方块填充和模型构建分帧进行，减轻大结构加载时的界面卡顿。
• 蓝图操作提示：按选角、调整和保存阶段显示操作说明，并同步显示选区尺寸。
• 蓝图保存反馈：保存成功后保留页面与结构 ID，并禁用重复保存。
• 蓝图教程说明：内置教程先介绍蓝图用途，再演示选区和保存操作。
• NBT 选取状态：等待服务器返回方块实体数据时持续显示等待提示，切换世界后清理状态。
• 坐标选取提示：选取期间持续显示当前操作提示，完成后自动清除。
• 世界内提示优先级：统一协调工具状态、蓝图提示与思索触发提示，短时结果优先显示，退出工具后清理提示。

远程管理

• 手动远程拉取：拉取指定场景或结构时直接覆盖本地，场景依赖的结构也会同步覆盖。
• 远程管理按钮：拉取、上传、历史、忽略和覆盖改用图标，覆盖与删除使用警示配色。

JEI 集成

• JEI 字段填入：物品、方块和实体等字段改用可预览的配料槽，可直接拖入对应 JEI 配料。
• 实体物品识别：实体字段除刷怪蛋外，也可从船等实体物品解析对应实体 ID。
• JEI 显隐设置：编辑器保留 JEI 原有显隐状态，列表未显示时提示对应快捷键或空间不足。

场景渲染

• 场景渲染缓存：定期回收闲置区段缓存，丢弃投影场景或切换世界时释放对应资源。

界面与操作反馈

• 未保存修改提示：统一返回与放弃修改对话框，明确提供保存返回、不保存返回和继续编辑选项。
• 列表布局：统一各类条目的左右边距、控件对齐和间距，并移除点击条目时的白色选中边框。
• 控件边界：按钮外框与点击范围保持一致，输入框和物品展示格统一保留 1px 内侧留白。
• 界面分组样式：统一菜单、列表和物品目录的分组标题、分隔线及编辑页背景。
• 确认与执行按钮：选择器与导出页改用确认和取消图标，区分执行操作与保存修改。
• 设置入口：V 菜单直接列出通用、AI、蓝图、投影仪及快捷键设置，权限管理移入“同步”分组。
• 操作结果提示：界面操作结果显示在原页面，并用不同颜色区分普通信息、成功、警告和错误。

AI 生成与编辑

• AI 多轮生成与编辑：可查询结构、注册表、步骤规则和参考资料后检查草稿，支持局部编辑或整体重写已有思索。
• AI 运行交互：新增流式输出侧栏、运行中补充指令与终止按钮，生成后可直接播放结果。
• AI 记录与恢复：可查看运行状态、用量和修改差异，恢复中断草稿，或撤销已保存的修改。
• AI 服务与运行配置：支持 Responses、Chat Completions、Anthropic 原生工具或 JSON 兼容，可设置推理强度、超时和运行预算。
• AI 生成保障：改用内置提示词并归档旧文件，结合实际模组和步骤规则校验草稿，支持上下文压缩、临时失败重试与保存冲突保护。

修复

JEI 集成

• 新版 JEI 兼容：修复了与新版 JEI 不兼容的问题。
• JEI 拖入区域：修正滚动后字段的有效拖入区域，避免屏幕外或被裁剪的字段接收配料。
• JEI 配料提示：使用 JEI 原生配料提示与渲染，保留模组附加信息，并兼容旧版 JEI。

物品 NBT

• NBT 物品预览与触发：统一按 1.21.1 数据组件或旧 NBT 条件构造物品，供预览、触发和编辑返回使用。

界面场景

• 界面物品 NBT 回填：修复显示界面步骤中，物品 NBT 展开编辑后未正确回填的问题。

思索播放与导航

• 文本面板遮挡：修复文本进度面板遮挡思索文本的问题。
• 返回列表界面缩放：修复退出思索返回物品目录时，界面缩放被历史页面初始化覆盖的问题。
• 分场景切换返回：切换思索分场景时不再被提前送回物品列表，退出播放后再返回原页面。

物品选择与场景保存

• 选取物品回填：创建掉落物时同步填入数量，选择无 NBT 物品时清除旧 NBT，避免沿用上次数据。
• 场景写入保护：先完整写入临时文件再替换原文件，降低保存中断导致场景损坏的风险。

文本与坐标编辑

• 文本编辑草稿隔离：取消文本编辑时，不再改动原步骤的多语言文本。
• 坐标触发输入校验：无效坐标会显示错误，不再被静默替换为零。

方块与区段动画

• 放置方块入场选项：移除动画模式中实际按向下入场处理的“无动画”选项，默认明确选择向下入场。
• 区段方块重影：修复放置、隐藏、替换、销毁及合并动画中的重复绘制和残留，Java 导出同步修正。
• 智能入场判断：按播放时的实际可见区段判断已显示方块，避免重叠结构重复入场或已显示部分消失。

结构预览

• 结构预览渲染：修复预览污染后续界面光照、第三方方块实体渲染干扰矩阵及上下拖动反向的问题。

自动同步

• 自动同步冲突保护：保留本地修改和手动删除的场景或结构，避免自动覆盖或恢复，并提示前往远程管理处理。

投影仪

• 投影仪模型朝向：配置界面模型使用固定朝向，避免随世界中投影仪的放置方向变化。

列表与 Ponder 兼容

• 列表滚动条拖动：修复步骤列表等页面点击滚动条后丢失焦点、无法持续拖动的问题。
• Ponder 文本框兼容：修复 Ponder 1.0.87 移除旧提示字段后，打开编辑界面触发 NoSuchFieldError 的问题。

English

New Features

Item Bindings and Ponder Categories

• Added item-tag bindings with optional NBT filters to attach a Ponder to every matching item.
• Added multiple item ID or tag bindings, each with its own NBT filter and add/remove controls.
• Added hover dropdowns and wheel selection for item IDs and their tags, with cycling tag-member icons.
• Added a searchable category picker with icons and multiple selection, linking tags to all segments and bound items.
• Added custom-category creation, editing, renaming, and deletion with bilingual text and item icons, protecting referenced categories from renaming or deletion.
• All scenes now automatically include The Ponderer category.

Interface Capture and Interaction

• Added world capture for container sources, opening data, slots, and visible block context for replay inside Ponder.
• Added Try, Reset, and Exit controls to pause tutorials and interact with containers in a separate demo environment.
• Added interface scripting for slot items and ingredients, data animations, player context, clicks and drags, text/key input, and closing interfaces, with a demo cursor.
• Added await_interface for slot-based exercises with hints, timeouts, and a skip control.
• Added local demo-menu opening for AE2 blocks and cable-bus parts.

Playback and Free Preview

• Added click-and-drag seeking at any time, with snapping to nearby keyframes and endpoints, including scenes without keyframes.
• Added dedicated 0.5x, 1x, and 2x playback buttons.
• Added a 0.2x–5x scene zoom slider with 1x at the midpoint, a hover multiplier, and right-click reset.
• Added button/Space toggling for paused block inspection, left-drag rotation, right-drag panning, and wheel zoom; Q resumes playback and restores the view.
• Added T to hide or show Ponder text in paused free previews and editor previews.

Step Editor

• Added a scene preview that seeks to the top visible step as the list scrolls and scrolls the list when scrubbing the timeline.
• Added scene previews to step editors, seeking to the current step and retaining camera and text visibility when returning to the list.
• Added left-drag rotation, right-drag panning, wheel zoom, and one-click camera reset to editor previews.
• Added previous/next step arrows with Save, Discard, and Cancel choices for unsaved edits.
• Added playback of unsaved form values with later steps paused, without writing the preview to the scene.
• Added middle-click picking inside editor previews for blocks, adjacent placement positions, and face centers, with camera controls and Esc cancellation.
• Added multiple-step selection by right-clicking Copy, then pasting all selected steps in list order after a chosen step.
• Added long-press vertical dragging to adjust coordinate and vector fields in 0.5 increments.
• Added long-press vertical dragging to adjust duration fields in 10-tick increments, clamped at zero.

World-Generation Structures

• Added server-backed world-generation structure selection with available starting-template previews and confirm/clear controls.

Remote Sync and Resource Packs

• Added pending remote updates with individual/bulk ignore or overwrite, persistent ignores, and renewed notices for newer versions.
• Added Auto, Always On, and Always Off sync modes; Auto disables sync in singleplayer and enables it in multiplayer and LAN.
• Added source-pack multi-selection with icons and content counts, applied together on confirmation.

Particle Effects and Java Export

• Added a generic Particle Effect step with success, redstone, smoke, spit, item, and block presets.
• Added vanilla and modded particle IDs with SNBT parameters and validation when saving.
• Added point, box, and sphere distributions with position, spread, count per tick, emission duration, and initial velocity.
• Added Java export for generic particles, Ponder categories, and item-tag bindings, expanding item tags to current item IDs and omitting NBT filters.

Improvements

Interface Scenes

• Slot editing now supports dragging existing items, right-click clearing, and saving counts and components.
• Text, slot overlays, and JEI now use the embedded container bounds, with ingredient lookup for its slots.

Text Progress

• Added a default text-progress setting, also saved by right-clicking the Comfy Reading button.
• Matched the text-progress panel to native Ponder speech-box colors and borders, with a pointer to the Comfy Reading button.

Item Selection and Ponder Creation

• Added inventory-picker buttons to item fields to fill item IDs and NBT, with outside-click dismissal.
• Simplified new-Ponder item selection to an inventory picker with an optional Capture NBT toggle.
• New Ponders now start with structure/interface scene selection followed by description editing; cancelling type selection leaves no local file.
• Added the expanded NBT editor to new-Ponder forms for editing full SNBT before a scene exists.

Step Lists and Field Editing

• Replaced step insert, copy, paste, and delete labels with icons and highlighted selected Copy buttons.
• Step rows now show types alongside gray parameter summaries, with full text, coordinates, counts, and actions on hover.
• Step summaries now resolve localized item, block, and entity names, available sound subtitles, and shared text.
• Step-list searches now match both step types and parameter summaries.
• Added distinct icons for inventory picking, block/NBT capture, point picking, expanded editing, and structure selection.
• Standardized example values and hover descriptions for item, NBT, angle, scale, link, and structure fields.
• Distinguished scene, world, and interface coordinates from vectors, with integer/decimal formats and valid ranges.
• Block ranges and coordinate triggers now accept decimals and floor them to containing-block coordinates, including negative values.

Camera Animation

• View adjustments now ease through panning followed by zooming, reaching their targets within the configured duration.
• Camera rotation now uses Ponder easing, with duration controlling the wait and zero duration remaining instantaneous.

Structures, Blueprints, and Picking Hints

• Moved structure-preview loading and analysis to background workers with loading feedback.
• Split preview block population and model baking across frames to reduce stalls when loading large structures.
• Added stage-specific blueprint hints for corner selection, resizing, and saving, alongside selection dimensions.
• Kept the blueprint page and saved structure ID visible after success, disabling duplicate saves.
• Added an introduction to blueprint usage before the built-in selection and saving demonstrations.
• Added a persistent waiting hint while fetching block-entity NBT, clearing the state when changing worlds.
• Kept coordinate-picking hints visible throughout selection, clearing them on completion.
• Coordinated world tool, blueprint, and Ponder-trigger hints, prioritizing transient results and clearing hints when tools end.

Remote Management

• Pulling a specific remote scene or structure now overwrites its local copy, including a scene's dependent structures.
• Added icons for remote pull, upload, history, ignore, and overwrite actions, with warning colors for overwrite and delete.

JEI Integration

• Replaced JEI field toggles with preview slots accepting matching item, block, entity, and other ingredient drops.
• Entity fields now resolve boats and other matching entity items in addition to spawn eggs.
• Editors now preserve JEI visibility preferences and explain how to reveal a hidden or space-constrained ingredient list.

Scene Rendering

• Added idle scene-cache cleanup and resource release when projector scenes are discarded or worlds change.

UI and Action Feedback

• Unified unsaved-change dialogs with explicit save, discard, and continue-editing choices.
• Unified horizontal margins, control alignment, and spacing across list-entry types, and removed white selection outlines.
• Aligned button borders with hit bounds and standardized 1px inner padding for inputs and ingredient slots.
• Unified section headings and dividers across menus, lists, and item browsing, plus editor backgrounds.
• Added confirm/cancel icons to selectors and exports, distinguishing action execution from saving edits.
• The V menu now directly lists general, AI, blueprint, projector, and keybinding settings, with permissions under Sync.
• Moved UI action results to their originating screens, distinguishing information, success, warnings, and errors by color.

AI Generation and Editing

• Added multi-turn generation with structure, registry, step-schema, and reference queries, draft review, and scoped editing or full rewrites of existing scenes.
• Added a streaming output panel, instructions during runs, cancellation, and direct playback of generated scenes.
• Added run status, usage, and change history, with interrupted-draft recovery and undo for saved changes.
• Added Responses, Chat Completions, and Anthropic native tools or JSON compatibility, with reasoning-effort, timeout, and run-budget settings.
• Switched to built-in prompts and archived legacy files, with runtime-grounded validation, context compaction, transient-error retries, and save-conflict protection.

Fixes

JEI Integration

• Fixed incompatibility with newer JEI versions.
• Fixed ingredient-drop bounds after scrolling so offscreen or clipped fields cannot receive drops.
• Switched ingredient rendering and tooltips to JEI's native APIs, preserving mod-added details and older JEI compatibility.

Item NBT

• Fixed stack construction from 1.21.1 components or legacy NBT for previews, triggers, and editor returns.

Interface Scenes

• Fixed expanded item-NBT edits not returning correctly to Show Interface steps.

Ponder Playback and Navigation

• Fixed the text-progress panel covering scene text.
• Fixed GUI scaling being overwritten by navigation-history screens when returning from Ponder to the item browser.
• Fixed segment transitions returning to the item list prematurely, restoring the originating page only after leaving playback.

Item Selection and Scene Saving

• Item-entity picking now fills counts, and selecting items without NBT clears stale NBT values.
• Wrote scenes to temporary files before replacement to reduce corruption from interrupted saves.

Text and Coordinate Editing

• Fixed cancelled text edits mutating the original step's localized text.
• Invalid trigger coordinates now report errors instead of silently becoming zero.

Block and Section Animation

• Removed the misleading None option from animated block entrances and explicitly defaulted to a downward entrance.
• Fixed duplicate or stale blocks during placement, hiding, replacement, destruction, and section merges, including Java exports.
• Fixed smart entrances to use runtime section visibility, avoiding repeated reveals or disappearing overlaps.

Structure Preview

• Fixed preview lighting leaking into other UI, block-entity renderers disturbing transforms, and inverted vertical dragging.

Automatic Sync

• Automatic sync now preserves locally edited or deleted scenes and structures, directing conflicts to remote management.

Projectors

• Fixed the projector config preview to use a consistent facing independent of its world placement.

Lists and Ponder Compatibility

• Fixed list scrollbars losing focus after clicks and failing to drag.
• Fixed editor NoSuchFieldError failures after Ponder 1.0.87 removed the legacy hint field.