{"id":"754b8862-7422-49ef-8add-c2d0de736a9a","entityType":"agent","slug":"clawhub-hackerfish-fluxmount","name":"fluxmount","canonicalUrl":"https://www.xpersona.co/agent/clawhub-hackerfish-fluxmount","canonicalPath":"/agent/clawhub-hackerfish-fluxmount","generatedAt":"2026-10-10T10:43:34.871Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T04:08:32.367Z","emptyReason":null},"description":"FluxMount - 让 macOS 自由读写外接 NTFS 硬盘，傻瓜式、一次到位、插上即用、不再复发。当用户把 NTFS 格式的移动硬盘或 SSD 接到 Mac 却无法写入或复制文件、抱怨各种插件都传不进去、问 Mac 怎么往 NTFS 盘里写文件、或想要开机与热插拔自动可读写挂载时使用。覆盖国内网络典型坑（GitHub 被墙、Homebrew Tier-3 无预编译包、新版 Clang 编译报错、launchctl 弃用、沙箱禁 sudo），并提供一键安装、健康自检与干净卸载。作者 张昌宇 (Changyu Zhang)。 Skill: fluxmount Owner: hackerfish Summary: FluxMount - 让 macOS 自由读写外接 NTFS 硬盘，傻瓜式、一次到位、插上即用、不再复发。当用户把 NTFS 格式的移动硬盘或 SSD 接到 Mac 却无法写入或复制文件、抱怨各种插件都传不进去、问 Mac 怎么往 NTFS 盘里写文件、或想要开机与热插拔自动可读写挂载时使用。覆盖国内网络典型坑（GitHub 被墙、Homebrew Tier-3 无预编译包、新版 Clang 编译报错、launchctl 弃用、沙箱禁 sudo），并提供一键安装、健康自检与干净卸载。作者 张昌宇 (Changyu Zhang)。 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-12T14:25:04.319Z | auto Initial public release with ro","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s172536sk0armxcfrmad3xpq518442e9:fluxmount","sourceUrl":"https://clawhub.ai/hackerfish/fluxmount","homepage":"https://clawhub.ai/hackerfish/skills/fluxmount","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/hackerfish/fluxmount","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/hackerfish/skills/fluxmount","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":65,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"FluxMount - 让 macOS 自由读写外接 NTFS 硬盘，傻瓜式、一次到位、插上即用、不再复发。当用户把 NTFS 格式的移动硬盘或 SSD 接到 Mac 却无法写入或复制文件、抱怨各种插件都传不进去、问 Mac 怎么往 NTFS 盘里写文件、或想要开机与热插拔自动可读写挂载时使用。覆盖国内网络典型坑（Gi"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:08:32.367Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:08:32.367Z","emptyReason":null},"stars":null,"forks":null,"downloads":1701,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"1.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:08:32.367Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T04:08:32.367Z","lastCrawledAt":"2026-10-10T04:08:32.367Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T04:08:32.367Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-08-12T14:25:04.319Z","changelog":"Initial public release with robust NTFS read-write support for macOS: - Enables automatic, reliable NTFS read-write mounting—plug and use, no more copy failures. - One-step installation with full self-check, dry-run mode, and simple uninstall. - Handles major domestic network hurdles: GitHub/Formula access, Homebrew bottling issues, Clang build changes, and modern macOS launch agent system. - Safe and reversible: automatic backups, easy rollback, no disk data modification. - Multi-disk support with fail-safe retries and permission checks; minimizes recurring issues. - Detailed guides and troubleshooting included for smooth user experience.","fileCount":27,"zipByteSize":43620}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s172536sk0armxcfrmad3xpq518442e9:fluxmount","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hackerfish-fluxmount/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hackerfish-fluxmount/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hackerfish-fluxmount/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hackerfish-fluxmount/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hackerfish-fluxmount/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hackerfish-fluxmount/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T10:43:34.870Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hackerfish-fluxmount/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hackerfish-fluxmount/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hackerfish-fluxmount/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hackerfish-fluxmount/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T04:08:32.367Z","emptyReason":null},"readme":"Skill: fluxmount\n\nOwner: hackerfish\n\nSummary: FluxMount - 让 macOS 自由读写外接 NTFS 硬盘，傻瓜式、一次到位、插上即用、不再复发。当用户把 NTFS 格式的移动硬盘或 SSD 接到 Mac 却无法写入或复制文件、抱怨各种插件都传不进去、问 Mac 怎么往 NTFS 盘里写文件、或想要开机与热插拔自动可读写挂载时使用。覆盖国内网络典型坑（GitHub 被墙、Homebrew Tier-3 无预编译包、新版 Clang 编译报错、launchctl 弃用、沙箱禁 sudo），并提供一键安装、健康自检与干净卸载。作者 张昌宇 (Changyu Zhang)。\n\nTags: latest:0.1.0\n\nVersion history:\n\nv0.1.0 | 2026-08-12T14:25:04.319Z | auto\n\nInitial public release with robust NTFS read-write support for macOS:\n\n- Enables automatic, reliable NTFS read-write mounting—plug and use, no more copy failures.\n- One-step installation with full self-check, dry-run mode, and simple uninstall.\n- Handles major domestic network hurdles: GitHub/Formula access, Homebrew bottling issues, Clang build changes, and modern macOS launch agent system.\n- Safe and reversible: automatic backups, easy rollback, no disk data modification.\n- Multi-disk support with fail-safe retries and permission checks; minimizes recurring issues.\n- Detailed guides and troubleshooting included for smooth user experience.\n\nArchive index:\n\nArchive v0.1.0: 27 files, 43620 bytes\n\nFiles: .github (0b), .github/workflows (0b), .github/workflows/ci.yml (603b), .gitignore (336b), CONTRIBUTING.md (1261b), deploy (0b), DEPLOY.md (5675b), deploy/clawhub.sh (665b), deploy/qoder.sh (1376b), LICENSE (1082b), manifest.yaml (880b), ONBOARDING.md (5614b), PLATFORMS.md (7423b), PUBLISH.md (5602b), README.md (11772b), references (0b), references/troubleshooting.md (5456b), SAFETY.md (3099b), scripts (0b), scripts/doctor.sh (166b), scripts/install.sh (10917b), scripts/mount-ntfs-rw (5832b), scripts/ntfs-automount (768b), scripts/uninstall.sh (2502b), skill-card.md (2596b), SKILL.md (5744b), _meta.json (128b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: fluxmount\nversion: 1.0.0\ndescription: FluxMount - 让 macOS 自由读写外接 NTFS 硬盘，傻瓜式、一次到位、插上即用、不再复发。当用户把 NTFS 格式的移动硬盘或 SSD 接到 Mac 却无法写入或复制文件、抱怨各种插件都传不进去、问 Mac 怎么往 NTFS 盘里写文件、或想要开机与热插拔自动可读写挂载时使用。覆盖国内网络典型坑（GitHub 被墙、Homebrew Tier-3 无预编译包、新版 Clang 编译报错、launchctl 弃用、沙箱禁 sudo），并提供一键安装、健康自检与干净卸载。作者 张昌宇 (Changyu Zhang)。\nagent_created: true\n---\n\n# FluxMount (macOS NTFS Read-Write)\n\n让 Mac 自由读写外接 NTFS 硬盘。底层基于开源的 macFUSE + ntfs-3g，并配套开机与热插拔自动挂载，做到\"插上即用、不再复发\"。作者：**张昌宇 (Changyu Zhang)**，协议 MIT。\n\n## 什么时候用这个 skill\n\n- 用户把 NTFS 格式外接硬盘接到 Mac，能看不能写 / 复制失败 / 插件传不进文件。\n- 用户问\"Mac 怎么写 NTFS\"\"有没有免费 NTFS 工具\"\"能不能让盘自动可读写\"。\n- 用户已装过驱动但仍只读，需要排查（系统扩展未批准 / 免密 sudo 未配 / 代理未注册）。\n\n## 根因（务必先讲给用户听）\n\nmacOS 原生对 NTFS **只支持只读挂载**。无论用什么 App、插件、脚本，只要系统把它挂成只读，谁都写不进去。这不是插件不行，是系统层面锁了写权限。**解法不是找更强插件，而是用 ntfs-3g 把它重新挂成读写。** 用户盘里的数据不会被改动（我们只是重新挂载，不删不改任何文件）。\n\n## 工作流程\n\n### 1. 识别硬盘（只读命令，无需 sudo）\n\n```bash\ndiskutil list\nsystem_profiler SPStorageDataType | grep -iA6 ntfs\nmount | grep -i ntfs\n```\n\n确认磁盘节点（如 /dev/disk12s2）、卷名，以及它被 macOS 以 `(ntfs, ... read-only ...)` 只读挂载。\n\n### 2. 一键安装（用户本机终端运行）\n\n把 skill 的 scripts/ 目录复制到本机后运行：\n\n```bash\nbash install.sh            # 完整安装\nbash install.sh --doctor   # 只做健康检查，报告当前环境与问题\nbash install.sh --status   # 查看所有 NTFS 盘的可读写状态\nbash install.sh --dry-run  # 只打印将要做什么，不改动任何系统（先给安全感）\n```\n\ninstall.sh 会自动：检测系统 → 装 macFUSE（国内镜像兜底 GitHub 被墙）→ 装 ntfs-3g（用 `brew tap gromgit/homebrew-fuse` + `brew install ntfs-3g-mac`，规避 Homebrew Tier-3 无包）→ 部署脚本到 /usr/local/bin → 配置免密 sudo → 注册开机 + 热插拔自动挂载（LaunchAgent，现代 bootstrap 方式）→ 立即挂载一次。**安装前会自动备份被覆盖的文件到 ~/.fluxmount-backup，可随时回退。**\n\n> 注意：沙箱/远程环境通常禁止 sudo 与 launchctl 写操作，安装与批准系统扩展必须在用户**真实终端**完成，本 skill 负责生成脚本与指引，不会在你的电脑上做不可控的改动。\n\n### 3. 用户只需一次的人工步骤（每个 Mac 一次）\n\n1. 打开 系统设置 → 隐私与安全性\n2. 找到\"来自开发者 Benjamin Fleischer 的系统软件已被阻止\"，点【允许】\n3. 重启电脑\n4. 重启后插上 NTFS 盘，等 5~8 秒即自动可读写，无需再敲命令\n\n### 4. 验证\n\n```bash\nmount | grep macfuse              # 应看到 (macfuse, ... rw ...)\nbash install.sh --doctor          # 全绿即通过\n```\n\nFinder 里直接往盘里拖文件即可。用完安全弹出：`diskutil unmount /Volumes/<盘名>`。\n\n## 资源\n\n- `scripts/mount-ntfs-rw` — 核心挂载脚本（多盘、幂等、退避重试、写权限校验、`--dry-run`、`--status` 状态查询）\n- `scripts/ntfs-automount` — LaunchAgent 热插拔入口\n- `scripts/install.sh` — 傻瓜式一键安装 + doctor 自检 + dry-run 预览\n- `scripts/uninstall.sh` — 干净回滚（恢复安装前备份）\n- `references/troubleshooting.md` — 排障手册（吸收竞品经验 + 国内网络坑）\n- `README.md` — 面向 GitHub / SkillHub / ClawHub 的发布文档与竞品对比\n- `SAFETY.md` — 安全与可回退说明（明确本工具改什么、不动什么、如何还原）\n- `manifest.yaml` — OpenClaw / ClawHub 跨平台元数据\n\n## 本 skill 相对竞品的特色（作者沉淀）\n\n- **国内网络专治**：macFUSE 下载走 kgithub / ghproxy 多个国内镜像兜底；ntfs-3g 用 gromgit tap 的 `ntfs-3g-mac`（有预编译包），避开 Homebrew 对旧 macOS 的 Tier-3 无包与 GitHub 被墙。\n- **傻瓜式一次到位**：单命令安装 + doctor 自检 + dry-run 预览，把\"系统扩展批准 / 免密 sudo / 代理注册\"三件最容易翻车的事都自动化或半自动化。\n- **防复发**：开机（RunAtLoad）+ 热插拔（StartOnMount）双触发；幂等（已可读写则跳过，不干扰正在用的盘）；指数退避重试 + 写权限校验。\n- **多盘支持**：遍历所有只读 NTFS 分区逐个重挂载，挂回原卷名（Finder 名字不变）。\n- **安全可控**：免密 sudo 仅放行 `mount-ntfs-rw` 一条命令；安装前自动备份被覆盖文件，uninstall 可完整还原；**只重挂载、绝不删除或改动盘内数据**。\n\n> 踩坑经验（已固化到 troubleshooting.md）：GitHub 被墙用国内镜像；Homebrew `brew install ntfs-3g` 在 2026 年 macOS 15 Intel 上因 Tier-3 无 bottle 失败，应改 `ntfs-3g-mac`；新版 Xcode/Clang 把隐式函数声明当硬错误导致源码编译失败；`launchctl load` 在 macOS 15 已弃用，改用 `launchctl bootstrap gui/$(id -u)`；Bash 工具沙箱会禁 sudo/launchctl 写操作，验证需用户本机执行。\n\nFile v0.1.0:README.md\n\n# FluxMount — macOS NTFS Read-Write Toolkit\n\n> [中文](#中文) · [English](#english)\n>\n> 让 macOS 自由读写外接 NTFS 硬盘 —— 傻瓜式、一次到位、插上即用、不再复发。\n> Make macOS read & write external NTFS drives — one-shot setup, plug-and-use, never relapses.\n>\n> 作者 / Author: **张昌宇 (Changyu Zhang)** · 协议 / License: MIT\n\n---\n\n### 🔌 装前 vs 装后（Before / After）\n\n| | 🚫 装前（原生 macOS） | ✅ 装后（FluxMount） |\n|---|---|---|\n| 写入文件 | 弹出\"只读\"，无法复制 / 拖入 | 直接拖进去，像本地盘一样用 |\n| 传文件 | 各种插件、网盘都传不进去 | 即插即用，随意读写 |\n| 每次插盘 | 要敲命令重新挂载 | 自动可读写（开机 + 热插拔） |\n| 多盘 / 重名 | 易冲突、需手动处理 | 遍历挂载、保留原卷名 |\n| 安全性 | — | 只重挂载、不删数据、可一键回退 |\n\n> English: Before FluxMount, macOS mounts NTFS **read-only** — you can see the files but cannot write. After, your NTFS drive behaves like a native writable disk: plug in and drag files, auto-mount on boot & hotplug, fully reversible and safe.\n\n## 中文\n\n### 为什么需要它\n\nmacOS 原生对 NTFS 硬盘**只支持只读挂载**。你把 Windows 格式的 SSD / 移动硬盘插上 Mac，能看不能写，各种\"传输助手\"\"网盘插件\"都传不进去 —— **这不是插件不行，是系统锁了写权限**。\n\nFluxMount 用开源的 [macFUSE](https://github.com/macfuse/macfuse) + [ntfs-3g](https://github.com/tuxera/ntfs-3g) 把硬盘**重新挂载为可读写**，并配好开机 / 热插拔自动挂载，从此插上就能直接拖文件。\n\n### 一键安装\n\n```bash\nbash install.sh            # 完整安装（自动装驱动、部署脚本、配自动挂载）\nbash install.sh --doctor   # 只做健康检查，报告当前环境\nbash install.sh --status   # 查看所有 NTFS 盘的可读写状态\nbash install.sh --dry-run  # 只预览将要做什么，不改动任何系统\n```\n\n安装后只需**每个 Mac 一次**的人工操作：\n\n1. 系统设置 → 隐私与安全性 → 点【允许】\"Benjamin Fleischer\"的系统软件\n2. 重启\n3. 插上 NTFS 盘，等 5~8 秒，自动可读写，无需再敲命令\n\n用完安全弹出：`diskutil unmount /Volumes/<盘名>`\n\n### 傻瓜式 & 安全设计\n\n- **国内网络专治**：macFUSE 下载走 kgithub / ghproxy 多个国内镜像兜底；ntfs-3g 用 `brew tap gromgit/homebrew-fuse` + `brew install ntfs-3g-mac`（有预编译包），避开 Homebrew Tier-3 无包与 GitHub 被墙。\n- **一次到位**：单命令安装 + `doctor` 自检 + `dry-run` 预览，自动处理\"系统扩展批准 / 免密 sudo / 代理注册\"三件最易翻车的事。\n- **防复发**：开机（RunAtLoad）+ 热插拔（StartOnMount）双触发；幂等（已可读写则跳过，不干扰正在用的盘）；退避重试 + 写权限校验。\n- **多盘支持**：遍历所有只读 NTFS 分区逐个重挂载，挂回原卷名（Finder 名字不变）。\n- **安全可控、可回退**：免密 sudo 仅放行 `mount-ntfs-rw` 一条命令；**安装前自动备份被覆盖文件到 `~/.fluxmount-backup`**，`uninstall.sh` 可完整还原；**只重挂载、绝不删除或改动盘内数据**。详见 [SAFETY.md](SAFETY.md)。\n- **下载可信**：安装 macFUSE 前校验代码签名（`pkgutil --check-signature`），防止下载被篡改。\n\n### 竞品对比 & 我们的特色\n\n| 能力 | macos-ntfs-smart-mount | Nigate | NTFS Tool | Mounty | **FluxMount** |\n|------|:---:|:---:|:---:|:---:|:---:|\n| 免费开源 | ✅ | ✅ | ✅ | ✅ | ✅ |\n| macFUSE + ntfs-3g | ✅ | (封装) | ✅ | ❌(内置写) | ✅ |\n| 国内镜像兜底 GitHub 被墙 | ❌ | ⚠️(多CDN) | ❌ | ❌ | ✅ **专治** |\n| 规避 Homebrew Tier-3 无包 | ✅(ntfs-3g-mac) | — | ❌ | — | ✅ |\n| 开机 + 热插拔自动挂载 | ❌(手动) | ✅(GUI) | 🚧(路线图) | ✅ | ✅ |\n| 多盘支持 | ❌ | ⚠️ | ✅ | ❌ | ✅ |\n| 命令行无 GUI 依赖 | ✅ | ⚠️ | ❌ | ✅ | ✅ |\n| 健康检查 / 自检 | ❌ | ❌ | ❌ | ❌ | ✅ **doctor/status** |\n| dry-run 预览 | ❌ | ❌ | ❌ | ❌ | ✅ |\n| 干净卸载 / 可回退 | ❌ | ⚠️ | ❌ | ❌ | ✅ **备份还原** |\n| 下载签名校验 | ❌ | ❌ | ❌ | ❌ | ✅ **独有** |\n| 中文文档 / 品牌 | ✅ | ✅ | ✅ | ✅ | ✅ **张昌宇出品** |\n\n> 我们吸收并改进了竞品优点：smart-mount 的 `ntfs-3g-mac` 正确装法与中英文档、Nigate 的多 CDN 镜像与热插拔、NTFS Tool 的退避重试与多盘处理；并补齐了它们都忽略的**国内网络适配、免密 sudo、代理注册、自检、dry-run、下载签名校验与可回退卸载**。\n\n### 文件结构\n\n```\nfluxmount/\n├── SKILL.md                 # WorkBuddy skill 入口\n├── README.md                # 本文件（中/英双语）\n├── SAFETY.md                # 安全与可回退说明\n├── manifest.yaml            # OpenClaw / ClawHub 跨平台元数据\n├── LICENSE                  # MIT (张昌宇)\n├── scripts/\n│   ├── mount-ntfs-rw        # 核心挂载(多盘/幂等/退避/校验/dry-run/status)\n│   ├── ntfs-automount       # LaunchAgent 热插拔入口\n│   ├── install.sh           # 傻瓜式一键安装 + doctor + status + dry-run\n│   ├── uninstall.sh         # 干净回滚(仅回退自己的盘 + 恢复安装前备份)\n│   └── doctor.sh            # 健康检查入口\n└── references/\n    └── troubleshooting.md   # 排障手册(含踩坑与竞品经验)\n```\n\n### 跨平台发布指南\n\nFluxMount 的核心脚本是 POSIX bash，可在任何 macOS 终端运行；元数据按多平台格式提供：\n\n- **WorkBuddy / SkillHub**：直接发布本目录（含 `SKILL.md`），或导入 `fluxmount.zip`。\n- **ClawHub / OpenClaw**：使用 `manifest.yaml` 元数据，发布命令参考 `clawhub publish ./fluxmount --slug fluxmount --name \"FluxMount\" --version 1.0.0`。\n- **GitHub / Gitee**：整仓库推送即可，README 即项目主页；建议打 `fluxmount` 主题标签（macos, ntfs, macfuse, ntfs-3g, automation）。\n\n### 声明\n\n挂载 / 修改磁盘有极低概率的数据风险，本工具按现状提供，作者不对任何数据损失负责。重要数据请先备份。NTFS 驱动底层依赖 macFUSE 与 ntfs-3g 的开源项目，版权归各自作者。\n\n由 张昌宇 (Changyu Zhang) 出品 · FluxMount\n\n---\n\n## English\n\n### Why you need it\n\nmacOS mounts NTFS external drives **read-only by default**. Plug a Windows-formatted SSD / USB disk into a Mac and you can see files but cannot write — and no \"transfer assistant\" or cloud-plugin can help, **because the OS itself locks write access**, not the apps.\n\nFluxMount remounts the disk **read-write** using the open-source [macFUSE](https://github.com/macfuse/macfuse) + [ntfs-3g](https://github.com/tuxera/ntfs-3g), and wires up auto-mount on boot and hot-plug, so you can just drag files in after plugging in.\n\n### One-shot install\n\n```bash\nbash install.sh            # full install (driver + scripts + auto-mount)\nbash install.sh --doctor   # health check, report current environment\nbash install.sh --status   # show read/write status of all NTFS disks\nbash install.sh --dry-run  # preview only, change nothing\n```\n\nAfter install, one manual step **per Mac**:\n\n1. System Settings → Privacy & Security → click **Allow** for \"Benjamin Fleischer\" system software\n2. Reboot\n3. Plug in the NTFS disk, wait 5–8s, it auto-mounts read-write — no more commands\n\nEject safely: `diskutil unmount /Volumes/<disk>`\n\n### Foolproof & safe by design\n\n- **China-network friendly**: macFUSE is downloaded via kgithub / ghproxy mirrors; ntfs-3g uses `brew tap gromgit/homebrew-fuse` + `brew install ntfs-3g-mac` (prebuilt bottle), avoiding Homebrew Tier-3 no-bottle and GitHub blocking.\n- **One-shot**: single command + `doctor` self-check + `dry-run` preview; auto-handles the three fragile steps (system-extension approval / passwordless sudo / agent registration).\n- **No relapse**: dual trigger (RunAtLoad + StartOnMount); idempotent (skips already read-write disks); retry with backoff + write-permission check.\n- **Multi-disk**: remounts every read-only NTFS partition, keeping the original volume name in Finder.\n- **Safe & reversible**: passwordless sudo grants only the `mount-ntfs-rw` command; **backs up overwritten files to `~/.fluxmount-backup` before install**; `uninstall.sh` fully restores; **only remounts — never deletes or alters your data**. See [SAFETY.md](SAFETY.md).\n- **Trustworthy download**: verifies the macFUSE installer signature (`pkgutil --check-signature`) before installing.\n\n### Comparison & our edge\n\n| Capability | macos-ntfs-smart-mount | Nigate | NTFS Tool | Mounty | **FluxMount** |\n|------|:---:|:---:|:---:|:---:|:---:|\n| Free & open source | ✅ | ✅ | ✅ | ✅ | ✅ |\n| macFUSE + ntfs-3g | ✅ | (wrapped) | ✅ | ❌(native) | ✅ |\n| China mirror (GitHub blocked) | ❌ | ⚠️(multi-CDN) | ❌ | ❌ | ✅ **dedicated** |\n| Avoid Homebrew Tier-3 no-bottle | ✅(ntfs-3g-mac) | — | ❌ | — | ✅ |\n| Boot + hot-plug auto-mount | ❌(manual) | ✅(GUI) | 🚧(roadmap) | ✅ | ✅ |\n| Multi-disk | ❌ | ⚠️ | ✅ | ❌ | ✅ |\n| No GUI dependency | ✅ | ⚠️ | ❌ | ✅ | ✅ |\n| Health check / self-test | ❌ | ❌ | ❌ | ❌ | ✅ **doctor/status** |\n| dry-run preview | ❌ | ❌ | ❌ | ❌ | ✅ |\n| Clean uninstall / rollback | ❌ | ⚠️ | ❌ | ❌ | ✅ **backup restore** |\n| Download signature check | ❌ | ❌ | ❌ | ❌ | ✅ **unique** |\n| Chinese docs / branding | ✅ | ✅ | ✅ | ✅ | ✅ **by Changyu Zhang** |\n\n> We absorbed and improved on competitors: smart-mount's correct `ntfs-3g-mac` install and docs, Nigate's multi-CDN mirrors and hot-plug, NTFS Tool's backoff-retry and multi-disk handling — then added what all of them miss: **China-network support, passwordless sudo, agent registration, self-check, dry-run, signature verification, and reversible uninstall**.\n\n### File structure\n\n```\nfluxmount/\n├── SKILL.md                 # WorkBuddy skill entry\n├── README.md                # this file (zh/en)\n├── SAFETY.md                # safety & rollback notes\n├── manifest.yaml            # OpenClaw / ClawHub cross-platform metadata\n├── LICENSE                  # MIT (Changyu Zhang)\n├── scripts/\n│   ├── mount-ntfs-rw        # core remount (multi-disk/idempotent/retry/check/dry-run/status)\n│   ├── ntfs-automount       # LaunchAgent hot-plug entry\n│   ├── install.sh           # one-shot install + doctor + status + dry-run\n│   ├── uninstall.sh         # clean rollback (only our disks + restore backup)\n│   └── doctor.sh            # health-check entry\n└── references/\n    └── troubleshooting.md   # troubleshooting (pitfalls + competitor notes)\n```\n\n### Cross-platform publishing\n\nCore scripts are POSIX bash and run in any macOS terminal; metadata ships in multi-platform formats:\n\n- **WorkBuddy / SkillHub**: publish this directory (with `SKILL.md`) or import `fluxmount.zip`.\n- **ClawHub / OpenClaw**: use `manifest.yaml`; e.g. `clawhub publish ./fluxmount --slug fluxmount --name \"FluxMount\" --version 1.0.0`.\n- **GitHub / Gitee**: push the whole repo; README is the project homepage. Suggest topics: `macos`, `ntfs`, `macfuse`, `ntfs-3g`, `automation`.\n\n### Disclaimer\n\nMounting / modifying disks carries a very low risk of data loss. Provided as-is, no warranty. Back up important data first. The NTFS driver relies on the open-source macFUSE and ntfs-3g projects, copyright their respective authors.\n\nBy 张昌宇 (Changyu Zhang) · FluxMount\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn7f38j0904t7yjceyfzjnbs31844zv9\",\n  \"slug\": \"fluxmount\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786544704319\n}\n\nFile v0.1.0:references/troubleshooting.md\n\n# FluxMount · 排障手册\n\n作者: 张昌宇 (Changyu Zhang)\n本手册固化了真实踩坑经验，并吸收了社区竞品（macos-ntfs-smart-mount / Nigate / NTFS Tool / Mounty）的做法与已知限制。\n\n---\n\n## 一、根因速记\n\n- macOS 原生 **NTFS 只读挂载**，任何 App/插件/脚本都无法写入 —— 不是插件问题，是系统锁了写权限。\n- 解法 = 用 **ntfs-3g**（经 macFUSE 的 FUSE 接口）把分区**重新挂载为读写**。这一步**不删不改**盘内任何数据，只是换个挂载方式。\n\n## 二、安装阶段典型坑\n\n### 1. macFUSE 下载被墙（GitHub 连接重置）\n\n- 现象: `curl: (56) Recv failure: Connection reset by peer`，下到 ~5MB 中断。\n- 根因: 国内直连 GitHub release 不稳定。\n- 解法: install.sh 已内置 kgithub / ghproxy 系列**国内镜像兜底**，会自动换源重试。若仍失败，开代理/VPN 手动下载 `macfuse-5.3.3.dmg` 双击安装后重跑。\n\n### 2. Homebrew `brew install ntfs-3g` 报错 no bottle / Tier 3\n\n- 现象: `Error: ntfs-3g: no bottle available!` + `Tier 3 configuration`。\n- 根因: 2026 年 macOS 15（尤其 Intel）被 Homebrew 归为 Tier-3 旧系统，不再提供预编译 ntfs-3g bottle；`--build-from-source` 又要从 GitHub 拉源码（被墙）。\n- **正确解法（关键）**: 用 `brew tap gromgit/homebrew-fuse` 后 `brew install ntfs-3g-mac`。该 tap 专为 macOS 维护，提供可用预编译包。这也是 macos-ntfs-smart-mount 的做法。\n- 反例: 不要走 `--build-from-source`，新版 Xcode/Clang 会把老 C 代码的隐式函数声明、重复全局符号当**硬错误**（`1 warning and 1 error generated`），需额外加 `-Wno-implicit-function-declaration -fcommon` 仍可能失败。\n\n### 3. 目录权限 not writable\n\n- 现象: `Error: The following directories are not writable by your user: /usr/local/share/man/man8`\n- 解法: `sudo chown -R $USER /usr/local/share/man/man8 && chmod u+w /usr/local/share/man/man8`，再重跑。\n\n### 4. Homebrew 自动更新卡死\n\n- 现象: 卡在 `Auto-updating Homebrew...` 假死。\n- 解法: Ctrl+C 取消，重跑时带 `HOMEBREW_NO_AUTO_UPDATE=1`（install.sh 已内置）。\n\n## 三、挂载阶段典型坑\n\n### 5. 系统扩展未批准（最常见）\n\n- 现象: 挂载报 `fusefs: failed to mount` / `FUSE cannot be used` / 盘停在只读的\"新加卷\"。\n- 解法: 系统设置 → 隐私与安全性 → 点【允许】\"Benjamin Fleischer\"的系统软件 → **重启** → 重跑 `sudo mount-ntfs-rw`。\n- 竞品提示: 部分旧教程让你进恢复模式改\"降低安全性/允许内核扩展\"——那是 **macFUSE 4.x (kext) 的做法**；macFUSE 5.x 用的是 **System Extension**，无需进恢复模式，只需在隐私与安全性里点允许。\n\n### 6. \"xxx 想访问可移除宗卷上的文件\"弹窗\n\n- 这是 macOS 的**访问权限**询问（不是删除！），点【允许】即可。我们的脚本不执行任何删除命令，只是卸载只读挂载 + 重新挂载。\n\n### 7. 热插拔不自动挂载\n\n- 多为后台弹了\"访问可移除宗卷\"权限框但无前台窗口看不到。去 系统设置 → 隐私与安全性 → 完全磁盘访问权限，把以下三个加进去，再拔插一次:\n  - `/usr/local/bin/ntfs-automount`\n  - `/usr/local/bin/mount-ntfs-rw`\n  - `/usr/local/bin/ntfs-3g`\n- 其次检查代理是否真注册: `launchctl print gui/$(id -u)/com.changyu.fluxmount` 应存在且 `runs>0`。\n\n### 8. `launchctl load` 在 macOS 15 失效\n\n- 现象: `launchctl list` 查不到、`launchctl load` 报 Input/output error。\n- 根因: macOS 15 (Sequoia) 已弃用 `launchctl load`，且远程/沙箱环境会拦截写类 launchctl。\n- 解法: 用现代方式 `launchctl bootout gui/$(id -u)/LABEL` 再 `launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/xxx.plist`，且**必须在图形登录会话的真实终端**执行（WorkBuddy 沙箱内的 Bash 无法替你注册）。\n\n### 9. Windows 快速启动导致挂载失败\n\n- 来源: Nigate 的已知提示。若 NTFS 盘来自未彻底关机的 Windows（快速启动开启），可能挂载异常。需在 Windows 端彻底关机或关闭快速启动。\n\n## 四、竞品经验借鉴（已吸收进本 skill）\n\n- **macos-ntfs-smart-mount**: `gromgit/homebrew-fuse` + `ntfs-3g-mac` 的正确装法；安全弹出时杀掉 Spotlight/QuickLook 防止卸载卡死；中英双语文档。\n- **Nigate**: 多 CDN 镜像（jsDelivr/statically）兜底 GitHub 被墙；GUI 实时监测 + 热插拔自动读写；多语言。\n- **NTFS Tool**: 指数退避重试（5/10/20/60s）、防抖监测、孤立挂载目录清理、每盘失败追踪、ExFAT 免 sudo。\n- **Mounty**: 用 macOS 内置实验性 NTFS 写（免 ntfs-3g），但苹果官方标注不稳定、有数据风险，本 skill 不采用。\n\n## 五、自检、预览与卸载（安全可控）\n\n- 健康检查: `bash install.sh --doctor`（报告 macFUSE / ntfs-3g / 脚本 / 免密 sudo / 代理 / 当前挂载 全绿即通过）。\n- 改动预览: `bash install.sh --dry-run`（只打印将写入的路径，不改动任何系统）。\n- 干净卸载/回退: `bash uninstall.sh`（移除代理、免密 sudo 规则、脚本；若 `~/.fluxmount-backup` 有安装前备份则还原；不动 macFUSE/ntfs-3g 本体）。\n- 安全边界详见仓库根目录 `SAFETY.md`：本工具只重挂载、绝不删除或改动盘内数据。\n\n由 张昌宇 (Changyu Zhang) 出品 · FluxMount\n\nFile v0.1.0:CONTRIBUTING.md\n\n# 贡献指南 (Contributing)\n\n感谢你关注 **FluxMount**！这是一个面向 macOS 用户的 NTFS 读写技能，目标是\"傻瓜式、一次到位、插上即用、不再复发\"。\n\n## 开发约定\n\n- **语言**：所有脚本为 POSIX / Bash，目标在 macOS 12+ 运行。\n- **风格**：函数式拆解、清晰注释、错误信息用中文（面向最终用户）。\n- **安全**：任何会改动系统的操作前，必须支持 `--dry-run` 预览；卸载必须可还原。\n- **幂等**：脚本重复执行不应造成副作用（已可读写则跳过）。\n\n## 本地测试\n\n```bash\n# 语法检查（CI 也会跑）\nfor f in scripts/*.sh; do bash -n \"$f\"; done\n\n# 静态检查（可选，需 brew install shellcheck）\nshellcheck scripts/*.sh\n\n# 只读预览（不改任何系统）\nbash scripts/install.sh --dry-run\n\n# 健康检查\nbash scripts/install.sh --doctor\n```\n\n## 提交 Issue / PR\n\n- **Bug**：请附上 `bash scripts/install.sh --doctor` 的输出、macOS 版本、芯片类型（Intel / Apple Silicon）。\n- **新功能**：先开 Issue 讨论，避免重复劳动。\n- **PR**：请保持小而专注，并确认本地测试通过。\n\n## 许可证\n\n本项目以 MIT 协议发布，版权归 **张昌宇 (Changyu Zhang)** 所有。\n\nFile v0.1.0:DEPLOY.md\n\n# FluxMount 多平台发布手册（实测命令）\n\n本文件给出的命令均来自各平台官方文档/实测，**直接照抄即可**。所有操作只在你自己的账号下进行，不影响任何机器配置。\n\n> 仓库已公开：`https://github.com/hackerFish/fluxmount`  \n> 作者署名：`张昌宇 <476929948@qq.com>`\n\n---\n\n## 1. ClawHub（发布一次，让所有兼容 Agent Skills 的桌面 agent 都能安装）\n\n> 注意：ClawHub 是 OpenClaw 生态的官方市场。发布后兼容 Agent Skills 的桌面 agent 能 `clawhub install` 装到，但**不会自动**同步到 WorkBuddy SkillHub / Qoder / 扣子这些独立市场——它们需你另外提交（见文末发布顺序）。腾讯 SkillHub 作为 ClawHub 国内镜像，很可能自动收录，使 WorkBuddy 用户也能搜到。\n\nClawHub 是 OpenClaw 生态的公开技能 registry，发布后 `clawhub install @hackerFish/fluxmount` 或 `openclaw skills install @hackerFish/fluxmount` 即可安装。\n\n### 步骤\n\n```bash\n# ① 安装 CLI（任选其一）\nnpm i -g clawhub            # 或 pnpm add -g clawhub\n\n# ② 登录（用你的 GitHub 账号 OAuth；账号需注册满约 1 周/7 天以上，否则过不了上传门槛）\nclawhub login\n\n# ③ 预览发布（强烈建议先 dry-run，检查元数据与文件规范，不上传）\nclawhub skill publish . --dry-run\n\n# ④ 正式发布（在仓库根目录执行，仓库根已有 SKILL.md）\nclawhub skill publish . \\\n  --slug fluxmount \\\n  --name \"FluxMount\" \\\n  --version 1.0.0 \\\n  --changelog \"首版发布：macOS NTFS 读写、插上即用、开机与热插拔自动挂载、安全可回退、国内网络加固\" \\\n  --tags \"ntfs,macos,macfuse,ntfs-3g,filesystem,skill,agent-skills,external-drive,read-write\"\n```\n\n也可用网页端：访问 `https://clawhub.ai/skills/publish` 直接上传整个仓库文件夹。\n\n也可以用仓库内封装脚本：`./deploy/clawhub.sh`（需先 `clawhub login`）。\n\n### 发布后管理\n\n```bash\nclawhub whoami                                   # 查看当前身份\nclawhub skill publish . --version 1.1.0 --changelog \"修复触发词匹配\"   # 更新版本\nclawhub list                                      # 已安装列表\n```\n\n> ClawHub 会跑自动安全检查，新版本可能短暂不出现在公开目录，直到审核完成——属正常。\n\n---\n\n## 2. Qoder（以 .zip 上传自定义 Skill）\n\nQoder 通过 API 上传 zip。**注意**：Qoder Cloud 是纯云端，没有你的物理外接硬盘，挂载动作无法在云端真正执行；上传仅用于跨平台技能收录/展示。在 Qoder 桌面端 / 本地形态下才能真挂载。\n\n### 步骤\n\n生成 Qoder 专用 zip（仓库内脚本会自动重新打包，SKILL.md 位于 `fluxmount/` 一级子目录，符合要求）：\n\n```bash\nQODER_PAT=你的Qoder令牌 ./deploy/qoder.sh\n```\n\n或手动上传（zip 已就绪于 `/Users/matiansa/cy/c/fluxmount-qoder.zip`）：\n\n```bash\ncurl -X POST \"https://api.qoder.com/api/v1/cloud/skills\" \\\n  -H \"Authorization: Bearer $QODER_PAT\" \\\n  -F \"name=fluxmount\" \\\n  -F \"type=custom\" \\\n  -F \"description=FluxMount - macOS NTFS read-write skill by Changyu Zhang\" \\\n  -F \"file=@fluxmount-qoder.zip\"\n```\n\n- 端点：`https://api.qoder.com/api/v1/cloud/skills`（阿里云版为 `https://api.qoder.com.cn/api/v1/cloud/skills`）\n- 成功返回 `201 Created`，含 `id`（如 `skill_019e...`）。\n- 绑定到 Agent（可选）：\n  ```bash\n  curl -X PUT \"https://api.qoder.com/api/v1/cloud/agents/agent_你的ID\" \\\n    -H \"Authorization: Bearer $QODER_PAT\" -H \"Content-Type: application/json\" \\\n    -d '{\"version\":1,\"skills\":[{\"type\":\"custom\",\"skill_id\":\"skill_你的ID\"}]}'\n  ```\n- 版本更新：重新打包改名 `fluxmount-v2.zip` 再 POST 一次即可（服务端版本自增）。\n\n---\n\n## 3. GitHub Topics（提升可被搜索/发现概率）\n\n在 `https://github.com/hackerFish/fluxmount` 页面右侧「About → ⚙️ → Topics」中点加，粘贴以下标签（每行一个，回车添加）：\n\n```\nntfs\nmacos\nmacfuse\nntfs-3g\nfilesystem\nagent-skills\nclaude-skills\nskill\nexternal-drive\nhard-drive\nread-write\nmount\nautomation\nchina\nhackintosh\n```\n\n也可用 API 一次性设置（需带你的 GitHub PAT）：\n\n```bash\ncurl -X PUT \"https://api.github.com/repos/hackerFish/fluxmount/topics\" \\\n  -H \"Authorization: Bearer $GITHUB_TOKEN\" \\\n  -H \"Accept: application/vnd.github+json\" \\\n  -d '{\"names\":[\"ntfs\",\"macos\",\"macfuse\",\"ntfs-3g\",\"filesystem\",\"agent-skills\",\"claude-skills\",\"skill\",\"external-drive\",\"hard-drive\",\"read-write\",\"mount\",\"automation\",\"china\",\"hackintosh\"]}'\n```\n\n---\n\n## 4. SkillHub / WorkBuddy（用户侧自动加载，无需你额外发布）\n\n用户只需把 `fluxmount/` 文件夹放到：\n\n- 用户级：`~/.workbuddy/skills/fluxmount/`\n- 项目级：`{工程}/.workbuddy/skills/fluxmount/`\n\nWorkBuddy 启动扫描 `SKILL.md` 的 `description` 触发词即可调用。若想上架 WorkBuddy 技能市场，按 WorkBuddy 官方「推荐市场」提交入口提交仓库地址即可（manifest.yaml 已带好元数据）。\n\n---\n\n## 5. 扣子 Coze（本地 Skill 模式）\n\n网页/云端 bot 无法执行本地挂载，仅「本地部署 / 本地 Skill」形态可用。发布方式：在 Coze 的「技能」→「本地技能」中挂载仓库目录，或按 Coze 官方本地 Skill 规范上传。详见 `PLATFORMS.md`。\n\n---\n\n## 发布顺序建议\n\n1. **GitHub**（已完成，已公开）\n2. **ClawHub**（发布一次，Agent-Skills 兼容的桌面 agent 都能装；SkillHub 多同步收录，杠杆最高）\n3. **Qoder**（补全跨平台收录）\n4. **GitHub Topics**（顺手提高可发现性）\n5. **SkillHub / 扣子**（按需）\n\nFile v0.1.0:ONBOARDING.md\n\n# FluxMount 上架清单（傻瓜版）\n\n作者：张昌宇 (Changyu Zhang) · GitHub: [@hackerFish](https://github.com/hackerFish)\n邮箱：476929948@qq.com\n\n本文件给你一步步照着做即可。⚠️ 凡标注「在你自己的电脑上执行」的步骤，都**不要**在别人的机器/沙箱里跑——尤其涉及 `git push` 和账号登录。\n\n---\n\n## 0. 先决条件（一次搞定）\n\n1. 在你自己的电脑上登录 GitHub 网页 → 进入 **Settings → Emails**，确认 `476929948@qq.com` 已验证（否则 commit 不会挂到你账号下，显示灰色未关联）。\n2. 在 GitHub 新建一个**空仓库**，名字叫 `fluxmount`，**不要**勾选自动生成 README（保持空仓库）。\n3. 本机装好 `git`，并登录 `gh`（`brew install gh` 后执行 `gh auth login`，选 GitHub.com、HTTPS、按提示浏览器授权）。\n\n---\n\n## 1. 推到 GitHub（在你自己电脑的终端执行）\n\n> 仓库已在 `/Users/matiansa/cy/c/FluxMount/` 完成 `git init` 与 3 个 commit，作者已写成你。把下面命令复制到**你登录了 GitHub 的终端**执行：\n\n```bash\ncd FluxMount\ngit branch -M main\ngit remote add origin https://github.com/hackerFish/fluxmount.git\ngit push -u origin main\n```\n\n推完去 `https://github.com/hackerFish/fluxmount` 看一眼，应能看到 SKILL.md、README.md、scripts/ 等全部文件，且 commit 作者是「张昌宇」。\n\n---\n\n## 2. ClawHub 上架（覆盖所有兼容 Agent Skills 的桌面 agent）\n\nClawHub 是跨平台技能市场，**一次发布**即可让 OpenClaw、Claude Desktop 等所有兼容 Agent Skills 的本地 agent 装上。\n\n- 方式 A（推荐）：在支持 `clawhub` 的终端直接\n  ```bash\n  clawhub publish ./FluxMount        # 或按平台提示指向上面的 GitHub 仓库\n  ```\n- 方式 B：打开 ClawHub 官网 → 提交 GitHub 仓库地址 `https://github.com/hackerFish/fluxmount` → 填名称/简介（可直接复用 `manifest.yaml` 内容）→ 提交审核。\n- 用户侧安装（给你做宣传用）：\n  ```bash\n  clawhub install fluxmount\n  # 或\n  npx skills add hackerFish/fluxmount\n  ```\n\n---\n\n## 3. SkillHub / WorkBuddy 上架\n\nWorkBuddy 用户既可以直接放目录用，也可以上架 SkillHub 市场被搜索到。\n\n- **直接可用（无需上架）**：用户把文件夹放到\n  - 用户级：`~/.workbuddy/skills/fluxmount/`\n  - 项目级：`{工程}/.workbuddy/skills/fluxmount/`\n  WorkBuddy 启动即扫描 `SKILL.md`，靠 `description` 触发。\n- **上架市场**：打开 WorkBuddy → 技能/推荐市场 → 发布技能 → 选择本地 `FluxMount` 目录或填写 GitHub 地址 `https://github.com/hackerFish/fluxmount` → 提交。上架后用户说「帮我装个能读写 NTFS 硬盘的技能」即可自动匹配安装。\n\n---\n\n## 4. Qoder 上架（上传 zip）\n\nQoder 接受 `.zip` 格式的技能包。我们已经打好 **`fluxmount-qoder.zip`**（标准 `fluxmount/` 包裹结构）。\n\n- **方式 A（界面上传，推荐）**：\n  1. 打开 Qoder → Settings / Skills（或 `管理技能`）→ 导入技能 / Import Skill。\n  2. 选择「从 zip 导入」→ 选中 `fluxmount-qoder.zip`。\n  3. 确认技能名 `fluxmount`、触发描述无误 → 启用。\n  4. 在 QoderWork / 桌面版里对 NTFS 磁盘说「帮我挂载这个 NTFS 硬盘可读写」即可执行。\n- **方式 B（API，CI 用）**：\n  ```bash\n  curl -X POST https://<你的Qoder域名>/api/v1/cloud/skills \\\n    -H \"Authorization: Bearer $QODER_TOKEN\" \\\n    -F \"file=@fluxmount-qoder.zip\"\n  ```\n- ⚠️ **纯云端 Qoder Cloud 跑不了本地挂载**（云端没有你的物理硬盘），需用 QoderWork / 桌面版，或当作「知识/流程型技能」教用户怎么做。\n\n目录形态（开发者手动放）：`.qoder/skills/fluxmount/`，把 `fluxmount/` 目录内容放进去即可。\n\n---\n\n## 5. 扣子 Coze 上架（本地 Skill 模式）\n\n扣子网页版/云端 bot **无法执行本地 bash 挂载**（云端无你的硬盘）。请用「本地 Skill」形态：\n\n- 本地部署的 Coze / 支持挂载 skills 目录的环境：把 `fluxmount/` 目录放到 Coze 的 skills 挂载目录（参考其文档的 `skills/<name>/SKILL.md` 约定），重启即生效。\n- 技能商店 `coze.cn/skills`：提交时选「本地技能 / Local Skill」类型，填写 GitHub 地址 `https://github.com/hackerFish/fluxmount`，简介复用 `manifest.yaml`。\n- 网页版用户得到的是「指引型技能」（告诉用户怎么做），而非自动挂载——这是所有动本地硬件技能的共性限制。\n\n---\n\n## 6. 发布后：怎么看调用次数和反馈\n\n- **平台后台**：ClawHub / SkillHub / Qoder / Coze 上架后，作者控制台会显示安装量、Star、用户反馈。\n- **GitHub（免费实时最直观）**：\n  - 仓库 **Insights → Traffic**：页面访问量、克隆量（最接近「被多少人下载」）。\n  - **Stars / Forks / Issues / Discussions**：反馈主渠道。建议在仓库开启 **Discussions**（Settings → Features → 勾选 Discussions）。\n- **本地私有使用无逐次计数**：FluxMount 刻意**不做内建埋点/联网上报**，守住「安全可控、不偷传数据」的底线。要看「被广泛使用」的证据，以平台后台 + GitHub Insights 为准。\n\n---\n\n## 7. 发布顺序建议（杠杆最高）\n\n1. **GitHub 先推** → 2. **ClawHub**（一次覆盖所有桌面 agent）→ 3. **SkillHub/WorkBuddy** → 4. **Qoder 上传 zip** → 5. **扣子本地 Skill**。\n发完后补一段「装前只读 vs 装后直接拖文件」的对比动图到 README 顶部，最能拉 star。\n\nFile v0.1.0:PLATFORMS.md\n\n# 跨平台发布矩阵 (Cross-Platform Matrix)\n\n> 结论先行：**WorkBuddy、OpenClaw、Qoder、扣子(Coze) 都采用同一套 Anthropic「Agent Skills」开放标准**——核心就是一个\"含 `SKILL.md` 的文件夹 + `name`/`description` frontmatter\"。\n> 所以 FluxMount **不用为每家重写**。差异只在三件事：**① 放到哪个目录 ② 怎么发布/安装 ③ 云端平台能不能跑本地 bash**。\n\n> ⚠️ **重要澄清（易误解）**：ClawHub 是 **OpenClaw 生态的官方市场**，**不是**\"发一次就自动铺满所有平台\"。同一份文件夹虽然能分别提交到各家，但 ClawHub / SkillHub / Qoder / 扣子 是**相互独立的提交入口**，每家要各交一次。ClawHub 的\"一处发布、多处可用\"只成立在**安装侧**（兼容 Agent Skills 的桌面 agent 都能 `clawhub install`），并不代表技能会自动出现在 WorkBuddy SkillHub、Qoder、扣子的市场上。\n\n作者：张昌宇 (Changyu Zhang) · MIT\n\n---\n\n## 一、为什么能跨平台\n\n| 平台 | 技能格式 | 核心文件 | 触发方式 |\n|------|----------|----------|----------|\n| WorkBuddy / SkillHub | Agent Skills | `SKILL.md` + 目录 | 自然语言命中 `description` |\n| OpenClaw / ClawHub | Agent Skills | `SKILL.md` + 目录 | 同上 |\n| Qoder (阿里/灵码) | Agent Skills | `SKILL.md` + 目录（`.zip` 上传） | 同上 |\n| 扣子 Coze | Agent Skills | `SKILL.md` + `scripts/references/assets/` | 同上 |\n\n四家 frontmatter 都认 `name` / `description`；Qoder 额外要求 `version`（本仓库已补 `version: 1.0.0`）。未知字段（如 WorkBuddy 的 `agent_created: true`）其他平台会自动忽略，**安全**。\n\n> FluxMount 已经是标准格式，直接复用即可，无需改写指令正文，只按平台选\"投放位置/发布方式\"。\n\n---\n\n## 二、各平台如何让用户用上 FluxMount\n\n### 1. WorkBuddy（桌面端，跑在用户本机）\n- **直接放目录**（用户级，全项目可用）：`~/.workbuddy/skills/fluxmount/`\n- **项目级**（仅团队工程）：`{工程}/.workbuddy/skills/fluxmount/`\n- 重启 WorkBuddy 即自动加载，对话说\"Mac 怎么写 NTFS\"即可触发。\n- **上架市场**：推 GitHub 后提交到 SkillHub / ClawHub，用户市场内一键装。\n\n### 2. OpenClaw / ClawHub（开源本地 Agent 框架）\n- **放目录**：`~/.openclaw/workspace/skills/fluxmount/`\n- **通用目录（推荐，各家 AI 编程工具都能识别）**：`~/.agents/skills/fluxmount/`\n- **ClawHub 命令行**：\n  ```bash\n  npm i -g clawhub\n  clawhub install fluxmount            # 若已上架 ClawHub\n  # 或直接从 GitHub 装（Vercel 提供的 npx 方式）：\n  npx skills add https://github.com/hackerFish/fluxmount --skill fluxmount\n  ```\n- ClawHub 是 **OpenClaw 生态的官方技能市场**：发布后，所有兼容 Agent Skills 的桌面 agent（OpenClaw、Claude Desktop、DeerFlow 等）都能 `clawhub install` 装到 —— **这是\"一处发布、多处可用\"在\"安装侧\"的最高杠杆**。但要注意：它**不会自动**把技能同步到 WorkBuddy SkillHub、Qoder、扣子这些**独立市场**，那些仍需你分别提交（见下方发布顺序）。\n\n### 3. Qoder（阿里 / 通义灵码，Qoder / QoderWork / Qoder CLI）\n- **项目级目录**：`.qoder/skills/fluxmount/SKILL.md`（结构同本仓库）\n- **上传到 Qoder Cloud Agents（API）**：\n  ```bash\n  cd FluxMount && zip -r ../fluxmount.zip . -x '.git/*'\n  curl -X POST \"https://api.qoder.com.cn/api/v1/cloud/skills\" \\\n    -H \"Authorization: Bearer $QODER_PAT\" \\\n    -F \"file=@../fluxmount.zip\"\n  ```\n  > 需要 `$QODER_PAT`（Qoder 个人访问令牌）。`name`/`description` 从 `SKILL.md` frontmatter 自动读取。\n- **桌面 / QoderWork** 可从 Qoder 技能市场直接安装。\n- ⚠️ 限制：Qoder **Cloud（纯云端）** 没有你的本地磁盘，跑不了本地挂载；需用 **QoderWork / 桌面端**（本地运行时）才能实际挂载 NTFS 盘。\n\n### 4. 扣子 Coze\n- 技能也是\"含 `SKILL.md` 的文件夹\"，结构 `SKILL.md` + `scripts/` + `references/` + `assets/`（后两者可选，本仓库已有 `scripts/references/`）。\n- **发布**：扣子技能商店 `https://www.coze.cn/skills`；或用\"对话生成技能 / 扣子编程上传 .skill\"方式。\n- **本地模式（关键）**：Coze 支持**本地 Skill**——本地部署的 Coze 环境可挂载技能目录、执行 Python/Shell 脚本。只有这种\"本地/企业内网部署\"形态能在用户 Mac 上跑 bash 挂载 NTFS。\n- ⚠️ 限制：Coze **网页版 / 普通云端 bot** 运行在云端，**没有用户的本地 NTFS 盘**，无法执行挂载。此时 FluxMount 只能作为\"知识/流程型技能\"（教用户怎么做），不能自动执行。\n\n---\n\n## 三、云端平台的硬性边界（务必知道）\n\nFluxMount 是**本地系统技能**：它要在**用户的 macOS 上**跑 bash、挂载**用户外接的物理 NTFS 硬盘**。\n\n| 平台运行形态 | 能跑 FluxMount 吗 | 原因 |\n|--------------|-------------------|------|\n| WorkBuddy 桌面端 | ✅ 能 | 跑在本机 |\n| OpenClaw 本地 | ✅ 能 | 跑在本机 |\n| QoderWork / 桌面 | ✅ 能 | 跑在本机 |\n| Coze 本地/企业内网部署 | ✅ 能 | 跑在本机 |\n| Qoder Cloud（纯云） | ❌ 不能 | 云端无本地盘 |\n| Coze 网页版/云端 bot | ❌ 不能 | 云端无本地盘 |\n\n> 这不是 FluxMount 的缺陷，而是所有\"本地硬件操作类\"技能的共性。云端平台只能调用 API / 云端函数，碰不到你的硬盘。\n\n---\n\n## 四、推荐发布顺序（投入产出比最高）\n\n1. **先上 ClawHub**（OpenClaw 官方市场，杠杆最高）：一次提交，让所有兼容 Agent Skills 的桌面 agent 都能装（OpenClaw、Claude Desktop 等）；腾讯 SkillHub 作为 ClawHub 的国内镜像，很可能自动同步收录，让 WorkBuddy 用户也能搜到。**注意**：Qoder、扣子仍需你另外提交。\n2. **再上 WorkBuddy SkillHub**：自然语言触达桌面办公用户。\n3. **Qoder**：上传 `.zip` 到 Cloud（面向 QoderWork 桌面用户）。\n4. **扣子 Coze**：以\"本地 Skill\"形态发布，并明确标注\"需本地部署环境\"。\n\n---\n\n## 五、本仓库已做的跨平台兼容处理\n\n- `SKILL.md` 含 `name` / `version: 1.0.0` / `description`，满足全部四家最小 frontmatter 要求。\n- `scripts/` 为 POSIX bash，无平台专属依赖（仅 macOS 相关命令，属技能本体范畴）。\n- `manifest.yaml` 带 `tags` / `categories` / `homepage`，供 ClawHub / SkillHub 索引。\n- `README.md` 中英双语，提升全球平台可见度。\n- 保留 `agent_created: true`（仅 WorkBuddy 识别，其他平台忽略）。\n\n---\n\n<details>\n<summary>English summary</summary>\n\nAll four named platforms (WorkBuddy, OpenClaw/ClawHub, Qoder, Coze) follow the same Anthropic \"Agent Skills\" open standard: a folder with `SKILL.md` + `name`/`description` frontmatter. FluxMount needs no rewrite — only per-platform placement/publish. Local-only agents (WorkBuddy desktop, OpenClaw, QoderWork, Coze local deploy) can actually mount NTFS; pure-cloud agents (Qoder Cloud, Coze web) cannot reach the user's local disk. Highest-leverage move: publish to ClawHub once (covers all Agent-Skills-compatible desktop agents on the *install* side), then submit separately to SkillHub, Qoder, and Coze-local. ClawHub does NOT auto-sync to proprietary markets.\n</details>\n\nFile v0.1.0:PUBLISH.md\n\n# 发布与运营手册 (Publish & Operate)\n\n本文件回答三件事：**别人怎么用这个技能**、**WorkBuddy 怎么加载它**、**你怎么看调用次数和反馈**。\n作者：张昌宇 (Changyu Zhang)。协议：MIT。\n\n---\n\n## 一、别人怎么用（上传到平台之后）\n\nFluxMount 是 **WorkBuddy 技能（Skill）**，发布后有两种分发方式：\n\n### 方式 A：上架 WorkBuddy 技能市场（SkillHub / ClawHub）\n- WorkBuddy 内置 **SkillHub 技能市场**，已收录 8 万+ 技能；另有开源技能集散地 **ClawHub**，会索引 GitHub 上的 skill 仓库。\n- 把本仓库推到 GitHub（见下方命令），再把仓库地址提交到 ClawHub / SkillHub 发布入口即可。本仓库的 `manifest.yaml` 已含 `name / slug / version / tags / categories / homepage` 等跨平台元数据，提交时直接被识别。\n- 上架后，**用户无需懂技术**：在 WorkBuddy 对话框说一句\"帮我装一个能读写 NTFS 硬盘的技能\"，WorkBuddy 会自动去技能市场匹配并安装；或直接在技能市场搜索 `FluxMount` 一键安装。\n\n### 方式 B：GitHub 直接装（开发者向）\n用户把仓库克隆到本地 skills 目录（见第二节），重启 WorkBuddy 即可使用，无需经过市场审核。\n\n---\n\n## 二、WorkBuddy 怎么\"用到\"这个技能\n\n**关键点：技能只要落到目录，WorkBuddy 会自动加载，不需要任何注册或配置。**\n\n放置位置（二选一）：\n\n```bash\n# 用户级（所有项目都能用，推荐）\n~/.workbuddy/skills/fluxmount/\n\n# 项目级（仅当前工程共享给团队）\n{你的工程}/.workbuddy/skills/fluxmount/\n```\n\n目录里必须包含 `SKILL.md`（本仓库已有）。WorkBuddy 启动时会扫描 skills 目录，读取每个 `SKILL.md` 的 **frontmatter**：\n\n- `name`：技能唯一名（本仓库为 `fluxmount`）\n- `description`：**最重要**——写清楚\"什么时候该用这个技能\"和触发关键词。WorkBuddy 的匹配/触发引擎就是靠这段描述来判断\"用户这句话要不要调用 FluxMount\"。\n\n当用户说出\"Mac 怎么往 NTFS 盘写文件\"\"外接硬盘复制不进去\"\"让 NTFS 盘自动可读写\"等语义时，WorkBuddy 会命中 `description` 里的触发条件，自动用 Skill 工具加载本技能并执行里面的工作流程。\n\n> 所以：**想让更多人搜到、用到，SKILL.md 的 `description` 写得好不好是胜负手。** 本仓库已针对中文口语化场景（\"插件传不进文件\"\"各种插件都不行\"）做了触发词覆盖。\n\n---\n\n## 三、怎么看调用次数和反馈\n\n### 1. 平台侧（最省心）\n- 若上架 **ClawHub / SkillHub**，平台作者后台通常会展示该技能的 **安装量 / Star / 用户反馈**。发布后在对应平台的\"我的技能 / 作者中心\"查看即可。\n- WorkBuddy 内若提供技能作者面板，调用统计会在那里呈现（以平台实际功能为准）。\n\n### 2. GitHub 侧（必看，免费且实时）\n在 `https://github.com/hackerFish/fluxmount` 的 **Insights** 标签页：\n- **Traffic**：页面访问量、克隆数（最接近\"被多少人看到/下载\"的指标）\n- **Stars / Forks**：受欢迎度与传播度\n- **Issues**：Bug 报告与功能请求（= 反馈主渠道）\n- **Discussions**（建议在仓库开启）：集中收集使用体验、答疑、好评\n\n### 3. 关于\"调用次数\"的诚实说明\nFluxMount 刻意**不做内建埋点/联网上报**——这是为了守住\"安全可控、不臃肿、不偷传数据\"的产品底线。因此：\n- 本地私有使用：没有逐次调用计数（也没必要）。\n- 要看\"被广泛使用\"的证据：以 **ClawHub/SkillHub 后台安装量 + GitHub Traffic/Stars/Issues** 为准。\n\n### 运营建议（提升 star 与反馈）\n1. 开启 GitHub **Discussions**，主动回复每一条 Issue/讨论（响应速度直接影响口碑与 star）。\n2. 录一段\"装之前只读 vs 装之后直接拖文件\"的对比动图，放进 README 顶部。\n3. 打好 `macos` / `ntfs` / `macfuse` 等话题标签，发到 V2EX、少数派、Reddit r/macsysadmin 等实操帖。\n4. 竞品对比表已在 README 中，强调\"国内网络专治 + dry-run 预览 + 可回退\"三个差异化点。\n\n---\n\n## 四、发布命令（本地仓库已就绪，直接推）\n\n```bash\ncd FluxMount\ngit init\ngit add .\ngit commit -m \"FluxMount v1.0.0 - macOS NTFS read-write skill by Changyu Zhang\"\ngit branch -M main\ngit remote add origin https://github.com/hackerFish/fluxmount.git\ngit push -u origin main\n```\n\n推上去后：去 ClawHub / SkillHub 提交仓库地址完成上架；在 GitHub 仓库开启 **Issues + Discussions**；在 README 顶部补一段对比动图。\n\n---\n\n<details>\n<summary>English summary</summary>\n\n**How others use it:** Publish to WorkBuddy's SkillHub / ClawHub marketplace (this repo's `manifest.yaml` is already compatible). Users install with one click or just by saying \"install a skill that writes NTFS disks\" in WorkBuddy. Developers can also `git clone` into `~/.workbuddy/skills/fluxmount/`.\n\n**How WorkBuddy loads it:** No registration needed. Drop the folder under `~/.workbuddy/skills/fluxmount/` (user-level) or `{workspace}/.workbuddy/skills/fluxmount/` (project-level). WorkBuddy auto-reads `SKILL.md` frontmatter; the `description` field drives trigger matching.\n\n**Call counts & feedback:** Marketplace author dashboards show installs/stars/feedback. For GitHub, use Insights → Traffic/Stars/Issues/Discussions. FluxMount intentionally has no telemetry (privacy-by-design); distribution signals come from marketplace stats + GitHub Insights.\n</details>\n\nFile v0.1.0:SAFETY.md\n\n# FluxMount · 安全与可回退说明\n\n本文件面向\"担心弄坏电脑 / 担心数据丢失\"的用户，明确说明 FluxMount **改什么、不动什么、如何还原**。\n\n## 本工具会改动的地方（全部可逆）\n\n安装后，FluxMount 只会在你的系统里新增 / 覆盖以下**它自己的文件**，且安装前会自动备份被覆盖的文件到 `~/.fluxmount-backup`：\n\n| 改动 | 路径 | 说明 |\n|------|------|------|\n| 挂载脚本 | `/usr/local/bin/mount-ntfs-rw` | 我们提供的核心脚本（覆盖前会备份） |\n| 自动挂载入口 | `/usr/local/bin/ntfs-automount` | LaunchAgent 调用的入口（覆盖前会备份） |\n| 免密 sudo 规则 | `/etc/sudoers.d/fluxmount` | **仅放行** `mount-ntfs-rw` 这一条命令免密码，不碰系统其他 sudo 配置（覆盖前会备份） |\n| 开机/热插拔代理 | `~/Library/LaunchAgents/com.changyu.fluxmount.plist` | 自动挂载触发器（覆盖前会备份） |\n| 第三方驱动（可选安装） | macFUSE、ntfs-3g | 开源驱动本体；来自官方或国内镜像，由 Homebrew / 官方 pkg 安装 |\n\n## 本工具**绝不**做这些事\n\n- ❌ **绝不删除、修改、移动你 NTFS 硬盘里的任何数据**。它只做一件事：把系统\"只读挂载\"的分区\"重新挂载为读写\"。已实测不影响盘内文件。\n- ❌ 绝不执行 `rm -rf` 你的个人目录、文档、下载等。\n- ❌ 绝不改动系统其他 sudoers、其他 LaunchAgent、其他磁盘。\n- ❌ 绝不格式化、绝不读写你要保护的盘之外的内容。\n\n## 受控执行（你始终掌握主动权）\n\n- 所有需要管理员权限的步骤，都会由 **Homebrew / macOS 安装器** 当场弹窗向你索要密码，**不会偷偷提权**。\n- 安装前想先看一眼会动哪里？先跑：\n  ```bash\n  bash install.sh --dry-run\n  ```\n  它会列出将要写入的每个路径，**不改动任何东西**。\n- 系统扩展批准、重启这类关键决策，必须由你在图形界面手动点【允许】，脚本无法替你做。\n\n## 如何回退 / 还原（可恢复）\n\n随时一键还原到\"安装前\"的状态：\n\n```bash\nbash uninstall.sh\n```\n\n它会：\n\n1. 卸载所有 FluxMount 产生的可读写挂载（用 `diskutil unmount`，安全弹出）；\n2. 停掉并移除 `com.changyu.fluxmount` 自动挂载代理；\n3. 删除免密 sudo 规则 `/etc/sudoers.d/fluxmount`；\n4. 删除 `/usr/local/bin/mount-ntfs-rw`、`/usr/local/bin/ntfs-automount`；\n5. **若 `~/.fluxmount-backup` 里存在安装前备份，则把原文件还原回去**（例如你之前自己放的同名脚本）。\n\n> 说明：macFUSE / ntfs-3g 两个驱动本体不在卸载范围内（它们是独立开源软件）。若你想彻底移除它们，请另行用 `brew uninstall` 或官方卸载器，二者也不影响你的数据。\n\n## 万一想更稳妥\n\n- 在执行任何磁盘操作前，先把 NTFS 盘里的重要文件备份到别处（最佳实践，任何磁盘工具都建议）。\n- 只在确认弹窗\"访问可移除宗卷\"时点【允许】—— 那是 macOS 的权限询问，不是删除提示。\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nFluxMount helps agents guide macOS users through installing, checking, using, and removing a macFUSE and ntfs-3g workflow for read-write mounting of external NTFS drives.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[hackerfish](https://clawhub.ai/user/hackerfish)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal macOS users and support agents use this skill when an NTFS external drive is mounted read-only and they need terminal commands, setup guidance, health checks, and rollback steps for read-write mounting.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The workflow installs persistent local automation and a passwordless sudoers entry for disk mounting.\n\nMitigation: Run the dry-run first, review the LaunchAgent and sudoers paths, confirm the sudoers rule only permits the FluxMount mounting command, and remove the components with uninstall.sh when no longer needed.\n\nRisk: The workflow depends on third-party filesystem drivers and mutable dependency sources or mirrors.\n\nMitigation: Verify dependency sources and installer signatures before installation, and proceed only on a trusted local macOS machine.\n\nRisk: Disk remounting workflows can affect access to external-drive data if used on the wrong volume or without backups.\n\nMitigation: Back up important data first, review status and doctor output before making changes, and safely unmount volumes after use.\n\n## Reference(s):\n\n- [Server-resolved GitHub repository](https://github.com/hackerFish/fluxmount)\n- [ClawHub skill page](https://clawhub.ai/hackerfish/skills/fluxmount)\n- [macFUSE](https://github.com/macfuse/macfuse)\n- [ntfs-3g](https://github.com/tuxera/ntfs-3g)\n- [Safety and rollback notes](SAFETY.md)\n- [Troubleshooting guide](references/troubleshooting.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration]\n\n**Output Format:** [Markdown guidance with inline shell commands and file path references]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include local macOS commands that require user review, administrator approval, system-extension approval, backups, and rollback steps.]\n\n## Skill Version(s):\n\n0.1.0 (source: ClawHub release metadata; artifact frontmatter and manifest list 1.0.0)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v0.1.0:.github/workflows/ci.yml\n\nname: CI\n\non:\n  push:\n    branches: [main, master]\n  pull_request:\n\njobs:\n  shellcheck:\n    name: Bash syntax & shellcheck\n    runs-on: macos-latest\n    steps:\n      - uses: actions/checkout@v4\n\n      - name: Install shellcheck\n        run: brew install shellcheck\n\n      - name: Syntax check (bash -n)\n        run: |\n          for f in scripts/*.sh; do\n            echo \"==> bash -n $f\"\n            bash -n \"$f\"\n          done\n\n      - name: Static analysis (shellcheck)\n        run: |\n          for f in scripts/*.sh; do\n            echo \"==> shellcheck $f\"\n            shellcheck \"$f\"\n          done","readmeExcerpt":"Skill: fluxmount Owner: hackerfish Summary: FluxMount - 让 macOS 自由读写外接 NTFS 硬盘，傻瓜式、一次到位、插上即用、不再复发。当用户把 NTFS 格式的移动硬盘或 SSD 接到 Mac 却无法写入或复制文件、抱怨各种插件都传不进去、问 Mac 怎么往 NTFS 盘里写文件、或想要开机与热插拔自动可读写挂载时使用。覆盖国内网络典型坑（GitHub 被墙、Homebrew Tier-3 无预编译包、新版 Clang 编译报错、launchctl 弃用、沙箱禁 sudo），并提供一键安装、健康自检与干净卸载。作者 张昌宇 (Changyu Zhang)。 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-12T14:25:04.319Z | auto Initial public release with ro","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"diskutil list\nsystem_profiler SPStorageDataType | grep -iA6 ntfs\nmount | grep -i ntfs"},{"language":"bash","snippet":"bash install.sh            # 完整安装\nbash install.sh --doctor   # 只做健康检查，报告当前环境与问题\nbash install.sh --status   # 查看所有 NTFS 盘的可读写状态\nbash install.sh --dry-run  # 只打印将要做什么，不改动任何系统（先给安全感）"},{"language":"bash","snippet":"mount | grep macfuse              # 应看到 (macfuse, ... rw ...)\nbash install.sh --doctor          # 全绿即通过"},{"language":"bash","snippet":"bash install.sh            # 完整安装（自动装驱动、部署脚本、配自动挂载）\nbash install.sh --doctor   # 只做健康检查，报告当前环境\nbash install.sh --status   # 查看所有 NTFS 盘的可读写状态\nbash install.sh --dry-run  # 只预览将要做什么，不改动任何系统"},{"language":"text","snippet":"fluxmount/\n├── SKILL.md                 # WorkBuddy skill 入口\n├── README.md                # 本文件（中/英双语）\n├── SAFETY.md                # 安全与可回退说明\n├── manifest.yaml            # OpenClaw / ClawHub 跨平台元数据\n├── LICENSE                  # MIT (张昌宇)\n├── scripts/\n│   ├── mount-ntfs-rw        # 核心挂载(多盘/幂等/退避/校验/dry-run/status)\n│   ├── ntfs-automount       # LaunchAgent 热插拔入口\n│   ├── install.sh           # 傻瓜式一键安装 + doctor + status + dry-run\n│   ├── uninstall.sh         # 干净回滚(仅回退自己的盘 + 恢复安装前备份)\n│   └── doctor.sh            # 健康检查入口\n└── references/\n    └── troubleshooting.md   # 排障手册(含踩坑与竞品经验)"},{"language":"bash","snippet":"bash install.sh            # full install (driver + scripts + auto-mount)\nbash install.sh --doctor   # health check, report current environment\nbash install.sh --status   # show read/write status of all NTFS disks\nbash install.sh --dry-run  # preview only, change nothing"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: fluxmount\nversion: 1.0.0\ndescription: FluxMount - 让 macOS 自由读写外接 NTFS 硬盘，傻瓜式、一次到位、插上即用、不再复发。当用户把 NTFS 格式的移动硬盘或 SSD 接到 Mac 却无法写入或复制文件、抱怨各种插件都传不进去、问 Mac 怎么往 NTFS 盘里写文件、或想要开机与热插拔自动可读写挂载时使用。覆盖国内网络典型坑（GitHub 被墙、Homebrew Tier-3 无预编译包、新版 Clang 编译报错、launchctl 弃用、沙箱禁 sudo），并提供一键安装、健康自检与干净卸载。作者 张昌宇 (Changyu Zhang)。\nagent_created: true\n---\n\n# FluxMount (macOS NTFS Read-Write)\n\n让 Mac 自由读写外接 NTFS 硬盘。底层基于开源的 macFUSE + ntfs-3g，并配套开机与热插拔自动挂载，做到\"插上即用、不再复发\"。作者：**张昌宇 (Changyu Zhang)**，协议 MIT。\n\n## 什么时候用这个 skill\n\n- 用户把 NTFS 格式外接硬盘接到 Mac，能看不能写 / 复制失败 / 插件传不进文件。\n- 用户问\"Mac 怎么写 NTFS\"\"有没有免费 NTFS 工具\"\"能不能让盘自动可读写\"。\n- 用户已装过驱动但仍只读，需要排查（系统扩展未批准 / 免密 sudo 未配 / 代理未注册）。\n\n## 根因（务必先讲给用户听）\n\nmacOS 原生对 NTFS **只支持只读挂载**。无论用什么 App、插件、脚本，只要系统把它挂成只读，谁都写不进去。这不是插件不行，是系统层面锁了写权限。**解法不是找更强插件，而是用 ntfs-3g 把它重新挂成读写。** 用户盘里的数据不会被改动（我们只是重新挂载，不删不改任何文件）。\n\n## 工作流程\n\n### 1. 识别硬盘（只读命令，无需 sudo）\n\n```bash\ndiskutil list\nsystem_profiler SPStorageDataType | grep -iA6 ntfs\nmount | grep -i ntfs\n```\n\n确认磁盘节点（如 /dev/disk12s2）、卷名，以及它被 macOS 以 `(ntfs, ... read-only ...)` 只读挂载。\n\n### 2. 一键安装（用户本机终端运行）\n\n把 skill 的 scripts/ 目录复制到本机后运行：\n\n```bash\nbash install.sh            # 完整安装\nbash install.sh --doctor   # 只做健康检查，报告当前环境与问题\nbash install.sh --status   # 查看所有 NTFS 盘的可读写状态\nbash install.sh --dry-run  # 只打印将要做什么，不改动任何系统（先给安全感）\n```\n\ninstall.sh 会自动：检测系统 → 装 macFUSE（国内镜像兜底 GitHub 被墙）→ 装 ntfs-3g（用 `brew tap gromgit/homebrew-fuse` + `brew install ntfs-3g-mac`，规避 Homebrew Tier-3 无包）→ 部署脚本到 /usr/local/bin → 配置免密 sudo → 注册开机 + 热插拔自动挂载（LaunchAgent，现代 bootstrap 方式）→ 立即挂载一次。**安装前会自动备份被覆盖的文件到 ~/.fluxmount-backup，可随时回退。**\n\n> 注意：沙箱/远程环境通常禁止 sudo 与 launchctl 写操作，安装与批准系统扩展必须在用户**真实终端**完成，本 skill 负责生成脚本与指引，不会在你的电脑上做不可控的改动。\n\n### 3. 用户只需一次的人工步骤（每个 Mac 一次）\n\n1. 打开 系统设置 → 隐私与安全性\n2. 找到\"来自开发者 Benjamin Fleischer 的系统软件已被阻止\"，点【允许】\n3. 重启电脑\n4. 重启后插上 NTFS 盘，等 5~8 秒即自动可读写，无需再敲命令\n\n### 4. 验证\n\n```bash\nmount | grep macfuse              # 应看到 (macfuse, ... rw ...)\nbash install.sh --doctor          # 全绿即通过\n```\n\nFinder 里直接往盘里拖文件即可。用完安全弹出：`diskutil unmount /Volumes/<盘名>`。\n\n## 资源\n\n- `scripts/mount-ntfs-rw` — 核心挂载脚本（多盘、幂等、退避重试、写权限校验、`--dry-run`、`--status` 状态查询）\n- `scripts/ntfs-automount` — LaunchAgent 热插拔入口\n- `scripts/install.sh` — 傻瓜式一键安装 + doctor 自检 + dry-run 预览\n- `scripts/uninstall.sh` — 干净回滚（恢复安装前备份）\n- `references/troubleshooting.md` — 排障手册（吸收竞品经验 + 国内网络坑）\n- `README.md` — 面向 GitHub / SkillHub / ClawHub 的发布文档与竞品对比\n- `SAFETY.md` — 安全与可回退说明（明确本工具改什么、不动什么、如何还原）\n- `manifest.yaml` — OpenClaw / ClawHub 跨平台元数据\n\n## 本 skill 相对竞品的特色（作者沉淀）\n\n- **国内网络专治**：macFUSE 下载走 kgithub / ghproxy 多个国内镜像兜底；ntfs-3g 用 gromgit tap 的 `ntfs-3g-mac`（有预编译包），避开 Homebrew 对旧 macOS 的 Tier-3 无包与 GitHub 被墙。\n- **傻瓜式一次到位**：单命令安装 + doctor 自检 + dry-run 预览，把\"系统扩展批准 / 免密 sudo / 代理注册\"三件最容易翻车的事都自动化或半自动化。\n- **防复发**：开机（RunAtLoad）+ 热插拔（StartOnMount）双触发；幂等（已可读写则跳过，不干扰正在用的盘）；指数退避重试 + 写权限校验。\n- **多盘支持**：遍历所有只读 NTFS 分区逐个重挂载，挂回原卷名（Finder 名字不变）。\n- **安全可控**：免密 sudo 仅放行 `mount-ntfs-rw` 一条命令；安装前自动备份被覆盖文件，uninstall 可完整还原；**只重挂载、绝不删除或改动盘内数据**。\n\n> 踩坑经验（已固化到 troubleshooting.md）：GitHub 被墙用国内镜像；Homebrew `brew install ntf"},{"path":"README.md","content":"# FluxMount — macOS NTFS Read-Write Toolkit\n\n> [中文](#中文) · [English](#english)\n>\n> 让 macOS 自由读写外接 NTFS 硬盘 —— 傻瓜式、一次到位、插上即用、不再复发。\n> Make macOS read & write external NTFS drives — one-shot setup, plug-and-use, never relapses.\n>\n> 作者 / Author: **张昌宇 (Changyu Zhang)** · 协议 / License: MIT\n\n---\n\n### 🔌 装前 vs 装后（Before / After）\n\n| | 🚫 装前（原生 macOS） | ✅ 装后（FluxMount） |\n|---|---|---|\n| 写入文件 | 弹出\"只读\"，无法复制 / 拖入 | 直接拖进去，像本地盘一样用 |\n| 传文件 | 各种插件、网盘都传不进去 | 即插即用，随意读写 |\n| 每次插盘 | 要敲命令重新挂载 | 自动可读写（开机 + 热插拔） |\n| 多盘 / 重名 | 易冲突、需手动处理 | 遍历挂载、保留原卷名 |\n| 安全性 | — | 只重挂载、不删数据、可一键回退 |\n\n> English: Before FluxMount, macOS mounts NTFS **read-only** — you can see the files but cannot write. After, your NTFS drive behaves like a native writable disk: plug in and drag files, auto-mount on boot & hotplug, fully reversible and safe.\n\n## 中文\n\n### 为什么需要它\n\nmacOS 原生对 NTFS 硬盘**只支持只读挂载**。你把 Windows 格式的 SSD / 移动硬盘插上 Mac，能看不能写，各种\"传输助手\"\"网盘插件\"都传不进去 —— **这不是插件不行，是系统锁了写权限**。\n\nFluxMount 用开源的 [macFUSE](https://github.com/macfuse/macfuse) + [ntfs-3g](https://github.com/tuxera/ntfs-3g) 把硬盘**重新挂载为可读写**，并配好开机 / 热插拔自动挂载，从此插上就能直接拖文件。\n\n### 一键安装\n\n```bash\nbash install.sh            # 完整安装（自动装驱动、部署脚本、配自动挂载）\nbash install.sh --doctor   # 只做健康检查，报告当前环境\nbash install.sh --status   # 查看所有 NTFS 盘的可读写状态\nbash install.sh --dry-run  # 只预览将要做什么，不改动任何系统\n```\n\n安装后只需**每个 Mac 一次**的人工操作：\n\n1. 系统设置 → 隐私与安全性 → 点【允许】\"Benjamin Fleischer\"的系统软件\n2. 重启\n3. 插上 NTFS 盘，等 5~8 秒，自动可读写，无需再敲命令\n\n用完安全弹出：`diskutil unmount /Volumes/<盘名>`\n\n### 傻瓜式 & 安全设计\n\n- **国内网络专治**：macFUSE 下载走 kgithub / ghproxy 多个国内镜像兜底；ntfs-3g 用 `brew tap gromgit/homebrew-fuse` + `brew install ntfs-3g-mac`（有预编译包），避开 Homebrew Tier-3 无包与 GitHub 被墙。\n- **一次到位**：单命令安装 + `doctor` 自检 + `dry-run` 预览，自动处理\"系统扩展批准 / 免密 sudo / 代理注册\"三件最易翻车的事。\n- **防复发**：开机（RunAtLoad）+ 热插拔（StartOnMount）双触发；幂等（已可读写则跳过，不干扰正在用的盘）；退避重试 + 写权限校验。\n- **多盘支持**：遍历所有只读 NTFS 分区逐个重挂载，挂回原卷名（Finder 名字不变）。\n- **安全可控、可回退**：免密 sudo 仅放行 `mount-ntfs-rw` 一条命令；**安装前自动备份被覆盖文件到 `~/.fluxmount-backup`**，`uninstall.sh` 可完整还原；**只重挂载、绝不删除或改动盘内数据**。详见 [SAFETY.md](SAFETY.md)。\n- **下载可信**：安装 macFUSE 前校验代码签名（`pkgutil --check-signature`），防止下载被篡改。\n\n### 竞品对比 & 我们的特色\n\n| 能力 | macos-ntfs-smart-mount | Nigate | NTFS Tool | Mounty | **FluxMount** |\n|------|:---:|:---:|:---:|:---:|:---:|\n| 免费开源 | ✅ | ✅ | ✅ | ✅ | ✅ |\n| macFUSE + ntfs-3g | ✅ | (封装) | ✅ | ❌(内置写) | ✅ |\n| 国内镜像兜底 GitHub 被墙 | ❌ | ⚠️(多CDN) | ❌ | ❌ | ✅ **专治** |\n| 规避 Homebrew Tier-3 无包 | ✅(ntfs-3g-mac) | — | ❌ | — | ✅ |\n| 开机 + 热插拔自动挂载 | ❌(手动) | ✅(GUI) | 🚧(路线图) | ✅ | ✅ |\n| 多盘支持 | ❌ | ⚠️ | ✅ | ❌ | ✅ |\n| 命令行无 GUI 依赖 | ✅ | ⚠️ | ❌ | ✅ | ✅ |\n| 健康检查 / 自检 | ❌ | ❌ | ❌ | ❌ | ✅ **doctor/status** |\n| dry-run 预览 | ❌ | ❌ | ❌ | ❌ | ✅ |\n| 干净卸载 / 可回退 | ❌ | ⚠️ | ❌ | ❌ | ✅ **备份还原** |\n| 下载签名校验 | ❌ | ❌ | ❌ | ❌ | ✅ **独有** |\n| 中文文档 / 品牌 | ✅ | ✅ | ✅ | ✅ | ✅ **张昌宇出品** |\n\n> 我们吸收并改进了竞品优点：smart-mount 的 `ntfs-3g-mac` 正确装法与中英文档、Nigate 的多 CDN 镜像与热插拔、NTFS Tool 的退避重试与多盘处理；并补齐了它们都忽略的**国内网络适配、免密 sudo、代理注册、自检、dry-run、下载签名校验与可回退卸载**。\n\n### 文件结构\n\n```\nfluxmount/\n├── SKILL.md                 # WorkBuddy skill 入口\n├── README.md        "},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7f38j0904t7yjceyfzjnbs31844zv9\",\n  \"slug\": \"fluxmount\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1786544704319\n}"},{"path":"references/troubleshooting.md","content":"# FluxMount · 排障手册\n\n作者: 张昌宇 (Changyu Zhang)\n本手册固化了真实踩坑经验，并吸收了社区竞品（macos-ntfs-smart-mount / Nigate / NTFS Tool / Mounty）的做法与已知限制。\n\n---\n\n## 一、根因速记\n\n- macOS 原生 **NTFS 只读挂载**，任何 App/插件/脚本都无法写入 —— 不是插件问题，是系统锁了写权限。\n- 解法 = 用 **ntfs-3g**（经 macFUSE 的 FUSE 接口）把分区**重新挂载为读写**。这一步**不删不改**盘内任何数据，只是换个挂载方式。\n\n## 二、安装阶段典型坑\n\n### 1. macFUSE 下载被墙（GitHub 连接重置）\n\n- 现象: `curl: (56) Recv failure: Connection reset by peer`，下到 ~5MB 中断。\n- 根因: 国内直连 GitHub release 不稳定。\n- 解法: install.sh 已内置 kgithub / ghproxy 系列**国内镜像兜底**，会自动换源重试。若仍失败，开代理/VPN 手动下载 `macfuse-5.3.3.dmg` 双击安装后重跑。\n\n### 2. Homebrew `brew install ntfs-3g` 报错 no bottle / Tier 3\n\n- 现象: `Error: ntfs-3g: no bottle available!` + `Tier 3 configuration`。\n- 根因: 2026 年 macOS 15（尤其 Intel）被 Homebrew 归为 Tier-3 旧系统，不再提供预编译 ntfs-3g bottle；`--build-from-source` 又要从 GitHub 拉源码（被墙）。\n- **正确解法（关键）**: 用 `brew tap gromgit/homebrew-fuse` 后 `brew install ntfs-3g-mac`。该 tap 专为 macOS 维护，提供可用预编译包。这也是 macos-ntfs-smart-mount 的做法。\n- 反例: 不要走 `--build-from-source`，新版 Xcode/Clang 会把老 C 代码的隐式函数声明、重复全局符号当**硬错误**（`1 warning and 1 error generated`），需额外加 `-Wno-implicit-function-declaration -fcommon` 仍可能失败。\n\n### 3. 目录权限 not writable\n\n- 现象: `Error: The following directories are not writable by your user: /usr/local/share/man/man8`\n- 解法: `sudo chown -R $USER /usr/local/share/man/man8 && chmod u+w /usr/local/share/man/man8`，再重跑。\n\n### 4. Homebrew 自动更新卡死\n\n- 现象: 卡在 `Auto-updating Homebrew...` 假死。\n- 解法: Ctrl+C 取消，重跑时带 `HOMEBREW_NO_AUTO_UPDATE=1`（install.sh 已内置）。\n\n## 三、挂载阶段典型坑\n\n### 5. 系统扩展未批准（最常见）\n\n- 现象: 挂载报 `fusefs: failed to mount` / `FUSE cannot be used` / 盘停在只读的\"新加卷\"。\n- 解法: 系统设置 → 隐私与安全性 → 点【允许】\"Benjamin Fleischer\"的系统软件 → **重启** → 重跑 `sudo mount-ntfs-rw`。\n- 竞品提示: 部分旧教程让你进恢复模式改\"降低安全性/允许内核扩展\"——那是 **macFUSE 4.x (kext) 的做法**；macFUSE 5.x 用的是 **System Extension**，无需进恢复模式，只需在隐私与安全性里点允许。\n\n### 6. \"xxx 想访问可移除宗卷上的文件\"弹窗\n\n- 这是 macOS 的**访问权限**询问（不是删除！），点【允许】即可。我们的脚本不执行任何删除命令，只是卸载只读挂载 + 重新挂载。\n\n### 7. 热插拔不自动挂载\n\n- 多为后台弹了\"访问可移除宗卷\"权限框但无前台窗口看不到。去 系统设置 → 隐私与安全性 → 完全磁盘访问权限，把以下三个加进去，再拔插一次:\n  - `/usr/local/bin/ntfs-automount`\n  - `/usr/local/bin/mount-ntfs-rw`\n  - `/usr/local/bin/ntfs-3g`\n- 其次检查代理是否真注册: `launchctl print gui/$(id -u)/com.changyu.fluxmount` 应存在且 `runs>0`。\n\n### 8. `launchctl load` 在 macOS 15 失效\n\n- 现象: `launchctl list` 查不到、`launchctl load` 报 Input/output error。\n- 根因: macOS 15 (Sequoia) 已弃用 `launchctl load`，且远程/沙箱环境会拦截写类 launchctl。\n- 解法: 用现代方式 `launchctl bootout gui/$(id -u)/LABEL` 再 `launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/xxx.plist`，且**必须在图形登录会话的真实终端**执行（WorkBuddy 沙箱内的 Bash 无法替你注册）。\n\n### 9. Windows 快速启动导致挂载失败\n\n- 来源: Nigate 的已知提示。若 NTFS 盘来自未彻底关机的 Windows（快速启动开启），可能挂载异常。需在 Windows 端彻底关机或关闭快速启动。\n\n## 四、竞品经验借鉴（已吸收进本 skill）\n\n- **macos-ntfs-smart-mount**: `gromgit/homebrew-fuse` + `ntfs-3g-mac` 的正确装法；安全弹出时杀掉 Spotlight/QuickLook 防止卸载卡死；中英双语文档。\n- **Nigate**: 多 CDN 镜像（jsDelivr/statically）兜底 GitHub 被墙；GUI 实时监测 + 热插拔自动读写；多语言。\n- **NTFS Tool**: 指数退避重试（5/10/20/60s）、防抖监测、孤立挂载目录清理、每盘失败追踪、ExFAT 免 sudo。\n- **Mounty**: 用 macOS 内置实验性 NTFS 写（免 ntfs-3g），但苹果官方标注不稳定、有数据风险，本 skill"},{"path":"CONTRIBUTING.md","content":"# 贡献指南 (Contributing)\n\n感谢你关注 **FluxMount**！这是一个面向 macOS 用户的 NTFS 读写技能，目标是\"傻瓜式、一次到位、插上即用、不再复发\"。\n\n## 开发约定\n\n- **语言**：所有脚本为 POSIX / Bash，目标在 macOS 12+ 运行。\n- **风格**：函数式拆解、清晰注释、错误信息用中文（面向最终用户）。\n- **安全**：任何会改动系统的操作前，必须支持 `--dry-run` 预览；卸载必须可还原。\n- **幂等**：脚本重复执行不应造成副作用（已可读写则跳过）。\n\n## 本地测试\n\n```bash\n# 语法检查（CI 也会跑）\nfor f in scripts/*.sh; do bash -n \"$f\"; done\n\n# 静态检查（可选，需 brew install shellcheck）\nshellcheck scripts/*.sh\n\n# 只读预览（不改任何系统）\nbash scripts/install.sh --dry-run\n\n# 健康检查\nbash scripts/install.sh --doctor\n```\n\n## 提交 Issue / PR\n\n- **Bug**：请附上 `bash scripts/install.sh --doctor` 的输出、macOS 版本、芯片类型（Intel / Apple Silicon）。\n- **新功能**：先开 Issue 讨论，避免重复劳动。\n- **PR**：请保持小而专注，并确认本地测试通过。\n\n## 许可证\n\n本项目以 MIT 协议发布，版权归 **张昌宇 (Changyu Zhang)** 所有。"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"FluxMount - 让 macOS 自由读写外接 NTFS 硬盘，傻瓜式、一次到位、插上即用、不再复发。当用户把 NTFS 格式的移动硬盘或 SSD 接到 Mac 却无法写入或复制文件、抱怨各种插件都传不进去、问 Mac 怎么往 NTFS 盘里写文件、或想要开机与热插拔自动可读写挂载时使用。覆盖国内网络典型坑（GitHub 被墙、Homebrew Tier-3 无预编译包、新版 Clang 编译报错、launchctl 弃用、沙箱禁 sudo），并提供一键安装、健康自检与干净卸载。作者 张昌宇 (Changyu Zhang)。 Skill: fluxmount Owner: hackerfish Summary: FluxMount - 让 macOS 自由读写外接 NTFS 硬盘，傻瓜式、一次到位、插上即用、不再复发。当用户把 NTFS 格式的移动硬盘或 SSD 接到 Mac 却无法写入或复制文件、抱怨各种插件都传不进去、问 Mac 怎么往 NTFS 盘里写文件、或想要开机与热插拔自动可读写挂载时使用。覆盖国内网络典型坑（GitHub 被墙、Homebrew Tier-3 无预编译包、新版 Clang 编译报错、launchctl 弃用、沙箱禁 sudo），并提供一键安装、健康自检与干净卸载。作者 张昌宇 (Changyu Zhang)。 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-12T14:25:04.319Z | auto Initial public release with ro","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":810,"uniquenessScore":52,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T04:08:32.367Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T04:08:32.367Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T10:43:34.871Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}