xuanzhu 0.1.8 → 0.1.9

package/README.md

@@ -1,5 +1,7 @@
 # 玄猪 XuanZhu
 
+[English](https://github.com/amble311/xuanzhu/blob/main/docs/README.en.md) | **中文**
+
 > 专为终端打造的 AI 编码 Agent —— 一条 `xzh` 命令，把 AI 编程助手带进你的终端。
 
 ## 快速上手
@@ -314,8 +316,10 @@ API Key 也可以来自环境变量，优先级低于配置文件：
 
 记忆由玄猪自行维护：
 
-- 启动时读取 `MEMORY.md` 注入提示词，让玄猪一开始就了解项目背景
-- 需要更多历史时调用 `memory_read`；完成实质工作后调用 `memory_write` 记录结论
+- 启动时读取 `MEMORY.md` 与**当天的日志**注入提示词（各取节选），让玄猪一开始就了解项目背景
+- 需要更多历史时调用 `memory_read`；**每完成一件实质工作后**必须调用 `memory_write` 记录结论
+  （技术方案、项目约定、踩过的坑、重要发现）。这条要求同时写在系统提示词的「核心原则」里，
+  明确要求**在给出最终答复前先写记忆** —— 此前措辞偏弱（「可调用」），实测几乎不会触发
 - `.xuanzhu` **始终**位于当前项目路径之下，**不做任何向上查找**：在 `/a/b/c` 工作就只用
   `/a/b/c/.xuanzhu`，即使 `/a` 或 `/a/b` 下已有 `.xuanzhu` 也不会复用
 - **启动时**与 **`/switch` 切换目录时**，若该目录下尚无 `.xuanzhu`，会自动创建
@@ -392,8 +396,11 @@ description: 一句话说明该技能的用途与适用场景
   - 唯一匹配直接补全（目录补 `/`、命令与文件补空格）；多匹配先补公共前缀，再按一次列出候选
 - 终端宽度不足 80 列时自动隐藏右侧面板，也可用 `/term` 手动开关
 - 鼠标滚轮按指针所在区域生效：在右侧滚动命令输出，在左侧滚动对话区
-- 限制：为让命令能被 `Ctrl+C` 可靠中断且不引入原生依赖，每条命令独立执行，
-  因此 `vim` / `htop` / `less` 这类需要 TTY 的全屏交互程序不可用，`export` 也不跨命令保留
+- 命令经系统自带的 `script` 包装启动，为子进程分配 **PTY** ——
+  因此**颜色、进度条、交互式提示都正常**（`npm init` 的提问、y/n 确认都能应答），
+  命令运行期间的按键会转发给它
+- 限制：仍**不支持 `vim` / `htop` / `less`** 这类全屏交互程序（没有真正的屏幕刷新与
+  窗口尺寸协商），`export` 的环境变量也不跨命令保留（每条命令独立进程）
 
 ## 界面快捷键
 
@@ -506,7 +513,7 @@ src/
 └── utils/    ANSI 与路径工具
 ```
 
-详见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)。
+详见 [docs/ARCHITECTURE.md](https://github.com/amble311/xuanzhu/blob/main/docs/ARCHITECTURE.md)。
 
 ## 开发