PPTAgent · 简洁商业风格 Skills

一套面向中文技术汇报、项目答辩和商业演示的本地 Skills 与工作流。仓库只保留通用技能、风格规则和运行工具，不包含个人 PPT、个人资料或具体项目数据。

上图是发布验收用的合成示例，不包含个人资料；它展示实际导出的 PPTX 页面，不是独立编辑器界面。

来源与定位

本项目的 PPTAgent 来源于 icip-cas/PPTAgent 的 Skill 版本，上游基准提交为 833cda553b343be0e486a93b0b57cac962cdd566。它不是上游官方发行版，也不是另起一个 PPT 生成模型，而是在上游能力之上做了两类特化：

• 本地工作流特化：统一 Linux / macOS 启动入口，隔离不同平台的运行依赖，保留 HTML 源稿、可编辑 PPTX、逐页渲染检查、导出复查和 finalize 验收流程。
• 简洁商业风格特化：通过配套的 concise-business-ppt-style skill，将默认设计收敛为白底深蓝、单行摘要标题、少量字号层级、规整对齐和真实证据图，减少宣传式口号与装饰。

上游 PPTAgent 的原始说明和 MIT 许可证保留在 .agents/skills/pptagent/。其他第三方技能的许可证与说明位于各自目录。

风格特点

• 白底、深蓝标题、浅灰蓝说明栏和细分隔线。
• 中文微软雅黑，英文与数字 Times New Roman；每页通常只有两到三个字号层级。
• 标题直接写清对象、动作或结果，不堆口号和副标题。
• 机制用流程图，结果用真实曲线、表格、云图或代码，不用插画填充空白。
• 保留数据口径、个人贡献边界和实验限制，不为了版面整齐删减关键条件。
• 主线简洁，公式、代码和补充实验放入技术备份。

完整规则见 简洁商业风格 skill 和 版式参考。

DSH 插件安装

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

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（独立入口），即可选择本插件的简洁商业演示工作流。已有项目或用户目录中的同名 pptagent 等技能优先，插件不会覆盖它们。Desktop 用户请在应用使用的实际 profile 中安装，而非盲目使用 web。

安装插件不自动下载 Python、Chromium 或其他大体积依赖。 首次使用先安装 LibreOffice、中文字体和 uv，再运行显式初始化。对于标准 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"

其他 profile 请替换路径中的 web。宿主技能正文会自动附带实际安装路径与 Node 启动命令；即使删除开发仓库，该安装仍可独立工作。完整依赖、验证与卸载说明见 部署指南。

插件模式的本地依赖位于版本隔离的用户缓存（Linux 默认 ~/.cache/dsh-career-pptagent/0.1.0/<platform>；macOS 默认 ~/Library/Caches/dsh-career-pptagent/0.1.0/<platform>）。可用绝对路径 PPTAGENT_RUNTIME_HOME 覆盖；原仓库直接调用 bin/ 仍默认使用项目 .runtime/。

快速开始（原仓库方式）

环境要求与依赖重建见 DEPLOYMENT.md。

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

创建一个 8 页中文任务：

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

随后由宿主 Agent 编辑 HTML，执行逐页检查、构建、导出复查和 finalize。也可以直接对编码助手说：

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

仓库结构

.agents/skills/pptagent/                 上游 PPTAgent Skill 与本地工作流
.agents/skills/concise-business-ppt-style/ 简洁商业风格规则
.agents/skills/humanizer-zh/             中文文案自然化复核
.agents/skills/agentdraw/                可编辑视觉图解
.agents/skills/opendiagram/              架构、流程、时序和 ER 图
.agents/skills/colorfigures/             交互式机制插画
.agents/skills/comfyui/                  ComfyUI 图像生成连接
.agents/skills/paper2any/                Paper2Any 工作流连接
.agents/skills/agent-reach/              只读内容检索
bin/                                   跨平台统一启动入口
scripts/                               通用安装、运行和绘图脚本
tests/                                 运行环境与连接器测试

绘图能力的用途和配置方法见 ILLUSTRATIONS.md。运行依赖、生成稿、密钥和本地输出不进入版本控制。