third-party-handoverlisted

# 交付给非技术用户（设备 / 账号 / 服务） 用于「帮朋友/家人/合作方把一台设备、一个服务、一个账号弄好，然后交出去」这类任务的**最后一公里**。对方不懂技术、出问题只会找你，所以交付物必须自带回滚路径。 触发场景：给朋友刷好的路由器、给家人的小工具/账号、给合作方的站点或服务、任何要求「做一张纸让对方照着用」的活。 ## 硬规矩（每次都适用） 1. **交付四件套，缺一不算交完**：① 能用的东西 ② 一页纸说明书 ③ 回滚路径 ④ **当面演示一次回滚**。 2. **一页纸的第一步永远是「怎么回到原样」**：写在“出问题怎么办”第一条，必须是一个动作（拔线/关掉/点某个按钮），不是排查步骤。 3. **凭据只手写、当面给，或只让他看屏幕**：账号、订阅、密钥不通过聊天工具发文字（聊天记录等于云备份）、不写进云端文档、不进公开仓库。他本人要用的**本机服务**，用「在他屏幕上显示」代替发密码：`open -a Terminal <启动脚本>`（把凭据打在窗口里，并告诉他“以后想看就双击这个脚本”），或 `pbcopy` 到剪贴板让他直接粘贴登录。 4. **给对方的部分只留「够用」的信息**：不写协议/实现细节、不写远程管理入口、不写你自己的其它资产。 5. **不承诺你验证不了的事**：给非技术用户的说法只能是实测过的现象（“能打开某页”“能连上”），不能是“理论上应该没问题”。**交付前自己完整跑一次冷启动**（先停掉它，再从零跑一遍启动脚本），并用**你要交给他的那套凭据真的登录一次**——自报“应该能用”不算验证。 6. **敏感话题用能力名，不用话题名**：一页纸同理，写法按对方能不能拿去求援来定，不按你自己的技术叫法。 ## 流程 1. **先确认对方环境**：他现有的网络/设备是什么、哪一步绝对不能动。改别人家网络的代价不对称。 2. **选最小侵入的接法**：能旁挂就不替换、能只影响一台设备就不影响全屋——回滚成本越低越好。 3. **装通，同时建档**：固件/版本、后台地址、账号、密码、原厂（初始状态）包的位置，随手记下，不要靠回忆。 4. **做一页纸**（模板 `templates/handover-onepager.html`）： - **一份文件、两个区**：`@media print` 里隐藏 `.private`（只给自己看的档案/凭据/验收清单）。不要维护“给人版”和“自己版”两份文件——它们必然不同步。 - 结构固定：它是什么（含“坏了不影响你”）→ 怎么用（含“能用”的可验证标准）→ 出问题怎么办（第一条回滚）→ 千万别做的三件事。 - 凭据区明确写“手写、不留电子版”。 5. **验证打印产物**（`scripts/verify_print_deliverable.sh`）：页数必须 1 页；私密关键词在 PDF 文本里 0 命中、正文关键词 ≥ 1；截图用视觉能力自己看一眼。 6. **当面交付 + 演示回滚**，三句话足够：这东西接在哪、坏了不影响你；万一不对第一件事是做 X，你看我做一次；记不住没关系，都写在纸上。 7. **留档**：把档案区填好，存在本机不公开的文档库（不进仓库、不进云盘），并记下交付日期与对方联系方式。 ## 打印验证（HTML → PNG + PDF，可重复执行） ```bash bash scripts/verify_print_deliverable.sh <绝对路径.html> \ --private "线路信息,设备