# @aspectlylabs/mikka 中文文档

规范地址：https://npmcn.com/package/%40aspectlylabs/mikka/

版本：0\.0\.51
npm 元数据更新时间：2026-10-31T14:20:03.724Z
中文译文更新时间：2026-10-31T14:24:37.838Z
软件包许可：AGPL-3\.0-only

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

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

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

- 包体积（解压后）：2.6 MB，39 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：11 个
- 首次发布：2026-10-30T23:11:20.394Z
- 最新版本发布：2026-10-31T14:20:03.384Z
- 已发布版本数：32（近 12 个月 32 个）

## 中文简介

本地Mikka守护进程：通过用户自己的cli运行代理

## 安装

```sh
npm install @aspectlylabs/mikka
```

也可以使用：`pnpm add @aspectlylabs/mikka`、`yarn add @aspectlylabs/mikka`、`bun add @aspectlylabs/mikka`

## README

# Mikka守护进程

守护进程将您的计算机连接到Mikka，并运行安装了Mikka的线程 克劳德法典或法典。需要Node.js 24或更新版本和Git。登录到 编写CLI，并确保您的本地Git凭证可以读取存储库 你想用。

发行候选版本是单一的 `@aspectlylabs/mikka` 包含 `mikka` 命令及其守护进程子命令。源工作区保持私有； `pnpm --filter @mikka/daemon build` 生成具有私有属性的包 协议捆绑。必须验证npm组织和受信任的发布者 在发表前。

包发布后，安装一次并启动守护进程：

```sh
npm install -g @aspectlylabs/mikka
mikka daemon login
mikka daemon
```

Login打印一个浏览器确认链接和一个短代码。这个守护进程 保存设备凭据，而不是浏览器会话。默认服务器为 `https://app.aspectlylabs.com/mikka`． 对于预览或自托管服务器，请使用 两个命令中的完整应用程序URL（包括其基本路径）：

```sh
mikka daemon login --server https://preview.example/mikka
mikka daemon --server https://preview.example/mikka
```

`mikka daemon status` 报告一个正在运行的守护进程。 `Ctrl+C` 关闭它。 手动测试设置可以使用 `mikka daemon login --token <device-token>`;保持 令牌退出屏幕截图，日志和shell历史。

## 候选发布版

```sh
pnpm --filter @mikka/daemon build
export MIKKA_DAEMON_DIST_DIR=/absolute/path/printed/by/the/build
pnpm --filter @mikka/daemon test:package
npm pack "$MIKKA_DAEMON_DIST_DIR"
```

每次构建都会写入一个新的 `.retained-build-*` 目录。 现有的构建保持完整。包测试需要精确的目录 并保留其 `.retained-package-test-*` 安装，包和夹具 检查指标。测试守护进程仍然执行其正常的生命周期 清理新专用夹具内部；以前保留的资源是 不是那个装置的一部分。

没有全球 `tsx` 或单独的 `@mikka/protocol` 需要包装。每一次推到 `main` 发布通过 `.github/workflows/publish-daemon.yml` 在守护进程 检查和安装包运行时测试通过。工作流使用npm 可信的发布和来源；它的NPM信任配置必须授权 这个确切的存储库和工作流文件名。

CI邮票 `0.0.<workflow run number + 1>` 进入源清单之前 构建，这样NPM包和运行时就会报告相同的版本。源提交 保留他们的开发版本。重新运行工作流将保留其版本和 如果NPM已经记录了同一提交的版本，则跳过发布。 CI将提交SHA写入已发布的清单中 `gitHead`;现有的 缺少或不同提交元数据的版本将停止发布。后 发布时，CI读取npm元数据并检查提交的SHA。如果npm 当发布的版本可用时，服务404，CI检查到31 等待10秒的时间。耗尽该等待将报告注册表验证 是不完整的;它没有声称NPM拒绝发表。 释放队列而不取消（不超过GitHub的100个等待运行限制）。 较旧的运行可以在自己的运行下发布 `build-<version>` 标签，保存 更新的 `latest` 的版本。手动调度仍然可用 `main` 并获得 一个新的运行版本。运行本地测试或构建不会发布任何内容。

`test:package` 使用public将实际的tarball安装到一个新目录中 注册表依赖项，没有工作区符号链接或安装脚本。平原 Node然后运行安装的CLI和绑定的mock守护进程 克隆/工作树/验证/提交/推送到一个一次性的本地裸源。 它验证推送的文件并保留个人签出。测试日志 tarball摘要；它的控制平面和模型是显式的内存固定装置。 这不是真正的Claude Code/Codex、native-helper、live GitHub App或产品 device-authorization接受。

## 常见问题

### @aspectlylabs/mikka 是什么？

本地Mikka守护进程：通过用户自己的cli运行代理

### 如何安装 @aspectlylabs/mikka？

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

### @aspectlylabs/mikka 支持 TypeScript 吗？

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

### @aspectlylabs/mikka 支持 ESM 还是 CommonJS？

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

### @aspectlylabs/mikka 需要什么版本的 Node\.js？

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

### @aspectlylabs/mikka 可以商用吗？

@aspectlylabs/mikka 使用 AGPL-3\.0-only 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @aspectlylabs/mikka 还在维护吗？

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