文档(问答归档)
这里放整理好的问答与笔记:有问必存、存完即推、推完发布,按分类归档、自动生成索引。
索引
索引由 python3 更新索引.py 生成:按分类分组(docs/<分类>/ 的一级目录),组内按日期倒序。
新文档落盘后跑一次(或直接跑 ./发布.sh 前的自检),表格就自动补上,不用手改。
育儿(4)
日期 |
主题 |
|---|---|
2026-11-17 |
|
2026-11-14 |
|
2026-11-14 |
|
2026-11-14 |
学习成长(2)
日期 |
主题 |
|---|---|
2026-11-18 |
|
2026-11-17 |
财务(1)
日期 |
主题 |
|---|---|
2026-11-18 |
沟通(1)
日期 |
主题 |
|---|---|
2026-11-14 |
工具与站点(1)
日期 |
主题 |
|---|---|
2026-11-12 |
分类
分类 |
放什么 |
|---|---|
|
小七的睡眠、吃穿、出门、情绪,以及一家人的带娃分工 |
|
优先级、时间安排、技能学习路径与执行方案 |
|
财报精读、财务知识、投资相关的笔记 |
|
对话、关系处理、跟家人和外人怎么开口 |
|
服务器、文档站、DSH 配置这类「东西在哪、怎么发布」 |
新增分类:在 docs/ 下建目录,在 index.rst 里加一段 :glob: toctree,目录表里补一行说明。
约定
一个主题一个
.md文件,放在分类目录里:docs/<分类>/主题-2026-11-12.md;用 MyST(markdown)语法;文件名带日期,
index.rst用 glob 收录,所以首页能点进来;正文开头放目录:标题和引言之后写一个
{contents}指令,页面顶部就会显示 这篇文章自己的目录,长文不用再手动列提纲;照抄_模板.md即可;文末带「版本记录」:迭代版本、使用的模型、本次 token / 额度消耗;
附件放
docs/files/,文档里用相对链接引用(文档在docs/<分类>/,所以写../files/...);提交信息用 Conventional Commits(
docs: ...),首行 ≤72 字符;新增页面后跑一次
./发布.sh,网页才更新。
发布
在任何一台机器上跑 ./发布.sh 都行(比如 Mac mini 上跑 DSH 的 ava 账号):
如果本机能写线上目录(就是在 ECS 上跑)→ 本机构建 + rsync;
否则 → 先
git push,再ssh docs-deploy让 ECS 拉取并构建(ECS 那边用 forced command 只允许触发~/bin/发布docs.sh,所以这把钥匙只能发布)。结束时会 curl 一次站点,
401就代表成功(站点带 Basic 认证,401 = 活着没登录)。