GoForum › 🌐 V2EX

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

skyzt · 2026-09-22 16:03 · 0 次点赞 · 2 条回复

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

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 路径探测修正掉,一分钟的事。

2 条回复
GaryBI1STP · 2026-09-22 16:18
#1

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

GaryBI1STP · 2026-09-22 16:18
#2

先收藏,之后研究看看

添加回复
你还需要 登录 后发表回复

登录后可发帖和回复

登录 注册
主题信息
作者: skyzt
发布: 2026-09-22
点赞: 0
回复: 0