pi-coding-master 0.2.7

package/core/god.pi.mod/cli/pi-people.sh

@@ -0,0 +1,264 @@
+#!/bin/bash
+# pi — person-based launcher
+MEMORY_DIR="$HOME/.pi/memory"
+PLIST="$MEMORY_DIR/plist.json"
+mkdir -p "$MEMORY_DIR"
+
+# ── 单一真相源：把 DEEPSEEK_API_KEY 强制对齐到 models.json 里配的字面量 key ──
+# 否则 pi 会先读环境变量(auth-storage 里 env 优先于 models.json)，shell 里残留的旧 key 会盖过来 → 402。
+# 这样无论 ~/.zshrc / 终端环境是什么，pi 进程(以及它 spawn 的 hc/sc/sl 小号)都用 models.json 的 key。
+__DSK=$(node --input-type=commonjs -e 'try{const j=JSON.parse(require("fs").readFileSync(process.env.HOME+"/.pi/agent/models.json","utf8"));const k=j.providers&&j.providers.deepseek&&j.providers.deepseek.apiKey;if(typeof k==="string"&&!k.startsWith("$")&&k.trim())process.stdout.write(k.trim());}catch(e){}' 2>/dev/null)
+[ -n "$__DSK" ] && export DEEPSEEK_API_KEY="$__DSK"
+[ -f "$PLIST" ] || echo '[]' > "$PLIST"
+
+COUNT=$(node --input-type=commonjs -e "console.log(JSON.parse(require('fs').readFileSync('$PLIST','utf8')).length)")
+
+# Parse flags —— 认【任意位置】的模式 flag，不只开头。
+# 这样 `pi --archive 18` 和 `pi 18 --archive` 都对；而且带了模式 flag 就绝不会再掉进"创建新人"
+# （旧逻辑只看 $1：`pi nn --archive 18` 里 --archive 在名字后面没被认出来 → 误判成创建 nn）。
+# 非模式的 --flag（如 pi 自带的 --session-dir resume 提示）→ 原样转发给真 pi。
+MODE=""
+ORIG=("$@")
+POS=()
+while [ $# -gt 0 ]; do
+  case "$1" in
+    # --msg) MODE="msg"; shift;;   # message parked in v0.1-stable(代码保留,见 Readme.md.GITHUB)
+    --sc) MODE="sc"; shift;;
+    --think) MODE="think"; shift;;           # 双 pane：上面对话，下面 thinking 流
+    --archive) MODE="archive"; shift;;       # 归档一个人（从列表隐藏，不删）
+    --unarchive) MODE="unarchive"; shift;;   # 恢复
+    --archived) MODE="archived"; shift;;     # 看已归档的
+    --dev) export PI_DEV=1; shift;;           # 开发模式：暴露 editcontext/issues 等调试工具
+    --*) exec /opt/homebrew/bin/pi "${ORIG[@]}";;   # 未知 --flag → 原样转发真 pi
+    *) POS+=("$1"); shift;;                          # 位置参数(名字/序号)收集起来
+  esac
+done
+set -- "${POS[@]+"${POS[@]}"}"   # 还原位置参数（空数组在 bash3.2 也安全）
+
+NAME="$1"
+shift 2>/dev/null
+
+# ── archive 管理：归档=从列表隐藏，不删除（有意没有 delete；也不杀进程）──
+if [ "$MODE" = "archived" ]; then
+  node --input-type=commonjs -e "
+    const fs=require('fs'),{execSync}=require('child_process');
+    let a=JSON.parse(fs.readFileSync('$PLIST','utf8')).filter(p=>p.archived);
+    if(!a.length){console.log('没有已归档的人。');process.exit(0);}
+    const now=Date.now();let ps='';try{ps=execSync('ps aux',{encoding:'utf8'});}catch{}
+    for(const p of a){p._active=ps.includes(p.id+'/sessions');p._ago=Math.round((now-new Date(p.lastSeen).getTime())/60000);}
+    a.sort((x,y)=>(y._active?1:0)-(x._active?1:0)||x._ago-y._ago);   // 和恢复时的序号一致
+    console.log('已归档（不在主列表；pi --unarchive <序号|名字> 恢复）：');
+    a.forEach((p,i)=>console.log('  '+String(i+1).padStart(2)+'. '+p.name+'   '+p.id));
+  "
+  exit 0
+fi
+if [ "$MODE" = "archive" ] || [ "$MODE" = "unarchive" ]; then
+  if [ -z "$NAME" ]; then echo "用法: pi --$MODE <名字|序号> [更多...]（可批量，序号/名字混着给都行）"; exit 1; fi
+  node --input-type=commonjs -e "(async()=>{
+    const fs=require('fs'),{execSync}=require('child_process');
+    const list=JSON.parse(fs.readFileSync('$PLIST','utf8'));
+    const mode=process.argv[1];
+    const targets=process.argv.slice(2);   // 批量：所有位置参数都是目标(序号或名字)
+    const now=Date.now();let ps='';try{ps=execSync('ps aux',{encoding:'utf8'});}catch{}
+    // 序号必须和【你看到的列表】同一个排序(active优先+最近优先)，否则归档错人(见过 nn-researcher 被误归档)。
+    // archive 的序号 = 主列表(非归档)里的序号；unarchive 的序号 = 'pi --archived' 里的序号。
+    function sorted(filterFn){
+      const a=list.filter(filterFn);
+      for(const p of a){p._active=ps.includes(p.id+'/sessions');p._ago=Math.round((now-new Date(p.lastSeen).getTime())/60000);}
+      a.sort((x,y)=>(y._active?1:0)-(x._active?1:0)||x._ago-y._ago);
+      return a;
+    }
+    // 关键：先按【同一份快照】把所有目标解析成人对象，再统一改 ——
+    // 否则边归档边重排，序号会错位(pi --archive 2 4 5 6 会越归档越错)。
+    const pool=sorted(mode==='archive' ? (x=>!x.archived) : (x=>x.archived));
+    const picked=new Set(); const errs=[];
+    for(const arg of targets){
+      let p=null;
+      if(/^[0-9]+\$/.test(arg)){ p=pool[parseInt(arg)-1]; if(!p){errs.push('序号 '+arg+' 超出'+(mode==='archive'?'当前列表':'已归档列表')+'范围');continue;} }
+      else { p=list.find(x=>x.name===arg); if(!p){errs.push('没找到 \"'+arg+'\"');continue;} }
+      picked.add(p);
+    }
+    if(!picked.size){ console.error(errs.join('；')||'没有可处理的目标。'); process.exit(1); }
+    const names=[...picked].map(p=>p.name).join(', ');
+    process.stdout.write((mode==='archive'?'归档':'恢复')+' '+names+'? [Y/n] ');
+    const rl=require('readline').createInterface({input:process.stdin});
+    const ans=await new Promise(r=>{rl.question('',a=>{rl.close();r(a)})});
+    if(ans&&/^n/i.test(ans)){console.log('cancelled');process.exit(0);}
+    for(const p of picked) p.archived=(mode==='archive');
+    fs.writeFileSync('$PLIST', JSON.stringify(list,null,2));
+    console.log((mode==='archive'?'已归档 ':'OK 已恢复 ')+[...picked].map(p=>p.name).join('、'));
+    if(errs.length) console.error('WARN: 跳过：'+errs.join('；'));
+  })();" "$MODE" "$NAME" "$@" || exit 1
+  exit 0
+fi
+
+if [ -z "$NAME" ] && [ -z "$MODE" ]; then
+  if [ "$COUNT" = "0" ]; then
+    echo "No people. Usage: pi <name>"
+  else
+    node --input-type=commonjs -e "
+      const fs = require('fs');
+      const Y = '\x1b[33m', G = '\x1b[32m', D = '\x1b[90m', R = '\x1b[0m';
+      function vw(s){let w=0;for(const c of [...s])w+=(c.codePointAt(0)>0x2E7F?2:1);return w;}
+      function pad(s,n){return s+' '.repeat(Math.max(0,n-vw(s)));}
+      const list = JSON.parse(fs.readFileSync('$PLIST','utf8')).filter(p=>!p.archived); // 归档的不显示
+      const now = Date.now();
+      const { execSync } = require('child_process');
+      let psOut = '';
+      try { psOut = execSync('ps aux', { encoding: 'utf8' }); } catch {}
+      for (const p of list) {
+        p._active = psOut.includes(p.id + '/sessions');
+        p._ago = Math.round((now - new Date(p.lastSeen).getTime()) / 60000);
+      }
+      list.sort((a,b) => (b._active?1:0) - (a._active?1:0) || a._ago - b._ago);
+      const nw = Math.max(6, ...list.map(p=>vw(p.name))) + 2;
+      console.log('  ' + '  ' + pad('NAME',nw) + pad('ID',12) + 'STATUS');
+      console.log('  ' + '─'.repeat(nw+12+20));
+      for (let i = 0; i < list.length; i++) {
+        const p = list[i];
+        const time = p._ago < 60 ? p._ago+'m ago' : p._ago < 1440 ? Math.round(p._ago/60)+'h ago' : Math.round(p._ago/1440)+'d ago';
+        const status = p._active ? G+'Active'+R : time;
+        const num = Y + String(i+1).padStart(2) + '.' + R;
+        console.log('  '+num+' '+pad(p.name,nw)+D+pad(p.id,12)+R+status);
+      }
+      console.log(D+'  pi <序号|名字> 进入   ·   pi --archive <名字> 归档(隐藏不删)   ·   pi --archived 看归档的'+R);
+    "
+  fi
+  exit 0
+fi
+
+if [ -z "$NAME" ]; then
+  echo "Usage: pi [--sc] <name>"
+  exit 1
+fi
+
+# Resolve by index or name
+ENTRY=$(node --input-type=commonjs -e "
+  const fs = require('fs'), { execSync } = require('child_process');
+  const list = JSON.parse(fs.readFileSync('$PLIST','utf8')).filter(p=>!p.archived); // 归档的不参与序号/进入解析
+  const now = Date.now();
+  let psOut = '';
+  try { psOut = execSync('ps aux', { encoding: 'utf8' }); } catch {}
+  for (const p of list) {
+    p._active = psOut.includes(p.id + '/sessions');
+    p._ago = Math.round((now - new Date(p.lastSeen).getTime()) / 60000);
+  }
+  list.sort((a,b) => (b._active?1:0) - (a._active?1:0) || a._ago - b._ago);
+  const arg = '$NAME';
+  let e;
+  if (/^\d+$/.test(arg)) {
+    const i = parseInt(arg) - 1;
+    e = list[i];
+  } else {
+    e = list.find(p => p.name === arg);
+  }
+  if (e) console.log(JSON.stringify(e));
+")
+
+if [ -z "$ENTRY" ]; then
+  if [[ "$NAME" =~ ^[0-9]+$ ]]; then
+    echo "序号 $NAME 不存在。运行 pi 查看列表。"
+    exit 1
+  fi
+  if [ -n "$MODE" ]; then
+    echo "\"$NAME\" not found."
+    exit 1
+  fi
+  if [ "$COUNT" != "0" ]; then
+    read -p "Create \"$NAME\"? [Y/n] " CONFIRM
+    case "$CONFIRM" in n|N) exit 0;; esac
+  fi
+  ID=$(node --input-type=commonjs -e "console.log(require('crypto').randomBytes(4).toString('hex'))")
+  mkdir -p "$MEMORY_DIR/$ID/sessions" "$MEMORY_DIR/$ID/.data"
+  node --input-type=commonjs -e "
+    const fs = require('fs');
+    const list = JSON.parse(fs.readFileSync('$PLIST','utf8'));
+    list.push({id:'$ID',name:'$NAME',created:new Date().toISOString(),lastSeen:new Date().toISOString(),note:'',model:''});
+    fs.writeFileSync('$PLIST',JSON.stringify(list,null,2));
+  "
+else
+  ID=$(echo "$ENTRY" | node --input-type=commonjs -e "process.stdin.on('data',d=>{console.log(JSON.parse(d).id)})")
+  NAME=$(echo "$ENTRY" | node --input-type=commonjs -e "process.stdin.on('data',d=>{console.log(JSON.parse(d).name)})")
+  node --input-type=commonjs -e "
+    const fs = require('fs');
+    const list = JSON.parse(fs.readFileSync('$PLIST','utf8'));
+    const p = list.find(x=>x.id==='$ID');
+    if(p)p.lastSeen=new Date().toISOString();
+    fs.writeFileSync('$PLIST',JSON.stringify(list,null,2));
+  "
+fi
+
+DATA_DIR="$MEMORY_DIR/$ID/.data"
+mkdir -p "$DATA_DIR"
+
+case "$MODE" in
+  # msg)   # message parked in v0.1-stable(代码保留,见 Readme.md.GITHUB)
+  #   exec node ~/.pi/agent/extensions/message/chat.mjs "$NAME"
+  #   ;;
+  sc)
+    TMUX_NAME="sc-$ID"
+    if ! tmux has-session -t "$TMUX_NAME" 2>/dev/null; then
+      echo "潜意识没有在运行。先用 pi $NAME 启动主 session。"
+      exit 0
+    fi
+    exec tmux attach -t "$TMUX_NAME" -r
+    ;;
+  think)
+    # dual-pane: upper=pi conversation, lower=thinking stream
+    THINK_LOG="$DATA_DIR/thinking.stream"
+    : > "$THINK_LOG"
+    TMUX_THINK="think-$ID"
+    tmux kill-session -t "$TMUX_THINK" 2>/dev/null || true
+    WAKEFILE="$DATA_DIR/.wake-restart"
+    LAST_NONCE=$(cat "$WAKEFILE" 2>/dev/null)
+    UPPER_SCRIPT="$DATA_DIR/.think-upper.sh"
+    cat > "$UPPER_SCRIPT" << 'UPPER_EOF'
+#!/bin/bash
+WOKE=""
+while true; do
+  PI_ALIVE_RESTART_LOOP=1 PI_ALIVE_WOKE="$WOKE" /opt/homebrew/bin/pi --session-dir "$SESSION_DIR" "$@"
+  NONCE=$(cat "$WAKEFILE" 2>/dev/null)
+  if [ -n "$NONCE" ] && [ "$NONCE" != "$LAST_NONCE" ]; then
+    LAST_NONCE="$NONCE"; WOKE=1; continue
+  fi
+  break
+done
+UPPER_EOF
+    chmod +x "$UPPER_SCRIPT"
+    tmux new-session -d -s "$TMUX_THINK" -x "$(tput cols)" -y "$(tput lines)" \
+      "SESSION_DIR='$MEMORY_DIR/$ID/sessions' WAKEFILE='$WAKEFILE' LAST_NONCE='$LAST_NONCE' bash '$UPPER_SCRIPT'"
+    tmux split-window -t "$TMUX_THINK" -v -l 30% \
+      "echo 'Thinking Stream'; tail -f '$THINK_LOG' 2>/dev/null"
+    tmux select-pane -t "$TMUX_THINK:0.0"
+    exec tmux attach -t "$TMUX_THINK"
+    ;;
+  *)
+    # wake-restart loop (Issues.DEV/010) + mutex PID lock
+    PIDFILE="$DATA_DIR/.pi-main.pid"
+    if [ -f "$PIDFILE" ]; then
+      OLD_PID=$(cat "$PIDFILE" 2>/dev/null)
+      if [ -n "$OLD_PID" ] && kill -0 "$OLD_PID" 2>/dev/null; then
+        echo "WARN:  $NAME 已有主意识在跑 (PID $OLD_PID)。不能同时开两个。"
+        exit 1
+      fi
+    fi
+    echo $$ > "$PIDFILE"
+    trap 'rm -f "$PIDFILE"' EXIT
+    WAKEFILE="$DATA_DIR/.wake-restart"
+    LAST_NONCE=$(cat "$WAKEFILE" 2>/dev/null)   # 吃掉历史残留的 nonce，避免首启误判为"睡醒"
+    WOKE=""
+    BLACKBOX="$HOME/smart-pi/pi-coding-master.DEV/Codebase/debug/god.pi.blackbox/blackbox.sh"
+    while true; do
+      if [ -x "$BLACKBOX" ]; then
+        PI_ALIVE_RESTART_LOOP=1 PI_ALIVE_WOKE="$WOKE" "$BLACKBOX" "$ID" "${NAME:-unknown}" "main" -- /opt/homebrew/bin/pi --session-dir "$MEMORY_DIR/$ID/sessions" "$@"
+      else
+        PI_ALIVE_RESTART_LOOP=1 PI_ALIVE_WOKE="$WOKE" /opt/homebrew/bin/pi --session-dir "$MEMORY_DIR/$ID/sessions" "$@"
+      fi
+      NONCE=$(cat "$WAKEFILE" 2>/dev/null)
+      if [ -n "$NONCE" ] && [ "$NONCE" != "$LAST_NONCE" ]; then
+        LAST_NONCE="$NONCE"; WOKE=1; continue   # 睡醒重启：重新拉起，并告诉新实例"你是睡醒的"
+      fi
+      break
+    done
+    ;;
+esac

package/core/god.pi.mod/cli/pi-people.sh.LESSON

@@ -0,0 +1,10 @@
+# pi-people.sh — LESSONS
+
+## 2026-06-16 改了 deepseek key 却一直 402——环境变量优先于 models.json
+**症状**：把 ~/.pi/agent/models.json 的 deepseek apiKey 换成新 key，余额闸还显示新 key 的 ¥49.99，但模型调用一直 402 "Insufficient Balance"。改 models.json、改 settings、重启、杀干净老进程，全没用。查了好几个小时、烧了好几次。
+
+**根因**：pi 解析 key 的顺序是 `authStorage.getApiKey(provider) ?? models.json.apiKey`，而 authStorage 会先读环境变量 `DEEPSEEK_API_KEY`（auth-storage.js:427-429，env key 在 includeFallback 判断之前就 return 了）。也就是说——**环境变量里的 key 永远盖过 models.json 里配的 key。** shell(~/.zshrc)里残留的旧 key（那个负余额账号）就这么一直被用 → 402。改 models.json 是白改；连"余额闸显示新 key 余额、模型调用却 402"这种矛盾，都是因为余额闸读 models.json、模型调用走 env。
+
+**修复**：launcher(pi-people.sh)在启动 pi 前，从 models.json 读出 deepseek 的字面量 key，强制 `export DEEPSEEK_API_KEY=<它>`。这样 pi 进程（及它 spawn 的 hc/sc/sl 小号）永远用 models.json 的 key，不依赖飘忽的 shell 环境。单一真相源 = models.json。
+
+**教训 / 下次怎么避免**：排查"配置改了不生效"时，**先问"这个值实际从哪取、谁的优先级最高"——环境变量、凭证库(authStorage/keychain)通常优先于 config 文件里的 apiKey。** 别一头扎进 config 文件反复改、反复重启。先用一条命令把"实际用的是哪个值"打出来（如分别测两个 key），矛盾立刻现形。这次就是只盯 models.json、忘了 env 优先，白烧好几小时。

package/core/god.pi.mod/cli/pi-people.sh.SPEC

@@ -0,0 +1,31 @@
+source: pi-people.sh @ 212c23d1
+
+# pi-people.sh — Shell script for pi people management
+
+## 职责
+pi-coding-master 的 person-based launcher：管理"人"列表（创建/列表/进入/归档/恢复），
+解析序号或名字定位人，然后以对应人的 session 目录启动真正的 pi agent 进程。
+
+## 接口 (CLI)
+- `pi` — 列出所有人（按 active 优先 + 最近优先排序）
+- `pi <名字|序号>` — 进入/创建人
+- `pi --archive <名字|序号> [更多...]` — 批量归档（隐藏不删）
+- `pi --unarchive <名字|序号> [更多...]` — 批量恢复
+- `pi --archived` — 查看已归档列表
+- `pi --sc <名字|序号>` — 只读 attach 潜意识 tmux (sc-{id})
+- `pi --dev` — 设置 PI_DEV=1 开发模式
+- 未知 `--flag` → 透传给 `/opt/homebrew/bin/pi`
+
+## 依赖
+- `~/.pi/memory/plist.json` — 人列表的单一真相源
+- `/opt/homebrew/bin/pi` — 底层 pi agent 二进制
+- `node` (JSON 操作、crypto 生成 ID)
+- `tmux` (潜意识 attach、终端会话)
+
+## 行为要点
+- 启动前从 `models.json` 提取 DEEPSEEK_API_KEY 覆盖环境变量，防 shell 残留旧 key → 402
+- 模式 flag 可在任意位置（`pi --archive 18` 和 `pi 18 --archive` 等价）
+- 排序: active(ps aux 检测) 优先 → lastSeen 近的优先；序号与显示顺序一致
+- 归档批量操作先在同一快照上解析所有目标再改，避免边改边重排序号错位
+- 主进程有 wake-restart 循环：pi 退出后若 `.wake-restart` nonce 变化则自动重启
+- PI_ALIVE_RESTART_LOOP=1 + PI_ALIVE_WOKE 环境变量控制重启闸和"睡醒"状态

package/core/god.pi.mod/paths.ts

@@ -0,0 +1,47 @@
+// paths.ts — 全局路径常量（唯一真相源）
+// 目录结构变了只改这里，其他文件全部 import { DIRS } from "#paths"
+
+import { resolve, dirname, join } from "node:path";
+import { homedir } from "node:os";
+
+const CORE = resolve(dirname(new URL(import.meta.url).pathname), "..");
+const ROOT = resolve(CORE, "../..");
+
+export const DIRS = {
+  root: ROOT,
+  core: CORE,
+
+  organs: resolve(CORE, "individual.bio.organs"),
+  gene: resolve(CORE, "individual.bio.gene"),
+
+  docs: resolve(ROOT, "Docs"),
+  devIssues: resolve(ROOT, "Docs/Dev/Issues"),
+  devLessons: resolve(ROOT, "Docs/Dev/Lessons"),
+  devNorms: resolve(ROOT, "Docs/Dev/Norms"),
+
+  deploy: resolve(ROOT, "Codebase/deploy"),
+  server: resolve(CORE, "technology.server"),
+  browserService: process.env.PI_BROWSER || "http://localhost:9222",
+} as const;
+
+// ── person 目录解析（统一入口，不要各文件自己写）──
+// personDir = ~/.pi/memory/<id>（不含 .data）
+// personDataDir = ~/.pi/memory/<id>/.data
+const PEOPLE_DIR = join(homedir(), ".pi/memory");
+
+export function personDir(sessionFile: string | null | undefined): string | null {
+  if (!sessionFile) return null;
+  const m = sessionFile.match(/\.pi\/memory\/([a-f0-9]+)\//);
+  return m ? join(PEOPLE_DIR, m[1]) : null;
+}
+
+export function personDataDir(sessionFile: string | null | undefined): string | null {
+  const pd = personDir(sessionFile);
+  return pd ? join(pd, ".data") : null;
+}
+
+export function personId(sessionFile: string | null | undefined): string | null {
+  if (!sessionFile) return null;
+  const m = sessionFile.match(/\.pi\/memory\/([a-f0-9]+)\//);
+  return m ? m[1] : null;
+}

package/core/god.pi.mod/tui.mods.blockrender/blockrender.js

@@ -0,0 +1,90 @@
+// god.pi.mod/tui.mods.blockrender/blockrender.js
+// ── pi-coding-master 统一块渲染引擎 (the one engine) ───────────────────────────────
+// 所有「● 块」—— assistant 文字 / 思考 / 工具命令 / 工具结果 —— 统一走这里，保证：
+//   1) bullet（●/○）顶格在 col 0
+//   2) 内容落在 col GUTTER(=2)，跨块对齐（说话、思考、命令同列）
+//   3) 折行后续行也缩进到 col GUTTER（挂起缩进 / hanging indent）
+//
+// 谁用它（都是 import，绝不各自重写）：
+//   - modes/interactive/components/assistant-message.js  → markdownBullet（文字/思考）
+//   - modes/interactive/components/tool-execution.js      → dot（状态点）
+//   - @earendil-works/pi-tui/dist/tui.js                  → wrapHanging（最终折行）
+//
+// 部署：install.sh 把本文件 cp 进 dist 两处（pi 组件目录 + pi-tui 根），
+//      各处用相对 import `./blockrender.js`。源码只此一份，绝不手改 live。
+
+export const GUTTER = 2; // 内容列：bullet "● " 占 2 列，内容从第 2 列起
+
+// 状态点（工具用）：进行=○(accent) / 错=●(error) / 成功=●(success)。统一在这里，别各处各写。
+export function dot(theme, opts) {
+  const o = opts || {};
+  if (o.partial) return theme.fg("accent", "○"); // ○
+  if (o.error) return theme.fg("error", "●"); // ●
+  return theme.fg("success", "●"); // ●
+}
+
+// 把一行开头的 GUTTER 个「前导可见空格」换成 "<dot> "（dot 落 col0，内容仍在 col GUTTER）。
+// 行首可能带 ANSI（颜色/背景）；只动可见的前导空格，不碰样式。
+export function swapLeadingPad(line, dotStr) {
+  const s = String(line);
+  const m = s.match(new RegExp("^((?:" + String.fromCharCode(27) + "\\[[0-9;]*m)*)( +)"));
+  if (!m || m[2].length < GUTTER) return dotStr + " " + s; // 没有足够前导空格 → 直接前置
+  const ansi = m[1];
+  const rest = s.slice(ansi.length + GUTTER); // 砍掉 GUTTER 个空格
+  return ansi + dotStr + " " + rest; // dot + 1 空格 = GUTTER 宽
+}
+
+// 渲染一个 markdown 块为「挂起 bullet」的行：
+// md 必须是用 paddingX=GUTTER 构造好的 Markdown 实例（这样全部行——含折行——都在 col GUTTER），
+// 再把首行前导空格换成 dot。→ 首行 "● 内容"、续行 "  内容"，天然挂起对齐。
+export function markdownBullet(md, dotStr, width) {
+  const lines = [...md.render(width)]; // copy: 不修改 Markdown 缓存（否则每帧重绘都会再叠加 dot）
+  if (lines.length > 0) lines[0] = swapLeadingPad(lines[0], dotStr);
+  return lines;
+}
+
+// 给【Text 组件】用的挂起折行：基于 wrapTextWithAnsi（Text 本来就用它）。
+// 若行首有前缀（空白 + 可选 ●/○ bullet 及其后空格），把整行按 (width-前缀宽) 折，续行补前缀宽空格 →
+// 续行和「● 后面的字」同列。无前缀则退回普通 wrapTextWithAnsi，行为不变（不影响别的 Text 用途）。
+export function hangWrapText(text, width, h) {
+  const { visibleWidth, wrapTextWithAnsi } = h;
+  const stripped = String(text).replace(new RegExp(String.fromCharCode(27) + "\\[[0-9;]*m", "g"), "");
+  const pm = stripped.match(/^(\s*(?:[●○◌•▪]\s+)?)/);
+  const indW = (pm && pm[1]) ? visibleWidth(pm[1]) : 0;
+  if (indW <= 0 || indW >= width) return wrapTextWithAnsi(text, width);
+  const wrapped = wrapTextWithAnsi(text, Math.max(1, width - indW));
+  if (wrapped.length <= 1) return wrapped;
+  const indent = " ".repeat(indW);
+  return wrapped.map((ln, i) => (i === 0 ? ln : indent + ln));
+}
+
+// 挂起缩进折行：超宽行折行时，续行缩进到「行首前缀」之后。
+// 前缀 = 行首空白 + 可选的 ●/○ bullet 及其后空格 → 续行和「● 后面的字」同列。
+// pi-tui 的宽度/切片 helper 跨包不同，由调用方注入 h = {visibleWidth, sliceWithWidth, sliceByColumn, isImageLine}。
+export function wrapHanging(lines, width, h) {
+  if (!Array.isArray(lines) || width <= 0) return lines;
+  const { visibleWidth, sliceWithWidth, sliceByColumn, isImageLine } = h;
+  let need = false;
+  for (const l of lines) {
+    if (typeof l === "string" && !isImageLine(l) && visibleWidth(l) > width) { need = true; break; }
+  }
+  if (!need) return lines;
+  const out = [];
+  for (const line of lines) {
+    if (typeof line !== "string" || isImageLine(line) || visibleWidth(line) <= width) { out.push(line); continue; }
+    const stripped = line.replace(new RegExp(String.fromCharCode(27) + "\\[[0-9;]*m", "g"), "");
+    const pm = stripped.match(/^(\s*(?:[●○◌•▪]\s+)?)/);
+    const indW = pm && pm[1] ? visibleWidth(pm[1]) : 0;
+    const indent = (indW > 0 && indW < width) ? " ".repeat(indW) : "";
+    let col = 0; const total = visibleWidth(line); let first = true;
+    while (col < total) {
+      const avail = first ? width : Math.max(1, width - indent.length);
+      const seg = sliceWithWidth(line, col, avail, true);
+      if (!seg || seg.width <= 0) { out.push((first ? "" : indent) + sliceByColumn(line, col, avail, true)); break; }
+      out.push((first ? "" : indent) + seg.text);
+      col += seg.width;
+      first = false;
+    }
+  }
+  return out;
+}

package/core/god.pi.mod/tui.mods.blockrender/blockrender.js.SPEC

@@ -0,0 +1,29 @@
+source: blockrender.js
+
+# blockrender.js — pi-coding-master 统一块渲染引擎
+
+## 职责
+所有「● 块」—— assistant 文字/思考/工具命令/工具结果 —— 的统一渲染引擎。
+保证 bullet 顶格 col 0、内容落 col GUTTER(=2)、折行挂起缩进到内容列。
+
+## 导出
+- `GUTTER = 2` — 内容列偏移量
+- `dot(theme, opts)` — 状态点：进行=○(accent) / 错=●(error) / 成功=●(success)
+- `swapLeadingPad(line, dotStr)` — 把行首 GUTTER 个空格换成 "dot "
+- `markdownBullet(md, dotStr, width)` — Markdown 块渲染为挂起 bullet
+- `hangWrapText(text, width, h)` — Text 组件挂起折行
+- `wrapHanging(lines, width, h)` — 超宽行挂起缩进折行
+
+## 依赖
+- 调用方注入 `h = {visibleWidth, sliceWithWidth, sliceByColumn, isImageLine}`（跨包共享，不硬依赖）
+
+## 部署
+源码只此一份（god 域），install.sh cp 到两处：
+1. `pi-dist/modes/interactive/components/blockrender.js`（组件目录）
+2. `pi-tui-dist/blockrender.js`（pi-tui 根）
+各处用相对 import `./blockrender.js`。绝不手改 live。
+
+## 行为要点
+- ANSI 剥离统一用 `String.fromCharCode(27)`，不用字面 ESC 字节
+- `wrapHanging` 只有 `visibleWidth(line) > width` 时才折行，否则原样返回
+- 行首前缀检测：空白 + 可选 ●/○ 及其后空格，折行续行缩进到前缀宽

package/core/god.pi.mod/tui.mods.footer.budget/budget_guard.ts

@@ -0,0 +1,154 @@
+// tui.mods.footer.budget/budget_guard.ts
+// ── 余额硬闸（代码强制，不靠模型自觉）─────────────────────────────────────────
+// 盯 deepseek 的【真实余额】(api.deepseek.com/user/balance) 当地面真值——它免疫我们的
+// mid-stream abort 补丁(pi 内部 usage 会把 abort 的流记成 0，系统性少算)，也覆盖所有实例。
+//
+// 两道线：
+//   1) 余额地板线 FLOOR：余额 ≤ FLOOR → 停（保证永远不会无声烧到 0）。
+//   2) 速率线 RATE：两次轮询间烧钱速率 > RATE(¥/min) → 停（专抓"一下子 100 块"那种尖峰）。
+// 触发后：连所有小号(pi-coding-master:hippocampus/subconscious/sleep)一起杀 + 显眼告警 + 拦住后续 turn。
+// 解除只能人工：/budget resume（充值后）。模型没有任何工具能绕过。
+//
+// 余额轮询结果写到 ~/.pi/agent/.pi-coding-master-balance.json，footer 读它显示"花费 + 真实余额"。
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { execSync } from "node:child_process";
+import { writeFileSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import * as rt from "#runtime";
+
+const BAL_URL = "https://api.deepseek.com/user/balance";
+const BAL_FILE = join(homedir(), ".pi/agent/.pi-coding-master-balance.json");
+
+// 可配（env 覆盖），默认值保守
+const FLOOR = Number(process.env.PI_ALIVE_BALANCE_FLOOR ?? 5);        // 余额地板线 CNY
+const RATE_LIMIT = Number(process.env.PI_ALIVE_RATE_CNY_PER_MIN ?? 10); // 速率上限 CNY/min
+const POLL_MS = Number(process.env.PI_ALIVE_BALANCE_POLL_MS ?? 45000);  // 轮询间隔
+
+// deepseek 的 key 从 models.json 取（支持 $ENV 或字面量）——换 key 只改 models.json 一处，余额闸自动跟上。
+function deepseekKey(): string | null {
+  try {
+    const cfg = JSON.parse(readFileSync(join(homedir(), ".pi/agent/models.json"), "utf8"));
+    let k = cfg?.providers?.deepseek?.apiKey;
+    if (typeof k === "string" && k.startsWith("$")) k = process.env[k.slice(1)] ?? "";
+    if (typeof k === "string" && k.trim()) return k.trim();
+  } catch {}
+  return process.env.DEEPSEEK_API_KEY || null;
+}
+
+// 同步取真实余额（curl）；key 经 env 注入子进程（不写进命令字符串，ps 看不到）。
+function fetchBalanceCNY(): number | null {
+  const key = deepseekKey();
+  if (!key) return null;
+  try {
+    const out = execSync(
+      `curl -s --max-time 15 ${BAL_URL} -H "Authorization: Bearer $DSK"`,
+      { encoding: "utf8", env: { ...process.env, DSK: key }, stdio: ["ignore", "pipe", "ignore"] },
+    );
+    const j = JSON.parse(out);
+    const b = (j?.balance_infos ?? []).find((x: any) => x.currency === "CNY") ?? j?.balance_infos?.[0];
+    return b ? Number(b.total_balance) : null;
+  } catch {
+    return null;
+  }
+}
+
+export function installBudgetGuard(pi: ExtensionAPI) {
+  let balance: number | null = null;
+  let balanceTs = 0;
+  let ratePerMin = 0;
+  let tripped: string | null = null; // null=正常；否则=触发原因
+  let personDataDir: string | null = null; // 本人 .data 目录，写 cost-<role>.json 用
+  // 当前模型的 provider —— 只有 "deepseek" 直连才受这个 deepseek 余额闸约束。
+  // 换到 siliconflow / zhipu 等：这个 deepseek 余额跟它们的钱包无关，不拦。
+  let activeProvider: string | null = null;
+  const readProvider = (ctx: any): string | null => {
+    try {
+      return ctx?.getModel?.()?.provider
+        ?? ctx?.sessionManager?.getModel?.()?.provider
+        ?? ctx?.settingsManager?.getDefaultProvider?.()
+        ?? null;
+    } catch { return null; }
+  };
+
+  function killWorkers() {
+    for (const role of ["hippocampus", "subconscious", "sleep"]) {
+      try { execSync(`pkill -f "pi-coding-master:${role}:"`, { stdio: "ignore" }); } catch {}
+    }
+    // tmux 兜底（连 bash 自愈循环一起杀）
+    try {
+      execSync(`tmux ls 2>/dev/null | grep -oE '^(hc|sc|sl)-[a-z0-9]+' | while read s; do tmux kill-session -t "$s" 2>/dev/null; done`, { stdio: "ignore" });
+    } catch {}
+  }
+
+  function trip(reason: string) {
+    if (tripped) return;
+    tripped = reason;
+    if (rt.getSessionRole() === "main") killWorkers(); // 只让 main 去杀小号，避免多实例乱杀
+    try {
+      // 缓存铁律：这条含会变的余额数字。绝不能用 steer/插到消息流前面 ——
+      // 开局即触发(poll 启动即查)时它会垫在【90万 token 快照】前面，前缀一变 → 整份快照每次重启全 cache miss。
+      // 改用 nextTurn 垫到尾部(像 continuous-date 那样)，快照永远是稳定的第一条消息。即时可见性由 before_agent_start 的 setWorkingMessage 负责。
+      pi.sendMessage(
+        { messageType: "budget-trip", content: `余额硬闸触发：${reason}。已连后台小号一起停。充值后 /budget resume 解除。`, display: true },
+        { deliverAs: "nextTurn", isTriggerNewTurn: false },
+      );
+    } catch {}
+  }
+
+  function poll(): void {
+    const b = fetchBalanceCNY();
+    if (b === null) return;
+    const now = Date.now();
+    if (balance !== null && balanceTs > 0) {
+      const dtMin = (now - balanceTs) / 60000;
+      if (dtMin >= 0.1) ratePerMin = Math.max(0, (balance - b) / dtMin); // 掉了多少 ¥/min
+    }
+    balance = b;
+    balanceTs = now;
+    try { writeFileSync(BAL_FILE, JSON.stringify({ balance: b, ratePerMin: +ratePerMin.toFixed(2), tripped, ts: now })); } catch {}
+    // 只在「快烧穿」时硬停（防烧穿）。速率只测量+显示，【不拦】——他们本来就烧得快，不该限制工作。
+    // 只有当前在用 deepseek 直连时才拦；换了 siliconflow/zhipu 等，这个 deepseek 余额与之无关 → 绝不拦。
+    if (activeProvider === "deepseek" && b <= FLOOR) trip(`余额 ¥${b.toFixed(2)} ≤ 地板 ¥${FLOOR}（防烧穿）`);
+  }
+
+  // ── turn 前硬拦 ─────────────────────────────────────────────
+  pi.on("before_agent_start", async (_event, ctx) => {
+    activeProvider = readProvider(ctx) ?? activeProvider;
+    // 换到非 deepseek（siliconflow/zhipu…）→ 自动解除 deepseek 余额闸：它跟别家钱包无关，不该拦。
+    if (tripped && activeProvider !== "deepseek") tripped = null;
+    if (tripped) { // 到这只剩「在用 deepseek 且确实触发」
+      try { (ctx as any)?.abort?.(); } catch {}
+      try { ctx.ui?.setWorkingMessage?.(`余额闸已停：${tripped}（充值后 /budget resume）`); } catch {}
+      return; // 不继续、不注入
+    }
+    if (activeProvider === "deepseek" && Date.now() - balanceTs > POLL_MS) poll(); // 只有 deepseek 才需要补查余额
+  });
+
+  // 定时轮询 + 启动即查
+  const timer = setInterval(poll, POLL_MS);
+  if ((timer as any).unref) (timer as any).unref();
+  pi.on("session_start", async (_e, ctx) => {
+    const id = (ctx as any).sessionManager?.getSessionFile?.()?.match(/\.pi\/memory\/([a-f0-9]+)\//)?.[1];
+    personDataDir = id ? join(homedir(), ".pi/memory", id, ".data") : null;
+    activeProvider = readProvider(ctx) ?? activeProvider;
+    poll(); // 只有当前是 deepseek 时 poll 内才会 trip（见上面的 provider 判断）
+  });
+  pi.on("session_shutdown", async () => { clearInterval(timer); });
+
+  // ── 各实例把自己这一 session 的累计花费写到本人 .data/cost-<role>.json ───────
+  // 主进程 footer 读 main/hc/sc 三份【分别显示】（不累加）。注意：这是 pi 自己算的花费，
+  // 因 abort 流不计而偏低，只作各实例相对参考；账户真实总额看余额接口。
+  pi.on("turn_end", async (_e, ctx) => {
+    if (!personDataDir) return;
+    let cost = 0;
+    try {
+      const entries = (ctx as any).sessionManager?.getEntries?.() ?? (ctx as any).sessionManager?.getBranch?.() ?? [];
+      for (const e of entries) { const u = (e?.message ?? e)?.usage; if (u?.cost?.total) cost += u.cost.total; }
+    } catch {}
+    const role = rt.getSessionRole();
+    try { writeFileSync(join(personDataDir, `cost-${role}.json`), JSON.stringify({ role, cost: +cost.toFixed(4), ts: Date.now() })); } catch {}
+  });
+
+}

package/core/god.pi.mod/tui.mods.footer.budget/budget_guard.ts.CHANGELOG

@@ -0,0 +1,10 @@
+[2026-06-15] created, by Claude Code
+- 新增余额硬闸（代码强制）：盯 deepseek 真实余额（地面真值，免疫 mid-stream abort 导致的 pi 内部少算）；
+  余额 ≤ FLOOR 或 烧钱速率 > RATE → 连小号(按 title pkill)一起停 + 显眼告警 + turn 前拦截；/budget 查看、resume 解除。
+- 轮询写 ~/.pi/agent/.pi-coding-master-balance.json 供 footer 显示真实余额。详见 budget-guard.ts.SPEC。
+
+[2026-06-15 续] 改成"只防烧穿"+ 各实例写花费
+- 撤掉速率线 trip：用户明确"不能限制他们认真干活"。现在【只在余额 ≤ FLOOR 时硬停】（防烧穿）；
+  速率(ratePerMin)只测量+写文件+/budget 显示，【不再拦】。
+- turn_end 各实例把自己 session 的累计花费写本人 .data/cost-<role>.json（main/hc/sc 分别）。
+  ⚠️ 这是 pi 自己算的，因 abort 流不计而偏低，只作相对参考；账户真实总额/速率看余额接口。