xuanzhu 0.13.0 → 0.14.1

package/README.md

@@ -188,6 +188,19 @@ xzh
 | `xzh config path` | 打印配置文件路径 |
 | `xzh config init` | 生成默认配置文件 |
 | `xzh vpn` | 交互式设置 / 探测 / 测试 / 启停全局 HTTP(S)/SOCKS5 代理 |
+| `xzh gateway` | 启动常驻 gateway 服务（工作目录 `~/.xzh_gateway`，首次启动自动开机自启） |
+| `xzh gateway stop\|restart\|status` | 停止 / 重启 / 查看 gateway |
+| `xzh gateway autostart [on\|off]` | 开/关开机自启（systemd user unit） |
+
+**gateway 是什么**：等价于在 `~/.xzh_gateway` 目录里启动一个 xzh，但没有界面、不会因为
+`quit`/`exit` 或关终端而退出 —— 它是给「外部消息通道」（先留好接口，未来接微信）用的常驻进程。
+
+- 工作目录 `~/.xzh_gateway`（`XZH_GATEWAY_HOME` 可改），记忆/会话独立，不混进日常项目；
+- 本地接口：`GET /health`、`POST /message`（`{"text":"..."}` → 回复文本）、`POST /shutdown`，
+  默认端口 17890（`XZH_GATEWAY_PORT` 可改），只监听 127.0.0.1；
+- 首次 `xzh gateway` 会顺手装好 **systemd user 开机自启**（`Restart=always`）；
+  没有 systemd 的环境只提示、不影响服务；`xzh gateway autostart off` 可关闭；
+- 日志：`~/.xzh_gateway/logs/gateway.log`。
 | `xzh setup` | 检查并自动安装依赖（玄猪自身 + 技能：playwright / officecli / 剪贴板工具等） |
 | `xzh init` | 扫描项目并生成 / 补全 `AGENTS.md` 与 `docs/`（已有内容只补缺失小节） |
 | `xzh init --dry-run` | 只预览将生成的内容，不写文件 |
@@ -235,6 +248,7 @@ xzh
 | `/auto [on\|off]` | 自动批准（**不带参数 = 开**，`/auto off` 才关；写入配置） |
 | `/autonomy [ask\|observe\|auto]` | 自治等级：逐项确认 / 只观察 / 全自动 |
 | `/monitor` | 查看全部叫醒条件（完整阈值 / 公式 / 链式进度）；面板只显示前 2 条 |
+| `/btc [moni]` | 在当前会话切进 btc 模式（`moni` = 模拟盘）；`/btc off` 回到原项目。工作目录切到 `~/.btc`，不会自动拉起常驻后端 |
 | `/compact` / `/context` / `/usage` | 压缩历史 / 看上下文预算 / 看 token 用量 |
 | `/tools` | 列出本轮发给模型的工具（排查「某个工具没被调用」） |
 | `/memory` | 查看项目记忆（`show`、`global`、`clear`） |
@@ -1167,6 +1181,15 @@ btc_status → btc_sync → btc_signal（三周期打分 + 1h 择时）→ btc_b
 限定北京时间时段（例如只在 21–24 点评估）。**它只叫醒、不下单** ——
 下单仍由那一轮按三周期打分与风控判断。
 
+**后台巡检是无人值守的**：被监控/排期叫醒后，它会在**交易动作**上自主决策到底（真开仓、真平仓、
+真撤单），不会停下来等确认。边界是代码强制的：清账本（`btc_paper_reset`）、资金划转
+（`btc_transfer_profit`）、写文件与执行命令仍会拒绝；硬性风控、三周期方向闸门、保证金与倍率校验
+照常生效。
+
+监控不只盯价位：**行情获取本身也被监控**。后端每 5 分钟探一次实时价，K 线同步失败也计入同一个
+「连续失败」计数（任一成功即清零）；**连续 2 次失败就叫醒一轮巡检**去排查（代理 / 网络 / 限频 /
+时间偏差），并把失败次数与最近错误写进提示词，修好前不得下单。同一轮故障只叫醒一次，恢复后计数清零。
+
 组合条件用**受限公式**（`kind=formula`）：`rsi_1h * 0.6 + adx_1h * 0.4`、
 `(close_1h - ma20_1h) / atr_1h`。变量是 `字段_周期`（+`price`），只允许四则/比较/`and or not`
 与 `abs/min/max`；求值在计算层按 AST 白名单执行，导入、属性、下标一律拒绝 ——