苍 天 的 图 书 馆

试用说明

v0.1.0 初版 · 2026 年 10 月

这是 0.1.0 初版,功能还在陆续补齐。用得别扭、看着不对的地方,可能都是我们的问题 —— 有任何想法或问题,在 QQ 群里直接找苍天说。

1这是什么

一个私有邀请制的私人电子书库网站。管理员把书放进来、整理好,你来检索、看简介、下载。

现在是初版试用,先放了一小批书(三十来本);后面会批量补齐,暂时不用大规模搬数据。

网址library.cangtian.top
能看的格式pdf、epub、mobi
设备电脑上最舒服;手机能看也能下;上传建议用电脑
数据本地和线上是同一份书,看到的就是最新的

2账号

admin
super-admin-1234
管理员

全部权限:审核、改书、管标签、管用户、看服务状态

member1
test--1234
成员

看公开的书、下载、建自己的书单与收藏、上传书(进待审)

member2
test--2345
成员

同上;可以拿它和 member1 一起用,看看两人互不干扰

member3
test--3456
成员

同上;专用它试改密码(改完记得改回来)

cangtian 是业主本人账号,不对外提供 —— 它上面挂着真数据,误操作不好补。

这几个是试用账号,大家共用:别改别人的密码,不然别人就进不去了。 想试「改密码」用 member3,试完改回 test--3456。

3进来会看到什么

  1. 打开网址 → 没登录会先跳到登录页,首页也一样。
  2. 用上表任一口令登录 → 落到首页。
  3. 顶栏:首页 / 检索 / 合集 / 书单 / 统计 / 上传 / 我的;管理员多一个「管理」。

4你能看到的八个页面

4.1

首页

/

用途:这是「报头」,不是搜索框 —— 告诉你馆里最近有什么、这周大家在读什么。

从上到下五块:

区块内容
刊头三格数字:公开藏书 / 公开合集 / 下载流水
本周最热近 7 天被下得最多的 6 本;还没人下载时会写明「最近 7 日还没有借阅记录」
今日荐书随机挑一本,封面 + 简介 + 书目信息,可以点「换一本」换掉
最近入库最近进来的 10 本,一张五列登记表(书名·副题名 / 作者 / 出版发行 / 出版年 / 入库时间)
合集5 个官方合集卡,每张带封面条和本数
4.2

检索

/browse

用途:真正找书的地方 —— 找、筛、排。

  • 搜索框可以切「全部 / 书名 / 作者 / 出版社 / 简介 / ISBN」, 搜的就是这六个地方,标签名和分类名不在里面。
  • 可以在同一个搜索上叠加条件(类目 / 语言 / 年代 / 标签),条件之间是「并且」。
  • 排序三种:书名 / 最新 / 最热。每页 24 条。
  • 页尾写「共 N 本 · 第 x/y 页」;「清空筛选」只清筛选和页码,不动你选的排序。
4.3

书籍详情

/books/:id

用途:一本书的全貌,也是唯一的下载入口。

区块有:封面 / 书目信息(作者、译者、出版社、出版年、ISBN、分类号)/ 简介 / 标签 / 文件 / 所属合集 / 相关书籍。

  • 文件区:同一本书有多个版本时会写「第 N 版」,每份一颗「下载」按钮,标着格式、大小、页数。
  • 点「下载」→ 按钮变成「准备中…」→ 浏览器直接开始下载,不会跳新页面。
  • 「所属合集」会分开写:官方合集、你自己的书单。
  • 「相关书籍」按相同标签或相同类目找;没有就写「暂无相关书籍」,不会留空白。
  • 点某个标签,会跳到检索页并把那个标签放进筛选里。
4.4

合集

/collections

用途:管理员编的专题书架,全站公开。

现在有 5 个:日本经济与社会 / 制度与增长 / 思想与经典 / 东亚与海洋 / 当代史档案(各 2–4 本)。

合集由管理员维护,你看到的就是排好的样子。

4.5

书单

/lists

用途:你自己的私人书架,别人看不到。

两类:书单(可以建好几份,比如「待读:日本战后史」「重读计划」)和收藏(每人一份,固定在最上面)。

书单和收藏只有你自己看得见 —— 别人、包括管理员,都看不到。

4.6

统计

/stats

用途:馆藏的体检报告。

四块:总览(书 / 文件 / 页数 / 下载)/ 类目分布(22 个一级分类里有几个装了书,目前 6 个)/ 格式·语言·年代三张表 / 下载排行(按书、按类目)。

这一页全是数字,没有需要点的地方。

4.7

上传

/upload

用途:提交书。先进待审核,管理员通过后才进公开书目。

  • 文件:pdf / epub / mobi。单个文件 200 MB 以内;更大的书请找苍天单独处理。
  • 书目:书名和分类号必填;作者、译者、编者至少写一项;出版社、出版年、ISBN 可选。
  • 封面:不选也能提交,系统会从文件里自己抽一张。
  • 标签:可以当场新建,输入后回车或点候选,多个之间用顿号隔开。

标签怎么起名(页面上一时还没提示,照着来就行,不然以后会乱):

  1. 2–12 个汉字,不要空格、不要标点;
  2. 一律简体,不要简繁混用;
  3. 不要用「社会学 / 哲学 / 经济」这种太大的词;
  4. 要给大词加限定,比如「政治社会学」「惩罚哲学」「中国经济」;
  5. 一本书 2–5 个就够,不用堆。
4.8

我的

/mine

用途:你的阅览证、你上传过的书、你下载过的书,三页左侧切换。

路径里面有什么
/mine阅览证(昵称 / 账号 / 身份 / 注册 / 上次登录)+ 四格数字(我上传的 / 收藏 / 书单 / 借阅)+ 两个可以展开的段落:改昵称、改密码。改完密码当前页会掉登录,重新登一次就好
/mine/uploads我上传的(书名 / 作者 / 出版社 / 提交时间 / 状态)。状态四态:待审核 / 已公开 / 已退回 / 草稿;被退回的会写明理由
/mine/downloads我的下载(时间 / 书名 / 文件 / 大小 / 来源)。来源那一列只是记这次文件从哪儿给你的,不用管它

5管理员才看到的七个页面

用 admin 登录后,顶栏会多一个「管理」。

页面路径干什么
概览/admin四行数字:书籍 / 文件 / 近 30 天下载 / 成员。只读,没有筛选
待办/admin/pending列着待审的书(状态 / 书名 / 提交人 / 出版社 / 等待时长 / 去审核)。这页不干活,只能点「去审核」进审核页
审核/admin/review逐本通过或退回,退回必须写理由。通过后立刻进公开书目
导入/admin/import占位页,只写清将来会有什么,没有任何按钮
标签/admin/tags新建 / 改名 / 删掉没人用的 / 一键清理。已经有书在用的标签,删除按钮是灰的
用户/admin/users用户表(角色 / 禁用)+ 邀请码。不能改自己的角色,也不能禁用自己
服务器/admin/server服务运行状态 + 一份「下载加速副本」清单(每页 8 条,可以逐条移除或重新生成)。移除只是删掉那份加速副本,书本身不动

管理员之间是平权的:任何一个管理员都能编任何一个官方合集,不管是谁建的。 这是 2026 年 10 月刚改过的,可以重点试试。

6看起来像问题、其实是这样

现象说明
没登录时访问任何页面都会先跳到登录页(首页也一样)这是个私人书架,不对外开放浏览
标签只能当筛选点,不能当关键词搜在检索框里打标签名是搜不到的
别人的书单你看不到不是提示「无权查看」,而是干脆不显示,连管理员也一样
3 本书没有 ISBN(《亚细亚的孤儿》《新教伦理与资本主义精神》《基本面量化投资》)原始文件里就没有,不是没读到
《新教伦理与资本主义精神》没有出版年、《基本面量化投资》没有出版社同上,文件里没带
22 个一级分类里只有 6 个装了书现在先放的是社科类的一小批,后面会补
管理台「导入」页是空的故意的,功能还没做,不放假的按钮
大文件下载比较慢部分书籍较大,没有走云存储,直连传输速度较慢,后续会改进

7遇到问题怎么说

在 QQ 群里直接和苍天说就行。顺手带上这几样,能少来回几轮: