English | 简体中文
把上游 ppt-master 技能集忠实封装为 DeepSeek Harness (DSH) 插件 —— 逐字节 vendor、零改写、零运行时依赖、可一键同步上游。
上游技能集本身是一个完整的 AI 演示文稿工作流(生成 / 重构 / 美化 PPTX、Brand·Style·Layout·Deck 工作区、原生模板填充)。本包装层不做任何内容改写,只负责把它可靠地装进 DSH:注册技能、暴露生命周期工具、提供 venv 解释器隔离、图形化配置卡片与工具可见范围控制。
- 零改写:vendor 的
skills/ppt-master/与上游 release 逐字节一致,天然通过上游attribution_guard.py完整性门; - 零运行时 npm 依赖:纯 Node 内置模块实现;技能的 Python 依赖由生命周期工具按需安装;
- 可更新:
scripts/sync-upstream.mjs一键同步上游新版本(下载 → 完整性门 → 校验 → 替换 → commit/tag/push); - 解释器可隔离:可选 venv 模式,为上游脚本提供独立解释器,容器场景可落到持久卷;
- 配置图形化:自带客户端半边,DSH「插件」页直接出配置卡片(中英双语),保存免重启生效。
%%{init: {"flowchart": {"wrappingWidth": 320}}}%%
flowchart TB
UP["上游 ppt-master<br/>GitHub · MIT"]:::up
SYNC["scripts/sync-upstream.mjs<br/>下载 → 完整性门 → 替换"]:::tool
VENDOR["skills/ppt-master/<br/>逐字节 vendor(零改写)"]:::artifact
HOST["index.js<br/>ctx.skills · ctx.tools.register"]:::code
CARD["lib/client.js<br/>插件页配置卡片"]:::code
DSH["DeepSeek Harness<br/>2 个技能 · 3 个工具<br/>+ 插件页配置卡片"]:::host
UP --> SYNC --> VENDOR --> HOST --> DSH
CARD --> DSH
classDef up fill:#d9a52122,stroke:#b8860b,stroke-width:1.5px,rx:6,ry:6
classDef tool fill:#4f6ef722,stroke:#4f6ef7,stroke-width:1.5px,rx:6,ry:6
classDef artifact fill:#2f9e7822,stroke:#2f9e78,stroke-width:1.5px,rx:6,ry:6
classDef code fill:#4f6ef722,stroke:#4f6ef7,stroke-width:1.5px,rx:6,ry:6
classDef host fill:#8c959f22,stroke:#8c959f,stroke-width:1.5px,rx:6,ry:6
技能面由 index.js 经 ctx.skills 注册:vendor 的 ppt-master 技能+一个内存合成、不落盘的入口技能 ppt-master-env(解释器路由入口)。DSH 通过 resourceBase 注入技能目录绝对路径,由执行 agent 代入上游约定的 ${SKILL_DIR}——机制等价满足上游 SKILL.md 的硬规则。
| 依赖 | 用途 | 备注 |
|---|---|---|
| DeepSeek Harness | 运行宿主 | 插件本体需 DSH ≥ 0.2.2-rc.1(engines.dsh + 装载期 assertWhenCapable 双重把关)。更早宿主会整插件拒绝装载(三个工具与 vendored 技能都不可用),因为 when 会被静默忽略、范围隔离失效;仍在使用 0.2.1 的用户请停留在 v6.9.0-r2(该版是本仓库最后一个不依赖步骤级 when 的发布) |
| Node.js ≥ 22.12 | 插件与工具运行时 | 纯内置模块,无 npm 依赖;22.12 是装载链路的下限(require(esm)) |
python3 ≥ 3.10(Windows 上 python ≥ 3.10 亦可) |
上游脚本套件与完整性门 | 建议 python3-venv 可用(venv 模式依赖其 ensurepip;仅 POSIX 布局) |
pip3(或 python -m pip / pip) |
安装上游 Python 依赖 | 系统模式按 pip3 → 命中的解释器 -m pip → pip 自动解析;venv 模式下改用 <venv>/bin/pip3,不受 PEP 668 拦截 |
| git / tar | 同步脚本 | 仅同步上游时需要 |
# 方式一:npm(推荐,插件市场同源)
dsh plugin --profile <name> add dsh-ppt-master-wrapper
# 方式二:GitHub 直接安装
dsh plugin --profile <name> add https://github.com/SAXEM1997/dsh-ppt-master-wrapper.git
# 方式三:本地路径 link(开发机)
dsh plugin --profile <name> add link:/path/to/dsh-ppt-master-wrapper方式四——内网镜像(可选,与 GitHub 同源):把上面的 URL 换成内网 GitLab 上本仓库的地址即可。安装后重启会话,ppt-master 技能即对 agent 可见;客户端半边(配置卡片)须宿主重启一次才首次装载——之后保存配置即免重启生效。
npm 版本号提示:包装层修订版形如
6.9.0-r1,在 semver 里属预发布(6.9.0-r1 < 6.9.0)。npm 侧始终把最新版发到latest标签,所以dsh plugin add dsh-ppt-master-wrapper拿到的是最新版;但^6.9.0这类范围不会包含6.9.0-r1,需要锁定时请写全版本号。
升级前请备份个人模板:上游 v6.10.0 起,通过 Create Template 注册的个人模板落在
skills/ppt-master/templates/local/(上游自家.gitignore该路径,属运行时数据而非发布内容)。 它位于插件包内,dsh plugin add升级会随包替换——升级前请把该目录复制到包外。 本仓库的sync-upstream.mjs只保证仓库内同步时保留它,管不到包管理器覆盖插件目录; 发布侧另有prepack哨兵(scripts/check-pack.mjs)确保用户模板不会被带进包体。
- 环境自检:调用
ppt_master_check_env,确认 Python 就绪(python3,Windows 上可能是python)、完整性门通过、Python 依赖已安装。 - 安装 Python 依赖:调用
ppt_master_setup_deps(幂等),或手动pip3 install -r skills/ppt-master/requirements.txt(Windows 上python -m pip install -r …)。 - 配置
.env(按需):上游图像生成脚本需要图像后端配置。在会话工作目录(上游.env查找顺序第 1 位;插件根目录为第 3 顺位兜底)执行cp skills/ppt-master/.env.example .env,按文件内注释填写IMAGE_BACKEND与对应 key/model (也可用进程环境变量提供同样配置)。.env已列入.gitignore;插件工具不读取、不回显其内容。
| 工具 | 参数 | 行为 |
|---|---|---|
ppt_master_info |
无 | 插件版本、上游版本、SKILL_DIR 绝对路径与上游 repo 链接。纯读。 |
ppt_master_check_env |
无 | 环境自检:Python 就绪度(python3,缺失或低于 3.10 时回退达标的 python,并写明实际命中的命令);运行 attribution_guard.py;探测 Python 依赖安装状态;提示 .env 是否存在。只读。 |
ppt_master_setup_deps |
user?、breakSystemPackages? |
幂等安装 requirements.txt(系统模式自动解析安装器),完成后自动复跑自检。唯一有副作用的工具;venv 的创建/删除只发生在它。 |
三个工具均 venv 感知(payload 带 venv 小节;venv.enabled=true 时工具描述追加解释器提示)。user / breakSystemPackages 仅系统模式生效,venv 模式下被忽略并在返回中注明。
插件声明原生 cordis Config,两组键、全部叶子 .volatile()——经插件页卡片保存后走宿主 volatile 快路径,免重启生效(三个工具每轮现读配置,venv.* 与 scope.* 同等;唯一例外是合成入口技能 ppt-master-env 的正文,它是注册期快照,正文自带脚注指向两个实时工具);经 profile cordis.patch.yml 手工编辑则需重启 DSH。两通道等价、先写者为准。
GUI 侧边栏 插件页 → 已安装 → dsh-ppt-master-wrapper → 包详情页配置卡片:venv 三字段(enabled / path / oldPathPolicy)+「工具可见范围」一节+版本信息块,文案中英双语跟随界面语言。memory 模式会话中卡片显式提示"本次不会写入宿主配置"。
| 键 | 取值 | 默认 |
|---|---|---|
venv.enabled |
是否启用 venv 解释器隔离 | false |
venv.path |
venv 目录(绝对路径或 ~ 前缀;相对路径判无效) |
~/.ppt-master/venv |
venv.oldPathPolicy |
改路径后旧 venv 处置:keep / delete |
keep |
- 懒创建:改配置零副作用;创建/删除只发生在
ppt_master_setup_deps。 - 平台:venv 隔离只支持 POSIX 布局(
bin/python3、bin/pip3);Windows 请用系统模式(python回退已支持,见上)。 - 容器建议:把
venv.path显式配置到持久卷(如/dsh-home/.ppt-master/venv)——venv 内符号链接指向容器内绝对路径,跨镜像重建是否可用依赖镜像不变。 - 损坏恢复:删除重建(
rm -rf <venv.path>后重跑setup_deps);半成品(缺bin/pip3)同样删除重建,系统缺 ensurepip 时先装python3-venv。 - 删除安全:自动删除只碰带所有权标记且满足安全条件的旧 venv;
enabled=false不删除任何东西;不要往 venv 目录里放用户数据。两类孤儿目录(无标记 / 有标记无登记)均需手动rm -rf。 - 配置热更新:三个工具每轮现读
venv.*,卡片保存即生效(无需重启);合成入口技能ppt-master-env的正文是注册期快照,改了venv.*后它仍显示旧的路由指引——以其脚注指向的ppt_master_info/ppt_master_check_env输出为准(重启 DSH 可让正文也刷新)。 - 完整判定条件与实现细节见 AGENTS.md §6。
3 个 ppt_master_* 工具默认注册为全局工具。工作区很多且多数与 PPT 无关时,可把它们从无关工作区的工具表里真正移除——走宿主的步骤级可见性(tools.register(def, { when })),不是前端过滤:每个模型步骤宿主都会调 tools.resolve() 逐工具判定,为真才出现在本步工具表。
| 键 | 取值 | 默认 |
|---|---|---|
scope.mode |
global(所有工作区可见) / selected(仅名单内可见) |
global |
scope.workspaceIds |
工作区 id 字符串数组 | [] |
selected 下:会话按「工作区 sessionIds 成员 → 会话 cwd 规范路径」两级判定归属,命中且 id 在名单里才可见——不属于任何工作区的会话也看不到。失败口径(明示收窄意图,答不出来时不静默放宽):注册表未就绪或读取失败、无 cwd、路径未命中、名单为空、判定尚未完成 ⇒ 本步一律不可见(fail-closed),注册表未就绪只 console.warn 一次;配置保存后下一步生效。
宿主下限:scope 依赖步骤级 when(tools.register(def, { when }) + tools.resolve),即 DSH ≥ 0.2.2-rc.1;更早的宿主没有该能力(0.2.1 会静默忽略 when),本版本 engines.dsh 声明下限并在装载期 fail-loud,不会出现"配了 selected 却全可见"的静默失效。
已知限制:只收窄工具不收窄技能条目;判定使用会话的 cwd(宿主在创建时写入,之后一般不变);符号链接的 cwd 首步可能不可见,异步规范化后下一步恢复;隐藏工具的调用会以宿主 UNKNOWN_TOOL 失败(不再有自定义拒绝文案);已删除工作区的 id 被忽略;市场截图 assets/screenshot-1-config-card.png 待重制(卡片新增了可见范围节)。
编辑 profile 的 cordis.patch.yml 追加(字段写全——patch 的 config 是整体替换语义;保存后须重启 DSH):
- id: dsh-ppt-master-wrapper
config:
venv:
enabled: true
path: /dsh-home/.ppt-master/venv
oldPathPolicy: keep
scope:
mode: selected
workspaceIds:
- b6ef89f7-74a6-4e4f-84eb-07581e390020插件升级新增配置字段后,已存在的 patch 条目需比对补全(或直接在卡片上重新保存一次),否则新字段回落默认值。
哪些改动需要重启:
- 卡片保存配置——不需要(volatile 快路径;工具侧立即生效,含
venv.*)。合成入口技能ppt-master-env的正文是注册期快照,保存后不会自己改写——正文自带脚注,实时状态以ppt_master_info/ppt_master_check_env为准; - 只改
lib/client.js——不需要(宿主 stat 轮询热更新,约 500ms); - 改
package.json的dsh.client/exports["./client"]声明面、或手工编辑 profile patch——需要。
卡片没出现 / 不可用,按序排查:① 刚改过 package.json 声明面?→ 重启 DSH(最常见);② 宿主「插件」页是否提供 plugins.bundle.config 槽位;③ 卡片显示「配置通道未接入」=宿主缺 configForms 服务(可选拼装,功能面不受影响);④ 宿主低于 0.2.2-rc.1 → 整插件不装载(不是只丢卡片),升级宿主;仅缺 dsh.client 声明面时才是"无卡片、其余照常"。
其他:插件装载失败并连带技能面消失,通常是 @deepseek-ai/schemastery 解析失败——装好的插件靠裸导入从 profile 的 node_modules 取它(与官方插件同一条路径),故先确认 profile 里确实提升了该包;DSH_NODE_MODULES / DSH_PROFILE_DIR / DSH_HOME 只是 link: 开发形态的兜底,宿主进程里通常为空,不要指望它们(详见 AGENTS.md §3)。入口技能缺失:宿主拒绝不带 resourceBase 的合成候选时仅入口技能缺席,vendor 技能与工具不受影响。
Windows 沙箱宿主:预览服务的 --daemon 不可用(已知上游问题):这类宿主把命令放进不允许进程 breakaway 的 Job Object(含 DSH),confirm_ui / svg_editor / spec_review 的 --daemon 会先打印 pid=…、随后与启动命令一起被回收(锁文件残留,--wait-only 会再起一个)。临时做法是在宿主后台任务里跑前台服务(不加 --daemon,--timeout 0 保持存活):
python <skill>/scripts/confirm_ui/server.py <project> --timeout 0页面与 --wait-only / --shutdown 照常工作。上游跟踪 hugohe3/ppt-master#357;vendor 树逐字节,本仓库不能就地修。
node scripts/sync-upstream.mjs [选项]| 选项 | 语义 |
|---|---|
--ref <tag|branch|commit> |
指定上游 ref(默认:最新语义版本 release tag) |
--repo <url> |
上游仓库 URL(默认 https://github.com/hugohe3/ppt-master.git) |
--refresh |
忽略 .upstream/ 缓存重新下载 |
--confirm-structural |
结构变化已人工确认,强制走自动路径 |
--skip-guard |
跳过 attribution_guard.py 执行(须与 --no-push 或 --dry-run 联用) |
--no-push |
只本地 commit + tag,不推送 |
--dry-run |
只输出将发生的变化 |
流程:解析最新 tag → 下载(或缓存)→ 完整性门 → 结构变化检测 → 自动路径:校验前置于替换 → 替换 skills/ → bump 版本(自动联动改写 lib/client.js 版本常量)→ commit + tag v<version> → push。结构变化 🔴(skill 目录增删、重命名、metadata.version 缺失等)时停下报告(退出码 2,报告写仓库根 sync-report.txt),人工评估后以 --confirm-structural 重跑。
推送凭据:设 DSH_PPT_GITLAB_PAT(GitLab 镜像)或配置 git credential helper;缺失时推送环节以退出码 6 失败并给出指引。
版本策略:package.json version 镜像上游版本(如 6.7.1);仅包装层自身变更追加 -rN 后缀。
退出码:0 成功/最新 · 1 用法 · 2 结构变化待人工 · 3 完整性门失败 · 4 校验失败 · 5 网络/来源失败 · 6 推送失败/tag 冲突 · 7 工具链缺失。
dsh-ppt-master-wrapper/
├── package.json / cordis.patch.yml # DSH 插件清单与 bundle 层补丁
├── index.js # 插件入口
├── lib/ # 客户端半边 / 工具 / venv / skill provider / scope
├── skills/ppt-master/ # ★ 上游 vendor 树(逐字节,零改写)
├── scripts/ # sync-upstream / verify-plugin / check-dsh-compat
├── tests/ # node:test 全套(733 用例)
├── docs/superpowers/ # 设计与计划文档(开发史)
├── .github/ # CI 与 issue/PR 模板
└── README / AGENTS.md / CONTRIBUTING.md / NOTICE / LICENSE
main 受保护,不直接推送。每次改动走 Issue → 分支 → PR → Squash merge;提交信息用约定式前缀。细节见 CONTRIBUTING.md;面向 agent 的机制备忘、测试地图与版本记账见 AGENTS.md。
node scripts/check-dsh-compat.mjs # 契约检查:spec §7.7 六项(+⑦)设计成立性前置
node --test tests/*.test.mjs # 全套测试(本机真实 SDK 环境 731/731(2 条 skip);若存在 `~/.ppt-master/.env`,仅 `envFileExists` 1 例变红)
node scripts/verify-plugin.mjs --upstream .upstream/refs/tags/<ref>@<sha> # 完整性校验(需缓存目录)无宿主 SDK 的机器(含 CI):node tests/helpers/stub-sdk.mjs .ci-stub 建默认 stub 树,以 DSH_NODE_MODULES=$PWD/.ci-stub/node_modules 跑前两条(预期 733/731/2 skip,skip 为显式声明);机制与红灯形态见 AGENTS.md §4,CI 见 .github/workflows/ci.yml。
| 版本(tag) | 说明 |
|---|---|
v6.7.0 |
首次交付:vendor 上游 v6.7.0 + skill provider + 三生命周期工具 + 三脚本 |
v6.7.0-r1 … r2 |
包装层修订(审查修复波:同步脚本健壮性) |
v6.7.0-r3 |
venv 解释器隔离 + 插件页配置卡片 + GitHub 发布面 |
v6.7.1 |
上游同步:vendor v6.7.1(逐字节) |
v6.7.1-r1 |
工具可见范围(scope 双键 + 装配层移除 + guard 兜底) |
v6.7.1-r2 |
审查修复波:scope 运行时加固(safeString / 注入看门狗 / disposed 清理 / 每轮单次刷新)+ 卡片勾选框基值缺失禁用与只读样式 + 契约探针补强 + 单轮严格定位判据 |
v6.7.1-r3 |
venv 配置现读:卡片保存后三个工具立即按新 venv.* 工作,不再读 apply 期快照(设计 R8 / issue #16);配置改坏时保存即告警 |
v6.7.3 |
上游同步:vendor v6.7.3(逐字节)。含 v6.7.2 的「不再静默丢失/覆盖内容」一批修复(skill-only 安装的项目落工作目录、PDF 表格不再按单篇样例重写、HTML/.txt 按声明编码解码、同名批次互不覆盖、图像检索整词匹配、原生图表 part 名冲突、公式 MCE fallback 让 WPS/LibreOffice 不再空白)与 v6.7.3 的 Edit Native 往返修复;另修 verify-plugin 的 baseName 反斜杠兼容(Windows 上第⑥项不再误报) |
v6.8.0 |
上游同步:vendor v6.8.0(逐字节)。AI 图像生成默认换 gpt-image-2.5-sunburst(约 1/4 输出 token、约一半耗时、支持真 RGBA 透明),aspect_ratio 接受任意正 W:H,Retry-After 全后端与 manifest 重排生效;Edit Native 的数据变更图表改为原地 patch(渐变/图例/单点标签等保留),合并单元格表格改任一格不再让 --native-charts-and-tables 失败;PPTX 导入零尺寸几何不再硬失败(无法恢复者保留并报告),作者隐藏内容不再泄漏进源 Markdown/Beautify 清单/重建讲解词;source_to_md 保留 Office Math 为 LaTeX、DOCX 文本与 Word 显示一致、EPUB/ODT/RTF 找回被跳过文本;动画时长按 PowerPoint beat 语义;超链接比较前先 XML 解码;支持的 Python 上限改为 3.14 |
v6.8.0-r1 |
包装层修订(无运行时行为变更):check-dsh-compat 的 guard 探针适配 DSH 0.2.2 的「执行外置」契约——先挂 @deepseek-ai/dsh-tool-executor-native 再按批量 tools.execute 调用,0.2.1 及更早仍走单调用,两代 SDK 均绿;顺手清掉 schemaOf 时代的陈旧文档坐标,并在 AGENTS §3 登记两代执行契约。vendor 树保持 v6.8.0 逐字节 |
v6.8.0-r2 |
scope 运行时两处收口(issue #33):① 注入看门狗 5s → 30s——boot 期注入回调常在 5s 后才到,旧值把正常启动记成「判定未生效、工具处处可见」且永不撤回;② 判定/装层前判活——cannot create effect on inactive context 的真含义是「会话已销毁」(cordis assertActive 只在 fiber.uid === null 时抛),短命子会话(mnemon idle review)不再刷 restrict 安装被宿主拒绝;③ 新增一条 scope 已激活(注入等待 Nms):判定 N 个会话,隐藏 M 个 摘要。默认 global 仍零日志 |
| v6.8.0-r3 | 装载期竞态修复(issue #36):schemastery 的 CJS 构建首行同步 require() ESM-only 的 cosmokit,而宿主以并行 import() 装载插件,同批有插件正在加载 cosmokit 时该 require 抛 ERR_REQUIRE_ESM_RACE_CONDITION,整个插件不装载。现于 require 之前先 await import() 预热 cosmokit,解析锚点落在 schemastery 自身(非提升布局下才不会静默退化)。入口模块因此带顶层 await;预热失败落回原路径。vendor 树保持 v6.8.0 逐字节 |
| v6.8.0-r4 | 环境声明与仓库约定修订:engines.node 由 >=20.0.0 校正为 >=22.12.0(装载链路需 require(esm));CI 兼容 job 改为 node22-compat 并钉死该下限;release 说明格式约定为「严谨总结 + 每 PR 一行 + 中英双语」。无运行时行为变更 |
| v6.9.0 | 上游同步:vendor v6.9.0(逐字节)。Image→PPTX 新增 OCR 文本证据——image_ocr.py scan 把归一化页图 OCR 成可复核文本块(行框、估算字号、取样墨色),文字层成为「去文字底板」之上的原生文本,merge-base 会回读底板、发现文本框内残留文字时以 exit 3 报出;新增 image_layers.py(check 校验图层与页面配准、diff-matte 由页面自身像素导出图层、mono-matte 从色板切单色图形)与 image_normalization.py;profile 不再绑定单一宿主,任意带参考图路径的视觉宿主均可(文本去除默认 -b openai、注册图层默认 -b gemini)。image_gen.py 支持 --gif-frames 生成动态 GIF 与 gpt-image-2.6 系列,每张图按其文件名格式只写一次(.jpg 保留 Gemini 原始 JPEG 字节,不再 PNG 往返留孤儿);旁白新增 --provider openai(gpt-realtime-2.1-mini 走 Realtime WebSocket,替代 2027-01-06 退役的 tts-1/gpt-4o-mini-tts)。覆盖写入修复:导出 -o 指向源 PPTX、source_to_md 输出指向输入(含硬链接别名)均在写盘前拒绝;模板重装改写 Installed-from 行而非叠加。依赖清单 19 条逐字不变(venv 无需重建),另清理 6.8.0 误入 vendor 的 __pycache__ |
| v6.9.0-r1 | npm 渠道与发布可追溯性。package.json 增 publishConfig(钉死 registry.npmjs.org——本机默认 registry 是镜像站,镜像不能发布);双语 README 安装段把 npm 提为方式一,并补 semver 提示(6.9.0-r1 属预发布,^6.9.0 不含它,锁定修订版须写全版本号);维护者手册新增 npm 发布流程。发布改由 .github/workflows/publish.yml 在 CI 侧执行 npm stage publish——维护机出口上行被限到 ~23 KB/s,17.7 MB 的 tarball 传不完(三次实测均中途 ECONNRESET),runner 上行正常;维护者带 2FA npm stage approve 完成发布。该 workflow 现按必填 version 输入检出 refs/tags/v<version> 并断言 package.json.version 与之一致:旧版从触发那一刻的 main 取码,正是这一点让已发布的 6.9.0 与 tag v6.9.0 不是同一棵树;同时对 npm stage publish 启用 --provenance(id-token: write),由 npm 签发把包绑定到 commit 与 workflow 的签名证明。无运行时行为变更 |
| v6.9.0-r2 | 装载期解析回到正路(运行时行为有变):宿主进程里 DSH_HOME / DSH_PROFILE / DSH_PROFILE_DIR 恒为空——它们只由 dsh-shell-env 在每次 shell 调用时现造,dsh-app-boot 的 .env 分层又把 DSH_* 前缀列为 bootstrap-only 直接拒绝;原实现只认这三个环境变量,故 Desktop 直启、或从普通终端启动 dsh 时装载即抛「定位链四级均未命中」,整个插件不启用(即 1 entry did not activate 那一行)。现改为先裸导入 @deepseek-ai/schemastery(装好的插件由 Node 从 profile 的 node_modules 解析,与官方插件同一条路径),未命中才落回 env 定位链——那条链现在只服务 link: 的符号链接开发形态 |
| v6.9.0-r3 | 工具可见范围改用宿主步骤级 when(运行时行为有变;引擎下限抬到 DSH ≥ 0.2.2-rc.1):删除 per-agent tools.restrict 装配层、根 ctx tools.guard 兜底、agent/created 订阅、注入看门狗与复检定时器(净删约 2100 行);三个工具改为 tools.register(def, { when }),由宿主每步 tools.resolve 逐个 await。判定同步、永不抛;global 不读注册表;selected 全程 fail-closed。两级判定:resolveNow(会话成员 + 字符串路径)同步回答本步,未命中且有 cwd 时排一次异步精化(judgeAgent + resolveByPath,单飞 + 2s 节流 + 代际)。缓存按 agent 对象(WeakMap)而非 id:正缓存绑定 cwd、命中依据(member/path)与注册表指纹,no-match 负缓存与注册表指纹绑定(清单变了才重排)。行为差异:隐藏工具被调用由自定义中文解释变为宿主 UNKNOWN_TOOL;0.2.1 及更早整插件拒绝装载(engines.dsh + 装载期 assertWhenCapable 双重把关),仍用 0.2.1 的用户请停留在 v6.9.0-r2。测试 734 → 702(旧机制用例随代码删除,补 when 语义与缓存失效用例) |
| v6.10.0 | 上游同步(规则①):vendor v6.10.0 逐字节(refs/tags/v6.10.0@d8f704b…),lib/client.js 两常量与 package.json.version 联动为 6.10.0;包装层 v6.9.0-r1..r3 按规则①归零。结构变化 0 项(49 files,+2146 −344,无删除、无目录增删);requirements.txt 逐字未变 ⇒ venv 无需重建;SKILL.md 只改 metadata.version,入口技能正文的替换规则仍成立。适配要点:上游本版把「个人模板库」定在 skills/ppt-master/templates/local/<kind_dir>/(上游自家 .gitignore 该路径,release 里从不出现),包装层因此三处配套:sync-upstream.mjs 新增 installSkills() 在替换 vendor 面前暂存并还原该目录(原实现会静默删除用户数据);verify-plugin 第⑥项把它列为唯一面内豁免(运行时数据,不算 vendor 分歧);根 .gitignore 忽略该路径。测试 702 → 705。个人模板库位于插件包内,dsh plugin add 升级会随包替换 ⇒ 升级前请自行备份 |
| v6.10.0-r1 | 系统解释器链路补全(运行时行为有变):check_env 在 python3 缺失时回退 python(先取达标的候选,低于 3.10 的只作最后兜底),payload 新增顶层 pythonCommand,渲染写明实际命中的命令;setup_deps 系统模式按 pip3 → 解析出的解释器 -m pip → pip 解析安装器,且 pip3 只在未报 Python 2、自报 minor 与 check_env/guard 所用解释器一致时采用。个人模板库链路补齐:同步时暂存还原(遗留暂存先归位、与现场并存时合并)、verify-plugin 第⑥项面内豁免、prepack 哨兵拦截个人模板进包体(.npmignore 实测无效)。README 补充 Windows 沙箱宿主下预览服务 --daemon 不可用的替代用法。测试 715 → 733 |
版本规则:
base镜像上游 release,包装层修订追加-rN。逐项明细见 AGENTS.md §5。
- 上游项目:hugohe3/ppt-master(MIT,© 2025-2026 Hugo He)——本包装层的全部能力来自上游技能集,感谢作者的杰出工作。
- 双 LICENSE 归属:插件根
LICENSE为本项目自身的 MIT 许可;vendorskills/ppt-master/LICENSE为上游原文,逐字节保留(受完整性门校验,不得改动)。完整上游版权声明见NOTICE;vendor 内SPONSORS*.md同样逐字节保留,欢迎按上游指引赞助原作者。
MIT,见 LICENSE。