# 揽序馆

> 揽收知识，整理次序。揽百家思，序而成档。

一个“只放 markdown、不做转换”的文档站：这里存放全部 `.md` 内容，由主机上的 nginx + njs 直接读取并在浏览器端渲染，磁盘上不生成任何 `.html` 中间文件。文件丢进来即可访问，改完即时生效。

## 目录结构

顶层按「内容形态」分五类，细节收到各自 README 里：

| 目录 | 内容 |
| --- | --- |
| `每日更新/` | 每天自动产出的栏目：AI 行业资讯日报、每日新闻（昨日要闻）、名人介绍、行业介绍、城市介绍、书籍介绍，按 ISO 周归档 |
| `学习笔记/` | 成体系的专题读物：AI 模型学习、语种学习、数据分析、信贷行业知识、技术专栏（高级/专家程序员）、管理专栏（技术管理者）、开发者 AI 能力指南 |
| `阅读记录/` | 微信读书全架精读笔记：418 本书，每本含阅读进度、全书地图、核心知识点、概念速查、可复用方法、行动清单、延伸阅读，按一级分类归档 |
| `项目文档/` | 项目相关的设计与说明：文档站自身（mdView）、风控系统的方案设计、可运行工程（TTS Studio） |
| `model进阶/` | 模型能力落地的场景分析：业务全景、各能力域技术方案与行业用法，分「分析 / 实操」两栏 |

每类的具体栏目、命名规则与生成方式见对应目录的 README：

- [每日更新/README.md](每日更新/README.md) — 7 个每日栏目 + 归档规则 + 生成脚本
- [学习笔记/README.md](学习笔记/README.md) — 6 个专题目录 + 1 篇 AI 能力长文，按篇独立维护
- [阅读记录/README.md](阅读记录/README.md) — 418 本书的精读笔记索引，按一级分类归档
- [项目文档/README.md](项目文档/README.md) — mdView 快速开始/语法/运维、风控系统方案、TTS Studio 工程
- [model进阶/README.md](model进阶/README.md) — 场景全景 + 技术方案，按分析/实操分目录

各栏目下的 `.workbuddy/` 是自动化任务的记忆与执行记录（已覆盖清单），不对外展示。

## 内容是怎么来的

`每日更新/` 下七个栏目由容器 cron 调脚本生成：检索当日信息 → 按固定模板成文 → 写入对应的周目录。

| 栏目 | 脚本 / 调度 | 时间 |
| --- | --- | --- |
| 每日AI新闻、每日名人介绍 | `/app/scripts/gen_daily.sh`（cron） | 每天 00:30 |
| 每日行业介绍 | `/app/scripts/gen_industry.sh`（cron） | 每天 00:50 |
| 每日新闻（昨日要闻） | `/app/scripts/gen_news.sh`（cron） | 每天 06:40 |
| 语种学习（英语高级每日） | `/app/scripts/gen_english.sh`（cron） | 每天 07:17 |
| 每日书籍介绍 | `/app/scripts/gen_book.sh`（cron） | 每天 08:23 |
| 每日城市介绍 | `/app/scripts/gen_city.sh`（cron） | 每天 08:50 |

`学习笔记/` 与 `每日更新/\*/README.md` 的选题表、`.workbuddy/memory/*.md` 记录了已覆盖的选题，用来避免连续几天重复。

跨栏目防重走统一台账 `/app/scripts/state/topics_used.txt`（`日期 栏目 主体` 三列）：日报关键词、新闻要闻、名人、行业、城市、书目、英语主题都记在里面，各任务写前读、后追加，避免「名人讲过的传记人物又被推荐成书」或「行业讲 AI 芯片、日报同天也讲同一批公司」。说明见 [每日更新/README.md](每日更新/README.md)。

## 怎么访问

- 首页（目录卡片 + 关键词筛选）：`http://<主机IP>/md/`
- 分类入口：`/md/每日更新/`、`/md/学习笔记/`、`/md/阅读记录/`、`/md/项目文档/`、`/md/model进阶/`
- 单篇：`http://<主机IP>/md/每日更新/每日AI新闻/2026年第44周(10-26~11-01)/AI日报_2026-10-27.md`
- 看原始 markdown：在路径后加 `?raw=1`

## 技术组成

```text
/app/markdown/          文档目录（nginx 直接读取，对外 /md/）
  README.md             总索引
  每日更新/  学习笔记/  阅读记录/  项目文档/  model进阶/
/app/mdview/
  nginx.conf            /md/ 前缀、静态附件
  mdview.js             njs：目录出首页，.md 出渲染页
  assets/               marked.min.js / render.js / theme.js / style.css
```

nginx 运行在主机上（systemd 管理，不用容器），`/mdview` 下的配置与前端资源由 nginx 直接引用，不做副本，避免两份配置漂移。