给极空间 NAS 写了个零配置 CLI + MCP：不用密码/SSH/DDNS， AI 直接管你的 NAS

[skyzt]

极空间没有官方 CLI 和公开 API ，日常只能靠客户端点来点去。我做了个
zspace-cli ，思路是"寄生"在已登录的桌面客户端上：直接读它的登录态，走它
本地的 127.0.0.1:13579 代理——所以**不用密码、不用 SSH 、不用 DDNS/端口
转发**，客户端开着就能用。

```bash
pip install zspace-cli
zs check # 探测客户端
zs find "权力的游戏" # NAS 全文索引搜索
zs up ./电影.mkv /sata11/my/data/影视
zs-mcp # MCP server ，接 Claude/Cursor 让 AI 管 NAS
```

几个特点：

- 完整 CLI + Python SDK + MCP server （ Glama 已收录）
- 附赠 8 个跨 NAS 整理 Agent Skill （照片/音乐/影视/下载清理/重复文件/
备份审计…）+ nas-report 全盘存储画像。脚本只读扫描，重命名/移动由
LLM 出方案、人确认、Agent 执行——SMB 挂载即可用，不限极空间
- 大文件上传是逆向桌面客户端的分片协议实现的（ uuid 会话 + 2MB 分片），
本地代理对单请求体积有上限，普通做法直接 413 ；中文文件名全链路 OK
（ 680MB 视频往返 MD5 校验）
- CI 跑 ubuntu/macos/windows × py3.9/3.12 ，测试全 mock——**没有极空间
也能贡献代码**

现在仓库里挂了一批带难度标签的贡献点子（断点续传、并行分片、百度网盘
集成 /znetdisk/*、WebDAV 挂载助手…），附逆向笔记。欢迎 star / PR：

https://github.com/skyzhao1223/zspace-cli
https://github.com/skyzhao1223/baidu-pan-skill （百度侧全链路，v0.2.0 已支持文件夹分享递归）

完整逆向过程（ dlink 31362 死路、并发限速实验、极空间分片协议、uuid 公式里的
JS 加法陷阱）已发全文： https://blog.csdn.net/boyzhaotian/article/details/166349848

另外求 Windows 极空间用户帮个忙：看一眼你的 `vuex.json` 在哪个目录
（ issue #7 ），我把 Windows 路径探测修正掉，一分钟的事。

[GaryBI1STP]

C:\Users\Administrator\AppData\Roaming\zspace
这个目录

[GaryBI1STP]

先收藏，之后研究看看

[skyzt]

收到，感谢！`C:\Users\Administrator\AppData\Roaming\zspace` 就是 `%APPDATA%\zspace`，正好是代码探测的第一候选路径，Windows 侧无需改动👍 已记录到 issue #7 ( https://github.com/skyzhao1223/zspace-cli/issues/7) 并在代码注释里标注了验证来源。现在只剩 Linux 装机没有实测确认，如果你有 Linux 机器，欢迎顺手 `pip install zspace-cli && zs check` 试一下~