@civilization/deepseek-genui 1.0.1 → 1.0.2
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.
- package/client.js +13 -2
- package/index.js +39 -3
- package/package.json +2 -2
- package/skills/agent-genui/SKILL.md +10 -8
package/client.js
CHANGED
|
@@ -2515,7 +2515,7 @@ window.__ModuleLoader__.load({
|
|
|
2515
2515
|
/**
|
|
2516
2516
|
* Component: DiffViewer (Git-Style Split/Unified Code Difference)
|
|
2517
2517
|
*/
|
|
2518
|
-
function DiffViewer({ title, oldHeader, newHeader, diffText, lines }) {
|
|
2518
|
+
function DiffViewer({ title, oldHeader, newHeader, diffText, lines, oldCode, newCode, filename }) {
|
|
2519
2519
|
const parsedLines = useMemo(() => {
|
|
2520
2520
|
if (lines && Array.isArray(lines)) return lines;
|
|
2521
2521
|
if (diffText && typeof diffText === 'string') {
|
|
@@ -2525,13 +2525,21 @@ window.__ModuleLoader__.load({
|
|
|
2525
2525
|
return { type: 'same', content: l.startsWith(' ') ? l.slice(1) : l, oldNum: i + 1, newNum: i + 1 };
|
|
2526
2526
|
});
|
|
2527
2527
|
}
|
|
2528
|
+
if (typeof oldCode === 'string' || typeof newCode === 'string') {
|
|
2529
|
+
const oldList = (oldCode || '').split('\n');
|
|
2530
|
+
const newList = (newCode || '').split('\n');
|
|
2531
|
+
const res = [];
|
|
2532
|
+
oldList.forEach((l, i) => res.push({ type: 'del', content: l, oldNum: i + 1, newNum: null }));
|
|
2533
|
+
newList.forEach((l, i) => res.push({ type: 'add', content: l, oldNum: null, newNum: i + 1 }));
|
|
2534
|
+
return res;
|
|
2535
|
+
}
|
|
2528
2536
|
return [
|
|
2529
2537
|
{ type: 'same', content: 'const server = express();', oldNum: 1, newNum: 1 },
|
|
2530
2538
|
{ type: 'del', content: 'server.use(cors({ origin: "*" })); // ⚠️ 存在通配符安全隐患', oldNum: 2, newNum: null },
|
|
2531
2539
|
{ type: 'add', content: 'server.use(cors({ origin: allowedOrigins, credentials: true })); // ✓ 精确放行白名单', oldNum: null, newNum: 2 },
|
|
2532
2540
|
{ type: 'same', content: 'server.listen(port);', oldNum: 3, newNum: 3 },
|
|
2533
2541
|
];
|
|
2534
|
-
}, [lines, diffText]);
|
|
2542
|
+
}, [lines, diffText, oldCode, newCode]);
|
|
2535
2543
|
|
|
2536
2544
|
return h('div', { className: 'dgen-diff-card' },
|
|
2537
2545
|
h('div', { className: 'dgen-node-card-head' },
|
|
@@ -3988,6 +3996,9 @@ window.__ModuleLoader__.load({
|
|
|
3988
3996
|
diffViewer(props) {
|
|
3989
3997
|
return h(DiffViewer, props);
|
|
3990
3998
|
},
|
|
3999
|
+
diff(props) {
|
|
4000
|
+
return h(DiffViewer, props);
|
|
4001
|
+
},
|
|
3991
4002
|
|
|
3992
4003
|
jsonViewer(props) {
|
|
3993
4004
|
return h(JsonViewer, props);
|
package/index.js
CHANGED
|
@@ -7,20 +7,21 @@ export const name = 'deepseek-genui';
|
|
|
7
7
|
export const inject = {
|
|
8
8
|
webServer: { optional: true },
|
|
9
9
|
skills: { optional: true },
|
|
10
|
+
systemPrompt: { optional: true },
|
|
10
11
|
};
|
|
11
12
|
|
|
12
13
|
const vendorRoot = fileURLToPath(new URL('./vendor/', import.meta.url));
|
|
13
14
|
|
|
14
15
|
export async function apply(ctx) {
|
|
15
|
-
// 1. 注册 DSH Agent Skill
|
|
16
|
+
// 1. 注册 DSH Agent Skill 认知协议(按需备用)
|
|
16
17
|
try {
|
|
17
18
|
const skillPath = new URL('./skills/agent-genui/SKILL.md', import.meta.url);
|
|
18
19
|
const skillText = await readFile(skillPath, 'utf8');
|
|
19
20
|
const content = skillText.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, '').trim();
|
|
20
21
|
ctx.effect(() => ctx.skills?.register({
|
|
21
22
|
name: 'agent-genui',
|
|
22
|
-
description: '
|
|
23
|
-
whenToUse: '
|
|
23
|
+
description: '图表可视化与交互组件引擎。生成基于 agent-genui 协议的高保真、交互式卡片、图表与架构可视化界面组件(GenUI),聊天对话流将自动就地渲染。',
|
|
24
|
+
whenToUse: '当需要生成数据大屏、指标看板、趋势图表、流程图、架构拓扑、时序图、生命周期状态机、交互表单、方案对比或需要以可视化界面呈现时使用。',
|
|
24
25
|
source: 'bundled',
|
|
25
26
|
content,
|
|
26
27
|
}));
|
|
@@ -28,6 +29,41 @@ export async function apply(ctx) {
|
|
|
28
29
|
// 容错处理:即使读取 skill 异常也不影响其余服务
|
|
29
30
|
}
|
|
30
31
|
|
|
32
|
+
// 2. 向模型注入常驻 Generative UI 认知,免去调用 skill 工具的额外轮次阻塞
|
|
33
|
+
if (ctx.systemPrompt) {
|
|
34
|
+
ctx.effect(() => ctx.systemPrompt.section({
|
|
35
|
+
name: 'agent-genui-guidance',
|
|
36
|
+
order: ctx.systemPrompt.getSectionOrder?.('STRUCTURED_OUTPUT') ?? 9900,
|
|
37
|
+
text: `
|
|
38
|
+
## 可视化交互卡片 (Generative UI) 协议
|
|
39
|
+
当回复中需要展示以下场景时,**优先输出包裹在 \`\`\`agent-genui 代码块中的结构化 JSON**,聊天界面会自动将其就地渲染为高保真活体交互卡片,严禁仅使用纯文本或 ASCII 字符画替代:
|
|
40
|
+
1. **指标与趋势图表**:KPI 指标看板(type: "metric")、数据图表(type: "chart",chartType 支持 "line" | "bar" | "area" | "pie" | "donut" | "heatmap" | "gauge");
|
|
41
|
+
2. **架构拓扑与流程**:服务分层架构(type: "diagram", diagramType: "architecture")、流程图(diagramType: "flowchart")、时序交互图(diagramType: "sequence");
|
|
42
|
+
3. **方案对比决策**:方案多维评分对比与采纳(type: "comparison");
|
|
43
|
+
4. **数据表格与代码变更**:数据列表(type: "table")、代码变更比对(type: "diffViewer" 或 "diff")、任务流水线(type: "taskPlan")。
|
|
44
|
+
|
|
45
|
+
输出格式规范:
|
|
46
|
+
先输出 1-2 句核心分析结论,紧接着输出代码块:
|
|
47
|
+
\`\`\`agent-genui
|
|
48
|
+
{
|
|
49
|
+
"protocol": "agent-genui",
|
|
50
|
+
"version": "1.0",
|
|
51
|
+
"id": "ui_card_id",
|
|
52
|
+
"title": "卡片标题",
|
|
53
|
+
"layout": { "type": "stack", "gap": "md" },
|
|
54
|
+
"children": [
|
|
55
|
+
{
|
|
56
|
+
"id": "node_1",
|
|
57
|
+
"type": "metric",
|
|
58
|
+
"props": { "title": "指标名称", "value": "12,480", "unit": "req/s", "change": "+18.2%", "changeType": "up" }
|
|
59
|
+
}
|
|
60
|
+
]
|
|
61
|
+
}
|
|
62
|
+
\`\`\`
|
|
63
|
+
`.trim(),
|
|
64
|
+
}), 'genui.systemPrompt()');
|
|
65
|
+
}
|
|
66
|
+
|
|
31
67
|
// 2. 托管本地 Mermaid 等离线静态 Vendor 资源
|
|
32
68
|
if (ctx.webServer) {
|
|
33
69
|
ctx.effect(() => ctx.webServer.register({
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@civilization/deepseek-genui",
|
|
3
|
-
"version": "1.0.
|
|
4
|
-
"description": "Enterprise-ready GenUI panel bundle for DeepSeek Harness (DSH 0.2.
|
|
3
|
+
"version": "1.0.2",
|
|
4
|
+
"description": "Enterprise-ready GenUI panel bundle for DeepSeek Harness (DSH 0.2.2-rc.3) with 7-dimensional component system, offline Mermaid/ReactFlow, and host fault isolation.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "index.js",
|
|
7
7
|
"author": "civilization-os",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: agent-genui
|
|
3
|
-
description:
|
|
4
|
-
whenToUse:
|
|
3
|
+
description: 图表可视化与交互组件引擎。生成基于 agent-genui 协议的高保真、交互式卡片、图表与架构可视化界面组件(GenUI),聊天对话流将自动就地渲染。
|
|
4
|
+
whenToUse: 当需要生成数据大屏、指标看板、趋势图表、流程图、架构拓扑、时序图、生命周期状态机、交互表单、方案对比或需要以可视化界面呈现时使用。
|
|
5
5
|
source: bundled
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -9,13 +9,13 @@ source: bundled
|
|
|
9
9
|
|
|
10
10
|
`@civilization/deepseek-genui` 为 DeepSeek Harness (DSH) 提供了原生的 Generative UI 运行时与聊天流内就地渲染能力。
|
|
11
11
|
|
|
12
|
-
当你输出被
|
|
12
|
+
当你输出被 ```agent-genui 代码块包裹的标准 JSON DSL 时,DSH 聊天流会自动拦截该代码块并原地渲染为高保真、可交互的活体卡片(支持图表 Tooltip 悬停、React Flow 拓扑拖拽与缩放、表单填写、方案采纳提交等)。
|
|
13
13
|
|
|
14
14
|
---
|
|
15
15
|
|
|
16
16
|
## 📌 输出规范(格式与约束)
|
|
17
17
|
|
|
18
|
-
在回复用户时,请先输出简明扼要的结论或文字说明,然后**直接输出包裹在
|
|
18
|
+
在回复用户时,请先输出简明扼要的结论或文字说明,然后**直接输出包裹在 ```agent-genui 代码块中的完整 JSON 描述**:
|
|
19
19
|
|
|
20
20
|
```agent-genui
|
|
21
21
|
{
|
|
@@ -237,15 +237,17 @@ source: bundled
|
|
|
237
237
|
|
|
238
238
|
---
|
|
239
239
|
|
|
240
|
-
### 9. 开发者 UI:代码 Diff 对比(`type: "diff"`)
|
|
241
|
-
支持 Git
|
|
240
|
+
### 9. 开发者 UI:代码 Diff 对比(`type: "diffViewer"` 或 `type: "diff"`)
|
|
241
|
+
支持 Git 级文件修改对比(绿底增加、红底删除),支持传入 `diffText` 或 `oldCode` + `newCode`:
|
|
242
242
|
```json
|
|
243
243
|
{
|
|
244
244
|
"id": "diff1",
|
|
245
|
-
"type": "
|
|
245
|
+
"type": "diffViewer",
|
|
246
246
|
"props": {
|
|
247
247
|
"title": "配置变更审查 (Diff Viewer)",
|
|
248
248
|
"filename": "application-prod.yml",
|
|
249
|
+
"oldHeader": "原配置 (v1.0)",
|
|
250
|
+
"newHeader": "新配置 (v1.1)",
|
|
249
251
|
"oldCode": "server:\n port: 8080\n timeout: 30s\n max-connections: 1000",
|
|
250
252
|
"newCode": "server:\n port: 8080\n timeout: 60s\n max-connections: 5000\n enable-keepalive: true"
|
|
251
253
|
}
|
|
@@ -307,6 +309,6 @@ source: bundled
|
|
|
307
309
|
|
|
308
310
|
## 💡 最佳实践
|
|
309
311
|
|
|
310
|
-
1. **直接输出代码块**:在回答用户时,不需要让用户去哪里搜索或配置,直接给出
|
|
312
|
+
1. **直接输出代码块**:在回答用户时,不需要让用户去哪里搜索或配置,直接给出 ```agent-genui 代码块即可。DSH 聊天前端已装配自动渲染拦截器,能将此代码块就地变为交互式卡片。
|
|
311
313
|
2. **组合使用**:可以使用 `layout: { "type": "stack", "gap": "md" }` 或 `layout: { "type": "grid", "gap": "md" }` 组合多个不同组件(例如:顶部 1 个 `metric` 指标,中间 1 个 `chart` 图表,底部 1 个 `table` 数据表或 `comparison` 方案对比)。
|
|
312
314
|
3. **保持 JSON 语法严谨**:属性名必须用双引号包裹,字符串内部的引号要转义,避免末尾逗号(trailing comma)。
|