wechen-agent-editor-v1 1.0.1 → 1.0.4

package/README.md

@@ -1,40 +1,45 @@
-# @li/wechen-agent
+# wechen-agent-editor-v1
 
-**@li/wechen-agent** 是一个可发布的 **Agent 流程编排编辑器** React 组件库：**画布上的图语义为可执行的 AI 流程**——**节点** 表示 **功能模块**，**连线** 表示 **执行顺序 / 控制流**（不是仅画关系图）；持久化的 `flow` 供宿主 **运行时或执行引擎** 消费。技术形态为左侧组件库（**可拖入画布**）、中间 **@xyflow/react** 画布、右侧 **节点 / 连线** 配置（antd + **Monaco Editor** 编辑 System Prompt 等）。适用于在宿主应用中嵌入「可执行 Agent / MCP 编排」类界面。
+**wechen-agent-editor-v1** 是一个可发布的 **Agent 流程编排编辑器** React 组件库：**画布上的图语义为可执行的 AI 流程**——**节点** 表示 **功能模块**，**连线** 表示 **执行顺序 / 控制流**（不是仅画关系图）；持久化的 `flow` 供宿主 **运行时或执行引擎** 消费。技术形态为左侧组件库（**可拖入画布**）、中间 **@xyflow/react** 画布、右侧 **节点 / 连线** 配置（antd + **Monaco Editor** 编辑 System Prompt 等）。适用于在宿主应用中嵌入「可执行 Agent / MCP 编排」类界面。
+
+> **npm 包名**：安装与 `import` 路径均以仓库根目录 **`package.json` 的 `name`** 为准（当前为 **`wechen-agent-editor-v1`**）。历史文档或内部示例若出现 **`@li/wechen-agent`**，请视为**曾用别名**，以 `package.json` 为准。
 
 > **BREAKING（包名）**：若你曾使用旧包名 `my-react-antd-widget`，请改为安装本包并更新 import。  
-> **BREAKING（peer）**：自 Monaco 集成起，宿主必须安装 **`monaco-editor`** 与 **`@monaco-editor/react`**，并配置 **Monaco worker**（见下文）。  
+> **BREAKING（peer 依赖）**：自 **1.0.3** 起，`react`、`react-dom`、`antd`、`@xyflow/react`、`monaco-editor`、`@monaco-editor/react` 改为 **`peerDependencies`**，避免与宿主 **重复安装多份 React / xyflow** 导致连线、拖拽、样式异常。请见下文「依赖（安装）」与「排查」。  
+> **BREAKING（Monaco）**：需在宿主入口配置 **Monaco worker**（见下文）。  
 > **BREAKING（initialFlow）**：未传 `initialFlow` 时为 **空画布**（无内置示例节点）。若依赖旧版「零配置即出现示例图」，请显式传入 `initialFlow={cloneWechenAgentFlow(defaultInitialFlow)}`（需同时 import `cloneWechenAgentFlow` 与 `defaultInitialFlow`）。
 
 
-## 依赖（peer）
+## 依赖（安装）
 
-宿主应用 **必须** 自行安装：
+本包将 **`react`、`react-dom`、`antd`、`@xyflow/react`、`monaco-editor`、`@monaco-editor/react`** 声明为 **`peerDependencies`**（与常见 React 组件库一致），**请保证宿主只解析到一份** 上述依赖，否则易出现 **Hooks 异常、React Flow 连线/拖拽失灵、样式错乱**。
 
 ```bash
-npm install @li/wechen-agent react react-dom antd @xyflow/react monaco-editor @monaco-editor/react
+npm install wechen-agent-editor-v1
 ```
 
-若你发布为 **非 scoped** 包，将命令中的 `@li/wechen-agent` 换成 `package.json` 里的实际 `name`。
+- **npm 7+** 安装本包时，一般会 **自动安装缺失的 peer**；仍建议在宿主 `package.json` 中 **显式列出** 上述依赖及版本，便于与业务线对齐并避免重复副本。
+- 版本范围以 **`peerDependencies`** 为准；建议 **React 18+**、**antd 5+**、**@xyflow/react 12+**。
+
+### 排查：第一次从组件库拖入正常，之后无法连线 / 无法再拖 / 样式怪
 
-- `react` / `react-dom`：建议 18+
-- `antd`：建议 5+
-- `@xyflow/react`：建议 12+（React Flow，拖拽编排核心）
-- `monaco-editor` + `@monaco-editor/react`：与根目录 `peerDependencies` 大版本对齐（用于 System Prompt 等代码编辑）
+1. **多份 React / 多份 @xyflow**（最常见）：在宿主项目根目录执行 **`npm ls react`**、**`npm ls @xyflow/react`**，若出现 **多个版本** 或嵌套在 **`wechen-agent-editor-v1/node_modules` 下又一份**，请删除锁文件后重装，或在 **Vite** 中配置 **`resolve.dedupe: ['react', 'react-dom', '@xyflow/react']`**，或调整 **pnpm overrides / npm overrides** 强制单版本。
+2. **样式未进生产包**：若打包后 **完全无 Flow 样式**，可兜底增加一行：  
+   `import "wechen-agent-editor-v1/style.css"`（本包 **`exports`** 已导出 **`./style.css` → `dist/style.css`**）。
+3. **Monaco**：未配 worker 时编辑区异常，一般 **不影响** 画布连线；请先排除 1、2。
 
 ### 从包导入（ESM）
 
-本包以 **ESM** 发布（`package.json` 的 `exports["."].import`）。典型写法：
+本包以 **ESM** 发布（`package.json` 的 `exports["."].import`）。构建会把 **React Flow 全局样式**打进 **`dist/style.css`**，并由 **`dist/index.js`** 自动 `import`；宿主 **只 import 本包即可**，无需再写 `@xyflow/react/dist/style.css`。典型写法：
 
 ```ts
-import "@xyflow/react/dist/style.css";
 import {
   WechenAgentEditor,
   cloneWechenAgentFlow,
   defaultInitialFlow,
   type WechenAgentEditorRef,
   type WechenAgentSnapshot,
-} from "@li/wechen-agent";
+} from "wechen-agent-editor-v1";
 ```
 
 **主要导出一览**（完整列表以 `src/index.ts` 为准）：
@@ -51,9 +56,8 @@ import {
 
 ### 样式
 
-```ts
-import "@xyflow/react/dist/style.css";
-```
+- **React Flow**：样式在 **`dist/style.css`**，随 **`import "…/wechen-agent-editor-v1"`**（或包名根路径）一并生效。若生产环境仍无样式，请确认宿主打包器 **会处理依赖包里的 `import "./style.css"`**；仍不行时使用兜底：**`import "wechen-agent-editor-v1/style.css"`**。
+- **Ant Design**：antd 5 为 **CSS-in-JS**，随组件在运行时注入；请使用 **`ConfigProvider`** 包裹（与官方用法一致），并避免 **重复多份 `antd`** 导致样式异常。
 
 Monaco 由 `@monaco-editor/react` 加载；**worker 需在宿主侧配置**，否则编辑器无法初始化。可选方式：
 
@@ -63,12 +67,11 @@ Monaco 由 `@monaco-editor/react` 加载；**worker 需在宿主侧配置**，
 ## 使用示例
 
 ```tsx
-import "@xyflow/react/dist/style.css";
 import { ConfigProvider } from "antd";
 import {
   WechenAgentEditor,
   type WechenAgentSnapshot,
-} from "@li/wechen-agent";
+} from "wechen-agent-editor-v1";
 
 export function AgentPage() {
   return (
@@ -116,7 +119,7 @@ export function AgentPage() {
 
 ```tsx
 import { Button, Space } from "antd";
-import type { WechenAgentHeaderActionsRenderContext } from "@li/wechen-agent";
+import type { WechenAgentHeaderActionsRenderContext } from "wechen-agent-editor-v1";
 
 <WechenAgentEditor
   renderHeaderActions={(ctx: WechenAgentHeaderActionsRenderContext) => (
@@ -144,53 +147,90 @@ npm run dev
 
 ## 构建与发布到 npm
 
-维护者或 CI 在发版前建议完成下列 **自检**：
+以下面向 **维护者** 与 **CI**。**npm 包名、版本号** 以仓库根目录 **`package.json` 的 `name` / `version`** 为唯一权威（当前包名为 **`wechen-agent-editor-v1`**），请勿依赖本文档中可能出现的示例数字。
 
-1. **依赖**：宿主侧 peer 与业务线 lockfile 可解析（见上文版本范围）。
+### 发布前自检
+
+1. **依赖**：在仓库根目录执行 `npm install`（或 CI 使用 `npm ci`），确认 `dependencies` 可解析；宿主若额外安装 React 等，注意与上文版本范围兼容（见「依赖（安装）」）。
 2. **构建**：`npm run build` 成功，生成 `dist/index.js` 与 `dist/index.d.ts`。
-3. **打包内容**：`npm run pack:check`（即 `npm pack --dry-run`）仅包含 `package.json` 声明的 `files`（当前为 **`dist`**），无意外把 `playground` 或源码打进包。
-4. **测试**（可选）：`npm test`（Vitest，见 `src/**/*.test.ts`）。
-5. **版本号**：在 `package.json` 提升 `version`；若团队维护变更说明，可同步更新 **CHANGELOG**（本仓库未强制附带该文件，由发布流程决定）。
+3. **打包内容**：`npm run pack:check`（即 `npm pack --dry-run`）确认仅包含 `package.json` **`files`** 声明的内容（当前为 **`dist`** 与 **`LICENSE`**），无意外把 `playground` 或源码打进包。
+4. **测试**（建议）：`npm test`（Vitest，见 `src/**/*.test.ts`）。
+5. **版本号**：在 `package.json` 提升 **`version`**（语义化：**`MAJOR`** 不兼容 API、**`MINOR`** 向后兼容功能、**`PATCH`** 修订）。若需预览版可使用 **0.x** 或预发布标签（如 `-beta`），并在变更说明中写明。若团队维护变更说明，可同步更新 **CHANGELOG**（本仓库未强制附带该文件）。
+
+**根目录一键执行（建议顺序）**：
 
 ```bash
+npm install
 npm run build
-npm run pack:check
 npm test
+npm run pack:check
+```
+
+### 宿主入口与构建产物
+
+**集成方**仅通过 **`package.json` `name`** 对应的 **根路径** 导入，例如：
+
+```ts
+import { WechenAgentEditor } from "wechen-agent-editor-v1";
+```
+
+**构建产物**为 **`dist/index.js`**、**`dist/style.css`**（React Flow 全局样式，由入口 JS 自动引用）与类型 **`dist/index.d.ts`**，由 **`src/index.ts`** 聚合导出；请勿依赖未文档化的深层路径。**公开 API** 概览见上文「主要导出一览」，完整符号以 `src/index.ts` 分组为准。
+
+### 发布流程与生命周期
+
+执行 **`npm publish`** 或 **`npm run release`** 时，npm 会先运行 **`prepublishOnly`**（已设为 `npm run build`），再上传。项目脚本 **`release` / `release:cn` 已对 `npm publish` 固定加上 `--registry https://registry.npmjs.org/`**，避免本机默认 registry 仍是 **npmmirror** 时发布误连镜像站并报 **ENEEDAUTH**。
+
+- **请勿**在 `package.json` 中新增名为 **`publish`** 的脚本并在其中调用 `npm publish`：发版完成后 npm 会再次执行同名生命周期脚本，可能导致**同一版本被发布两次**并报 **E403**。
+- **`README`** 等会按 npm 默认规则一并打入包； tarball 不含 `monaco-editor` 源码树与 `playground`。
+
+**前置条件**：已安装 **Node.js（建议 LTS）** 与 **npm**；在 [npmjs.com](https://www.npmjs.com/) 拥有账号。
+
+**登录**（本包当前为 **unscoped** 名，一般使用全局登录即可）：
+
+```bash
+npm login
+npm whoami
 ```
 
-执行 `npm publish`（或 `npm run publish`）时，npm 会先运行 **`prepublishOnly`**（已设为 `npm run build`），再上传。**`files`** 显式包含 **`dist/`** 与 **`LICENSE`**；`README` 等会按 npm 默认规则一并打入包。不含 `monaco-editor` 源码树与 `playground`。
+若将来包名改为 **`@scope/pkg`**（scoped），需对该 **scope** 拥有发布权限，必要时使用 `npm login --scope=@scope`，且 **scoped 包首次**发布到公共注册表通常需要 `npm publish --access public`。
+
+**发布**（请先在 **npm 官方** 完成登录：`npm login --registry https://registry.npmjs.org/`）：
 
-### 首次发布到 npm（操作清单）
+```bash
+npm publish --access public --registry https://registry.npmjs.org/
+# 或（项目脚本，已含上述 registry）
+npm run release
+```
 
-**版本号含义**：`package.json` 中 **`version`** 当前为 **1.0.0**，表示以 **语义化版本** 首次公开发布；之后 **`MAJOR`** 不兼容 API 变更、**`MINOR`** 向后兼容功能、**`PATCH`** 修订。若需先发预览版，可改用 **0.x** 并在文档中说明。
+**国内网络（可选）**：日常可使用 **npmmirror** 加速 `npm install`；**发版**请用上面的 **`--registry`** 或脚本（勿依赖「先 npm config set registry」——用户级 `.npmrc` 里若仍指向镜像，`npm publish` 可能仍连镜像并报错）。发版成功后若希望把 **默认 registry** 切回镜像，可执行：
 
-**发布入口（宿主应使用）**：仅通过包名根路径导入，例如 `import { WechenAgentEditor } from "@li/wechen-agent"`。**构建产物**为 **`dist/index.js`**（类型声明 **`dist/index.d.ts`**），由源码 **`src/index.ts`** 聚合导出；请勿依赖未文档化的深层路径。**公开 API** 概览见上文「主要导出一览」，完整符号以 `src/index.ts` 分组为准。
+```bash
+npm run registry:show          # 查看当前默认 registry
+npm run registry:npmjs         # 手动切到 npm 官方（仅改默认 registry，可选）
+npm run registry:npmmirror     # 切回 npmmirror（装依赖常用）
+npm run release:cn             # 发布到官方（脚本内已固定 registry）→ 成功后再切回 npmmirror
+```
 
-**发布前**：将 `package.json` 中 **`repository` / `bugs` / `homepage`** 里的占位地址（`your-org/wechen-agent`）替换为 **真实 Git 仓库** URL，便于 npm 页展示与问题反馈。
+**发后验证**（将包名换成与 `package.json` `name` 一致）：
 
-**前置条件**：已安装 **Node.js（建议 LTS）** 与 **npm**；在 [npmjs.com](https://www.npmjs.com/) 拥有账号。发布 **`@li/...` scoped 包** 前，确认你对 **`@li` 组织** 具有 **publish** 权限（或由组织管理员授权）。
+```bash
+npm view wechen-agent-editor-v1 version
+```
 
-1. **本地校验**  
-   - `npm install`（或 CI 用 `npm ci`）  
-   - `npm run build`  
-   - `npm test`（可选，Vitest）  
-   - `npm run pack:check` 查看将要上传的 tarball 内容  
+在空目录新建最小项目并烟测：
 
-2. **登录 npm**  
-   - `npm login`（若仅用 scope：`npm login --scope=@li`）  
-   - `npm whoami` 确认当前用户  
+```bash
+npm install wechen-agent-editor-v1
+```
 
-3. **发布**（scoped 包首次需公开作用域）  
-   - `npm publish --access public`  
-   - 或：`npm run publish`（脚本已等价包含上述参数）  
+### 元数据占位
 
-4. **发后验证**  
-   - `npm view @li/wechen-agent version`  
-   - 在空目录新建最小项目：`npm install @li/wechen-agent`，再 `import { WechenAgentEditor } from "@li/wechen-agent"` 做一次烟测  
+发版前建议将 `package.json` 中 **`repository` / `bugs` / `homepage`** 里的占位地址（如 `your-org/wechen-agent`）替换为 **真实 Git 仓库** URL，便于 npm 页面展示与问题反馈。**占位未替换时** npm 项目页上的「仓库」链接不可用，建议在 **对外公开发布前** 完成替换。
 
 ## 技术说明
 
-- 构建：Vite `build.lib`，`react`、`react-dom`、`antd`、`@xyflow/react`、`monaco-editor`、`@monaco-editor/react` 均为 **external**。
+- 构建：Vite `build.lib`，`react`、`react-dom`、`antd`、`@xyflow/react`、`monaco-editor`、`@monaco-editor/react` 均为 **external**（**不打进 `dist`**），由宿主 **`peerDependencies`** 在运行时解析；**请勿**让本包与宿主各装一份 React。
+- **`sideEffects`**：`package.json` 声明 **`./dist/index.js`** 与 **`./dist/style.css`**，避免宿主误摇树掉 **入口 JS 对同目录 CSS 的 `import`**，导致 **生产包样式丢失**。
 - 组件库条目拖入画布时，使用 MIME `application/reactflow` 与载荷前缀 `scope:"wechen-agent"`；宿主可 import `WECHEN_AGENT_FLOW_DRAG_MIME` 与编解码函数以对齐自定义侧栏。
 - 顶栏 **保存** / **测试运行** 通过 `onSave`、`onTestRun` 传出 `WechenAgentSnapshot`：`flow` 为与 `initialFlow` 同形的 **完整对象**（推荐）；`flowJson` 为兼容用字符串。
 - 画布 **Controls** 使用 `showInteractive={false}` 时隐藏「锁定交互」开关，**缩放 / 适应视图** 仍可用。

package/dist/index.d.ts

@@ -1,18 +1,3 @@
-/**
- * @packageDocumentation
- * @li/wechen-agent — 可执行 AI 流程编排编辑器（节点=模块，连线=顺序/控制流；非仅关系图）。
- *
- * **宿主必做**
- * - 安装下方 **peer** 依赖，并在入口引入 `@xyflow/react/dist/style.css`。
- * - 配置 **Monaco worker**（见 README），否则代码编辑区无法初始化。
- *
- * **最小示例**
- * ```tsx
- * import "@xyflow/react/dist/style.css";
- * import { WechenAgentEditor } from "@li/wechen-agent";
- * <WechenAgentEditor onSave={(s) => api.save(s.flow)} />
- * ```
- */
 export { WechenAgentEditor } from './WechenAgentEditor';
 export type { WechenAgentEditorProps } from './WechenAgentEditor';
 export { WechenAgentEditorRenderContext, useWechenAgentEditorRender, } from './WechenAgentEditorContext';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAG9E,YAAY,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAC9E,YAAY,EACV,6BAA6B,EAC7B,iCAAiC,EACjC,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,uCAAuC,EACvC,sCAAsC,EACtC,+BAA+B,GAChC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,8BAA8B,EAC9B,mCAAmC,EACnC,gCAAgC,EAChC,gBAAgB,EAChB,mBAAmB,EACnB,iCAAiC,GAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,kCAAkC,CAAC;AAG1C,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,qCAAqC,EACrC,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,YAAY,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,8BAA8B,CAAC;AAGtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAG9E,YAAY,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAC9E,YAAY,EACV,6BAA6B,EAC7B,iCAAiC,EACjC,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,uCAAuC,EACvC,sCAAsC,EACtC,+BAA+B,GAChC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,8BAA8B,EAC9B,mCAAmC,EACnC,gCAAgC,EAChC,gBAAgB,EAChB,mBAAmB,EACnB,iCAAiC,GAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,kCAAkC,CAAC;AAG1C,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,qCAAqC,EACrC,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,YAAY,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/style.css

@@ -0,0 +1 @@
+.react-flow{direction:ltr;--xy-edge-stroke-default: #b1b1b7;--xy-edge-stroke-width-default: 1;--xy-edge-stroke-selected-default: #555;--xy-connectionline-stroke-default: #b1b1b7;--xy-connectionline-stroke-width-default: 1;--xy-attribution-background-color-default: rgba(255, 255, 255, .5);--xy-minimap-background-color-default: #fff;--xy-minimap-mask-background-color-default: rgba(240, 240, 240, .6);--xy-minimap-mask-stroke-color-default: transparent;--xy-minimap-mask-stroke-width-default: 1;--xy-minimap-node-background-color-default: #e2e2e2;--xy-minimap-node-stroke-color-default: transparent;--xy-minimap-node-stroke-width-default: 2;--xy-background-color-default: transparent;--xy-background-pattern-dots-color-default: #91919a;--xy-background-pattern-lines-color-default: #eee;--xy-background-pattern-cross-color-default: #e2e2e2;background-color:var(--xy-background-color, var(--xy-background-color-default));--xy-node-color-default: inherit;--xy-node-border-default: 1px solid #1a192b;--xy-node-background-color-default: #fff;--xy-node-group-background-color-default: rgba(240, 240, 240, .25);--xy-node-boxshadow-hover-default: 0 1px 4px 1px rgba(0, 0, 0, .08);--xy-node-boxshadow-selected-default: 0 0 0 .5px #1a192b;--xy-node-border-radius-default: 3px;--xy-handle-background-color-default: #1a192b;--xy-handle-border-color-default: #fff;--xy-selection-background-color-default: rgba(0, 89, 220, .08);--xy-selection-border-default: 1px dotted rgba(0, 89, 220, .8);--xy-controls-button-background-color-default: #fefefe;--xy-controls-button-background-color-hover-default: #f4f4f4;--xy-controls-button-color-default: inherit;--xy-controls-button-color-hover-default: inherit;--xy-controls-button-border-color-default: #eee;--xy-controls-box-shadow-default: 0 0 2px 1px rgba(0, 0, 0, .08);--xy-edge-label-background-color-default: #ffffff;--xy-edge-label-color-default: inherit;--xy-resize-background-color-default: #3367d9}.react-flow.dark{--xy-edge-stroke-default: #3e3e3e;--xy-edge-stroke-width-default: 1;--xy-edge-stroke-selected-default: #727272;--xy-connectionline-stroke-default: #b1b1b7;--xy-connectionline-stroke-width-default: 1;--xy-attribution-background-color-default: rgba(150, 150, 150, .25);--xy-minimap-background-color-default: #141414;--xy-minimap-mask-background-color-default: rgba(60, 60, 60, .6);--xy-minimap-mask-stroke-color-default: transparent;--xy-minimap-mask-stroke-width-default: 1;--xy-minimap-node-background-color-default: #2b2b2b;--xy-minimap-node-stroke-color-default: transparent;--xy-minimap-node-stroke-width-default: 2;--xy-background-color-default: #141414;--xy-background-pattern-dots-color-default: #777;--xy-background-pattern-lines-color-default: #777;--xy-background-pattern-cross-color-default: #777;--xy-node-color-default: #f8f8f8;--xy-node-border-default: 1px solid #3c3c3c;--xy-node-background-color-default: #1e1e1e;--xy-node-group-background-color-default: rgba(240, 240, 240, .25);--xy-node-boxshadow-hover-default: 0 1px 4px 1px rgba(255, 255, 255, .08);--xy-node-boxshadow-selected-default: 0 0 0 .5px #999;--xy-handle-background-color-default: #bebebe;--xy-handle-border-color-default: #1e1e1e;--xy-selection-background-color-default: rgba(200, 200, 220, .08);--xy-selection-border-default: 1px dotted rgba(200, 200, 220, .8);--xy-controls-button-background-color-default: #2b2b2b;--xy-controls-button-background-color-hover-default: #3e3e3e;--xy-controls-button-color-default: #f8f8f8;--xy-controls-button-color-hover-default: #fff;--xy-controls-button-border-color-default: #5b5b5b;--xy-controls-box-shadow-default: 0 0 2px 1px rgba(0, 0, 0, .08);--xy-edge-label-background-color-default: #141414;--xy-edge-label-color-default: #f8f8f8}.react-flow__background{background-color:var(--xy-background-color-props, var(--xy-background-color, var(--xy-background-color-default)));pointer-events:none;z-index:-1}.react-flow__container{position:absolute;width:100%;height:100%;top:0;left:0}.react-flow__pane{z-index:1}.react-flow__pane.draggable{cursor:grab}.react-flow__pane.dragging{cursor:grabbing}.react-flow__pane.selection{cursor:pointer}.react-flow__viewport{transform-origin:0 0;z-index:2;pointer-events:none}.react-flow__renderer{z-index:4}.react-flow__selection{z-index:6}.react-flow__nodesselection-rect:focus,.react-flow__nodesselection-rect:focus-visible{outline:none}.react-flow__edge-path{stroke:var(--xy-edge-stroke, var(--xy-edge-stroke-default));stroke-width:var(--xy-edge-stroke-width, var(--xy-edge-stroke-width-default));fill:none}.react-flow__connection-path{stroke:var(--xy-connectionline-stroke, var(--xy-connectionline-stroke-default));stroke-width:var(--xy-connectionline-stroke-width, var(--xy-connectionline-stroke-width-default));fill:none}.react-flow .react-flow__edges{position:absolute}.react-flow .react-flow__edges svg{overflow:visible;position:absolute;pointer-events:none}.react-flow__edge{pointer-events:visibleStroke}.react-flow__edge.selectable{cursor:pointer}.react-flow__edge.animated path{stroke-dasharray:5;animation:dashdraw .5s linear infinite}.react-flow__edge.animated path.react-flow__edge-interaction{stroke-dasharray:none;animation:none}.react-flow__edge.inactive{pointer-events:none}.react-flow__edge.selected,.react-flow__edge:focus,.react-flow__edge:focus-visible{outline:none}.react-flow__edge.selected .react-flow__edge-path,.react-flow__edge.selectable:focus .react-flow__edge-path,.react-flow__edge.selectable:focus-visible .react-flow__edge-path{stroke:var(--xy-edge-stroke-selected, var(--xy-edge-stroke-selected-default))}.react-flow__edge-textwrapper{pointer-events:all}.react-flow__edge .react-flow__edge-text{pointer-events:none;-webkit-user-select:none;-moz-user-select:none;user-select:none}.react-flow__arrowhead polyline{stroke:var(--xy-edge-stroke, var(--xy-edge-stroke-default))}.react-flow__arrowhead polyline.arrowclosed{fill:var(--xy-edge-stroke, var(--xy-edge-stroke-default))}.react-flow__connection{pointer-events:none}.react-flow__connection .animated{stroke-dasharray:5;animation:dashdraw .5s linear infinite}svg.react-flow__connectionline{z-index:1001;overflow:visible;position:absolute}.react-flow__nodes{pointer-events:none;transform-origin:0 0}.react-flow__node{position:absolute;-webkit-user-select:none;-moz-user-select:none;user-select:none;pointer-events:all;transform-origin:0 0;box-sizing:border-box;cursor:default}.react-flow__node.selectable{cursor:pointer}.react-flow__node.draggable{cursor:grab;pointer-events:all}.react-flow__node.draggable.dragging{cursor:grabbing}.react-flow__nodesselection{z-index:3;transform-origin:left top;pointer-events:none}.react-flow__nodesselection-rect{position:absolute;pointer-events:all;cursor:grab}.react-flow__handle{position:absolute;pointer-events:none;min-width:5px;min-height:5px;width:6px;height:6px;background-color:var(--xy-handle-background-color, var(--xy-handle-background-color-default));border:1px solid var(--xy-handle-border-color, var(--xy-handle-border-color-default));border-radius:100%}.react-flow__handle.connectingfrom{pointer-events:all}.react-flow__handle.connectionindicator{pointer-events:all;cursor:crosshair}.react-flow__handle-bottom{top:auto;left:50%;bottom:0;transform:translate(-50%,50%)}.react-flow__handle-top{top:0;left:50%;transform:translate(-50%,-50%)}.react-flow__handle-left{top:50%;left:0;transform:translate(-50%,-50%)}.react-flow__handle-right{top:50%;right:0;transform:translate(50%,-50%)}.react-flow__edgeupdater{cursor:move;pointer-events:all}.react-flow__pane.selection .react-flow__panel{pointer-events:none}.react-flow__panel{position:absolute;z-index:5;margin:15px}.react-flow__panel.top{top:0}.react-flow__panel.bottom{bottom:0}.react-flow__panel.top.center,.react-flow__panel.bottom.center{left:50%;transform:translate(-15px) translate(-50%)}.react-flow__panel.left{left:0}.react-flow__panel.right{right:0}.react-flow__panel.left.center,.react-flow__panel.right.center{top:50%;transform:translateY(-15px) translateY(-50%)}.react-flow__attribution{font-size:10px;background:var(--xy-attribution-background-color, var(--xy-attribution-background-color-default));padding:2px 3px;margin:0}.react-flow__attribution a{text-decoration:none;color:#999}@keyframes dashdraw{0%{stroke-dashoffset:10}}.react-flow__edgelabel-renderer{position:absolute;width:100%;height:100%;pointer-events:none;-webkit-user-select:none;-moz-user-select:none;user-select:none;left:0;top:0}.react-flow__viewport-portal{position:absolute;width:100%;height:100%;left:0;top:0;-webkit-user-select:none;-moz-user-select:none;user-select:none}.react-flow__minimap{background:var( --xy-minimap-background-color-props, var(--xy-minimap-background-color, var(--xy-minimap-background-color-default)) )}.react-flow__minimap-svg{display:block}.react-flow__minimap-mask{fill:var( --xy-minimap-mask-background-color-props, var(--xy-minimap-mask-background-color, var(--xy-minimap-mask-background-color-default)) );stroke:var( --xy-minimap-mask-stroke-color-props, var(--xy-minimap-mask-stroke-color, var(--xy-minimap-mask-stroke-color-default)) );stroke-width:var( --xy-minimap-mask-stroke-width-props, var(--xy-minimap-mask-stroke-width, var(--xy-minimap-mask-stroke-width-default)) )}.react-flow__minimap-node{fill:var( --xy-minimap-node-background-color-props, var(--xy-minimap-node-background-color, var(--xy-minimap-node-background-color-default)) );stroke:var( --xy-minimap-node-stroke-color-props, var(--xy-minimap-node-stroke-color, var(--xy-minimap-node-stroke-color-default)) );stroke-width:var( --xy-minimap-node-stroke-width-props, var(--xy-minimap-node-stroke-width, var(--xy-minimap-node-stroke-width-default)) )}.react-flow__background-pattern.dots{fill:var( --xy-background-pattern-color-props, var(--xy-background-pattern-color, var(--xy-background-pattern-dots-color-default)) )}.react-flow__background-pattern.lines{stroke:var( --xy-background-pattern-color-props, var(--xy-background-pattern-color, var(--xy-background-pattern-lines-color-default)) )}.react-flow__background-pattern.cross{stroke:var( --xy-background-pattern-color-props, var(--xy-background-pattern-color, var(--xy-background-pattern-cross-color-default)) )}.react-flow__controls{display:flex;flex-direction:column;box-shadow:var(--xy-controls-box-shadow, var(--xy-controls-box-shadow-default))}.react-flow__controls.horizontal{flex-direction:row}.react-flow__controls-button{display:flex;justify-content:center;align-items:center;height:26px;width:26px;padding:4px;border:none;background:var(--xy-controls-button-background-color, var(--xy-controls-button-background-color-default));border-bottom:1px solid var( --xy-controls-button-border-color-props, var(--xy-controls-button-border-color, var(--xy-controls-button-border-color-default)) );color:var( --xy-controls-button-color-props, var(--xy-controls-button-color, var(--xy-controls-button-color-default)) );cursor:pointer;-webkit-user-select:none;-moz-user-select:none;user-select:none}.react-flow__controls-button svg{width:100%;max-width:12px;max-height:12px;fill:currentColor}.react-flow__edge.updating .react-flow__edge-path{stroke:#777}.react-flow__edge-text{font-size:10px}.react-flow__node.selectable:focus,.react-flow__node.selectable:focus-visible{outline:none}.react-flow__node-input,.react-flow__node-default,.react-flow__node-output,.react-flow__node-group{padding:10px;border-radius:var(--xy-node-border-radius, var(--xy-node-border-radius-default));width:150px;font-size:12px;color:var(--xy-node-color, var(--xy-node-color-default));text-align:center;border:var(--xy-node-border, var(--xy-node-border-default));background-color:var(--xy-node-background-color, var(--xy-node-background-color-default))}.react-flow__node-input.selectable:hover,.react-flow__node-default.selectable:hover,.react-flow__node-output.selectable:hover,.react-flow__node-group.selectable:hover{box-shadow:var(--xy-node-boxshadow-hover, var(--xy-node-boxshadow-hover-default))}.react-flow__node-input.selectable.selected,.react-flow__node-input.selectable:focus,.react-flow__node-input.selectable:focus-visible,.react-flow__node-default.selectable.selected,.react-flow__node-default.selectable:focus,.react-flow__node-default.selectable:focus-visible,.react-flow__node-output.selectable.selected,.react-flow__node-output.selectable:focus,.react-flow__node-output.selectable:focus-visible,.react-flow__node-group.selectable.selected,.react-flow__node-group.selectable:focus,.react-flow__node-group.selectable:focus-visible{box-shadow:var(--xy-node-boxshadow-selected, var(--xy-node-boxshadow-selected-default))}.react-flow__node-group{background-color:var(--xy-node-group-background-color, var(--xy-node-group-background-color-default))}.react-flow__nodesselection-rect,.react-flow__selection{background:var(--xy-selection-background-color, var(--xy-selection-background-color-default));border:var(--xy-selection-border, var(--xy-selection-border-default))}.react-flow__nodesselection-rect:focus,.react-flow__nodesselection-rect:focus-visible,.react-flow__selection:focus,.react-flow__selection:focus-visible{outline:none}.react-flow__controls-button:hover{background:var( --xy-controls-button-background-color-hover-props, var(--xy-controls-button-background-color-hover, var(--xy-controls-button-background-color-hover-default)) );color:var( --xy-controls-button-color-hover-props, var(--xy-controls-button-color-hover, var(--xy-controls-button-color-hover-default)) )}.react-flow__controls-button:disabled{pointer-events:none}.react-flow__controls-button:disabled svg{fill-opacity:.4}.react-flow__controls-button:last-child{border-bottom:none}.react-flow__controls.horizontal .react-flow__controls-button{border-bottom:none;border-right:1px solid var( --xy-controls-button-border-color-props, var(--xy-controls-button-border-color, var(--xy-controls-button-border-color-default)) )}.react-flow__controls.horizontal .react-flow__controls-button:last-child{border-right:none}.react-flow__resize-control{position:absolute}.react-flow__resize-control.left,.react-flow__resize-control.right{cursor:ew-resize}.react-flow__resize-control.top,.react-flow__resize-control.bottom{cursor:ns-resize}.react-flow__resize-control.top.left,.react-flow__resize-control.bottom.right{cursor:nwse-resize}.react-flow__resize-control.bottom.left,.react-flow__resize-control.top.right{cursor:nesw-resize}.react-flow__resize-control.handle{width:5px;height:5px;border:1px solid #fff;border-radius:1px;background-color:var(--xy-resize-background-color, var(--xy-resize-background-color-default));translate:-50% -50%}.react-flow__resize-control.handle.left{left:0;top:50%}.react-flow__resize-control.handle.right{left:100%;top:50%}.react-flow__resize-control.handle.top{left:50%;top:0}.react-flow__resize-control.handle.bottom{left:50%;top:100%}.react-flow__resize-control.handle.top.left,.react-flow__resize-control.handle.bottom.left{left:0}.react-flow__resize-control.handle.top.right,.react-flow__resize-control.handle.bottom.right{left:100%}.react-flow__resize-control.line{border-color:var(--xy-resize-background-color, var(--xy-resize-background-color-default));border-width:0;border-style:solid}.react-flow__resize-control.line.left,.react-flow__resize-control.line.right{width:1px;transform:translate(-50%);top:0;height:100%}.react-flow__resize-control.line.left{left:0;border-left-width:1px}.react-flow__resize-control.line.right{left:100%;border-right-width:1px}.react-flow__resize-control.line.top,.react-flow__resize-control.line.bottom{height:1px;transform:translateY(-50%);left:0;width:100%}.react-flow__resize-control.line.top{top:0;border-top-width:1px}.react-flow__resize-control.line.bottom{border-bottom-width:1px;top:100%}.react-flow__edge-textbg{fill:var(--xy-edge-label-background-color, var(--xy-edge-label-background-color-default))}.react-flow__edge-text{fill:var(--xy-edge-label-color, var(--xy-edge-label-color-default))}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wechen-agent-editor-v1",
-  "version": "1.0.1",
-  "description": "Wechen Agent — executable AI flow orchestration editor (React Flow): nodes as modules, edges as execution order; Monaco + Ant Design, for npm",
+  "version": "1.0.4",
+  "description": "Wechen Agent：可执行的 AI 流程编排编辑器（React Flow），节点即模块、边即执行顺序；Monaco + Ant Design，面向 npm",
   "license": "MIT",
   "keywords": [
     "react",
@@ -29,7 +29,10 @@
     "dist",
     "LICENSE"
   ],
-  "sideEffects": false,
+  "sideEffects": [
+    "./dist/index.js",
+    "./dist/style.css"
+  ],
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -38,7 +41,8 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
-    }
+    },
+    "./style.css": "./dist/style.css"
   },
   "scripts": {
     "test": "vitest run",
@@ -46,7 +50,11 @@
     "prepublishOnly": "npm run build",
     "dev": "npm --prefix playground run dev",
     "pack:check": "npm pack --dry-run",
-    "publish": "npm publish --access public"
+    "release": "npm publish --access public --registry https://registry.npmjs.org/",
+    "release:cn": "npm publish --access public --registry https://registry.npmjs.org/ && npm run registry:npmmirror",
+    "registry:show": "npm config get registry",
+    "registry:npmjs": "npm config set registry https://registry.npmjs.org/",
+    "registry:npmmirror": "npm config set registry https://registry.npmmirror.com/"
   },
   "peerDependencies": {
     "@monaco-editor/react": "^4.6.0",