Files
simple_password/README.md
T
laoyang 03eca9dc9c docs: README 加入线上地址与界面章节,截图按新布局重拍,补 .gitignore (#1)
- README 顶部加线上地址 https://password.yangyq.net/
- 新增「界面」章节:左设置/右操作的双栏逻辑、两按钮实测 241×42 宽高差 0px
- 截图全部重拍(旧图还是改动前的布局):dark/light 2400×1640、mobile 780×2490
- 新增 .gitignore,忽略 node_modules(本地跑判据的落点,43MB,之前没被忽略)

验证(不只看文字):
- 截图像素级检查:深浅背景色正确、颜色多样性足够,排除白屏
- _sp_shot_verify.js 26 条:断言被截图的页面状态正确(主题/左右栏/按钮尺寸/无历史模块)
- _sp_readme_check.js 10 条:README 事实性断言与产品逐条对账
- _sp_readme_render.js 9 条:最小 GFM 渲染后三张图 naturalWidth 均 > 0
2026-10-28 15:25:47 +08:00

4.8 KiB
Raw Blame History

Simple Password

一个干净、纯本地的密码生成器。单文件 index.html,双击即用,也可丢到任意静态托管上。

在线使用 → https://password.yangyq.net/

深色主题

特点

  • 纯前端,零依赖 — 一个 index.html,没有构建步骤、没有 CDN、没有任何外部请求。断网可用。
  • 左设置、右操作 — 设置栏在左,不调任何设置时视线直接落到右侧的密码与「复制密码」。窄屏自动变上下排列,设置在上。
  • 密码学安全随机 — 走 crypto.getRandomValues + 拒绝采样消除取模偏差,不用 Math.random()。
  • 生成即复制 — 默认开启自动复制;剪贴板 API 不可用(如 file:// 下的旧浏览器)时自动降级到 execCommand。
  • 深浅色 — 跟随系统偏好,可手动切换并记住选择。首帧前定主题,不会白屏闪一下。
  • 可调长度 — 4~64 位。选了「每类至少一位」时,下限自动收紧到所选类型数。
  • 四类字符可选 — 小写 / 大写 / 数字 / 符号,四类全不选会被兜回小写,不会生成空密码。
  • 排除易混淆字符 — 一键去掉 0 O o 1 l I,抄写不出错。
  • 自定义排除 — 想避开 @、空格或某个符号,直接填进去。
  • 强度与熵 — 按 长度 × log₂(字符池) 算真实熵,分五档给出评价,同时显示字符池规模。
  • 批量候选 — 一次出 5 个,点任意一条即复制。
  • 不保留记录 — 不记历史,localStorage 只存偏好设置与主题,不存密码。

界面

设置与主操作分居左右两栏 —— 不调设置的人,视线直接落到右侧的密码和「复制密码」上。 「复制密码」与「换一个」严格等大(实测 241×42,宽高差 0px),用渐变与实心填充区分主次。

浅色主题:

浅色主题

移动端自动转为上下单列,设置在输出之上:

移动端

使用

直接用浏览器打开 index.html 即可,无需服务器。

已经部署的在线版本:https://password.yangyq.net/

想在本地用 http 协议(例如需要真实剪贴板权限时):

python -m http.server 8000
# 然后访问 http://127.0.0.1:8000/

快捷键

键 作用
空格 换一个密码
C 复制当前密码
点击密码 也可以复制

在输入框里打字时不会误触发。

关于安全

  • 所有运算在浏览器里完成,不联网、不上传、不写日志。
  • 用 crypto.getRandomValues 取随机数,并按「拒绝采样」丢弃落在偏置区间的值,避免取模带来的分布倾斜。
  • 勾「每类至少一位」时,先从每类各取一位,剩余位从全池随机,最后整体洗牌 —— 保证覆盖的同时不引入位置可预测性。
  • 不保留任何生成记录。密码只存在于剪贴板与页面显示,刷新即失去痕迹;localStorage 里只存偏好设置与主题,不存密码。

浏览器支持

Chrome / Edge / Firefox / Safari 的近两年版本,以及移动端浏览器。

用到 backdrop-filter(毛玻璃)和 crypto.getRandomValues,老浏览器上会自动降级为不透明背景,功能不受影响。

目录

index.html    全部内容:结构、样式、脚本
docs/         README 用的界面截图

开发校验

改完 index.html 后建议跑一遍(脚本在仓库外的 _tooling/,配合 jsdom 与 playwright):

node _sp_test.js             # 功能判据(jsdom,78 条)
node _sp_visual.js           # 真实浏览器几何 / 对比度 / 多视口(114 条)
node _sp_clip.js             # 真实剪贴板端到端(19 条)
node _sp_file_check.js       # file:// 双击直开(15 条)
node _sp_falsify.js          # 反向注入,证明功能判据有牙齿(22 条)
node _sp_visual_falsify.js   # 反向注入,证明几何判据有牙齿(6 条)

反向注入必须单独跑视觉那套:_sp_falsify.js 只喂 _sp_test.js(jsdom 不做布局), 把「按钮等大」「两栏左右」这类几何 bug 注进去根本影响不到被测判据, 会表现成"注入后仍全绿",看着像判据没牙齿,其实是靶子选错。

重拍 README 截图:

node _sp_shots.js            # 输出到仓库 docs/:dark.png / light.png / mobile.png
node _sp_shot_verify.js      # 断言被截图的那个页面状态是对的(26 条)

截图脚本与判据脚本分开,是因为判据脚本的截图(_sp_shots 目录)尺寸与时机跟着判据走, 会带 toast、焦点框、320px 极端视口;README 需要的是干净的产品图。混在一起改判据就会把图搞脏。

License

MIT