@wendongfly/myhi 1.3.192 → 1.3.193

package/dist/chat.html

@@ -231,6 +231,9 @@
     /* ── 输入栏 ─────────────────────────────── */
     /* 输入区与对话同底色、不画分隔线：输入框自带圆角边框，浮在对话下方即可（原来一条贯穿的横线 + 浅色底带显得割裂） */
     #input-area { background: var(--bg); flex-shrink: 0; padding: 0.5rem 0.75rem 0.35rem; }
+    #pending-bar { margin: 0 0 0.45rem; padding: 0.45rem 0.7rem; border-radius: 9px; background: rgba(210,153,34,0.14); border: 1px solid rgba(210,153,34,0.45); color: var(--text); font-size: 0.8rem; cursor: pointer; }
+    .msg-plan { border: 1px solid var(--purple); border-radius: 10px; padding: 0.55rem 0.8rem !important; background: rgba(124,58,237,0.06); }
+    .msg-plan .plan-head { font-size: 0.78rem; font-weight: 600; color: var(--purple); margin-bottom: 0.25rem; }
     #input-area.no-shortcuts { padding-bottom: max(0.5rem, env(safe-area-inset-bottom)); }
     #input-box { background: var(--bg); border: 1px solid var(--border); border-radius: 12px; transition: border-color 0.2s; overflow: hidden; position: relative; }
     #img-preview { display: none; align-items: center; gap: 0.5rem; padding: 0.5rem 0.75rem; border-bottom: 1px solid var(--surface2); background: var(--surface); }
@@ -511,6 +514,7 @@
     <span class="sb-item" id="work-status"><span class="sb-dot idle"></span> 空闲</span>
     <span id="control-badge" class="readonly" style="display:none">只读</span>
     <span id="viewer-count" class="sb-item"></span>
+    <span id="guide-chip" class="sb-item" style="display:none;cursor:pointer" onclick="showMemory('project')"></span>
     <span id="update-badge" style="display:none;color:var(--yellow);cursor:pointer" onclick="doUpdate()">⬆ 有更新</span>
     <span id="claude-update-badge" style="display:none;color:var(--blue);cursor:pointer" onclick="doClaudeUpdate()">⬆ claude</span>
   </div>
@@ -518,6 +522,7 @@
   <div id="chat-area"></div>
 
   <div id="input-area">
+    <div id="pending-bar" style="display:none" onclick="reopenPending()"></div>
     <div id="readonly-overlay" style="display:none"></div>
     <div id="input-box">
       <!-- 待发草稿提示：本轮干完（idle）且收件箱里还有本任务的草稿时浮出来 -->
@@ -526,6 +531,14 @@
         <span id="draft-tip-text" style="flex:1;font-size:0.74rem;color:var(--yellow);overflow:hidden;text-overflow:ellipsis;white-space:nowrap"></span>
         <button class="img-remove" onclick="event.stopPropagation();hideDraftTip()" title="暂不处理">&times;</button>
       </div>
+      <!-- 建议生成项目说明：看出是长期项目（同目录多任务 / 聊了很多轮 / 说了「以后都…」）且还没有 CLAUDE.md 时浮出 -->
+      <div id="guide-tip" style="display:none;align-items:center;gap:0.5rem;padding:0.4rem 0.75rem;border-bottom:1px solid var(--surface2);background:rgba(46,160,67,0.10)">
+        <span style="font-size:0.95rem;flex-shrink:0">📘</span>
+        <span id="guide-tip-text" style="flex:1;min-width:0;font-size:0.74rem;color:var(--text2);line-height:1.45"></span>
+        <button onclick="guideTipGo()" style="flex-shrink:0;background:var(--green);color:#fff;border:none;border-radius:6px;padding:0.25rem 0.6rem;font-size:0.72rem;cursor:pointer">帮我生成</button>
+        <button onclick="guideTipOff()" style="flex-shrink:0;background:none;border:none;color:var(--muted);font-size:0.7rem;cursor:pointer;padding:0.2rem">不再提示</button>
+        <button class="img-remove" onclick="guideTipClose()" title="先不管">&times;</button>
+      </div>
       <div id="img-preview">
         <img id="img-preview-thumb" src="" alt="">
         <span class="img-info">已添加图片，输入文字后发送</span>
@@ -938,7 +951,7 @@
   <div id="memory-sheet" class="action-sheet">
     <div class="action-sheet-backdrop" onclick="closeMemorySheet()"></div>
     <div class="action-sheet-box" style="height:90vh;max-height:90vh;display:flex;flex-direction:column">
-      <div class="action-sheet-title">Claude 记忆</div>
+      <div class="action-sheet-title">项目说明与记忆</div>
       <div id="memory-content" style="flex:1;overflow-y:auto;padding:0.3rem 0;font-size:0.78rem;color:var(--text2);scrollbar-width:thin">
         <div style="text-align:center;color:var(--muted);padding:2rem 0">加载中...</div>
       </div>
@@ -1012,7 +1025,47 @@
       </div>
       <button id="ask-sheet-submit-multi" class="action-sheet-cancel ask-submit-btn" style="display:none;background:var(--blue3);color:#fff;font-weight:600;margin-bottom:0.4rem" onclick="submitAskMulti()">提交回答</button>
       <button id="ask-sheet-submit-single" class="action-sheet-cancel" style="background:var(--purple);color:#fff;font-weight:600;margin-bottom:0.4rem" onclick="submitAskReply()">发送自定义回答</button>
-      <button class="action-sheet-cancel" onclick="closeAskSheet()">取消</button>
+      <button id="ask-sheet-skip" class="action-sheet-cancel" style="display:none" onclick="skipAsk()">⏭ 跳过，让 AI 自己决定</button>
+      <button id="ask-sheet-cancel" class="action-sheet-cancel" onclick="closeAskSheet()">取消</button>
+    </div>
+  </div>
+  <!-- 方案审批：计划模式下 AI 用 ExitPlanMode 提交方案 -->
+  <div id="plan-sheet" class="action-sheet">
+    <div class="action-sheet-backdrop" onclick="closePlanSheet()"></div>
+    <div class="action-sheet-box" style="max-height:88vh;display:flex;flex-direction:column">
+      <div class="action-sheet-title">📋 AI 提交了方案，请审批</div>
+      <div class="msg-assistant" style="flex:1;min-height:0;overflow-y:auto;padding:0.2rem 0.4rem;scrollbar-width:thin"><div class="content" id="plan-sheet-body"></div></div>
+      <textarea id="plan-sheet-fb" class="slash-inp" rows="2" placeholder="需要改的话写在这里，再点「按意见修改」（可选）" style="margin:0.5rem 0 0.4rem;resize:vertical"></textarea>
+      <button class="action-sheet-cancel" style="background:var(--green);color:#fff;font-weight:600;margin-bottom:0.4rem" onclick="approvePlan()">✅ 批准并执行</button>
+      <button class="action-sheet-cancel" style="margin-bottom:0.4rem" onclick="revisePlan()">✏️ 按意见修改方案</button>
+      <button class="action-sheet-cancel" onclick="closePlanSheet()">稍后再看</button>
+    </div>
+  </div>
+  <!-- 退出计划：按方案执行 / 仅退出 -->
+  <div id="planexit-sheet" class="action-sheet">
+    <div class="action-sheet-backdrop" onclick="closePlanExit()"></div>
+    <div class="action-sheet-box">
+      <div class="action-sheet-title">退出计划模式</div>
+      <button class="action-sheet-cancel" style="background:var(--green);color:#fff;font-weight:600;margin-bottom:0.4rem" onclick="exitPlan(true)">✅ 退出并按方案执行</button>
+      <button class="action-sheet-cancel" style="margin-bottom:0.4rem" onclick="exitPlan(false)">仅退出计划模式</button>
+      <button class="action-sheet-cancel" onclick="closePlanExit()">取消</button>
+    </div>
+  </div>
+
+  <!-- 清除：先说清楚会发生什么，免得误以为出了故障 -->
+  <div id="clear-sheet" class="action-sheet">
+    <div class="action-sheet-backdrop" onclick="closeClearSheet()"></div>
+    <div class="action-sheet-box">
+      <div class="action-sheet-title">清除对话，从头开始？</div>
+      <div style="font-size:0.82rem;color:var(--muted);line-height:1.65;padding:0 0.4rem 0.7rem">
+        · AI 会<b>忘掉本任务之前聊过的内容</b>，下次提问是全新对话<br>
+        · 界面上的聊天记录一并清空<br>
+        · <b>项目文件、已做的修改都不受影响</b><br>
+        适合换新话题、或 AI 被旧内容带偏时用。只是嫌对话太长，用「压缩」更合适——会保留要点。
+      </div>
+      <button class="action-sheet-cancel" style="background:var(--red);color:#fff;font-weight:600;margin-bottom:0.4rem" onclick="doClear(true)">清除并开始新对话</button>
+      <button class="action-sheet-cancel" style="margin-bottom:0.4rem" onclick="closeClearSheet();doSlashCmd('/compact')">改用压缩（保留要点）</button>
+      <button class="action-sheet-cancel" onclick="closeClearSheet()">取消</button>
     </div>
   </div>
 
@@ -2153,6 +2206,8 @@
           if (block.type === 'thinking' && block.thinking) thinkings.push(block.thinking);
           else if (block.type === 'text' && block.text) texts.push(block.text);
           else if (block.type === 'tool_use') {
+            const planTxt = planTextOf(block.name, block.input);
+            if (planTxt !== null) { addPlanCard(planTxt); continue; }
             // Task 在翻页（fragment）模式下退化为普通工具卡——面板逻辑挂在聊天区，
             // 塞进 fragment 会错位；整本回放仍用面板
             if (block.name === 'Task' && !_replayParent) {
@@ -2499,6 +2554,7 @@
         if (draftBtn) draftBtn.style.display = busy ? '' : 'none';
         // 用 try 包住：这两个绑定声明在文件后段，初始化早期调用会撞 TDZ
         try { if (!busy) _draftTipDismissed = false; renderDraftTip(); } catch {}
+        try { if (!busy) checkGuide(); else renderGuideTip(); } catch {}
       }
       _postStatus(state);
     }
@@ -2658,6 +2714,7 @@
       currentSession = session;
       overlay.classList.add('hidden');
       document.title = session.title + ' — myhi';
+      setTimeout(() => { try { checkGuide(); } catch {} }, 0);
       document.getElementById('session-title').textContent = session.title;
       if (session.cwd) document.getElementById('session-cwd').textContent = session.cwd;
       updateViewers(session.viewers);
@@ -2782,9 +2839,9 @@
                   _textRenderedThisTurn = true;
                 }
               } else if (block.type === 'tool_use') {
-                if (block.name === 'AskUserQuestion' && block.input) {
-                  openAskSheet(block.input);
-                }
+                if (block.name === 'AskUserQuestion' && block.input) legacyAsk(block.id, block.input);
+                const planTxt = planTextOf(block.name, block.input);
+                if (planTxt !== null) { addPlanCard(planTxt); continue; }
                 if (block.name === 'Task') {
                   subaCreatePanel(block.id, subagentToolInfo(block.input || {}));
                 } else {
@@ -2858,9 +2915,8 @@
           break;
         case 'tool_use':
           // 独立工具调用消息
-          if (msg.name === 'AskUserQuestion' && msg.input) {
-            openAskSheet(msg.input);
-          }
+          if (msg.name === 'AskUserQuestion' && msg.input) legacyAsk(msg.id, msg.input);
+          if (planTextOf(msg.name, msg.input) !== null) { addPlanCard(planTextOf(msg.name, msg.input)); break; }
           if (msg.name === 'Task') {
             subaCreatePanel(msg.id, subagentToolInfo(msg.input || {}));
           } else {
@@ -3231,6 +3287,7 @@
 
     function sendCommand() {
       const text = cmdInput.value.trim();
+      if (GUIDE_REMEMBER_RE.test(text)) _guideRemember = true;   // 「以后都… / 记住…」：这一轮干完建议写进项目说明
       if (!text && !_pendingImage && !_pendingFile) return;
 
       // AI 还在跑这一轮（可能正开着子代理，整轮 result 未到，服务端 isBusy 会拒收）：
@@ -3565,22 +3622,56 @@
 
     // ── 设置面板 ──────────────────────────────────
     // ── 会话内使用说明（精简版；完整版在首页 ❓ 帮助）──────────────
+    // 快捷栏按钮说明：帮助面板和鼠标悬停提示共用这一份，加按钮时在这里补一句
+    const SK_HELP = {
+      draft:    ['📥 草稿', 'AI 忙时先把想法存起来，干完再发；勾「自动接力」会在这一轮结束后自动发出。'],
+      folder:   ['📂 文件夹', '在这台电脑上用资源管理器打开本任务目录（后台/服务模式下不可用）。'],
+      model:    ['模型', '切换 AI 模型。复杂任务用强模型，简单活换快模型更省；被安全检测误拦时也可换个模型再试。'],
+      plan:     ['计划', '先让 AI 只调研、出方案、不改文件；你审批后再执行。再点一次「退出计划」可按方案执行或仅退出。'],
+      compact:  ['压缩', '对话太长时把前面内容压成摘要，AI 保留要点、继续干活，上下文水位下降。不会丢文件。'],
+      resume:   ['恢复', '翻看本任务以前的对话，选一段接着聊。'],
+      clear:    ['清除', '让 AI 忘掉之前聊过的内容、从头开始新对话，聊天记录也清空；项目文件不受影响。只嫌太长用「压缩」。'],
+      secrets:  ['🔑 密钥', '保存 token / 密码等，命令里用 $名字 引用，值不会进聊天和模型。新增后清除或重开会话生效。'],
+      guard:    ['🛡 护栏', '发给 AI 前把姓名、证件号、手机号等换成代号，回来再还原；映射只留在本机。'],
+      followup: ['🔄 跟进', '长任务交出去后，AI 每说完一轮，隔一段时间自动替你问进度、让它接着干；判断全部完成就停（最多 5 次，每次都算一轮模型调用）。'],
+      git:      ['提交', '查看改动并 git 提交 / 推送。'],
+      memory:   ['记忆', '查看、编辑「项目说明」和 AI 的长期记忆，每次新对话都会带上；长期项目可一键让 AI 生成项目说明。'],
+      skills:   ['技能', '管理常用指令模板（/命令），一点就发；可自建。'],
+      cost:     ['费用', '查看本次会话的 token 用量与花费。'],
+    };
+    document.querySelectorAll('.sk[data-sk]').forEach(b => { const h = SK_HELP[b.dataset.sk]; if (h && !b.title) b.title = h[1]; });
+
     window.openChatHelp = function() {
       overlay.innerHTML = '';
       overlay.classList.remove('hidden');
       const wrap = document.createElement('div');
       wrap.style.cssText = 'position:absolute;inset:0;display:flex;align-items:center;justify-content:center;padding:1rem;background:rgba(0,0,0,0.55)';
       const box = document.createElement('div');
-      box.style.cssText = 'max-width:520px;background:var(--surface);border:1px solid var(--border);border-radius:14px;padding:1.1rem;font-size:0.82rem;line-height:1.75;color:var(--text);max-height:80vh;overflow-y:auto';
+      box.style.cssText = 'max-width:560px;width:100%;background:var(--surface);border:1px solid var(--border);border-radius:14px;padding:1.1rem;font-size:0.82rem;line-height:1.75;color:var(--text);max-height:85vh;overflow-y:auto';
+      const sec = (t) => `<div style="font-size:0.86rem;font-weight:700;margin:0.8rem 0 0.3rem">${t}</div>`;
+      const row = (k, v) => `<div style="display:flex;gap:0.6rem;padding:0.28rem 0;border-top:1px solid var(--border)"><span style="flex:0 0 5.2em;font-weight:600">${k}</span><span style="flex:1;color:var(--text2,var(--text))">${v}</span></div>`;
+      const shown = new Set([...document.querySelectorAll('#sk-claude-agent .sk[data-sk]')].map(b => b.dataset.sk));
+      const skRows = Object.entries(SK_HELP).filter(([k]) => currentSession?.mode !== 'agent' || shown.has(k)).map(([, h]) => row(h[0], h[1])).join('');
       box.innerHTML = `
-        <div style="font-size:1rem;font-weight:700;margin-bottom:0.5rem">💬 会话怎么用</div>
+        <div style="font-size:1rem;font-weight:700;margin-bottom:0.3rem">💬 会话怎么用</div>
         <b>发消息</b>：像聊天一样把需求说清楚即可；触屏回车=换行，用发送键发送。<br>
         <b>让它读文件</b>：打 <b>@</b> 从本项目逐层浏览、打字搜索；项目外打 <b>@D:</b>、<b>@/</b>、<b>@~/</b> 按路径逐层浏览；选中插路径；或点「文件」面板的 <b>@</b> 引用。<br>
         <b>工具/思考</b>：AI 干活的过程默认折叠，点「🔧 N 个工具调用」展开看命令与输出。<br>
         <b>AI 忙时</b>：输入框变「存草稿」，先记着干完取回；勾自动接力会自动发出。<br>
-        <b>定位旧消息</b>：电脑上鼠标移到聊天区，右下角 ☰ 可列出你发过的消息点击跳转；看完点底部「↓ 回到底部」一键回来。<br>
-        <b>常用按钮</b>：模型/计划/压缩/恢复/清除/密钥/护栏/提交——普通用户可在设置→快捷栏精简。<br>
-        <span style="color:var(--muted)">更多说明见首页顶栏 ❓ 帮助。</span>`;
+        <b>AI 提问 / 交方案</b>：AI 需要你拿主意时会弹出选项，选一个即可，也可「跳过，让 AI 自己决定」；收起后输入框上方「❓ AI 在等你回答」可再打开。<br>
+        <b>定位旧消息</b>：电脑上鼠标移到聊天区，右下角 ☰ 可列出你发过的消息点击跳转；看完点底部「↓ 回到底部」一键回来。
+        ${sec('顶栏')}
+        ${row('▦ 分屏', '电脑上多个任务并排看、并排干。')}
+        ${row('?', '就是这份说明。')}
+        ${row('⚙ 设置', '聊天显示（思考 / 工具输出是否展开）、快捷栏显示哪些按钮、本任务的选项。')}
+        ${row('◈ 水位', 'AI 的「记忆容量」用了多少。快满时 AI 容易忘事，点「压缩」腾空间。')}
+        ${row('文件', '浏览、编辑、上传、下载本任务目录里的文件。')}
+        ${row('切换', '跳到其他任务。')}
+        ${row('›', '返回首页。')}
+        ${row('📘', '状态栏出现「已带项目说明」表示 AI 每次会先读本项目的项目说明；变黄「偏长」时建议精简。点它查看 / 编辑。')}
+        ${sec('快捷栏（输入框下方）')}
+        ${skRows}
+        <div style="color:var(--muted);margin-top:0.5rem">按钮太多？到 ⚙ 设置 → 快捷栏 关掉用不到的。鼠标停在按钮上也能看到说明。更多见首页 ❓ 帮助。</div>`;
       const closeBtn = document.createElement('button');
       closeBtn.textContent = '知道了';
       closeBtn.style.cssText = 'display:block;margin:0.8rem auto 0;background:var(--blue2);color:#fff;border:none;border-radius:8px;padding:0.5rem 1.4rem;font-size:0.85rem;cursor:pointer';
@@ -4443,10 +4534,7 @@
                 askMultiState.answers[qIdx] = { question: qText, label };
                 refreshAskMultiSubmit();
               } else {
-                _clearAsk();
-                addInputMessage(label);
-                socket.emit('agent:query', { prompt: label });
-                showThinking();
+                answerAsk({ [qText]: label }, label);
               }
             };
             block.appendChild(item);
@@ -4456,6 +4544,8 @@
       });
 
       if (isMulti) refreshAskMultiSubmit();
+      document.getElementById('ask-sheet-skip').style.display = _askCtlId ? '' : 'none';
+      document.getElementById('ask-sheet-cancel').textContent = _askCtlId ? '稍后回答' : '取消';
       sheet.classList.add('open');
       if (!isMulti) inp.focus();
     }
@@ -4483,21 +4573,125 @@
       const answers = askMultiState.answers.slice(0, n);
       if (answers.some((a) => !a)) return;
       const reply = answers.map((a, i) => 'Q' + (i + 1) + ': ' + a.question + '\nA: ' + a.label).join('\n\n');
+      const map = {}; answers.forEach((a) => { map[a.question] = a.label; });
+      answerAsk(map, reply);
+    };
+    // 交互通道下「取消」只是先收起，问题还挂着（输入框上方的提示条可再打开）；旧模式照旧清掉
+    window.closeAskSheet = function() {
+      if (_askCtlId) { document.getElementById('ask-sheet').classList.remove('open'); renderPendingBar(); return; }
       _clearAsk();
-      addInputMessage(reply);
-      socket.emit('agent:query', { prompt: reply });
-      showThinking();
     };
-    window.closeAskSheet = function() { _clearAsk(); };
     window.submitAskReply = function() {
       const inp = document.getElementById('ask-sheet-input');
       const text = inp.value.trim();
       if (!text) return;
+      answerAsk({ [_askQuestions[0]?.question || '']: text }, text);
+    };
+
+    // ── 交互通道（1.3.193）：AI 的提问 / 方案审批由 claude 发起、等 myhi 回答 ──
+    //   新 claude：服务端推 agent:interaction（带 id），答案用 agent:respond 交回 claude 正在等待的那个调用，
+    //            模型拿到的是「对自己问题的回答」，上下文连贯；刷新 / 换设备时服务端会补发，先答先算。
+    //   老 claude（没有交互通道）：沿用旧做法——看到 tool_use 就弹窗，答案当新消息发出去。
+    let _askCtlId = null;                 // 当前问答弹窗对应的交互 id（null = 旧模式）
+    let _planCtl = null;                  // 待审批的方案 { id, plan }
+    const _ctlToolUseIds = new Set();     // 已由交互通道接管的 tool_use，旧路径别再弹一次
+    function ensureControl() { if (!isController && canTakeControl()) socket.emit('take-control', { sessionId: SESSION_ID }); }
+    function answerAsk(map, display) {
+      if (_askCtlId) {
+        ensureControl();
+        socket.emit('agent:respond', { id: _askCtlId, decision: { answers: map } });
+        _askCtlId = null; _clearAsk(); renderPendingBar(); showThinking();
+        return;
+      }
       _clearAsk();
-      addInputMessage(text);
-      socket.emit('agent:query', { prompt: text });
+      addInputMessage(display);
+      socket.emit('agent:query', { prompt: display });
       showThinking();
+    }
+    window.skipAsk = function() {
+      if (!_askCtlId) return _clearAsk();
+      ensureControl();
+      socket.emit('agent:respond', { id: _askCtlId, decision: { skip: true } });
+      _askCtlId = null; _clearAsk(); renderPendingBar();
+    };
+    // 旧路径：tool_use 一出现就弹。交互通道开着时先等一下，服务端的正式请求到了就以它为准
+    function legacyAsk(toolUseId, input) {
+      if (!currentSession?.interactive) return openAskSheet(input);
+      setTimeout(() => { if (!_ctlToolUseIds.has(toolUseId) && !_askCtlId) openAskSheet(input); }, 1500);
+    }
+    socket.on('agent:interaction', (v) => {
+      if (!v?.id) return;
+      if (v.toolUseId) _ctlToolUseIds.add(v.toolUseId);
+      if (v.kind === 'ask') {
+        if (_askCtlId === v.id) return;           // 重连补发的同一题
+        _clearAsk(); _askCtlId = v.id;
+        openAskSheet({ questions: v.questions || [] });
+      } else if (v.kind === 'plan') {
+        if (_planCtl?.id === v.id) return;
+        _planCtl = { id: v.id, plan: v.plan || '' };
+        openPlanSheet();
+        _postStatus('waiting');
+      }
+      renderPendingBar();
+    });
+    socket.on('agent:interaction-closed', ({ id } = {}) => {
+      if (_askCtlId === id) { _askCtlId = null; _clearAsk(); }
+      if (_planCtl?.id === id) { _planCtl = null; closePlanSheet(); }
+      renderPendingBar();
+    });
+    // 输入框上方的「AI 在等你」提示条：弹窗被收起后从这里再打开
+    function renderPendingBar() {
+      const bar = document.getElementById('pending-bar');
+      if (!bar) return;
+      const txt = _planCtl ? '📋 AI 提交了方案，等你审批' : _askCtlId ? '❓ AI 在等你回答一个问题' : '';
+      bar.textContent = txt ? txt + ' · 点这里查看' : '';
+      bar.style.display = txt ? '' : 'none';
+    }
+    window.reopenPending = function() {
+      if (_planCtl) return openPlanSheet();
+      if (_askCtlId) document.getElementById('ask-sheet').classList.add('open');
+    };
+    // ── 方案审批 ──
+    window.openPlanSheet = function() {
+      if (!_planCtl) return;
+      document.getElementById('plan-sheet-body').innerHTML = renderMarkdown(_planCtl.plan || '（方案为空）');
+      document.getElementById('plan-sheet').classList.add('open');
     };
+    window.closePlanSheet = function() { document.getElementById('plan-sheet').classList.remove('open'); renderPendingBar(); };
+    window.approvePlan = function() {
+      if (!_planCtl) return;
+      ensureControl();
+      socket.emit('agent:respond', { id: _planCtl.id, decision: { approve: true } });
+      _planCtl = null; closePlanSheet(); showThinking();
+    };
+    window.revisePlan = function() {
+      if (!_planCtl) return;
+      const fb = document.getElementById('plan-sheet-fb').value.trim();
+      if (!fb) { document.getElementById('plan-sheet-fb').focus(); document.getElementById('plan-sheet-fb').placeholder = '先写下要怎么改，再点这个按钮'; return; }
+      ensureControl();
+      socket.emit('agent:respond', { id: _planCtl.id, decision: { approve: false, feedback: fb } });
+      document.getElementById('plan-sheet-fb').value = '';
+      _planCtl = null; closePlanSheet(); showThinking();
+    };
+    // ── 聊天里的方案卡片：ExitPlanMode 提交的方案、写进 ~/.claude/plans/*.md 的方案文件（原来只是个折叠的「写文件」，看不到内容）──
+    function planTextOf(name, input) {
+      if (!input) return null;
+      if (name === 'ExitPlanMode') return String(input.plan || '');
+      if (name === 'Write' && /[\\/]\.claude[\\/]plans[\\/][^\\/]+\.md$/.test(input.file_path || '')) return String(input.content || '');
+      return null;
+    }
+    let _lastPlanText = '';
+    function addPlanCard(text) {
+      const t = String(text || '').trim();
+      if (!t || t === _lastPlanText) return;      // 先写方案文件、再 ExitPlanMode 提交同一份：只显示一次
+      _lastPlanText = t;
+      const el = document.createElement('div');
+      el.className = 'msg msg-assistant msg-plan';
+      el.innerHTML = '<div class="plan-head">📋 方案</div><div class="content"></div>';
+      el.querySelector('.content').innerHTML = renderMarkdown(t);
+      (_replayParent || chatArea).appendChild(el);
+      if (!_replayParent) { trimMessages(); scrollToBottom(); }
+    }
     document.getElementById('ask-sheet-input').addEventListener('keydown', (e) => {
       if (e.key === 'Enter') { e.preventDefault(); submitAskReply(); }
     });
@@ -4609,15 +4803,22 @@
     };
 
     // ── 清除会话 ──────────────────────────────────
-    window.doClear = function() {
+    window.closeClearSheet = function() { document.getElementById('clear-sheet').classList.remove('open'); };
+    window.doClear = function(confirmed) {
+      // Agent 模式先弹说明确认：清除不可撤销，且用户常不清楚它会让 AI 忘掉上下文
+      if (currentSession?.mode === 'agent' && !confirmed) {
+        document.getElementById('clear-sheet').classList.add('open');
+        return;
+      }
+      closeClearSheet();
+      if (workState !== 'idle' && !confirm('AI 还在执行，清除会中断这一轮。确定清除？')) return;
       // 清除聊天区 UI
       chatArea.innerHTML = '';
       endStream();
       // Agent 模式：发送 /clear 清除 Claude 上下文
       if (currentSession?.mode === 'agent') {
         if (!isController && canTakeControl()) socket.emit('take-control', { sessionId: SESSION_ID });
-        socket.emit('agent:query', { prompt: '/clear' });
-        addStatusMessage('已清除对话和 Claude 上下文');
+        socket.emit('agent:query', { prompt: '/clear' });   // 服务端回一条「已开始新对话」，所有在看的人都能看到
         _ctxNudgeLevel = 0;
         _lastCtxTokens = 0;
         ctxUpdate(0); // 上下文已清空，水位指示复位
@@ -4793,6 +4994,55 @@
         `本任务有 ${n} 条待发草稿 —— 点这里取回`;
       tip.style.display = 'flex';
     }
+    // ── 项目说明（CLAUDE.md）：状态标记 + 适时建议生成 ─────────────
+    // 新用户不知道 CLAUDE.md，等看出是长期项目时再提：同目录还有别的任务 / 本任务聊了很多轮 / 说了「以后都…」。
+    // 每个目录可「不再提示」（存本机）；× 只关本页。
+    const GUIDE_REMEMBER_RE = /以后(都|每次|一律)|每次都(要|得|先)|记住|总是要|别再忘|下次(也|还)要/;
+    const GUIDE_TURNS = 15;
+    let _guide = null, _guideRemember = false, _guideTipClosed = false;
+    const guideOffKey = 'myhi_guide_tip_off';
+    const guideOffList = () => { try { return JSON.parse(localStorage.getItem(guideOffKey) || '[]'); } catch { return []; } };
+    async function checkGuide() {
+      if (currentSession?.mode !== 'agent') return;
+      try { const r = await fetch('/api/session/' + SESSION_ID + '/guide'); if (r.ok) _guide = await r.json(); } catch {}
+      renderGuideChip(); renderGuideTip();
+    }
+    function renderGuideChip() {
+      const c = document.getElementById('guide-chip');
+      if (!c) return;
+      if (!_guide?.exists) { c.style.display = 'none'; return; }
+      c.style.display = '';
+      c.style.color = _guide.long ? 'var(--yellow)' : 'var(--muted)';
+      c.textContent = _guide.long ? '📘 项目说明偏长' : '📘 已带项目说明';
+      c.title = _guide.long
+        ? `项目说明（CLAUDE.md）有 ${_guide.lines} 行，每轮都会占用 AI 的记忆容量。建议精简到要点（可以让 AI 帮你精简）。点击查看`
+        : `AI 每次开始工作前会先读本项目的项目说明（CLAUDE.md，${_guide.lines} 行）。点击查看 / 编辑`;
+    }
+    function guideTipReason() {
+      if (!_guide || _guide.exists) return '';
+      if (_guideRemember) return '想让 AI 以后每次都记得？可以写进「项目说明」，每次新对话 AI 都会先读，不用再重复交代。';
+      if (_guide.siblings > 0) return `这个项目目录还有 ${_guide.siblings} 个其他任务在用。让 AI 把项目情况和你的要求写成「项目说明」，以后每个任务、每次对话都会先读。`;
+      if (_guide.turns >= GUIDE_TURNS) return '这个项目你常来。让 AI 把项目情况和你的要求写成「项目说明」，以后每次新对话不用再重复交代。';
+      return '';
+    }
+    window.renderGuideTip = function() {
+      const tip = document.getElementById('guide-tip');
+      if (!tip) return;
+      const why = guideTipReason();
+      const off = currentSession?.cwd && guideOffList().includes(currentSession.cwd);
+      if (!why || off || _guideTipClosed || workState !== 'idle' || !canTakeControl()) { tip.style.display = 'none'; return; }
+      document.getElementById('guide-tip-text').textContent = why;
+      tip.style.display = 'flex';
+    };
+    window.guideTipGo = function() { _guideTipClosed = true; renderGuideTip(); genProjectGuide(); };
+    window.guideTipClose = function() { _guideTipClosed = true; _guideRemember = false; renderGuideTip(); };
+    window.guideTipOff = function() {
+      const l = guideOffList();
+      if (currentSession?.cwd && !l.includes(currentSession.cwd)) { l.push(currentSession.cwd); localStorage.setItem(guideOffKey, JSON.stringify(l.slice(-200))); }
+      renderGuideTip();
+      addStatusMessage('本项目不再提示生成项目说明（需要时在快捷栏「记忆」里生成）');
+    };
+
     window.hideDraftTip = function() { _draftTipDismissed = true; renderDraftTip(); };
 
     window.openInboxSheet = async function() {
@@ -5215,16 +5465,28 @@
       const isPlan = currentSession?.permissionMode === 'plan';
       if (!isController && canTakeControl()) socket.emit('take-control', { sessionId: SESSION_ID });
       if (isPlan) {
-        // 直接切回 bypassPermissions，不走 /plan 命令（因为那要等 agent 响应）
-        socket.emit('set-mode', { sessionId: SESSION_ID, mode: 'bypassPermissions' });
-        if (currentSession) currentSession.permissionMode = 'bypassPermissions';
-        updatePlanButton();
-        addStatusMessage('已退出计划模式，恢复到自动执行');
+        // AI 已经提交了方案在等审批：直接打开审批（批准即在原进程里切到执行，不打断）
+        if (_planCtl) return openPlanSheet();
+        document.getElementById('planexit-sheet').classList.add('open');
       } else {
         // 进入计划：弹窗输入计划描述
         doSlashCmd('/plan');
       }
     };
+    window.closePlanExit = function() { document.getElementById('planexit-sheet').classList.remove('open'); };
+    // 手动退出计划：切回自动执行会重启 claude 进程——AI 还在规划时先确认，免得这一轮被悄悄打断
+    window.exitPlan = function(run) {
+      closePlanExit();
+      if (workState !== 'idle' && !confirm('AI 还在规划，现在退出会中断这一轮。确定退出？')) return;
+      socket.emit('set-mode', { sessionId: SESSION_ID, mode: 'bypassPermissions' });
+      if (currentSession) currentSession.permissionMode = 'bypassPermissions';
+      updatePlanButton();
+      addStatusMessage('已退出计划模式，恢复到自动执行');
+      if (run) setTimeout(() => {
+        const t = '按刚才的方案开始执行。';
+        addInputMessage(t); socket.emit('agent:query', { prompt: t }); showThinking();
+      }, 600);
+    };
     socket.on('mode-changed', ({ sessionId, mode }) => {
       if (sessionId !== SESSION_ID) return;
       if (currentSession) currentSession.permissionMode = mode;
@@ -5756,10 +6018,22 @@
         container.innerHTML = '';
         container.appendChild(makeBar());
 
+        // 本项目还没有项目说明（CLAUDE.md）：讲清它是什么、适合什么项目，给一键生成入口——新用户不必知道这个文件名
+        if (_memScope === 'project' && !files.some(f => f.name === 'CLAUDE.md')) {
+          const intro = document.createElement('div');
+          intro.style.cssText = 'border:1px dashed var(--border);border-radius:10px;padding:0.75rem 0.85rem;margin-bottom:0.6rem;line-height:1.7';
+          intro.innerHTML = '<div style="font-weight:700;color:var(--text);font-size:0.86rem">📘 本项目还没有「项目说明」</div>'
+            + '<div>项目说明是 AI <b>每次开始工作前都会先读</b>的一页项目规矩：项目是做什么的、关键目录、怎么构建测试、你的固定要求（如「回复用中文」「改完先跑测试」）。有了它，每次新对话不用再重复交代。</div>'
+            + '<div style="color:var(--muted);margin-top:0.2rem">适合会反复来做的长期项目；一次性的小任务不需要。</div>'
+            + '<button onclick="genProjectGuide()" style="margin-top:0.55rem;width:100%;padding:0.5rem;border-radius:8px;cursor:pointer;font-size:0.8rem;border:none;background:var(--green);color:#fff;font-weight:600">📘 让 AI 生成项目说明</button>'
+            + '<div style="color:var(--muted);font-size:0.7rem;margin-top:0.3rem">AI 会先看一遍项目、写出草稿给你确认，确认后才保存（文件名 CLAUDE.md，放在项目目录里）。</div>';
+          container.appendChild(intro);
+        }
+
         if (files.length === 0) {
           const e = document.createElement('div');
           e.style.cssText = 'text-align:center;color:var(--muted);padding:1.5rem 0';
-          e.textContent = _memScope === 'project' ? '本项目暂无记忆文件' : '暂无记忆文件';
+          e.textContent = _memScope === 'project' ? '还没有其他记忆（AI 在对话中记下的经验会出现在这里）' : '暂无记忆文件';
           container.appendChild(e);
           return;
         }
@@ -5771,7 +6045,9 @@
           const dm = m[1].match(/^description:\s*(.+)$/m);
           return { desc: dm ? dm[1].trim() : '', body: content.slice(m[0].length) };
         };
-        const cleanName = (n) => n.replace(/^.*\//, '').replace(/\.md$/i, '');
+        // CLAUDE.md 用大白话称呼（文件名放进描述里给懂行的人看）
+        const NICE = { 'CLAUDE.md': ['📘 项目说明', 'CLAUDE.md · AI 每次开始工作前先读的项目规矩'], '~/.claude/CLAUDE.md': ['🌐 全局说明', '~/.claude/CLAUDE.md · 对所有项目都生效'] };
+        const cleanName = (n) => NICE[n] ? NICE[n][0] : n.replace(/^.*\//, '').replace(/\.md$/i, '');
 
         // 搜索框
         const search = document.createElement('input');
@@ -5789,7 +6065,7 @@
           for (const f of files) {
             if (kw && !(f.name.toLowerCase().includes(kw) || (f.content || '').toLowerCase().includes(kw))) continue;
             shown++;
-            const { desc, body: md } = parseFM(f.content || '');
+            const fm = parseFM(f.content || ''); const md = fm.body; const desc = fm.desc || (NICE[f.name] ? NICE[f.name][1] : '');
             const deletable = f.name.startsWith('memory/') || f.name.startsWith('~/.claude/memory/');
             const editable = deletable || f.name.endsWith('CLAUDE.md') || f.name.endsWith('settings.json');
             const card = document.createElement('div');
@@ -5837,6 +6113,26 @@
     };
 
     // 让 AI 按规则过一遍记忆（只分析给建议，不改文件）
+    // 一键生成项目说明（CLAUDE.md）：AI 先调研、出草稿，用户确认后才写文件——项目说明会改变 AI 之后的行为，不能静默写入
+    window.genProjectGuide = function() {
+      closeMemorySheet();
+      if (currentSession?.mode !== 'agent') return addStatusMessage('该功能仅在 agent(Claude) 会话可用');
+      if (workState !== 'idle') return addStatusMessage('AI 正在干活，等这一轮结束再生成项目说明');
+      const prompt = [
+        '请为当前项目目录写一份项目说明（项目根目录的 CLAUDE.md，以后每次对话开始你都会先读它）。',
+        '步骤：1) 先快速了解项目：目录结构、README、构建/依赖配置（如 package.json、pyproject、Makefile 等），不用逐个细读源码；',
+        '2) 结合本次对话里我交代过的要求和习惯；',
+        '3) 用中文写一份精简草稿（建议 30~60 行，只写要点）：项目是做什么的、关键目录/文件、怎么运行/构建/测试、约定与注意事项、我的固定要求；',
+        '不要写任何密码、token、密钥等敏感值。',
+        '4) 先把完整草稿贴出来让我确认，问我是否保存（可以直接保存 / 我要修改）；我确认后再写入 CLAUDE.md。在我确认前不要创建或修改任何文件。',
+        '如果项目根目录已经有 CLAUDE.md，就在它基础上补充，并说明改了哪些。',
+      ].join('');
+      if (!isController && canTakeControl()) socket.emit('take-control', { sessionId: SESSION_ID });
+      addInputMessage('📘 让 AI 生成项目说明');
+      socket.emit('agent:query', { prompt });
+      showThinking();
+    };
+
     window.analyzeMemory = function() {
       const scopeTxt = _memScope === 'all' ? '所有项目 + 全局' : '本项目';
       const prompt = [