@ww_nero/skills 3.2.0 → 3.3.0

package/assets/ppt_prompt.txt

@@ -0,0 +1,25 @@
+制作PPT的完整步骤如下（可根据当前实际状态，跳过部分已经完成的环节）：
+
+1. **规划PPT内容**，存储到markdown文件中：
+   - 每页Slide的规划需要包含：内容、布局方式、插图（只有用户明确提出要求时才添加插图）
+   - 不同页面应尽可能使用不同的布局方式，避免过于单调，可适当使用图表来呈现信息，例如折线图、柱状图、饼状图等；各正文页面标题样式、背景和文字色调**必须保持一致**。
+   - 如果用户未明确提出要求，则页面默认比例为宽1280px、高720px，默认背景为弱渐变的浅灰蓝（#F2F4F7 → #FCFCFC），现代科技感、扁平化风格。
+   - 如果需要插入图片，则按照以下方式：
+     - 收集图片素材，优先使用用户提供的图片；如未提供，则使用图像生成工具生成合适的图片
+     - 将图片素材保存到`images`文件夹中，使用内容和宽高比例作为图片名称，例如`main_background_16_9.png`表示该图片是主背景图，宽高比为16:9；对于用户提供的图片素材，可调用工具解读图片内容
+
+2. **通过SVG代码实现Slides的排版**：
+   - 如需Image，统一使用`rect`或`circle`元素进行占位（必须符合图片宽高比例），占位元素应设置合适的位置，可添加浅色填充或边框以便预览时识别
+   - 如需Icon，优先使用Emoji，其次使用纯SVG代码的方式绘制
+   - 如需Chart，如折线图、柱状图等，应使用纯SVG代码的方式绘制，而不是使用图片占位元素
+   - 每页Slide的保存在一个独立HTML文件中，例如`slide_01.html`、`slide_02.html`等。
+
+3. **把SVG转成PPTX文件**：
+   - 参考snippet工具中提供的`svg_to_pptx`代码示例，编写临时的python脚本，把svg转化成可编辑的pptx文件，不要遗漏任何元素（例如线条、装饰等）
+   - 转化的方法是把svg代码转化成使用python创建pptx中可操作元素的代码，示例中的创建元素的工具函数均可以使用
+   - 同时对于每个slide务必创建单独的create_slide函数，例如`create_slide1`、`create_slide2`等
+   - **不要使用`BeautifulSoup`这种通用的解析元素的方式，而是逐个元素从svg代码转化为python创建元素的代码**
+   - 转换过程中，需要把图片占位元素替换成前面准备的图片素材
+   - 每个页面编写一个单独的python脚本进行转化，最后再写一个python脚本，把所有单页的pptx文件合并成一个。
+
+**注意**：完成后**需要保留**规划文档、html页面文件和python转化脚本，方便进一步根据反馈进行修改

package/assets/video_prompt.txt

@@ -0,0 +1,174 @@
+视频处理的技巧指导
+
+本指南涵盖常见的视频处理场景，所有操作均基于 ffmpeg 命令行工具实现。
+
+---
+
+## 1. 添加字幕
+
+完整流程如下：
+
+**步骤 1：提取音频**
+```bash
+ffmpeg -i input.mp4 -vn -acodec libmp3lame -q:a 2 audio.mp3
+```
+
+**步骤 2：语音转字幕**
+使用 ASR 工具（如 mcp__media__asr）将音频转换为 SRT 字幕文件。
+
+**步骤 3：翻译字幕（可选）**
+如需翻译字幕，可在此步骤对 SRT 文件内容进行语言转换。
+
+**步骤 4：移除原有字幕（如有）**
+```bash
+# 查看视频流信息
+ffprobe -i input.mp4
+
+# 移除内嵌字幕流（保留视频和音频）
+ffmpeg -i input.mp4 -map 0:v -map 0:a -c copy output_no_sub.mp4
+```
+
+**步骤 5：烧录字幕到视频**
+```bash
+# 软字幕（可关闭）
+ffmpeg -i input.mp4 -i subtitle.srt -c copy -c:s mov_text output.mp4
+
+# 硬字幕（烧录到画面）
+ffmpeg -i input.mp4 -vf "subtitles=subtitle.srt:force_style='FontSize=24,FontName=Microsoft YaHei'" -c:a copy output.mp4
+```
+
+---
+
+## 2. 视频剪辑
+
+**截取片段**
+```bash
+# 从第 10 秒开始，截取 30 秒
+ffmpeg -i input.mp4 -ss 00:00:10 -t 00:00:30 -c copy output.mp4
+
+# 精确截取（需重新编码）
+ffmpeg -i input.mp4 -ss 00:00:10 -to 00:00:40 -c:v libx264 -c:a aac output.mp4
+```
+
+**移除片段**
+```bash
+# 保留 0-10s 和 20s-结尾，移除中间 10-20s
+ffmpeg -i input.mp4 -vf "select='not(between(t,10,20))',setpts=N/FRAME_RATE/TB" -af "aselect='not(between(t,10,20))',asetpts=N/SR/TB" output.mp4
+```
+
+**合并视频**
+```bash
+# 创建文件列表 files.txt：
+# file 'part1.mp4'
+# file 'part2.mp4'
+ffmpeg -f concat -safe 0 -i files.txt -c copy output.mp4
+```
+
+**调整速度**
+```bash
+# 2 倍速
+ffmpeg -i input.mp4 -filter:v "setpts=0.5*PTS" -filter:a "atempo=2.0" output.mp4
+```
+
+---
+
+## 3. 视频理解
+
+对于视频内容理解，推荐采用 **抽帧 + 图像理解** 的方式：
+
+**适用范围**
+- 仅适用于短视频（小于 1 分钟）
+- 建议每 5 秒抽取 1 帧
+
+**抽帧命令**
+```bash
+# 每 5 秒抽取 1 帧
+ffmpeg -i input.mp4 -vf "fps=1/5" frame_%03d.png
+
+# 指定起止时间抽帧
+ffmpeg -i input.mp4 -ss 00:00:00 -to 00:01:00 -vf "fps=1/5" frame_%03d.png
+```
+
+**理解流程**
+1. 使用上述命令抽取关键帧
+2. 使用图像理解工具（如视觉模型）逐帧分析
+3. 综合各帧信息得出视频内容理解
+
+---
+
+## 4. 视频生成
+
+视频生成需要专业的 AI 视频生成工具，建议使用：
+
+- **可灵 (Kling)** - 快手旗下视频生成工具
+- **Sora** - OpenAI 视频生成模型
+- **通义万相** - 阿里云视频生成工具
+- **Runway Gen-3** - 专业视频生成平台
+
+当前工具链不支持视频生成功能。
+
+---
+
+## 5. 视频内容编辑
+
+**重要提示：不支持逐帧编辑**
+
+如果需要对视频内容进行逐帧编辑（如使用图像编辑工具修改每一帧），成本极高，不建议执行。原因：
+- 一分钟 30fps 视频有 1800 帧
+- 逐帧编辑耗时耗力，效果难以保证一致性
+
+**替代方案**
+- 使用专业视频编辑软件：Adobe Premiere、DaVinci Resolve、Final Cut Pro
+- 使用 AI 视频编辑工具：Runway、Pika Labs
+
+---
+
+## 6. 其他常用操作
+
+**格式转换**
+```bash
+ffmpeg -i input.avi -c:v libx264 -c:a aac output.mp4
+```
+
+**调整分辨率**
+```bash
+ffmpeg -i input.mp4 -vf "scale=1920:1080" -c:a copy output.mp4
+```
+
+**提取视频（无音频）**
+```bash
+ffmpeg -i input.mp4 -an -c:v copy output.mp4
+```
+
+**添加/替换音频**
+```bash
+ffmpeg -i video.mp4 -i audio.mp3 -c:v copy -c:a aac -map 0:v:0 -map 1:a:0 output.mp4
+```
+
+**生成 GIF**
+```bash
+ffmpeg -i input.mp4 -vf "fps=10,scale=480:-1:flags=lanczos" -t 5 output.gif
+```
+
+**旋转视频**
+```bash
+# 顺时针旋转 90 度
+ffmpeg -i input.mp4 -vf "transpose=1" output.mp4
+```
+
+---
+
+## 能力边界说明
+
+**可以执行的操作**
+- 所有基于 ffmpeg 的视频处理操作
+- 结合 ASR 实现字幕生成
+- 抽帧后进行图像分析
+
+**无法执行的操作**
+- 视频生成（建议使用专业工具）
+- 逐帧内容编辑（成本过高）
+- 复杂特效制作（建议使用 After Effects 等）
+- 实时视频处理
+
+如遇到无法实现的需求，建议使用更专业的视频处理工具。

package/index.js

@@ -82,7 +82,14 @@ const loadJson = (filename) => {
 };
 
 const SNIPPETS = loadJson('snippets.json');
-const GUIDES = loadJson('guide.json');
+
+const loadText = (filename) => {
+  const filePath = path.join(ASSETS_ROOT, filename);
+  return fs.readFileSync(filePath, 'utf8');
+};
+
+const PPT_PROMPT = loadText('ppt_prompt.txt');
+const VIDEO_PROMPT = loadText('video_prompt.txt');
 
 const buildSnippet = (title, workingDirectory) => {
   const entry = SNIPPETS[title];
@@ -109,19 +116,6 @@ const buildSnippet = (title, workingDirectory) => {
   return lines.join('\n');
 };
 
-const buildGuide = (title) => {
-  const entry = GUIDES[title];
-  if (!entry) {
-    const supported = Object.keys(GUIDES).join(', ');
-    throw new Error(`title 仅支持: ${supported}`);
-  }
-
-  const lines = [];
-  lines.push(`【${entry.title}】技能指导`);
-  lines.push(entry.content);
-
-  return lines.join('\n');
-};
 
 const listTools = () => ({
   tools: [
@@ -133,7 +127,7 @@ const listTools = () => ({
         properties: {
           working_directory: {
             type: 'string',
-            description: '工作目录的绝对路径，生成的脚本文件将保存到此目录'
+            description: '工作目录的绝对路径，示例脚本文件将保存到此目录'
           },
           title: {
             type: 'string',
@@ -145,24 +139,27 @@ const listTools = () => ({
       }
     },
     {
-      name: 'guide',
-      description: '返回技能指导说明',
+      name: 'make_ppt',
+      description: '制作PPT的全流程指导说明及注意事项',
       inputSchema: {
         type: 'object',
-        properties: {
-          title: {
-            type: 'string',
-            description: '技能类型，可选: convert_doc_types | make_ppt',
-            enum: Object.keys(GUIDES)
-          }
-        },
-        required: ['title']
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: 'process_video',
+      description: '视频处理的技巧指导',
+      inputSchema: {
+        type: 'object',
+        properties: {},
+        required: []
       }
     }
   ]
 });
 
-const server = new Server({ name: 'skills', version: '3.2.0' }, { capabilities: { tools: {} } });
+const server = new Server({ name: 'skills', version: '3.3.0' }, { capabilities: { tools: {} } });
 
 server.setRequestHandler(ListToolsRequestSchema, async () => listTools());
 
@@ -179,10 +176,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       return { content: [{ type: 'text', text: result }] };
     }
 
-    if (name === 'guide') {
-      const title = args?.title;
-      const payload = buildGuide(title);
-      return { content: [{ type: 'text', text: payload }] };
+    if (name === 'make_ppt') {
+      return { content: [{ type: 'text', text: PPT_PROMPT }] };
+    }
+
+    if (name === 'process_video') {
+      return { content: [{ type: 'text', text: VIDEO_PROMPT }] };
     }
 
     return { content: [{ type: 'text', text: `未知工具: ${name}` }], isError: true };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ww_nero/skills",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "MCP server that returns Python reference snippets and skill guides",
   "main": "index.js",
   "bin": {

package/assets/guide.json

@@ -1,10 +0,0 @@
-{
-  "convert_doc_types": {
-    "title": "转化文档类型",
-    "content": "执行文档类型转化任务（如 PPTX、PDF、DOCX、HTML、PNG 等格式互转）时，可参考以下方法：\n\n## 方法一：使用命令行工具（推荐用于简单场景）\n\n以下工具均已安装，可直接在终端调用：\n\n- **LibreOffice (soffice)**：支持 Office 文档互转\n  - PPTX → PDF: `soffice --headless --convert-to pdf input.pptx --outdir ./output`\n  - DOCX → PDF: `soffice --headless --convert-to pdf input.docx --outdir ./output`\n  - XLSX → PDF: `soffice --headless --convert-to pdf input.xlsx --outdir ./output`\n\n- **Pandoc**：支持多种文档格式转换\n  - Markdown → DOCX: `pandoc input.md -o output.docx`\n  - Markdown → PDF（中文）: `pandoc input.md -o output.pdf --pdf-engine=xelatex -V CJKmainfont=\"Microsoft YaHei\"`\n  - HTML → Markdown: `pandoc input.html -o output.md`\n\n- **LaTeX (pdflatex/xelatex)**：用于高质量 PDF 生成\n  - TEX → PDF: `xelatex input.tex`\n\n## 方法二：编写临时 Python 脚本（推荐用于复杂场景）\n\n参考 `snippet` 工具中提供的转化脚本示例（已验证正确性），编写临时 Python 脚本：\n\n| 转化类型 | snippet 名称 | 说明 |\n|---------|-------------|------|\n| HTML → PNG | `html_to_png` | 使用 Playwright 渲染并截图 |\n| PDF → PNG | `pdf_to_png` | 使用 pdf2image 分页转换 |\n| PPTX → PNG | `pptx_to_png` | 使用 LibreOffice + pdf2image |\n| SVG → PPTX | `svg_to_pptx` | 转化为可编辑的 PPTX 元素 |\n| STEP → STL | `step_to_stl` | 使用 pythonocc-core 转换 |\n| 合并 STL | `combine_stls` | 使用 gmsh 合并多个 STL |\n\n调用示例：使用 `snippet` 工具获取参考代码，如 `snippet({ title: \"pdf_to_png\" })`\n\n## 解读 PPTX 或 PDF 文档\n\n当用户需要解读 PPTX 或 PDF 文档内容时：\n1. 编写临时 Python 脚本，将 PPTX/PDF 转化为 PNG 图片\n2. 对生成的图片进行视觉分析或内容解读\n3. 完成后删除临时脚本和中间文件\n\n## 注意事项\n\n- 临时脚本执行完成后应删除，除非用户明确要求保留\n- Python 环境已全局安装 `playwright`、`pdf2image`、`python-pptx`、`Pillow`、`pythonocc-core`、`gmsh` 等常用库\n- 如需其他库，可使用 `pip install` 安装"
-  },
-  "make_ppt": {
-    "title": "制作PPT",
-    "content": "制作PPT的完整步骤如下（可根据当前实际状态，跳过部分已经完成的环节）：\n\n1. **规划PPT内容**，存储到markdown文件中：\n   - 每页Slide的规划需要包含：内容、布局方式、插图（只有用户明确提出要求时才添加插图）\n   - 不同页面应尽可能使用不同的布局方式，避免过于单调，可适当使用图表来呈现信息，例如折线图、柱状图、饼状图等；各正文页面标题样式、背景和文字色调**必须保持一致**。\n   - 如果用户未明确提出要求，则页面默认比例为宽1280px、高720px，默认背景为弱渐变的浅灰蓝（#F2F4F7 → #FCFCFC），现代科技感、扁平化风格。\n   - 如果需要插入图片，则按照以下方式：\n     - 收集图片素材，优先使用用户提供的图片；如未提供，则使用图像生成工具生成合适的图片\n     - 将图片素材保存到`images`文件夹中，使用内容和宽高比例作为图片名称，例如`main_background_16_9.png`表示该图片是主背景图，宽高比为16:9；对于用户提供的图片素材，可调用工具解读图片内容\n\n2. **通过SVG代码实现Slides的排版**：\n   - 如需Image，统一使用`rect`或`circle`元素进行占位（必须符合图片宽高比例），占位元素应设置合适的位置，可添加浅色填充或边框以便预览时识别\n   - 如需Icon，优先使用Emoji，其次使用纯SVG代码的方式绘制\n   - 如需Chart，如折线图、柱状图等，应使用纯SVG代码的方式绘制，而不是使用图片占位元素\n   - 每页Slide的保存在一个独立HTML文件中，例如`slide_01.html`、`slide_02.html`等。\n\n3. **把SVG转成PPTX文件**：\n   - 参考snippet工具中提供的`svg_to_pptx`代码示例，编写临时的python脚本，把svg转化成可编辑的pptx文件，不要遗漏任何元素（例如线条、装饰等）\n   - 转化的方法是把svg代码转化成使用python创建pptx中可操作元素的代码，示例中的创建元素的工具函数均可以使用\n   - 同时对于每个slide务必创建单独的create_slide函数，例如`create_slide1`、`create_slide2`等\n   - **不要使用`BeautifulSoup`这种通用的解析元素的方式，而是逐个元素从svg代码转化为python创建元素的代码**\n   - 转换过程中，需要把图片占位元素替换成前面准备的图片素材\n   - 每个页面编写一个单独的python脚本进行转化，最后再写一个python脚本，把所有单页的pptx文件合并成一个。\n\n**注意**：完成后**需要保留**规划文档、html页面文件和python转化脚本，方便进一步根据反馈进行修改"
-  }
-}