# ilse-design 中文文档

规范地址：https://npmcn.com/package/ilse-design/

版本：0\.11\.0
npm 元数据更新时间：2026-11-03T20:24:40.069Z
中文译文更新时间：2026-11-03T21:40:30.518Z
软件包许可：PolyForm-Shield-1\.0\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/ilse-design
原文对照：https://npmcn.com/package/ilse-design/?lang=original
项目主页：https://github.com/idantas/ilse#readme
源码仓库：https://github.com/idantas/ilse

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5 MB，547 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：13 个
- peer 依赖：vite \>=5\.0\.0，react \>=18\.0\.0
- 首次发布：2026-04-10T16:11:54.024Z
- 最新版本发布：2026-11-03T20:24:39.719Z
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

设计师的眼睛在代码代理：指出什么是错误的在你运行的应用程序，或调整它像在Figma -你自己的编码代理改变代码。

## 安装

```sh
npm install ilse-design
```

也可以使用：`pnpm add ilse-design`、`yarn add ilse-design`、`bun add ilse-design`

## README

![Ilse](https://raw.githubusercontent.com/idantas/ilse/main/.github/assets/logo-ilse.svg)

**英语** · [葡萄牙商业银行](https://github.com/idantas/ilse/blob/main/LEIAME.md)

**设计师的眼睛在代码代理中。**

你在浏览器中打开你的应用程序，指出哪里出了问题，然后说应该怎么做——或者就在那里进行调整，就像在Figma中一样。你的AI编码代理会改变代码。您可以在页面上看到结果，并保留它或撤消它。

> **业余项目，测试版。** 由设计人员制作，适用于使用代码代理的设计人员。免费使用，与代码打开阅读。

## 你能做什么

-   **指着说。** 点击一个元素，选择一段文字或绘制一个区域，写下需要改变的内容： _卡片之间要有更多的空间。_， _“这个标题应该更强一些。”_。
-   **自己调整。** 像Figma这样的属性面板：大小、布局、间距、排版、颜色、边框。在发送更改之前，您将看到实时更改。
-   **编辑文本和删除东西。** 在面板中重新键入文本，或删除元素。
-   **各种屏幕尺寸。** 用尺子打开手机、平板电脑或桌面宽度的页面，并使用相同的工具栏调整每个页面。
-   **移动东西。** 拖动可重新排序、移进或移出容器、调整大小。
-   **画出来。** 用铅笔在页面上画草图，或者粘贴截图作为参考。
-   **撤销任何东西。** ⌘Z将代码完全还原为原来的样子。不需要让人工智能恢复。
-   **CI保持绿色。** 每次更改之后，Ilse都会运行项目的类型检查和覆盖它的测试。当更改中断时，代理会在完成之前进行修复。

## 你需要什么？

-   一个 **反应** 在您的计算机上运行的项目（Next.js, Vite…）。
-   一个 **人工智能编码代理** 已安装并登录： [克劳德代码](https://claude.com/claude-code)、Codex、Cursor CLI或Gemini CLI。

伊尔丝使用 _你的_ 代理和 _你的_ 帐户。它没有自己的帐户、密钥或服务器，也没有任何东西离开你的机器。

## 试一试

在你的项目文件夹中-不需要先启动应用程序-运行：

```bash
npx ilse-design@latest
```

伊尔丝在npm [`ilse-design`](https://www.npmjs.com/package/ilse-design) 需要Node.js 18或更新版本。 `@latest` 确保你安装的是最新版本，即使你的机器上安装的是旧版本。

Ilse启动开发服务器(`npm run dev`)并在其通常的地址-打开您的应用程序 `http://localhost:3000`，或者它使用的任何端口-工具栏在顶部。登录、SSO和回调继续工作。第一次测试会问一些问题，大约需要一分钟。下次，只要 `ilse` 如果你 [它安装](https://github.com/idantas/ilse/blob/main/docs/reference.md#install)。

更喜欢自己运行开发服务器？ `--separate` 在自己的地址上打开了Ilse， `localhost:4700`． 更多方法： [轻快地插件](https://github.com/idantas/ilse/blob/main/docs/reference.md#on-your-apps-own-port-vite-plugin), [bookmarklet或Chrome扩展（实验性）](https://github.com/idantas/ilse/blob/main/docs/reference.md#any-local-page-bookmarklet-or-chrome-extension)。

对终端不舒服？问你的经纪人： _在此项目中安装并运行Ilse -参见https://github.com/idantas/ilse_。

## 成本是多少

伊尔斯运行的是你的代理人的计划，所以它使用了那个计划的限制。它总是选择最便宜的方法：

-   **面板的调整** 映射到代码中的类是由Ilse自己生成的-没有AI，即时的，没有来自你的计划的任何东西。
-   **小的请求** 换一种更快、更便宜的模式：几秒钟。
-   **更大的** （新的屏幕，结构）到完整代理-最昂贵的步骤，所以它只在需要时使用。

## 更深

-   [它是如何工作的](https://github.com/idantas/ilse/blob/main/docs/how-it-works.md) - Ilse如何查找代码、成本阶梯、模型、安全检查、使用限制、撤销和提交。
-   [参考](https://github.com/idantas/ilse/blob/main/docs/reference.md) -命令，设置，通过MCP连接代理，日志，兼容性。
-   [AGENTS.md](https://github.com/idantas/ilse/blob/main/AGENTS.md) -供投稿人及其代理人使用。

## 为什么“伊尔丝”

人工智能将设计师从执行瓶颈中解放出来，但工艺仍然需要人类的判断。Ilse是设计师在代理内部的眼睛：你指出错误，代理修复它，你同意。

> “设计是改善人性的工具。”——伊尔丝·克劳福德

## 贡献

问题和拉请求是欢迎的-见 [CONTRIBUTING.md](https://github.com/idantas/ilse/blob/main/CONTRIBUTING.md)． 安全问题不为人知： [SECURITY.md](https://github.com/idantas/ilse/blob/main/SECURITY.md)。

[PolyForm Shield 1.0.0](https://github.com/idantas/ilse/blob/main/LICENSE)：免费使用、修改和分享——只是不要建立一个与Ilse竞争的产品。0.5.1之前的版本是MIT；看到 [请注意](https://github.com/idantas/ilse/blob/main/NOTICE)。

## 常见问题

### ilse-design 是什么？

设计师的眼睛在代码代理：指出什么是错误的在你运行的应用程序，或调整它像在Figma -你自己的编码代理改变代码。

### 如何安装 ilse-design？

在项目目录运行 npm install ilse-design，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ilse、ilse-mcp、ilse-design，可以用 npx ilse 直接运行。

### ilse-design 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### ilse-design 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### ilse-design 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### ilse-design 可以商用吗？

ilse-design 使用 PolyForm-Shield-1\.0\.0 许可。声明的许可为 PolyForm-Shield-1\.0\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### ilse-design 还在维护吗？

最新版本 0\.11\.0 发布于 2026/11/04（1 天前）；至今共发布 25 个版本，其中过去 12 个月发布了 25 个；首次发布于 2026/04/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。