Jishu Hub Capabilities

---
name: jishu-hub-capabilities
description: 在 Jishu Hub 会话中向用户呈现内容前必读——图表/流程图/框架/关系图直接输出 mermaid 代码块、网页/原型输出 html 代码块（会话界面原生渲染，无需生成文件）；HTML 交付文件预览用 preview_html 工具；MCP 工具与 skill 的调用指引。
---

# Jishu Hub 会话能力指南

你在 Jishu Hub 桌面应用的会话中工作。会话界面本身就能渲染富内容：
很多「画个图给我看看」的需求**不需要生成任何文件、不需要调用任何工具**，
直接在回复中输出对应代码块即可。本文件按场景给出最佳通道选择。

## 快速决策表

| 用户想要 | 通道 | 动作 |
|---|---|---|
| 流程图 / 故事框架 / 架构图 / 关系图 / 时序图 | 会话内 mermaid 块 | 回复中直接输出 ` ```mermaid ` 代码块 |
| 网页 demo / 交互原型 / 单文件小页面 | 会话内 html 块 | 回复中直接输出 ` ```html ` 代码块 |
| 已交付的 HTML 文件看实际效果 | preview_html 工具（仅机枢 agent） | 写文件后调用 preview_html |
| 结构化外部能力（数据库、API、内部系统等） | MCP 工具（仅机枢 agent） | 直接调用 `插件id__` 前缀的工具 |
| 已沉淀的可复用流程 | skill | read 对应 SKILL.md 后按指引执行 |

## 会话内直接渲染（首选：零文件、零工具调用）

### mermaid 代码块

- 会话界面把 ` ```mermaid ` 代码块**直接渲染成图**（可放大、可导出 PNG/SVG）。
- **用户要「画图 / 绘制框架 / 流程 / 关系」时，这就是默认通道。**
  不要为展示图表生成 HTML 文件或网页包装——那会多一次文件落盘且失去会话内交互。
- 常用图型：`flowchart TD`（流程/框架）、`sequenceDiagram`（时序）、
  `graph LR`（关系）、`stateDiagram-v2`（状态）、`gantt`（排期）、`mindmap`（脑图）。
- 最佳实践：节点文案保持简短，长文案用 `<br/>` 折行；单图节点建议 ≤ 30 个，
  内容更多时按模块拆成多张图；中文直接可用，无需转义。

### html 代码块

- 会话界面把 ` ```html ` 代码块渲染成**实时预览卡**（脚本可执行、高度自适应、可放大阅读）。
- 适用：单文件页面 demo、交互原型、小型可视化组件、效果演示。
- 约束：CSS/JS 全部内联，不引用外部网络资源；输出完整文档或自包含片段。

## HTML 文件预览（preview_html，仅机枢 agent）

两种模式**按场景严格选择**：

- **前端项目开发（url 模式，首选）**：项目跑在 dev server 上（vite/webpack 等）时，
  先用 shell 启动并确认端口，再调 preview_html 传 `url`（如 `http://localhost:5173`）——
  预览面板直连 dev server，外链 CSS/JS、热更新全部正常。
  **不要用文件模式预览多文件项目**（外链样式加载不到），**更不要为预览把 CSS/JS 内联进单文件**。
- **自包含单文件交付物（file 模式）**：你开发/修改了单文件 HTML（登录页、报告页、
  单文件应用）时传 `file` 路径。同一文件多次修改后可再次调用刷新；纯后端产物不要调用。
- **不适用：纯图表展示。** 图表直接用 ` ```mermaid ` 块。
- url 仅限本机回环地址（localhost / 127.0.0.1）。

## MCP 工具调用（仅机枢 agent）

- Hub 的 MCP 解析服务把 MCP 插件的工具以 `插件id__工具名` 前缀暴露。
  **优先直接调用这些结构化工具**：无需 shell、不要自行拼接命令行。
- 未在会话勾选的 MCP 服务同样经解析服务在线可用，按同样的前缀规则发现即可。

## Skill 使用

- Hub 分发的 skill 位于你的 skill 目录，系统提示词的 available_skills
  清单里列有名称与描述。
- 当任务与某个 skill 的描述匹配时，用 read 工具读取其 SKILL.md，按指引执行。