0g.hk

禁得起 curl 的短链 / 临时笔记 —— 域名即文案。

<子域名>.0g.hk   →   一条链接、一段文字、一份 AI prompt

无账号、无数据库、无追踪脚本。Cloudflare Worker + KV，单文件 Worker，TTL ≤ 7 天。

Live · https://0g.hk 　|　 API · docs/API.md 　|　 LLM 手册 · https://0g.hk/llms.txt

为什么会有这个

• 临时分享、不留痕：会议链接、Wi-Fi 密码、长 prompt，发出去几天自动消失，不用回头清理。
• 域名即文案：check-this-out.0g.hk 比 bit.ly/3xK9p 体面十倍。海报、二维码、口播都能直接读。
• AI 友好：curl 0g.hk 拿到的是 plain-text 手册，把这条丢给 ChatGPT / Claude，一句「去 0g.hk 看说明，然后建一个 foo」就能跑通。
• 零账号、零追踪：没有登录、没有 analytics 脚本、KV 只存内容和 token hash。

三十秒上手

# 文本进去、短链出来
curl -sS --data-urlencode c='hello world' https://0g.hk/

# 机器可读
curl -sS -H 'Accept: application/json' --data-urlencode c='hello world' https://0g.hk/ | jq .

# 自定名 + URL 短链 + 7 天
curl -sS -H 'Accept: application/json' -H 'Content-Type: application/json' \
  -d '{"content":"https://github.com/catoncat/0g-hk","name":"repo","ttl":"7d"}' \
  https://0g.hk/

浏览器打开 https://0g.hk 是 Markdown 编辑器（实时预览，支持 GFM 表格）。AI / 脚本拿到的是 plain-text 手册而不是 HTML（content negotiation）。

产品约束

项	值
内容类型	文本（≤ 24KB，可在 /admin/config 调整）或 URL（≤ 2KB）
子域名	小写字母/数字/-（空格/下划线自动转 -）
TTL	1h / 1d / 7d，默认 7d，最长 7 天
续期	POST <sub>.0g.hk/?edit=<token>&renew=1，重置到期窗口
编辑 token	创建时返回一次，KV 只存 hash。丢了就改不了
Rate limit	创建/编辑 10 req/min/IP
保留名	www api new admin edit raw n app abuse report exists，以及 mail email dns mx ns cdn static assets help docs status

路由（概览）

请求	行为
POST 0g.hk/	创建（text/plain · JSON · form 三种 body 皆可）
GET 0g.hk/?c=...&n=...	浏览器快捷创建，返回 HTML 结果页
GET 0g.hk/?n=foo	HTML 编辑器预填子域名
GET 0g.hk/ · 浏览器	HTML 首页（带案例、创建入口）
GET 0g.hk/ · curl/AI	纯文本 usage 手册
GET 0g.hk/llms.txt	永远纯文本 usage 手册
GET 0g.hk/exists?n=foo	{valid,exists,reason?} 名字校验
GET <sub>.0g.hk	302 跳转 · 跳转中间页 · 笔记页（视内容/白名单）
GET <sub>.0g.hk/raw	原文 + metadata headers
GET <sub>.0g.hk/edit	编辑器 UI（token 放 URL hash）
POST <sub>.0g.hk/?edit=tk[&content=&ttl=&renew=1]	编辑 / 改 TTL / 续期

设计小记

• 子域即资源：repo.0g.hk 比 0g.hk/abc123 好记十倍；推广时「链接本身就是文案」（check-this-out.0g.hk、name-your-own-links.0g.hk…）。
• Content negotiation at /：浏览器拿 HTML、curl / AI 拿 plain-text。告诉 AI「去 0g.hk 看说明书然后帮我建个 foo」就能跑通。
• KV key 布局：n:<name> 存内容，m:<name> 存元数据（token hash + TTL key + createdAt）。TTL 由 KV 原生 expirationTtl 管理，到期自动消失。
• Edit token：创建时一次性返回 + 仅哈希入库。刻意不提供「找回」，鼓励把短链本身当做可丢弃资源。
• 跳转白名单：主流站（GitHub / X / YouTube / Notion / …）直接 302，其余先过跳转中间页以降低 phishing 滥用成本。
• Rate limit：创建/编辑 10/min/IP。
• 缓存：HTML 页面 no-store；/raw 短缓存 60 秒；/llms.txt 缓存 5 分钟。

仓库结构

src/index.js        Worker 入口与主路由
src/pages.js        HTML 页面渲染
src/responses.js    响应工具、通用样式、llms.txt
src/util.js         名字、URL、限流和安全校验工具
src/moderation.js   Safe Browsing / Workers AI 内容安全
src/admin.js        管理后台
docs/API.md         HTTP API 参考（工程向）
docs/review/        Cloudflare 配置实施记录与后续计划
wrangler.toml       Cloudflare Worker 配置

自部署

前置：Cloudflare 账号 + 一个 KV namespace + 一个挂在 Cloudflare 的域名（或直接用 *.workers.dev）。

npm install              # 安装本地 wrangler
npm run dev              # 本地（http://localhost:8787）
npm run deploy           # 推到 Cloudflare

把 wrangler.toml 里的 account_id、route、kv_namespaces.id 替换成自己的就能跑。域名上：0g.hk 作为 Custom Domain，*.0g.hk/* 作为通配路由，KV namespace 绑在 NOTES。

许可

MIT。家用项目，开放但不承诺稳定。