笔记
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）。
这个网站最早只是一个人的笔记仓库，后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法，只是干干净净地存放一些东西；既然做好了，就公开出来，万一有人用得上呢。
不做大而全，不做平台梦，保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护：不会突然冒出付费墙，不会在角落塞广告位，也不会把你的数据卖给第三方。
产品会持续迭代，站内日志页记录着每一次改动，改了什么都有迹可循；想了解这个站是怎么一步步走到今天的，翻翻日志就能看到来龙去脉。
如果在这里看到涉嫌违规的内容，点对应卡片右侧的“举报”按钮就能提交，我们会尽快核实处理；也谢谢你花一点时间，一起把这里维护干净。
趋势
jq 想改 JSON 写回文件，别直接拿 > 重定向
先说结论：jq 不像 sed 有 -i 原地改，别写成 jq '.a=1' file.json > file.json，这么干文件大概率被清空。我在这上面栽过一次，写出来给未来的自己提个醒。
场景是改一个工具的配置文件，JSON 格式，想把某个字段从 3 改成 4，还想顺便缩进统一一下。想都没想就写了：
jq '.count = 4' config.json > config.json
跑完一看，config.json 是空的。我第一反应是 jq 的表达式写错了，单独又跑了一遍不带重定向的，输出明明是对的，这才反应过来问题出在重定向本身：shell 处理 > 是在命令执行之前，先把右边的文件打开并截断成空，然后 jq 才去读左边的 config.json——它读到的已经是被截断的空文件，自然输出空。
这属于 shell 重定向和命令执行顺序的基本功，但写管道脚本的时候特别容易忘，尤其是脑子里装着 sed -i、perl -pi 那套"原地改"的习惯。
正确做法是写临时文件再挪回去：
jq '.count = 4' config.json > config.json.tmp && mv config.json.tmp config.json
用 && 串起来保证 jq 成功才覆盖源文件。想要更稳一点，可以在 mv 前先确认临时文件非空，免得 jq 中途报错留下个半截文件把原配置顶了：
jq '.count = 4' config.json > config.json.tmp
if [ -s config.json.tmp ]; then
mv config.json.tmp config.json
else
echo "jq 输出是空的，别覆盖源文件" >&2
rm -f config.json.tmp
fi
-s 判断文件存在且非空，这个检查多花两行但能挡住手滑。
还有另一种工具叫 sponge，来自 moreutils 包，专门解决这类"读取同一个文件又写回"的问题。它会把 stdin 整个吸进去等命令结束再一次性写出，天然规避截断：
jq '.count = 4' config.json | sponge config.json
前提是系统里装了 moreutils，Debian/Ubuntu 直接 apt install moreutils，macOS 用 brew install moreutils。没装就老老实实临时文件 + mv。
再补充两个我常用的 jq 用法，跟"改字段写回"配套。一个是从环境变量取值塞进 JSON：
jq --arg name "$USER" '.owner = $name' config.json > config.json.tmp && mv config.json.tmp config.json
--arg 把 shell 变量带进 jq，变量值里的特殊字符 jq 会自己处理，不用手拼字符串，比用双引号拼 JSON 安全得多，拼错引号直接语法错误。
注意 --arg 塞进来的值一律是字符串，就算你传 4 也是字符串 "4"。要给数字字段赋值得用 --argjson，它才会按 JSON 字面量解析：
jq --argjson n 4 '.count = $n' config.json > config.json.tmp && mv config.json.tmp config.json
字符串和数字搞错的话，jq 不报错，配置照样写出来，但下游程序读的时候类型不对，端口、超时这种数字字段被玩成字符串，轻则校验失败重则程序直接抛类型错误。我在这上面栽过：用 --arg 传了个端口号，改出来的 JSON 里 port 变成了 "8080" 带引号，服务起来端口对不上，排查半天才看到引号。jq 1.6 之后还能直接读环境变量，jq -n 'env.HOME' 就能拿到 HOME 的值，适合把环境变量塞进输出，省得先 --arg 倒一手。
另一个是只校验 JSON 合法性、不改内容：
jq -e . config.json >/dev/null && echo "JSON 正常"
-e 让 jq 在输入不是合法 JSON 时返回非零，配 if 用可以当校验器，脚本里判断"这个文件到底是不是好的 JSON"很好使，我经常在批处理一堆配置前先拿它过一遍。
还有个 mv 的小坑顺带记：mv 是替换文件，新文件继承的是临时文件的权限，不是源文件的。如果 config.json 本来设了特殊权限，比如 600 或者属主是别的用户，mv 完权限就变了。讲究的话先记下原权限再设回去，或者用 cp -p 保留：
cp -p config.json config.json.tmp # 先把权限一起复制
jq '.count = 4' config.json.tmp > config.json.new && mv config.json.new config.json
这个细节是后来被同事提醒的，平时单机自己用根本注意不到，等配置被 ansible 或别的服务用固定权限读的时候就翻车了。总之记忆锚点就一条：jq 是过滤器，不是编辑器，输出重定向回源文件前先经过临时文件这道手。