@hupan56/wlkj 3.1.7 → 3.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hupan56/wlkj",
-  "version": "3.1.7",
+  "version": "3.1.9",
   "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
   "bin": {
     "wlkj": "bin/cli.js"

package/templates/qoder/scripts/capability/adapters/mcp.py

@@ -270,9 +270,13 @@ class McpMemoryProvider:
             import hashlib
             import json
             import time as _time
-            from foundation.protocol.duckdb_conn import get_db, init_schema
+            # ⚠ 不能 import init_schema! duckdb_conn 故意不导出它 (领域 DDL 留在各域)。
+            # 旧版 from ...duckdb_conn import init_schema → ImportError → 被下面 except 吞掉
+            # → INSERT 永不执行 → remember() 静默丢全部写入。
+            # learning_events 表已由 self.available 的 CREATE TABLE IF NOT EXISTS 保证存在,
+            # 这里直接 INSERT 即可。
+            from foundation.protocol.duckdb_conn import get_db
             con = get_db()
-            init_schema(con)
             eid = hashlib.md5(("%s:%s:%s" % (key, content, _time.time())).encode()).hexdigest()[:16]
             ts = _time.strftime("%Y-%m-%dT%H:%M:%S")
             data = json.dumps({"content": content}, ensure_ascii=False)

package/templates/qoder/scripts/capability/memory_chain.py

@@ -33,7 +33,9 @@ def build_memory_chain(host: str) -> ProviderChain:
     from .adapters.cli import FileMemoryCap
 
     providers: list = [McpMemoryProvider()]
-    if host == "qoderwork":
+    # ⚠ host 名是 "qoder-work" (带连字符, 见 registry.py:40 detect_host 返回值)。
+    # 旧版写成 "qoderwork" (无连字符) → 永不匹配 → QwMemoryCap 在所有 QoderWork 机器上都不激活。
+    if host == "qoder-work":
         from .adapters.qw import QwMemoryCap
         providers.append(QwMemoryCap())
     providers.append(FileMemoryCap())

package/templates/qoder/scripts/domain/kg/kg_capabilities.py

@@ -158,7 +158,9 @@ def wiki_query(kw):
         return ("wiki-index.json 不存在。请手动构建(一次性):\n"
                 "  python .qoder/scripts/domain/kg/search/search_index.py wiki")
     try:
-        from repowiki import search_wiki
+        # v3.x: repowiki 在 domain/kg/server/ 子包下, 不能裸 from repowiki import
+        # (sys.path 没含 server/, 永远 ModuleNotFoundError → search_wiki 永远报"模块缺失")
+        from domain.kg.server.repowiki import search_wiki
         from foundation.integrations.terms import get_cn_map_with_auto
     except ImportError as e:
         return "Wiki 搜索模块缺失: %s" % str(e)

package/templates/qoder/scripts/domain/kg/search/context_pack.py

@@ -10,7 +10,7 @@ for _ in range(10):
         break
 if _cp not in _s.path: _s.path.insert(0, _cp)
 from bootstrap import setup; setup()
-from foundation.core.paths import get_repo_root
+from foundation.core.paths import get_repo_root
 
 """
 QODER Context Pack - 一次调用返回写 PRD/原型所需的全部上下文
@@ -48,7 +48,7 @@ except (AttributeError, TypeError, OSError, IOError):
 sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
 from foundation.integrations.terms import CN_MAP, BUSINESS_PATH_MAP, CN_TO_EN, get_platform_map, expand_chinese_query
 
-BASE = get_repo_root()
+BASE = get_repo_root()
 INDEX_DIR = os.path.join(BASE, 'data', 'index')
 PLATFORM_MAP = get_platform_map()
 MIN_FUZZY_LEN = 4
@@ -309,7 +309,7 @@ def _compute_and_print(query, platform, page_type):
     code_dir = os.path.join(BASE, 'data', 'code')
     wiki_results = []
     try:
-        from repowiki import search_wiki, build_wiki_index
+        from domain.kg.server.repowiki import search_wiki, build_wiki_index
         from foundation.integrations.terms import get_cn_map_with_auto
         wiki_idx_path = os.path.join(BUILD_CACHE_DIR, 'wiki-index.json')
         if not os.path.isfile(wiki_idx_path):

package/templates/qoder/scripts/domain/kg/search/prefetch.py

@@ -296,7 +296,7 @@ def _print_merged(query, platform, primary_cn, en_words, collected):
     code_dir = os.path.join(BASE, 'data', 'code')
     wiki_results = []
     try:
-        from repowiki import search_wiki, build_wiki_index
+        from domain.kg.server.repowiki import search_wiki, build_wiki_index
         wiki_idx_path = os.path.join(BUILD_CACHE_DIR, 'wiki-index.json')
         if not os.path.isfile(wiki_idx_path):
             build_wiki_index(code_dir, wiki_idx_path)

package/templates/qoder/scripts/domain/kg/search/search_index.py

@@ -768,7 +768,7 @@ def show_vben():
 def search_wiki_cli(query):
     """搜 Repo Wiki (Qoder IDE 生成的语义级模块文档)。"""
     try:
-        from repowiki import search_wiki, build_wiki_index
+        from domain.kg.server.repowiki import search_wiki, build_wiki_index
         from foundation.integrations.terms import get_cn_map_with_auto
     except ImportError:
         print('Wiki 搜索不可用 (common.repowiki 模块缺失)')

package/templates/qoder/scripts/domain/report/status_snapshot.py

@@ -141,16 +141,25 @@ def snapshot(repo=None):
     data["index_age_days"] = _index_freshness(meta)
 
     # 3. EVA 评估历史 (健康度趋势)
-    data["eval_history"] = _read_jsonl_tail(
-        os.path.join(qd, "learning", "eval-history.jsonl"), n=10)
+    # ⚠ 真实路径是 data/learning/eval-history.jsonl (旧版写 .qoder/learning/ 是历史 bug,
+    #   eval_prd.py/learn.py 早改了, 这里要对齐 EVAL_HISTORY_PATH, 否则 /wl-status 永远 null)。
+    try:
+        from foundation.core.paths import EVAL_HISTORY_PATH
+        eval_path = str(EVAL_HISTORY_PATH)
+    except Exception:
+        eval_path = os.path.join(repo, "data", "learning", "eval-history.jsonl")
+    data["eval_history"] = _read_jsonl_tail(eval_path, n=10)
 
-    # 4. 学习反馈
-    data["feedback_count"] = None
-    fb = os.path.join(qd, "learning", "feedback.jsonl")
-    if os.path.exists(fb):
+    # 4. 学习反馈 (扫所有成员的 journal/feedback.jsonl, learn.py 写这里)
+    data["feedback_count"] = 0
+    members_dir = os.path.join(repo, "workspace", "members")
+    if os.path.isdir(members_dir):
         try:
-            with open(fb, encoding="utf-8") as f:
-                data["feedback_count"] = sum(1 for _ in f)
+            for m in os.listdir(members_dir):
+                fb = os.path.join(members_dir, m, "journal", "feedback.jsonl")
+                if os.path.isfile(fb):
+                    with open(fb, encoding="utf-8") as f:
+                        data["feedback_count"] += sum(1 for _ in f)
         except Exception:
             pass
 
@@ -172,8 +181,8 @@ def snapshot(repo=None):
     # 8. 任务目录结构
     data["tasks_dir"] = _list_dir(os.path.join(qd, "workspace", "tasks"))
 
-    # 9. 学习模式
-    data["patterns"] = _list_dir(os.path.join(qd, "learning", "patterns"))
+    # 9. 学习模式 (data/learning/patterns/, 非 .qoder/learning/)
+    data["patterns"] = _list_dir(os.path.join(repo, "data", "learning", "patterns"))
 
     # 10. 成员目录 (团队规模)
     data["members"] = _list_dir(os.path.join(qd, "workspace", "members"))

package/templates/qoder/scripts/domain/requirement/archive_prd.py

@@ -10,7 +10,7 @@ for _ in range(10):
         break
 if _cp not in _s.path: _s.path.insert(0, _cp)
 from bootstrap import setup; setup()
-from foundation.core.paths import get_repo_root
+from foundation.core.paths import get_repo_root
 
 """
 archive_prd.py - PRD 按时间归档到个人工作区
@@ -45,44 +45,10 @@ except (AttributeError, TypeError, OSError, IOError):
     except Exception:
         pass
 
-# 让 common/ 可被 import（直接当脚本跑时）
-_THIS_DIR = os.path.dirname(os.path.abspath(__file__))
-_COMMON = os.path.join(_THIS_DIR, "foundation")
-if _COMMON not in sys.path:
-    sys.path.insert(0, _COMMON)
-
-try:
-    from paths import get_repo_root, get_developer, MEMBERS_DIR
-except ImportError:
-    # 极端兜底：直接算路径
-    def get_repo_root():
-        current = Path(_THIS_DIR).resolve()
-        for _ in range(10):
-            if (current / ".qoder").is_dir():
-                return current
-            parent = current.parent
-            if parent == current:
-                break
-            current = parent
-        return Path(_THIS_DIR).parent.parent
-
-    def get_developer(repo_root=None):
-        dev = (repo_root or get_repo_root()) / ".qoder" / ".developer"
-        if not dev.is_file():
-            return None
-        for enc in ("utf-8", "gbk"):
-            try:
-                for line in dev.read_text(encoding=enc).splitlines():
-                    line = line.strip()
-                    if "=" in line and line.split("=")[0].strip() == "name":
-                        return line.split("=", 1)[1].strip() or None
-                    if ":" in line and line.split(":")[0].strip() == "name":
-                        return line.split(":", 1)[1].strip() or None
-            except (OSError, IOError, UnicodeDecodeError):
-                continue
-        return None
-
-    MEMBERS_DIR = None  # 下面用 repo_root 拼
+# v3.x: 顶部 bootstrap 已 setup, 直接 import foundation.* (旧版重复尝试 from paths
+# + 手写兜底, 兜底会与 foundation.core.paths 静默漂移, 这里统一走真源)。
+from foundation.core.paths import get_repo_root as _grr, get_developer, MEMBERS_DIR
+get_repo_root = _grr  # 已在顶部 import, 这里显式重绑确保本模块可见
 
 
 # ============================================================

package/templates/qoder/scripts/foundation/integrations/zentao_client.py

@@ -60,15 +60,38 @@ class ZentaoClient:
 
     @classmethod
     def from_config(cls) -> Optional['ZentaoClient']:
-        """从 .qoder/config.yaml 的 zentao 段构造（CLI 用）。凭据不全返回 None。"""
+        """从 .qoder/config.yaml 的 zentao 段构造（CLI 用）。凭据不全返回 None。
+
+        v3.1.4 设计: url 团队共享(放 config.yaml), user/password 个人凭据(放
+        workspace/members/{dev}/.private/secrets/zentao.env, gitignored)。
+        所以这里 url 从 config 读, user/password 从 zentao.env 读 ——
+        与 mcp_launcher.launch_zentao() 完全对齐 (旧版从 config 读 user/password
+        → 永远 None, 因为 config 故意不放个人凭据)。
+        """
+        # ① url 从 config.yaml
+        url = ''
         try:
             from foundation.core.config import load_config_section, SECTIONS
             cfg = load_config_section(SECTIONS.ZENTAO)
+            url = (cfg.get('url') or '').strip()
         except Exception:
-            return None
-        url = (cfg.get('url') or '').strip()
-        user = (cfg.get('user') or '').strip()
-        pwd = (cfg.get('password') or '')
+            url = ''
+        # ② user/password 从当前开发者的 .private/secrets/zentao.env
+        user = pwd = ''
+        try:
+            from foundation.core.paths import get_secrets_dir, get_developer
+            dev = get_developer()
+            if dev:
+                env_file = os.path.join(get_secrets_dir(dev), 'zentao.env')
+                if os.path.isfile(env_file):
+                    for line in open(env_file, encoding='utf-8'):
+                        line = line.strip()
+                        if line.startswith('ZENTAO_USER='):
+                            user = line.split('=', 1)[1].strip().strip('"').strip("'")
+                        elif line.startswith('ZENTAO_PASSWORD='):
+                            pwd = line.split('=', 1)[1].strip().strip('"').strip("'")
+        except Exception:
+            pass
         if not url or not user or not pwd:
             return None
         return cls(url, user, pwd)

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

@@ -86,6 +86,23 @@ def _ensure_imports():
 from foundation.protocol.mcp_base import BaseMCPServer, tool
 
 
+def _require_kgdb():
+    """检查 kg.duckdb 是否存在。存在返回 None; 不存在返回友好提示字符串。
+
+    防止 get_db() 创建空库后查询报 CatalogException (49 台没预建图谱的机器)。
+    """
+    try:
+        from foundation.core.paths import DATA_INDEX_DIR
+        db_path = DATA_INDEX_DIR / 'kg.duckdb'
+        if not db_path.is_file():
+            return ("知识图谱未构建 (kg.duckdb 不存在)。请管理员跑:\n"
+                    "  python .qoder/scripts/orchestration/wlkj.py kg-build\n"
+                    "或非管理员: npx @hupan56/wlkj update (会 git pull 拉团队已构建的 kg.duckdb)")
+    except Exception:
+        pass
+    return None
+
+
 class KnowledgeGraphMCPServer(BaseMCPServer):
     """知识图谱 MCP Server。
 
@@ -185,6 +202,11 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
         q = (args.get("module") or '').strip()
         if not q:
             return "请提供模块名。可选: assets/cost/hr/maintenance/operation/qualityAndSafety/veh/settings/dashboard/flow/systems/monitor/quasafe"
+        # ⚠ 先检查 kg.duckdb 存在! get_db() 会创建空库 → 查询报 CatalogException
+        # (49 台没预建图谱的机器会看到原始异常, 而非友好提示)。
+        _hint = _require_kgdb()
+        if _hint:
+            return _hint
         con = get_db()
         try:
             return workflow_query(con, q)
@@ -209,6 +231,9 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
         except (TypeError, ValueError):
             depth = 3
         depth = max(1, min(5, depth))
+        _hint = _require_kgdb()
+        if _hint:
+            return _hint
         con = get_db()
         try:
             return hop_query(con, sym, depth, multi_hop_fn=multi_hop)
@@ -236,6 +261,9 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
     def _t_search_field(self, args):
         from domain.kg.storage.kg_duckdb import get_db
         field = (args.get("field") or '').strip()
+        _hint = _require_kgdb()
+        if _hint:
+            return _hint
         con = get_db()
         try:
             rows = con.execute(
@@ -260,6 +288,9 @@ class KnowledgeGraphMCPServer(BaseMCPServer):
     def _t_list_modules(self, args):
         from domain.kg.storage.kg_duckdb import get_db
         platform = args.get("platform", "")
+        _hint = _require_kgdb()
+        if _hint:
+            return _hint
         con = get_db()
         try:
             if platform == 'web':

package/templates/qoder/skills/design-import/figma-workflow.md

@@ -1,81 +1,81 @@
-# Figma 协作指南（设计师专用）
-
-> 工作流出的 HTML 原型 → Figma 精修 → 录回 spec.json 闭环
-
-## 为什么这条路可行
-
-工作流用 `fill_prototype.py` 出的 HTML 原型有以下特征，**非常适合 html.to.design 插件转换**：
-
-- CSS 用标准 CSS 变量（`:root { --primary: ... }`），插件能正确解析成 Figma Variables
-- 布局用 Flexbox/Grid，转换后图层结构清晰
-- 颜色是 Vben 真实 HSL token（不是 #1890ff），导入后直接是正确配色
-- 图标是内联 SVG（Ant Design），导入后是可编辑矢量
-
-## 完整流程（4 步）
-
-### Step 1: PM 出原型（工作流侧）
-
-PM 在 QoderWork 说"出个 XX 的原型"，工作流输出：
-
-```
-workspace/members/{pm}/drafts/prototype-{需求名}-web.html
-```
-
-设计师从 PM 那拿到这个 HTML 文件。
-
-### Step 2: 导入 Figma（设计师侧）
-
-1. 打开 Figma，新建一个 Frame
-2. 菜单：**Plugins → html.to.design**（by ‹div›RIOTS）
-   - 没装的话：Figma Community 搜 "html.to.design" 安装（免费）
-3. 插件面板里选 **File** 标签（不是 URL 标签）
-4. 把 HTML 文件**拖进拖放区**（或点选文件）
-5. 点 **Import**，等几秒
-
-**结果**：HTML 变成完全可编辑的 Figma 图层——每个元素是独立的 Frame/Text/Rectangle，颜色是正确的 Vben 配色。
-
-### Step 3: 设计师精修（Figma 侧）
-
-设计师在 Figma 里做只有人能做的精修：
-
-- 调间距/对齐（AI 的间距可能不精确）
-- 优化交互细节（hover 态、动画、过渡）
-- 换更合适的图标/插图
-- 调整信息层级和视觉重点
-- 加设计师特有的"手感"
-
-**注意**：颜色 token（`--primary` 等）尽量别改——它们是系统统一的，改了前端实现时会对不上。
-
-### Step 4: 录回工作流（闭环）
-
-设计师精修完，在 QoderWork 里说：
-
-> "录入设计稿"
-
-工作流把 Figma 最终稿的关键决策（布局/配色/组件）录成 `data/style/{需求名}-design-spec.json`。
-
-从此：
-- 下次同需求出原型，工作流**优先用这份 spec**
-- 前端拿到的 HTML 原型**匹配设计师的 Figma 终稿**
-- 设计师的劳动成果**沉淀进知识图谱**，不浪费
-
-## 常见问题
-
-**Q: 导入后图层太碎怎么办？**
-A: html.to.design 会按 HTML DOM 结构生成图层。fill_prototype 出的 HTML 结构已经很干净（侧边栏/搜索栏/表格各自独立），不会太碎。如果某个区域图层太多，选中后用 Figma 的 "Flatten" 合并。
-
-**Q: 表格数据是假的怎么办？**
-A: 对的，原型里的表格行是示例数据（"XX示例1"）。这是故意的——原型验证的是布局和交互，不是数据。真实数据前端会从 API 取。
-
-**Q: 图标导入后变位图了？**
-A: 不会。工作流用的图标是内联 SVG（不是图片标签），html.to.design 会保留为矢量。如果个别图标显示异常，从 `data/index/icon-reference.json` 找原始 SVG 手动替换。
-
-**Q: APP 端原型也能导入吗？**
-A: 能。`prototype-{需求名}-app.html` 同样是标准 HTML，导入方式一样。APP 原型用的是 Vant 风格（移动端组件库）。
-
-## html.to.design 插件安装
-
-- Figma Community 搜索：`html.to.design`
-- 或直接访问：https://www.figma.com/community/plugin/1159123024924461424
-- 免费版每次导入有限制，团队版无限
-- 也有 Chrome 扩展版（适合截取在线页面）
+# Figma 协作指南（设计师专用）
+
+> 工作流出的 HTML 原型 → Figma 精修 → 录回 spec.json 闭环
+
+## 为什么这条路可行
+
+工作流用 `fill_prototype.py` 出的 HTML 原型有以下特征，**非常适合 html.to.design 插件转换**：
+
+- CSS 用标准 CSS 变量（`:root { --primary: ... }`），插件能正确解析成 Figma Variables
+- 布局用 Flexbox/Grid，转换后图层结构清晰
+- 颜色是 Vben 真实 HSL token（不是 #1890ff），导入后直接是正确配色
+- 图标是内联 SVG（Ant Design），导入后是可编辑矢量
+
+## 完整流程（4 步）
+
+### Step 1: PM 出原型（工作流侧）
+
+PM 在 QoderWork 说"出个 XX 的原型"，工作流输出：
+
+```
+workspace/members/{pm}/drafts/prototype-{需求名}-web.html
+```
+
+设计师从 PM 那拿到这个 HTML 文件。
+
+### Step 2: 导入 Figma（设计师侧）
+
+1. 打开 Figma，新建一个 Frame
+2. 菜单：**Plugins → html.to.design**（by ‹div›RIOTS）
+   - 没装的话：Figma Community 搜 "html.to.design" 安装（免费）
+3. 插件面板里选 **File** 标签（不是 URL 标签）
+4. 把 HTML 文件**拖进拖放区**（或点选文件）
+5. 点 **Import**，等几秒
+
+**结果**：HTML 变成完全可编辑的 Figma 图层——每个元素是独立的 Frame/Text/Rectangle，颜色是正确的 Vben 配色。
+
+### Step 3: 设计师精修（Figma 侧）
+
+设计师在 Figma 里做只有人能做的精修：
+
+- 调间距/对齐（AI 的间距可能不精确）
+- 优化交互细节（hover 态、动画、过渡）
+- 换更合适的图标/插图
+- 调整信息层级和视觉重点
+- 加设计师特有的"手感"
+
+**注意**：颜色 token（`--primary` 等）尽量别改——它们是系统统一的，改了前端实现时会对不上。
+
+### Step 4: 录回工作流（闭环）
+
+设计师精修完，在 QoderWork 里说：
+
+> "录入设计稿"
+
+工作流把 Figma 最终稿的关键决策（布局/配色/组件）录成 `data/style/{需求名}-design-spec.json`。
+
+从此：
+- 下次同需求出原型，工作流**优先用这份 spec**
+- 前端拿到的 HTML 原型**匹配设计师的 Figma 终稿**
+- 设计师的劳动成果**沉淀进知识图谱**，不浪费
+
+## 常见问题
+
+**Q: 导入后图层太碎怎么办？**
+A: html.to.design 会按 HTML DOM 结构生成图层。fill_prototype 出的 HTML 结构已经很干净（侧边栏/搜索栏/表格各自独立），不会太碎。如果某个区域图层太多，选中后用 Figma 的 "Flatten" 合并。
+
+**Q: 表格数据是假的怎么办？**
+A: 对的，原型里的表格行是示例数据（"XX示例1"）。这是故意的——原型验证的是布局和交互，不是数据。真实数据前端会从 API 取。
+
+**Q: 图标导入后变位图了？**
+A: 不会。工作流用的图标是内联 SVG（不是图片标签），html.to.design 会保留为矢量。如果个别图标显示异常，从 `data/index/ref-icon.json` 找原始 SVG 手动替换。
+
+**Q: APP 端原型也能导入吗？**
+A: 能。`prototype-{需求名}-app.html` 同样是标准 HTML，导入方式一样。APP 原型用的是 Vant 风格（移动端组件库）。
+
+## html.to.design 插件安装
+
+- Figma Community 搜索：`html.to.design`
+- 或直接访问：https://www.figma.com/community/plugin/1159123024924461424
+- 免费版每次导入有限制，团队版无限
+- 也有 Chrome 扩展版（适合截取在线页面）

package/templates/qoder/skills/prototype-generator/SKILL.md

@@ -32,21 +32,21 @@ Generate production-ready HTML prototypes that match the project's actual UI sty
 - 若 `.qoder/.current-task` 存在，原型命名带上任务关键词
 - 平台（Web/APP/Both）必须明确；如未指定，先问用户（见 prd-generator Step 0）
 
-## ⚠️ 前置门: 用户是否选了"画原型"？（v3.1 新增）
-
-本 skill **只在用户明确选择"画原型"后才进入**。
-
-- 如果上游 `/wl-prd-full` 或 `/wl-prd` 在「批量确认」环节已决定**不画**（PRD 第 1 行
-  `@contract` 头标记 `prototype: none`），**立即退出本 skill**，不生成任何 HTML。
-- 如果上游没有 contract 头（独立调用本 skill），**先问用户**：
-  `这个需求要画原型吗？(画 / 不画)`
-  用户答"不画"→ 退出；用户答"画"→ 继续。
-- **绝不擅自决定画/不画**。决策权在用户，本 skill 只执行。
-
-> 这条门治"AI 默默画了个塑料骨架"的反模式——比如"出交车点检固定为总部全局规则"
-> 这种纯规则下发型需求，AI 不该自己往里塞一个配置页原型。
-
----
+## ⚠️ 前置门: 用户是否选了"画原型"？（v3.1 新增）
+
+本 skill **只在用户明确选择"画原型"后才进入**。
+
+- 如果上游 `/wl-prd-full` 或 `/wl-prd` 在「批量确认」环节已决定**不画**（PRD 第 1 行
+  `@contract` 头标记 `prototype: none`），**立即退出本 skill**，不生成任何 HTML。
+- 如果上游没有 contract 头（独立调用本 skill），**先问用户**：
+  `这个需求要画原型吗？(画 / 不画)`
+  用户答"不画"→ 退出；用户答"画"→ 继续。
+- **绝不擅自决定画/不画**。决策权在用户，本 skill 只执行。
+
+> 这条门治"AI 默默画了个塑料骨架"的反模式——比如"出交车点检固定为总部全局规则"
+> 这种纯规则下发型需求，AI 不该自己往里塞一个配置页原型。
+
+---
 ## Step 0: Know the Platform
 
 The platform MUST already be decided (asked by /wl-prd-full Step 0).
@@ -229,12 +229,12 @@ Key design tokens already in the templates (do not override):
 
 ## ⚠️ Icons: NEVER emoji, ALWAYS the project's real icon system
 
-Source of truth: **data/index/icon-reference.json** (real usage counts +
+Source of truth: **data/index/ref-icon.json** (real usage counts +
 ready-to-paste SVGs extracted from the actual projects).
 
-- **Web (fywl-ui)**: Ant Design icons. Inline the SVG from icon-reference.json:
+- **Web (fywl-ui)**: Ant Design icons. Inline the SVG from ref-icon.json:
   ```html
-  <span class="anticon">{svg from icon-reference.json web.svg.outlined[...]}</span>
+  <span class="anticon">{svg from ref-icon.json web.svg.outlined[...]}</span>
   <style>.anticon svg{width:1em;height:1em;fill:currentColor}</style>
   ```
   Most-used in the real app: Download(303x), Plus(171x), Delete, Search, Edit...
@@ -260,31 +260,31 @@ ready-to-paste SVGs extracted from the actual projects).
 4. ICS 的菜单来自后端接口(`access_mode: backend`),静态代码里抓不到完整菜单树,
    所以菜单层级**必须由需求/PRD 提供**,不要去代码里找。
 
-## 🔒 Step 3.5: 来源锚定 + UTF-8（硬门 #3，eval A2 检查）
-
-### 来源锚定（必做）
-
-生成的 HTML 必须在 `<head>` 里写一行注释，标注样式来源的真实文件：
-
-```html
-<!-- @prototype-source: fywl-ui/apps/ics/src/views/xxx/index.vue, fywl-ui/apps/ics/src/api/xxx.ts -->
-<meta name="x-source-pages" content="fywl-ui/.../index.vue">
-```
-
-- 来源文件**必须来自 Step 2 读过的真实 Vue/TS 文件**（prefetch 返回的 page_examples）
-- 写不出具体文件名 = 你没做 Step 2 = 违规
-- eval A2 会检查：HTML 含 `@prototype-source:` 或 `x-source-pages` → 通过；否则 A2 扣 5 分
-
-### UTF-8 强制（治编码乱码）
-
-生成的 HTML **必须用 UTF-8 写入**，否则中文 `<title>`/注释会变成 `鍑轰氦杞?` 乱码。
-
-- Write 工具调用时，内容里的中文必须是原始 UTF-8（不要从 GBK 源复制）
-- 如果用 Python 写文件：`open(path, 'w', encoding='utf-8')`
-- **绝不要从 bash 输出里复制中文再粘贴**（bash 在 Windows 上可能转 GBK）→ 优先让
-  `fill_prototype` 脚本直接出文件，AI 只 Edit 占位符
-
----
+## 🔒 Step 3.5: 来源锚定 + UTF-8（硬门 #3，eval A2 检查）
+
+### 来源锚定（必做）
+
+生成的 HTML 必须在 `<head>` 里写一行注释，标注样式来源的真实文件：
+
+```html
+<!-- @prototype-source: fywl-ui/apps/ics/src/views/xxx/index.vue, fywl-ui/apps/ics/src/api/xxx.ts -->
+<meta name="x-source-pages" content="fywl-ui/.../index.vue">
+```
+
+- 来源文件**必须来自 Step 2 读过的真实 Vue/TS 文件**（prefetch 返回的 page_examples）
+- 写不出具体文件名 = 你没做 Step 2 = 违规
+- eval A2 会检查：HTML 含 `@prototype-source:` 或 `x-source-pages` → 通过；否则 A2 扣 5 分
+
+### UTF-8 强制（治编码乱码）
+
+生成的 HTML **必须用 UTF-8 写入**，否则中文 `<title>`/注释会变成 `鍑轰氦杞?` 乱码。
+
+- Write 工具调用时，内容里的中文必须是原始 UTF-8（不要从 GBK 源复制）
+- 如果用 Python 写文件：`open(path, 'w', encoding='utf-8')`
+- **绝不要从 bash 输出里复制中文再粘贴**（bash 在 Windows 上可能转 GBK）→ 优先让
+  `fill_prototype` 脚本直接出文件，AI 只 Edit 占位符
+
+---
 ## Step 4: Highlight Changes + Interactivity
 
 - Mark NEW/CHANGED elements with the template's `highlight-new` class

package/templates/qoder/skills/wl-commit/SKILL.md

@@ -37,7 +37,19 @@ git status && git diff HEAD --stat
 
 ### Step 2: 质量门禁（提交前自检）
 
-逐项检查，任何一项不过都暂停问用户：
+**2a. 程序级强制门禁（syncgate）—— 先 git add 再跑**
+```bash
+# 1. 精确 add (不用 git add .)
+git add <相关文件>
+# 2. 对暂存文件跑零信任门禁 (身份/作者/秘密扫描/REQ-ID)
+python -c "import sys; sys.path.insert(0, r'$R/.qoder/scripts'); from domain.task.syncgate import run_gates; from foundation.core.paths import get_developer, get_repo_root; import subprocess; staged=subprocess.check_output(['git','diff','--cached','--name-only'],cwd=r'$R',text=True).split(); ok,reason=run_gates(staged, get_developer(), str(get_repo_root())); print('GATE_PASS' if ok else ('GATE_FAIL: '+reason)); sys.exit(0 if ok else 2)"
+```
+- `GATE_PASS` → 继续 2b
+- `GATE_FAIL: <原因>` → 停下，把原因告诉用户（如"检出疑似密钥 .env"），问修复还是强制。默认修复。
+  （这与 team_sync.py push 走的是同一道 syncgate，源码提交也不绕过零信任门禁。）
+
+**2b. 人工自检（grep 类）**
+逐项检查：
 - [ ] 无 TODO / FIXME 残留（grep 一下）
 - [ ] 金额字段用了 BigDecimal（不出现 double/float 存钱）
 - [ ] 命名/风格跟周围代码一致
@@ -60,8 +72,8 @@ type 选 feat / fix / refactor / docs / test / chore。
 **用户没明确说"提交/确认"之前，不要真的 commit。**
 
 ### Step 5: 提交 + 推送
+（文件已在 Step 2a git add 过，门禁已过）
 ```bash
-git add <相关文件>            # 精确 add，不用 git add .
 git commit -m "<确认后的信息>"
 git pull --rebase             # 先拉远端
 git push

package/templates/root/AGENTS.md

@@ -1,275 +1,275 @@
-# QODER Pipeline
-
-## 🏗️ 架构: 引擎与数据分离 (Trellis 化)
-
-`.qoder/` 一分为二 (v2.8.0+):
-
-| 类别 | 内容 | 来源 | 进团队 git? |
-|------|------|------|------------|
-| **引擎代码** | `.qoder/scripts/` `skills/` `commands/` `agents/` `contracts/` `hooks/` `templates/` `rules/` | `npx @hupan56/wlkj init/update` 生成 | ❌ gitignore |
-| **团队数据** | `.qoder/config.yaml` `config.toml` `settings.json` `learning/` + `data/` (kg.duckdb/索引) + `workspace/` (PRD/任务) | git 跟踪, 团队共享 | ✅ |
-
-- 引擎代码**只由 npm 包生成**, 不再进团队 git → 彻底消除"引擎更新污染团队 git"和"新机 init 产生 unrelated histories"。
-- Qoder 全系列仍读 `.qoder/` (路径不变), 只是引擎来源从 git 变成 npm 生成。
-- 老团队升级 (管理员跑一次): `npx @hupan56/wlkj migrate`, 然后团队成员各自 `npx @hupan56/wlkj update`。
-
----
-
-## ⚠️ CRITICAL RULE #1: ALWAYS ASK PLATFORM FIRST
-
-**When user asks for PRD or prototype, you MUST ask this question FIRST:**
-
-```
-这个需求是针对哪个平台？
-
-1. **Web 管理端** (fywl-ui) - Ant Design Vue + VxeGrid 风格
-2. **APP 移动端** (Carmg-H5) - Vant 风格  
-3. **两端都要**
-
-请选择 (1/2/3):
-```
-
-**DO NOT skip this question. DO NOT auto-detect. ALWAYS ASK.**
-**Wait for user answer before doing ANYTHING else.**
-**DO NOT search/read/analyze in the same turn as asking — the reply MUST end after the question.**
-Asking platform + simultaneously searching code in the same response is a VIOLATION.
-
----
-
-## CRITICAL RULE #2: Use /wl-search to find code
-
-When user asks about code, business, API, feature:
-1. **ALWAYS** use `/wl-search <keyword>` command first
-2. Then read only the specific files returned
-3. **NEVER** grep the entire codebase directly
-
-Examples:
-- "考勤代码在哪" -> /wl-search attendance
-- "保险定时任务" -> /wl-search insurance
-- "薪资API" -> /wl-search --api salary
-
-## CRITICAL RULE #2.5: 触发方式（非侵入式 — v3.0）
-
-工作流**只在显式调用时启动**，不主动干预普通对话。
-
-**两种触发方式（且仅此两种）：**
-1. **斜杠命令**：`/wl-prd` `/wl-search` `/wl-req` 等 → 启动工作流
-2. **npx**：`npx @hupan56/wlkj init/update` → 安装/同步
-
-**自然语言不触发工作流。** 用户说"写个需求""查下代码"等，AI 正常回答，不自动拉入工作流。
-（工作流启动后的过程内交互 — 如选平台、确认需求 — 仍可用自然语言。）
-
-### 禅道自然查询（非命令，直接回答）
-
-用户随口问禅道（"我的任务""看下#301""Bug 状态""我的需求"）—— **直接用禅道 MCP 工具自然回答**，
-不拉入 `/wl-task` 工作流：
-- QoderWork: `qw_mcp_call("my_workbench", {})` 一行看全（任务+需求+Bug）
-- CLI/其他: `cap.mcp.call("my_workbench")`
-
-只有**显式工序**（`/wl-task` 建需求/记工时/改状态）才走工作流。
-> 工具用真实工具名，别拿需求冒充任务回答（问任务查 task 域，查不到如实说"没有"）。
-
-
-注意区分："同步/保存产出" = team_sync（push）；"提交/commit 代码" = wl-commit。
-
-## CRITICAL RULE #3: User NEVER touches git
-
-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`
-- 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.
-
-## Platform Filtering
-
-After user selects platform, use it for search:
-
-```bash
-# Search by platform
-/wl-search 保险 --platform web      # Only fywl-ui (PC)
-/wl-search 保险 --platform app      # Only Carmg-H5 (Mobile)
-/wl-search 保险                       # Both platforms
-
-# Platform shortcuts
-web/pc/管理端 -> fywl-ui
-app/mobile/h5/移动端 -> Carmg-H5
-```
-
-## Commands: 7 Core (小而美) + Optional
-
-> 认知面只暴露 7 个核心命令，每个是一道工序站，每个带模式参数。
-> **一个命令当多个用**——记不住参数也没关系，自然语言一样路由。
-> 模块契约（输入/输出/校验）见 `.qoder/contracts/`。
-
-### 7 Core Commands（记住这 7 个就够）
-
-| Command | 工序站 | 模式参数（第一个词路由） | Auto | 背后 skill |
-|---------|--------|------------------------|------|-----------|
-| `/wl-init` | 身份 | （无） | YES | wl-init |
-| `/wl-prd` | 需求 | 语义路由: 完整档/小改动/评审 (原 wl-prd-full/quick/review 合并) | YES | prd-generator/prd-review |
-| `/wl-design` | 设计 | `import`/`generate`/`review` 或默认(import) | YES | design-import/prototype-generator/design-review |
-| `/wl-task` | 任务 | `create`/`list`/`start`/`finish` | YES | wl-task |
-| `/wl-code` | 编码 | （无，按 spec 实现） | NO | spec-coder |
-| `/wl-test` | 测试 | `quick`/`browser`/`unit` 或默认(quick) | NO | wl-test / test-generator |
-| `/wl-commit` | 提交 | （无） | NO | wl-commit |
-
-### Optional Commands（长大了再开，非执行链路必经）
-
-> 物理上归在 `.qoder/commands/optional/` 子目录（Qoder IDE 会按子目录归类显示），
-> QoderWork 安装脚本已支持递归扫描，4 个照样能装到用户级。
-
-| Command | 用途 | 何时用 |
-|---------|------|--------|
-| `/wl-search` | 代码索引搜索 | 全员工具，按需，非工序站（物理在 `commands/` 顶层） |
-| `/wl-req` | 需求 CRUD + 发布 | 需求生命周期管理（创建/编辑/发布/归档） |
-| `/wl-spec` | PRD→技术规格 | 需求复杂时（小团队可直接 `/wl-code`） |
-| `/wl-status` | 项目健康度/路线图 | 需要 PMO/汇报时 |
-| `/wl-report` | 日报周报 | 需要向上汇报时 |
-| `/wl-insight` | 需求澄清对焦(默认)/调研/规划 | 需求模糊听不懂、要做调研或规划时（位于 /wl-prd 之前）。最高频:产品听不懂用户时快速对焦(必要时出原型图帮助理解),对齐后再问要不要调研 |
-
-> **新人只需记 7 个核心命令**，能把活从需求干到提交。可选 6 个按场景启用。
-
-## Knowledge Index
-
-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
-
-### MCP Servers (QoderWork / Qoder IDE)
-注册在 `~/.qoderwork/mcp.json`，setup.py 一键配齐：
-- `qoder-knowledge-graph` (stdio) — 本仓库知识图谱，13 个工具 (search_code/api, get_impact, context_360, fill_prototype, get_design_system...)。自动拉起。
-- `playwright` (stdio) — 浏览器自动化，快且稳。自动拉起。
-- `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`。
-
-### Style Index (Prototype Reference)
-UI patterns from Vue files: Tables(718), Forms(301), Detail(129), Dashboard(90)
-Top components: Space(583), Modal(270), Select(172), Input(134)
-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
-
-Prototype templates:
-  .qoder/templates/prototype-web.html   # Web管理端 (Vben Admin + Ant Design)
-  .qoder/templates/prototype-app.html   # APP移动端 (Vant)
-
-Prototype output: workspace/members/{dev}/drafts/prototype-{feature}.html
-Style priority: Code > PDF > Default
-
-## Workflow: 契约网（非强制流水线）
-
-模块间**不强制顺序**，靠标准契约文件对接（详见 `.qoder/contracts/`）。
-完整链路**可以**这么走，但任何模块都能独立开机：
-
-```
-/wl-init → /wl-prd (ASK PLATFORM!) → /wl-design → /wl-task → /wl-code → /wl-test → /wl-commit
-  身份       需求        设计          任务        编码        测试        提交
-```
-
-**独立性**：每个模块认文件不认流程。缺上游 → 手动喂个契约文件，或用自然语言 +
-`context_pack.py` 让 AI 自检索补全（见 `.qoder/contracts/fallback.md`）。
-
-## Qoder 全系列兼容（IDE / Quest / CLI / QoderWork）
-
-This pipeline works on Windows + macOS, across the **whole Qoder family**.
-Each product loads rules from a different carrier — keep them in sync:
-
-| 产品/模式 | 规则载体 | 命令载体 |
-|-----------|---------|---------|
-| Qoder IDE 默认编辑器 | .qoder/rules/wl-pipeline.md (always_on) | .qoder/commands/wl-*.md |
-| Qoder Quest 模式 | .qoder/rules/ + .qoder/skills/ + .qoder/agents/ | 自然语言 -> skills |
-| Qoder CLI (qodercli) | 本文件 AGENTS.md | 自然语言 -> scripts |
-| QoderWork 桌面 Agent | 安装 .qoder/skills/ 下的技能 | 自然语言 -> skills |
-
-> 本流水线聚焦 Qoder 全系列，4 种载体功能等价。知识图谱 13 个能力（影响分析/
-> 覆盖矩阵/功能画像/业务流程/多跳遍历…）通过统一 CLI `python .qoder/scripts/kg/kg.py`
-> 全系列触达；QoderWork 环境也可直接调 MCP 工具。
-
-## QoderWork Integration: Optional Enhancement Only (Progressive Enhancement)
-
-> 🔒 **核心原则：本流水线绝不强依赖 QoderWork。**
-> 团队里有人用 Qoder IDE、有人用 Qoder CLI、有人用 QoderWork —— 必须保证前两者开箱即用、功能完整。
-> QoderWork 的「连接器 / 专家套件 / 定时任务」只能是**可选增强**：有就锦上添花，没有就静默回退，绝不报错、绝不阻塞。
-
-具体落实：
-- **本地数据是唯一事实源**：task.json / git log / drafts / index 永远是真相，连接器只是它的"投影/补充"
-- **增强段统一标记 `🧩 QoderWork 增强（可选）`**：出现在 wl-report / wl-task / wl-status 三个 skill 里，每段都明确写"无连接器则自动回退 + 不影响纯 Qoder 使用"
-- **探测而非假设**：只在运行环境真正提供了「日历/待办/邮件」工具可读时才启用增强；看不到就跳过，补一句 `[xx 未启用：非 QoderWork 或未授权连接器]`
-- 已接入的增强点：
-  - `/wl-report` 读日历补"会议/评审"到日报（补 PM/设计岗无提交的空窗）
-  - `/wl-task` 把任务同步为待办 + finish 后标记完成（本地仍为准）
-  - `/wl-status` 用真实日历节点校准"按时交付""团队同步"两维健康度
-- 未来加任何 QoderWork 增强都必须遵循同样原则：**先保证纯 Qoder 可跑，再叠加可选层。**
-
-- THE rule file: `.qoder/rules/wl-pipeline.md` — 修改流程规则时同步更新它和本文件
-- Quest 修改 agents/skills 后需重启 Quest 窗口/新建对话才能生效（Qoder 已知限制）
-- **Repo Wiki** (`.qoder/repowiki/`, Qoder IDE 生成): 存在则作为模块级知识源,
-  写 PRD 前优先查相关模块页。索引管"定位", Wiki 管"理解"。
-  ⚠️ Wiki 由宿主从代码自动生成、会被重生成覆盖, **且 .gitignore 已排除** → 不可手写、不进团队 git
-  (团队共享知识走 `data/learning/patterns/` 和 `data/docs/`, 那里可写且进 git)。
-- All scripts are pure Python 3 + git, path-autodetecting (no hardcoded
-  drive letters). Invoke as `python` (Windows) or `python3` (macOS).
-- Weekly update: Windows -> scripts/setup_weekly_cron.bat,
-  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).
-
-## Fast Path: one call to get all context
-
-`python .qoder/scripts/kg/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.
-
-## Icons: NEVER emoji
-
-Prototypes use the projects' real icon systems (data/index/icon-reference.json):
-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]`
-must PASS (>=80%). Metrics definition: data/docs/constitution/eva-metrics.md
-
-## Workflow Usability (可用性)
-
-回答"这套工作流对真实团队用不用得起来"——EVA 管 PRD 写得好不好, 本指标管工作流有没有人用。
-```bash
-python .qoder/scripts/orchestration/wlkj.py usability [--days N]   # 或 --json
-```
-- 采纳(主): U1流程采纳率/U2一次过审率/U3返工轮数/U4规则违反率/U5绕过率/U6活跃度
-- 流程(辅): F1端到端闭环率/F2转化漏斗/F3单命令效率/F4流程断点
-- 每条指标标【自动/半自动/待埋点】, 算不了的明说不编造
-- `/wl-status health` 的健康分含「工作流采纳」维度(权重10%)
-- 指标定义 + 公式 + 阈值: `data/docs/constitution/workflow-usability-metrics.md`
-- **交互看板**: `wlkj.py usability --html` → QoderWork 嵌入对话流 / CLI 落盘 dashboard.html
-- **红灯自动沉淀**: 评测红/黄项自动 append 到 `data/learning/patterns/usability-patterns.md`(进 git 团队共享)
-
-## Deterministic Hooks (确定性钩子 · 吸收宿主能力)
-
-把"靠 AI 自觉"的规则升级为"宿主确定性执行"(不漂移、不依赖 LLM 服从性)。配置在 `.qoder/settings.json`:
-
-| Hook | 时机 | 作用 | 阻断? |
-|------|------|------|-------|
-| `SessionStart` | 开会话 | 注入项目上下文 + 可用性红灯到 `<qoder-context>` | 否 |
-| `UserPromptSubmit` | 用户提交 | `/wl-prd-*` 未带平台 → **exit 2 阻断**, 强制先问平台(治违规率) | 是 |
-| `PostToolUse` | 工具执行后 | 写完 PRD/建完任务 → **自动埋点**(治漏斗断链) | 否 |
-| `Stop` | Agent 说完成 | 产出 PRD 未跑 eval → **exit 2 阻断**, 强制 eval≥80%(带防递归) | 是 |
-
-> 钩子契约: `exit 0` 放行 / `exit 2` 阻断(原因写 stderr) / 失败绝不崩会话。脚本草稿在 `.qoder/hooks/`。
-
-## Permission Model
-
-| Level | Commands | Auto |
-|-------|---------|------|
-| SAFE | /wl-init, /wl-prd, /wl-design, /wl-task, /wl-search, /wl-req, /wl-spec, /wl-status, /wl-insight, /wl-report | YES |
-| DANGEROUS | /wl-code, /wl-test, /wl-commit | NO |
+# QODER Pipeline
+
+## 🏗️ 架构: 引擎与数据分离 (Trellis 化)
+
+`.qoder/` 一分为二 (v2.8.0+):
+
+| 类别 | 内容 | 来源 | 进团队 git? |
+|------|------|------|------------|
+| **引擎代码** | `.qoder/scripts/` `skills/` `commands/` `agents/` `contracts/` `hooks/` `templates/` `rules/` | `npx @hupan56/wlkj init/update` 生成 | ❌ gitignore |
+| **团队数据** | `.qoder/config.yaml` `config.toml` `settings.json` `learning/` + `data/` (kg.duckdb/索引) + `workspace/` (PRD/任务) | git 跟踪, 团队共享 | ✅ |
+
+- 引擎代码**只由 npm 包生成**, 不再进团队 git → 彻底消除"引擎更新污染团队 git"和"新机 init 产生 unrelated histories"。
+- Qoder 全系列仍读 `.qoder/` (路径不变), 只是引擎来源从 git 变成 npm 生成。
+- 老团队升级 (管理员跑一次): `npx @hupan56/wlkj migrate`, 然后团队成员各自 `npx @hupan56/wlkj update`。
+
+---
+
+## ⚠️ CRITICAL RULE #1: ALWAYS ASK PLATFORM FIRST
+
+**When user asks for PRD or prototype, you MUST ask this question FIRST:**
+
+```
+这个需求是针对哪个平台？
+
+1. **Web 管理端** (fywl-ui) - Ant Design Vue + VxeGrid 风格
+2. **APP 移动端** (Carmg-H5) - Vant 风格  
+3. **两端都要**
+
+请选择 (1/2/3):
+```
+
+**DO NOT skip this question. DO NOT auto-detect. ALWAYS ASK.**
+**Wait for user answer before doing ANYTHING else.**
+**DO NOT search/read/analyze in the same turn as asking — the reply MUST end after the question.**
+Asking platform + simultaneously searching code in the same response is a VIOLATION.
+
+---
+
+## CRITICAL RULE #2: Use /wl-search to find code
+
+When user asks about code, business, API, feature:
+1. **ALWAYS** use `/wl-search <keyword>` command first
+2. Then read only the specific files returned
+3. **NEVER** grep the entire codebase directly
+
+Examples:
+- "考勤代码在哪" -> /wl-search attendance
+- "保险定时任务" -> /wl-search insurance
+- "薪资API" -> /wl-search --api salary
+
+## CRITICAL RULE #2.5: 触发方式（非侵入式 — v3.0）
+
+工作流**只在显式调用时启动**，不主动干预普通对话。
+
+**两种触发方式（且仅此两种）：**
+1. **斜杠命令**：`/wl-prd` `/wl-search` `/wl-req` 等 → 启动工作流
+2. **npx**：`npx @hupan56/wlkj init/update` → 安装/同步
+
+**自然语言不触发工作流。** 用户说"写个需求""查下代码"等，AI 正常回答，不自动拉入工作流。
+（工作流启动后的过程内交互 — 如选平台、确认需求 — 仍可用自然语言。）
+
+### 禅道自然查询（非命令，直接回答）
+
+用户随口问禅道（"我的任务""看下#301""Bug 状态""我的需求"）—— **直接用禅道 MCP 工具自然回答**，
+不拉入 `/wl-task` 工作流：
+- QoderWork: `qw_mcp_call("my_workbench", {})` 一行看全（任务+需求+Bug）
+- CLI/其他: `cap.mcp.call("my_workbench")`
+
+只有**显式工序**（`/wl-task` 建需求/记工时/改状态）才走工作流。
+> 工具用真实工具名，别拿需求冒充任务回答（问任务查 task 域，查不到如实说"没有"）。
+
+
+注意区分："同步/保存产出" = team_sync（push）；"提交/commit 代码" = wl-commit。
+
+## CRITICAL RULE #3: User NEVER touches git
+
+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`
+- 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.
+
+## Platform Filtering
+
+After user selects platform, use it for search:
+
+```bash
+# Search by platform
+/wl-search 保险 --platform web      # Only fywl-ui (PC)
+/wl-search 保险 --platform app      # Only Carmg-H5 (Mobile)
+/wl-search 保险                       # Both platforms
+
+# Platform shortcuts
+web/pc/管理端 -> fywl-ui
+app/mobile/h5/移动端 -> Carmg-H5
+```
+
+## Commands: 7 Core (小而美) + Optional
+
+> 认知面只暴露 7 个核心命令，每个是一道工序站，每个带模式参数。
+> **一个命令当多个用**——记不住参数也没关系，自然语言一样路由。
+> 模块契约（输入/输出/校验）见 `.qoder/contracts/`。
+
+### 7 Core Commands（记住这 7 个就够）
+
+| Command | 工序站 | 模式参数（第一个词路由） | Auto | 背后 skill |
+|---------|--------|------------------------|------|-----------|
+| `/wl-init` | 身份 | （无） | YES | wl-init |
+| `/wl-prd` | 需求 | 语义路由: 完整档/小改动/评审 (原 wl-prd-full/quick/review 合并) | YES | prd-generator/prd-review |
+| `/wl-design` | 设计 | `import`/`generate`/`review` 或默认(import) | YES | design-import/prototype-generator/design-review |
+| `/wl-task` | 任务 | `create`/`list`/`start`/`finish` | YES | wl-task |
+| `/wl-code` | 编码 | （无，按 spec 实现） | NO | spec-coder |
+| `/wl-test` | 测试 | `quick`/`browser`/`unit` 或默认(quick) | NO | wl-test / test-generator |
+| `/wl-commit` | 提交 | （无） | NO | wl-commit |
+
+### Optional Commands（长大了再开，非执行链路必经）
+
+> 物理上归在 `.qoder/commands/optional/` 子目录（Qoder IDE 会按子目录归类显示），
+> QoderWork 安装脚本已支持递归扫描，4 个照样能装到用户级。
+
+| Command | 用途 | 何时用 |
+|---------|------|--------|
+| `/wl-search` | 代码索引搜索 | 全员工具，按需，非工序站（物理在 `commands/` 顶层） |
+| `/wl-req` | 需求 CRUD + 发布 | 需求生命周期管理（创建/编辑/发布/归档） |
+| `/wl-spec` | PRD→技术规格 | 需求复杂时（小团队可直接 `/wl-code`） |
+| `/wl-status` | 项目健康度/路线图 | 需要 PMO/汇报时 |
+| `/wl-report` | 日报周报 | 需要向上汇报时 |
+| `/wl-insight` | 需求澄清对焦(默认)/调研/规划 | 需求模糊听不懂、要做调研或规划时（位于 /wl-prd 之前）。最高频:产品听不懂用户时快速对焦(必要时出原型图帮助理解),对齐后再问要不要调研 |
+
+> **新人只需记 7 个核心命令**，能把活从需求干到提交。可选 6 个按场景启用。
+
+## Knowledge Index
+
+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
+
+### MCP Servers (QoderWork / Qoder IDE)
+注册在 `~/.qoderwork/mcp.json`，setup.py 一键配齐：
+- `qoder-knowledge-graph` (stdio) — 本仓库知识图谱，17 个工具 (search_code/api, get_impact, context_360, fill_prototype, get_design_system...)。自动拉起。
+- `playwright` (stdio) — 浏览器自动化，快且稳。自动拉起。
+- `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`。
+
+### Style Index (Prototype Reference)
+UI patterns from Vue files: Tables(718), Forms(301), Detail(129), Dashboard(90)
+Top components: Space(583), Modal(270), Select(172), Input(134)
+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
+
+Prototype templates:
+  .qoder/templates/prototype-web.html   # Web管理端 (Vben Admin + Ant Design)
+  .qoder/templates/prototype-app.html   # APP移动端 (Vant)
+
+Prototype output: workspace/members/{dev}/drafts/prototype-{feature}.html
+Style priority: Code > PDF > Default
+
+## Workflow: 契约网（非强制流水线）
+
+模块间**不强制顺序**，靠标准契约文件对接（详见 `.qoder/contracts/`）。
+完整链路**可以**这么走，但任何模块都能独立开机：
+
+```
+/wl-init → /wl-prd (ASK PLATFORM!) → /wl-design → /wl-task → /wl-code → /wl-test → /wl-commit
+  身份       需求        设计          任务        编码        测试        提交
+```
+
+**独立性**：每个模块认文件不认流程。缺上游 → 手动喂个契约文件，或用自然语言 +
+`context_pack.py` 让 AI 自检索补全（见 `.qoder/contracts/fallback.md`）。
+
+## Qoder 全系列兼容（IDE / Quest / CLI / QoderWork）
+
+This pipeline works on Windows + macOS, across the **whole Qoder family**.
+Each product loads rules from a different carrier — keep them in sync:
+
+| 产品/模式 | 规则载体 | 命令载体 |
+|-----------|---------|---------|
+| Qoder IDE 默认编辑器 | .qoder/rules/wl-pipeline.md (always_on) | .qoder/commands/wl-*.md |
+| Qoder Quest 模式 | .qoder/rules/ + .qoder/skills/ + .qoder/agents/ | 自然语言 -> skills |
+| Qoder CLI (qodercli) | 本文件 AGENTS.md | 自然语言 -> scripts |
+| QoderWork 桌面 Agent | 安装 .qoder/skills/ 下的技能 | 自然语言 -> skills |
+
+> 本流水线聚焦 Qoder 全系列，4 种载体功能等价。知识图谱 17 个能力（影响分析/
+> 覆盖矩阵/功能画像/业务流程/多跳遍历…）通过统一 CLI `python .qoder/scripts/kg/kg.py`
+> 全系列触达；QoderWork 环境也可直接调 MCP 工具。
+
+## QoderWork Integration: Optional Enhancement Only (Progressive Enhancement)
+
+> 🔒 **核心原则：本流水线绝不强依赖 QoderWork。**
+> 团队里有人用 Qoder IDE、有人用 Qoder CLI、有人用 QoderWork —— 必须保证前两者开箱即用、功能完整。
+> QoderWork 的「连接器 / 专家套件 / 定时任务」只能是**可选增强**：有就锦上添花，没有就静默回退，绝不报错、绝不阻塞。
+
+具体落实：
+- **本地数据是唯一事实源**：task.json / git log / drafts / index 永远是真相，连接器只是它的"投影/补充"
+- **增强段统一标记 `🧩 QoderWork 增强（可选）`**：出现在 wl-report / wl-task / wl-status 三个 skill 里，每段都明确写"无连接器则自动回退 + 不影响纯 Qoder 使用"
+- **探测而非假设**：只在运行环境真正提供了「日历/待办/邮件」工具可读时才启用增强；看不到就跳过，补一句 `[xx 未启用：非 QoderWork 或未授权连接器]`
+- 已接入的增强点：
+  - `/wl-report` 读日历补"会议/评审"到日报（补 PM/设计岗无提交的空窗）
+  - `/wl-task` 把任务同步为待办 + finish 后标记完成（本地仍为准）
+  - `/wl-status` 用真实日历节点校准"按时交付""团队同步"两维健康度
+- 未来加任何 QoderWork 增强都必须遵循同样原则：**先保证纯 Qoder 可跑，再叠加可选层。**
+
+- THE rule file: `.qoder/rules/wl-pipeline.md` — 修改流程规则时同步更新它和本文件
+- Quest 修改 agents/skills 后需重启 Quest 窗口/新建对话才能生效（Qoder 已知限制）
+- **Repo Wiki** (`.qoder/repowiki/`, Qoder IDE 生成): 存在则作为模块级知识源,
+  写 PRD 前优先查相关模块页。索引管"定位", Wiki 管"理解"。
+  ⚠️ Wiki 由宿主从代码自动生成、会被重生成覆盖, **且 .gitignore 已排除** → 不可手写、不进团队 git
+  (团队共享知识走 `data/learning/patterns/` 和 `data/docs/`, 那里可写且进 git)。
+- All scripts are pure Python 3 + git, path-autodetecting (no hardcoded
+  drive letters). Invoke as `python` (Windows) or `python3` (macOS).
+- Weekly update: Windows -> scripts/setup_weekly_cron.bat,
+  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).
+
+## Fast Path: one call to get all context
+
+`python .qoder/scripts/kg/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.
+
+## Icons: NEVER emoji
+
+Prototypes use the projects' real icon systems (data/index/icon-reference.json):
+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]`
+must PASS (>=80%). Metrics definition: data/docs/constitution/eva-metrics.md
+
+## Workflow Usability (可用性)
+
+回答"这套工作流对真实团队用不用得起来"——EVA 管 PRD 写得好不好, 本指标管工作流有没有人用。
+```bash
+python .qoder/scripts/orchestration/wlkj.py usability [--days N]   # 或 --json
+```
+- 采纳(主): U1流程采纳率/U2一次过审率/U3返工轮数/U4规则违反率/U5绕过率/U6活跃度
+- 流程(辅): F1端到端闭环率/F2转化漏斗/F3单命令效率/F4流程断点
+- 每条指标标【自动/半自动/待埋点】, 算不了的明说不编造
+- `/wl-status health` 的健康分含「工作流采纳」维度(权重10%)
+- 指标定义 + 公式 + 阈值: `data/docs/constitution/workflow-usability-metrics.md`
+- **交互看板**: `wlkj.py usability --html` → QoderWork 嵌入对话流 / CLI 落盘 dashboard.html
+- **红灯自动沉淀**: 评测红/黄项自动 append 到 `data/learning/patterns/usability-patterns.md`(进 git 团队共享)
+
+## Deterministic Hooks (确定性钩子 · 吸收宿主能力)
+
+把"靠 AI 自觉"的规则升级为"宿主确定性执行"(不漂移、不依赖 LLM 服从性)。配置在 `.qoder/settings.json`:
+
+| Hook | 时机 | 作用 | 阻断? |
+|------|------|------|-------|
+| `SessionStart` | 开会话 | 注入项目上下文 + 可用性红灯到 `<qoder-context>` | 否 |
+| `UserPromptSubmit` | 用户提交 | `/wl-prd-*` 未带平台 → **exit 2 阻断**, 强制先问平台(治违规率) | 是 |
+| `PostToolUse` | 工具执行后 | 写完 PRD/建完任务 → **自动埋点**(治漏斗断链) | 否 |
+| `Stop` | Agent 说完成 | 产出 PRD 未跑 eval → **exit 2 阻断**, 强制 eval≥80%(带防递归) | 是 |
+
+> 钩子契约: `exit 0` 放行 / `exit 2` 阻断(原因写 stderr) / 失败绝不崩会话。脚本草稿在 `.qoder/hooks/`。
+
+## Permission Model
+
+| Level | Commands | Auto |
+|-------|---------|------|
+| SAFE | /wl-init, /wl-prd, /wl-design, /wl-task, /wl-search, /wl-req, /wl-spec, /wl-status, /wl-insight, /wl-report | YES |
+| DANGEROUS | /wl-code, /wl-test, /wl-commit | NO |