人工智能AI Agent自主智能体桌面应用MCP Clients【免费下载链接】KunLocal-first AI agent workspace for coding, writing, design, research, and automation — one runtime for desktop GUI and TUI.项目地址https://gitcode.com/gh_mirrors/de/Kun点击查看免费下载examples/ui-plugins/starlight/artwork/README.md记录了官方示例插件 Starlight星夜 Kun舞台背景的创作源头一张自包含的矢量图starlight-stage.svg导出为 1600 × 900 的 WebP 后由manifest.json引用而存放源文件的artwork/目录在安装时被有意忽略。本文以此为入口完整拆解 Kun UI 插件形象工坊的「矢量源文件 → WebP 导出 → manifest 引用 → 安装白名单复制」素材管线并结合仓库源码说明背景图层的校验、默认参数与宿主 CSS 注入原理帮助插件作者正确规划资源目录并理解为什么artwork/不会被安装。一、Starlight 插件与 artwork 目录的定位Kun 的「形象工坊」允许任何人制作并安装自己的视觉形象包一个 UI 插件就是一个文件夹manifest.json加上被 manifest 引用的图片。官方示例 Starlight 同时演示了旧版兼容的形象槽位、背景路径简写与完整背景图层对象目录结构如下examples/ui-plugins/starlight/ ├── artwork/ │ ├── README.md # 素材源文件说明本文关联文档 │ └── starlight-stage.svg # 原创矢量源自包含 ├── img/ │ ├── bird.png / greet.png / sit.png / sleep.png / surf.png │ └── starlight-stage.webp # 1600 × 900 WebP 导出manifest 实际引用 ├── README.md └── manifest.jsonartwork/目录的核心定位见 artwork/README.md是保存可再编辑的创作源文件starlight-stage.svg是img/starlight-stage.webp的原始矢量来源它不依赖任何外部图片、字体或网络资源是一个完全自包含的单文件矢量图。而 WebP 导出才是运行时真正被加载的资源。二、为什么源文件要自包含1600 × 900 舞台背景的创作约束原文档强调starlight-stage.svguses no external images, fonts, or network resources。这一约束对 UI 插件作者有实际意义可移植性插件是纯声明式的资源包安装时应用只复制 manifest 引用的图片源文件若引用了外部字体或图片导出的 WebP 可能在不同环境出现渲染差异。可审计性Kun 主进程在安装、预装和重新加载时会调用应用已有的图片解码器验证像素数据而不只信任文件头见 docs/UI_PLUGINS.md。自包含源文件导出的成品更容易通过逐字节校验。打开 starlight-stage.svg 可以看到它的矢量结构完全是手写声明式的sky线性渐变#141028→#29204e→#44326f铺出深紫夜空nebula径向渐变与soft高斯模糊滤镜feGaussianBlur stdDeviation20叠加出星云光晕随后是 11 个带不同opacity的星点circle、两道流线型path曲线以及三层山脊路径path分别使用ridge渐变、#211a35与#171224。整个文件只有defs、渐变、滤镜与基础图形元素没有任何image或字体引用——这正是「自包含」的直接体现。三、manifest 只引用 WebPartwork/ 不参与安装原文档指出The WebP export is 1600 × 900. Only the WebP is referenced bymanifest.json; this authoring directory is intentionally ignored when the plugin is installed.对应地manifest.json 中的backgrounds部分只指向img/下的成品backgrounds: { light: { stage: img/starlight-stage.webp }, dark: { stage: { path: img/starlight-stage.webp, fit: cover, position: center, opacity: 0.42 } } }安装行为与 docs/UI_PLUGINS.md 的描述完全一致应用校验 manifest 和图片后只把 manifest 与被figures/backgrounds/scene引用的图片复制进应用数据目录~/.kun/ui-plugins/id/未引用的创作源文件不会复制。也就是说img/starlight-stage.webp被安装artwork/starlight-stage.svg和artwork/README.md被忽略。这带来一个直接结论artwork/里的源文件仅供作者维护与再编辑并不会增大运行时占用、也不会被宿主解析或执行。Kun 明确不执行插件中的 JS、HTML、CSS 或 SVG见 docs/UI_PLUGINS.md源文件留在插件目录中只作为创作资产。四、源码级验证背景路径白名单与默认透明度从源码结构看Kun 对背景图层的管理集中在src/shared/ui-plugin-presentation.ts与src/shared/ui-plugin-css.tsisSafeUiPluginBackgroundPath(value)src/shared/ui-plugin-presentation.ts校验背景图片路径必须是插件目录内的相对路径禁止绝对路径、..与反斜杠docs/UI_PLUGINS.md。artwork/starlight-stage.svg正因为未被 manifest 引用根本不会进入这条校验与复制链路。UI_PLUGIN_BACKGROUND_DEFAULT_OPACITYsrc/shared/ui-plugin-presentation.ts为五个背景槽位定义了默认透明度app为0.22、sidebar为0.18、stage为0.32、write/design为0.50。Starlight 的dark.stage显式写了opacity: 0.42就是在这个固定槽位上的自定义值。字符串简写与对象等价stage: img/starlight-stage.webp是{ path: … }的简写完整对象可追加fitcover/contain默认cover、position九宫格九个位置默认center与opacity0–1省略时用上表默认值。buildUiPluginBackgroundCsssrc/shared/ui-plugin.ts在启用主题时把上述参数编译成宿主生成的 CSS。背景图片本身不携带布局或样式权限应用只读取图像像素再在固定的安全图层中应用fit/position/opacity参数docs/UI_PLUGINS.md。五、light / dark 不自动回退为什么两边都要显式声明Starlight 的 manifest 同时声明了backgrounds.light.stage字符串简写与backgrounds.dark.stage完整对象插件自己的 README.md 明确说明了原因明暗主题都被显式声明因为背景主题之间不会自动回退。这是 Kun 背景图层的固定规则只声明light.stage时深色主题不会偷偷沿用它。若希望两种主题显示同一张图必须在light与dark两边都显式声明docs/UI_PLUGINS.md。这一设计让作者可以对明暗主题分别配置不同的opacity如 Starlight 深色模式用0.42压低亮度保证文字可读性也避免了主题切换时的意外回退。六、安装与启用流程中的 artwork 位置结合 docs/UI_PLUGINS.md 的宿主受控 CDP 主题注入流程可以看清源文件在整个生命周期中的位置从「设置 → 形象工坊 → 安装插件文件夹…」选择插件目录应用校验 manifest 与全部引用图片只复制 manifest 和被引用的图片artwork/不进入~/.kun/ui-plugins/id/。启用主题时渲染层只把插件id发给主进程主进程重新读取并规范化 manifest、重新校验引用图片此时img/starlight-stage.webp已就位。样式生成器把白名单 token、固定背景槽位组合成 CSS主进程短暂附加mainWindow.webContents.debugger用固定的Runtime.evaluate只更新宿主管理的style节点后立即分离。Kun 不使用--remote-debugging-port也不接受插件提供的 CSS、JS、选择器或 CDP payload。因此artwork/starlight-stage.svg从始至终只是「留在插件目录里的源文件」验证、复制、解码、注入这条运行时链路里都没有它。七、给插件作者的实战建议基于 Starlight 示例与源码规则规划资源目录时可以遵循以下实践源文件与成品分离把可再编辑的 SVG / PSD / Figma 导出源放在artwork/或自定义的源文件目录把被引用的 PNG / WebP 成品放在img/manifest 只指向成品。artwork/天然不参与安装不会浪费用户的存储与解码资源。遵守背景图体积与像素限制单张背景图片 ≤ 8 MiB去重后全部背景合计 ≤ 32 MiB任一背景宽、高均 ≤ 8192 px单张解码尺寸 ≤ 24 MP去重后合计 ≤ 64 MPdocs/UI_PLUGINS.md。1600 × 900 的 Starlight 舞台背景远低于上限导出 WebP13 KB 左右尤其适合作为全屏背景。路径与引用保持一致manifest 中所有图片路径必须是插件目录内的相对路径禁止绝对路径、..与反斜杠。light/dark都要显式声明需要的背景避免依赖不存在的回退。为可读性留余地如果背景妨碍文字可读性先降低opacity如 Starlight 深色模式用0.42不要把重要文字烘焙进背景图。覆盖更新方式修改插件后重新执行「安装插件文件夹…」即可按同id覆盖更新正在使用时先切回默认形象再切回来即可确保重新载入最新资源。八、小结examples/ui-plugins/starlight/artwork/README.md用三句话讲清了 Kun UI 插件素材管线的关键约定源文件starlight-stage.svg自包含、成品starlight-stage.webp为 1600 × 900、只有 WebP 被 manifest 引用而artwork/在安装时被有意忽略。这背后是 Kun「纯声明式、无代码执行、白名单安装、主进程校验」的安全模型插件只复制被引用的静态图片源文件只属于创作侧。理解了这条管线你就能像官方示例一样把可再编辑的矢量源与运行时成品干净地分离做出规范、可安装、可维护的 UI 插件。如需继续深入可阅读 docs/UI_PLUGINS.mdmanifest 全字段参考、人物舞台presentation、专属场景scene、尺寸体积限制与安全模型、manifest.json完整示例声明、src/shared/ui-plugin-presentation.ts背景路径校验与默认透明度、src/shared/ui-plugin-css.ts背景 CSS 生成与stage槽位选择器以及 src/main/services/ui-plugin-operations.ts安装复制逻辑。赞分享人工智能AI Agent自主智能体桌面应用MCP Clients【免费下载链接】KunLocal-first AI agent workspace for coding, writing, design, research, and automation — one runtime for desktop GUI and TUI.项目地址https://gitcode.com/gh_mirrors/de/Kun点击查看免费下载相关推荐clawdbot多语言支持高级配置精细调整翻译质量clawdbot多语言支持高级配置精细调整翻译质量 clawdbot作为一款跨平台的个人AI助手其多语言支持功能能够帮助用户突破语言障碍实现全球范围内的顺AI 应用AI Agent交互助手后端即时通讯网关OBS背景移除插件安装与使用指南OBS背景移除插件安装与使用指南 插件概述 OBS背景移除插件 obs backgroundremoval 是一款基于人工智能技术的开源插件能够实时移除视频源人工智能计算机视觉视频处理Leiningen构建过程中的资源管理文件复制与过滤Leiningen构建过程中的资源管理文件复制与过滤 资源管理是Clojure项目构建中的关键环节直接影响应用打包质量和运行稳定性。本文将系统讲解Leini构建工具CLI上一篇openEuler安全加固工具DIM配置内存完整性保护完全指南下一篇CronTick配置指南从基础设置到高级优化创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考