LSZW 云端知识库：新 Windows 电脑完整操作说明
适用日期：2026 年 11 月 9 日。本包用于浏览器访问云端知识库。
1. 你将获得什么
- 浏览器入口：https://lszw.kuantanai.com/kb/
- 权限：viewer，可以检索、查看知识资料、查看原生图片、按需下载模型与资料文件。
- 当前活动版本：v0.3.0-curated-20261104，1,569 个案例。当前案例向量 1,556 个；关键词检索与图像语义检索覆盖口径不同。
- 一份尚未使用的独立激活文件。请在 2026 年 11 月 16 日 14:58（北京时间）之前完成首次激活。设备授权从激活时开始计算 30 天。
无需安装 LSZW 桌面客户端、Rhino、Python、Node.js，也不需要 SSH、数据库密码或管理员权限。 知识库通过 HTTPS 网页访问。只有你主动下载的模型、图片等资料会保存到本机。
本包包含私人激活文件，请单独交给这台新电脑的使用者，不要上传到公开下载站或公开群。
2. 操作包中的文件
| 文件 | 用途 |
|---|---|
| 先看这里.html | 可离线阅读的完整说明，双击即可用浏览器打开 |
| 完整操作说明.md | 同一份说明的 Markdown 版本 |
| 打开云端知识库.url | Windows 网址快捷方式，双击进入正式 HTTPS 页面 |
| authorization/activation.json | 本台新电脑的首次激活文件；不是安装程序 |
| tools/检查网络.ps1 | 可选的网络诊断，只读检查公网服务状态，不读取激活码 |
| tools/校验操作包.ps1 | 可选的操作包 SHA-256 完整性校验 |
| SHA256SUMS.json | 包内文件的大小与 SHA-256 清单 |
| web-source/ | 已部署网页的源码副本，留档用，无需在 Windows 运行 |
| 网页验收记录.json | 浏览器和云端验证摘要，不包含激活码或登录令牌 |
3. 首次使用：从 ZIP 到登录
- 把整个 ZIP 复制到新 Windows 电脑。
- 右键 ZIP，选择“全部解压缩”。例如解压到
D:\LSZW-Cloud-Access\或“文档”目录。 - 双击
先看这里.html阅读说明。 - 双击
打开云端知识库.url。也可以打开 Edge 或 Chrome，在地址栏输入https://lszw.kuantanai.com/kb/。 - 确认地址栏是上述 HTTPS 域名。页面应显示“灵塑造物 · 云端知识库”和服务状态。
- 在“激活这台电脑”区域，点击“激活文件”，选择本包
authorization文件夹中的activation.json。 - 页面提示文件已读取后，在“电脑名称”填一个能辨认的名字，例如“设计室-张三-Windows”。
- 点击“激活并进入知识库”。激活码只在你点击这个按钮时提交给云端。
- 页面出现设备名称、viewer 权限、到期时间，以及“已连接……共 1569 个案例”，表示已进入知识库。
如果不方便选择文件，也可以用记事本打开 activation.json，只复制 activationCode 对应的值，粘贴到网页“激活码”输入框，不要复制引号或整段 JSON。
激活码只能使用一次。 以后在同一台电脑、同一个浏览器的同一个用户配置中，直接打开网址即可恢复会话，不必重复激活。不要用无痕窗口做首次激活；无痕窗口关闭后会丢失登录状态。不要把 JSON 中的激活码当作每次登录的密码。
首次点击后如果网络超时，先刷新当前网页，查看能否恢复已保存的会话。如果仍显示激活不可用，请联系管理员核对，勿连续重复点击。
4. 日常检索
4.1 关键词或文件名
- 选择“关键词 / 文件名”。
- 输入短关键词，如“镶座”“戒指”“心形”，或模型文件名的一部分，如“6021”。
- 点击“检索”。结果按案例展示；有后续结果时，使用“下一页”。
- 没有结果时先缩短检索词，或改为中文描述搜图。
4.2 中文描述搜图
选择“中文描述搜图”，输入如“心形戒指”“四爪圆形宝石镶座”。它根据文字与图片的相似程度排序。相关度分数用于排序，不等于识别准确率、质量评分或生产批准。
4.3 以图搜图
选择“以图搜图”，选择 PNG/JPEG 参考图片，再点击“检索”。图片建议小于 5.7 MB。此功能会把你选择的图片发送到本知识库服务器用于检索；不会修改本地原图。
4.4 找相似款与预览
每条结果可点击“找相似款”。语义检索结果如有图片，可点击“预览图片”。关键词结果不一定带图片预览按钮，可在详情的相关文件中查看图片。
5. 查看知识记录
- 在结果上点击“查看资料”。
- 页面下方显示当前文件、范围、摘要和可读取的记录类别。
- 点击“部件”“观察与描述”“尺寸记录”“连接关系”“曲线”或“建模方法”。只有该范围确有记录的类别才会显示按钮。
- 点击某条记录展开内容。记录按服务器原字段显示；不要把缺失字段推断为已经完成的结论。
- 记录较多时，点击“继续读取下一页记录”。
详情可能只对应命中的一个部件范围，并不自动代表整款所有部件都经过审核。历史观察、模型响应、人工确认和制造批准是不同状态。历史尺寸没有完成实物比例校准，不能直接作为制造参数。
6. 按需下载模型或图片
只查看知识记录时，无需下载任何客户端或模型。
如需要原始资料：
- 在搜索结果中点击“获取模型下载链接”，或在详情“相关文件”中点击“生成查看 / 下载链接”。
- 点击新出现的“打开模型文件 / 另存为”或“打开文件（另存为）”。
- 浏览器将从腾讯云 COS 获取该文件。图片一般直接显示；可右键“图片另存为”。模型可能直接下载，也可能需要按浏览器提示另存。
- 如果模型下载时没有原文件名，按搜索结果中显示的原文件名保存，保留如
.3dm的扩展名。 - 下载链接约 5 分钟有效。失效时回到页面重新检索、重新生成，不要把临时链接作为长期资料链接收藏。
如需核对文件：在下载文件所在目录打开 PowerShell，运行：
Get-FileHash -LiteralPath '.\你的模型文件.3dm' -Algorithm SHA256
将输出与网页相应文件的 SHA-256 逐字比较。网页生成下载链接不代表已替你完成整文件校验。
7. 登录保存、续期与换电脑
- 登录续期信息保存在当前浏览器的本地网站数据中。使用专用 Windows 账号和固定浏览器配置。
- 正常关闭标签页、关闭浏览器，或重启电脑后，再访问同一网址会尝试恢复会话。
- 清除网站数据、重装浏览器、更换浏览器配置或改用另一台电脑，不会自动继承授权。
- “退出并清除本机登录”会注销当前云端会话。原激活码不能重复使用；再次使用需要管理员重新签发授权。因此自己的固定电脑日常使用完，直接关闭页面即可。
- 设备授权为激活起 30 天。到期或被管理员撤销后，请联系管理员续发。
- 设备名称只是便于辨认的标签。本授权以激活后建立的设备会话为依据，并非硬件锁定；不要转发激活文件或复制浏览器登录资料。
8. 常见问题与处理
| 现象 | 处理 |
|---|---|
| 网址打不开、连接超时 | 先确认电脑能上网；试 Edge/Chrome；运行网络检查；让网络管理员放行本文第 9 节域名的 HTTPS 443 |
| 看到证书警告 | 不要跳过证书检查；检查 Windows 时间，联系管理员确认域名与证书 |
| 看到 JSON 或 404 | 使用完整 /kb/ 地址；/v1/health 只用于诊断，不是知识库界面 |
| 激活不可用 | 可能已用、已过期；同一浏览器先刷新恢复会话，仍失败则请管理员查授权状态 |
| 激活后不记得登录 | 确认不是无痕窗口，浏览器允许本网站存储数据，也没有自动清除网站数据 |
| 401 / 登录失效 | 先刷新尝试续期；持续失败时请管理员核对，不能反复使用旧激活码 |
| 403 / 资料无权限 | 先重新检索，排除 5 分钟引用过期；仍失败时记录案例 ID 联系管理员 |
| 检索为空 | 缩短关键词、换用同义词或中文描述；不是每个历史字段都有中文描述 |
| 下载返回 403 | 链接可能过期；重新检索并生成新链接 |
| 下载返回 404 / NoSuchKey | 服务器登记了资料，但该对象当前不在 COS；记录案例 ID 和文件 SHA-256，交管理员修复，不要重复激活 |
| 无法以图搜图 | 使用 PNG/JPEG，压缩到 5.7 MB 以下；图片会发送到云端检索 |
| 页面提示 503 | 服务暂不可用，稍后重试并联系管理员 |
现有云端资料中，验收时发现个别历史文件可取得授权链接、但 COS 返回 404 NoSuchKey。网页访问与资料读取不受这个单文件缺失影响；这不表示整个资料库已经逐文件验证完整。具体缺失摘要见本包验收记录。
9. 网络和环境要求
- Windows，推荐使用当前版本的 Microsoft Edge 或 Google Chrome。
- 可访问
https://lszw.kuantanai.com的 HTTPS 443。 - 预览或下载资料还需访问
https://jewelry-knowledge-prod-1398034167.cos.ap-shanghai.myqcloud.com的 HTTPS 443。 - Windows 日期、时间和时区应正确。
- 不需要开放本机入站端口，不需要访问 PostgreSQL 端口 5432，不需要 SSH 22 端口。
可选网络检查：在解压目录打开 PowerShell：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\tools\检查网络.ps1
该命令的执行策略只对这一次进程生效，不修改系统全局策略。检查结果只包含公开的服务状态，不会读取激活文件或提交登录。
可选操作包校验：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\tools\校验操作包.ps1
10. 新电脑交付验收
首次在新电脑使用后，逐项确认：
- 打开
/kb/页面，看到“服务正常”。 - 用本包激活文件成功进入，设备名称与授权到期时间正确。
- 搜索“镶座”或“戒指”，出现真实案例。
- 打开某案例的资料，展开至少一条记录。
- 刷新网页后能恢复登录；关闭浏览器再打开也能恢复。
- 如需下载，再选一份资料下载；需要严格核验时比对文件大小与 SHA-256。
管理员已在 Linux 上使用 Chromium 测试网页与真实云端接口。新 Windows 电脑上的首次激活、网络和浏览器行为，需要由使用者按本节确认；未把其他电脑上的测试冒称为这台新电脑已验收。
11. 需要管理员协助时提供什么
发送：问题发生时间、浏览器名称、网页错误文字、案例 ID、相关文件 SHA-256（如有）。不要发送激活码、浏览器本地存储内容、登录令牌、数据库密码或云存储密钥。
此 ZIP 是私人访问操作包，包含一份新电脑激活文件。公开网页源码和私人授权文件已分开；服务器仅部署 web-source 对应的网页，不部署授权文件。