chore(session-mechanism): 交接单目录改名（去 05- 前缀）＋图模式触发词改为「图完成目标」
This commit is contained in:
admin committed
1 parent
ce05207aa2
commit
5c862e4005
15 files changed
+62
-62
No files matched your search
@@ -5,8 +5,8 @@
|
||||
# 约定全部依赖“人记得做”。本脚本把判据变成**一条命令 + 退出码**，不靠记忆。
|
||||
#
|
||||
# 关键设计：**mtime 只作提示、不作判定**（它分不清“谁改的”）。真正的判定来自四处：
|
||||
# ① 全局执行锁（05-交接单/.exec-lock）—— **一粗**：同一时刻只允许一个任务会话动「文档/代码/服务器」
|
||||
# ① 单级占用锁（05-交接单/.doing-<单号>）—— **一细**：这个单归谁做（供台账 / 接管使用）
|
||||
# ① 全局执行锁（交接单/.exec-lock）—— **一粗**：同一时刻只允许一个任务会话动「文档/代码/服务器」
|
||||
# ① 单级占用锁（交接单/.doing-<单号>）—— **一细**：这个单归谁做（供台账 / 接管使用）
|
||||
# ② 越界改动（不在我声明清单里的未提交文件）—— 推送前检查，防“顺手重放别人的半成品”
|
||||
# ④ 双端一致性（docs-sync-check.sh）—— 推送前检查，防“幽灵文件”（推回了别人已移走的文件）
|
||||
#
|
||||
@@ -24,7 +24,7 @@
|
||||
# # ⛔ 不带名字 ⇒ 拒绝释放（R9，2026-09-25 修）
|
||||
# # 域锁侧：--claim-exec <会话> --domains <域…> / 同姿势 --release-exec <会话>
|
||||
# bash 07-scripts/handoff-guard.sh # 看全局状态（信息模式）
|
||||
# ME="exec-session-B" MINE="05-交接单/T03-*.md" bash 07-scripts/handoff-guard.sh T03 # 开工检查（严格）
|
||||
# ME="exec-session-B" MINE="交接单/T03-*.md" bash 07-scripts/handoff-guard.sh T03 # 开工检查（严格）
|
||||
# ME="exec-session-B" MINE="..." PUSH=1 bash 07-scripts/handoff-guard.sh T03 # 推送前检查
|
||||
#
|
||||
# 环境变量：ME（我是谁 —— 用来判断锁是不是自己的；不设则一律按“别人的锁”处理）
|
||||
@@ -46,7 +46,7 @@ fi
|
||||
# 🔴 2026-10-15 修（第 11 条禁令 ＋ D 盘实测事故）：
|
||||
# 原写 `ROOT="${DSH_DOCS_ROOT:-$(cd "$_SM_HERE/.." && pwd)}"` —— 回落值是
|
||||
# `$_SM_HERE/..` ＝ **本技能包自己的 `scripts/`** ⇒ 锁根落进技能包
|
||||
# （实测已在 `<技能包>/scripts/05-交接单/.locks` 长出一把锁，本该落文档库）。
|
||||
# （实测已在 `<技能包>/scripts/交接单/.locks` 长出一把锁，本该落文档库）。
|
||||
# ✅ 现行：取不到 ⇒ **如实报错 ＋ 留痕 ＋ 退出码 2**，⛔ 不回落到包内、⛔ 不猜路径。
|
||||
if [ -z "${DSH_DOCS_ROOT:-}" ]; then
|
||||
_SM_ERR="${_SM_PKG}/logs/handoff-guard.err.log"
|
||||
@@ -59,9 +59,9 @@ if [ -z "${DSH_DOCS_ROOT:-}" ]; then
|
||||
fi
|
||||
ROOT="$DSH_DOCS_ROOT"
|
||||
cd "$ROOT" || exit 2
|
||||
LOCKDIR="$ROOT/05-交接单/.doing-"
|
||||
LOCKEXEC="$ROOT/05-交接单/.exec-lock"
|
||||
MELOCK="$ROOT/05-交接单/.me-lock"
|
||||
LOCKDIR="$ROOT/交接单/.doing-"
|
||||
LOCKEXEC="$ROOT/交接单/.exec-lock"
|
||||
MELOCK="$ROOT/交接单/.me-lock"
|
||||
ME="${ME:-}"
|
||||
|
||||
# ══════════════════════════════════════════════════════════════════════════
|
||||
@@ -77,7 +77,7 @@ ME="${ME:-}"
|
||||
#
|
||||
# 兼容：`.exec-lock` 分支**原样保留** ⇒ 未升级的会话照旧可用（hook 是启动时快照）。
|
||||
# ══════════════════════════════════════════════════════════════════════════
|
||||
LOCKSROOT="$ROOT/05-交接单/.locks"
|
||||
LOCKSROOT="$ROOT/交接单/.locks"
|
||||
GATELOCK="$LOCKSROOT/.gate" # 秒级临界区：算交集时必须串行，否则两个会话可能同时判定"无冲突"
|
||||
|
||||
# 域字符串规范化 ⇒ 域键。**必须与 lock-guard-hook.py 的 domain_key() 同规则**，
|
||||
@@ -418,15 +418,15 @@ if [ "${1:-}" = "--claim" ]; then
|
||||
[ -n "$T" ] || { echo "用法：--claim <单号> [占用者]" >&2; exit 2; }
|
||||
if mkdir "$LOCKDIR$T" 2>/dev/null; then
|
||||
printf '%s\n' "$OWNER" > "$LOCKDIR$T/OWNER"
|
||||
echo "✓ 已占位：05-交接单/.doing-$T（$OWNER）—— 完工请 --release $T"
|
||||
echo "✓ 已占位：交接单/.doing-$T（$OWNER）—— 完工请 --release $T"
|
||||
exit 0
|
||||
fi
|
||||
echo "✗ 占位失败：05-交接单/.doing-$T 已存在（占用者 $(cat "$LOCKDIR$T/OWNER" 2>/dev/null || echo '?')） → 停手" >&2
|
||||
echo "✗ 占位失败：交接单/.doing-$T 已存在（占用者 $(cat "$LOCKDIR$T/OWNER" 2>/dev/null || echo '?')） → 停手" >&2
|
||||
exit 1
|
||||
fi
|
||||
if [ "${1:-}" = "--release" ]; then
|
||||
T="${2:-}"; [ -n "$T" ] || { echo "用法：--release <单号>" >&2; exit 2; }
|
||||
rm -rf "$LOCKDIR$T" && echo "✓ 已释放：05-交接单/.doing-$T" || { echo "✗ 释放失败" >&2; exit 1; }
|
||||
rm -rf "$LOCKDIR$T" && echo "✓ 已释放：交接单/.doing-$T" || { echo "✗ 释放失败" >&2; exit 1; }
|
||||
exit 0
|
||||
fi
|
||||
|
||||
@@ -451,7 +451,7 @@ in_mine() { [ -z "$MINE" ] && return 1; for p in $MINE; do case "$1" in $p) retu
|
||||
|
||||
# ── ① 占用锁（硬判定）────────────────────────────────────
|
||||
echo
|
||||
echo "【1】占用锁（05-交接单/.doing-*）"
|
||||
echo "【1】占用锁（交接单/.doing-*）"
|
||||
shopt -s nullglob
|
||||
LOCKS=("$LOCKDIR"*)
|
||||
if [ ${#LOCKS[@]} -eq 0 ]; then
|
||||
@@ -475,9 +475,9 @@ fi
|
||||
if [ ${#LOCKS[@]} -gt 0 ]; then
|
||||
for L in "${LOCKS[@]}"; do
|
||||
n="$(basename "$L")"; T="${n#.doing-}"
|
||||
row="$(grep -m1 "^| \`$T-" 05-交接单/README.md 2>/dev/null || true)"
|
||||
row="$(grep -m1 "^| \`$T-" 交接单/README.md 2>/dev/null || true)"
|
||||
if [ -z "$row" ]; then
|
||||
echo " ⚠ $T 有占用锁，但 \`05-交接单/README.md §一\` 里**没有这一行** → 补上（新增单）"
|
||||
echo " ⚠ $T 有占用锁，但 \`交接单/README.md §一\` 里**没有这一行** → 补上（新增单）"
|
||||
VERDICT=1; HARD+=("①b $T 有锁但台账缺行")
|
||||
elif printf '%s' "$row" | grep -qE "执行中|已完成|已归档"; then
|
||||
echo " · $T 台账已标「执行中/已完成」✓"
|
||||
@@ -491,7 +491,7 @@ fi
|
||||
|
||||
# ── ①c 全局执行锁（2026-09-12 新增：同一时刻只允许一个任务会话）────
|
||||
echo
|
||||
echo "【1c】全局执行锁（05-交接单/.exec-lock）"
|
||||
echo "【1c】全局执行锁（交接单/.exec-lock）"
|
||||
if [ ! -d "$LOCKEXEC" ]; then
|
||||
echo " ✓ 无全局锁 —— ⚠️ 这**不是「可以开工」，是「你快去抢」**："
|
||||
echo " 开工前必须先：bash 07-scripts/handoff-guard.sh --claim-exec \"<你的会话名>\""
|
||||
@@ -544,7 +544,7 @@ fi
|
||||
# ── ② 越界改动（推送前硬判定）────────────────────────────
|
||||
echo
|
||||
echo "【2】未提交改动（含未跟踪）"
|
||||
CHANGED="$(git -c core.quotepath=false status --short 2>/dev/null | awk '{print $NF}' | grep -vE '^05-交接单/\.(doing-|exec-lock)' || true)"
|
||||
CHANGED="$(git -c core.quotepath=false status --short 2>/dev/null | awk '{print $NF}' | grep -vE '^交接单/\.(doing-|exec-lock)' || true)"
|
||||
OUTSIDE=(); INSIDE=()
|
||||
if [ -z "$CHANGED" ]; then
|
||||
echo " ✓ 工作区干净"
|
||||
@@ -570,7 +570,7 @@ echo
|
||||
echo "【3】近 $WINDOW 分钟被改动的文件（**仅提示**：mtime 分不清谁改的）"
|
||||
HOT="$(find . -type f -mmin "-$WINDOW" \
|
||||
-not -path './.git/*' -not -path '*/node_modules/*' -not -name '*.bak*' \
|
||||
-not -path './05-交接单/.doing-*' -not -path './05-交接单/.exec-lock*' 2>/dev/null | sed 's|^\./||' | LC_ALL=C sort)"
|
||||
-not -path './交接单/.doing-*' -not -path './交接单/.exec-lock*' 2>/dev/null | sed 's|^\./||' | LC_ALL=C sort)"
|
||||
if [ -z "$HOT" ]; then
|
||||
echo " ✓ 无（这块是「冷」的）"
|
||||
else
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""handoff-status.py — 一条命令看清 05-交接单 里哪些单子【待执行】/【已完成】/【无状态】。
|
||||
"""handoff-status.py — 一条命令看清 交接单 里哪些单子【待执行】/【已完成】/【无状态】。
|
||||
|
||||
为什么需要它：`05-交接单/交接单-已完成/` 那层目录摊平后，**"目录位置"不再表达状态**。
|
||||
为什么需要它：`交接单/交接单-已完成/` 那层目录摊平后，**"目录位置"不再表达状态**。
|
||||
状态改由**机读字段**承载（与布局解耦，摊平/搬家都不失效）：
|
||||
① 单子头部 `- 状态：…` 行（模板已有）→ ② 回退取 `05-交接单/README.md` 台账表的「状态」列
|
||||
① 单子头部 `- 状态：…` 行（模板已有）→ ② 回退取 `交接单/README.md` 台账表的「状态」列
|
||||
|
||||
用法：python 07-scripts/handoff-status.py
|
||||
"""
|
||||
@@ -38,7 +38,7 @@ import os
|
||||
import re
|
||||
|
||||
ROOT = os.environ.get("DSH_DOCS_ROOT") or os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
||||
D = os.path.join(ROOT, "05-交接单")
|
||||
D = os.path.join(ROOT, "交接单")
|
||||
README = os.path.join(D, "README.md")
|
||||
|
||||
HEAD_STATUS = re.compile(r"^[\s>*\-|#]*\*{0,2}状态\*{0,2}\s*[:：]\s*(.+?)\s*$", re.M)
|
||||
|
||||
@@ -7,7 +7,7 @@
|
||||
# 文档冲突靠 git status / mtime 能看出来，**服务器态变更看不出来**
|
||||
# （systemctl 不会告诉你 10 分钟前谁重启过）→ 只能靠显式锁。
|
||||
#
|
||||
# 与文档库锁的关系：`05-交接单/.doing-<单>` + `.exec-lock` 管「文档与单子」；本锁管「生产态」。
|
||||
# 与文档库锁的关系：`交接单/.doing-<单>` + `.exec-lock` 管「文档与单子」；本锁管「生产态」。
|
||||
# 顺序：**先抢全局执行锁 → 再占本锁**。
|
||||
#
|
||||
# 用法：
|
||||
|
||||
@@ -205,7 +205,7 @@ def main() -> int:
|
||||
root = Path(a.locks_root)
|
||||
exec_lock = root / ".exec-lock"
|
||||
elif docs and os.path.isdir(docs):
|
||||
base = Path(docs) / "05-交接单"
|
||||
base = Path(docs) / "交接单"
|
||||
root = base / ".locks"
|
||||
exec_lock = base / ".exec-lock"
|
||||
else:
|
||||
|
||||
@@ -43,7 +43,7 @@ fi
|
||||
DOCS_ROOT="$DSH_DOCS_ROOT"
|
||||
CODE_ROOT="${DSH_CODE_REPO:-${DOCS_ROOT%/*}}" # ⛔ 不留盘符：代码库＝文档库的上一级（纯 bash 展开，⛔ 不调 dirname）
|
||||
WS_ROOT="${DSH_WS_ROOT:-$(pwd)}" # ⛔ 不留盘符：默认＝当前工作目录（本文件内未被使用）
|
||||
LOCKROOT="$DOCS_ROOT/05-交接单/.locks"
|
||||
LOCKROOT="$DOCS_ROOT/交接单/.locks"
|
||||
|
||||
# ── 机制层（⛔ 不受 architecture.md 的 src/** 分层管辖，但**全平台共用**）────────
|
||||
# 判据：这些文件任一改动都会改变**所有会话**的行为 ⇒ 与层④同性质（全局影响）。
|
||||
|
||||
Reference in new issue
Block a user