# Ava 的 Memory Repo 这个仓同时干两件事: 1. **AI 记忆**:DSH 的 `dsh-auto-memory` 插件把会话里值得长期记住的事写成 markdown, 存在 `memory/`(事实层);人写的偏好和规则在 `global/AGENTS.md`(规则层)。 2. **个人文档站**:仓里的 markdown 用 Sphinx 编译,发布到 `https://docs.xuyuanyuan.ramwin.com/`(HTTPS + 密码)。 ```{contents} 本文目录 :depth: 2 :local: ``` ## 目录 | 目录 | 作用 | |---|---| | `memory/` | DSH 自动维护的记忆事实层,一条记忆一个 `.md`,随 git 同步 | | `docs/<分类>/` | 问答归档(「有问必存」),按分类存放,一个主题一个 `.md` | | `docs/README.md` | 文档区首页:分类说明 + 自动生成的分类索引 | | `global/AGENTS.md` | AI 助手的全局规则,软链到 `~/.dsh/AGENTS.md` | | `dsh/` | DSH 插件清单与配置快照,换机/重建时照着装 | | `conf.py` / `index.rst` | Sphinx 配置与导航(每个分类一段 glob toctree) | ## 日常工作流 1. 会话里聊到值得留下的东西 → AI 直接写进 `memory/` 或 `docs/<分类>/`; 2. 新文档用脚手架:`python3 新文档.py 主题 --分类 育儿`(自动套模板、刷新索引); 3. 提交推送:`git add -A && git commit -m "docs: ..." && git push`; 4. 发布网页:`./发布.sh`(先跑 `./检查文档.py` 自检,再构建 + 同步); 5. 本地预览:`./run_server.sh`()。 ## 问答文档 「有问必存」的问答都在 `docs/<分类>/`,文件名带日期。分类现在有 `育儿`、`学习成长`、`财务`、`沟通`、`工具与站点`,每类在首页 `index.rst` 里各有一段 `:glob:` toctree 自动收录,所以新文档发布即出现在对应分类下。 分类索引(按分类分组、组内按日期倒序)由 `python3 更新索引.py` 生成,落在 [文档(问答归档)](docs/README.md) 页;README 不再重复一份文章列表。 约定与发布方式见 [文档(问答归档)](docs/README.md)。 ## 相关 - 从哪来的:照着 `wangx` 的 memory-repo / life 仓搭的简化版(只留记忆 + 文档)。 - 部署细节见 [dsh/README.md](dsh/README.md) 和文档站首页。 ## 版本记录 - v4(2026-11-18):文档按分类归档(`docs/<分类>/`)、`docs/README.md` 生成分类索引、 全站页面统一带 `{contents}`,自检升级为「分类 + 导航 + 索引 + 目录 + 版本记录」。 模型 DeepSeek flash(via DeepSeek Harness)。 - v3(2026-11-14):文章索引统一放到首页——`index.rst` 用 glob toctree (`docs/*20??-??-??`)直接列出全部文章,新文档发布即出现在首页「问答归档」; README 与「文档(问答归档)」页只留链接,避免同一篇在两处重复。 模型 DeepSeek flash(via DeepSeek Harness)。 - v2(2026-11-14):加「问答文档」小节,先在 README 页面列出文档(v3 已合并到首页)。 模型 DeepSeek flash(via DeepSeek Harness)。 - v1(2026-11-12):初始版本,模型 DeepSeek flash(via DeepSeek Harness)。