# 文档(问答归档) 这里放整理好的问答与笔记:**有问必存、存完即推、推完发布**,按分类归档、自动生成索引。 ```{contents} 本文目录 :depth: 2 :local: ``` ## 索引 索引由 `python3 更新索引.py` 生成:按分类分组(`docs/<分类>/` 的一级目录),组内按日期倒序。 新文档落盘后跑一次(或直接跑 `./发布.sh` 前的自检),表格就自动补上,不用手改。 ### 育儿(4) | 日期 | 主题 | | --- | --- | | 2026-11-17 | [19 个月宝宝凌晨 5 点醒来大哭:怎么处理(2026-11-17)](./育儿/宝宝凌晨5点醒来大哭-2026-11-17.md) | | 2026-11-14 | [带娃出门总被催:19 个月宝宝的「时间账」(2026-11-14)](./育儿/带娃出门被催怎么办-2026-11-14.md) | | 2026-11-14 | [宝宝穿衣分歧与周末带娃:这周怎么谈、还出不出门(2026-11-14)](./育儿/宝宝穿衣分歧与周末带娃沟通-2026-11-14.md) | | 2026-11-14 | [宝宝成长视频:1 岁 7 个月才开始拍,晚吗?要买什么、用什么剪、学什么?](./育儿/宝宝成长视频拍摄-2026-11-14.md) | ### 学习成长(2) | 日期 | 主题 | | --- | --- | | 2026-11-18 | [学习与育儿周计划(2026-11-18)](./学习成长/学习计划与育儿安排-2026-11-18.md) | | 2026-11-17 | [想学的东西很多,一闲下来只会刷手机:按优先级排班(通勤 2 小时)](./学习成长/想学很多东西却一直刷手机-2026-11-17.md) | ### 财务(1) | 日期 | 主题 | | --- | --- | | 2026-11-18 | [小米集团(1810.HK)财报精读:发展史、盈利模式与愿景(2026-11-18)](./财务/小米集团财报分析-2026-11-18.md) | ### 沟通(1) | 日期 | 主题 | | --- | --- | | 2026-11-14 | [第一次对话,说些什么比较好](./沟通/第一次对话怎么聊-2026-11-14.md) | ### 工具与站点(1) | 日期 | 主题 | | --- | --- | | 2026-11-12 | [站点与入口(2026-11-12)](./工具与站点/站点与入口-2026-11-12.md) | ## 分类 | 分类 | 放什么 | | --- | --- | | `育儿` | 小七的睡眠、吃穿、出门、情绪,以及一家人的带娃分工 | | `学习成长` | 优先级、时间安排、技能学习路径与执行方案 | | `财务` | 财报精读、财务知识、投资相关的笔记 | | `沟通` | 对话、关系处理、跟家人和外人怎么开口 | | `工具与站点` | 服务器、文档站、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 = 活着没登录)。 [← 回首页看全部文章](../index.rst)