docs add storage analysis rules for project-local notes

doc/1270-SEONexus-Codex多版本协作交接总文档.md

@@ -274,6 +274,53 @@ su -s /bin/bash www -c 'git -C /www/wwwroot/diff-maccms/SEONexus log --oneline -
 
 所以这不是代码问题，也不是远端仓库问题，而是当前机器上的 Git 身份边界。
 
+### 5.1 仓库 ownership 也必须保持 `www:www`
+
+除了 `git push` 只能使用 `www`，当前机器上还要额外遵守一条：
+
+- `SEONexus` 仓库目录本身也必须保持 `www:www`
+
+尤其不能让下面这些路径长期混入 `root:root`：
+
+- `.git`
+- `.git/index`
+- `.git/objects/*`
+- `docs/`
+- 其它会被 `git pull` / `git checkout` 自动写入的目录
+
+已经验证过的真实故障现象包括：
+
+- `error: insufficient permission for adding an object to repository database .git/objects`
+- `fatal: failed to write object`
+- `fatal: unpack-objects failed`
+- `error: unable to create file docs/...: Permission denied`
+
+这类问题的根因不是远端仓库异常，而是：
+
+- 前面曾用 `root` 对仓库做过 `commit`、写文件或目录创建
+- 导致 `www` 后续执行 `pull` / `push` / `stash` 时权限链断掉
+
+因此后续建议固定为：
+
+- 与 Git 直接相关的操作优先都用 `www`
+- `root` 只做日志排查、系统命令、权限修复
+- 不要再用 `root` 在仓库里直接 `commit`、`pull`、`push`
+
+如果已经出现 ownership 混乱，优先修复命令为：
+
+```bash
+chown -R www:www /www/wwwroot/diff-maccms/SEONexus
+```
+
+如果只是 `.git` 或仓库内同步文档目录出错，也至少要修：
+
+```bash
+chown -R www:www /www/wwwroot/diff-maccms/SEONexus/.git
+chown -R www:www /www/wwwroot/diff-maccms/SEONexus/docs
+```
+
+这条规则和“只能 `www` 推送”应视为同一组约束，不能只做一半。
+
 ### 6. `SEONexus` 与 `SEONexusAdmin` 是同机双仓协作
 
 当前机器上：
@@ -474,6 +521,50 @@ su -s /bin/bash www -c 'git -C /www/wwwroot/diff-maccms/SEONexus log --oneline -
 
 如果后续发现某条规则经常踩坑，就更新本文件，不要只留在聊天记录里。
 
+### 3. 项目本地持续分析文档
+
+除了需要进入 Git 的正式文档外，每个项目还允许保留一套“只服务当前项目持续优化”的本地分析文档。
+
+这类文档推荐放在项目自己的：
+
+- `code/storage/_analysis/`
+
+使用原因：
+
+- 每个项目都有自己的蜘蛛日志来源、观察窗口和异常轨迹
+- 这类分析如果完全不记录，后续优化容易断档
+- 但如果全部提交进 Git，又会把大量过程性观察和未确认判断写进正式历史
+
+因此这类文档的定位是：
+
+- 允许持续记录
+- 默认不提交
+- 以项目私有观察为主
+- 适合记录尚在观察期的中间结论
+
+推荐最少按两层组织：
+
+- `code/storage/_analysis/sources/`
+- `code/storage/_analysis/domains/`
+
+例如：
+
+- `code/storage/_analysis/sources/baiduspider.md`
+- `code/storage/_analysis/sources/sogou.md`
+- `code/storage/_analysis/domains/sjzyunyang.com.md`
+- `code/storage/_analysis/domains/jingxifa.com.md`
+
+边界规则：
+
+- 可以在每个独立项目里持续写自己的分析文档
+- 也允许每个独立项目优化“本项目私有层”
+- 但不建议每个项目独立发明一套公共核心方案
+
+也就是：
+
+- 项目私有观察可以分散记录
+- 公共核心方案仍应集中验证、集中沉淀、再回灌
+
 ---
 
 ## 特别注意事项