前言¶

做技术汇报或项目答辩时，常见的做法是把内容丢给模型，让它生成一份 PPT，结果要么页面文字堆叠、要么中文字体回退成方块，导出的 PPTX 格式也常不可编辑。wangzw928/career-pptagent 面向的是另一条路径：本地 Skills + 工作流，先产出 HTML 源稿，再渲染检查、构建可编辑 PPTX、导出复查，最终按 finalize 验收交付。它由 WangZW928 维护，来源是 icip-cas/PPTAgent 的 Skill 版本（基准提交 833cda553b343be0e486a93b0b57cac962cdd566），不是上游官方发行版。

这套插件属于 DSH 的工作流分类，适合需要在 Linux（含 WSL）或 macOS 上批量产出中文技术演示稿、并把流程固定下来的开发者。

这是什么¶

一句话定位：把「HTML 源稿 → 逐页检查 → 可编辑 PPTX → 导出复查 → finalize 验收」这条链封装成 DSH 插件，同时附带一套 concise-business-ppt-style 简洁商业风格规则，默认收敛为白底、深蓝标题、两到三档字号层级。

它解决的问题具体有三个：

1. 中文场景下的字体、换行、回退和页码问题有统一检查项，而不是手工调。
2. 交付物是可编辑 PPTX，不是图片或只读文件。
3. 风格规则内置，模型不需要临场发挥设计，避免口号堆叠和装饰填充。

仓库不包含个人 PPT 或项目数据，只保留通用技能、风格规则和运行工具。上游原始说明和 MIT 许可证保留在 .agents/skills/pptagent/。

核心能力¶

下面这些能力都有文档支撑，不是推测。

本地工作流特化。 统一 Linux / macOS 启动入口，隔离不同平台的运行依赖，保留 HTML 源稿、可编辑 PPTX、逐页渲染检查、导出复查和 finalize 验收流程。

简洁商业风格特化。 通过 concise-business-ppt-style skill 收敛默认设计：白底深蓝、单行摘要标题、少量字号层级、规整对齐、真实证据图，减少宣传式口号与装饰。机制用流程图，结果用真实曲线、表格、云图或代码，不用插画填充空白。保留数据口径、个人贡献边界和实验限制。

平台适配。 支持 DSH 0.2.1-rc.5 / 0.2.1、Node.js 22+、Linux / WSL 与 macOS。Windows 原生环境请用 WSL。插件提供 Host 级技能，无需前端构建，不修改用户的共享技能目录。

绘图与连接能力。 仓库结构里除了核心 PPTAgent skill，还包含 agentdraw（可编辑视觉图解）、opendiagram（架构、流程、时序和 ER 图）、colorfigures（交互式机制插画）、comfyui（ComfyUI 图像生成连接）、paper2any（Paper2Any 工作流连接）、agent-reach（只读内容检索）和 humanizer-zh（中文文案自然化复核）。

安装与启用¶

插件的安装命令来自 README 原文，安装的是发布版的 .tgz。

dsh plugin --profile web add https://github.com/WangZW928/Career-PPTagent/releases/download/v0.1.0/dsh-career-pptagent-0.1.0.tgz

按宿主提示启用插件后，新会话调用 career-pptagent（独立入口），即可选择本插件的简洁商业演示工作流。Desktop 用户请在应用实际使用的 profile 中安装，而不是盲目使用 web。已有项目或用户目录中的同名 pptagent 技能优先，插件不会覆盖它们。

安装插件不会自动下载 Python、Chromium 或其他大体积依赖。首次使用需要先装好系统级前提：LibreOffice 和中文字体，再显式初始化。对于标准 web profile，依次执行：

PLUGIN="${DSH_HOME:-$HOME/.dsh}/profiles/web/node_modules/dsh-career-pptagent"
node "$PLUGIN/plugin/cli.js" setup
node "$PLUGIN/plugin/cli.js" pptagent doctor --workspace "$PWD"
node "$PLUGIN/plugin/cli.js" pptagent init --workspace "$PWD/presentation" --slides 8 --language zh
node "$PLUGIN/plugin/cli.js" pptagent scaffold --workspace "$PWD/presentation"

setup 准备运行环境，doctor 检查环境是否就绪，init 创建任务，scaffold 生成初始 HTML。其他 profile 请替换路径中的 web。

插件模式的本地依赖放在版本隔离的用户缓存里：Linux 默认 ~/.cache/dsh-career-pptagent/0.1.0/<platform>，macOS 默认 ~/Library/Caches/dsh-career-pptagent/0.1.0/<platform>。可以用绝对路径 PPTAGENT_RUNTIME_HOME 覆盖。

如果绘图或 diagram 工作流也需要，补两步初始化：

node "$PLUGIN/plugin/cli.js" setup-illustrations
node "$PLUGIN/plugin/cli.js" setup-opendiagram

插件不自动配置 ComfyUI、Paper2Any 或任何 API 凭据，密钥需要通过运行环境传入。离线运行需要提前完成依赖安装。

典型用法¶

初始化完成后，后续流程由宿主 Agent 编辑 HTML，然后执行逐页检查、构建、导出复查和 finalize，最终以 final-report.json 中 complete=true 作为交付依据。

也可以直接对编码助手说：

使用 pptagent 和 concise-business-ppt-style，制作一份 8 页中文项目答辩 PPT。

原仓库方式（不走插件）也可以跑通，适合想先看效果的场景。先安装依赖并诊断：

bash scripts/setup-pptagent.sh
./bin/pptagent doctor --workspace "$PWD"

再创建任务并生成初始 HTML：

./bin/pptagent init --workspace "$PWD/outputs/presentation" --slides 8 --language zh
./bin/pptagent scaffold --workspace "$PWD/outputs/presentation"

验证环节可以跑完整测试：

source scripts/runtime-env.sh
"$PPTAGENT_PYTHON" -m pytest tests .agents/skills/pptagent/tests

标准验收包括 HTML 渲染、逐页视觉检查、可编辑 PPTX 构建与实际导出检查、中文 glyphs 与字体回退检查、连接器测试，生成物保存在本地 outputs/。

适用场景与注意¶

适合：需要在 Linux / macOS 上产出中文技术汇报、项目答辩或商业演示稿，并且希望可编辑 PPTX 是真实能用的，流程要可复现的团队或个人。仓库明确说明上游许可证为 MIT，其他第三方技能的许可证在各自目录。

需要留意的地方：

1. 插件以当前 dsh 进程权限运行。安装前应检查源码与许可证，确认命令和脚本符合自身环境要求。
2. 插件不自动下载运行时依赖，首次使用必须先装好 LibreOffice 和中文字体，否则 doctor 会报告缺失。
3. Windows 原生暂未支持，只能用 WSL。
4. 项目或用户目录下的同名技能优先于插件，career-pptagent 是显式选择本插件的入口；想强制走插件时要注意命名冲突。
5. 卸载在宿主插件管理页移除即可（CLI 可用 dsh plugin --profile web remove dsh-career-pptagent），不会删除用户 PPT 工作区或版本缓存。
6. 升级版本需要再次初始化新版本缓存，旧缓存不自动删除，也不会自动清理。

结尾¶

这套插件的价值在于把可复现的中文演示稿流程和一套固定风格捆绑在一起，减少了每次重新约定版式和检查口径的成本。目录页在 https://www.skillhub.cn/plugins/WangZW928/Career-PPTagent ，仓库在 https://github.com/WangZW928/Career-PPTagent 。