85 lines
4.7 KiB
Markdown
85 lines
4.7 KiB
Markdown
# 知微运维纪律（2026-07-21 生效，23:48 加严）
|
||
|
||
> 由小小莫（Sisyphus）与老爸共同制定。核心原则：**实际部署的脚本 = MoFin git 最新版代码**。
|
||
> 违反本纪律的改动会被 `deploy_guard.py`（每 15 分钟）自动回滚并告警。
|
||
|
||
---
|
||
|
||
## ⚠️ 2026-07-21 23:48 加严：git 写权限已撤销
|
||
|
||
因两次 stale 提交覆盖重构（`c31736a3` / `34337fc5`），老爸批准**撤销知微的 MoFin git 写权限**：
|
||
|
||
- **pre-commit 提交白名单**：任何 commit（含 merge）必须携带 `GIT_ALLOW_COMMIT=1` 令牌，否则拒绝。知微没有此令牌
|
||
- 钩子由 hygiene 每日检查存在性，擅删/篡改会告警升级
|
||
- **她唯一的变更路径：kanban 提单给小小莫**（写清问题+证据+建议方案），由小小莫评审执行
|
||
- 以下权限不变：自愈白名单动作（rerun/restart/sync_links/switch_llm_key）、读代码/日志/DB、自己的 profile 目录
|
||
|
||
---
|
||
|
||
## 一、绝对禁止
|
||
|
||
1. **不得直接编辑 `/home/hmo/MoFin/` 下任何被 git 跟踪的代码文件**（包括 `deploy/profile-scripts/`、根目录 `*.py`、`server.py`、`static/*.html`、`prompt_manager/`）。部署守卫每 15 分钟扫描，**未提交的工作区改动一律自动 `git checkout` 回滚**，并通过 XMPP 告警
|
||
2. **不得直接编辑 `/home/hmo/.hermes/profiles/*/scripts/` 下的文件**——那些是 canonical 的同步副本（**2026-08-30 起：deploy 在 data 卷、hermes 在系统盘，跨设备硬链接已物理失效，sync_profile_scripts.sh 改用 `cp -u`**），编辑它们 = 造成副本分叉（8-30 事故：51 脚本分叉，8-26~28 修复未达生产）
|
||
3. **不得在未 `git pull --rebase` 的情况下提交代码**（2026-07-20 17:31 事件：基于过期 checkout 提交，回滚了 candidate_filter busy_timeout 和 premarket Step1.5 两处修复）
|
||
4. **不得直接调用 hermes gateway `/v1/chat/completions` 做批量 LLM 调用**——那是 agent 运行时不是透传（dev-spec 红线#11，603288 事件：单次调用螺旋 35 分钟/44 次 terminal/153k token）。批量调用一律用 `llm_client.call_llm()`（OCG 直连）
|
||
|
||
## 二、自愈系统如何在纪律下运作（不矛盾）
|
||
|
||
L3 自愈（self_repair.py）的动作白名单**本来就不改代码**，guard 不会干预：
|
||
|
||
| 白名单动作 | 性质 | guard 态度 |
|
||
|---|---|---|
|
||
| `rerun_script` | 重跑脚本 | ✅ 允许 |
|
||
| `restart_service` | 重启 systemd 服务 | ✅ 允许 |
|
||
| `sync_links` | 同步脚本副本（cp -u） | ✅ 允许（与 guard 同向） |
|
||
| `switch_llm_key` | 切换 LLM key（改 hermes config，非 MoFin repo） | ✅ 允许 |
|
||
| `none`（只报告） | 报备 | ✅ 允许 |
|
||
|
||
**key 切换、服务重启、任务重跑、硬链修复——自愈能做的一切都不需要碰代码。**
|
||
|
||
## 三、当判断"需要改代码"时
|
||
|
||
### 路径 A（首选）：kanban 提单给小小莫
|
||
描述问题+证据+建议方案，小小莫处理。适用于一切非紧急情况。
|
||
|
||
### 路径 B（紧急热修）：走 git 正规流程
|
||
```
|
||
cd /home/hmo/MoFin
|
||
git pull --rebase # 必须第一步！否则回滚别人的修复
|
||
# 修改代码
|
||
python3 -m py_compile <改动的文件>
|
||
# 最小化验证（能跑就跑一下）
|
||
git commit -m "fix: <原因>"
|
||
git push origin master:session-work # 或留本地并立即 XMPP 通知小小莫合并
|
||
```
|
||
- **git 提交永远安全**：guard 只回滚未提交的工作区改动，不动 commit
|
||
- 提交到 session-work 后，guard 会在 15 分钟内自动 merge 到 master 并完成部署（含重链、dashboard 重启）
|
||
- 提交前不 pull = 纪律违规（见一.3）
|
||
|
||
## 四、guard 的自动部署回路
|
||
|
||
```
|
||
任何机器 push → 246 repo session-work 分支
|
||
→ deploy_guard（15min）检测领先且可快进
|
||
→ 自动 merge → sync_profile_scripts.sh 同步（cp -u，跨设备）
|
||
→ 触及 server.py/static 时自动重启 mofin-dashboard
|
||
→ XMPP 报备
|
||
```
|
||
|
||
## 五、数据/运行时产物不受限
|
||
|
||
`data/`、`gateway/logs/`、`static/mofin_health.json` 等运行时产物不在守卫范围，正常读写无碍。
|
||
|
||
---
|
||
|
||
*依据：dev-spec 十条红线 + 2026-07-20 stale 提交事件 + 2026-07-21 gateway agent 螺旋事件*
|
||
|
||
## 六、现金写保护（2026-08-30 老莫立）
|
||
|
||
**cash/frozen_cash 唯一合法更新通道：老莫 XMPP 口述 → 知微资产更新流程（manual-asset-update）**。
|
||
|
||
- `write_portfolio_summary()` 默认 `allow_cash_update=False`：忽略传入 cash，读库内现值回写并重算 total_assets
|
||
- 仅 `import_holding_xls.py`（券商导入，--cash 必传）显式放行
|
||
- 任何现金变更必须先写 cash_log（note 精确来源，如「Dad 在 XMPP 14:05 说现金 xxx」）
|
||
- 8-30 事故：重构期某调用方错写 80476 覆盖老莫锁定的 690——保护上线后此类覆写不可能再发生
|