把软件发给别人前，先补齐这几个入口

补记说明：本文于 2026 年 10 月 25 日整理并首次发布。页面日期是这份经验的归档日期，历史案例与当前开放状态分别说明。

自己做一个 App，最容易兴奋的时刻，通常是功能第一次跑起来。

两台设备终于能连上，问一句日语终于有了回答，录下来的声音终于能回听。到了这一步，我很容易觉得：差不多可以给别人试试了。

但把链接发出去之前，还有一些问题：他用的是哪台设备？从哪里安装？需要谁邀请？输入的东西去了哪里？用不了的时候，该找谁？

最近整理咫尺、日语随记和陪练的产品页，我花了不少注意力在这些问题上。它们看起来不像新功能，却决定一个人拿到产品后，能不能顺利开始。

先把“现在怎么用”写明白#

下面的产品状态来自 10 月 24 日整理的资料。咫尺是一款双人互动 App，当时是受邀内测。iPhone 和 Mac 走 TestFlight（Apple 的测试版分发工具），安卓有自己的下载入口，鸿蒙的安装方式也要单独说明。这和写一句“支持多平台”，给人的帮助完全不同。

日语随记主要在手机上整理日语问题，陪练主要在 Mac 上继续学习。同样，日语随记已经进入自用内测，不等于陌生访客打开产品页就能下载。陪练已有签名自用版，也不等于公开分发和在线更新都已经做好。

我现在整理介绍页，会先回答三个问题：谁能用、在哪用、从哪一步开始。 没有开放的入口就把状态写清楚；已经开放的入口，尽量让人少绕一层。

如果你也准备把自己的工具发给朋友，可以先把这三个答案写在下载按钮旁边。很多时候，缺的就是这一小段话。

做日语随记时，从功能角度看，拍照提问是一条很短的路径：拍照、识别、解释、留下笔记。

换成使用者的角度，问题就变了：照片是在手机上识别，还是发到别处？讲解时会处理什么文字？笔记只在本机，还是会跟账号同步？

现有说明里，照片先在本机识别；是否开启学习同步，会影响题目照片、普通提问和笔记的保存方式。这些区别不能藏在一句“支持云同步”里。随记与陪练可以同步的内容，也要和仍留在本机的朗读录音、学习板等内容分开解释。

我给自己留了一个很小的检查表：

这张表是我核对产品行为的方法。页面上的说明还要和实际版本一起检查；写了说明，并不会自动让功能按说明运行。

“有问题联系我们”太容易写了。但收到一句“用不了”，往往还得来回问好几轮。

我希望支持入口能先帮双方补齐一点上下文：用的是什么设备和版本，卡在哪一步，屏幕上有没有错误提示。涉及截图或录音时，也应该提醒使用者只提供排查需要的部分。

对我来说，好的支持页应该让人知道下一步能做什么。比如入口还没开放，就说明当前邀请方式；某项能力仍在内测，就说清已知范围；暂时解决不了，也留下一个能反馈问题的位置。

这会反过来影响我做功能的方式：如果一项能力很难向别人解释清楚，也许它的边界还需要再理一遍。

我给自己定的做法很简单：从产品页开始，假装没看过源码，也不知道开发时的那些默认前提，沿着安装、首次打开、完成一次操作、找到帮助这条路走一遍。

能安装，和能完成第一次使用，中间还隔着很多小事。受邀内测、公开测试、正式上架也各有不同的完成条件，不能互相代替。

这轮页面整理没有替产品完成正式上架，也没有证明每台设备都已经验收通过。但它让我更容易看见接下来要补什么：入口是不是准确，数据说明有没有落后，失败之后能不能找到人。

下次再介绍一个新功能时，我想把这条使用路径一起交出去。

下面按公开说明构造一份走查示例，方便说明要看哪些点，不是本轮新增的设备验收记录。

如果朋友想在 Mac 上试咫尺，首先应该看到需要 TestFlight，以及需要先有已登录的手机 App。到了 Mac 登录码这一步，说明要能接住“去手机哪里扫码、在哪里确认”，不能只给一个下载按钮就结束。

如果朋友只是想把一句日语留下来，日语随记的介绍应该让他知道当前仍无公开下载。已有内测用户还要看清笔记自动保存和同步是不同设置，登录也不会自动把设备里的全部历史上传。

如果想在陪练里朗读一段，则要知道录音与系统转写在本机完成；需要文字 AI 时是另一条处理路径。朗读录音和随记模块里的题目照片，也不能因为都叫“学习记录”就混为同一种同步内容。

走查最后再故意停在一个失败点：没有权限、入口不可用，或者操作被打断。页面应当保留用户已输入的内容，并给一个能理解的下一步，而不是只留下“请重试”。

问题反馈也要有所取舍。设备类型、系统与 App 版本、可复现步骤通常比整份数据库更有帮助。截图先遮掉姓名、聊天和学习内容；没有排查需要时，不让使用者交出完整录音或原始资料。

相关入口：咫尺、日语随记、陪练。文中的状态以 2026 年 10 月 24 日整理时为准。