千手使用文档

连接统一平台，或使用自己的控制器

千手已配置统一控制平台地址 https://qsnode.com/console。该地址在服务器部署完成后生效；域名已配置不等于服务已经通过上线验收，实际可用以连接检查结果为准。

使用统一工作台

1. 打开工作台。默认使用上述统一地址，也可以通过“设置工作台地址”选择其他实际控制器。
2. 创建账号或登录。同一个账号可以租用，也可以出租。
3. 选择方向。租客选资源；机主下载客户端并连接自己的电脑。

在本机自托管体验

从发布清单直接下载平台源码，准备 Python 3，解压后在项目根目录运行。平台控制器与接入出租电脑的设备连接器是两个组件。

python3 launch.py

本机控制器启动后，打开 http://127.0.0.1:8765/console，并可将其保存为工作台地址。

127.0.0.1 指正在使用的电脑。统一平台和本机自托管共用当前产品边界：模拟资金，GPU 与模型服务运行能力仍需接通和实测。

租用一份计算资源

1. 填写需要。在“一键找电脑”输入 CPU 份额、内存、时长和最高时价；镜像是可选条件。
2. 查看当前匹配。页面列出实际出租配额、当前预计冻结金额和最高预算。报价不占库存，最终在下单时重新匹配。
3. 确认租用。自动匹配默认只搜索真实可租工作区。没有供给时，可改条件，或手选带演示标记的设备体验流程。
4. 等到可连接。工作区 ready 确认后，租约中会出现“连接工作区”。

手选设备也可以下单。没有工作区能力的节点会显示“仅连通性节点”，不能把它租成完整计算资源。

余额不足时，“模拟补足余额并下单”会先增加测试余额，再尝试创建租约。两个步骤都不发生真实支付；失败时不要把它理解成订单已成功。

连接自己的电脑

1. 下载并打开原生连接器。下载中心会推荐 Mac 通用版或 Windows 安装版，原生应用已内置 Python。源码启动包面向进阶用户，需另外准备 Python 3。
2. 先登录并绑定账号。点击“登录并绑定这台电脑”，浏览器打开千手统一注册／登录页与设备确认页。核对自己的账号和这台电脑后批准，连接器会显示平台确认的机主、用户名、设备编号和平台域名。绑定不需要先安装 Docker，也不会自动开启寄售。
3. 选择份额、准备环境。选择“轻量”“均衡”或自定义 CPU、内存 GB 与每小时模拟价格，再“检查环境”。点击“一键安装 / 准备环境”：缺少 Docker Desktop 时从官方下载安装并核验；已有 Desktop 时复用并启动，Docker 引擎已就绪时只准备工作区镜像。许可、WSL 准备、系统管理员授权与必要重启仍需你确认；等待系统授权时可重试并允许继续准备。
4. 开始寄售。账号归属与环境核验通过后，点击“开始寄售”。只有算力中心确认有效心跳后才显示在线；已有租约或其他连接器仍在运行时，不允许直接修改出租份额。

同一千手账号可关联多台电脑，每台电脑持有独立设备授权。改名字、报价或资源份额继续使用同一设备编号；平台按账号 ID 记录订单、钱包和收入归属。

“出租时防休眠”仅在真实上线期间生效；可以另外选择防熄屏。暂停、断线或退出后自动释放，不修改长期电源配置，也不取消系统锁屏。笔记本请接电并保持开盖；无法阻止合盖、手动睡眠或关机。

最小化可继续运行；暂停寄售或关闭连接器会停止接单，保留本机账号绑定。“解除绑定”需要先停止寄售并确认，会撤销这台电脑的设备凭据；账号、钱包和其他电脑保留，再次接入需要重新授权。

“使用远程算力”进入订单的浏览器终端与小文件通道。网页使用统一账号登录会话；本机设备授权只用于这台电脑接入，不能代替网页登录或付款授权。进入网页管理时，请核对网页账号与期望操作的账号一致。图形远程桌面和 SSH 尚未开放。

账号卡始终显示核验结果：未绑定、正在核验、暂时无法核验或已绑定。网络失败、钥匙串锁定、系统拒绝访问时不会冒称已登录／已绑定。可点击重新核验，按系统提示解锁钥匙串或允许访问后重试。

前往下载中心，获取适合电脑的连接器 →

用账号确认设备归属

千手统一账号用于网页登录、订单、钱包和设备管理。连接器通过一次性配对让你在浏览器确认“这台电脑属于哪个账号”，本机不保存账号密码。

1. 在连接器点击“登录并绑定这台电脑”。浏览器自动打开；已有账号直接登录，没有账号先注册。
2. 核对网页当前账号、设备名称、硬件资料与配对码，再明确批准。仅打开页面或查看设备不会自动授权。
3. 平台把设备编号绑定到该账号 ID，发给这台电脑独立的设备凭据。连接器再向平台核验机主与设备编号，并显示在账号卡中。
4. 确认显示的是期望账号，再准备环境、开始寄售。设备绑定和实际出租是分别完成的操作。

电脑上的凭据如何保存

Mac 使用系统钥匙串；Windows 使用当前系统用户身份加密保存设备凭据。凭据不放进下载包、命令行、诊断或界面，不要求手动复制长期账号令牌。若系统保管库锁定或拒绝访问，点击重新核验并完成系统授权；不会把凭据改存为明文文件。

网页登录与设备绑定

网页通过登录会话管理账号，连接器只持有这台电脑的设备授权。网页切换账号不会自动更改已绑定电脑的机主；本机设备凭据不能用来登录网页、管理其他设备或发起付款。订单与收入根据平台保存的账号 ID 归属。

暂停、解除与更换账号

暂停或关闭连接器停止接单并保留绑定。需要换账号时，先停止寄售，在账号卡点击“解除绑定”并确认，再重新登录绑定。解除会撤销本机授权并清除本机凭据，其他电脑和账号钱包保留；历史订单与账本仍按原账号记录。配对码到期或已被使用时可重新发起，只批准自己正在操作的设备。

连接工作区与保存结果

真实工作区租约准备完成后，买方可以从租约进入网页命令终端。首选浏览器登录后打开订单中的连接入口。当前终端是非交互命令入口，不是完整SSH、TTY或远程桌面。交付说明可下载，短期凭据到期或订单结束后失效；页面不提供不存在的SSH密码或公网IP。

• 每条命令最多运行 30 秒。
• 同一租约的容器与 /workspace 文件保留。
• 长程序需由使用者自行管理后台运行。
• 租约结束后清理工作区，请提前保存需要的结果。
• 只有当前买方、有效且已就绪的真实工作区，才会开放终端。

pwd && python --version

“演示设备”只演示交易流程，不执行命令；“可连接”也不表示已验证 GPU 映射。用途由租客自主选择，平台不要求先选择业务任务模板。

查看模型来源与部署方案

模型库是可选的应用环境路径。你可以只租资源，不进入模型库；也可以先查模型资料，再规划运行环境。

1. 查来源。通过魔搭或 Hugging Face 官方仓库核对模型卡和许可。
2. 看方案。工作台整理运行框架、下载示例与部署前置条件。
3. 分清状态。生成方案不自动下载、部署、开通模型 API，也不开始模型服务计费。

Qwen3-8B 的官方总参数量为 8.2B。模型名字不能直接用来推算固定显存或速度；框架、精度、上下文与实际硬件组合仍需验证。

GPU 映射、持久模型缓存、镜像网络与服务运行尚未全部接通。当前“部署方案”不能当成已经运行的模型服务。

浏览当前整理的模型资料 →

钱包、支付与结算

DEMO模拟钱包和CNY人民币钱包独立记账，不能互转。购买时明确选择币种，支付来源为该币种的钱包余额；DEMO余额不能支付CNY订单。

DEMO模拟体验

模拟充值只增加测试余额，可体验冻结、计费和分账。不会形成真实付款、卖方现金收入或提现。

CNY商户预接入

微信和支付宝已经预留商户接入流程，但只有服务端完整配置并启用的渠道才提供真实支付单。商户未配置时显示“等待商户配置，暂不可充值”，不会用模拟付款替代。

真实支付单只有在服务端验签或主动反查核验后才可入账。扫码、关闭页面或点击刷新本身都不等于已经付款成功。

订单怎么扣费

• 下单在对应币种钱包预冻结最大预算。
• 等待和环境准备不计费；工作区ready回执后进入active，并设置计费起点started_at。
• 有效使用费用按该订单时价和平台费快照结算，不超过冻结预算。
• 当前默认演示平台费为10%，只影响分账；管理规则调整不追溯已有订单。
• 未使用预算仅解冻回同币种钱包。

钱包预算解冻不等于微信或支付宝原路退款。外部退款申请进入待审核，不应显示“退款已完成”。当前商户未配置不影响DEMO完整体验。

查看费用规则与模拟计算器 →

当前能力与使用边界

• 已实现流程：账号、双角色、CPU 资源租约、模拟钱包、短码配对、可选模型目录与方案。
• 依赖机主环境：Docker、镜像、份额限制、工作区真实执行与清理。源码启动包另需 Python 3，macOS 应用已内置 Python。
• 尚未接通：GPU映射、已经运行的模型API和提现尚未提供；微信/支付宝属于已预接入但等待商户配置的能力。控制器地址以实际部署为准。
• 没有连续在线保证：机主可以收回资源，设备也可能断网或关机。

发布文件存在、流程测试通过和目标设备实际运行，是不同的验证层次。请不要把其中一项当成全部能力已经验收。

查看完整能力状态 →

常见连接问题

官网能打开，工作台却打不开？

官网可以独立托管，工作台需要连接实际运行的控制器。确认已部署的服务地址，或启动自己的本机控制器，再使用“设置工作台地址”。静态官网无法代替控制器服务。

没有真实资源可租？

需要至少一台已连接、已开放工作区、当前在线且满足配置的设备。可以降低需要的份额，或者手选演示设备体验交易；演示不会被混入默认自动匹配。

下载需要登录？

源码启动包使用登录后的控制器下载接口；macOS 应用通过发布清单直接下载，已内置 Python。请勿把源码包与原生应用混淆。静态托管页面不会把请求失败显示成已下载。

配对码失效？

在客户端重新发起配对，使用新的短码。查看资料后仍需自己批准。

租约一直在准备？

检查机主客户端、Docker、镜像是否准备好。启动失败或掉线时，以租约状态和日志为准；不要把它当成已经可连接。

刷新后是否需要重新登录？

浏览器通过会话 Cookie 恢复登录。退出操作会请求控制器撤销会话；如果控制器暂时无法访问，页面会提示退出未完成。

控制器与接口检查

当前接口服务于自托管原型。健康检查与发布清单可用于确认本机控制器是否可访问；账号、租约与设备操作仍需授权。

curl http://127.0.0.1:8765/api/health

curl http://127.0.0.1:8765/api/releases

官网读取发布清单展示文件状态，但不会把控制器可达等同于所有节点和容器都正常，也不会据此生成虚构可用率。

检查控制器与能力状态 →