@aspectlylabs/mikka

中文文档
0.0.51发布于 2026/10/31AGPL-3.0-onlyES Module构建来源已验证

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

中文使用文档

Mikka守护进程

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

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

包发布后,安装一次并启动守护进程:

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

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

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历史。

候选发布版

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 共发布 32 个版本,首次发布于 2026/10/31;过去 12 个月发布了 32 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.0.51latest2026/10/312 天前
0.0.492026/10/312 天前
0.0.482026/10/312 天前
0.0.472026/10/312 天前
0.0.462026/10/312 天前
0.0.452026/10/312 天前

关于 @aspectlylabs/mikka 的常见问题

@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 和提交记录判断。