@hupan56/wlkj 3.2.0 → 3.3.1

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 (130) hide show
  1. package/bin/cli.js +117 -0
  2. package/package.json +2 -2
  3. package/templates/.qoder/.runtime/hook-errors.log +4 -0
  4. package/templates/qoder/commands/optional/wl-insight.md +276 -276
  5. package/templates/qoder/commands/optional/wl-report.md +1 -1
  6. package/templates/qoder/commands/optional/wl-spec.md +13 -1
  7. package/templates/qoder/commands/optional/wl-status.md +14 -1
  8. package/templates/qoder/commands/wl-code.md +111 -4
  9. package/templates/qoder/commands/wl-commit.md +12 -1
  10. package/templates/qoder/commands/wl-design.md +69 -5
  11. package/templates/qoder/commands/wl-init.md +129 -102
  12. package/templates/qoder/commands/wl-prd.md +162 -6
  13. package/templates/qoder/commands/wl-search.md +106 -20
  14. package/templates/qoder/commands/wl-task.md +617 -613
  15. package/templates/qoder/commands/wl-test.md +20 -1
  16. package/templates/qoder/contracts/spec.md +4 -0
  17. package/templates/qoder/hooks/post-tool-use.py +71 -0
  18. package/templates/qoder/hooks/pre-tool-use.py +136 -0
  19. package/templates/qoder/hooks/session-start.py +365 -397
  20. package/templates/qoder/scripts/capability/__pycache__/__init__.cpython-39.pyc +0 -0
  21. package/templates/qoder/scripts/capability/__pycache__/present_html.cpython-39.pyc +0 -0
  22. package/templates/qoder/scripts/capability/__pycache__/registry.cpython-39.pyc +0 -0
  23. package/templates/qoder/scripts/capability/__pycache__/registry_mcp.cpython-39.pyc +0 -0
  24. package/templates/qoder/scripts/capability/adapters/__init__.py +1 -1
  25. package/templates/qoder/scripts/capability/adapters/__pycache__/__init__.cpython-39.pyc +0 -0
  26. package/templates/qoder/scripts/capability/adapters/__pycache__/cli.cpython-39.pyc +0 -0
  27. package/templates/qoder/scripts/capability/adapters/__pycache__/mcp.cpython-39.pyc +0 -0
  28. package/templates/qoder/scripts/capability/adapters/__pycache__/qw.cpython-39.pyc +0 -0
  29. package/templates/qoder/scripts/capability/adapters/mcp.py +76 -100
  30. package/templates/qoder/scripts/capability/adapters/qw.py +295 -295
  31. package/templates/qoder/scripts/capability/caps/__init__.py +5 -5
  32. package/templates/qoder/scripts/capability/caps/__pycache__/__init__.cpython-39.pyc +0 -0
  33. package/templates/qoder/scripts/capability/caps/__pycache__/context.cpython-39.pyc +0 -0
  34. package/templates/qoder/scripts/capability/caps/__pycache__/cron.cpython-39.pyc +0 -0
  35. package/templates/qoder/scripts/capability/caps/__pycache__/identity.cpython-39.pyc +0 -0
  36. package/templates/qoder/scripts/capability/caps/__pycache__/memory.cpython-39.pyc +0 -0
  37. package/templates/qoder/scripts/capability/caps/__pycache__/notify.cpython-39.pyc +0 -0
  38. package/templates/qoder/scripts/capability/caps/__pycache__/present.cpython-39.pyc +0 -0
  39. package/templates/qoder/scripts/capability/caps/__pycache__/repo.cpython-39.pyc +0 -0
  40. package/templates/qoder/scripts/capability/caps/__pycache__/sandbox.cpython-39.pyc +0 -0
  41. package/templates/qoder/scripts/capability/caps/memory.py +1 -1
  42. package/templates/qoder/scripts/capability/caps/notify.py +64 -0
  43. package/templates/qoder/scripts/capability/caps/sandbox.py +38 -0
  44. package/templates/qoder/scripts/capability/present_html.py +68 -0
  45. package/templates/qoder/scripts/capability/registry.py +27 -25
  46. package/templates/qoder/scripts/capability/registry_mcp.py +67 -5
  47. package/templates/qoder/scripts/capability/smoke_test_report.json +34 -20
  48. package/templates/qoder/scripts/deployment/setup/carriers.py +3 -1
  49. package/templates/qoder/scripts/deployment/setup/init_doctor.py +10 -3
  50. package/templates/qoder/scripts/domain/__pycache__/__init__.cpython-39.pyc +0 -0
  51. package/templates/qoder/scripts/domain/integration/__init__.py +0 -0
  52. package/templates/qoder/scripts/domain/integration/__pycache__/__init__.cpython-39.pyc +0 -0
  53. package/templates/qoder/scripts/domain/integration/__pycache__/return_to_platform.cpython-39.pyc +0 -0
  54. package/templates/qoder/scripts/domain/integration/return_to_platform.py +395 -0
  55. package/templates/qoder/scripts/domain/integration/spec_upload.py +208 -0
  56. package/templates/qoder/scripts/domain/kg/build/kg_build.py +27 -3
  57. package/templates/qoder/scripts/domain/kg/extract/asset/__init__.py +10 -0
  58. package/templates/qoder/scripts/domain/kg/extract/asset/asset_tree.py +57 -0
  59. package/templates/qoder/scripts/domain/kg/extract/asset/discussion_importer.py +62 -0
  60. package/templates/qoder/scripts/domain/kg/extract/asset/prd_importer.py +146 -0
  61. package/templates/qoder/scripts/domain/kg/extract/asset/prototype_importer.py +64 -0
  62. package/templates/qoder/scripts/domain/kg/extract/asset/returns_importer.py +52 -0
  63. package/templates/qoder/scripts/domain/kg/extract/build_goal3.py +104 -0
  64. package/templates/qoder/scripts/domain/kg/extract/build_goal4.py +55 -0
  65. package/templates/qoder/scripts/domain/kg/extract/build_goal5.py +95 -0
  66. package/templates/qoder/scripts/domain/kg/extract/db/__init__.py +8 -0
  67. package/templates/qoder/scripts/domain/kg/extract/db/data_profile.py +22 -0
  68. package/templates/qoder/scripts/domain/kg/extract/db/fk_extractor.py +55 -0
  69. package/templates/qoder/scripts/domain/kg/extract/db/schema_extractor.py +90 -0
  70. package/templates/qoder/scripts/domain/kg/extract/extract.py +84 -0
  71. package/templates/qoder/scripts/domain/kg/extract/inference/__init__.py +9 -0
  72. package/templates/qoder/scripts/domain/kg/extract/inference/community_summarizer.py +206 -0
  73. package/templates/qoder/scripts/domain/kg/extract/inference/embed_builder.py +132 -0
  74. package/templates/qoder/scripts/domain/kg/extract/inference/naming_matcher.py +80 -0
  75. package/templates/qoder/scripts/domain/kg/extract/inference/promote.py +59 -0
  76. package/templates/qoder/scripts/domain/kg/extract/inference/recompute.py +93 -0
  77. package/templates/qoder/scripts/domain/kg/extract/inference/weak_link.py +421 -0
  78. package/templates/qoder/scripts/domain/kg/extract/java/__init__.py +15 -0
  79. package/templates/qoder/scripts/domain/kg/extract/java/_parser.py +271 -0
  80. package/templates/qoder/scripts/domain/kg/extract/java/all.py +145 -0
  81. package/templates/qoder/scripts/domain/kg/extract/java/build_java_to_pg.py +102 -0
  82. package/templates/qoder/scripts/domain/kg/extract/java/call_chain.py +49 -0
  83. package/templates/qoder/scripts/domain/kg/extract/java/class_extractor.py +141 -0
  84. package/templates/qoder/scripts/domain/kg/extract/java/domain_extractor.py +148 -0
  85. package/templates/qoder/scripts/domain/kg/extract/java/dubbo_extractor.py +33 -0
  86. package/templates/qoder/scripts/domain/kg/extract/java/endpoint_extractor.py +36 -0
  87. package/templates/qoder/scripts/domain/kg/extract/java/javadoc_extractor.py +110 -0
  88. package/templates/qoder/scripts/domain/kg/extract/java/llm_cn_filler.py +150 -0
  89. package/templates/qoder/scripts/domain/kg/extract/java/member_extractor.py +157 -0
  90. package/templates/qoder/scripts/domain/kg/extract/java/mybatisplus_extractor.py +34 -0
  91. package/templates/qoder/scripts/domain/kg/extract/java/pg_upsert.py +165 -0
  92. package/templates/qoder/scripts/domain/kg/extract/java/satoken_extractor.py +30 -0
  93. package/templates/qoder/scripts/domain/kg/extract/java/spring_extractor.py +39 -0
  94. package/templates/qoder/scripts/domain/kg/extract/java/validation_extractor.py +33 -0
  95. package/templates/qoder/scripts/domain/kg/extract/mybatis/__init__.py +9 -0
  96. package/templates/qoder/scripts/domain/kg/extract/mybatis/all.py +79 -0
  97. package/templates/qoder/scripts/domain/kg/extract/mybatis/mapper_parser.py +99 -0
  98. package/templates/qoder/scripts/domain/kg/extract/mybatis/relation_builder.py +69 -0
  99. package/templates/qoder/scripts/domain/kg/extract/mybatis/sql_extractor.py +78 -0
  100. package/templates/qoder/scripts/domain/kg/extract/prd/__init__.py +8 -0
  101. package/templates/qoder/scripts/domain/kg/extract/prd/prd_chunk_embed.py +105 -0
  102. package/templates/qoder/scripts/domain/kg/extract/prd/prd_llm_extract.py +153 -0
  103. package/templates/qoder/scripts/domain/kg/extract/prd/req_anchor.py +120 -0
  104. package/templates/qoder/scripts/domain/kg/graph/kg_semantic.py +4 -2
  105. package/templates/qoder/scripts/domain/kg/kg.py +42 -5
  106. package/templates/qoder/scripts/domain/kg/search/_remote.py +187 -0
  107. package/templates/qoder/scripts/domain/kg/search/context_pack.py +32 -2
  108. package/templates/qoder/scripts/domain/kg/search/search_index.py +74 -20
  109. package/templates/qoder/scripts/domain/kg/switch_project.py +158 -0
  110. package/templates/qoder/scripts/domain/kg/sync_repowiki.py +109 -0
  111. package/templates/qoder/scripts/domain/task/__pycache__/wlkj_panel.cpython-39.pyc +0 -0
  112. package/templates/qoder/scripts/domain/task/{zentao_panel.py → wlkj_panel.py} +315 -53
  113. package/templates/qoder/scripts/engine/poller.py +219 -0
  114. package/templates/qoder/scripts/foundation/__pycache__/__init__.cpython-39.pyc +0 -0
  115. package/templates/qoder/scripts/foundation/core/__pycache__/__init__.cpython-39.pyc +0 -0
  116. package/templates/qoder/scripts/foundation/core/__pycache__/paths.cpython-39.pyc +0 -0
  117. package/templates/qoder/scripts/foundation/integrations/active_task.py +2 -1
  118. package/templates/qoder/scripts/orchestration/wlkj.py +4 -0
  119. package/templates/qoder/scripts/protocol/__pycache__/__init__.cpython-39.pyc +0 -0
  120. package/templates/qoder/scripts/protocol/mcp/zentao_mcp_server.py +1 -1
  121. package/templates/qoder/scripts/protocol/transports/__pycache__/__init__.cpython-39.pyc +0 -0
  122. package/templates/qoder/scripts/protocol/transports/__pycache__/base.cpython-39.pyc +0 -0
  123. package/templates/qoder/scripts/protocol/transports/__pycache__/cli.cpython-39.pyc +0 -0
  124. package/templates/qoder/scripts/protocol/transports/__pycache__/http.cpython-39.pyc +0 -0
  125. package/templates/qoder/scripts/protocol/transports/__pycache__/stdio.cpython-39.pyc +0 -0
  126. package/templates/qoder/scripts/protocol/transports/http.py +7 -1
  127. package/templates/qoder/scripts/validation/metrics/__pycache__/present_board.cpython-39.pyc +0 -0
  128. package/templates/qoder/scripts/validation/metrics/present_board.py +180 -0
  129. package/templates/qoder/settings.json +10 -0
  130. package/templates/root/AGENTS.md +9 -10
@@ -1,6 +1,6 @@
1
1
  # -*- coding: utf-8 -*-
2
2
  """
3
- nexus.adapters —— 各宿主/降级路径的 Cap 实现。
3
+ capability.adapters —— 各宿主/降级路径的 Cap 实现。
4
4
 
5
5
  设计模式: Adapter + Bridge(Cap 抽象 × 宿主实现 正交)
6
6
 
@@ -23,7 +23,7 @@ from __future__ import annotations
23
23
 
24
24
  from typing import Any, Optional
25
25
 
26
- from ..registry_mcp import McpRegistry
26
+ from ..registry_mcp import McpRegistry, _load_servers
27
27
  from protocol.transports import ToolResult
28
28
 
29
29
 
@@ -42,7 +42,7 @@ class McpCap:
42
42
  """L1 MCP 能力统一入口 —— 复用已有 MCP server(禅道/知识图谱/MySQL/蓝湖)。
43
43
 
44
44
  工作流调用:
45
- cap = nexus.resolve()
45
+ cap = resolve()
46
46
  result = cap.mcp.call("search_code", {"keyword": "保险"})
47
47
  # 自动路由:MCP 可用走 MCP,不可用走 wlkj.py(CLI 降级)
48
48
  """
@@ -54,8 +54,9 @@ class McpCap:
54
54
  # spawn 子进程, 不依赖宿主是否原生支持 MCP —— CLI / Codex / Claude 同样能起 server。
55
55
  # 故: 宿主未声明 mcp_servers 或声明为空 = "没有宿主原生限制, 用全部本地可起的"。
56
56
  if mcp_servers: # 非空列表才过滤
57
- from ..registry_mcp import SERVERS
58
- filtered = {k: v for k, v in SERVERS.items() if k in mcp_servers}
57
+ # _load_servers() 而非硬编码 SERVERS —— 这样 mcp_config.json 改配置才生效
58
+ all_servers = _load_servers()
59
+ filtered = {k: v for k, v in all_servers.items() if k in mcp_servers}
59
60
  self._registry = McpRegistry(servers=filtered)
60
61
  else:
61
62
  self._registry = _get_registry()
@@ -117,6 +118,12 @@ class McpCap:
117
118
  "search_wiki": ("kg", ["wiki"]),
118
119
  "fill_prototype": ("kg", ["fill-prototype"]),
119
120
  "get_design_system": ("kg", ["design-system"]),
121
+ # RAG/GraphRAG 降级映射(MCP 挂时走本地 wlkj.py kg search,语义降级为关键词)
122
+ "rag_search": ("kg", ["search"]),
123
+ "ask_corpus": ("kg", ["search"]),
124
+ # 学习工具降级(MCP 挂时本地无 learning 表,返回提示)
125
+ "learn": ("noop", []),
126
+ "get_learnings": ("noop", []),
120
127
  "list_tasks": ("task", ["list"]),
121
128
  "create_task": ("task", ["create"]),
122
129
  "start_task": ("task", ["start"]),
@@ -129,10 +136,16 @@ class McpCap:
129
136
  if entry is None:
130
137
  return None
131
138
  cmd, base_args = entry
139
+ # noop 类工具(learn/get_learnings 等):本地无等价 CLI,返回提示不崩
140
+ if cmd == "noop":
141
+ return json.dumps({"degraded": True, "message": "MCP不可用,该工具(learning)降级跳过"}, ensure_ascii=False)
132
142
  cli_args = list(base_args)
133
- # 从 MCP args 构建命令行参数
134
- if "keyword" in args:
135
- cli_args.append(str(args["keyword"]))
143
+ # 从 MCP args 构建命令行参数。
144
+ # 参数名对齐: 平台 MCP search 工具入参是 query, 引擎命令文档用 keyword。
145
+ # 这里两边都取值, 确保无论上游传哪个都能落到 CLI 查询词上。
146
+ kw = args.get("keyword") or args.get("query")
147
+ if kw is not None:
148
+ cli_args.append(str(kw))
136
149
  if "platform" in args and args["platform"]:
137
150
  cli_args.extend(["--platform", str(args["platform"])])
138
151
  if "role" in args and args["role"]:
@@ -211,128 +224,91 @@ class McpCap:
211
224
 
212
225
 
213
226
  class McpMemoryProvider:
214
- """memory 职责链的 MCP provider —— 接通 kg.duckdb learning_events 表。
227
+ """memory 职责链的 MCP provider —— 接通平台 PG.learning_patterns。
215
228
 
216
- 设计模式: Adapter(把 kg.duckdb 适配成 MemoryCap 契约)
229
+ 设计模式: Adapter(把平台 MCP get_learnings/learn 适配成 MemoryCap 契约)
217
230
 
218
- 职责链位置: 链头优先(available=True),纯 CLI 环境也能用。
219
- mem0/Zep MCP server 更成熟时,可替换为 MCP 版本,接口不变。
231
+ 职责链位置: 链头优先。平台 MCP 可用(has_tool get_learnings)时抢占,
232
+ 复用项目级学习表(PG.learning_patterns,按 token 解析 pid 隔离,跨会话积累)。
220
233
 
221
- 数据源: kg.duckdb learning_events 表(id, ts, dev, event, data)。
222
- 复用 learn_aggregate.py 的写入逻辑,保证 CLI 和 MCP 行为一致。
234
+ 数据源: 平台 MCP 工具 get_learnings / learn(后端 services.knowledge.learn)。
223
235
  """
224
236
 
225
237
  def __init__(self):
226
- self._available: bool | None = None # 懒探测
238
+ self._registry = None # 懒取 MCP 单例(避免 import 时即连后端)
239
+
240
+ def _reg(self):
241
+ """复用 McpCap 同款模块级单例(_get_registry),零重复 spawn。"""
242
+ if self._registry is None:
243
+ self._registry = _get_registry()
244
+ return self._registry
227
245
 
228
246
  @property
229
247
  def available(self) -> bool:
230
- """kg.duckdb 存在且可读写即为可用。"""
231
- if self._available is None:
232
- try:
233
- from foundation.protocol.duckdb_conn import get_db
234
- con = get_db()
235
- con.execute("""CREATE TABLE IF NOT EXISTS learning_events (
236
- id TEXT PRIMARY KEY, ts TEXT NOT NULL, dev TEXT NOT NULL,
237
- event TEXT NOT NULL, data JSON)""")
238
- con.close()
239
- self._available = True
240
- except Exception:
241
- self._available = False
242
- return self._available
248
+ """平台 MCP 可用且 get_learnings 工具在索引中即为可用。
249
+ 全迁 PG 后记忆走平台 get_learnings(PG.learning_patterns,按项目隔离)。
250
+ """
251
+ try:
252
+ return self._reg().has_tool("get_learnings")
253
+ except Exception:
254
+ return False
243
255
 
244
256
  def recall(self, query: str) -> list[dict]:
245
- """语义检索记忆: event data 模糊匹配。"""
257
+ """检索记忆: 取平台学习记录,按 query 模糊过滤 pattern/category。"""
246
258
  if not self.available:
247
259
  return []
248
260
  try:
249
- from foundation.protocol.duckdb_conn import get_db
250
- con = get_db()
251
- rows = con.execute(
252
- """SELECT id, ts, dev, event, data FROM learning_events
253
- WHERE event LIKE '%' || ? || '%' OR data LIKE '%' || ? || '%'
254
- ORDER BY ts DESC LIMIT 20""",
255
- [query, query],
256
- ).fetchall()
257
- con.close()
258
- return [
259
- {"id": r[0], "ts": r[1], "dev": r[2], "event": r[3], "data": r[4]}
260
- for r in rows
261
- ]
261
+ import json as _json
262
+ result = self._reg().call("get_learnings", {"limit": 50})
263
+ text = getattr(result, "text", "") or ""
264
+ data = _json.loads(text) if text else {}
265
+ items = data.get("items", []) if isinstance(data, dict) else []
266
+ q = (query or "").lower()
267
+ out = []
268
+ for it in items:
269
+ hay = "%s %s" % (it.get("category", ""), it.get("pattern", ""))
270
+ if not q or q in hay.lower():
271
+ out.append({
272
+ "event": it.get("category", ""),
273
+ "data": it.get("pattern", ""),
274
+ "ts": it.get("last_seen", ""),
275
+ "dev": ",".join(it.get("source_devs", []) or []),
276
+ })
277
+ return out[:20]
262
278
  except Exception:
263
279
  return []
264
280
 
265
281
  def remember(self, key: str, content: str) -> None:
266
- """写入一条记忆: 插入 learning_events 表。"""
282
+ """写入一条记忆: 调平台 learn(PG.learning_patterns 累加)。"""
267
283
  if not self.available:
268
284
  return
269
285
  try:
270
- import hashlib
271
- import json
272
- import time as _time
273
- # ⚠ 不能 import init_schema! duckdb_conn 故意不导出它 (领域 DDL 留在各域)。
274
- # 旧版 from ...duckdb_conn import init_schema → ImportError → 被下面 except 吞掉
275
- # → INSERT 永不执行 → remember() 静默丢全部写入。
276
- # learning_events 表已由 self.available 的 CREATE TABLE IF NOT EXISTS 保证存在,
277
- # 这里直接 INSERT 即可。
278
- from foundation.protocol.duckdb_conn import get_db
279
- con = get_db()
280
- eid = hashlib.md5(("%s:%s:%s" % (key, content, _time.time())).encode()).hexdigest()[:16]
281
- ts = _time.strftime("%Y-%m-%dT%H:%M:%S")
282
- data = json.dumps({"content": content}, ensure_ascii=False)
283
- con.execute(
284
- "INSERT OR IGNORE INTO learning_events(id, ts, dev, event, data) VALUES (?,?,?,?,?)",
285
- [eid, ts, "", key, data],
286
- )
287
- con.close()
286
+ self._reg().call("learn", {
287
+ "category": "rule",
288
+ "pattern": "%s: %s" % (key, content[:500]),
289
+ "source": "engine/memory",
290
+ })
288
291
  except Exception:
289
- pass
292
+ pass # 写入失败不阻塞
290
293
 
291
294
  def get_fact(self, key: str) -> str | None:
292
- """按 event 精确查找,返回 data 字段(JSON 字符串)。"""
293
- if not self.available:
294
- return None
295
- try:
296
- from foundation.protocol.duckdb_conn import get_db
297
- con = get_db()
298
- row = con.execute(
299
- "SELECT data FROM learning_events WHERE event = ? ORDER BY ts DESC LIMIT 1",
300
- [key],
301
- ).fetchone()
302
- con.close()
303
- if not row:
304
- return None
305
- data = row[0]
306
- if isinstance(data, str):
307
- return data
308
- import json as _json
309
- return _json.dumps(data, ensure_ascii=False) if data else None
310
- except Exception:
311
- return None
295
+ """按 key 取一条事实,无则 None。"""
296
+ results = self.recall(key)
297
+ return results[0].get("data") if results else None
312
298
 
313
299
  def list_recent(self, limit: int = 10) -> list[dict]:
314
- """最近 N 条记忆。"""
300
+ """最近 N 条记忆(平台按 frequency 倒序返回)。"""
315
301
  if not self.available:
316
302
  return []
317
303
  try:
318
304
  import json as _json
319
- from foundation.protocol.duckdb_conn import get_db
320
- con = get_db()
321
- rows = con.execute(
322
- "SELECT id, ts, dev, event, data FROM learning_events ORDER BY ts DESC LIMIT ?",
323
- [limit],
324
- ).fetchall()
325
- con.close()
326
- results = []
327
- for r in rows:
328
- data = r[4]
329
- # DuckDB JSON 列可能返回字符串,需解析
330
- if isinstance(data, str):
331
- try:
332
- data = _json.loads(data)
333
- except (_json.JSONDecodeError, TypeError):
334
- data = {"raw": data}
335
- results.append({"id": r[0], "ts": r[1], "dev": r[2], "event": r[3], "data": data or {}})
336
- return results
305
+ result = self._reg().call("get_learnings", {"limit": limit})
306
+ text = getattr(result, "text", "") or ""
307
+ data = _json.loads(text) if text else {}
308
+ items = data.get("items", []) if isinstance(data, dict) else []
309
+ return [{"event": it.get("category", ""), "data": it.get("pattern", ""),
310
+ "ts": it.get("last_seen", ""), "dev": ",".join(it.get("source_devs", []) or [])}
311
+ for it in items[:limit]]
337
312
  except Exception:
338
313
  return []
314
+