@hupan56/wlkj 3.1.27 → 3.1.29

package/templates/qoder/scripts/protocol/mcp/zentao_mcp_server.py

@@ -115,35 +115,13 @@ from foundation.protocol.mcp_base import BaseMCPServer, tool
 
 
 def _assignee_account(item):
-    """从任务/Bug 提取指派人账号 (兼容禅道两种返回格式)。
-
-    禅道 API 的 assignedTo 可能是:
-      - dict: {'id':14,'account':'zhengkang','realname':'郑康'} (列表接口常见)
-      - str: 'zhengkang' (详情接口常见)
-      - None/其它: 返回空串
-    旧代码用 str(dict)==account 比较, 永远匹配不上 → 过滤全失效。本函数统一取 account。
-    """
-    a = item.get('assignedTo') if isinstance(item, dict) else None
-    if isinstance(a, dict):
-        return str(a.get('account', ''))
-    if isinstance(a, str):
-        return a
-    return ''
+    """从任务/Bug 提取指派人账号 (转发 ZentaoClient, 单一真相源)。"""
+    return ZentaoClient.assignee_account(item)
 
 
 def _openedby_account(item):
-    """从任务/Bug 提取创建人账号 (openedBy 字段, 同 _assignee_account 的兼容逻辑)。
-
-    用途: Bug 的归属判定 —— 团队习惯提了 bug 不指派 (assignedTo=None), bug 留在创建人头上。
-    "我的 bug" 应包含 openedBy==我 (我提的), 不能只认 assignedTo。
-    openedBy 在禅道里通常是字符串 (账号), 兼容 dict 格式。
-    """
-    o = item.get('openedBy') if isinstance(item, dict) else None
-    if isinstance(o, dict):
-        return str(o.get('account', ''))
-    if isinstance(o, str):
-        return o
-    return ''
+    """从任务/Bug 提取创建人账号 (转发 ZentaoClient, 单一真相源)。"""
+    return ZentaoClient.openedby_account(item)
 
 
 class ZentaoMCPServer(BaseMCPServer):
@@ -196,8 +174,9 @@ class ZentaoMCPServer(BaseMCPServer):
         """归属校验 (写操作前调用): 查 item 详情, 校验归属。
 
         防止误改队友任务/Bug。返回 None=放行, 字符串=拒绝原因。
-        - 未配置 MY_ACCOUNT (兼容旧环境): 不校验, 返回 None (放行, 退回旧行为)。
-        - 查询失败: 放行 (不因网络抖动阻塞用户, 禅道侧权限仍兜底)。
+        - 未配置 MY_ACCOUNT: fail-closed 拒绝 (对齐 _require_my_account; 共享账号下禅道
+          权限分不出谁, 未识别身份 = 无法判定归属 → 拒绝写, 防静默放行改队友数据)。
+        - 查询失败: 放行 (网络抖动是暂时的, 不锁死用户; 禅道侧权限仍有一层兜底)。
         - 归属语义 (v3.1.6): task 只认 assignedTo==我; bug/story 认 assignedTo==我 OR openedBy==我
           (原因: bug/story 创建后 assignedTo 常为空, 用户提的自己能 resolve/close 是合理的;
           task 则不放宽 —— task 的 openedBy 是组长拆的, 归属以 assignedTo 为准)。
@@ -208,7 +187,9 @@ class ZentaoMCPServer(BaseMCPServer):
             item_id: 任务/Bug ID
         """
         if not MY_ACCOUNT:
-            return None  # 未配置归属 → 不强制 (兼容)
+            # fail-closed: 共享账号下无法判定归属 → 拒绝写, 防改错队友
+            return ('🚫 未识别禅道身份, 无法校验归属, 已拒绝写操作(防改错队友)。\n'
+                    '  修复: /wl-init 配置禅道账号, 或 member.json 加 "zentao_account"。')
         r = _api('GET', '/%ss/%s' % (kind, item_id))
         if r.status_code not in (200, 201):
             return None  # 查询失败不阻塞 (禅道权限兜底)
@@ -230,31 +211,61 @@ class ZentaoMCPServer(BaseMCPServer):
     # 旧工作流只查最近几个执行 → 漏掉早期任务 (用户实测: 61 执行只查 12 个,
     # 漏 9 个未开始任务)。这些辅助方法封装全量扫描, 供 my_workbench 等工具复用。
 
-    def _fetch_all_executions(self, limit=200):
-        """全量拉执行列表 (默认 200, 覆盖团队历史执行量)。返回 [(id,name,status),...] 或 None。"""
-        r = _api('GET', '/executions', {'limit': limit})
-        if r.status_code not in (200, 201):
-            return None
-        data = r.json()
-        execs = data.get('executions') if isinstance(data, dict) else None
-        if not isinstance(execs, list):
-            return None
-        return [(e.get('id'), str(e.get('name', ''))[:20], e.get('status', '')) for e in execs]
+    def _paged_list(self, path, params, list_key, page_size=100, max_pages=20):
+        """分页拉全量 (循环 page+limit, 按 id 去重防禅道不支持 page)。
 
-    def _collect_my_tasks(self, status_filter=None):
-        """全量扫所有执行, 收集指派给我(MY_ACCOUNT)的任务。
+        禅道列表接口默认 limit≈20, 大集合超默认页就静默漏数据 (如产品>20 → 漏整个产品,
+        连带它的 bugs/stories 全漏)。本方法循环翻页, 读到不足一页或撞全重复即停。
+        禅道若不支持 page 参数(总返回第一页), 按 id 去重保证数据正确, 只是多几次冗余请求。
+        Returns: (合并去重列表, 是否截断[读满 max_pages 仍未到尾])。
+        """
+        seen, all_items = set(), []
+        truncated = False
+        for page in range(1, max_pages + 1):
+            p = dict(params or {})
+            p.update({'limit': page_size, 'page': page})
+            r = _api('GET', path, p)
+            if r.status_code not in (200, 201):
+                break
+            data = r.json()
+            items = data.get(list_key) if isinstance(data, dict) else None
+            if not isinstance(items, list) or not items:
+                break
+            new = 0
+            for it in items:
+                if not isinstance(it, dict):
+                    continue
+                key = it.get('id', id(it))
+                if key in seen:
+                    continue
+                seen.add(key)
+                all_items.append(it)
+                new += 1
+            if new == 0:
+                break          # 本页全重复(禅道不支持 page) → 停
+            if len(items) < page_size:
+                break          # 不足一页 = 最后一页
+        else:
+            truncated = True   # 读满 max_pages 仍未到尾
+        return all_items, truncated
 
-        Args:
-            status_filter: 可选, 只保留该状态 (如 'wait'/'doing'); None=全部非终态。
-        Returns:
-            (任务列表, 执行映射) 或 (None, 错误提示)。任务为统一 dict:
-              {id,name,status,pri,execution,execution_name,estimate,left,deadline,story}
+    def _fetch_all_executions(self):
+        """全量拉执行列表 (循环翻页, 防漏)。返回 [(id,name,status),...] 或 None。"""
+        execs, _ = self._paged_list('/executions', None, 'executions')
+        out = [(e.get('id'), str(e.get('name', ''))[:20], e.get('status', ''))
+               for e in execs if isinstance(e, dict) and e.get('id') is not None]
+        return out or None
+
+    def _collect_all_tasks(self):
+        """全量扫所有执行, 收集全部任务(不过滤归属)。
+
+        _collect_my_tasks(再过滤我的) 与 team_tasks_summary(全量聚合) 的共同遍历骨架(DRY)。
+        Returns: (任务列表, None) 或 (None, 错误)。每条带 execution/execution_name。
         """
         execs = self._fetch_all_executions()
         if execs is None:
             return None, '查询执行列表失败, 稍后重试。'
-        emap = {eid: ename for eid, ename, _ in execs}
-        mine = []
+        all_t = []
         for eid, ename, _ in execs:
             r = _api('GET', '/executions/%s/tasks' % eid, {'limit': 200})
             if r.status_code not in (200, 201):
@@ -266,14 +277,29 @@ class ZentaoMCPServer(BaseMCPServer):
             for t in tasks:
                 if not isinstance(t, dict):
                     continue
-                if _assignee_account(t) != MY_ACCOUNT:
-                    continue
-                if status_filter and t.get('status') != status_filter:
-                    continue
                 t2 = dict(t)
                 t2['execution'] = eid
                 t2['execution_name'] = ename
-                mine.append(t2)
+                all_t.append(t2)
+        return all_t, None
+
+    def _collect_my_tasks(self, status_filter=None):
+        """指派给我(MY_ACCOUNT)的任务(在 _collect_all_tasks 基础上过滤归属)。
+
+        Args:
+            status_filter: 可选, 只保留该状态 (如 'wait'/'doing'); None=全部。
+        Returns: (任务列表, None) 或 (None, 错误)。
+        """
+        all_t, err = self._collect_all_tasks()
+        if err:
+            return None, err
+        mine = []
+        for t in all_t:
+            if _assignee_account(t) != MY_ACCOUNT:
+                continue
+            if status_filter and t.get('status') != status_filter:
+                continue
+            mine.append(t)
         return mine, None
 
     def _collect_my_bugs(self):
@@ -285,23 +311,11 @@ class ZentaoMCPServer(BaseMCPServer):
         assignedTo=None → 旧逻辑 Bug=0, 用户"明明有 BUG"却查不到)。
         返回 (bug列表, None) 或 (None, 错误)。bug dict 加 _why 字段标记归属来源。
         """
-        r = _api('GET', '/products', None)
-        if r.status_code not in (200, 201):
-            return None, '查询产品列表失败。'
-        data = r.json()
-        prods = data.get('products') if isinstance(data, dict) else None
-        if not isinstance(prods, list):
-            return None, '产品列表响应异常。'
+        prods, _ = self._paged_list('/products', None, 'products')
         mine = []
         for p in prods:
             pid = p.get('id')
-            r = _api('GET', '/products/%s/bugs' % pid, {'limit': 500})
-            if r.status_code not in (200, 201):
-                continue
-            data = r.json()
-            bugs = data.get('bugs') if isinstance(data, dict) else None
-            if not isinstance(bugs, list):
-                continue
+            bugs, _ = self._paged_list('/products/%s/bugs' % pid, None, 'bugs')
             for b in bugs:
                 if not isinstance(b, dict):
                     continue
@@ -326,24 +340,11 @@ class ZentaoMCPServer(BaseMCPServer):
         只认 assignedTo 会让用户提的需求查不到 (同 Bug 的踩坑)。
         返回 (story列表, None) 或 (None, 错误)。story dict 加 _why 字段标记来源。
         """
-        r = _api('GET', '/products', None)
-        if r.status_code not in (200, 201):
-            return None, '查询产品列表失败。'
-        data = r.json()
-        prods = data.get('products') if isinstance(data, dict) else None
-        if not isinstance(prods, list):
-            return None, '产品列表响应异常。'
+        prods, _ = self._paged_list('/products', None, 'products')
         mine = []
         for p in prods:
             pid = p.get('id')
-            r = _api('GET', '/products/%s/stories' % pid, {'limit': 500})
-            # ★ 禅道列表接口可能返回 201 (Created), 不能只认 200
-            if r.status_code not in (200, 201):
-                continue
-            data = r.json()
-            sts = data.get('stories') if isinstance(data, dict) else None
-            if not isinstance(sts, list):
-                continue
+            sts, _ = self._paged_list('/products/%s/stories' % pid, None, 'stories')
             for s in sts:
                 if not isinstance(s, dict):
                     continue
@@ -1013,9 +1014,13 @@ class ZentaoMCPServer(BaseMCPServer):
         if r.status_code not in (200, 201):
             return '查询失败: %s' % _err_text(r)
         s = r.json()
-        return '需求 #%s: %s\n状态: %s\n优先级: %s\n描述: %s' % (
-            sid, s.get('title', ''), s.get('status', ''),
-            s.get('pri', ''), str(s.get('spec', ''))[:200])
+        asg = _assignee_account(s) or '空'
+        opn = _openedby_account(s) or '空'
+        return ('需求 #%s: %s\n状态: %s | 优先级: %s | 模块: %s | 计划: %s\n'
+                '指派: %s | 创建: %s\n描述: %s') % (
+            sid, s.get('title', ''), s.get('status', ''), s.get('pri', ''),
+            s.get('module', ''), s.get('plan', ''),
+            asg, opn, str(s.get('spec', ''))[:200])
 
     @tool("create_story",
           "在禅道创建需求(PRD发布→禅道需求)。权限不足会返回友好提示不报错。例: create_story(product_id=1, title='品质案件催办', spec='需求详情', pri=3, module=104)",
@@ -1142,6 +1147,9 @@ class ZentaoMCPServer(BaseMCPServer):
           }, "required": ["story_id"]})
     def _t_update_story(self, args):
         sid = args.get('story_id', 0)
+        guard = self._assert_owner('story', sid)
+        if guard:
+            return guard
         payload = {}
         for k in ('title', 'spec', 'pri'):
             if args.get(k) is not None:
@@ -1160,6 +1168,9 @@ class ZentaoMCPServer(BaseMCPServer):
           }, "required": ["story_id"]})
     def _t_delete_story(self, args):
         sid = args.get('story_id', 0)
+        guard = self._assert_owner('story', sid)
+        if guard:
+            return guard
         return self._safe_write(
             'DELETE', '/stories/%s' % sid, None,
             '✅ 需求 #%s 已删除' % sid,
@@ -1237,11 +1248,11 @@ class ZentaoMCPServer(BaseMCPServer):
         t = r.json()
         asg = _assignee_account(t) or '空'
         opn = _openedby_account(t) or '空'
-        return ('任务 #%s: %s\n状态: %s | 类型: %s | 优先级: %s\n'
+        return ('任务 #%s: %s\n状态: %s | 类型: %s | 优先级: %s | 模块: %s\n'
                 '指派: %s | 创建: %s\n'
                 '工时: 预计=%s 消耗=%s 剩余=%s\n截止: %s\n需求: %s 执行: %s') % (
             tid, t.get('name', ''), t.get('status', ''), t.get('type', ''),
-            t.get('pri', ''), asg, opn,
+            t.get('pri', ''), t.get('module', ''), asg, opn,
             t.get('estimate', ''), t.get('consumed', ''), t.get('left', ''),
             t.get('deadline', ''), t.get('story', ''), t.get('execution', ''))
 
@@ -1554,11 +1565,11 @@ class ZentaoMCPServer(BaseMCPServer):
         b = r.json()
         asg = _assignee_account(b) or '空'
         opn = _openedby_account(b) or '空'
-        return ('Bug #%s: %s\n状态: %s | 严重度: %s | 优先级: %s | 解决方案: %s\n'
+        return ('Bug #%s: %s\n状态: %s | 严重度: %s | 优先级: %s | 解决方案: %s | 模块: %s\n'
                 '指派: %s | 创建: %s | 影响版本: %s | 解决版本: %s\n'
                 '关联需求: %s | 类型: %s\n描述: %s') % (
             bid, b.get('title', ''), b.get('status', ''),
-            b.get('severity', ''), b.get('pri', ''), b.get('resolution', ''),
+            b.get('severity', ''), b.get('pri', ''), b.get('resolution', ''), b.get('module', ''),
             asg, opn, b.get('openedBuild', ''), b.get('resolvedBuild', ''),
             b.get('story', ''),
             b.get('type', ''), str(b.get('steps', ''))[:200])
@@ -1609,6 +1620,9 @@ class ZentaoMCPServer(BaseMCPServer):
           }, "required": ["bug_id"]})
     def _t_update_bug(self, args):
         bid = args.get('bug_id', 0)
+        guard = self._assert_owner('bug', bid)
+        if guard:
+            return guard
         payload = {}
         for k in ('title', 'severity', 'pri', 'openedBuild'):
             if args.get(k) is not None:
@@ -1627,6 +1641,9 @@ class ZentaoMCPServer(BaseMCPServer):
           }, "required": ["bug_id"]})
     def _t_delete_bug(self, args):
         bid = args.get('bug_id', 0)
+        guard = self._assert_owner('bug', bid)
+        if guard:
+            return guard
         return self._safe_write(
             'DELETE', '/bugs/%s' % bid, None,
             '✅ Bug #%s 已删除' % bid,
@@ -1744,13 +1761,16 @@ class ZentaoMCPServer(BaseMCPServer):
         if serr:
             return serr
 
-        # 过滤掉终态 (除非显式要看历史)
+        # 过滤掉终态 (除非显式要看历史)。三域对称: 都用正向白名单,
+        # 对齐 task 的语义 (完成即消失)。旧版 bug 把 resolved 算活动、
+        # story 把 draft 算活动 → 计数虚高, 与"我手头还要干的活"直觉不符。
         LIVE_TASK = {'wait', 'doing', 'pause'}
-        LIVE_BUG = {'active', 'resolved'}
+        LIVE_BUG = {'active'}                       # resolved=已解决待验证, 像任务 done, 剔除
+        LIVE_STORY = {'active', 'reviewing', 'changing'}  # 草稿/终态剔除
         if not include_closed:
             tasks = [t for t in tasks if t.get('status') in LIVE_TASK]
             bugs = [b for b in bugs if b.get('status') in LIVE_BUG]
-            stories = [s for s in stories if s.get('status') not in ('closed',)]
+            stories = [s for s in stories if s.get('status') in LIVE_STORY]
 
         lines = ['📋 我(%s)的禅道工作台 — 任务 %d · 需求 %d · Bug %d' % (
             MY_ACCOUNT, len(tasks), len(stories), len(bugs))]
@@ -1877,6 +1897,105 @@ class ZentaoMCPServer(BaseMCPServer):
         lines.append('\n💡 说"看Bug#XXXX"或"Bug解决了"')
         return '\n'.join(lines)
 
+    @tool("team_tasks_summary",
+          "团队任务聚合(跨执行全量, 不漏)。复用全量遍历, 一个工具覆盖三场景。"
+          "mode: team=按人聚合(doing/wait/done计数+工时, 站会用); "
+          "overdue=超期清单(deadline<今天且未完, 风险排查); "
+          "by_execution=按执行完成率(PMO看进度)。例: team_tasks_summary() / team_tasks_summary(mode='overdue')",
+          {"type": "object", "properties": {
+              "mode": {"type": "string", "enum": ["team", "overdue", "by_execution"],
+                       "description": "聚合模式, 默认 team"},
+          }, "required": []})
+    def _t_team_tasks_summary(self, args):
+        gate = self._gate()
+        if gate:
+            return gate
+        mode = args.get('mode') or 'team'
+        if mode not in ('team', 'overdue', 'by_execution'):
+            return '⚠️ mode 只支持 team / overdue / by_execution。'
+        all_t, err = self._collect_all_tasks()
+        if err:
+            return err
+        if not all_t:
+            return '没有查到任何任务(执行列表为空)。'
+        if mode == 'overdue':
+            return self._fmt_overdue(all_t)
+        if mode == 'by_execution':
+            return self._fmt_by_execution(all_t)
+        return self._fmt_team(all_t)
+
+    def _fmt_team(self, tasks):
+        """按人聚合: 每人的 doing/wait/done 计数 + 消耗/预计工时。"""
+        from collections import defaultdict
+        by_acc = defaultdict(lambda: {'doing': 0, 'wait': 0, 'done': 0, 'consumed': 0.0, 'estimate': 0.0})
+        for t in tasks:
+            acc = _assignee_account(t) or '(未指派)'
+            st = t.get('status', '')
+            rec = by_acc[acc]
+            if st == 'doing':
+                rec['doing'] += 1
+            elif st in ('wait', 'pause'):
+                rec['wait'] += 1
+            elif st in ('done', 'closed'):
+                rec['done'] += 1
+            for k in ('consumed', 'estimate'):
+                try:
+                    rec[k] += float(t.get(k) or 0)
+                except (TypeError, ValueError):
+                    pass
+        rows = sorted(by_acc.items(), key=lambda kv: -(kv[1]['doing'] + kv[1]['wait']))
+        lines = ['👥 团队任务聚合 (共 %d 个任务, %d 人)' % (len(tasks), len(by_acc))]
+        lines.append('\n  账号          进行 未开始 已完成  消耗h/预计h')
+        for acc, r in rows:
+            lines.append('  %-12s  %4d  %4d   %4d   %5.1f/%5.1f' % (
+                acc[:12], r['doing'], r['wait'], r['done'], r['consumed'], r['estimate']))
+        lines.append('\n💡 说 "team_tasks_summary mode=overdue" 看超期, 或 mode=by_execution 看执行进度')
+        return '\n'.join(lines)
+
+    def _fmt_overdue(self, tasks):
+        """超期清单: deadline < 今天 且 未到终态。"""
+        from datetime import datetime
+        today = datetime.now().strftime('%Y-%m-%d')
+        overdue = [t for t in tasks
+                   if t.get('status') not in ('done', 'closed', 'cancel', 'cancelled')
+                   and (t.get('deadline') or '')[:10] < today
+                   and (t.get('deadline') or '')[:10]]
+        if not overdue:
+            return '✅ 没有超期任务 (deadline<%s 且未完的共 0 个)。' % today
+        overdue.sort(key=lambda t: (t.get('deadline') or '')[:10])
+        lines = ['🔴 超期任务清单 (deadline<%s 且未完, 共 %d 个):' % (today, len(overdue))]
+        for t in overdue:
+            lines.append('  [#%s] %s  截止=%s  状态=%s  指派=%s  执行=%s' % (
+                t.get('id'), str(t.get('name', ''))[:30], (t.get('deadline') or '')[:10],
+                t.get('status'), _assignee_account(t) or '空', t.get('execution_name', '')))
+        lines.append('\n💡 说 "team_tasks_summary mode=team" 看每人手头活')
+        return '\n'.join(lines)
+
+    def _fmt_by_execution(self, tasks):
+        """按执行聚合: 完成率 + 工时。"""
+        from collections import defaultdict
+        by_exec = defaultdict(lambda: {'total': 0, 'done': 0, 'consumed': 0.0, 'estimate': 0.0})
+        for t in tasks:
+            name = t.get('execution_name') or str(t.get('execution', '?'))
+            rec = by_exec[name]
+            rec['total'] += 1
+            if t.get('status') in ('done', 'closed'):
+                rec['done'] += 1
+            for k in ('consumed', 'estimate'):
+                try:
+                    rec[k] += float(t.get(k) or 0)
+                except (TypeError, ValueError):
+                    pass
+        rows = sorted(by_exec.items(), key=lambda kv: -kv[1]['total'])
+        lines = ['📊 执行完成率 (共 %d 个执行, %d 个任务)' % (len(by_exec), len(tasks))]
+        lines.append('\n  执行                完成/总数  完成率  消耗h/预计h')
+        for name, r in rows:
+            rate = (r['done'] * 100 // r['total']) if r['total'] else 0
+            lines.append('  %-18s  %4d/%4d   %3d%%   %6.1f/%6.1f' % (
+                name[:18], r['done'], r['total'], rate, r['consumed'], r['estimate']))
+        lines.append('\n💡 说 "team_tasks_summary mode=overdue" 看风险任务')
+        return '\n'.join(lines)
+
     # ── 用户 User (2) ── (指派任务/Bug 必须知道有哪些账号) ─────────────
 
     @tool("list_users",

package/templates/root/AGENTS.md

@@ -76,8 +76,8 @@ Examples:
 
 PMs on this team do not know git. ALL git operations are invisible:
 - After any publish/save action (/wl-prd publish, /wl-task create/finish,
-  /wl-report save), run: `python .qoder/scripts/task/team_sync.py push`
-- To get teammates' latest work: `python .qoder/scripts/task/team_sync.py pull`
+  /wl-report save), run: `python .qoder/scripts/domain/task/team_sync.py push`
+- To get teammates' latest work: `python .qoder/scripts/domain/task/team_sync.py pull`
 - If team_sync prints SYNC_CONFLICT, YOU (the AI) resolve the conflict
   yourself (it tells you the commands). NEVER ask the user to run git.
 - When the user says 同步/保存/提交 in natural language -> team_sync, not raw git.
@@ -135,7 +135,7 @@ app/mobile/h5/移动端 -> Carmg-H5
 
 3 projects: Carmg-H5(1378 files), fywl-ics(8973 files, 3903 APIs), fywl-ui(3270 files)
 Search: /wl-search <keyword> returns compact results (~200 bytes)
-Weekly sync: python .qoder/scripts/task/git_sync.py
+Weekly sync: python .qoder/scripts/domain/task/git_sync.py
 
 ### MCP Servers (QoderWork / Qoder IDE)
 注册在 `~/.qoderwork/mcp.json`，setup.py 一键配齐：
@@ -144,7 +144,7 @@ Weekly sync: python .qoder/scripts/task/git_sync.py
 - `qoder-mysql` (stdio) — 只读查真实数据库结构/数据。自动拉起。
 - `lanhu` (STDIO) — 蓝湖设计稿直读，设计师发链接 AI 提取颜色/尺寸/字体/切图。
   **STDIO 模式：开 QoderWork 自动起、关自动停**（QoderWork 原生进程管理，无需手动 start）。
-  cookie 按角色隔离（UI 能改稿/PM 只读）：wrapper 读当前 `.developer` → 该角色的 `workspace/members/{dev}/.secrets/lanhu.env`（gitignored）。换角色改 `.developer` + 配该角色 cookie → 重启 QoderWork。首次配置跑 `python .qoder/scripts/setup/setup_lanhu.py`。
+  cookie 按角色隔离（UI 能改稿/PM 只读）：wrapper 读当前 `.developer` → 该角色的 `workspace/members/{dev}/.secrets/lanhu.env`（gitignored）。换角色改 `.developer` + 配该角色 cookie → 重启 QoderWork。首次配置跑 `python .qoder/scripts/deployment/setup/setup_lanhu.py`。
 
 ### Style Index (Prototype Reference)
 UI patterns from Vue files: Tables(718), Forms(301), Detail(129), Dashboard(90)
@@ -153,10 +153,10 @@ Form components: Input(2262), Select(1049), ApiSelect(725), DatePicker(265)
 Field map: 2383 entries
 
 Style search:
-  python .qoder/scripts/kg/search_index.py --style table/form/modal/dashboard
-  python .qoder/scripts/kg/search_index.py --field <field_name>
-  python .qoder/scripts/kg/search_index.py --components
-  python .qoder/scripts/kg/search_index.py --vben    # Vben Admin CSS variables
+  python .qoder/scripts/domain/kg/search/search_index.py --style table/form/modal/dashboard
+  python .qoder/scripts/domain/kg/search/search_index.py --field <field_name>
+  python .qoder/scripts/domain/kg/search/search_index.py --components
+  python .qoder/scripts/domain/kg/search/search_index.py --vben    # Vben Admin CSS variables
 
 Prototype templates:
   .qoder/templates/prototype-web.html   # Web管理端 (Vben Admin + Ant Design)
@@ -191,7 +191,7 @@ Each product loads rules from a different carrier — keep them in sync:
 | QoderWork 桌面 Agent | 安装 .qoder/skills/ 下的技能 | 自然语言 -> skills |
 
 > 本流水线聚焦 Qoder 全系列，4 种载体功能等价。知识图谱 17 个能力（影响分析/
-> 覆盖矩阵/功能画像/业务流程/多跳遍历…）通过统一 CLI `python .qoder/scripts/kg/kg.py`
+> 覆盖矩阵/功能画像/业务流程/多跳遍历…）通过统一 CLI `python .qoder/scripts/domain/kg/kg.py`
 > 全系列触达；QoderWork 环境也可直接调 MCP 工具。
 
 ## QoderWork Integration: Optional Enhancement Only (Progressive Enhancement)
@@ -222,11 +222,11 @@ Each product loads rules from a different carrier — keep them in sync:
   macOS/Linux -> scripts/setup_weekly_cron.sh. Only ONE machine per team
   needs this; everyone else gets the graph via /wl-init's auto pull.
 - Environment problems of any kind -> run:
-  `python .qoder/scripts/setup/init_doctor.py` (add --fix to auto-repair).
+  `python .qoder/scripts/deployment/setup/init_doctor.py` (add --fix to auto-repair).
 
 ## Fast Path: one call to get all context
 
-`python .qoder/scripts/kg/context_pack.py <业务词> --platform <web|app>` returns
+`python .qoder/scripts/domain/kg/search/context_pack.py <业务词> --platform <web|app>` returns
 code files + page examples + field specs + PRDs + APIs + style/icon pointers
 in ONE call. Use it FIRST; fall back to search_index.py for drill-down.
 
@@ -237,7 +237,7 @@ Web = Ant Design inline SVG, APP = Vant font icons. Emoji in a prototype = FAIL.
 
 ## Quality Gate (EVA)
 
-Before publishing any PRD: `python .qoder/scripts/report/eval_prd.py <prd> [prototype]`
+Before publishing any PRD: `python .qoder/scripts/validation/metrics/eval_prd.py <prd> [prototype]`
 must PASS (>=80%). Metrics definition: data/docs/constitution/eva-metrics.md
 
 ## Workflow Usability (可用性)