帮助 (Help)

概述

帮助页面是 DeepSeno 内嵌的用户手册与开发者参考。页面以 Markdown 渲染，自动跟随当前界面语言（中 / 英）切换内容。

路由：/help。布局为双栏：左侧目录（章节导航） + 右侧滚动内容。右上角有外链按钮，指向 MCP 协议文档。

如何打开

• 从侧边栏底部的「？/ Help」菜单进入
• 也可以直接访问路由 /help

三大板块

帮助页面分三个主板块，左侧目录可一键跳转：

1. 插件开发（Plugin Development）

讲清楚 DeepSeno 的「插件」机制：

• 插件是什么：JSON 配置 + 指令（instructions） + MCP 工具
• 完整 JSON 格式：插件配置的所有字段
• 三个示例：
  • 纯指令插件（只配 instructions）
  • 纯 MCP 插件（只配 mcp）
  • 混合插件（同时配两者）
• 编写指令的小技巧：角色定位 + 步骤化指令 + 与工具的结合
• 开发 MCP Server：Node.js 实现示例
• 常用图标参考：可用于 page.icon 字段的 lucide-react 图标速查

2. 内置工具（Built-in Tools）

讲清楚不需要插件就能用的能力：

• 17 条内置工具表，每条附触发示例（用户怎么说会触发该工具）
• 工具 vs 插件 的关系说明：内置工具始终可用；插件工具按需安装
• MCP 插件工具命名约定：plugin_<pluginId>_<toolName>

3. FAQ

常见问题与排错：

• 如何安装插件
• 插件启动失败时如何排错
• API Key 如何配置（针对带 env 字段的插件）
• 指令长度建议（≤ 500 字效果最好）
• MCP 调试技巧
• 为什么 AI 没调用我的工具（意图分类、范围过滤）

反馈渠道

如果帮助页面没有覆盖你的问题，可以：

• 在「设置」页面查看版本号与日志路径
• 通过应用菜单的「反馈」入口提交问题
• 参考右上角的 MCP 协议文档外链了解协议细节