z-mcp-codesign 0.1.3 → 0.1.4

package/README.md

@@ -21,50 +21,40 @@
 }
 ```
 
-
-
 # 提供的工具
 
-| 工具名 | 说明 |
-| ------ | ---- |
-| `codesign_open_login` | 有界面打开 CoDesign 登录页，用于在本机 Edge 用户数据目录中完成登录 |
-| `codesign_screen_inspect_save` | 打开指定 CoDesign 页面，截取最大的可见 `.screen-inspect` 区域，保存为本地 PNG 文件并返回保存路径（默认保存到项目根目录 `.codesign_screen_imgs/`） |
-| `codesign_screen_viewer_download_save` | 打开 CoDesign 页面，点击 `.screen-viewer__action` 选择“下载图片”，捕获下载并保存到项目根目录 `.codesign_screen_imgs/` |
-| `codesign_screen_list` | 获取 CoDesign 设计页面左侧菜单中的所有页面名称和访问地址 |
+| 工具名                                 | 说明                                                                                                                                    |
+| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `codesign_open_login`                  | 有界面打开 CoDesign 登录页，用于在本机 Edge 用户数据目录中完成登录                                                                      |
+| `codesign_screen_inspect_save`         | 打开指定 CoDesign 页面，截取最大的可见 `.screen-inspect` 区域，保存为本地 PNG 文件并返回保存路径（默认保存到项目根目录 `_z-mcp-imgs/`） |
+| `codesign_screen_viewer_download_save` | 打开 CoDesign 页面，点击 `.screen-viewer__action` 选择“下载图片”，捕获下载并保存到项目根目录 `_z-mcp-imgs/`                             |
+| `codesign_screen_list`                 | 获取 CoDesign 设计页面左侧菜单中的所有页面名称和访问地址                                                                                |
 
 # 使用示例
 
 **打开登录页（用于后续抓图）**
 
 ```bash
-使用MCP 打开 CoDesign 登录页
+调用MCP 打开CoDesign登录页
 ```
 
 **列出当前项目的页面列表**
 
 ```bash
-使用MCP 获取CoDesign所有页面列表使用表格展示。
-URL为：https://codesign.qq.com/app/design/<projectId>/<pageId>/inspect
-```
-
-**抓图并保存到本地**
-
-```bash
-使用MCP 获取CoDesign页面图片，把截图保存到本地，并告诉我保存路径。
+调用MCP 获取CoDesign所有页面列表使用表格展示。
 URL为：https://codesign.qq.com/app/design/<projectId>/<pageId>/inspect
 ```
 
 **通过页面“下载图片”保存到本地**
 
 ```bash
-使用MCP 打开CoDesign页面，下载图片保存到本地，并告诉我保存路径。
-URL为：https://codesign.qq.com/app/design/<projectId>/<pageId>/inspect
+调用MCP 打开CoDesign页面，下载图片保存到本地，并告诉我保存路径。
+传入参数url为：https://codesign.qq.com/app/design/<projectId>/<pageId>/inspect
 ```
 
 **生成项目**
 
 ```bash
-使用MCP 打开CoDesign页面，下载图片保存到本地，并识别图片内容生成Vue3+Vite项目。
-URL为：https://codesign.qq.com/app/design/<projectId>/<pageId>/inspect
+调用MCP 打开CoDesign页面，下载图片保存到本地，并识别图片内容生成Vue3+Vite项目。
+传入参数url为：https://codesign.qq.com/app/design/<projectId>/<pageId>/inspect
 ```
-

package/dist/index.js

@@ -3222,8 +3222,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path3) {
-      let input = path3;
+    function removeDotSegments(path2) {
+      let input = path2;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3422,8 +3422,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path3, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path3 && path3 !== "/" ? path3 : void 0;
+        const [path2, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path2 && path2 !== "/" ? path2 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -7281,8 +7281,8 @@ function getErrorMap() {
 
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path3, errorMaps, issueData } = params;
-  const fullPath = [...path3, ...issueData.path || []];
+  const { data, path: path2, errorMaps, issueData } = params;
+  const fullPath = [...path2, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -7398,11 +7398,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path3, key) {
+  constructor(parent, value, path2, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path3;
+    this._path = path2;
     this._key = key;
   }
   get path() {
@@ -11039,10 +11039,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path3) {
-  if (!path3)
+function getElementAtPath(obj, path2) {
+  if (!path2)
     return obj;
-  return path3.reduce((acc, key) => acc?.[key], obj);
+  return path2.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -11362,11 +11362,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path3, issues) {
+function prefixIssues(path2, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path3);
+    iss.path.unshift(path2);
     return iss;
   });
 }
@@ -21008,8 +21008,7 @@ import { resolve as resolve4 } from "node:path";
 import { join } from "node:path";
 var ENV_EDGE_USER_DATA = "Z_MCP_CODESIGN_EDGE_USER_DATA";
 var DEFAULT_CODESIGN_LOGIN_URL = "https://codesign.qq.com/app/login";
-var SCREEN_INSPECT_SELECTOR = ".screen-inspect:visible";
-var DEFAULT_MCP_EDGE_PROFILE = join(process.cwd(), ".z-mcp-codesign-edge");
+var DEFAULT_MCP_EDGE_PROFILE = join(process.cwd(), "_z-mcp-edge");
 
 // src/lib/login-window.ts
 import { resolve as resolve2 } from "node:path";
@@ -21205,7 +21204,6 @@ var toolError = (text) => ({
 // src/tools/open-login.ts
 var codesignLoginInput = external_exports.object({
   loginUrl: external_exports.string().url().optional().describe(`\u53EF\u9009\uFF1B\u9ED8\u8BA4 ${DEFAULT_CODESIGN_LOGIN_URL}`),
-  userDataDir: external_exports.string().optional().describe("\u6D4F\u89C8\u5668\u7528\u6237\u6570\u636E\u6839\u76EE\u5F55\uFF1B\u672A\u4F20\u65F6\u540C\u6293\u56FE\u5DE5\u5177\uFF08\u73AF\u5883\u53D8\u91CF\u6216\u4E34\u65F6\u76EE\u5F55\uFF09\u3002"),
   profileDirectory: external_exports.string().optional().describe(
     "User Data \u4E0B Edge profile \u76EE\u5F55\u540D\uFF08\u5982 Default\uFF09\uFF1B\u4E0E\u6293\u56FE\u5DE5\u5177\u4F7F\u7528\u540C\u4E00\u76EE\u5F55\u65F6\u987B\u4F20\u76F8\u540C\u503C\u3002"
   )
@@ -21226,7 +21224,7 @@ function registerOpenLoginTool(mcpServer2, deps2) {
           return toolError("loginUrl \u4E0D\u662F\u5408\u6CD5 URL\u3002");
         }
       }
-      const persistentDir = resolveEdgeUserDataDir(input.userDataDir);
+      const persistentDir = resolveEdgeUserDataDir(void 0);
       const ok = await openOrNavigateCodesignLogin(
         deps2,
         loginUrl,
@@ -21243,7 +21241,7 @@ function registerOpenLoginTool(mcpServer2, deps2) {
           {
             loginUrl,
             userDataDir: resolve4(persistentDir),
-            hint: "\u5728\u5F39\u51FA\u7684\u6D4F\u89C8\u5668\u4E2D\u5B8C\u6210\u767B\u5F55\u540E\u5173\u95ED\u7A97\u53E3\uFF0C\u518D\u8C03\u7528\u6293\u56FE\u5DE5\u5177\uFF08\u5982 codesign_screen_inspect_save\uFF09\u3002"
+            hint: "\u5728\u5F39\u51FA\u7684\u6D4F\u89C8\u5668\u4E2D\u5B8C\u6210\u767B\u5F55\u540E\u5173\u95ED\u7A97\u53E3\uFF0C\u518D\u8C03\u7528\u6293\u56FE/\u5217\u8868/\u4E0B\u8F7D\u7B49\u5DE5\u5177\u3002"
           },
           null,
           2
@@ -21253,10 +21251,6 @@ function registerOpenLoginTool(mcpServer2, deps2) {
   );
 }
 
-// src/tools/screen-inspect-save.ts
-import { mkdir as mkdir2, writeFile } from "node:fs/promises";
-import path from "node:path";
-
 // src/lib/codesign-page.ts
 import { chromium as chromium2 } from "playwright";
 var DEFAULT_CODESIGN_PAGE_DEFAULTS = {
@@ -21271,9 +21265,9 @@ async function withCodesignPage(deps2, input, fn, opts = {}) {
     ...opts.defaults ?? {}
   };
   const url = input.url;
-  const headless = input.headless ?? merged.headless;
+  const headless = opts.allowHeaded ? merged.headless : true;
   const timeoutMs = input.timeoutMs ?? merged.timeoutMs;
-  const persistentDir = resolveEdgeUserDataDir(input.userDataDir);
+  const persistentDir = resolveEdgeUserDataDir(void 0);
   const context = await chromium2.launchPersistentContext(
     persistentDir,
     persistentBrowserContextOptions({
@@ -21312,109 +21306,12 @@ async function withCodesignPage(deps2, input, fn, opts = {}) {
   }
 }
 
-// src/lib/screen-inspect-png.ts
-async function screenshotLargestScreenInspectPng(page) {
-  const handles = await page.$$(SCREEN_INSPECT_SELECTOR);
-  let best = null;
-  for (const h of handles) {
-    const box = await h.boundingBox();
-    if (!box || box.width < 1 || box.height < 1) continue;
-    const area = box.width * box.height;
-    const bestArea = best ? best.box.width * best.box.height : 0;
-    if (!best || area > bestArea) best = { handle: h, box };
-  }
-  if (!best) return null;
-  const buffer = Buffer.from(await best.handle.screenshot({ type: "png" }));
-  return { buffer, boundingBox: best.box };
-}
-
-// src/tools/screen-inspect-save.ts
-function safeSegment(s) {
-  return s.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
-}
-function timestampCompact(d) {
-  const pad = (n) => String(n).padStart(2, "0");
-  return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}_${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`;
-}
-function deriveCodesignIds(url) {
-  try {
-    const u = new URL(url);
-    const parts = u.pathname.split("/").filter(Boolean);
-    const projectId = parts.find((p) => /^\d{10,}$/.test(p));
-    const pageId = parts.find((p) => /^\d+$/.test(p));
-    return { projectId, pageId };
-  } catch {
-    return {};
-  }
-}
-var screenInspectSaveInput = external_exports.object({
-  url: external_exports.string().url().describe("CoDesign \u9875\u9762\u5730\u5740"),
-  headless: external_exports.boolean().optional().describe("\u65E0\u5934\u6A21\u5F0F\uFF0C\u9ED8\u8BA4 true"),
-  timeoutMs: external_exports.number().int().positive().optional().describe("\u6574\u4F53\u8D85\u65F6\u6BEB\u79D2\u6570\uFF0C\u9ED8\u8BA4 60000"),
-  userDataDir: external_exports.string().optional().describe(
-    "\u6D4F\u89C8\u5668\u7528\u6237\u6570\u636E\u6839\u76EE\u5F55\uFF08\u987B\u5148\u9000\u51FA\u5360\u7528\u8BE5\u76EE\u5F55\u7684\u6D4F\u89C8\u5668\uFF09\u3002\u672A\u4F20\u65F6\u4F7F\u7528\u73AF\u5883\u53D8\u91CF Z_MCP_CODESIGN_EDGE_USER_DATA \u6216\u7CFB\u7EDF\u4E34\u65F6\u76EE\u5F55\u4E0B\u9ED8\u8BA4\u914D\u7F6E\u3002"
-  ),
-  profileDirectory: external_exports.string().optional().describe("User Data \u4E0B\u914D\u7F6E\u540D\uFF0C\u5982 Default\u3002")
-});
-async function runScreenInspectSave(deps2, input) {
-  return withCodesignPage(
-    deps2,
-    input,
-    async (page) => {
-      const shot = await screenshotLargestScreenInspectPng(page);
-      if (!shot) {
-        return toolError("\u672A\u627E\u5230\u53EF\u89C1\u7684 .screen-inspect \u533A\u57DF\u3002");
-      }
-      const outDir = path.resolve(process.cwd(), ".codesign_screen_imgs");
-      const { projectId, pageId } = deriveCodesignIds(input.url);
-      const filenameParts = [
-        "codesign",
-        projectId ? `p${safeSegment(projectId)}` : void 0,
-        pageId ? `s${safeSegment(pageId)}` : void 0,
-        timestampCompact(/* @__PURE__ */ new Date())
-      ].filter(Boolean);
-      const finalPath = path.join(outDir, `${filenameParts.join("_")}.png`);
-      await mkdir2(path.dirname(finalPath), { recursive: true });
-      await writeFile(finalPath, shot.buffer);
-      return toolResult(
-        JSON.stringify(
-          {
-            url: input.url,
-            title: await page.title(),
-            mimeType: "image/png",
-            savedPath: finalPath,
-            boundingBox: shot.boundingBox
-          },
-          null,
-          2
-        )
-      );
-    },
-    {
-      waitForSelector: { selector: ".screen-inspect", state: "visible" },
-      defaults: { afterLoadWaitMs: 250 }
-    }
-  );
-}
-function registerScreenInspectSaveTool(mcpServer2, deps2) {
-  mcpServer2.registerTool(
-    "codesign_screen_inspect_save",
-    {
-      description: "\u6253\u5F00 CoDesign \u9875\u9762\uFF0C\u4EC5\u622A\u53D6\u9762\u79EF\u6700\u5927\u7684\u53EF\u89C1 .screen-inspect \u533A\u57DF\uFF0C\u4FDD\u5B58\u4E3A\u672C\u5730 PNG \u6587\u4EF6\u5E76\u8FD4\u56DE\u8DEF\u5F84\uFF08\u9ED8\u8BA4\u4FDD\u5B58\u5230\u9879\u76EE\u6839\u76EE\u5F55 .codesign_screen_imgs\uFF09\u3002",
-      inputSchema: screenInspectSaveInput
-    },
-    (input) => runScreenInspectSave(deps2, input)
-  );
-}
-
 // src/tools/screen-list.ts
 var screenListInput = external_exports.object({
   url: external_exports.string().url().describe(
     "CoDesign \u8BBE\u8BA1\u9875\u9762\u5730\u5740\uFF0C\u5982 https://codesign.qq.com/app/design/<projectId>/<pageId>/inspect"
   ),
-  headless: external_exports.boolean().optional().describe("\u65E0\u5934\u6A21\u5F0F\uFF0C\u9ED8\u8BA4 true"),
   timeoutMs: external_exports.number().int().positive().optional().describe("\u6574\u4F53\u8D85\u65F6\u6BEB\u79D2\u6570\uFF0C\u9ED8\u8BA4 60000"),
-  userDataDir: external_exports.string().optional().describe("\u6D4F\u89C8\u5668\u7528\u6237\u6570\u636E\u6839\u76EE\u5F55\uFF1B\u672A\u4F20\u65F6\u540C\u6293\u56FE\u5DE5\u5177\uFF08\u73AF\u5883\u53D8\u91CF\u6216\u4E34\u65F6\u76EE\u5F55\uFF09\u3002"),
   profileDirectory: external_exports.string().optional().describe("User Data \u4E0B\u914D\u7F6E\u540D\uFF0C\u5982 Default\u3002")
 });
 async function runScreenList(deps2, input) {
@@ -21489,16 +21386,16 @@ function registerScreenListTool(mcpServer2, deps2) {
 }
 
 // src/tools/screen-viewer-download-save.ts
-import { mkdir as mkdir3 } from "node:fs/promises";
-import path2 from "node:path";
-function safeSegment2(s) {
+import { mkdir as mkdir2 } from "node:fs/promises";
+import path from "node:path";
+function safeSegment(s) {
   return s.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
 }
-function timestampCompact2(d) {
+function timestampCompact(d) {
   const pad = (n) => String(n).padStart(2, "0");
   return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}_${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`;
 }
-function deriveCodesignIds2(url) {
+function deriveCodesignIds(url) {
   try {
     const u = new URL(url);
     const parts = u.pathname.split("/").filter(Boolean);
@@ -21511,11 +21408,7 @@ function deriveCodesignIds2(url) {
 }
 var screenViewerDownloadSaveInput = external_exports.object({
   url: external_exports.string().url().describe("CoDesign \u9875\u9762\u5730\u5740"),
-  headless: external_exports.boolean().optional().describe("\u65E0\u5934\u6A21\u5F0F\uFF0C\u9ED8\u8BA4 true"),
   timeoutMs: external_exports.number().int().positive().optional().describe("\u6574\u4F53\u8D85\u65F6\u6BEB\u79D2\u6570\uFF0C\u9ED8\u8BA4 60000"),
-  userDataDir: external_exports.string().optional().describe(
-    "\u6D4F\u89C8\u5668\u7528\u6237\u6570\u636E\u6839\u76EE\u5F55\uFF08\u987B\u5148\u9000\u51FA\u5360\u7528\u8BE5\u76EE\u5F55\u7684\u6D4F\u89C8\u5668\uFF09\u3002\u672A\u4F20\u65F6\u4F7F\u7528\u73AF\u5883\u53D8\u91CF Z_MCP_CODESIGN_EDGE_USER_DATA \u6216\u7CFB\u7EDF\u4E34\u65F6\u76EE\u5F55\u4E0B\u9ED8\u8BA4\u914D\u7F6E\u3002"
-  ),
   profileDirectory: external_exports.string().optional().describe("User Data \u4E0B\u914D\u7F6E\u540D\uFF0C\u5982 Default\u3002")
 });
 async function clickFirstVisibleText(page, candidates) {
@@ -21565,18 +21458,18 @@ async function runScreenViewerDownloadSave(deps2, input) {
         return toolError("\u672A\u6355\u83B7\u5230\u4E0B\u8F7D\u4E8B\u4EF6\uFF08\u70B9\u51FB\u540E\u672A\u89E6\u53D1\u4E0B\u8F7D\uFF09\u3002");
       }
       const suggested = download.suggestedFilename() || "codesign_download.png";
-      const ext = path2.extname(suggested) || ".png";
-      const outDir = path2.resolve(process.cwd(), ".codesign_screen_imgs");
-      const { projectId, pageId } = deriveCodesignIds2(input.url);
+      const ext = path.extname(suggested) || ".png";
+      const outDir = path.resolve(process.cwd(), "_z-mcp-imgs");
+      const { projectId, pageId } = deriveCodesignIds(input.url);
       const filenameParts = [
         "codesign",
         "viewer_download",
-        projectId ? `p${safeSegment2(projectId)}` : void 0,
-        pageId ? `s${safeSegment2(pageId)}` : void 0,
-        timestampCompact2(/* @__PURE__ */ new Date())
+        projectId ? `p${safeSegment(projectId)}` : void 0,
+        pageId ? `s${safeSegment(pageId)}` : void 0,
+        timestampCompact(/* @__PURE__ */ new Date())
       ].filter(Boolean);
-      const finalPath = path2.join(outDir, `${filenameParts.join("_")}${ext}`);
-      await mkdir3(path2.dirname(finalPath), { recursive: true });
+      const finalPath = path.join(outDir, `${filenameParts.join("_")}${ext}`);
+      await mkdir2(path.dirname(finalPath), { recursive: true });
       await download.saveAs(finalPath);
       return toolResult(
         JSON.stringify(
@@ -21601,7 +21494,7 @@ function registerScreenViewerDownloadSaveTool(mcpServer2, deps2) {
   mcpServer2.registerTool(
     "codesign_screen_viewer_download_save",
     {
-      description: "\u6253\u5F00 CoDesign \u9875\u9762\uFF0C\u70B9\u51FB .screen-viewer__action \u540E\u9009\u62E9\u201C\u4E0B\u8F7D\u56FE\u7247\u201D\uFF0C\u6355\u83B7\u6D4F\u89C8\u5668\u4E0B\u8F7D\u5E76\u4FDD\u5B58\u5230\u9879\u76EE\u6839\u76EE\u5F55 .codesign_screen_imgs/\u3002",
+      description: "\u6253\u5F00 CoDesign \u9875\u9762\uFF0C\u70B9\u51FB\u201C\u4E0B\u8F7D\u56FE\u7247\u201D\uFF0C\u6355\u83B7\u6D4F\u89C8\u5668\u4E0B\u8F7D\u5E76\u4FDD\u5B58\u5230\u9879\u76EE\u6839\u76EE\u5F55 _z-mcp-imgs/\u3002\u4E0B\u8F7DCoDesign\u9875\u9762\u56FE\u7247\u5230\u672C\u5730",
       inputSchema: screenViewerDownloadSaveInput
     },
     (input) => runScreenViewerDownloadSave(deps2, input)
@@ -21610,7 +21503,6 @@ function registerScreenViewerDownloadSaveTool(mcpServer2, deps2) {
 
 // src/tools/register-all.ts
 function registerAllCodesignTools(mcpServer2, deps2) {
-  registerScreenInspectSaveTool(mcpServer2, deps2);
   registerScreenViewerDownloadSaveTool(mcpServer2, deps2);
   registerScreenListTool(mcpServer2, deps2);
   registerOpenLoginTool(mcpServer2, deps2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "z-mcp-codesign",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "description": "An MCP server to capture images from Tencent CoDesign pages via Edge",
   "main": "dist/index.js",