@hupan56/wlkj 3.3.14 → 3.3.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/bin/cli.js +16 -1
  2. package/package.json +1 -1
  3. package/templates/qoder/commands/optional/wl-spec.md +4 -2
  4. package/templates/qoder/commands/wl-commit.md +3 -1
  5. package/templates/qoder/commands/wl-init.md +2 -2
  6. package/templates/qoder/commands/wl-prd.md +24 -0
  7. package/templates/qoder/commands/wl-search.md +18 -11
  8. package/templates/qoder/commands/wl-task.md +3 -1
  9. package/templates/qoder/config.yaml +0 -6
  10. package/templates/qoder/contracts/insight.md +55 -0
  11. package/templates/qoder/hooks/pre-tool-use-commit.py +124 -0
  12. package/templates/qoder/hooks/session-start.py +20 -1
  13. package/templates/qoder/hooks/stop-eval.py +129 -0
  14. package/templates/qoder/scripts/capability/adapters/mcp.py +9 -1
  15. package/templates/qoder/scripts/capability/registry.py +0 -3
  16. package/templates/qoder/scripts/deployment/setup/init_doctor.py +6 -2
  17. package/templates/qoder/scripts/deployment/setup/install_qoderwork.py +7 -7
  18. package/templates/qoder/scripts/deployment/setup/setup.py +5 -2
  19. package/templates/qoder/scripts/domain/kg/build/build_entity_registry.py +12 -12
  20. package/templates/qoder/scripts/domain/kg/build/build_relations.py +12 -12
  21. package/templates/qoder/scripts/domain/kg/graph/kg_semantic.py +41 -5
  22. package/templates/qoder/scripts/domain/kg/kg.py +14 -0
  23. package/templates/qoder/scripts/foundation/io/context_cache.py +94 -0
  24. package/templates/qoder/scripts/tool_guide.md +70 -0
  25. package/templates/qoder/scripts/validation/eval/alignment_matrix.py +176 -0
  26. package/templates/qoder/scripts/validation/eval/bf2_content_fidelity.py +110 -0
  27. package/templates/qoder/scripts/validation/eval/bf2_llmjudge.py +104 -0
  28. package/templates/qoder/scripts/validation/eval/bf_score.py +218 -0
  29. package/templates/qoder/scripts/validation/eval/code_flywheel.py +150 -0
  30. package/templates/qoder/scripts/validation/eval/dispatcher_ab.py +156 -0
  31. package/templates/qoder/scripts/validation/eval/dispatcher_ab_2026-07-21.json +23 -0
  32. package/templates/qoder/scripts/validation/eval/feature_fidelity_flywheel.py +143 -0
  33. package/templates/qoder/scripts/validation/eval/gradient_matrix.py +261 -0
  34. package/templates/qoder/scripts/validation/eval/gradient_matrix_baseline_2026-07-21.json +33 -0
  35. package/templates/qoder/scripts/validation/eval/metrics_dashboard.py +105 -0
  36. package/templates/qoder/scripts/validation/eval/multi_turn_flywheel.py +118 -0
  37. package/templates/qoder/scripts/validation/eval/prd_fidelity_flywheel.py +128 -0
  38. package/templates/qoder/scripts/validation/eval/prd_flywheel.py +148 -0
  39. package/templates/qoder/scripts/validation/eval/prototype_fidelity_flywheel.py +166 -0
  40. package/templates/qoder/scripts/validation/eval/recall_flywheel.py +148 -0
  41. package/templates/qoder/scripts/validation/eval/robustness_flywheel.py +139 -0
  42. package/templates/qoder/scripts/validation/eval/speed_accuracy_flywheel.py +188 -0
  43. package/templates/qoder/scripts/validation/eval/task_flywheel.py +124 -0
  44. package/templates/qoder/scripts/validation/eval/token_flywheel.py +88 -0
  45. package/templates/qoder/scripts/validation/metrics/eval_code_ac.py +177 -0
  46. package/templates/qoder/scripts/validation/metrics/lint_cases.py +170 -0
  47. package/templates/qoder/scripts/validation/test/test_context_cache.py +78 -0
  48. package/templates/qoder/scripts/validation/test/test_lint_cases.py +60 -0
  49. package/templates/qoder/scripts/validation/test/test_pre_tool_use_commit.py +70 -0
  50. package/templates/qoder/skills/wl-spec/SKILL.md +1 -1
  51. package/templates/qoder/agents/design-agent.md +0 -20
  52. package/templates/qoder/agents/spec-generator.md +0 -21
  53. package/templates/qoder/scripts/domain/kg/graph/kg_link_db.py +0 -235
  54. package/templates/qoder/scripts/domain/kg/search/enrich_prompt.py +0 -238
  55. package/templates/qoder/scripts/domain/kg/server/perf_bench.py +0 -197
@@ -1,197 +0,0 @@
1
- # -*- coding: utf-8 -*-
2
- # v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
3
- import os as _o, sys as _s
4
- _f = _o.path.abspath(__file__)
5
- for _ in range(10):
6
- _f = _o.path.dirname(_f)
7
- _cp = _o.path.join(_f, 'foundation')
8
- if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
9
- break
10
- if _cp not in _s.path: _s.path.insert(0, _cp)
11
- from bootstrap import setup; setup()
12
- from foundation.core.paths import get_repo_root
13
-
14
- """
15
- perf_bench.py — 知识图谱关键路径性能基准
16
-
17
- 诊断"用了工作流反而更慢"的根因, 并验证常驻化(daemon)加速层的效果。
18
-
19
- 两种测量模式:
20
- 1. 冷启动 (subprocess 跑 kg.py) — 模拟真实用户体验: 起进程→import→连库→跑
21
- 2. daemon 热路径 (kgd_client) — daemon 常驻时的 IPC 调用, 模型/连接已就绪
22
-
23
- 用法:
24
- python perf_bench.py # 默认: 测冷启动 (--no-daemon)
25
- python perf_bench.py --with-daemon # 同时测 daemon 热路径 (需先 kgd.py start)
26
- python perf_bench.py --quick # 跳过 semantic (26s), 只测轻量路径
27
- """
28
- import io
29
- import os
30
- import subprocess
31
- import sys
32
- import time
33
-
34
- # UTF-8 输出 (Windows 终端默认 GBK 会乱码)
35
- try:
36
- sys.stdout.reconfigure(encoding='utf-8', errors='replace')
37
- except Exception:
38
- pass
39
-
40
- KG_PY = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'kg.py')
41
- REPO_ROOT = get_repo_root()
42
-
43
- # ── 测试用例 (覆盖四层) ──────────────────────────────────────────────
44
- # (名称, kg子命令, 参数列表, 预期层)
45
- CASES = [
46
- ('search-考勤(web)', 'search', ['考勤', '--platform', 'web'], '结构层'),
47
- ('search-车辆(web)', 'search', ['车辆', '--platform', 'web'], '结构层'),
48
- ('search-报销(app)', 'search', ['报销', '--platform', 'app'], '结构层'),
49
- ('api-asset', 'api', ['asset'], '结构层'),
50
- ('context_pack-车辆', 'context', ['车辆', '--platform', 'web'], '①③+设计'),
51
- ('impact-/asset', 'impact', ['/asset'], '图谱层'),
52
- ('feature-资产管理', 'feature', ['资产管理'], '图谱层'),
53
- ('semantic-报销', 'semantic', ['报销'], '向量层'), # 26s 慢王
54
- ]
55
-
56
-
57
- def _run_kg(args, use_daemon=True, timeout=120):
58
- """跑一次 kg.py 子命令, 返回 (耗时秒, 返回码)。
59
-
60
- use_daemon=True : 走默认 (kg.py 内部会优先 daemon)
61
- use_daemon=False : 加 --no-daemon 强制冷路径
62
- """
63
- cmd = [sys.executable, KG_PY] + args
64
- if not use_daemon:
65
- cmd.append('--no-daemon')
66
- env = dict(os.environ)
67
- env['PYTHONIOENCODING'] = 'utf-8'
68
- t0 = time.time()
69
- try:
70
- # stdout 重定向到 DEVNULL, 只测耗时, 不看内容
71
- r = subprocess.run(cmd, stdout=subprocess.DEVNULL,
72
- stderr=subprocess.DEVNULL, cwd=REPO_ROOT,
73
- env=env, timeout=timeout)
74
- return time.time() - t0, r.returncode
75
- except subprocess.TimeoutExpired:
76
- return float(timeout), -1
77
-
78
-
79
- def _median(samples):
80
- """取中位数 (抗抖动)。"""
81
- s = sorted(samples)
82
- n = len(s)
83
- return s[n // 2] if n % 2 else (s[n // 2 - 1] + s[n // 2]) / 2.0
84
-
85
-
86
- def bench_case(name, cmd, args, cold=True, daemon=False, repeats=3):
87
- """跑单个用例, 返回 (中位数耗时, 状态)。
88
-
89
- cold=True : 测冷启动 (--no-daemon)
90
- daemon=True: 测 daemon 热路径 (不加 --no-daemon, 但需 daemon 在线)
91
- """
92
- if cold and daemon:
93
- raise ValueError('cold 和 daemon 互斥')
94
- # 重量级命令 (semantic 冷启动 ~27s) 只跑 1 次, 避免基准脚本本身过慢
95
- if cmd == 'semantic' and cold:
96
- repeats = 1
97
- use_daemon = daemon
98
- samples = []
99
- status = 'ok'
100
- for _ in range(repeats):
101
- elapsed, rc = _run_kg([cmd] + args, use_daemon=use_daemon)
102
- samples.append(elapsed)
103
- if rc != 0:
104
- status = 'rc=%d' % rc
105
- return _median(samples), status
106
-
107
-
108
- def daemon_online():
109
- """探测 daemon 是否在线 (通过 kg.py status, 1s 超时)。"""
110
- try:
111
- from kgd import kgd_client
112
- return kgd_client.ping(timeout=1.0)
113
- except Exception:
114
- return False
115
-
116
-
117
- def fmt_speedup(cold_s, hot_s):
118
- """格式化加速比。"""
119
- if hot_s <= 0.001:
120
- return '-'
121
- return '%.0fx' % (cold_s / hot_s)
122
-
123
-
124
- def main():
125
- args = sys.argv[1:]
126
- quick = '--quick' in args
127
- want_daemon = '--with-daemon' in args
128
-
129
- print('=' * 72)
130
- print('知识图谱性能基准 (repo: %s)' % os.path.basename(REPO_ROOT))
131
- print('=' * 72)
132
-
133
- if quick:
134
- print('[quick 模式] 跳过 semantic (向量层 26s), 只测轻量路径\n')
135
- cases = [c for c in CASES if c[1] != 'semantic']
136
- else:
137
- cases = CASES
138
-
139
- cold_results = [] # [(name, secs, status, layer)]
140
- hot_results = {} # name -> (secs, status)
141
-
142
- # ── 1. 冷启动基线 (真实用户体验: 每次起一个进程) ──
143
- print('[1/2] 冷启动基线 (--no-daemon, 模拟现状) ...')
144
- for name, cmd, cargs, layer in cases:
145
- secs, status = bench_case(name, cmd, cargs, cold=True)
146
- cold_results.append((name, secs, status, layer))
147
- marker = ' ' if status == 'ok' else '! '
148
- print(' %s%-22s %6.2fs [%s] %s' % (marker, name, secs, layer, status))
149
- print()
150
-
151
- # ── 2. daemon 热路径 (常驻加速层) ──
152
- if want_daemon:
153
- online = daemon_online()
154
- if not online:
155
- print('[2/2] daemon 未在线 — 跳过热路径测试。')
156
- print(' (先启动: python .qoder/scripts/domain/kg/server/kgd.py start)')
157
- else:
158
- print('[2/2] daemon 在线, 测热路径 ...')
159
- for name, cmd, cargs, layer in cases:
160
- secs, status = bench_case(name, cmd, cargs, cold=False, daemon=True)
161
- hot_results[name] = (secs, status)
162
- marker = ' ' if status == 'ok' else '! '
163
- print(' %s%-22s %6.2fs [%s] %s' % (marker, name, secs, layer, status))
164
- print()
165
-
166
- # ── 汇总对比表 ──
167
- print('-' * 72)
168
- print('%-22s %10s %10s %10s' % ('用例', '冷启动', 'daemon', '加速'))
169
- print('%-22s %10s %10s %10s' % ('─' * 18, '─' * 8, '─' * 8, '─' * 6))
170
- for name, cold_s, status, layer in cold_results:
171
- hot_s = hot_results.get(name, (None, None))[0]
172
- hot_str = '%.2fs' % hot_s if hot_s else '-'
173
- speed = fmt_speedup(cold_s, hot_s) if hot_s else '-'
174
- print('%-22s %8.2fs %10s %10s' % (name, cold_s, hot_str, speed))
175
- print('-' * 72)
176
-
177
- # ── 诊断结论 ──
178
- print('\n诊断:')
179
- semantic_s = next((s for n, s, _, _ in cold_results if 'semantic' in n), None)
180
- if semantic_s and semantic_s > 10:
181
- print(' 🔴 semantic %.1fs — 模型冷加载占 99%%, 是头号慢源' % semantic_s)
182
- print(' 解法: kgd.py start 常驻模型 → <0.5s')
183
- elif semantic_s:
184
- print(' 🟢 semantic %.1fs — 在可接受范围' % semantic_s)
185
-
186
- total_cold = sum(s for _, s, _, _ in cold_results)
187
- print(' 冷启动累积: %.1fs (一次 PRD 流程的隐性等待)' % total_cold)
188
- if hot_results:
189
- total_hot = sum(hot_results[n][0] for n in hot_results)
190
- print(' daemon 累积: %.1fs → 整体提速 %.0fx' %
191
- (total_hot, total_cold / max(total_hot, 0.01)))
192
-
193
- return 0
194
-
195
-
196
- if __name__ == '__main__':
197
- sys.exit(main())