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

skyzt 2026-09-22 16:01 1

极空间没有官方 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 路径探测修正掉,一分钟的事。
最新回复 (3)
  • GaryBI1STP 09-22 16:15
    1
    C:\Users\Administrator\AppData\Roaming\zspace
    这个目录
  • GaryBI1STP 09-22 16:15
    2
    先收藏,之后研究看看
  • skyzt 楼主 09-22 16:35
    3
    收到,感谢!`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` 试一下~
* 帖子来源V2EX
返回