@paircode/tool-art 0.3.0 → 0.3.1

package/client.js

@@ -1,4 +1,4 @@
-// tool-art — client 半：注册「画板」插件面板并注入 bundle
+// tool-art — client 半：注册「画板」主内容区视图并注入 bundle
 //
 // ★ 2026-09-17 合并：本插件原本拆成 tool-art（工具面）+ ui-art（UI 面）两个独立
 //   发布包，同属一个创作域却分两处维护（版本/文档/发布各一份，且用户看不出「AI 用的
@@ -10,8 +10,12 @@
 // 区域发现对「同包同时含 dsh.ui + dsh.ui.build」的包生效，与工具面共存无冲突）。
 // external 共享核心（Vue/api 等）从 window.__PAIRCODE_CORE 取。
 //
-// 与其余五域（design/model/music/rig/voice）同包面板同样走通用 ui.registerPanel
-// （不动壳、纯加法，卸载插件即消失）。
+// ★ 2026-09-18：不再注册进「插件面板」（ui.registerPanel）—— 那是壳级逃生口的
+//   管理/总览区（docs/plugin-development.md §12 分工表），六域是「编辑器式工作台」，
+//   主内容区视图（ui.registerView）才是它的位置。此前两处同时注册：插件面板里多一个
+//   重复入口，且两处各 mount 一份 Vue 实例（状态不同步）。现只保留 view。
+//
+// 与其余五域同构：只注册主内容区视图（不动壳、纯加法，卸载插件即消失）。
 (ui) => {
   const GLOBAL = 'ArtPanel'
   const JS = 'plugins-assets/tool-art/assets/art-panel.js'
@@ -26,20 +30,13 @@
     document.head.appendChild(link)
   }
 
-  // 注册面板（bundle 就绪时立即注册；否则先注入 script，onload 后注册）
+  // 注册视图（bundle 就绪时立即注册；否则先注入 script，onload 后注册）
   const register = () => {
     const bundle = window[GLOBAL]
     if (!bundle || typeof bundle.mount !== 'function') return false
-    ui.registerPanel({
-      id: 'art-panel',
-      title: '画板',
-      icon: 'grid',
-      render: (el) => bundle.mount(el),
-    })
-    // ★ 中间区域视图（2026-09 ui.registerView）：与「对话 / 编辑器 / 市场 / 工具集」
+    // ★ 主内容区视图（2026-09 ui.registerView）：与「对话 / 编辑器 / 市场 / 工具集」
     //   同级的主内容区 tab。open:true → 默认以「后台 tab」形式出现，不抢占对话主视图
     //   （mainTab 仍是 conversation），点 tab 才激活；可与对话并排（「并排对话」按钮）。
-    //   与上面的插件面板共用同一 bundle（render 每次调用各建独立 Vue 实例）。
     ui.registerView({
       id: 'art-view',
       title: '画板',

package/index.js

@@ -2009,7 +2009,7 @@ var TOOL_DEFS = [
     parameters: {
       type: 'object',
       properties: {
-        path: { type: 'string', description: '工程文件路径（默认 art.project.json；相对主项目根解析）' },
+        path: { type: 'string', description: '工程文件路径（默认 <主项目根>/art.project.json；相对主项目根解析，跨项目传绝对路径）' },
         mode: { type: 'string', description: 'create（新建）| show（默认，查看摘要）| update（改画布属性）' },
         title: { type: 'string', description: '可选：画板标题' },
         width: { type: 'integer', description: '可选：画布宽（像素，1..8192，默认 800）' },
@@ -2029,7 +2029,7 @@ var TOOL_DEFS = [
     parameters: {
       type: 'object',
       properties: {
-        path: { type: 'string', description: '可选：工程路径（默认 art.project.json）' },
+        path: { type: 'string', description: '可选：工程路径（默认 <主项目根>/art.project.json；相对主项目根解析）' },
         ops: { type: 'array', description: '编辑命令数组（按顺序应用）' },
         op: { type: 'string', description: '可选：单条 op 名（与同层参数合成为一条命令）' },
         ids: { type: 'array', description: '可选：目标图元 id 数组' },
@@ -2048,8 +2048,8 @@ var TOOL_DEFS = [
     parameters: {
       type: 'object',
       properties: {
-        path: { type: 'string', description: '要导入的 SVG 文件路径（相对主项目根解析）' },
-        out: { type: 'string', description: '可选：输出的工程路径（默认 art.project.json）' },
+        path: { type: 'string', description: '要导入的 SVG 文件路径（相对主项目根解析，跨项目传绝对路径）' },
+        out: { type: 'string', description: '可选：输出的工程路径（默认 <主项目根>/art.project.json；相对主项目根解析）' },
         title: { type: 'string', description: '可选：画板标题（默认取 SVG 的 <title>）' },
         overwrite: { type: 'boolean', description: '可选：目标工程已存在时是否覆盖（默认 false）' },
       },
@@ -2064,9 +2064,9 @@ var TOOL_DEFS = [
     parameters: {
       type: 'object',
       properties: {
-        path: { type: 'string', description: '可选：工程路径（默认 art.project.json）' },
+        path: { type: 'string', description: '可选：工程路径（默认 <主项目根>/art.project.json；相对主项目根解析）' },
         format: { type: 'string', description: '产物格式：svg（默认，矢量文本产物）；png 会返回替代路径说明（沙箱无渲染器）' },
-        out: { type: 'string', description: '可选：输出路径（默认 art.svg）' },
+        out: { type: 'string', description: '可选：输出路径（默认 <主项目根>/art.svg；相对主项目根解析）' },
       },
     },
   },
@@ -2078,8 +2078,8 @@ var TOOL_DEFS = [
     parameters: {
       type: 'object',
       properties: {
-        path: { type: 'string', description: '可选：工程路径（默认 art.project.json）' },
-        report: { type: 'string', description: '可选：旁挂校验报告路径（默认 art.verify.json）' },
+        path: { type: 'string', description: '可选：工程路径（默认 <主项目根>/art.project.json；相对主项目根解析）' },
+        report: { type: 'string', description: '可选：旁挂校验报告路径（默认 <主项目根>/art.verify.json）' },
         minContrast: { type: 'number', description: '可选：文本对比度统一阈值（默认按 WCAG：4.5，大字 3.0）' },
       },
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paircode/tool-art",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "scope": "global",
   "type": "plugin",
   "main": "index.js",