Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Windows: 企业 EDR（奇安信天擎）拦截 MoveFileExW 导致启动写 index.html 报 EXDEV，CLI 完全无法启动

オープン 初心者向け
  • 何か問題がありますか？
#4,381 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
70/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
活発
技術スタック
node.js, typescript
領域
cli

調査の方向性

CLIのソースで、index.htmlのrenameSync/temp fileを使用したアトミックな書き込みを検索する。提案されたEXDEV/EPERM時のcopyFileSyncへのtry/catchフォールバックを挿入する。内蔵ウェブサーバーの起動またはファイル書き込みヘルパーのユニットテストを実行して検証する。

索引モデルが issue の本文から書いたものです。

説明

问题描述

在企业 EDR 环境（奇安信天擎）下，CLI 启动内置 web 服务时用"写临时文件 + 原子改名"生成 index.html，rename 被安全软件过滤驱动拦截并返回 EXDEV，CLI 直接失败退出，无法使用。

Failed to start server: EXDEV: cross-device link not permitted, rename
'C:\Users\Administrator\AppData\Local\kimi-code\web\2.3.1\win32-x64\<hash>\dist-web\index.html.<pid>.<ts>.tmp'
-> '...\dist-web\index.html'

根因分析（已通过系统调用级实验确证）

天擎过滤驱动按目标扩展名（.html/.txt/.docx/.xlsx/.pdf/.jpg/.bat/.ps1 等）拦截特定的改名 API，与目录位置无关（C/D 盘任意目录均复现）：

Win32 API rename 目标为 .html 等 rename 目标为 .js/.exe 等
MoveFileW（普通改名） 正常 正常
MoveFileExW（libuv uv_fs_rename 使用） ERROR_NOT_SAME_DEVICE (winerr 17) 正常
MoveFileWithProgressW ERROR_NOT_SAME_DEVICE 正常

关键点：

  • 该拦截不是跨设备问题（各层目录均无 reparse point，同卷内 rename），EXDEV 错误码有强误导性
  • 同一环境下普通 MoveFile 与"复制+删除"均正常，操作本身可行，仅因 libuv 选择了被拦截的 API
  • 天擎"信任区"只豁免病毒扫描，不豁免此拦截；Windows Defender 已被第三方接管
  • 该模式（tmp+rename 原子写文档类文件）在 Node/npm 生态广泛存在，影响面不限于本 CLI

复现

// Node v24.21.0，装有奇安信天擎的 Windows 机器
const fs = require('fs');
fs.writeFileSync('a.tmp', 'x');
fs.renameSync('a.tmp', 'b.html');   // 抛 EXDEV: cross-device link not permitted
fs.renameSync('a.tmp', 'b.js');     // 正常

对照（ctypes 直调 API）：MoveFileExW(src, dst, 0) 和 (src, dst, MOVEFILE_REPLACE_EXISTING) 对 .html 目标均返回 winerr=17；MoveFileW 正常。

建议修复

原子写流程在 rename 失败时增加降级（对正常环境零影响）：

try {
  fs.renameSync(tmp, target);
} catch (e) {
  if (['EXDEV', 'EPERM', 'EBUSY', 'EACCES'].includes(e.code)) {
    fs.copyFileSync(tmp, target);  // copy 路径不受上述规则影响，已验证
    fs.unlinkSync(tmp);
  } else {
    throw e;
  }
}

环境信息

  • OS：Windows 10 Pro x64（简体中文），C/D 盘均 NTFS，无符号链接
  • kimi-code CLI：2.3.1
  • 安全软件：奇安信天擎企业定制版（奇安信过滤驱动层拦截）
  • 临时绕过手段均无：天擎策略集中管控，本地无可用的排除项；扩展名白名单/信任区只豁免扫描层
主要言語
TypeScript
スター
8k
フォーク
1.3k
平均マージ
16時間 17分
マージ済み PR（30日）
161

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

MoonshotAI/kimi-code のほかの issue

MoonshotAI/kimi-code の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。