speccore 8.3.333 → 8.3.341

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 (309) hide show
  1. package/.agents/skills/spec-ask/SKILL.md +4 -0
  2. package/.agents/skills/spec-unitize/SKILL.md +9 -1
  3. package/.agents/skills/speccore-router/SKILL.md +12 -11
  4. package/README.en.md +3 -11
  5. package/README.md +3 -13
  6. package/dist/cli.js +64 -206
  7. package/dist/cli.js.map +1 -1
  8. package/dist/commands/analyze.d.ts.map +1 -1
  9. package/dist/commands/analyze.js +530 -481
  10. package/dist/commands/analyze.js.map +1 -1
  11. package/dist/commands/ask.d.ts.map +1 -1
  12. package/dist/commands/ask.js +6 -0
  13. package/dist/commands/ask.js.map +1 -1
  14. package/dist/commands/completion.d.ts.map +1 -1
  15. package/dist/commands/completion.js +9 -7
  16. package/dist/commands/completion.js.map +1 -1
  17. package/dist/commands/doc2spec.d.ts +44 -1
  18. package/dist/commands/doc2spec.d.ts.map +1 -1
  19. package/dist/commands/doc2spec.js +257 -5
  20. package/dist/commands/doc2spec.js.map +1 -1
  21. package/dist/commands/doctor.js +3 -3
  22. package/dist/commands/doctor.js.map +1 -1
  23. package/dist/commands/done.js +1 -5
  24. package/dist/commands/done.js.map +1 -1
  25. package/dist/commands/execute.js +118 -66
  26. package/dist/commands/execute.js.map +1 -1
  27. package/dist/commands/help.js +6 -54
  28. package/dist/commands/help.js.map +1 -1
  29. package/dist/commands/init.d.ts.map +1 -1
  30. package/dist/commands/init.js +71 -47
  31. package/dist/commands/init.js.map +1 -1
  32. package/dist/commands/iteration/create.d.ts.map +1 -1
  33. package/dist/commands/iteration/create.js +72 -10
  34. package/dist/commands/iteration/create.js.map +1 -1
  35. package/dist/commands/iteration/taskify.d.ts.map +1 -1
  36. package/dist/commands/iteration/taskify.js +133 -35
  37. package/dist/commands/iteration/taskify.js.map +1 -1
  38. package/dist/commands/pr.d.ts.map +1 -1
  39. package/dist/commands/pr.js +24 -2
  40. package/dist/commands/pr.js.map +1 -1
  41. package/dist/commands/prompts.d.ts +6 -0
  42. package/dist/commands/prompts.d.ts.map +1 -1
  43. package/dist/commands/prompts.js +19 -10
  44. package/dist/commands/prompts.js.map +1 -1
  45. package/dist/commands/search.js +1 -1
  46. package/dist/commands/search.js.map +1 -1
  47. package/dist/commands/status-panel.d.ts.map +1 -1
  48. package/dist/commands/status-panel.js +23 -34
  49. package/dist/commands/status-panel.js.map +1 -1
  50. package/dist/commands/unitize.d.ts +3 -0
  51. package/dist/commands/unitize.d.ts.map +1 -1
  52. package/dist/commands/unitize.js +32 -9
  53. package/dist/commands/unitize.js.map +1 -1
  54. package/dist/commands/update-env-configs.d.ts.map +1 -1
  55. package/dist/commands/update-env-configs.js +2 -1
  56. package/dist/commands/update-env-configs.js.map +1 -1
  57. package/dist/commands/update.d.ts +4 -0
  58. package/dist/commands/update.d.ts.map +1 -1
  59. package/dist/commands/update.js +41 -1
  60. package/dist/commands/update.js.map +1 -1
  61. package/dist/commands/welcome.d.ts.map +1 -1
  62. package/dist/commands/welcome.js +41 -0
  63. package/dist/commands/welcome.js.map +1 -1
  64. package/dist/core/analyze-engine.js +3 -3
  65. package/dist/core/analyze-engine.js.map +1 -1
  66. package/dist/core/arbitration/l3-human-arbiter.js +1 -1
  67. package/dist/core/arbitration/l3-human-arbiter.js.map +1 -1
  68. package/dist/core/arbitration/verdict-generator.js +1 -1
  69. package/dist/core/arbitration/verdict-generator.js.map +1 -1
  70. package/dist/core/ask-context.d.ts.map +1 -1
  71. package/dist/core/ask-context.js +14 -3
  72. package/dist/core/ask-context.js.map +1 -1
  73. package/dist/core/ask-engine.d.ts.map +1 -1
  74. package/dist/core/ask-engine.js +55 -49
  75. package/dist/core/ask-engine.js.map +1 -1
  76. package/dist/core/code-graph/reporter.d.ts.map +1 -1
  77. package/dist/core/code-graph/reporter.js +3 -12
  78. package/dist/core/code-graph/reporter.js.map +1 -1
  79. package/dist/core/code-graph/requirement-linker.js +1 -1
  80. package/dist/core/code-graph/requirement-linker.js.map +1 -1
  81. package/dist/core/code-scanner.js +1 -1
  82. package/dist/core/code-scanner.js.map +1 -1
  83. package/dist/core/deploy/engine.d.ts.map +1 -1
  84. package/dist/core/deploy/engine.js +58 -44
  85. package/dist/core/deploy/engine.js.map +1 -1
  86. package/dist/core/environment-config.d.ts +13 -0
  87. package/dist/core/environment-config.d.ts.map +1 -1
  88. package/dist/core/environment-config.js +28 -1
  89. package/dist/core/environment-config.js.map +1 -1
  90. package/dist/core/error-diagnosis.js +2 -2
  91. package/dist/core/error-diagnosis.js.map +1 -1
  92. package/dist/core/git-integration.d.ts +5 -7
  93. package/dist/core/git-integration.d.ts.map +1 -1
  94. package/dist/core/git-integration.js +137 -12
  95. package/dist/core/git-integration.js.map +1 -1
  96. package/dist/core/global-knowledge.d.ts.map +1 -1
  97. package/dist/core/global-knowledge.js +25 -11
  98. package/dist/core/global-knowledge.js.map +1 -1
  99. package/dist/core/handoff-generator.d.ts.map +1 -1
  100. package/dist/core/handoff-generator.js +3 -1
  101. package/dist/core/handoff-generator.js.map +1 -1
  102. package/dist/core/index-guard.d.ts.map +1 -1
  103. package/dist/core/index-guard.js +4 -26
  104. package/dist/core/index-guard.js.map +1 -1
  105. package/dist/core/intent-recognition.d.ts +1 -1
  106. package/dist/core/intent-recognition.d.ts.map +1 -1
  107. package/dist/core/intent-recognition.js +68 -68
  108. package/dist/core/intent-recognition.js.map +1 -1
  109. package/dist/core/knowledge-graph.d.ts.map +1 -1
  110. package/dist/core/knowledge-graph.js +6 -4
  111. package/dist/core/knowledge-graph.js.map +1 -1
  112. package/dist/core/name-validator.d.ts.map +1 -1
  113. package/dist/core/name-validator.js +41 -20
  114. package/dist/core/name-validator.js.map +1 -1
  115. package/dist/core/pinyin-initials.d.ts +10 -0
  116. package/dist/core/pinyin-initials.d.ts.map +1 -0
  117. package/dist/core/pinyin-initials.js +44 -0
  118. package/dist/core/pinyin-initials.js.map +1 -0
  119. package/dist/core/prompt-builder.js +1 -1
  120. package/dist/core/prompt-builder.js.map +1 -1
  121. package/dist/core/prompt-plugins/analyze-graph-plugin.js +1 -1
  122. package/dist/core/prompt-plugins/analyze-graph-plugin.js.map +1 -1
  123. package/dist/core/reindex-engine.js +4 -4
  124. package/dist/core/reindex-engine.js.map +1 -1
  125. package/dist/core/skeleton-residue.d.ts +13 -0
  126. package/dist/core/skeleton-residue.d.ts.map +1 -1
  127. package/dist/core/skeleton-residue.js +83 -14
  128. package/dist/core/skeleton-residue.js.map +1 -1
  129. package/dist/core/spec-merger.d.ts.map +1 -1
  130. package/dist/core/spec-merger.js +3 -2
  131. package/dist/core/spec-merger.js.map +1 -1
  132. package/dist/core/state.d.ts +10 -0
  133. package/dist/core/state.d.ts.map +1 -1
  134. package/dist/core/state.js +20 -1
  135. package/dist/core/state.js.map +1 -1
  136. package/dist/core/structured-extractor.d.ts +6 -0
  137. package/dist/core/structured-extractor.d.ts.map +1 -1
  138. package/dist/core/structured-extractor.js +6 -0
  139. package/dist/core/structured-extractor.js.map +1 -1
  140. package/dist/core/task-paths.d.ts +12 -0
  141. package/dist/core/task-paths.d.ts.map +1 -1
  142. package/dist/core/task-paths.js +33 -1
  143. package/dist/core/task-paths.js.map +1 -1
  144. package/dist/core/unified-config.d.ts +7 -1
  145. package/dist/core/unified-config.d.ts.map +1 -1
  146. package/dist/core/unified-config.js +70 -21
  147. package/dist/core/unified-config.js.map +1 -1
  148. package/dist/core/unit-staffing.d.ts +21 -4
  149. package/dist/core/unit-staffing.d.ts.map +1 -1
  150. package/dist/core/unit-staffing.js +59 -12
  151. package/dist/core/unit-staffing.js.map +1 -1
  152. package/dist/core/usage-analytics.js +1 -1
  153. package/dist/core/usage-analytics.js.map +1 -1
  154. package/dist/core/validator.d.ts.map +1 -1
  155. package/dist/core/validator.js +45 -5
  156. package/dist/core/validator.js.map +1 -1
  157. package/dist/core/verify-report-aggregator.d.ts.map +1 -1
  158. package/dist/core/verify-report-aggregator.js +19 -2
  159. package/dist/core/verify-report-aggregator.js.map +1 -1
  160. package/dist/utils/task-utils.d.ts +4 -1
  161. package/dist/utils/task-utils.d.ts.map +1 -1
  162. package/dist/utils/task-utils.js +30 -4
  163. package/dist/utils/task-utils.js.map +1 -1
  164. package/package.json +4 -3
  165. package/templates/deploy-examples.yaml +33 -5
  166. package/templates/html/speccore-ask-explain.html +1 -1
  167. package/templates/html/speccore-ask-guide.html +1 -1
  168. package/templates/html/speccore-ask-match.html +1 -1
  169. package/templates/html/speccore-ask-pipeline.html +1 -1
  170. package/templates/html/speccore-ask-result.html +1 -1
  171. package/templates/html/speccore-help.html +2 -2
  172. package/templates/speccore-yml-example.yml +174 -54
  173. package/templates/verify-spec-example.yaml +66 -1
  174. package/dist/commands/audit.d.ts +0 -12
  175. package/dist/commands/audit.d.ts.map +0 -1
  176. package/dist/commands/audit.js +0 -540
  177. package/dist/commands/audit.js.map +0 -1
  178. package/dist/commands/backup.d.ts +0 -18
  179. package/dist/commands/backup.d.ts.map +0 -1
  180. package/dist/commands/backup.js +0 -102
  181. package/dist/commands/backup.js.map +0 -1
  182. package/dist/commands/baseline.d.ts +0 -13
  183. package/dist/commands/baseline.d.ts.map +0 -1
  184. package/dist/commands/baseline.js +0 -227
  185. package/dist/commands/baseline.js.map +0 -1
  186. package/dist/commands/chain.d.ts +0 -55
  187. package/dist/commands/chain.d.ts.map +0 -1
  188. package/dist/commands/chain.js +0 -501
  189. package/dist/commands/chain.js.map +0 -1
  190. package/dist/commands/clarify.d.ts +0 -17
  191. package/dist/commands/clarify.d.ts.map +0 -1
  192. package/dist/commands/clarify.js +0 -351
  193. package/dist/commands/clarify.js.map +0 -1
  194. package/dist/commands/code-index.d.ts +0 -21
  195. package/dist/commands/code-index.d.ts.map +0 -1
  196. package/dist/commands/code-index.js +0 -193
  197. package/dist/commands/code-index.js.map +0 -1
  198. package/dist/commands/context.d.ts +0 -10
  199. package/dist/commands/context.d.ts.map +0 -1
  200. package/dist/commands/context.js +0 -213
  201. package/dist/commands/context.js.map +0 -1
  202. package/dist/commands/current.d.ts +0 -10
  203. package/dist/commands/current.d.ts.map +0 -1
  204. package/dist/commands/current.js +0 -53
  205. package/dist/commands/current.js.map +0 -1
  206. package/dist/commands/dev.d.ts +0 -18
  207. package/dist/commands/dev.d.ts.map +0 -1
  208. package/dist/commands/dev.js +0 -854
  209. package/dist/commands/dev.js.map +0 -1
  210. package/dist/commands/diff.d.ts +0 -10
  211. package/dist/commands/diff.d.ts.map +0 -1
  212. package/dist/commands/diff.js +0 -160
  213. package/dist/commands/diff.js.map +0 -1
  214. package/dist/commands/global-status.d.ts +0 -9
  215. package/dist/commands/global-status.d.ts.map +0 -1
  216. package/dist/commands/global-status.js +0 -135
  217. package/dist/commands/global-status.js.map +0 -1
  218. package/dist/commands/graph.d.ts +0 -25
  219. package/dist/commands/graph.d.ts.map +0 -1
  220. package/dist/commands/graph.js +0 -523
  221. package/dist/commands/graph.js.map +0 -1
  222. package/dist/commands/handover.d.ts +0 -11
  223. package/dist/commands/handover.d.ts.map +0 -1
  224. package/dist/commands/handover.js +0 -170
  225. package/dist/commands/handover.js.map +0 -1
  226. package/dist/commands/health.d.ts +0 -7
  227. package/dist/commands/health.d.ts.map +0 -1
  228. package/dist/commands/health.js +0 -80
  229. package/dist/commands/health.js.map +0 -1
  230. package/dist/commands/history.d.ts +0 -9
  231. package/dist/commands/history.d.ts.map +0 -1
  232. package/dist/commands/history.js +0 -117
  233. package/dist/commands/history.js.map +0 -1
  234. package/dist/commands/impact.d.ts +0 -12
  235. package/dist/commands/impact.d.ts.map +0 -1
  236. package/dist/commands/impact.js +0 -238
  237. package/dist/commands/impact.js.map +0 -1
  238. package/dist/commands/import.d.ts +0 -19
  239. package/dist/commands/import.d.ts.map +0 -1
  240. package/dist/commands/import.js +0 -673
  241. package/dist/commands/import.js.map +0 -1
  242. package/dist/commands/knowledge.d.ts +0 -6
  243. package/dist/commands/knowledge.d.ts.map +0 -1
  244. package/dist/commands/knowledge.js +0 -94
  245. package/dist/commands/knowledge.js.map +0 -1
  246. package/dist/commands/lifecycle.d.ts +0 -9
  247. package/dist/commands/lifecycle.d.ts.map +0 -1
  248. package/dist/commands/lifecycle.js +0 -288
  249. package/dist/commands/lifecycle.js.map +0 -1
  250. package/dist/commands/merge-check.d.ts +0 -10
  251. package/dist/commands/merge-check.d.ts.map +0 -1
  252. package/dist/commands/merge-check.js +0 -183
  253. package/dist/commands/merge-check.js.map +0 -1
  254. package/dist/commands/notify.d.ts +0 -13
  255. package/dist/commands/notify.d.ts.map +0 -1
  256. package/dist/commands/notify.js +0 -63
  257. package/dist/commands/notify.js.map +0 -1
  258. package/dist/commands/rag-index.d.ts +0 -19
  259. package/dist/commands/rag-index.d.ts.map +0 -1
  260. package/dist/commands/rag-index.js +0 -286
  261. package/dist/commands/rag-index.js.map +0 -1
  262. package/dist/commands/recommend.d.ts +0 -13
  263. package/dist/commands/recommend.d.ts.map +0 -1
  264. package/dist/commands/recommend.js +0 -37
  265. package/dist/commands/recommend.js.map +0 -1
  266. package/dist/commands/refresh.d.ts +0 -21
  267. package/dist/commands/refresh.d.ts.map +0 -1
  268. package/dist/commands/refresh.js +0 -211
  269. package/dist/commands/refresh.js.map +0 -1
  270. package/dist/commands/rollback.d.ts +0 -8
  271. package/dist/commands/rollback.d.ts.map +0 -1
  272. package/dist/commands/rollback.js +0 -113
  273. package/dist/commands/rollback.js.map +0 -1
  274. package/dist/commands/status.d.ts +0 -7
  275. package/dist/commands/status.d.ts.map +0 -1
  276. package/dist/commands/status.js +0 -262
  277. package/dist/commands/status.js.map +0 -1
  278. package/dist/commands/trace.d.ts +0 -12
  279. package/dist/commands/trace.d.ts.map +0 -1
  280. package/dist/commands/trace.js +0 -163
  281. package/dist/commands/trace.js.map +0 -1
  282. package/dist/commands/tracker.d.ts +0 -2
  283. package/dist/commands/tracker.d.ts.map +0 -1
  284. package/dist/commands/tracker.js +0 -28
  285. package/dist/commands/tracker.js.map +0 -1
  286. package/dist/commands/verdict.d.ts +0 -16
  287. package/dist/commands/verdict.d.ts.map +0 -1
  288. package/dist/commands/verdict.js +0 -189
  289. package/dist/commands/verdict.js.map +0 -1
  290. package/dist/commands/workspace.d.ts +0 -20
  291. package/dist/commands/workspace.d.ts.map +0 -1
  292. package/dist/commands/workspace.js +0 -142
  293. package/dist/commands/workspace.js.map +0 -1
  294. package/dist/core/constraint-set.d.ts +0 -67
  295. package/dist/core/constraint-set.d.ts.map +0 -1
  296. package/dist/core/constraint-set.js +0 -151
  297. package/dist/core/constraint-set.js.map +0 -1
  298. package/dist/core/smart-recommend.d.ts +0 -16
  299. package/dist/core/smart-recommend.d.ts.map +0 -1
  300. package/dist/core/smart-recommend.js +0 -149
  301. package/dist/core/smart-recommend.js.map +0 -1
  302. package/dist/core/task-type-registry.d.ts +0 -110
  303. package/dist/core/task-type-registry.d.ts.map +0 -1
  304. package/dist/core/task-type-registry.js +0 -334
  305. package/dist/core/task-type-registry.js.map +0 -1
  306. package/dist/utils/mermaid-render.d.ts +0 -39
  307. package/dist/utils/mermaid-render.d.ts.map +0 -1
  308. package/dist/utils/mermaid-render.js +0 -284
  309. package/dist/utils/mermaid-render.js.map +0 -1
@@ -1,284 +0,0 @@
1
- "use strict";
2
- /**
3
- * mermaid-render — Mermaid 图表渲染工具
4
- * v7.0.0+: 将 .mmd 文件或 Markdown 中的 Mermaid 代码块渲染为 HTML
5
- *
6
- * 用法:
7
- * speccore graph render <file.mmd> 渲染单个 .mmd 文件
8
- * speccore graph render --all 批量渲染 diagrams/ 目录下所有 .mmd
9
- * speccore graph render --extract <file.md> 从 Markdown 提取 Mermaid 并渲染
10
- */
11
- Object.defineProperty(exports, "__esModule", { value: true });
12
- exports.renderMmdFile = renderMmdFile;
13
- exports.renderFromMarkdown = renderFromMarkdown;
14
- exports.renderAllMmdInDir = renderAllMmdInDir;
15
- exports.renderAllMarkdownInDir = renderAllMarkdownInDir;
16
- const fs_extra_1 = require("fs-extra");
17
- const path_1 = require("path");
18
- const logger_1 = require("./logger");
19
- /** HTML 模板 */
20
- const HTML_TEMPLATE = `<!DOCTYPE html>
21
- <html lang="zh-CN">
22
- <head>
23
- <meta charset="UTF-8">
24
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
25
- <title>{{TITLE}}</title>
26
- <script src="https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js"></script>
27
- <style>
28
- * { margin: 0; padding: 0; box-sizing: border-box; }
29
- body {
30
- font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
31
- background: #f5f7fa;
32
- padding: 40px 20px;
33
- min-height: 100vh;
34
- }
35
- .container {
36
- max-width: 1400px;
37
- margin: 0 auto;
38
- }
39
- .header {
40
- background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
41
- color: white;
42
- padding: 30px 40px;
43
- border-radius: 12px;
44
- margin-bottom: 30px;
45
- box-shadow: 0 4px 20px rgba(102, 126, 234, 0.3);
46
- }
47
- .header h1 { font-size: 24px; font-weight: 600; margin-bottom: 8px; }
48
- .header p { opacity: 0.9; font-size: 14px; }
49
- .diagram-card {
50
- background: white;
51
- border-radius: 12px;
52
- padding: 30px;
53
- margin-bottom: 24px;
54
- box-shadow: 0 2px 12px rgba(0,0,0,0.06);
55
- border: 1px solid #e8ecf1;
56
- }
57
- .diagram-card h2 {
58
- font-size: 18px;
59
- color: #1a1a2e;
60
- margin-bottom: 20px;
61
- padding-bottom: 12px;
62
- border-bottom: 2px solid #f0f2f5;
63
- }
64
- .mermaid {
65
- display: flex;
66
- justify-content: center;
67
- padding: 20px 0;
68
- }
69
- .mermaid svg {
70
- max-width: 100%;
71
- height: auto;
72
- }
73
- .meta {
74
- display: flex;
75
- gap: 20px;
76
- margin-top: 16px;
77
- padding-top: 16px;
78
- border-top: 1px solid #f0f2f5;
79
- font-size: 12px;
80
- color: #8898aa;
81
- }
82
- .meta span { display: flex; align-items: center; gap: 6px; }
83
- .empty-state {
84
- text-align: center;
85
- padding: 60px 20px;
86
- color: #8898aa;
87
- }
88
- .empty-state svg { width: 64px; height: 64px; margin-bottom: 16px; opacity: 0.5; }
89
- @media print {
90
- body { background: white; padding: 20px; }
91
- .header { box-shadow: none; border: 1px solid #e8ecf1; }
92
- .diagram-card { box-shadow: none; break-inside: avoid; }
93
- }
94
- </style>
95
- </head>
96
- <body>
97
- <div class="container">
98
- <div class="header">
99
- <h1>{{TITLE}}</h1>
100
- <p>{{SUBTITLE}}</p>
101
- </div>
102
- {{DIAGRAMS}}
103
- </div>
104
- <script>
105
- mermaid.initialize({
106
- startOnLoad: true,
107
- theme: 'default',
108
- securityLevel: 'loose',
109
- fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
110
- flowchart: { useMaxWidth: true, htmlLabels: true, curve: 'basis' },
111
- sequence: { useMaxWidth: true, diagramMarginX: 20, diagramMarginY: 20 },
112
- graph: { useMaxWidth: true },
113
- });
114
- </script>
115
- </body>
116
- </html>`;
117
- /** 单张图表的 HTML 片段 */
118
- const DIAGRAM_CARD_TEMPLATE = `
119
- <div class="diagram-card">
120
- <h2>{{NAME}}</h2>
121
- <div class="mermaid">
122
- {{CODE}}
123
- </div>
124
- <div class="meta">
125
- <span>📄 来源: {{SOURCE}}</span>
126
- <span>📐 类型: {{TYPE}}</span>
127
- <span>🕐 生成: {{TIME}}</span>
128
- </div>
129
- </div>`;
130
- /**
131
- * 渲染单个 .mmd 文件为 HTML
132
- */
133
- async function renderMmdFile(filePath, options = {}) {
134
- if (!await (0, fs_extra_1.pathExists)(filePath)) {
135
- logger_1.logger.error(`文件不存在: ${filePath}`);
136
- return null;
137
- }
138
- const content = await (0, fs_extra_1.readFile)(filePath, 'utf-8');
139
- const fileName = (0, path_1.basename)(filePath, (0, path_1.extname)(filePath));
140
- const title = options.title || fileName;
141
- return generateHtml(title, [{ name: fileName, code: content, source: filePath, type: 'mmd' }]);
142
- }
143
- /**
144
- * 从 Markdown 文件提取 Mermaid 代码块并渲染
145
- */
146
- async function renderFromMarkdown(mdFilePath, options = {}) {
147
- if (!await (0, fs_extra_1.pathExists)(mdFilePath)) {
148
- logger_1.logger.error(`文件不存在: ${mdFilePath}`);
149
- return null;
150
- }
151
- const content = await (0, fs_extra_1.readFile)(mdFilePath, 'utf-8');
152
- const diagrams = extractMermaidFromMarkdown(content, mdFilePath);
153
- if (diagrams.length === 0) {
154
- logger_1.logger.warn(`未在 ${mdFilePath} 中发现 Mermaid 图表`);
155
- return null;
156
- }
157
- const fileName = (0, path_1.basename)(mdFilePath, (0, path_1.extname)(mdFilePath));
158
- const title = options.title || `${fileName} — 图表集`;
159
- return generateHtml(title, diagrams);
160
- }
161
- /**
162
- * 批量渲染目录下所有 .mmd 文件
163
- */
164
- async function renderAllMmdInDir(dirPath, options = {}) {
165
- if (!await (0, fs_extra_1.pathExists)(dirPath)) {
166
- logger_1.logger.error(`目录不存在: ${dirPath}`);
167
- return [];
168
- }
169
- const files = (await (0, fs_extra_1.readdir)(dirPath))
170
- .filter(f => f.endsWith('.mmd'))
171
- .sort();
172
- const results = [];
173
- for (const file of files) {
174
- const filePath = (0, path_1.join)(dirPath, file);
175
- const html = await renderMmdFile(filePath, options);
176
- if (html) {
177
- const outputName = file.replace('.mmd', '.html');
178
- const outputPath = options.outputDir
179
- ? (0, path_1.join)(options.outputDir, outputName)
180
- : (0, path_1.join)(dirPath, outputName);
181
- await (0, fs_extra_1.writeFile)(outputPath, html, 'utf-8');
182
- results.push({ file, output: outputPath });
183
- logger_1.logger.info(` ✓ ${file} → ${outputName}`);
184
- }
185
- }
186
- return results;
187
- }
188
- /**
189
- * 批量渲染目录下所有 Markdown 文件中的 Mermaid
190
- */
191
- async function renderAllMarkdownInDir(dirPath, options = {}) {
192
- if (!await (0, fs_extra_1.pathExists)(dirPath)) {
193
- logger_1.logger.error(`目录不存在: ${dirPath}`);
194
- return [];
195
- }
196
- const files = (await (0, fs_extra_1.readdir)(dirPath))
197
- .filter(f => f.endsWith('.md'))
198
- .sort();
199
- const results = [];
200
- for (const file of files) {
201
- const filePath = (0, path_1.join)(dirPath, file);
202
- const html = await renderFromMarkdown(filePath, options);
203
- if (html) {
204
- const outputName = file.replace('.md', '-diagrams.html');
205
- const outputPath = options.outputDir
206
- ? (0, path_1.join)(options.outputDir, outputName)
207
- : (0, path_1.join)(dirPath, outputName);
208
- await (0, fs_extra_1.writeFile)(outputPath, html, 'utf-8');
209
- results.push({ file, output: outputPath });
210
- logger_1.logger.info(` ✓ ${file} → ${outputName}`);
211
- }
212
- }
213
- return results;
214
- }
215
- /** 从 Markdown 提取 Mermaid 代码块 */
216
- function extractMermaidFromMarkdown(content, sourcePath) {
217
- const diagrams = [];
218
- // 匹配 ```mermaid ... ``` 代码块
219
- const pattern = /```mermaid\n([\s\S]*?)```/g;
220
- let match;
221
- let index = 0;
222
- while ((match = pattern.exec(content)) !== null) {
223
- index++;
224
- const code = match[1].trim();
225
- // 推断图表类型
226
- const type = inferDiagramType(code);
227
- diagrams.push({
228
- name: `图表 ${index} (${type})`,
229
- code,
230
- source: sourcePath,
231
- type,
232
- });
233
- }
234
- return diagrams;
235
- }
236
- /** 推断 Mermaid 图表类型 */
237
- function inferDiagramType(code) {
238
- const firstLine = code.split('\n')[0]?.trim().toLowerCase() || '';
239
- if (firstLine.includes('sequencediagram'))
240
- return '时序图';
241
- if (firstLine.includes('flowchart') || firstLine.includes('graph'))
242
- return '流程图/关系图';
243
- if (firstLine.includes('statediagram'))
244
- return '状态图';
245
- if (firstLine.includes('classdiagram'))
246
- return '类图';
247
- if (firstLine.includes('erdiagram'))
248
- return 'ER 图';
249
- if (firstLine.includes('gantt'))
250
- return '甘特图';
251
- if (firstLine.includes('pie'))
252
- return '饼图';
253
- if (firstLine.includes('journey'))
254
- return '用户旅程';
255
- return '图表';
256
- }
257
- /** 生成完整 HTML */
258
- function generateHtml(title, diagrams) {
259
- const now = new Date().toLocaleString('zh-CN');
260
- const diagramHtml = diagrams.map((d, i) => {
261
- // 对 Mermaid 代码进行 HTML 转义
262
- const escapedCode = d.code
263
- .replace(/&/g, '&amp;')
264
- .replace(/</g, '&lt;')
265
- .replace(/>/g, '&gt;');
266
- return DIAGRAM_CARD_TEMPLATE
267
- .replace('{{NAME}}', d.name)
268
- .replace('{{CODE}}', escapedCode)
269
- .replace('{{SOURCE}}', (0, path_1.basename)(d.source))
270
- .replace('{{TYPE}}', d.type)
271
- .replace('{{TIME}}', now);
272
- }).join('\n');
273
- const subtitle = diagrams.length > 0
274
- ? `共 ${diagrams.length} 张图表 · ${now}`
275
- : `生成时间: ${now}`;
276
- return HTML_TEMPLATE
277
- .replace('{{TITLE}}', title)
278
- .replace('{{SUBTITLE}}', subtitle)
279
- .replace('{{DIAGRAMS}}', diagramHtml || `
280
- <div class="empty-state">
281
- <p>未找到可渲染的图表</p>
282
- </div>`);
283
- }
284
- //# sourceMappingURL=mermaid-render.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"mermaid-render.js","sourceRoot":"","sources":["../../src/utils/mermaid-render.ts"],"names":[],"mappings":"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"}