【前端/API/经验管线】E 任务集成与演示准备

[dydpop]

改动内容

• 完成 E 任务主链路前端适配：Dashboard、Knowledge Import、Agent Execution、Wiki、Graph、Self-Evolution Demo、Evolution。
• 保持飞书 interfaces.md 契约不变，前端兼容 WebSocket 新旧格式、执行历史、Wiki/Graph 的 skill_id 联动。
• 收口 Experience Pipeline：稳定 LLM-facing prompts，增加轻量输出归一化，校验 ingest source_type，并将创建失败写入 errors。
• PR 前追加轻量交付修复：Wiki/Graph 重复标签去重，Evolution 使用新版 Ant Design Progress size，避免浏览器 console error。

Graph UI 追加更新

• 优化 Graph 节点标签可读性，保留原有圆形/圆环节点视觉。
• 增加缩放、适配视图按钮，以及力导向布局设置。
• 增加无边节点在可视区域内均匀散布的初始布局，避免节点全部挤在中心。
• 新增 5 个本地 test_graph_* demo skills 和加权关系边，方便在真实关系数据不足时审查吸引/排斥效果。
• 边关系文字改为显示在箭头旁边，并在缩小时自动隐藏、放大后自动出现，降低视觉拥挤。
• 详细审查说明见 docs/modules/06-graph-ui-review-notes.md，也已作为中文 PR 评论补充。

接口兼容说明

• 不修改 docs/interfaces.md 和 docs/architecture.md。
• 不新增强制跨组接口，不要求 A/C/D 立刻改实现。
• E 侧继续按飞书字段消费：ExecutionResult、ExecutionHistoryItem、SystemHealthReport、WebSocket { type, payload, timestamp }。
• /ingest/parse 与 /ingest/parse-and-create 保持现有请求/响应字段；source_type 限定为 trajectory / document / api_doc / script。

测试

• python -m compileall -q skillos\api skillos\layers\input_knowledge
• python -m pytest skillos\tests\test_layers.py -q：40 passed，101 warnings（现有依赖/utcnow deprecation warning）
• npm run build：通过；仍有 Vite large chunk warning（G6/common chunk，非功能阻塞）
• git diff --check：通过，仅有 Windows CRLF 提示
• Ingest API smoke：trajectory / document / api_doc / script 四类 parse 均 success=True、units=1、errors=0
• Playwright browser smoke：/ingest -> /wiki?skill_id=... -> /graph?skill_id=...、/demo、/execution、/evolution、/ 均无页面运行时 error；本地仍有已知 WebSocket dev warning
• Graph smoke：/graph 与 /graph?skill_id=test_graph_design_plan 均通过；边关系文字缩放显隐、布局设置、节点详情面板可用

剩余依赖/风险

• C 侧仍需提供真实 execution history 和 ExecutionResult.retrieved_skills 数据。
• C/D 侧仍需推送真实 WebSocket 事件，供 Dashboard Feed 和轻量刷新使用。
• D 侧仍需补齐真实 health report、repair、evolution cycle 结果。
• A/D 侧补齐真实 Skill 关系边后，Graph 展示会更完整。
• 当前没有 team-test-key，因此 LLM 质量只完成本地 fallback/接口稳定性验证，未声称完成真实模型质量验证。

给组长的说明

这次 PR 的重点是让 E 任务主链路可演示、可联调、可审查；没有改飞书锁定的接口文档，也没有强行要求其他组调整接口。Graph 里的测试图谱数据主要用于本地审查布局和关系展示，如果团队认为不适合进入 main，可以后续单独拆出或删除。

[dydpop]

请审核，看看可不可以 review 一下：

本次主要完成了简单的 E 负责的部分：前端展示、API 适配、Knowledge Import、Wiki/Graph 联动、Self-Evolution Demo、Evolution 页面，以及 Experience Pipeline 收口。

这版没有修改 docs/interfaces.md 和 docs/architecture.md，也没有新增跨组强制接口，主要还是按飞书里文件的已有接口做兼容和展示。

我本地已经完成过这些检查：

• 后端 compileall 通过
• pytest skillos\tests\test_layers.py -q：40 passed
• 前端 npm run build 通过
• git diff --check 通过
• 浏览器检查 /、/demo、/ingest、/wiki、/graph、/execution、/evolution 均无 runtime error

目前我记录到的剩余依赖主要是：

• C 侧真实 execution history 和 ExecutionResult.retrieved_skills
• C/D 侧真实 WebSocket 事件
• D 侧真实 health report、repair、evolution cycle 结果
• A/D 侧真实 Skill 关系边，Graph 展示会更完整

这些依赖暂时不影响 E 侧页面进入和基础展示；E 侧已经做了空状态、错误提示和兼容兜底。

已知非阻塞项：

• 本地开发环境还有一个 WebSocket warning，不过不影响展示，如果需要我调整一下我也可以把它修掉
• Vite 仍有 large chunk warning，主要来自 G6/common chunk
• 目前没有 team-test-key，所以真实 LLM 质量还没有单独验证，本轮验证的是 fallback 和接口稳定性

[dydpop]

Graph UI 审查说明

目的

这份说明用于补充本次 PR 中 Graph 界面的 UI 与交互改动，方便组长审查，也方便后续组内同步。除特别说明外，这些改动都属于前端展示和本地演示辅助，不改变飞书接口契约。

本次改了什么

• 优化节点名称显示，在保留原有圆形/圆环节点视觉的前提下，让节点文字更容易读。
• 在 Graph 画布右上角增加缩放按钮和适配视图按钮，方便检查大图和局部关系。
• 增加力导向布局设置：
  • 排斥力度
  • 吸引力度
  • 连接距离
  • 节点间距
  • 紧凑 / 均衡 / 开放 三组预设
• 增加确定性的初始节点分布逻辑，让没有关系边的节点也能在可视画面内均匀散开，避免堆在中心。
• 新增 5 个本地演示用 test_graph_* Skill 和加权关系边，方便在真实关系数据还不足时审查吸引/排斥效果。
• 优化边关系文字：
  • 关系文字显示在箭头旁边，不再直接压在线上。
  • 文字格式类似 depends on · 0.85。
  • 放大图谱时显示关系文字，缩小图谱时自动隐藏，减少视觉拥挤。

建议审查路径

本地启动前后端后，优先打开这个页面：

http://127.0.0.1:5173/graph?skill_id=test_graph_design_plan

建议重点检查：

• 是否能加载 5 个节点、5 条边的小型测试子图。
• 点击节点后，右侧节点详情面板是否仍然正常。
• 打开“布局设置”，调整排斥力度、吸引力度、连接距离、节点间距后，图谱布局是否有变化。
• 放大图谱后，边关系文字是否出现在箭头旁边。
• 缩小图谱后，边关系文字是否自动消失。
• 点击“返回全图”后，完整图谱是否还能正常加载。

对接口的影响

• 不修改飞书接口契约。
• 不新增前端依赖。
• 不新增强制后端接口。
• 继续沿用现有 /graph 和 /graph/subgraph 能力。
• 本地测试图谱数据只用于当前真实关系数据较少时的审查和演示。

已验证内容

本地已完成基础检查：

npm run build
git diff --check
python -m compileall -q skillos\api
python -m pytest skillos\tests\test_layers.py -q

浏览器冒烟检查通过：

/graph
/graph?skill_id=test_graph_design_plan

Graph 页面检查时，浏览器控制台没有新增运行时错误。当前仍存在的本地 WebSocket warning 是既有非阻塞问题，不是这次 Graph UI 改动引入的。

给审查人的说明

• 这次 Graph UI 改动的目标是让图谱更容易演示和审查，不是重新设计最终视觉风格。
• Graph 的真实丰富度仍然依赖 A/D 或后端后续补齐真实 Skill 关系边。
• 本地演示种子数据只是为了在真实关系边不足时也能检查布局、缩放、边权重和关系文字显示效果。
• 如果团队认为测试图谱种子数据不适合进入 main，可以在后续提交中拆出或删除，不影响前端 Graph 交互本身。