Plugin Creator

创建 Lexora 插件

将用户的需求变成可安装、可修改的真实插件。完成最小可用版本，再依据编译诊断与用户的实际体验迭代。不要用占位 demo 代替需求。

理解需求

先利用当前对话确定输入、触发时机、呈现位置与生效范围、需要保留的数据和停止方式。描述充分时直接实施；只询问会改变实现的缺失信息。短需求选择轻量默认值并说明，不要求用户先填技术问卷。没有设置需求时优先复用插件管理中的启用、禁用，不额外增加导航和配置页面。

分别确定事件来自哪里、内容画在哪里、何时可见。事件来自某个控件，不意味着内容只能画在该控件内；保留用户指定的窗口、分屏或局部区域，不擅自缩小范围。未指定的视觉细节可以选择默认值；指定范围缺少正式能力时明确说明，不能用相近位置代替交付。

用户提供外部参考时先阅读公开说明或代码，提取需要复现的用户行为，再映射到 Lexora 的正式能力。参考项目的内部接口不能直接移植；读取失败时说明缺少的依据，不把推测写成已经核对的实现。

用户给出的作者署名或调用名不符合规则时，说明具体原因并给出 1–3 个保留原意的可用候选，通过对话请用户确定后继续。不要静默截断、转拼音、替换为系统账号或生成陌生名称；中文作者署名本身合法，无需改成英文。尚未指定调用名时可以按插件功能提出简短名称。

按需求组合能力

读取 能力选择与组合，将需求对应到输入来源、呈现方式、运行入口与状态归属，再确定最小清单。一个插件可以组合多种正式扩展点，也可以只提供命令或一个文件视图；现有示例不是插件类别或必须复制的模板。

查询宿主扩展能力时，通过 lexora_tool_search 查找 lexora_plugin_capabilities。先无参数查询当前宿主的简短目录，再按 kind 或 target 获取所需能力的契约；不要把完整目录提前塞进提示词。内容区的共同规则见 内容插槽。没有匹配位置时说明能力缺口，不借助 CSS 选择器或相近区域模拟替换。

先说明所选组合能完成的用户行为，再创作。文件阅读工具需要按文件打开的独立视图和各自的阅读状态；常驻信息条可能需要底部挂载、宿主查询命令与私有设置。不要因为都“有界面”就统一做导航页，也不要为了演示全部 API 给插件添加无关权限。

阅读协议并创作

继续旧对话创作时，重新读取当前技能与协议。历史消息、旧工具结果和压缩摘要中的命名示例不作为新插件的身份依据；维护已有插件时读取实际源码清单，并保留其中的 ID。

1. 读取 协议与清单 和 完整 API 类型。这些文件与当前 Lexora 一起分发；不要根据其他产品的插件格式猜测接口。 需要实时配置、表单依赖或运行状态判断时，读取 条件函数，声明数据输入与作用域，不将函数序列化进清单。需要 Agent 指令、后台任务动作、模型调用、任务标题或原生设置时，追加读取 Agent 与设置，并确认当前宿主能力目录支持。事件驱动动作与订阅按 事件与触发列表 选择精确入口和载荷，不把普通事件监听器当作任务能力调用。
2. 在当前可写工作区创建独立源码目录，例如 plugins/<插件名>/。通过文件工具写入真实文件，保留源码以便后续对话修改。不需要用户另外安装 Node、Bun 或 SDK。
3. 新建独立插件时通过 lexora_tool_search 查找 lexora_plugin_identity，传入按功能选定的简短英文 slug，将返回的 id、author 和 engines 写入 extension.json。作者未指定时省略参数，使用已保存的默认署名；明确不署名时传空字符串。作者名支持中文，不要求用户提供英文名、平台账号或唯一名称，也不从系统用户名、Git 配置或目录推断署名。不要自行编造 ID 或继续生成 local.*。修改、升级、换电脑维护及分发沿用源码内已有 ID，不重新调用身份生成工具；包括已有的 local.*。只有创建独立副本时生成新 ID 并同步内部引用。
4. 按选定组合声明视图、命令、导航和挂载点，明确每项能力由宿主入口还是视图入口调用；限定页面时使用公开上下文和声明条件。仅声明实际需要的权限；没有对应能力时解释限制，不绕过隔离访问宿主 DOM、内部接口或文件。明确用户第一次如何启动、关闭后如何再次打开；普通挂载需要显式打开；内容插槽和替换控件的启用、回退与配置归属按 内容插槽 实现。现有入口足够时不额外增加设置页。
5. 使用自包含 TS/JS 和包内资源。复制 references/api.d.ts 为源码目录的 lexora.d.ts，仅通过 import type 引用。源码清单设置 format: "source"。视图导出 render(context, container)，需要命令、存储或调度时再添加宿主入口 activate(context)。
6. 事件、定时器、动画在关闭时清理，动画结束回收节点、空闲时停止循环。页面使用主题变量；窗口效果保持透明、不阻挡输入，并尊重减少动态效果偏好。

修改作者署名时直接更新清单 author，保留已有 id 和所有贡献引用，无需调用身份生成工具。ID 的前缀不会自动成为署名；用户说“用户名”或“发布者”且含义不明确时，先区分作者署名与更换插件身份。用户明确要求更换 ID 时，先说明它会被当作另一份插件，既有数据不会自动转移。

编译与修正

通过 lexora_tool_search 查找 lexora_plugin_build，然后调用它：

如果当前明确是在独立 Lexora Plugin SDK 仓库中开发、没有 Lexora 内置工具，使用 SDK 工作流。普通 Lexora 对话不需要这条分支。

{ "source": "plugins/my-plugin", "output": "my-plugin-1.0.0.lexora-extension", "review": true }

output 是已存在父目录中的新文件，放在源码目录之外；现有文件不会被覆盖。工具使用内置隔离编译器，不执行 npm 安装脚本或插件代码。错误结果包含 code 与有限的 diagnostics：修正对应问题后重新构建，避免重复提交相同错误。需要重新生成包时使用新的输出文件名。

review: true 请求显示安装确认，用户确认后才会安装。只要求源码或打包时设为 false。不要绕过确认或通过内部配置安装。交付前核对构建结果中的 id、name、author 和 version。author 为空表示安装界面会显示未署名；用户要求署名时，修正清单并重新构建，不能把 ID 前缀当作署名已经生效。构建结果中的 installation 只表示是否发起审核，不代表当前安装状态；旧版本返回的 installed: false 也不能用于断言用户尚未安装。

需要判断安装、待应用更新或加载失败时，通过 lexora_tool_search 查找 lexora_plugin_inspect，以插件 id 读取当前宿主状态。比较当前版本与 pendingVersion，检查可见命令、导航入口、视图 ready 和错误。仍待用户审核时交付结果即可，不循环轮询；工具不可用时明确安装状态未核实。ready 只证明入口完成加载，不能代替实际功能验收。

通过 lexora_output_present 交付源码目录与安装包。不要只在回答中粘贴代码，也不要下载 SDK 或建立另一套构建工程。

验证与迭代

按所选能力检查主要动作，以及真正影响它的边界：文件视图验证两份资源的状态互不覆盖；组合面板验证导航切换和设置刷新；控件验证宿主允许值、失败回退与明确重试；后台命令验证关闭页面后仍按约定运行。再验证禁用后的停止行为，避免机械套用某个示例的测试步骤。

有持久设置时，检查修改后的实际行为、离开页面再返回及重启后的恢复；开关需要验证关闭与重新开启，不能只确认表单显示成功提示。

编译通过只证明包可构建，不证明界面和运行效果通过。Lexora 的浏览器工具只能控制资源浏览器，不能操作插件安装弹窗或窗口效果；不要为此创建另一个 HTML 模拟宿主来代替安装验收。有能操作真实插件界面的工具时执行检查；否则交付编译后的包和待验证项，让用户安装后反馈，不在等待安装期间反复调用无关工具。不要编造截图、通知送达、运行成功或性能数据。

交付简短说明：完成了什么、源码与包的位置、如何触发、已检查和仍待体验的行为。用户反馈后读取现有源码，修正实现、重新编译并再次验证相同场景。保持 ID 与数据含义稳定。发布市场或同步远端单独遵循用户指示。