# @ryuxdsgn/design-intelligence 中文文档

规范地址：https://npmcn.com/package/%40ryuxdsgn/design-intelligence/

版本：2\.22\.1
npm 元数据更新时间：2026-11-02T09:15:02.439Z
中文译文更新时间：2026-11-02T09:31:23.353Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：441 kB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.12
- 运行依赖：2 个
- 首次发布：2026-10-10T23:51:13.205Z
- 最新版本发布：2026-11-02T09:15:02.244Z
- 已发布版本数：42（近 12 个月 42 个）

## 中文简介

RYUX: AI代理和设计师的设计智能。一项技能，五个切入点：分析，设计，构建，批判和QA，适用于Claude Code， Codex, Cursor, Gemini CLI, OpenCode, Cline， Copilot等。

## 安装

```sh
npm install @ryuxdsgn/design-intelligence
```

也可以使用：`pnpm add @ryuxdsgn/design-intelligence`、`yarn add @ryuxdsgn/design-intelligence`、`bun add @ryuxdsgn/design-intelligence`

## README

# ![RYUX](https://raw.githubusercontent.com/ryuxdsgn/design-intelligence/main/.github/assets/ryux-light.svg)

`@ryuxdsgn/design-intelligence`

安装 **RYUX**，为人工智能代理和设计师设计智能，只需一个命令。RYUX就是其中之一 技能有五个入口点。告诉你的经纪人你在做什么；RYUX从任务中挑选知识 需求:

-   **分析**理解现有的界面，并将每个发现标记为测量、观察或 推断。
-   **设计**：在Figma， pen.dev或模型中创建或改进UI和UX，无需代码。
-   **构建**在repo自己的栈中实现接口。
-   **批判**：对Figma链接、pen.dev设计、网站URL或 截图。
-   **质量保证**：渲染，检查，修复，再渲染。

原创作品由ryux.design提供，MIT授权。规则和原理： [`docs/design-rules.md`](https://github.com/ryuxdsgn/design-intelligence/blob/main/docs/design-rules.md).

## 使用

```bash
npx @ryuxdsgn/design-intelligence                                          # start here: agents, install, project setup
npx @ryuxdsgn/design-intelligence setup                                    # teach RYUX about the project (DESIGN.md)
npx @ryuxdsgn/design-intelligence setup --audience "..." --market "..."    # same, without questions
npx @ryuxdsgn/design-intelligence check                                    # health check (exit 1 on problems)
npx @ryuxdsgn/design-intelligence check --json                             # the same findings as JSON, for agents and CI
npx @ryuxdsgn/design-intelligence init --agent claude --dry-run            # list what would change, write nothing
npx @ryuxdsgn/design-intelligence init --agent claude                      # install + empty project context block
npx @ryuxdsgn/design-intelligence install --agent claude,cursor,codex      # non-interactive
npx @ryuxdsgn/design-intelligence install --agent all                      # every supported agent
npx @ryuxdsgn/design-intelligence install --agent claude --global          # into your home directory
npx @ryuxdsgn/design-intelligence update                                   # refresh, and migrate RYUX 1.x installs
npx @ryuxdsgn/design-intelligence remove --yes                             # remove RYUX and marked blocks
```

`ryux-rules` 仍然可以作为同一命令的别名。

| 命令 | 它是做什么的 |
| --- | --- |
| `setup` | 问一些简单的问题，“写我自己的”，或者跳过：产品，当前工作，受众，市场和地区，约束，设计意图，UX， UI和动作方向。将答案保存到 `<!-- ryux-context -->` 块在 `DESIGN.md`，只更改您回答的字段。答案是方向，而不是证据。没有终端时，用 `--product`， `--work`， `--audience`， `--market`， `--constraints`， `--intent`， `--ux`， `--ui`， `--motion`. |
| `init` | 安装RYUX，然后添加 `<!-- ryux-context -->` 块 `DESIGN.md` （产品，受众，市场和场所，设计系统，证据来源，约束），只预先填充它可以检测到的东西。重新运行永远不会覆盖您所写的内容。 `--dry-run` 列出要创建或更新的内容，不写入任何内容。 |
| `install` | 写 `ryux/` 技能放入每个代理的文件夹和一个短指针块放入 `CLAUDE.md`， `GEMINI.md`，或者 `AGENTS.md`． 交互式安装然后提供 `setup`. `--dry-run` 列出要创建或更新的文件夹和块，不写入任何内容。 |
| `check` （`doctor`） | 检查每个安装：所有文件存在，前文有效，版本匹配这个命令，每个模块引用解析，没有RYUX 1。X文件夹，指针块，项目上下文以及填充了多少设置字段。每个问题都命名了修复它的命令。错误时退出1，因此它在CI中工作； `--json` 打印 `{ ok, cli, scope, installs, findings: [{ level, where, message, fix }] }`. |
| `update` | 重写此版本的安装并迁移RYUX 1.x。 |
| `remove` | 移除技能和指针块。离开你 `DESIGN.md` 上下文。 |

退出代码：0已完成或运行正常，1发现问题或命令失败，2命令使用错误（未知命令或代理）。

一个版本: `packages/cli/package.json`． 技能标题、插件清单和 `ryux --version` 一切都源于它。

## 代理

| 代理 | `--agent` | 项目文件夹 | 全球文件夹 | 文件指针 |
| --- | --- | --- | --- | --- |
| 克劳德代码 | `claude` | `.claude/skills/` | `~/.claude/skills/` | `CLAUDE.md` |
| 食典委 | `codex` | `.codex/skills/` | `~/.agents/skills/` | `AGENTS.md` |
| 光标 | `cursor` | `.cursor/skills/` | `~/.cursor/skills/` | `AGENTS.md` |
| 双子座CLI | `gemini` | `.gemini/skills/` | `~/.gemini/skills/` | `GEMINI.md` |
| OpenCode | `opencode` | `.opencode/skills/` | `~/.config/opencode/skills/` | `AGENTS.md` |
| 克莱因 | `cline` | `.cline/skills/` | `~/.cline/skills/` | `AGENTS.md` |
| GitHub副驾驶员 | `copilot` | `.agents/skills/` | `~/.agents/skills/` | `AGENTS.md` |
| Amp | `amp` | `.agents/skills/` | `~/.config/agents/skills/` | `AGENTS.md` |
| 乔任梁代码 | `kimi` | `.agents/skills/` | `~/.agents/skills/` | `AGENTS.md` |
| 反重力 | `antigravity` | `.agents/skills/` | `~/.gemini/config/skills/` | `AGENTS.md` |
| 别的 | `agents-md` | 内嵌规则 `AGENTS.md` | (项目) | `AGENTS.md` |

共享文件夹的代理只写入一次。项目安装将一个短标记块添加到 指针文件;全局安装只写技能文件夹。

## 安装了什么

一个文件夹, `ryux/`，在每个代理的技能文件夹中：

```
ryux/
  SKILL.md            the router: entry points, how RYUX works, levels, Hard Gates, task table, Delivery Gate
  capabilities/       analyze, design, build, critique, qa
  knowledge/          product, ux, interaction, forms, edge-cases, content, ui, design-system,
                      accessibility, responsive, frontend, anti-slop
```

代理读取路由器，然后只读取任务所需的能力和知识文件。

## 安全为您的回购

-   您的文件永远不会被全部覆盖。 `CLAUDE.md`， `GEMINI.md`, `AGENTS.md` 只有改变 在 `<!-- ryux-rules:start -->` … `<!-- ryux-rules:end -->` 块。
-   `update` 只接触已安装的东西； `remove` 把它拿出来。
-   从RYUX 1.x升级： `install` 或者 `update` 代替16 `ryux-*` 单个文件夹 `ryux/` 文件夹中。文件夹的 `ryux-rules` 0.x和光标 `.mdc` 文件也被删除。旧的 `--for`， `--groups`, `--concerns` 标志被接受和忽略。

## 网络和MCP

-   命令行不发出网络请求，也不运行其他程序。它只写入列出的文件 以上。
-   ryux MCP服务器是可选的：还没有托管服务器，ryux永远不会连接到一个 自己的。RYUX在没有它的情况下工作，并将其证据评为无。
-   该技能告诉代理将MCP服务器、网页或屏幕截图返回的内容视为数据， 从来没有作为指示。

## 其他安装方式

```bash
npx skills add ryuxdsgn/design-intelligence      # skills.sh, any agent
```

```text
/plugin marketplace add ryuxdsgn/design-intelligence
/plugin install ryux@design-intelligence          # Claude Code plugin
```

## 开发

```bash
pnpm --filter @ryuxdsgn/design-intelligence build      # tsc -> dist/
node packages/cli/dist/cli/index.js --help
pnpm sync:skills              # regenerate skills/ryux/, docs/design-rules.md, plugin versions
pnpm test                     # unit + CLI integration tests (node:test, no extra dependencies)
pnpm check:sync               # CI: fail if the committed skill, docs, or versions drift from the sources
```

## 常见问题

### @ryuxdsgn/design-intelligence 是什么？

RYUX: AI代理和设计师的设计智能。一项技能，五个切入点：分析，设计，构建，批判和QA，适用于Claude Code， Codex, Cursor, Gemini CLI, OpenCode, Cline， Copilot等。

### 如何安装 @ryuxdsgn/design-intelligence？

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

### @ryuxdsgn/design-intelligence 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ryuxdsgn\_\_design-intelligence 是否存在。

### @ryuxdsgn/design-intelligence 支持 ESM 还是 CommonJS？

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

### @ryuxdsgn/design-intelligence 需要什么版本的 Node\.js？

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

### @ryuxdsgn/design-intelligence 可以商用吗？

@ryuxdsgn/design-intelligence 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @ryuxdsgn/design-intelligence 还在维护吗？

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