# @fmatar/archlens-skill 中文文档

规范地址：https://npmcn.com/package/%40fmatar/archlens-skill/

版本：1\.1\.3
npm 元数据更新时间：2026-11-14T19:34:54.041Z
中文译文更新时间：2026-11-15T03:13:18.024Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：244 kB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：0 个
- 首次发布：2026-09-25T16:59:23.396Z
- 最新版本发布：2026-11-14T19:34:53.868Z
- 近 30 天下载量：2386（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

Archlens清洁建筑治理政策和人工智能助理技能的跨平台CLI和安装器

## 安装

```sh
npm install @fmatar/archlens-skill
```

也可以使用：`pnpm add @fmatar/archlens-skill`、`yarn add @fmatar/archlens-skill`、`bun add @fmatar/archlens-skill`

## README

# @fmatar/ archlens- skill (英语)

[![npm version](https://img.shields.io/npm/v/@fmatar/archlens-skill.svg)](https://www.npmjs.com/package/@fmatar/archlens-skill) [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![Node](https://img.shields.io/badge/Node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)

零依赖CLI、政策脚手架和多代理技术安装器 **[Archlens 动态清洁建筑工作台](https://github.com/fmatar/archlens)**。 。 。 .

分析任何项目寄存器,检测编程语言和软件包等级,将软件包分类为同心同心的 Clean Architecture 阶梯,脚手架 `.archlens/policy.json`,并装备了AI编码助理(Claude Code,双子座CLI,Google Antigravity)的邮箱重构协议.

* * *

## QQ 快速启动

### 备选办法A:零出入口自主AI设置(`--mcp` - 关于抗重力和克洛德的建议)

设备 **谷歌反重力**, (中文(简体) ), **克劳德代码**, (中文(简体) ), **克劳德桌面**, (中文(简体) ), **光标**, (中文(简体) ), **风起浪起**,以及 **双子座CLI** 在一个命令。 选择可移植的 NPX stdio 桥( 带有 4- 等离线 AST 倒置) 或 麻黄多克 `mcp-stdio` 容器 :

```bash
# Portable / shared-repo setup (.archlens/policy.json + AGENTS.md + skills + NPX MCP bridge):
npx @fmatar/archlens-skill --yes --skills --mcp

# Personal workstation setup (ephemeral docker run -i --rm -e QUARKUS_PROFILE=mcp-stdio container):
npx @fmatar/archlens-skill --yes --skills --mcp --docker

# Equip global skills AND global MCP manifests across all detected coding agents:
npx @fmatar/archlens-skill global
npx @fmatar/archlens-skill global --docker
```

### 备选办法B:直接通过 `npx skills`

打开 [Vercel实验室技能](https://github.com/vercel-labs/skills) 标准,您可以添加跨越 15+ AI 编码助理(Claude Code, Cursor, Antigravity, Copilot, Codex, Windsurf, Zed)的Archlens 能力 :

```bash
# Add all 3 Archlens skills to detected AI assistants in project or globally:
npx skills add fmatar/archlens --all -y

# Or add to a specific assistant:
npx skills add fmatar/archlens --all --agent claude-code -y
```

### 选项 C: 通过 NPX 运行交互式政策脚手架

```bash
# Production Stable (recommended)
npx @fmatar/archlens-skill

# Canary / Development Preview (tracks latest develop branch)
npx @fmatar/archlens-skill@dev

# Direct GitHub Execution (zero registry dependencies)
npx github:fmatar/archlens
```

### 备选办法D:通过国家预防机制在全球安装

```bash
npm install -g @fmatar/archlens-skill
archlens-skill
```

### 选项 E: 从本地仓库克隆运行

```bash
# Install globally from the local repository:
npm install -g ./cli
archlens-skill

# Or execute directly with Node:
node ./cli/bin/index.js
```

* * *

## 关键特性

-   **无外部依赖**: 配备纯节点Js标准库的工程师(`node:fs`, (中文(简体) ), `node:path`, (中文(简体) ), `node:readline`, (中文(简体) ), `node:test`, (中文(简体) ), `node:os`) (中文(简体) ). 立即执行通过 `npx` 没有后遗症.
-   **交互式终端 UI**:在终端运行时显示有样式的ANSI诊断,ASCII品牌标语,以及交互式引导选择.
-   **Polyglot 密码库分析器**:自动检测项目语言和布局跨越了Java,克特林,TypeScript,JavaScript,Python,Rust,Go和克洛朱尔.
-   **同心分级分类**: 自动将软件包映射到清洁建筑层:
    -   **0级(核心领域)**数字 : `domain`, (中文(简体) ), `model`, (中文(简体) ), `entities`, (中文(简体) ), `core`, (中文(简体) ), `types`
    -   **1级(应用)**数字 : `usecase`, (中文(简体) ), `application`, (中文(简体) ), `service`, (中文(简体) ), `port`, (中文(简体) ), `interactor`
    -   **第二级(配位符)**数字 : `adapter`, (中文(简体) ), `controller`, (中文(简体) ), `gateway`, (中文(简体) ), `presenter`, (中文(简体) ), `repository`, (中文(简体) ), `dto`, (中文(简体) ), `api`
    -   **第三级(基础设施)**数字 : `infrastructure`, (中文(简体) ), `config`, (中文(简体) ), `db`, (中文(简体) ), `web`, (中文(简体) ), `server`, (中文(简体) ), `client`
-   **多机构技能部署**: 安装 `archlens-install-policy` 将全球技能纳入克洛德守则`~/.claude/skills/`),双子CLI / 抗重力 (`~/.gemini/config/skills/`)和自定义代理工作空间.
-   **安全递增更新**: 为新引入的软件包重新扫描代码库, 更新 `order` 财务报告和审定财务报表 `levels` 同时保留用户自定义规则和配置.
-   **无缝升级迁移**: 自动迁移遗产 `.uml-viewer/` 现代文件夹和配套文件 `.archlens/` 通过 `archlens-skill upgrade`。 。 。 .
-   **模式背景协议( MCP) 客户端自动配置**: 检测和配置主机AI客户端在单一命令(Claude Desktop, Google Antigravity, Claude Code, Cursor, VS Code)中的显示(Claude)`--mcp`) (中文(简体) ).
-   **紧急集装箱管弦乐和斯德奥桥**: 必要时自动旋转Archlens容器,将MCP接通于 stdio(`mcp` 命令),并在无法使用多克时提供即时离线AST倒置.
-   **邮箱协议集成**: 将清洁建筑配套协议注入 `CLAUDE.md` 财务报告和审定财务报表 `AGENTS.md` 用于无缝同步的邮箱重构(`to-agent.json`, (中文(简体) ), `to-viewer.json`) (中文(简体) ).

* * *

## 使用和CLI 参考

### 共同工作流程

#### 1\. 互动设置向导

通过仓库检查和选项选择指导您 :

```bash
npx @fmatar/archlens-skill
```

#### 2\. 无头本地初始化

以默认设置初始化当前寄存器中的 Clean 架构治理 :

```bash
npx @fmatar/archlens-skill --yes
```

瞄准特定寄存器目录 :

```bash
npx @fmatar/archlens-skill --path /path/to/project --yes
```

#### 3\. 全球AI代理技术与MCP安装

部署技能和全球MCP的显示方式是:Claude Code、双子座CLI和Antigravity在所有工作空间配备(通过) `--docker` 用于电子容器模式或 `--no-mcp` 以跳过 MCP 设置 :

```bash
npx @fmatar/archlens-skill global
npx @fmatar/archlens-skill global --docker
```

#### 4\. 同步现有政策

添加新模块或软件包后重新扫描代码以将其纳入 `.archlens/policy.json`数字 :

```bash
npx @fmatar/archlens-skill update
```

#### 5\. 更新遗产配置

长者 `.uml-viewer/` 标准目录和相伴 `.archlens/` 版式 :

```bash
npx @fmatar/archlens-skill upgrade
```

#### 6\. 导出 LLM 重构快取

生成 Claude Code、双子座、ChatGPT 或 Antigravity 的可复制的建筑诊断和具体依赖性倒置原则(DIP)指令:

```bash
# Print dossier to stdout
npx @fmatar/archlens-skill prompt

# Or copy directly to system clipboard
npx @fmatar/archlens-skill prompt --copy
```

#### 7\. 示范背景协议(MCP)设置和Stio桥

配置检测到的AI客户端显示或发射交互式 stdio 桥:

```bash
# Auto-configure Claude Desktop, Google Antigravity, Claude Code, Cursor, and VS Code
npx @fmatar/archlens-skill --mcp

# Auto-configure pure ephemeral Docker MCP container (docker run -i --rm -e QUARKUS_PROFILE=mcp-stdio)
npx @fmatar/archlens-skill --mcp --docker

# Launch MCP stdio transport bridge (spins up Docker container automatically when needed)
npx @fmatar/archlens-skill mcp
```

#### 8\. 启动工作台集装箱和自动储存

启动 Archlens 容器,挂载工作空间,验证准备状态,并选择打开浏览器. **如果容器被杀死或停止,则运行 `start` (或呼叫 MCP 工具) 自动再次启动 :**

```bash
# Start container and automatically open workbench in browser:
npx @fmatar/archlens-skill start --open

# Start container in background on default port 8088:
npx @fmatar/archlens-skill start

# Specify a custom port or target workspace directory:
npx @fmatar/archlens-skill start --path /path/to/project --port 8088 --open
```

* * *

### 命令行选项

| 旗帜/ 命令 | 简写 | 说明 | 默认 |
| --- | --- | --- | --- |
| `check` | `--check` | 运行无头清洁建筑 CI 质量门 |  |
| `start` |  | 启动 Archlens 工作台( Native 二进制 / JAR / Docker倒置) |  |
| `prompt` | `--prompt` | 导出 LLM 重构速记 |  |
| `mcp` |  | 运行 MCP stdio 服务器桥(在线+离线静态倒置) |  |
| `update` | `--update`, (中文(简体) ), `-u` | 重新扫描代码并更新已有 `.archlens/policy.json` | `false` |
| `upgrade` | `--upgrade` | 迁移遗产 `.uml-viewer` 改为 `.archlens` | `false` |
| `global` | `--global`, (中文(简体) ), `-g` | 将技能安装到全球代理目录 | `false` |
| `--max-violations <N>` |  | 最大允许的外层违反 `check` | `0` |
| `--detect-cycles` |  | 失败 `check` 如果检测到包依赖周期( ADP) | `false` |
| `--screaming-threshold <N>` |  | 最小尖叫建筑分数( X)`0.0`– 说吧 –`1.0`(中文(简体) ) |  |
| `--suggest-features` |  | 建议尖叫建筑特征片组 `check` | `false` |
| `--fitness-threshold <N>` |  | 最低复合结构适配指数`0.0`– 说吧 –`1.0`(中文(简体) ) |  |
| `--format <FMT>` |  | 输出格式 `check` (单位:千美元)`text`, (中文(简体) ), `json`, (中文(简体) ), `sarif`(中文(简体) ) | `text` |
| `--output <FILE>` | `-O` | 写入 `check` 要存档的输出报告( 如 SARIF) |  |
| `--native` |  | 强制本地 JVM 运行模式 `start` | `false` |
| `--docker` |  | 强制嵌入容器模式 `start` 或配置电平 `mcp-stdio` 显示为 `--mcp` | `false` |
| `--jar <PATH>` |  | 自定义路径到 `quarkus-run.jar` 用于本地模式 | 自动检测 |
| `--open` | `-o` | 启动时在默认浏览器中打开视觉工作台 | `false` |
| `--port <PORT>` |  | 工作端口 HTTP 端口 | `8088` |
| `--path <DIR>` | `-p` | 目标存储器目录 | `.` (当前目录) |
| `--title <NAME>` | `-t` | 视觉工作台的项目标题 | 格式化文件夹名称 |
| `--prefix <PKG>` |  | 常见包前缀( 如. `com.example.service`(中文(简体) ) | 自动检测 |
| `--server-url <URL>` |  | Visual Workbench 服务器端点 | `http://localhost:8088` |
| `--mcp` | `-m` | 自动配置 MCP 客户端列表( Claude, Antigravity, Cursor, 双子座, Grok, Windsurf, VS 代码) | `false` |
| `--copy` | `-c` | 直接将 LLM 输出复制到系统剪贴板 | `false` |
| `--force` | `-f` | 覆盖已存在的配置文件 | `false` |
| `--dry-run` |  | 不写入文件而模拟执行 | `false` |
| `--yes` | `-y` | 自动接受默认值( 非交互) | `false` |
| `--version` | `-v` | 显示软件包版本 |  |
| `--help` | `-h` | 显示帮助引用 |  |

* * *

## \* \* 人工生成

运行安装器会创建以下治理结构:

```text
my-project/
├── .archlens/
│   ├── policy.json             # Clean Architecture concentric tiers & rules
│   └── workbench.config.json   # Workbench endpoint and mailbox IPC configuration
├── CLAUDE.md                   # Clean Architecture Mailbox companion protocol
└── AGENTS.md                   # Agent instructions for DIP refactoring & AST reload
```

### 在 Archlens 工作区可视化

一旦配置, 启动 Archlens 工作台并打开您的项目 :

```text
http://localhost:8088/?projectRoot=/absolute/path/to/my-project
```

或者打开视觉工作台并按下 `⌘O` 编号 : `Ctrl+O` 浏览并选择您的工程根.

* * *

## 测试

使用节点本地测试跑道执行测试套件 :

```bash
npm test
```

* * *

## 许可证

阿帕奇-2.0 © [法迪马达](https://github.com/fmatar)

## 常见问题

### @fmatar/archlens-skill 是什么？

Archlens清洁建筑治理政策和人工智能助理技能的跨平台CLI和安装器

### 如何安装 @fmatar/archlens-skill？

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

### @fmatar/archlens-skill 支持 TypeScript 吗？

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

### @fmatar/archlens-skill 支持 ESM 还是 CommonJS？

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

### @fmatar/archlens-skill 需要什么版本的 Node\.js？

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

### @fmatar/archlens-skill 可以商用吗？

@fmatar/archlens-skill 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @fmatar/archlens-skill 的下载量有多少？

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

### @fmatar/archlens-skill 还在维护吗？

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