# @1agh/maude 中文文档

规范地址：https://npmcn.com/package/%401agh/maude/

版本：2\.0\.8
npm 元数据更新时间：2026-11-07T16:10:17.276Z
中文译文更新时间：2026-11-06T15:21:23.948Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%401agh/maude
原文对照：https://npmcn.com/package/%401agh/maude/?lang=original
项目主页：https://github.com/1aGh/maude#readme
源码仓库：https://github.com/1aGh/maude

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

- 包体积（解压后）：53 MB，2591 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：9 个
- 首次发布：2026-05-20T08:59:33.877Z
- 最新版本发布：2026-11-07T16:10:16.969Z
- 近 30 天下载量：2924（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：126（近 12 个月 126 个）

## 中文简介

Michal Dovrtál的 Claude 代码插件市场: `design` (canvas-first design 迭接) + : `flow` (基因代理工作流程循环与.ai第二大脑). 船舶 `maude` CLI( 与 `mdcc` 用于脚手架工作空间,运行设计 dev 服务

## 安装

```sh
npm install @1agh/maude
```

也可以使用：`pnpm add @1agh/maude`、`yarn add @1agh/maude`、`bun add @1agh/maude`

## README

# 玛德

克劳德代码和代码插件的个人市场. 今天有两个插件, 加一个 `maude` 用于脚手架和运行捆绑的dev工具的CLI.

> **完整文档 : [https://maude.sh (英语)](https://maude.sh/)** (或浏览来源于 [`site/content/docs/`](https://npmcn.com/package/%401agh/maude/site/content/docs/) 直到公共URL登陆). 贡献? 见 [捐款额](https://npmcn.com/package/%401agh/maude/CONTRIBUTING.md)安全吗? 见 [警卫](https://npmcn.com/package/%401agh/maude/SECURITY.md)。 。 。 .

| 插件 | 它会做什么 |
| --- | --- |
| **`design`** | TSX/JSX上的 Canvas- first 迭代在下方 `.design/` ——元素选择通过 Cmd+Click,自动管理的dev服务器,链式UX/DS批判. 帆布也可以成为 **视频码** (Remotion 组成预览了 in-app,通过Maude自己的抓取引擎导出为MP4/GIF——没有额外安装). |
| **`flow`** | 通用代理工作流程循环,带有二脑 `.ai/` 工作空间. `/flow:plan`, (中文(简体) ), `/flow:execute`, (中文(简体) ), `/flow:validate`, (中文(简体) ), `/flow:done`, (中文(简体) ), `/flow:bug-rca`, (中文(简体) ), `/flow:bug-fix`, (中文(简体) ), `/flow:release`, (中文(简体) ), `/flow:record-ddr`, (中文(简体) ), `/flow:init`, (中文(简体) ), `/flow:run` (10个命令;变体为旗帜-参见: [流动移徙](https://maude.sh/docs/flow-migration)) (中文(简体) ). 通过项目不可知 `<project>` 占位符 + 每重置 `.ai/workflows.config.json`。 。 。 . |

再加上 **`maude`** CLI - 翻译: `maude init` 脚手架很新鲜 `.ai/` 流插件骨架的工作空间; `maude design serve` 启动设计 Dev 服务器 。 遗产 `mdcc` 别名仍然有效(打印出去色警告),将在v0.17.x被删除.

## 快开始

**代码 CLI :** 使用该 [本地插件安装指南](https://npmcn.com/package/%401agh/maude/docs/native-plugins.md)它使用相同的工作流程; Studio ACP支持是单独的后续行动.

> **使用Maude桌面吗?** 仅限 **已安装 Claude 代码**,桌面应用程序的内置聊天面板自动加载 `design` + 键 `flow` 其会话插件 - `/design:*` 财务报告和审定财务报表 `/flow:*` 只是工作,没有设备可以安装(已经安装了插件的电源用户看到一个没有操作,没有双载荷). 以下步骤如下: **手动/ 动力用户路径** 为: `maude` CLI,网络 `maude design serve` 流动或驱动 `/design:*` 从你自己的终端Claude代码。 全部细节 : [maude.sh/台式电脑](https://maude.sh/desktop)。 。 。 .

### 1\. 在克洛德法典内增加市场

```
/plugin marketplace add 1aGh/maude
```

### 2\. 安装您想要的插件

```
/plugin install design@maude
/plugin install flow@maude
```

礛 `/reload-plugins` 你应该看看 `/design:edit`, (中文(简体) ), `/design:*`, (中文(简体) ), `/flow:plan`, (中文(简体) ), `/flow:execute`等 (中文(简体) ).

### 3\. 安装国家领导才能

```sh
# From npm:
npm i -g @1agh/maude

# Or directly from GitHub:
npm i -g github:1aGh/maude
```

安装后, 这些垃圾箱会打开 `$PATH`数字 :

-   `maude` · 主要的CLI(`init`, (中文(简体) ), `config`, (中文(简体) ), `design serve`) (中文(简体) ).
-   `mdcc` - 遗产别名 `maude`。打印折旧警告;将在v0.17.x中删除.

### 4\. 诱饵

在任何工程根中 :

```sh
maude init                          # scaffold .ai/ second-brain workspace
```

然后在克洛德代码内(与 `flow@maude` 已安装 :

```
/init                  # Anthropic's built-in — generates CLAUDE.md tailored to your codebase
/flow:init    # populates .ai/workflows.config.json with detected stack
/flow:run --status     # confirm everything wired up
```

`/init` 写入 `CLAUDE.md` Claude 自动装入每个会话(公约,构建命令,获取). `/flow:init` 处理结构化的工作空间配置——它们是互补的,而不是重复的.

### 健康检查 - `maude doctor`

`maude doctor` 报告缺少依赖性、配置方案出错、堆栈漂移和缺少质量门声明. `--fix` 应用安全的自定义(每个依赖安装的瞬间;从不覆盖已有的用户配置值). `--json` 方案消费者。 在堆栈更改后或在打开 PR 之前运行 .

```sh
maude doctor          # full health check (deps + config + quality)
maude doctor --fix    # install missing deps (per-item prompt) + apply safe config fixes
maude doctor --json   # machine-readable envelope
```

**质量门** 已声明为 `.ai/workflows.config.json` 在顶层 `quality` 地图——平面 `gate → shell command` 测绘(如:. `{ "lint": "pnpm lint", "tests": "pnpm test" }`) (中文(简体) ). 流程命令( E)`/flow:validate`, (中文(简体) ), `/flow:validate --fast`, (中文(简体) ), `/flow:execute --quick`直接读取,然后通过 `eval`。这里有 **没有 `maude quality run` 包装** —— 说 `pnpm <script>` 已经是跑者了。 用单行道插入你自己的预承诺工具: `eval $(jq -r '.quality.lint' .ai/workflows.config.json)`。通过运行填充块 `maude doctor --fix` 曾经你 `package.json` 脚本存在( 添加- 它永远不会覆盖您调制的命令) .

### 侧车缓存 - `maude cache`

Flow + 设计命令通过小型侧车缓存重复使用昂贵的相会工作 `.ai/cache/` (单位:千美元)[DDR-061 复员方案](https://npmcn.com/package/%401agh/maude/.ai/archive/decisions/DDR-061-sidecar-cache-monitor-background-orchestration.md):域研究(同域简报上的Sskips 30-90 s的WebSearch),密码库-情报扫描(树没有变化时Skips重新扫描),解析设计-系统词汇,以及安全审查再利用(一个共享的1小时窗口横跨) `/flow:validate`, (中文(简体) ), `/flow:done`, (中文(简体) ), `/flow:validate --security`) (中文(简体) ). 正确性第一——大多数层都是内容处理的(一个已更改的输入更改了密钥)——保证误差),而一个过时的条目从不投机地服务.

```sh
maude cache list              # layers, entry counts, sizes, last-write time
maude cache stats             # hit/miss counters + hit-rate per layer
maude cache inspect <layer>   # list a layer's entries; add a <key> to print one
maude cache clear [layer]     # wipe one layer (or everything)
```

这个 `research/domain` 财务报告和审定财务报表 `codebase-intelligence` 层为 **承诺** (在给定的树上下定决心,所以合作者分享命中); 平分,设计-背景,安全,和情景层被分出. `maude init` 丢入 a `.ai/.gitignore` 用来编码拆分.

### 插件调用 `maude` 可执行逻辑

插件斜线命令通过 on-PATH 达到所有可执行逻辑 `maude` 二进制 — 绝不是亲戚 `cli/lib/*.mjs` 路径或原始 `$CLAUDE_PLUGIN_ROOT/dev-server/bin/*.sh` 援引[复员方案-062](https://npmcn.com/package/%401agh/maude/.ai/archive/decisions/DDR-062-plugins-reach-executable-logic-via-maude.md)) (中文(简体) ). 市场只复制每个插件( 无兄弟姐妹) `cli/`,没有 `dev-server/`),和流指令的 `$CLAUDE_PLUGIN_ROOT` 在流插件(该插件完全没有dev-server)的分数——所以每个安装形状中唯一持有的合同是 `maude`,它从自己的软件包根解决捆绑的帮助者。 缓存/飞行前通过 `maude cache …` 编号 : `maude preflight …`; 设计 dev-server 的击打助手通过 **`maude design <verb>`** (单位:千美元)`screenshot`, (中文(简体) ), `server-up`, (中文(简体) ), `prep`, (中文(简体) ), `slug`, (中文(简体) ), `smoke`, (中文(简体) ), `runtime-health`)——见 `maude design help`保持全球 `maude` 当前; stale 二进制表示 stale 帮助.

## 运行时间要求

-   **节点 20** ——用于dev服务器和CLI. 0 npm 运行时间分解.
-   **克劳德代码** ——桌面应用,CLI,或IDE扩展.
-   可选 : **`agent-browser`** 设计截图证据.

## 协作模式

两条干净的道路,没有中间地带([复员方案047](https://npmcn.com/package/%401agh/maude/.ai/archive/decisions/DDR-047-collab-scope-cut-no-lan-mode-hub-admin-ui.md):

-   **v1.0 — git shitchoff OR回路多塔布.** Push / pull是跨机的故事. 在一款单机上,两个浏览器标签(或两个克洛德码例编辑同一回波)同步光标,评论,和注释在回回WebSocket上直播. dev 服务器拒绝任何非浏览 `host` 合作 WS 端点上的标题 .
-   **v1.1——部署一个枢纽** (第9阶段,飞行)。 跨机现场合作需要你部署的中枢二进制 无隧道模式;无共享云. **靴子订单不能吃你的工作** (单位:千美元)[复员方案102](https://npmcn.com/package/%401agh/maude/.ai/archive/decisions/DDR-102-cold-start-divergence-resolution.md)):每台机器的日记除了真实的相差之外,还讲述干净的赶超;相差的画布快照 **两者** 版本改为 `_history/` 在新人获胜之前,失败者就是 `/design:rollback` 远离——和 `maude design status` 每张扫描报告同步状态诚实(synced / 待定 / auth- 拒绝) .

## 警卫

独奏模式(默认)是完全局部的——没有帐号,没有遥测,没有网络信任表面,帆布沙盒默认上线. 链接(hub)模式是选入的并带有有文件证明的信任模式,包含被披露的,有界限的残基(hub-pushed内容作为不可信输入处理). 完整的账户——什么运行在哪里, 帆布沙盒做什么和不关闭, `.tsx` 同步的双选入, 不信任的文本处理 [`/docs/security`](https://maude.sh/docs/security) (来源: [`site/content/docs/security.mdx`](https://npmcn.com/package/%401agh/maude/site/content/docs/security.mdx)) (中文(简体) ). 改为: **报告** 一种脆弱性,见 [警卫](https://npmcn.com/package/%401agh/maude/SECURITY.md)。 。 。 .

## 何等为相

面向用户的Docs生活在两个地方 — README将您指向正确的方式:

-   **参考文献** (每个命令,每个配置密钥, Next.js / Expo / monorepo 的配方) [`site/content/docs/`](https://npmcn.com/package/%401agh/maude/site/content/docs/) (截至2001年12月31日) [https://maude.sh (英语)](https://maude.sh/) 看到了吗 [复员方案-005](https://npmcn.com/package/%401agh/maude/.ai/archive/decisions/DDR-005-docs-site-stack-and-hosting.md)) (中文(简体) ).
-   **kayai 知识图后端** (可选择的共享决策内存,横跨repos) [`docs/kgai-onboarding.md`](https://npmcn.com/package/%401agh/maude/docs/kgai-onboarding.md) (每个用户)+ [`docs/kgai-company-setup.md`](https://npmcn.com/package/%401agh/maude/docs/kgai-company-setup.md) (一任管理员. 默认关闭——缺席 `kg`,每个命令运行它的经典 `.ai/` 路径.
-   **快速启动** + 键 **贡献信息** 这个读取.

文件站点自动生成每个命令页 `plugins/{flow,design}/commands/*.md` 前题和从 `plugins/flow/.claude-plugin/config.schema.json`。添加一个新的命令 ~ Docs 在下一个构建上更新.

## 工作空间

重罚是 **pnpm 工作空间单列波** 带有一个已公布 npm 软件包(`@1agh/maude`) (中文(简体) ). 内部工作空间是 `"private": true` 绝不出版:

| 工作空间 | 目的 |
| --- | --- |
| `.` (基层) | 单 npm 发布器——CLI,dev-server 条目,插件模板,将发往 npm. |
| `site/` | Docs site — Fumadocs + Next.js, 由 Cloudflare 工人服务([复员方案-005](https://npmcn.com/package/%401agh/maude/.ai/archive/decisions/DDR-005-docs-site-stack-and-hosting.md)) (中文(简体) ). |
| `apps/studio/` | 零点 节点dev服务器+浏览器客户端. 捆绑输出( O)`dist/`)是npm焦油丸中唯一一种. |
| `apps/hub/` | 为v1.1联合枢纽(第9阶段)预留. |

根部常见脚本 :

```sh
pnpm install          # bootstrap everything
pnpm dev              # boot the design dev server
pnpm dev:site         # docs site dev server
pnpm build            # build every workspace that defines `build`
pnpm lint             # biome over the whole repo
pnpm test             # node --test over cli/**/*.test.mjs
pnpm changeset        # add a changeset for the next release
```

网站工作空间的 Next.js 依赖性很重 — 贡献者固定插件代码可以继续工作 `pnpm install --filter '!@maude/site'` 跳过它们.

## 更新

在Claude Code中,在新版本上市后:

```
/plugin marketplace update maude
/plugin install design@maude
/plugin install flow@maude
```

## 释放

Npm 软件包 (`@1agh/maude`)和克洛德代码插件(`design@maude`, (中文(简体) ), `flow@maude`)共享一个版本. 标准发布路径是 **更改**数字 :

```sh
# 1. Each PR with shipped behavior includes a changeset
pnpm changeset

# 2. When ready to release, the maintainer runs:
pnpm version            # = bash scripts/changesets-version.sh
                        #   → consumes .changeset/*.md
                        #   → bumps package.json + CHANGELOG
                        #   → propagates version to plugin manifests
                        #   → re-runs scripts/check-version-parity.sh

git commit -am "chore: release v$(node -p "require('./package.json').version")"
# ANNOTATED (-a -m) is required — `git push --follow-tags` only pushes annotated
# tags. A lightweight `git tag vX.Y.Z` will silently stay local and no release
# workflow ever fires.
VER="v$(node -p "require('./package.json').version")"
git tag -a "$VER" -m "$VER"
git push --follow-tags
```

这个 `v*` 标签触发器 `.github/workflows/publish.yml`,重新运行对等检查,验证标记匹配 `package.json`,建立工作空间,出版 `--access public --provenance`,并使用 ChangeGELOG 条目创建该版本的 GitHub 发布.

`scripts/bump-version.sh patch|minor|major|X.Y.Z` 继续作为变换器流外紧急热补补的手动倒置.

### 一次性设置(项目所有人)

1.  创建一个 **自动化** 符号 [https://www.npmjs.com/ settings/~/tokens (英语)](https://www.npmjs.com/settings/~/tokens)。 。 。 .
2.  GitHub repo – (英语) **设置 / 秘密 / 动作** → `NPM_TOKEN`。 。 。 .
3.  `id-token: write` 已启用 `publish.yml` 为npm出处.

## 地方发展(插文作者)

```
/plugin marketplace add /absolute/path/to/maude
/plugin install design@maude
/plugin install flow@maude
```

在插件内部工作 :

1.  **编辑就位** - 本地市场点到你的工作树.
2.  **编辑后重新装入 :**
    -   指挥/代理/技能 + `/plugin marketplace update maude` 接下来 `/reload-plugins`。 。 。 .
    -   Dev 服务器代码 ~ 杀死运行的过程(`lsof -i :<port>` → `kill`让下一个 `/design:edit` 启动自动启动.
3.  **隔离试验** ——从零开始开放克洛德代码项目(`cd /tmp && claude`)所以插件与这repo自己的不相缠 `.ai/`。 。 。 .
4.  **狗粮** ——毛德本身使用 `flow` 计划/执行/执行。 一次 `flow` 您可以使用此市场来驱动自己的开发 `/flow:plan`, (中文(简体) ), `/flow:execute`等 (中文(简体) ).

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/package/%401agh/maude/LICENSE)。 。 。 .

## 常见问题

### @1agh/maude 是什么？

Michal Dovrtál的 Claude 代码插件市场: design \(canvas-first design 迭接\) \+ : flow \(基因代理工作流程循环与\.ai第二大脑\)\. 船舶 maude CLI\( 与 mdcc 用于脚手架工作空间,运行设计 dev 服务

### 如何安装 @1agh/maude？

在项目目录运行 npm install @1agh/maude，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mdcc、maude、mdcc-safe、maude-safe、claude-design-server，可以用 npx mdcc 直接运行。

### @1agh/maude 支持 TypeScript 吗？

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

### @1agh/maude 支持 ESM 还是 CommonJS？

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

### @1agh/maude 需要什么版本的 Node\.js？

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

### @1agh/maude 可以商用吗？

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

### @1agh/maude 的下载量有多少？

根据 npm 官方下载统计，@1agh/maude 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,924 次，日均约 97 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @1agh/maude 还在维护吗？

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