笔记
0工具
0此页用于记录用户反馈问题后的每一次改进
关于
“写笔记”支持四种格式——Word 文档、Excel 表格、Markdown、纯文本，起稿或二次编辑时都能随时切换，同一篇笔记想用哪种形态来记，都由你说了算。
md、txt、csv、json 这类纯文本则原样载入，不做多余加工。拿一张现成的表倒进来、改几笔、再导出去，等于白用一台免费的格式转换器。
要带走就在右上角点“下载”，可导出 PDF、Word、Markdown、Excel、TXT 等格式；列表卡片“⋯”菜单里，也有同样的下载入口。
在“工具”页点“＋ 上传工具”即可发布：填好名称与链接，再用 Markdown 把使用方法写清楚——能解决什么问题、怎么装、怎么用，比堆介绍实在。
要分发安装包就一并上传压缩包（ZIP、RAR、7Z、TAR.GZ，最大 35MB），别人在详情页一键下载；只放链接不带附件也可以。
工具按大家的收藏热度排序，好用的自然会被顶上来。发布后可在详情页或卡片菜单里编辑、下架。
写笔记时勾上“隐藏”，这篇就只存在于你自己的账号里：不进列表、不进搜索、不上首页精选，也不会出现在任何公开的页面，链接发给别人同样打不开。
适合放密码、草稿、日记这类只给自己看的内容；想公开，去“发布”打开它，把“隐藏”的勾去掉再保存，之后编辑会默认保持原状态，不会悄悄变回公开。
不想公开、只想临时给人看：点“分享”生成一条带密码和有效期的链接，到期自动失效，你也能随时撤销。
你的内容会同时保存在多个副本上，系统定期做备份与完整性校验，再配合异地容灾机制：就算某台机器出问题，数据也不会丢，可以长期放心存放；特别重要的资料，仍建议你另外再留一份备份。
全站跑在容器化、模块化的现代架构上，更新、部署、回滚都很快，扩展性和稳定性都按长期运营的标准来设计（Built for reliability, designed to scale）。
这个网站最早只是一个人的笔记仓库，后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法，只是干干净净地存放一些东西；既然做好了，就公开出来，万一有人用得上呢。
不做大而全，不做平台梦，保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护：不会突然冒出付费墙，不会在角落塞广告位，也不会把你的数据卖给第三方。
产品会持续迭代，站内日志页记录着每一次改动，改了什么都有迹可循；想了解这个站是怎么一步步走到今天的，翻翻日志就能看到来龙去脉。
如果在这里看到涉嫌违规的内容，点对应卡片右侧的“举报”按钮就能提交，我们会尽快核实处理；也谢谢你花一点时间，一起把这里维护干净。
趋势
dev/prod 构建环境串味，接口地址老指向开发环境
前端项目本地 npm run dev 一切正常，打包部署到线上，页面能开，但所有接口请求都打到了开发环境的地址，登录都登不上。检查构建产物，发现里面内联的 API 地址是开发机的 IP。dev 和 prod 的环境配置串味了，而且是构建环节串的，不是运行时的问题。
vite 项目里环境变量靠 .env 系列文件区分，.env.development 和 .env.production，配合 import.meta.env.VITE_API_BASE 这种读取。串味最常见的原因有几个，按命中率排：
第一，服务器或 CI 上直接 npm run build，但没带 --mode production，或者环境里 NODE_ENV 没设对。vite build 默认就是 production 模式，但如果构建脚本里自己用 --mode 覆盖了，就会去读别的 env 文件。我踩过的是 CI 里构建命令写成了 npm run build -- --mode staging，结果线上包内联的是 staging 地址，这类属于命令写错。
第二，.env.production 没提交到仓库。很多团队把 .env 和 .env.local 加了 gitignore，结果 .env.production 也被一起忽略了。服务器上拉代码之后根本没有 .env.production 文件，vite 找不到就退回默认值或者用了本地残留的 .env.development，构建出来全是开发地址。正确做法是 .env.production 这种不含密钥的文件提交进仓库，真密钥走 CI 的 secrets 注入。
第三，Docker 构建时环境变量没传进 build 阶段。docker build 默认不继承宿主机的环境变量，得显式用 --build-arg 传，然后在 Dockerfile 里用 ARG 接住再转 ENV，而且必须在 RUN npm run build 之前声明，时机不对就取不到：
FROM node:20
WORKDIR /app
COPY . .
ARG VITE_API_BASE
ENV VITE_API_BASE=$VITE_API_BASE
RUN npm run build
构建时 shell 展开和 ARG/ENV 的时机经常搞错，最常见的是 ENV 写在 RUN 后面，变量根本没进到构建命令里。
第四，node_modules/.vite 的缓存。vite 会把依赖预构建缓存放在 node_modules/.vite，环境变量变了但缓存没失效，构建可能用了旧配置。怀疑这个就删了重来：
rm -rf node_modules/.vite dist
npm run build
我那次绕了一大圈才定位到的是个组合拳：服务器上 .env.production 不存在，本地 .env.development 又因为 .dockerignore 写漏被拷进了镜像，vite 在构建环境里直接读到了 development 文件，产物全串成开发地址。
排查顺序建议从产物下手。构建完先别急着部署，直接翻 dist 里的 js 搜地址：
grep -rEo "https?://[^"'"' ]*" dist/assets/ | sort -u
一眼看出打包进去的到底是哪个环境的地址，比上线后抓包快。或者构建脚本里加一步输出当前生效的环境变量，确认用的哪个 env：
node -e "require('dotenv').config({ path: '.env.' + (process.env.NODE_ENV||'production') }); console.log(process.env.VITE_API_BASE)"
另外留意代码里直接写 process.env.XXX 而不是 import.meta.env.VITE_ 前缀的情况。vite 只把 VITE_ 前缀的变量暴露给前端代码，非前缀的在 client 代码里读永远是 undefined，有些人为了省事把地址写死在代码里，dev 改 prod 时只改了 .env 没改代码，自然串味。这类属于变量命名规范问题，统一前缀能少踩一半坑。
教训是环境区分要在构建机层面就锁死，别依赖"本地手工 build 再传上去"这种流程，人一定会忘。CI 里显式指定 mode、把 .env.production 提交、Docker 用 ARG 传参，三层都做了，串味基本绝迹。