deepseek-harness/native/system/README.zh.md

---

description: "为 Linux 进程隔离与 POSIX Session 写锁提供预编译系统原语。"

kind: "package-library"

@deepseek-ai/node-addon-system

English | 中文

Summary

使用 Linux landlock-run 可执行文件限制子进程，或通过 ./flock 入口获取 POSIX 写锁。平台包包含预编译二进制；用户安装时不会构建原生代码。Landlock 策略与 Session 生命周期仍由调用方负责。

Table of Contents

• 使用
• 支持范围
• 开发

Use

@deepseek-ai/node-addon-system/landlock-run 为 Landlock 导出 launcherPath、probe 和 grantArgs。其可执行文件名、参数和失败语义由 CLI 约定 定义。

flock 行为约定 将描述符、进程和咨询式锁语义对应到独立原生测试。

@deepseek-ai/node-addon-system/flock 导出 tryLockExclusive(fd): Promise<void>。在调用完成前保持描述符打开。获取操作使用非阻塞独占 flock；竞争以 EAGAIN 或 EWOULDBLOCK 拒绝，关闭该打开文件描述的最后一个描述符即释放锁。参见入口 README。

导入任一入口都不会加载 addon。Landlock 可执行文件缺失时探测为不可用；flock 绑定缺失时拒绝获取。两条路径都不会编译或静默授予不受支持的行为。

Support

Linux x64/arm64 包包含静态 Landlock 可执行文件，以及分别用于 glibc/musl 的 system.node 文件。macOS x64/arm64 包仅包含 system.node。Landlock 还需要支持强制执行的 Linux 内核；Windows 使用 Harness 既有锁实现。支持矩阵 指定构建者与验证负责人。

Development

在本目录运行 pnpm build:ts 构建入口、pnpm build:native 构建当前宿主声明的原生产物、pnpm build:test-oracle 构建独立的 flock 系统调用 fixture。随后用 pnpm test 验证入口、锁、打包及可用的内核行为。Linux 完整构建需要 musl-gcc；macOS 使用 cc。根目录 pnpm run build:native-system 只构建源码测试所需的当前宿主 addon。

架构、打包和发布流程分别负责实现与发布细节。

Dev Note

无。