Ava 的 Memory Repo

这个仓同时干两件事:

  1. AI 记忆:DSH 的 dsh-auto-memory 插件把会话里值得长期记住的事写成 markdown, 存在 memory/(事实层);人写的偏好和规则在 global/AGENTS.md(规则层)。

  2. 个人文档站:仓里的 markdown 用 Sphinx 编译,发布到 https://docs.xuyuanyuan.ramwin.com/(HTTPS + 密码)。

目录

目录

作用

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(http://127.0.0.1:18009/)。

问答文档

「有问必存」的问答都在 docs/<分类>/,文件名带日期。分类现在有 育儿、学习成长、财务、沟通、工具与站点,每类在首页 index.rst 里各有一段 :glob: toctree 自动收录,所以新文档发布即出现在对应分类下。

分类索引(按分类分组、组内按日期倒序)由 python3 更新索引.py 生成,落在 文档(问答归档) 页;README 不再重复一份文章列表。

约定与发布方式见 文档(问答归档)。

相关

  • 从哪来的:照着 wangx 的 memory-repo / life 仓搭的简化版(只留记忆 + 文档)。

  • 部署细节见 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)。