Files
dsh_ai1net_server/state.py
T

420 lines
24 KiB
Python
Raw Normal View History

#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""DSH 状态快照 —— 让 AI 用「1 次调用」代替「十几轮探索」。
用法:
python state.py # 本地快照(快,无网络)
python state.py --online # 追加:与 Gitea 远端比对基线(需 SSH)
设计原则(2026-09-16 立):
① 只输出「能决定下一步」的内容。**大输出本身就是成本。**
② 只读宿主库 / 远端,**不写它们**。执行它不需要抢锁。
⚠️ **唯一例外**(2026-10-02 用户加):**会话规则机制体检**会**写一份自己的产物**
`<WS>/.workbuddy/collab/session-rules.json`(=用户要求的那枚「状态标记」)——
它只落在**本工作区自己的协作件目录**里,原子替换、不碰宿主库,故仍不改变本项免锁的性质。
③ 每条状态带「判据」——让读者不必再自己取证。
④ 默认不联网、不 SSH —— 那些是慢操作,要就显式加 --online。
"""
import io, json, os, re, subprocess, sys, datetime
REPO = r"D:/github/dsh_shenxian"
DOCS = os.path.join(REPO, "dsh-server-docs")
WS = r"E:/ProgramData/AIProject/ai1net-dsh-server"
# 🔑 2026-09-21 加 `--ws <path>`:让**其他工作区**用同一份脚本取**自己那条线**的状态。
# 用法 = python "<本脚本绝对路径>" --ws "<自己的工作区>"(本工作区无脚本时不必复制第二份)。
# ⛔ 跨工作区调用**不改变 cwds** —— 接续任务一律建在**自己的工作区**(归属三律,见技能 §0.6)。
_WS_CUSTOM = False
for _i, _a in enumerate(sys.argv):
if _a == "--ws" and _i + 1 < len(sys.argv):
WS = sys.argv[_i + 1].replace("\\", "/").rstrip("/")
_WS_CUSTOM = True
LOGDIR = os.path.join(WS, ".workbuddy", "memory")
def _norm(p):
return os.path.normcase(os.path.normpath(p.replace("\\", "/")))
def _owner_ws(path):
"""读入口文件头部的**工作区归属声明**(2026-09-21 加,治「入口落错家」)。
规范写法(放在文件前 1.2 KB 内):`> 🔴 **工作区**:<该线自己的工作区绝对路径>`
返回 "" = 未声明 ⇒ 按**本工作区**处理(兼容旧文件,不报错)。
⛔ 别的工作区复制来的副本会被识别成「外来线」并排除出 §2 / 口令 ——
否则本工作区会把**别线**当成自己的线,新会话被引到别人的待办上(2026-09-21 实测)。
"""
try:
head = io.open(path, encoding="utf-8", errors="replace", newline="").read()[:1200]
except Exception:
return ""
m = re.search(r"(?:^|[\s>|*])工作区\**\s*[::]\s*"
r"([A-Za-z]:[\\/][^\s|,,()()【】\[\]`]*)", head)
return m.group(1).rstrip("/\\") if m else ""
def _list_entries():
"""全部「接续入口_*.md」,按 mtime 降序 —— ⛔ 不写死文件名(2026-09-16 晚加)。
多线并行时**只取最新一份**会让新会话走错线(这是他线的待办),
所以这里**列全**,由新会话按自己那份接续包 / 自动化 prompt 里的线名认领。
⚠️ 2026-09-21 加归属校验:声明的工作区 ≠ 本工作区 ⇒ 标 `alien`(外来副本,应迁回+删)。
返回 4 元组 `(path, mtime, owner_ws, alien)`。
"""
try:
c = [os.path.join(WS, f) for f in os.listdir(WS)
if f.startswith("接续入口_") and f.endswith(".md")]
except Exception:
c = []
c.sort(key=os.path.getmtime, reverse=True)
out = []
for p in c:
ow = _owner_ws(p)
out.append((p,
datetime.datetime.fromtimestamp(os.path.getmtime(p)).strftime("%m-%d %H:%M"),
ow, bool(ow) and _norm(ow) != _norm(WS)))
return out
ENTRIES = _list_entries()
LOCAL = [e for e in ENTRIES if not e[3]] # 属于本工作区的线(§2 展开 / 口令只用这些)
ALIEN = [e for e in ENTRIES if e[3]] # 别的工作区的入口副本(应迁移 + 删除)
ENTRY = ((LOCAL or ENTRIES)[0][0] if ENTRIES
else os.path.join(WS, "接续入口_覆盖网络线_20260916.md"))
LOCK = os.path.join(DOCS, "交接单", ".exec-lock")
ONLINE = "--online" in sys.argv
def sh(cmd, cwd=None, timeout=25):
try:
p = subprocess.run(["bash", "-lc", cmd], cwd=cwd, capture_output=True,
timeout=timeout)
return (p.stdout or b"").decode("utf-8", "replace").strip()
except Exception as e:
return "!%s" % type(e).__name__
def read(p):
try:
return io.open(p, encoding="utf-8", errors="replace", newline="").read()
except Exception:
return ""
def line(k, v):
print(" %-9s %s" % (k, v))
print("═══ DSH 状态快照 · %s ═══" % datetime.datetime.now().strftime("%Y-%m-%d %H:%M"))
print()
# ── 1. 执行锁(域锁 + 旧全局锁)────────────────────────────────
# ⚠️ `.exec-lock` 是**目录**(`handoff-guard.sh --claim-exec` 用 `mkdir` 原子创建,OWNER 写在里面),
# **不是文件**。旧版按文件读 ⇒ 永远读空 ⇒ **恒报「空闲」** —— 也就是每个新会话读到的**第一个
# 信号就是错的**(2026-09-16 实测:本会话正持锁时 state.py 仍报空闲)。两种形态都兼容:
# 目录读 `OWNER`,历史遗留的普通文件照读。
#
# 2026-09-22 加:**域锁**(`交接单/.locks/*`)—— 不重叠的域可并行 ⇒ 开机第 0 步必须能看见
# 「谁占了哪些域」,否则新会话会误判"不能开工"而错失并行机会。
LOCKSROOT = os.path.join(DOCS, "交接单", ".locks")
SID = os.environ.get("CODEBUDDY_SESSION_ID", "")
s = ""
if os.path.isdir(LOCK):
s = read(os.path.join(LOCK, "OWNER")).strip()
elif os.path.exists(LOCK):
s = read(LOCK).strip()
dom_locks = []
if os.path.isdir(LOCKSROOT):
for _n in sorted(os.listdir(LOCKSROOT)):
_d = os.path.join(LOCKSROOT, _n)
if not os.path.isdir(_d):
continue
_own = read(os.path.join(_d, "OWNER")).strip()
_who = (_own.splitlines() or [""])[0]
_doms = " ".join(read(os.path.join(_d, "DOMAINS")).split())
if _n == ".publish":
dom_locks.append(("发布锁", _who, "commit/push/scp 期间不可并行"))
elif _n == ".migrations":
for _m in sorted(os.listdir(_d)) if os.path.isdir(_d) else []:
_md = os.path.join(_d, _m)
if os.path.isdir(_md):
dom_locks.append(("骨架", read(os.path.join(_md, "OWNER")).splitlines()[0] if read(os.path.join(_md, "OWNER")).strip() else "?", _m))
elif _n.startswith("."):
continue
else:
_mine = bool(SID) and SID in _own
dom_locks.append(("域锁" + ("(我)" if _mine else ""), _who, _doms))
if not s and not dom_locks:
line("[锁]", "空闲 ✅ —— 「空闲」≠「可以开工」:先 --claim-exec 抢锁")
elif dom_locks and not s:
# 纯域锁形态(目标形态):并行的关键信号 —— 不重叠即可开工
line("[锁]", "🟢 域锁形态(%d 把)—— **不重叠的域可以并行**" % len(dom_locks))
for _k, _who, _x in dom_locks[:5]:
line("", " · [%s] %s | %s" % (_k, _who, _x[:70]))
line("", "⇒ 你要的域若与上面不重叠 ⇒ 可直接抢:--claim-exec \"<会话名>\" --domains <域...>")
line("", "⇒ 重叠 ⇒ 停手或改做不重叠的域(⛔ 不得删锁,R9)")
else:
ls = [x.strip() for x in s.splitlines() if x.strip()]
line("[锁]", "🔴 旧全局锁被占 —— %s" % (" / ".join(ls[:3]) if ls else s))
line("", "⇒ 该会话未升级到域锁 ⇒ 全局独占;等它 --release-exec(⛔ 不得删锁,R9)")
for _k, _who, _x in dom_locks[:4]:
line("", " · [%s] %s | %s" % (_k, _who, _x[:70]))
# ── 2. git 基线 ────────────────────────────────────────────────
head = sh("git rev-parse --short HEAD", REPO)
br = sh("git rev-parse --abbrev-ref HEAD", REPO)
porcelain = sh("git status --porcelain", REPO)
nmod = len([l for l in porcelain.splitlines() if l.strip()])
line("[git]", "分支 %s · HEAD %s" % (br or "?", head or "?"))
line("", "工作区 %s" % ("干净 ✅" if nmod == 0 else "🟡 %d 处改动(未 commit)" % nmod))
if _WS_CUSTOM:
line("", "⚠️ 本次 `--ws` 指向别的工作区 ⇒ [git] 段是平台代码仓 `%s` 的状态,与该工作区无关" % REPO)
for l in porcelain.splitlines()[:8]:
print(" %s" % l[:96])
if nmod > 8:
print(" … 余 %d 处" % (nmod - 8))
# ── 3. 远端 / 镜像(--online)──────────────────────────────────
if ONLINE:
rem = sh('GIT_SSH_COMMAND="ssh -o BatchMode=yes -o ConnectTimeout=12 " '
'git ls-remote origin refs/heads/master', REPO, 40)
m = re.search(r"([0-9a-f]{7,40})\s+refs/heads/master", rem)
if m:
rsha = m.group(1)[:7]
anc = sh("git merge-base --is-ancestor %s HEAD && echo YES || echo NO" % rsha, REPO)
line("[远端]", "master=%s %s" % (rsha, "✅ 已同步" if rsha == head
else ("可快进" if anc == "YES" else "🔴 已分叉")))
else:
line("[远端]", "⚠️ ls-remote 取不到(本机 refs/remotes 写不进是已知的)")
# ── 4. 接续入口 §2 待办(⚠️ 多线并行:只走你自己那条)──────────
if len(LOCAL) > 1:
line("[入口]", "⚠️ 检测到 **%d 条工作线** —— ⛔ 只走**你自己那条**"
"(以你手上那份接续包 / 自动化 prompt 里的线名为准),别串线" % len(LOCAL))
for p0, mt0, ow0, al0 in ENTRIES:
line("[入口]", "%s(mtime %s)%s" % (
os.path.basename(p0), mt0,
" 🔴 **外来线**(属于 %s ⇒ 迁回该工作区并删本副本)" % ow0 if al0
else (" ← 最新" if p0 == ENTRY else "")))
if ALIEN:
line("", "🔴 上面 %d 条是**别的工作区的入口副本**(归属三律:入口只允许一份、在本工作区)"
"⇒ 内容迁回 %s,删掉这里的副本" % (len(ALIEN), ALIEN[0][2]))
t = read(ENTRY)
if t:
print(" ——下面只展开最新的那条(%s)§2——" % os.path.basename(ENTRY))
# ⚠️ 2026-09-25 修:原正则只认 `## 2.`,而本工作区的入口一律写 `## §2 xxx`
# ⇒ 一直落到下面的「§2 未解析出条目」(实测:4 条入口**全部**解析为空 ——
# `[入口] §2` 段是每棒开机第一个信号,它空着 = 下一棒拿不到动作)。
# 现兼容三种写法:`## 2.` / `## §2 ` / `## 2、`;⚠️ 用 lookahead 卡住分隔符,
# ⛔ 不能让 `## 2026-…` 这类以 2 开头的标题被误当成 §2。
sec = re.search(r"##\s*(?:§)?\s*2(?=[.\s、]|$)[^\n]*\n(.*?)(?=\n##\s|\Z)", t, re.S)
body = sec.group(1) if sec else ""
items = re.findall(r"^\s*(?:\d+[.)]|[-*])\s+(.{6,120})", body, re.M)
for i, it in enumerate(items[:6], 1):
print(" %d) %s" % (i, it.replace("**", "").strip()[:104]))
if not items:
line("", "(§2 未解析出条目 —— 请直接读该文件)")
# ── 5. 上次收口点 ─────────────────────────────────────────────
today = os.path.join(LOGDIR, datetime.date.today().isoformat() + ".md")
lg = read(today)
if lg:
# 优先找「接续点 / 收口」章节,其次取最后一个章节
best = None
for m in re.finditer(r"^#{2,3}\s*(.+)$", lg, re.M):
if ("接续" in m.group(1)) or ("收口" in m.group(1)):
best = m
if best is None:
hs = list(re.finditer(r"^#{2,3}\s*(.+)$", lg, re.M))
best = hs[-1] if hs else None
start = best.start() if best else 0
title = best.group(1).strip() if best else "(无章节)"
nxt = re.search(r"^#{2,3}\s", lg[start + 4:], re.M)
sec = lg[start:start + 4 + nxt.start()] if nxt else lg[start:]
line("[收口]", "%s |今日日志 %d 字符" % (title[:64], len(lg)))
# ⚠️ 日志是**多会话共用**的:多线并行时,最后写的那个不一定是「你那条线」的
_ti = [m.group(1).strip() for m in re.finditer(r"^#{2,3}\s*(.+)$", lg, re.M)
if ("接续" in m.group(1)) or ("收口" in m.group(1))]
if len(_ti) > 1:
print(" ⚠️ 今日日志里有 %d 个接续点/收口章节(多线共用同一份日志)"
"⇒ 只认**你那条线**的那一个:" % len(_ti))
for _x in _ti[-3:]:
print(" · %s" % _x[:96])
print(" ⚠️ 下面是**日志原文摘录**,可能含已被后续推翻的结论"
"(实测教训:曾摘出「定时自动化仍在烧钱」「rawUsage 为空」两条已勘误说法)")
print(" ⇒ 当前事实以 `.workbuddy/memory/MEMORY.md` 状态层为准;该做什么看上面 [入口] 段。")
keys = [l.strip() for l in sec.split("\n")
if re.match(r"^\s*[-*]\s*\*\*", l) or re.match(r"^\s*\d+[.)]\s*\*\*", l)]
for b in (keys[:5] or [l.strip() for l in sec.split("\n") if l.strip().startswith("-")][:3]):
print(" %s" % b.replace("**", "").strip()[:104])
if best and best.group(1) != title:
pass
else:
line("[收口]", "⚠️ 今日日志不存在:%s" % today)
# ── 5.5 钩子闸门自检(2026-09-30 加)────────────────────────────
# 为什么必须有:`settings.json.bak-decision-20260927-233116`(mtime 09-26 21:17)里 **hooks 段是空的**
# ⇒ 那次改动把 `stop-dialog-guard` 的 UserPromptSubmit 钩子(=「上下文到量 ⇒ 强制收口:先落盘、
# 出接续包、登记接续棒」的**唯一触发源**)连同其它闸门**整段清掉**;09-27~09-30 只补回了
# decision_bridge / wb-result-hook ⇒ 该机制**静默失效 4 天**(guard 日志最后一条 09-26 19:19),
# 直到 09-30 才被人发现。⇒ 判据不能靠"记得去数":开工第 0 步(本文件)就把它数出来。
# ⚠️ 读配置必须认 `CODEBUDDY_CONFIG_DIR`(实测本机 = `E:\ProgramData\.workbuddy`);guard 自带的
# `path_health()` 读的是 `WORKBUDDY_CONFIG_DIR`/`~/.workbuddy` ⇒ 本机**永远读空 ⇒ 恒静默**。
GATES = [
("UserPromptSubmit", "stop-dialog-guard.py", "水位/收口触发源(接续机制的起点)"),
("UserPromptSubmit", "skill-load-guard.py", "用户点名方法 ⇒ 强制加载技能"),
("PreToolUse", "lock-guard-hook.py", "无锁不许改文档库 / 代码库"),
("PreToolUse", "bash-output-guard.py", "拦下会灌爆上下文的读命令"),
]
def _tail_time(p):
"""只读文件尾 8 KB 取最后一行前 16 字符(⛔ 不整读 —— lock-hook.log 已 3.6 MB)。"""
try:
with io.open(p, "rb") as f:
f.seek(0, 2)
n = min(8192, f.tell())
f.seek(-n, 2)
rows = [x for x in f.read().decode("utf-8", "replace").split("\n") if x.strip()]
return (rows[-1] or "")[:16] if rows else "空"
except Exception:
return "缺"
_WSROOT = os.path.dirname(os.path.abspath(__file__))
GATE_LOGS = [("收口", os.path.join(_WSROOT, ".workbuddy", "stop-dialog-guard.log")),
("技能", os.path.join(_WSROOT, ".workbuddy", "skill-load-guard.log")),
("限流", os.path.join(_WSROOT, ".workbuddy", "bash-guard.log")),
("锁", os.path.join(os.path.dirname(DOCS), ".workbuddy", "lock-hook.log"))]
_CFG = os.path.join(os.environ.get("CODEBUDDY_CONFIG_DIR")
or os.path.join(os.path.expanduser("~"), ".workbuddy"), "settings.json")
try:
_HK = (json.load(io.open(_CFG, encoding="utf-8")) or {}).get("hooks") or {}
_cmds = [(ev, str(h.get("command") or ""))
for ev, arr in _HK.items() for blk in (arr or [])
for h in ((blk or {}).get("hooks") or [])]
except Exception:
_HK, _cmds = None, []
if _HK is None:
line("[闸门]", "⚠️ 读不到 hooks 配置:%s" % _CFG)
else:
_miss = [g for g in GATES if not any(g[0] == ev and g[1] in c for ev, c in _cmds)]
if _miss:
line("[闸门]", "🔴 关键闸门**不在册** ⇒ 该机制现在不会运行:")
for _ev, _f, _why in _miss:
print(" · %s(应挂 %s)—— %s" % (_f, _ev, _why))
else:
_cnt = {}
for _ev, _c in _cmds:
_cnt[_ev] = _cnt.get(_ev, 0) + 1
line("[闸门]", "✅ 关键闸门在册 | %s"
% " ".join("%s×%d" % (k, v) for k, v in sorted(_cnt.items())))
_bad = []
for _ev, _c in _cmds:
_m = re.search(r'([A-Za-z]:[\\/][^"\']*?\.py)', _c)
if _m and not os.path.exists(_m.group(1)):
_bad.append("%s(%s)" % (os.path.basename(_m.group(1)), _ev))
if _bad:
print(" ⚠️ 路径自检:%s 不存在 ⇒ 该钩子**静默失效**"
% "、".join(sorted(set(_bad))[:4]))
# 每条闸门日志的「最后一行时间」= 它最后一次真被调用的时刻(陈旧 ⇒ 该闸门已掉线)
print(" · 各闸门日志最后一行:%s"
% " ".join("%s=%s" % (t, _tail_time(p)) for t, p in GATE_LOGS))
# ── 5b. 会话规则机制体检(🔴 用户 2026-10-02 口径:开会话后**第一件事**)────────
# 用户原话逐字(**两句,第二句是纠正**):
# ① 「这个会话和协作会话的技能包 运行的第一件事 ,就应该是检查清楚
# 所有会话规划是否配置完整且生效,然后标记一个状态」
# ② 「就应该是检查清楚 **所有会话规则机制** 是否配置完整且生效,**不是规划 是 规则**」
# ⇒ 对象=**规则机制**(钩子 / 闸门 / 技能指针 / 常驻 / 编排…),⛔ 不是"排期规划"。
# 首版按①的字面写成「会话规划体检」、只查排期那一面 ⇒ 当天实测出来的三类失效
# (钩子指向已退役技能名 / 快照写进幽灵目录 / 每轮注入的记忆指针悬空)**一条都查不到**
# ⇒ 按②重做,⚠️ 旧脚本已退役到 `归档/技能包-旧件-20261002/`。
# 为什么放在这里:本文件是**所有会话的开工第 0 步**(见文末口令),把它挂在这儿
# 才能保证"第一件事"真的发生在第一步,而不是靠人记得。
# ⚠️ 逻辑**在技能包里**(skill 就是 skill)—— 这里只做**调用 + 摘要**;
# ⛔ 找不到技能包时**显式告警**,⛔ 绝不静默跳过(静默跳过=本项目反复踩的那个坑)。
print()
def _skills_root():
for c in (os.environ.get("DSH_SKILLS_ROOT"),
os.path.join(os.environ.get("CODEBUDDY_CONFIG_DIR") or "", "skills"),
os.path.join(os.path.expanduser("~"), ".workbuddy", "skills")):
if c and os.path.isdir(c):
return c
return None
_sk = _skills_root()
_spc = os.path.join(_sk, "session-mechanism", "scripts", "session-rules-check.py") if _sk else ""
if not (_spc and os.path.isfile(_spc)):
line("[会话规则]", "⚠️ 体检脚本不在 ⇒ 本项**未跑**(⛔ 不是「没问题」):"
"skills/session-mechanism/scripts/session-rules-check.py")
else:
try:
_pr = subprocess.run([sys.executable, _spc, "--ws", WS],
capture_output=True, timeout=40)
_txt = (_pr.stdout or b"").decode("utf-8", "replace").strip()
for _l in _txt.split("\n"):
print(" " + _l)
if not _txt:
_err = (_pr.stderr or b"").decode("utf-8", "replace").strip()
line("[会话规则]", "⚠️ 体检无输出(rc=%d)%s"
% (_pr.returncode, (":" + _err[:100]) if _err else ""))
except Exception as _e:
line("[会话规则]", "⚠️ 体检自身异常(⛔ 不影响开工):%s" % str(_e)[:120])
# ── 5c. 🔴🔴 钩子环境体检(2026-10-02 用户定案· 技能必须先检查环境配置)────────
# 为什么单列一项(真实代价:另一工作区为「钩子静默零输出」绕了两轮):
# 2026-10-02 实测 —— `reply-style-guard.py` 被注册成文档库里的旧副本,
# 它沿 `__file__` 上溯定位技能库失败 ⇒ 落进 `os.path.expanduser('~/.workbuddy/skills')`
# 而 **Windows 上 `~` 不是真配置目录** ⇒ 静默零输出,日志只有一行 `core=0 字符`
# ⇒ **「机制坏了」与「没配规则」表现完全一样**(原钩子设计判据就是「读不到就静默」)。
# 本项判**两样**:① 技能库根能否定位(⛔ 已删 `~` 回落)② 已注册钩子**逐条目标是否存在**。
# ⛔ 本项**只读**,⛔ 不写环境标记(标记由 `hooks/_env.py --stamp` 显式写)。
_envpy = os.path.join(_sk, "session-mechanism", "scripts", "hooks", "_env.py") if _sk else ""
if not (_envpy and os.path.isfile(_envpy)):
line("[钩子环境]", "⚠️ 自检模块不在 ⇒ 本项**未跑**(⛔ 不是「没问题」):"
"skills/session-mechanism/scripts/hooks/_env.py")
else:
try:
_er = subprocess.run([sys.executable, _envpy, "--ws", WS],
capture_output=True, timeout=30)
_et = (_er.stdout or b"").decode("utf-8", "replace").strip()
for _l in _et.split("\n"):
print(" " + _l)
if _er.returncode != 0:
_es = (_er.stderr or b"").decode("utf-8", "replace").strip()
line("[钩子环境]", "❌ 环境**未配好** ⇒ 钩子会静默失效(⛔ 先修再开工,"
"否则每轮规则注入都是空的)%s" % ((":" + _es[:140]) if _es else ""))
except Exception as _e2:
line("[钩子环境]", "⚠️ 体检自身异常(⛔ 不影响开工):%s" % str(_e2)[:120])
# 环境标记(用户 2026-10-02 要求:「在对应文件夹创建状态变量和时间作为标记」):
# ⛔ 标记缺失/过期**只提示不阻塞**(它是"上次何时体检过"的记录,不是闸门)。
# 🔴🔴 2026-10-02 用户拍板 **A 案:装全局,一处配好所有工作区共用** ⇒ 读**全局**那份
# (`<配置目录>/env-stamp.json`),⛔ 不再只读工作区那份(那是旧口径的残留)。
_st = os.path.join(os.environ.get("CODEBUDDY_CONFIG_DIR") or r"E:\ProgramData\.workbuddy",
"env-stamp.json")
_st_old = os.path.join(WS, ".workbuddy", "env-stamp.json")
if os.path.isfile(_st):
try:
_sj = json.loads(open(_st, encoding="utf-8").read())
print(" · 环境标记(全局口径):%s | scope=%s | ok=%s"
% (_sj.get("checked_at", "?"), _sj.get("scope", "?"), _sj.get("ok", "?")))
if os.path.isfile(_st_old):
print(" ⚠️ 本工作区还留着一份旧 `scope=workspace` 标记 ⇒ **读数不认它**"
"(现行口径=全局,用户 2026-10-02 拍板)。⛔ 不影响生效,可删:%s" % _st_old)
except Exception:
print(" · 全局环境标记存在但**读不出**(⛔ 损坏)⇒ 建议重跑 `_env.py --stamp`")
else:
print(" · 全局环境标记:**无** ⇒ 首次使用请跑 "
"`python \"%s\" --ws \"%s\" --stamp --scope global`" % (_envpy, WS))
# ── 6. 下一步 ─────────────────────────────────────────────────
print()
print(" ⇒ 下一步:按**你那条线**(见下面「口令」)的 [入口] §2 第 1 条开工;"
"⛔ 不要再 Glob/Grep 全库探索(省积分第一纪律)")
print(" ⇒ 口令(复制给新会话):跑 `state.py`,按 **%s** 那段 §2 第 1 条开工"
% os.path.basename(ENTRY).replace("接续入口_", "").replace(".md", "")
.rsplit("_", 1)[0])
print(" ⇒ 动手前:bash \"%s/07-scripts/handoff-guard.sh\" --claim-exec \"<你的会话名>\"" % DOCS)