NetSeed Docs

    NetSeed App

    NetSeed App 面向 iOS、Android、macOS 和 Windows。移动端与桌面端共享相同的账号、Space、连接和授权语义；布局会适配屏幕，但同名入口表达同一件事。

    主界面

    区域作用准确性要求
    连接开关启动或停止当前 Space 的连接登录/切换后的资源刷新不能长期阻塞连接
    当前组织与网络上方显示 Organization，下方显示 Network不重复写“组织/网络”前缀；无手动刷新图标，后台静默刷新
    账号查看当前登录者、切换或退出账号“当前账号”不使用含义不清的“已授权”副标题
    服务查看当前 Space 中自己发布或获授权的 L4 Service筛选项与桌面端一致，紧凑单行展示
    节点查看本机 Node 与获授权 Node 的 IP/DNS分组标题留足高度并垂直居中
    出口选择已授权的互联网出口全站统一叫“出口”，不用“线路”
    设置高级连接、更多设置、活动日志、关于图标与页面标题保持唯一且一致

    登录与切换 Space

    登录由外部浏览器完成，详情见登录与设备授权。切换 Space 时 App 显示透明遮罩与居中的紧凑白色加载弹层；冲突操作暂时不可用，耗时超过阈值后出现取消。成功后界面展示新的 Organization/Network，并保持断开，由用户决定何时连接。

    只有一个 Space 时仍显示当前值，但切换项不可点击；列表不会为了一个选项保留大块空白。

    节点与服务

    • 节点支持“我的节点”和“已授权给我的节点”两个范围；授权整个 Node 后可见其 L3 信息并按策略访问。
    • 服务目录可能在未连接时仍可见，因为授权目录可独立刷新；真正访问私网服务仍要求当前 Space 已连接。
    • 服务筛选应使用当前 Network 的最新数据。切换后旧缓存不得覆盖新列表。

    出口交互

    先在出口页选择一个已授权出口，再打开出口开关。未选择时点击开关只提示 请先选择出口，不进入半开启状态。出口列表使用紧凑行距；选择结果在下一次连接时安全应用。

    高级连接设置

    默认 自动 适合大多数网络。数据传输可在 WG/WSS 间自动选择；控制通道可在 SSE、Noise、QUIC 中按 NSD 广告能力和信任 pin 选择。强制某个模式仅用于排障，企业代理、UDP 限制和平台 VPN 权限都可能影响结果。

    三类 pin 绑定 NSD authority，不绑定 Organization/Network/Space。App 首次使用受控发布配置，之后可信持久 source/manifest authority 优先；普通远程配置不能静默替换 pin 或认证权威，轮换必须走显式可信迁移。

    App 与命令行同时安装

    App 内置自己的 Core/Library；本机 ns 是独立发行的命令行程序，但二者共享设备身份语义。任何时刻只能有一个 Core 持有系统网络资源。需要改用 CLI 时先在 App 断开并退出运行；CLI 的 ns update 不会更新 App，App 更新也不会替换系统 ns。

    更新兼容性

    正常 App 更新保留 Device 身份、账号和 Space Profiles。首次启动会兼容迁移旧格式；遇到异常先记录版本和日志，再用无破坏性的退出/重启/ns reset，不要直接删除身份。完整清理只用于明确需要把本机作为新 Device 注册的场景。