第一课 · 看成品时看这四样
打开 首页。不要先读后面的决断卡。按这个顺序看,看完再 打开示例。
- 标题是不是只讲一件事。这里是 NexDo:本地文件,不是团队云。
- 第一屏有没有一个真能点的动作。这里是「打开示例」和「下载 iOS 版」。没有空的下载按钮。
- 顶栏只有「使用说明」。打开它,目录最后一节是「本站怎么做的」。Lab 和 Tax 在 Blog 与 About 之间。
- 页脚是不是只有隐私政策和服务条款。留言在页面中部,不在页脚。
第二课 · 把要求写成四句
模型做不成「帮我做一个和这个站一样的站」。它做得成「打开这个地址,应看到这句话」。一轮只写四句:
- 谁在用,做完要看见什么。
- 这次不改什么。
- 打开哪个地址,看到哪句话或哪一个数字,算做完。
- 看过现页。不对就退回这一稿,再做下一件。
这个站上说清了的一轮:谁是没登录的访客;不要把他送回首页;打开材料抽取,应停在「没有这个页面」,地址不变。做完就是这样。说了但做歪的一轮:第一屏收成一张小图,没写「不能比原来差」,看过之后整屏退回。五轮连着看在 十月这一串。
第三课 · 自己先做一页
不要从后台、账号、远控开始。先做一页:一个标题、一句话、一个按钮。按钮指向你已经有的示例。做完用浏览器打开,三样都在第一屏,点按钮能到那个地址。可复制的四句在 第 10 章。
模型在这个站上还做过、而且现在能打开核对的事:留言选项和保存类型一致;首页看板和后台状态用同一套说法;博客一天只发有限篇,套话不照发。这些在下面的课例里,第一遍可以跳过。
使用说明的六页只教访客怎么打开、怎么用。这一页教要求怎么写。两份正文不并成一篇,顶栏也只有使用说明一个入口。值班用的操作说明不公开。想把成品和要求对上,先打开下面每一行,再按那一行写的章去看要求。
本站自己的课例
上面三步是这门课的目标:看成品,把要求写成四句,自己做一页。下面的章是这个站上已经能打开核对的决定。用法在使用说明里,不要在这里再找按钮。
- 1. 这个站有什么已写
- 2. 要求怎么写已写
- 3. 首页怎么收成 NexDo已写
- 4. 谁能进哪一扇门已写
- 5. 访客怎么参与已写
- 6. 说明为什么拆成两本已写
- 7. 内容怎么留下来已写
- 8. 远控公开到哪已写
- 开发进程2026-03 起
- 9. 记录怎么读已写
- 10. 自己做一个最小站点已写
打开示例
1. 这个站有什么
按钮和预期写在 使用说明 · 先这样用。这里不把那张表再列一遍。
这一层只留下还要守住的话:首页第一屏只讲 NexDo,第二屏是 NexControl。其他作品默认收起。注册之后,主站账号用来使用需要身份的能力。这个口令打不开 NexDo 的网页工作台,示例仍然可以直接打开。远控要登录并获授权才能看自己的设备。安装包还没有对公网放行。
技术上是这样叠的。访客看到的首页、关于页、法律页和这一页,都是站点上的页面。主站一个进程同时给出这些页面和留言、概述这类接口。公网先到隧道,再进这个进程。NexDo、博客、项目管理、远控是旁边的进程。公网上有的地址会先记一笔访问,再转到旁边那个进程。端口是事先写好的,不是每次启动临时抽一个。密钥、本机路径和连接步骤不写在这门课里。
2. 要求怎么写
向模型提一件事,写成四句。缺了验收句,做完也无法判断是不是那一件。
- 谁在用,做完要看见什么。
- 这次明确不改什么。修一处,不许顺手改另一处。
- 怎样算做完:打开哪个地址,应看到哪句话,或哪一个数字对得上。
- 做完用现成页面验收。对不上现在页面的过程,不写进这一页。
说清了的例子是抽取入口:要求写的是「不要送回首页」。做完后地址还停在抽取页,正文是「没有这个页面」。
说了但做歪的例子是首页第一屏:收成一张小图之后,没有写「不能比原来差」。看过之后整屏退回。见 首页命名。
只做了一半的例子是留言:下拉里已经有「想让我实现」,保存时不认识这个类型,存成了「产品建议」。见 留言分类。
一轮对话是这样来回的
- 你说要看见什么,以及不要动什么。例如:「没有抽取权限的人,不要被送回首页。」
- 我改一处,并说打开哪个地址对。例如:抽取页停在「没有这个页面」,地址不变。
- 你看现页。对了,才做下一件。不对,就退回。首页第一屏收成小图之后,看过认为不如原来,整屏退回。
不是把一年的要求一次说完。一件对上现页,再提下一件。对话原文不贴。下面按时间写开发进程,只保留还能在页面上对上的阶段。
开发进程
版本记录从 2026-03-28 的 1.0.0 记到现在,大约一千九百条。带标题的大约一千条,从 2026 年 8 月才开始在标题上写清这一版做了什么。更早的月份只有版本号和改动列表。下面收成四段。每一段是很多次对话叠出来的,不是一条对话。四段后面有十月连续五轮,可以顺着看一件怎么接到下一件。
2026-03 · 先钉事实
- 记录
- 1.0.0,2026-03-28。这一版建立版本号,并要求需求、设计、接口、架构和测试互相指得上。术语收成首页、管理后台、NexDo。
- 对话
- 先问「现在的代码到底是什么」,再改文档。文档不能写成还没做出来的样子。
- 留下
- 以后每一版都能按版本号找回。这一页用的就是这份记录,但不按条展开。
2026-04 至 05 · 公开页一件一件能打开
- 记录
- 5 月 6 日,行情公开页开始标明美股、港股、A 股,并出现刷新和查看分析。5 月 27 日,后台写文章的区域可以收起侧栏,把正文和预览拉开。
- 对话
- 一次只加访客能点到的一个动作。加完就打开那个页面看,不把整站重做一遍。
- 留下
- 行情站和管理后台的写法:页面上多一个动作,就要有对应的验收。
2026-06 至 08 · 远控按手感收,不写完成
- 记录
- 6 月仍在收手机上的全屏、输入和回到前台后的连接。8 月标题里大量是远控的手感问题,月末材料抽取也开始出现在标题里。8 月带标题的记录有五百多条。
- 对话
- 你指出一个手感问题,我只改这一处,你在真机上看。比原来差就退回。没有说「已经很稳」之前,不写成体验完成。
- 留下
- 公开页只有介绍和宣传片。连接怎么做、当时排障的细节,不进这门课。见 远控的公开边界。
2026-09 至 10 · 工具、说明、这门课
- 记录
- 9 月 1 日,材料抽取把表格先收成可读的表。9 月中,项目管理里的数据血缘按任务分行。10 月,使用说明改成访客能读的六页,这一页开始写「要求怎样变成页面」。
- 对话
- 仍然是一件对上现页再提下一件。使用说明只教怎么用。这门课才教怎么要求。两本不要并成一本。
十月这一串,可以连着看
下面五轮是连续发生的。每一轮只做一件,看现页之后才做下一件。对话原文不贴,对应的卡可以点开。
- 首页第一屏被收成一张小图。看过之后不如原来,整屏退回。见 首页命名。
- 没有抽取权限的人不要被送回首页。地址停在「没有这个页面」。见 抽取入口。
- 选「想让我实现」却被存成「产品建议」。允许列表补上这个类型。见 留言分类。
- 首页三列和后台状态对不上。按同一套状态重分。见 公开看板。
- 课写好了,顶栏却看不到。使用说明后面加上「本站怎么做的」,Lab 和 Tax 仍在最后。
3. 首页怎么收成 NexDo
首页命名
- 怎么说
- 首页产品名只用 NexDo。第一屏先讲这一件:本地文件,不是团队云。要有「打开示例」和「下载 iOS 版」。不要把名字换成读起来像「下课」的另一个词,也不要在头几行把 NexDo 重复三遍。
- 不做
- 不改顶栏顺序。不把 YouCare、行情、墨守加回前两屏。不在页脚再重复顶栏。
- 否定
- 第一屏曾收成标题、一句、两个按钮和一张小示意图。看过之后认为不如原来,整屏退回。三句说明和三张说明卡回到按钮下面。
- 哪一层
- 只改首页这块文案和排版。示例仍打开任务站的示例图谱,iOS 仍进应用商店。这一页的入口在顶栏「使用说明」后面,Lab 和 Tax 仍在最后。第一屏辅助链接里也有。手机菜单里「使用说明」下面同样有。
- 实现
- 改的是首页这一份页面和样式。任务站本身没动。顶栏、手机菜单、第一屏辅助链接三处写的是同一个地址。
- 验收
- 打开首页。标题是 NexDo。说明是三句。按钮是「打开示例」「下载 iOS 版」。下面三张卡是「免费 · 不注册」「数据在这台设备」「看清阻塞再动手」。辅助链接是「NexControl 介绍」和「使用说明」。
- 锚点
- 1.0.1881 · test_homepage_stops_false_promises
- 不公开
- 改稿时的对话原文。
4. 谁能进哪一扇门
角色权限
- 怎么说
- 角色治理要能勾到当前目录里的产品,不能只有原来那十来个后台键。选权限不要平铺成一排胶囊。勾上之后,主站已经能拦住的入口要真的放行;公开首页不要因此关掉。
- 不做
- 不改远控的连接热路径。普通用户和游客不自动获得新键。独立进程仍用各自的登录。
- 否定
- 先做了一排平铺的权限。产品一多就没法看。后来改成三组,组默认收起,可以搜索、只看已选、按组全选。
- 哪一层
- 权限目录分成后台控制面、本机运维、子项目。监控认「本机监控」或原来的系统配置。抽取认「材料抽取」或系统配置。模型调度台认「模型调度台」或访问日志。后台类的键仍要同时有管理后台入口。新产品键可以单独放行。
- 实现
- 改的是权限目录和放行。新产品的键可以单独通过。原来的后台键仍要同时有管理后台入口。超级管理员和管理员在启动时补齐新键。普通用户和游客不自动获得。
- 验收
- 只给监控的人能打开监控,打开抽取会看到打不开的页面。只给抽取的人相反。原来有系统配置的人,两处都还能进。
- 锚点
- 1.0.1879 · test_admin_role_product_grants
- 不公开
- 谁有什么权限,以及后台怎么进去。
5. 访客怎么参与
留言分类
- 怎么说
- 首页留言下拉里的每一个选项,保存后都要还是这个类型。选「想让我实现」,后台不能显示成「产品建议」。
- 不做
- 不把留言原文自动公开。不改「至少 8 个字」和「整理后才上公开墙」。
- 否定
- 页面有这个选项,服务端的允许列表里没有。不认识的类型被一律改写成产品建议。通道是通的,分类是错的。
- 哪一层
- 允许的类型补上「想让我实现」,和首页下拉、后台标签用同一个名字。提交成功只表示已收到。公开墙仍只读管理员改写后的标题和摘要。
- 实现
- 改的是保存留言时的允许列表,让它和页面下拉用同一组名字。列表里没有的名字,才会落到「产品建议」。
- 验收
- 首页选「想让我实现」发一条足够长的留言。后台类型是「想让我实现」。首页公开看板不出现原文。
- 锚点
- 1.0.1882 · test_feedback_category_and_board_match_admin
- 不公开
- 留言正文和联系方式。
公开看板
- 怎么说
- 首页「评估中、进行中、已发布」必须跟后台状态是同一本账。后台标成评估中,首页不能把它放进进行中。
- 不做
- 不在首页展示留言原文、称呼和联系方式。
- 否定
- 只有「已读」进评估列,其余状态几乎都进进行中。已上线也不会进已发布。评估列空着的时候,页面上还会露出一段没填上的模板代码。
- 哪一层
- 公开看板按状态分列:新留言、已读、评估中在左列;实现中在中列;已上线、已处理、已写复盘、已归档在右列。空列只写人话,不写模板。
- 实现
- 改的是首页把后台状态分到三列的那段逻辑。空列的句子直接写成中文,不再留下没填上的模板。
- 验收
- 打开首页留言区的三列。已发布的公开提议在右列。没有被整理公开的新留言不出现在这三列。
- 锚点
- 1.0.1882 · publicIdeaColumn
- 不公开
- 访客留下的原话。
6. 说明为什么拆成两本
当时拆开的是「访客怎么用」和「值班怎么管」。值班那一册仍然不公开。访客现在只进使用说明:前六页是怎么用,这一页是怎么要求。法律页和管理概述的卡也放在下面:一个管页脚条款,一个管后台那本账,都不另开章。
公开手册
- 怎么说
- 给来逛站的人一本说明:有哪些产品、不注册能做什么、注册之后账号管什么。内部怎么值班、怎么排障,不放进这本。
- 不做
- 不把操作员手册改写成公开教程。不在说明书里写主机、隧道和后台地址。
- 否定
- 曾有一本从环境到排障的操作员册。它适合值班,不适合访客。若整本公开,产品怎么用和机器怎么管会混在一页里。
- 哪一层
- 公开的只有六页,由使用说明这个入口读:产品关系、先这样用、NexDo、NexControl、主站入口、账号与条款。操作员那一册不从站点发出去。
- 实现
- 公开说明单独做成六页。操作员手册留在仓库里,这个站点不把那一册发出去。
- 验收
- 打开 使用说明。能看到六页目录,读得到「打开示例」。读不到排障和主机操作。
- 锚点
- 1.0.1876 · test_manual_public_reader
- 不公开
- 运维步骤和排障。
法律页
- 怎么说
- 访客要能核对这个站收集什么、使用上有什么约定。这两个链接只放页脚。顶栏留给产品入口。
- 不做
- 不在首页第一屏再放一套法律按钮。不把账号注销流程写进这一轮。
- 否定
- 法律链接若再进顶栏,就和 NexDo、NexControl、使用说明挤成两套导航。页脚已经是核对条款的地方。
- 哪一层
- 两份静态页:隐私政策写本地文件、官网注册与扫码、远控涉及的屏幕和文件、实验场和项目管理。服务条款写使用规则和账号约定。使用说明的账号页只指向这两份,不另写一套。
- 实现
- 两份页面是静态的,只从页脚链出。使用说明的账号页只指向它们,不另写一套约定。
- 锚点
- 公开手册 · 账号与条款
- 不公开
- 账号数据和内部注销流程。
管理概述
- 怎么说
- 管理概述要能扫完:先看这段时间的总数,再看走势,再看异常,最后看谁来了、去了哪。点一个数字,打开的明细必须和这个数字是同一口径。
- 不做
- 不把安全再做成左侧另一套页面。不在这一页公开访客明细长什么样。
- 否定
- 异常曾想单独占一个顶栏。点「区间总访问」若打开的是另一套筛选,总数和明细就对不上。错误占比、独立 IP 也各自要打开自己那一笔,不能混用。
- 哪一层
- 概述页的阅读顺序固定为四段:区间总访问,趋势与入口,异常切片,谁来了、去了哪。点总数打开同一时间范围的访问明细。点错误占比打开状态码不低于 400 的记录。点独立 IP 打开的是访问次数,不是另一份名单。
- 实现
- 概述页的四个区块和点开的明细共用时间范围和状态条件。点哪个数字,就带上那个数字自己的条件。
- 验收
- 概述页从上到下能按这四段读完。点区间总访问后,明细的时间范围和总数是同一段。
- 锚点
- 1.0.1878 · test_admin_stats_query
- 不公开
- 后台怎么登录,以及访客明细。
7. 内容怎么留下来
博客发稿
- 怎么说
- 自动文章一天最多三篇。素材分不够就丢掉,不凑第四篇。套话不能照发。改不干净就删稿退料。事实对不上、有安全问题,或者分数跌破底线,直接不发。
- 不做
- 不把模型自己报的总分当成最终分。不按某一天的实测分数去改门槛。不在公开课里写密钥和模型调度地址。
- 否定
- 门槛曾经定得比发给评审的分档更严,一批稿被自己的流水线删掉。后来又按某一次模型的输出把门槛往下挪,同样的稿会再次全灭。门槛必须和分档表成对出现。
- 哪一层
- 本地模型只出初稿。专家复审、润色和发表前的修改走单独的复核。四项分开打分,由代码求平均。可发布的起点是 82 分,70 分以下必须拦住。90 分以上可以直接发,82 到 89 分小改后可发,70 到 81 分要人工再看。
- 实现
- 门槛写在发稿代码里,并且和发给评审的分档表成对。分数是四项平均,不采用模型自己报的总分。
- 验收
- 公开博客上看得到已发的文章。看不到当天第 4 篇自动稿,也看不到还带着套话的原稿。
- 锚点
- 分档表 · 82 / 70
- 不公开
- 模型密钥、调度地址、未发表原稿。
8. 远控公开到哪
远控的公开边界
- 怎么说
- 手机可以当电脑的操控面,但公开页只介绍产品。安装包没有对公网放行之前,首页不放空的下载按钮。没有宣称「已经很稳」之前,不把体验写成完成。
- 不做
- 不写连接怎么建立,不写端口、密钥和操作步骤。不控制没有授权的设备。
- 否定
- 把内部排障和连接过程写成公开教程。那会把「别人来学习产品决定」做成「别人来复制进门办法」。
- 哪一层
- 公开的是首页第二屏的宣传片,以及 六页介绍。使用说明里写:登录后才能看自己的设备;电脑侧需要辅助功能、屏幕录制和完全磁盘访问,只为完成这一次操控。约定写在隐私政策和服务条款。
- 实现
- 公开页只增加介绍和宣传片。安装包放行之前不放下载按钮。连接过程不进任何公开页。
- 锚点
- 公开手册 · NexControl
- 不公开
- 连接、中继、打洞和主机操作。
9. 记录怎么读
不要按版本号读
- 怎么说
- 站点是长年累月改出来的。要让后来的人看见「我怎么要求、做成了什么」,但不能把每一次版本都贴出来。
- 不做
- 不按日期把变更记录再做成一座博客。不贴对话原文。
- 否定
- 仓库里的版本记录从 2026-03-28 的 1.0.0 记到现在,大约一千九百条。标题里多数看不出访客还能打开的行为。按条公开,别人读不完,也容易带上不该公开的细节。更早的工作不在这份记录里。
- 哪一层
- 公开课只收「打开某个地址还能对上」的决定。同一件事的相邻版本并成一张卡。版本号只当索引。这一页现在用十章把已经能对上的决定收在一起。
- 实现
- 这一页按十章收录,不为每一条版本另开一页。新的决定改到对应的卡上。
- 验收
- 打开这一页的目录。能看到十章,而不是一千九百条版本。点进某一张卡,能按「验收」打开现在的页面。
- 锚点
- 1.0.0 · 2026-03-28 起的版本记录
- 不公开
- 会话原文、密钥、本机路径、账号和留言。
10. 自己做一个最小站点
一页、一个按钮、一条验收
- 怎么说
- 把下面四句交给自己的模型,先做一个能打开的页,再考虑第二件功能。不要一次把整个产品讲完。
- 不做
- 不照搬这个站的后台、远控和账号。第一版没有登录也可以。
- 否定
- 一上来要求「做一个和 21zhao 一样的站」。范围太大,做完无法验收,也容易把不该复制的部分一起写进去。
- 哪一层
- 只做一页静态页。上面一个标题、一句话、一个按钮。按钮打开你已经有的示例或作品。页脚放你自己的说明。
- 实现
- 读者自己保存一页文件即可。不需要这个站的账号,也不需要连这个站的后台。
- 验收
- 用浏览器打开那一页。标题、那句话和按钮都在第一屏。点按钮能到你指定的地址。没有登录框,也没有打不开的下载。
- 锚点
- 可复制的四句在下面
- 不公开
- 这一课不需要你的密钥。也不要把别人的密钥写进提示。
做一页静态站点。访客打开就看见标题和一句话,还有一个按钮。
按钮指向我给你的示例地址。
不要做登录,不要做后台,不要放空的下载按钮。
完成的标准:我打开这个文件,第一屏有标题、那句话和按钮,点按钮能到示例地址。