@hupan56/wlkj 3.1.7 → 3.1.8

package/package.json

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

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/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