@cola1900/dsh-ppt 0.1.3 → 0.2.1

package/README.md

@@ -3,7 +3,7 @@
 从 [dataelement/dsh-desktop](https://github.com/dataelement/dsh-desktop) 提取的独立 **DSH / DeepSeek Harness 插件**。一个包包含 PPT 按钮、模板选择、PPTD 编写与校验、预览和可编辑 PPTX 导出，无需 Electron 或原 Desktop 仓库。
 
 - 16 套模板、192 个版式，保留英文/中文 PPTD 示例和本地预览图。
-- 仅在会话启用 PPT 模式时自动注入创作指引。
+- 提供原生 DSH **PPT 预设**；只有选择该预设时才注入 PPT 创作指引。
 - 保留原有文件授权、路径限制、写入哈希检查、版本记录和导出校验。
 - 提供 `dsh-pptd` 命令行和 `@cola1900/dsh-ppt/pptd` JavaScript API。
 
@@ -17,9 +17,9 @@
 dsh plugin --profile web add @cola1900/dsh-ppt
 ```
 
-把 `web` 替换为实际 profile，然后重启该 profile。新会话中点击输入框底部工具栏的 **PPT**，在输入框下方选择模板，再描述需求。选中后面板收起，按钮以灰黑色选中态显示模板名，不常驻显示模板缩略图。过长的模板名显示省略号，悬停可查看完整名称。再次点击可更换模板或退出 PPT 模式；仅打开、关闭面板不会改变当前模式。
+把 `web` 替换为实际 profile，然后重启该 profile。新会话顶部的原生预设选择器会出现 **PPT**；选择后，输入框下方显示模板面板，在首次发送前选择模板，再描述需求。首次发送后预设和模板固定，新会话可以重新选择。插件首次启动会把内置 preset 写入 `$DSH_HOME/.agent-presets/ppt`，无需手动复制或配置。
 
-界面使用官方 `conversation.input.left` 和 `conversation.input.dock` 插槽，只设置插件自身样式，不修改原 DSH。模板面板始终在输入框下方，列表内部可滚动；窗口较矮时可滚动页面，不会自动翻到上方。
+界面只使用官方 `conversation.input.dock` 插槽，只设置插件自身样式，不修改原 DSH。模板名称继续在卡片内显示省略号，输入框底部不再显示 `PPT · 模板名` 控件。
 
 如果目标 Desktop 已内置 `dsh-ppt-composer`，先在目标 profile 的插件配置中停用原 PPT bundle，再加载本包。不要同时启用两套 PPT bundle，否则会重复注册工具、路由和输入框按钮。本包已经合并 composer，无需再安装 `dsh-ppt-composer`。
 
@@ -40,7 +40,7 @@ dsh-pptd render /path/to/deck -o /path/to/output.pptx --json
 
 ## 开发
 
-`lib/` 是上游维护的 JavaScript 运行时代码；`src/client.js` 是输入框客户端的构建输入。完整原始 TypeScript 源码不在上游提取基线中，本项目没有把声明文件冒充实现源码。
+`lib/` 是上游维护的 JavaScript 运行时代码；`src/client.js` 是输入框客户端的构建输入。`presets/ppt/` 是随插件安装的原生 Agent Preset 定义，首次启动会同步到 DSH 的用户 preset 根目录。完整原始 TypeScript 源码不在上游提取基线中，本项目没有把声明文件冒充实现源码。
 
 `skills/dsh-ppt/references/` 保存模板元数据、设计说明、双语源文件和预览。修改元数据或预览后执行 `npm run build`，生成模板目录、预览白名单和客户端预览映射。构建使用已随包保存的预览，不依赖网络或原桌面工程。修改版式后可用 `dsh-pptd screenshot` 重新生成图片，再更新对应的 JPG 预览。
 

package/UPSTREAM.md

@@ -8,7 +8,7 @@
 - 模板：`packages/ppt-runtime/templates/`
 - 模板许可证与来源资料：`packages/ppt-runtime/upstream/`
 
-独立化改动：合并核心和 composer 为单个 `dsh-ppt` 包；客户端模块标识统一为 `dsh-ppt`；将 Desktop 专有输入框插槽替换为官方 `conversation.input.left` 和 `conversation.input.dock`，按钮放在输入框底部工具栏，模板面板始终在输入框下方展开，选中后收起并在按钮显示模板名；移除常驻的选中缩略图，区分收起面板和退出 PPT 模式；移除指向缺失文件的 `client-standard` 导出，并使用匹配实际客户端的类型声明；将构建改为读取包内模板、生成目录和预览白名单；移除未使用的 TypeScript、Zod 运行依赖；增加独立安装、打包说明及运行验证。
+独立化改动：合并核心和 composer 为单个 `dsh-ppt` 包；客户端模块标识统一为 `dsh-ppt`；改用 DSH 原生 Agent Preset，随包提供 `presets/ppt/` 并在首次启动时同步到用户 preset 根目录；模板面板只在 PPT 预设的空白会话中通过官方 `conversation.input.dock` 插槽显示，首次发送后固定预设和模板；移除输入框底部 `PPT · 模板名` 控件；移除常驻的选中缩略图；移除指向缺失文件的 `client-standard` 导出，并使用匹配实际客户端的类型声明；将构建改为读取包内模板、生成目录和预览白名单；移除未使用的 TypeScript、Zod 运行依赖；增加独立安装、打包说明及运行验证。
 
 输入框布局只通过插件自身 CSS 和标准会话插槽实现，不修改原 DSH 源码或宿主元素样式。
 

package/cordis.patch.yml

@@ -6,3 +6,4 @@
       name: '@cola1900/dsh-ppt'
       config:
         root: !!js dshHomePath('kimi-ppt')
+        presetRoot: !!js dshHomePath('.agent-presets')

package/lib/client.js

@@ -30,21 +30,9 @@ window.__ModuleLoader__.load({
 			tag.dataset.plugin = "dsh-ppt";
 			tag.dataset.pluginCss = tagId;
 			tag.textContent = css + `
-.dsh-ppt-control{display:inline-flex;align-items:center;flex:none;min-width:0}
-.dsh-ppt-trigger{box-sizing:border-box;display:inline-flex;align-items:center;gap:6px;max-width:220px;min-height:30px;padding:5px 9px;border:1px solid transparent;border-radius:8px;background:transparent;color:var(--dsw-alias-label-secondary,#626875);font:inherit;font-size:12px;line-height:18px;cursor:pointer}
-.dsh-ppt-trigger:hover,.dsh-ppt-trigger[aria-expanded=true]{background:var(--dsw-alias-interactive-bg-hover,#f3f4f6)}
-.dsh-ppt-trigger[data-selected=true]{color:var(--dsw-alias-label-primary,#20232a);background:var(--dsw-alias-interactive-bg-hover,#f3f4f6)}
-.dsh-ppt-trigger-mode{flex:none;white-space:nowrap}
-.dsh-ppt-trigger-label{min-width:0;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}
-.dsh-ppt-trigger .desktop-ppt-icon{width:16px;height:16px;flex:none}
-.dsh-ppt-chevron{font-size:10px;flex:none;opacity:.7}
 .dsh-ppt-panel{order:1;align-self:center;display:flex;flex-direction:column;flex-shrink:0;margin:0;padding:0;box-sizing:border-box;width:calc(100% - 2 * var(--dsh-composer-side-clearance,16px));max-height:400px;overflow:hidden;border:1px solid var(--dsw-alias-border-l2-darkmode-thin,#e4e6eb);border-radius:14px;background:var(--dsw-alias-bg-base,#fff);color:var(--dsw-alias-label-primary,#20232a);box-shadow:0 12px 40px #0000001a,0 2px 8px #00000008;font:13px/1.5 var(--font-sans,system-ui,sans-serif)}
 .dsh-ppt-panel-header{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:14px 16px 8px;flex:none}
 .dsh-ppt-panel-title{font-size:14px;font-weight:600;margin:0}
-.dsh-ppt-panel-actions{display:flex;align-items:center;gap:8px}
-.dsh-ppt-exit,.dsh-ppt-close{border:0;background:transparent;color:var(--dsw-alias-label-secondary,#626875);font:inherit;cursor:pointer;border-radius:6px;padding:4px 8px}
-.dsh-ppt-close{font-size:20px;line-height:20px;padding:2px 7px}
-.dsh-ppt-exit:hover,.dsh-ppt-close:hover{background:var(--dsw-alias-interactive-bg-hover,#f3f4f6)}
 .dsh-ppt-panel ._2S_x-q_categoryTabs{padding:0 12px 10px;flex:none;border-bottom:1px solid var(--dsw-alias-border-l2-darkmode-thin,#eceef1)}
 .dsh-ppt-panel ._2S_x-q_categoryTabs button{font-size:12px;padding:4px 9px}
 .dsh-ppt-panel ._2S_x-q_categoryTabs button[data-selected=true]{color:var(--dsw-alias-label-primary,#20232a);background:var(--dsw-alias-interactive-bg-hover,#f3f4f6)}
@@ -55,10 +43,10 @@ window.__ModuleLoader__.load({
 .dsh-ppt-panel ._2S_x-q_templateName{font-size:12px;text-align:left;padding:6px 2px 0;width:100%;box-sizing:border-box}
 .dsh-ppt-panel ._2S_x-q_previewViewport{border-radius:8px}
 .dsh-ppt-selected{position:absolute;top:8px;right:8px;z-index:3;display:grid;place-items:center;width:20px;height:20px;border-radius:50%;background:var(--dsw-alias-label-primary,#20232a);color:var(--dsw-alias-bg-base,#fff);font-size:12px;box-shadow:0 1px 4px #0002;pointer-events:none}
-.dsh-ppt-trigger:focus-visible,.dsh-ppt-panel button:focus-visible{outline:2px solid var(--dsw-alias-label-primary,#20232a);outline-offset:2px}
+.dsh-ppt-panel button:focus-visible{outline:2px solid var(--dsw-alias-label-primary,#20232a);outline-offset:2px}
 .dsh-ppt-panel button:disabled{cursor:wait;opacity:.55}
 .dsh-ppt-panel-notice{margin:0 16px 8px;color:var(--dsw-alias-label-secondary,#626875);font-size:12px}
-@media(max-width:600px){.dsh-ppt-panel ._2S_x-q_templateGrid{grid-template-columns:repeat(2,minmax(0,1fr))}.dsh-ppt-trigger{max-width:170px}}
+@media(max-width:600px){.dsh-ppt-panel ._2S_x-q_templateGrid{grid-template-columns:repeat(2,minmax(0,1fr))}}
 `;
 			document.head.appendChild(tag);
 		}
@@ -418,57 +406,29 @@ window.__ModuleLoader__.load({
 				]
 			});
 		}
-		/** The picker is independent of PPT activation; closing it never changes the session. */
-		function OfficePptChooser({ client, mode, sessionId, t, placement }) {
+		/** Template picker shown only for the native PPT agent preset. */
+		function OfficePptChooser({ client, mode, sessionId, t }) {
 			const state = useMode(mode, sessionId);
-			const open = state.pickerOpen;
-			const setOpen = value => mode.setPickerOpen(sessionId, value);
 			const [category, setCategory] = react.useState("all");
-			const panel = react.useRef(null);
-			const panelId = `dsh-ppt-picker-${encodeURIComponent(sessionId)}`;
-			const triggerId = `${panelId}-trigger`;
-			const active = state.activeMode === "ppt";
-			const selected = state.templates.find(template => template.id === state.selectedId);
-			const label = active && selected ? `${t("mode.label")} · ${selected.name}` : t("mode.label");
-			const close = () => { setOpen(false); document.getElementById(triggerId)?.focus({ preventScroll: true }); };
 
 			react.useEffect(() => {
-				if (placement !== "trigger" || mode.snapshot(sessionId).loading || state.templates.length > 0 || state.error !== "") return;
+				if (mode.snapshot(sessionId).loading || state.templates.length > 0 || state.error !== "") return;
 				mode.setLoading(sessionId, true);
 				loadTemplateState(client, t("templates.loadTimeout")).then(next => {
 					mode.setTemplates(sessionId, next.templates);
 					const template = next.templates.find(item => item.id === next.selectedTemplateId);
-					const activeMode = next.presentationMode === "ppt" ? "ppt" : null;
-					if (template) mode.select(sessionId, template, activeMode);
-					else mode.deselect(sessionId, activeMode);
+					if (template) mode.select(sessionId, template, "ppt");
+					else mode.deselect(sessionId, "ppt");
 					mode.setNotice(sessionId, next.templateMigration?.reason === "template-retired");
 				}).catch(reason => mode.setError(sessionId, reason instanceof Error ? reason.message : String(reason)));
-			}, [client, mode, sessionId, placement, state.loading, state.templates.length, state.error, t]);
-
-			react.useLayoutEffect(() => {
-				if (!open || placement !== "panel") return;
-				panel.current.querySelector('[data-office-ppt-template-viewport] button[aria-pressed="true"], [data-ppt-category]')?.focus({ preventScroll: true });
-			}, [open, placement]);
+			}, [client, mode, sessionId, state.loading, state.templates.length, state.error, t]);
 
 			const choose = async template => {
-				if (state.loading) return;
-				if (active && template.id === state.selectedId) { close(); return; }
+				if (state.loading || template.id === state.selectedId) return;
 				mode.setLoading(sessionId, true);
 				try {
 					await client.call("template/select", { templateId: template.id, mode: "ppt" });
 					mode.select(sessionId, template, "ppt");
-					close();
-				} catch (reason) {
-					mode.setError(sessionId, reason instanceof Error ? reason.message : String(reason));
-				}
-			};
-			const exitPpt = async () => {
-				mode.setLoading(sessionId, true);
-				try {
-					await client.call("presentation/mode", { mode: null });
-					mode.setMode(sessionId, null);
-					mode.setLoading(sessionId, false);
-					close();
 				} catch (reason) {
 					mode.setError(sessionId, reason instanceof Error ? reason.message : String(reason));
 				}
@@ -477,28 +437,13 @@ window.__ModuleLoader__.load({
 			const categories = ["all", ...new Set(templates.map(templateCategory))];
 			const visible = templates.filter(template => category === "all" || templateCategory(template) === category);
 			const h = react.createElement;
-			if (placement === "trigger") return h("span", { className: "dsh-ppt-control" },
-				h("button", {
-					id: triggerId, type: "button", className: "dsh-ppt-trigger", title: label, "aria-label": label,
-					"data-desktop-ppt": "", "data-selected": active || undefined,
-					"aria-expanded": open, "aria-pressed": active,
-					"aria-controls": open ? panelId : undefined,
-					onClick: () => setOpen(!open)
-				}, h(DesktopPptIcon), h("span", { className: "dsh-ppt-trigger-mode" }, t("mode.label") + (active && selected ? " ·" : "")),
-					active && selected && h("span", { className: "dsh-ppt-trigger-label" }, selected.name),
-					h("span", { className: "dsh-ppt-chevron", "aria-hidden": true }, "⌄")));
-			if (!open) return null;
 			return h("section", {
-					ref: panel, id: panelId, "aria-label": t("templates.title"),
-					className: "dsh-ppt-panel", "data-office-ppt-template-panel": "", "data-placement": "bottom",
-					onKeyDown: event => { if (event.key === "Escape") { event.preventDefault(); event.stopPropagation(); close(); } }
+					"aria-label": t("templates.title"),
+					className: "dsh-ppt-panel", "data-office-ppt-template-panel": "", "data-placement": "bottom"
 				},
 					h("div", { className: "dsh-ppt-panel-header" },
-						h("h2", { className: "dsh-ppt-panel-title" }, t("templates.title")),
-						h("div", { className: "dsh-ppt-panel-actions" },
-							active && h("button", { type: "button", className: "dsh-ppt-exit", disabled: state.loading, onClick: exitPpt }, t("mode.exit")),
-							h("button", { type: "button", className: "dsh-ppt-close", "aria-label": t("templates.close"), onClick: close }, "×"))),
-					state.notice && active && h("p", { className: "dsh-ppt-panel-notice", role: "status" }, t("templates.migrated")),
+						h("h2", { className: "dsh-ppt-panel-title" }, t("templates.title"))),
+					state.notice && h("p", { className: "dsh-ppt-panel-notice", role: "status" }, t("templates.migrated")),
 					h("div", { className: OfficePptHero_module_css_default.categoryTabs, role: "group", "aria-label": t("templates.categories") },
 						categories.map(item => h("button", {
 							key: item, type: "button", "data-ppt-category": item, "aria-pressed": category === item,
@@ -509,13 +454,19 @@ window.__ModuleLoader__.load({
 							state.templates.length === 0 && h("button", { type: "button", className: OfficePptHero_module_css_default.retryButton, onClick: () => mode.setError(sessionId, "") }, t("templates.retry"))),
 						state.loading && templates.length === 0 ? h("div", { className: OfficePptHero_module_css_default.panelState }, t("status.loading")) :
 						h("div", { className: OfficePptHero_module_css_default.templateGrid }, visible.map(template => h(TemplateCard, {
-							key: template.id, template, selected: active && template.id === state.selectedId, choose, disabled: state.loading
+							key: template.id, template, selected: template.id === state.selectedId, choose, disabled: state.loading
 						})))));
 		}
 		function OfficePptComposer(props) {
-			const blank = props.useSession(session => session.blank);
-			if (!blank) return null;
-			return react_jsx_runtime.jsx(OfficePptChooser, { ...props }, props.sessionId);
+			const blank = props.useSession(current => current.blank);
+			const agentPreset = props.useSessions(current => {
+				const summary = current.byId[props.sessionId];
+				return summary?.projectionValues?.agentPreset ?? summary?.agentPreset;
+			});
+			if (!blank || agentPreset !== "ppt") return null;
+			return react_jsx_runtime.jsx(OfficePptChooser, {
+				client: props.client, mode: props.mode, sessionId: props.sessionId, t: props.t
+			}, props.sessionId);
 		}
 		//#endregion
 		//#region ../office-ppt/src/client/locales.ts
@@ -697,25 +648,22 @@ window.__ModuleLoader__.load({
 				mode
 			});
 		}
-		/**
-		* Register the compact PPT picker in the public composer toolbar.
-		* @param ctx - Browser context that owns the standard Composer slots.
-		*/
+		/** Register the template picker below the composer for the native PPT preset. */
 		function applyStandard(ctx) {
 			const injectHero = officePptHeroInjection(ctx);
-			// The standard composer is a flex column. Ordering only our dock last keeps
-			// the picker below the input in normal flow, including blank sessions.
-			for (const [name, placement] of [["conversation.input.left", "trigger"], ["conversation.input.dock", "panel"]]) {
-				ctx.slots.inject(name, () => ctx.slots.register({
-					name, id: "dsh-ppt", order: 20, locale: NS, inject: injectHero
-				}, props => react_jsx_runtime.jsx(OfficePptComposer, { ...props, placement })));
-			}
+			const name = "conversation.input.dock";
+			ctx.slots.inject(name, () => ctx.slots.register({
+				name, id: "dsh-ppt", order: 20, locale: NS, inject: injectHero
+			}, props => react_jsx_runtime.jsx(OfficePptComposer, {
+				client: props.client, mode: props.mode, sessionId: props.sessionId,
+				useSession: props.useSession, useSessions: props.useSessions, t: props.t
+			}, props.sessionId)));
 		}
 		//#endregion
 		//#region src/client/index.ts
 		/** Required standard browser services. */
 		const inject = standardInject;
-		/** Mount the PPT toolbar button and the collapsible picker below the input card. */
+		/** Mount the native-PPT-preset template picker below the input card. */
 		function apply(ctx) {
 			applyStandard(ctx);
 		}

package/lib/index.js

@@ -11,7 +11,7 @@ import { definitions as DSH_PPT_TEMPLATE_DEFINITIONS, semantics as DSH_PPT_TEMPL
 import { i as renderPptdProject, n as loadPptdProject, o as recommendedTextCapacity, r as parsePptdProject, t as checkPptdProject } from "./pptd-2VqVzr_T.js";
 import z from "@deepseek-ai/schemastery";
 import { fileURLToPath } from "node:url";
-import { access, appendFile, link, lstat, mkdir, open, readFile, readdir, realpath, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
+import { access, appendFile, copyFile, link, lstat, mkdir, open, readFile, readdir, realpath, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { BUNDLED_SKILL_RANK, renderSkillContent } from "@deepseek-ai/dsh-skill";
 import { createHash, randomUUID } from "node:crypto";
@@ -758,8 +758,7 @@ var PptService = class {
 				state: {
 					...state,
 					selectedTemplateId: template.id,
-                    templateMigration: undefined,
-					presentationMode: "ppt"
+					templateMigration: undefined
 				},
 				value: template,
 				summary: `已选择模板 ${template.name}`,
@@ -3143,6 +3142,20 @@ function pptComposerContext(state) {
 		"workflow: direct local PPTD authoring with bounded pptd_* tools and final pptd_render conversion"
 	].join("\n");
 }
+/** Resolve the preset currently running this session, including blank-session switches. */
+function sessionAgentPreset(session) {
+	if (session === void 0 || typeof session !== "object") return void 0;
+	for (let index = (session.events?.length ?? 0) - 1; index >= 0; index -= 1) {
+		const event = session.events[index];
+		if (event?.type === "agent-preset/selected" && typeof event.data?.agentPreset === "string") return event.data.agentPreset;
+	}
+	return typeof session.header?.agentPreset === "string" ? session.header.agentPreset : void 0;
+}
+/** New sessions use the native preset; the state flag remains for old sessions. */
+function isPptSession(agent, state) {
+	const preset = sessionAgentPreset(agent?.session);
+	return preset === "ppt" || (preset === void 0 && state.presentationMode === "ppt");
+}
 function hasActiveSkill(agent) {
 	return agent.session.deriveMessages().some((message) => {
 		if (message.role !== "user") return false;
@@ -3207,7 +3220,7 @@ function registerPptTools(ctx, service) {
 	});
 	// Resolve the persisted composer state for this assembly, never a process-wide toggle.
 	ctx.on("system-prompt/assemble", async (_assembly, { agent }, next) => {
-		const active = agent !== void 0 && (await service.state(agent.id)).presentationMode === "ppt";
+		const active = agent !== void 0 && isPptSession(agent, await service.state(agent.id));
 		const assembly = await next();
 		return active ? assembly : {
 			...assembly,
@@ -3217,7 +3230,8 @@ function registerPptTools(ctx, service) {
 	ctx.on("agent/pre-step", async ({ agent, step, signal }, next) => {
 		const decision = await next();
 		if (decision.kind === "reject" || signal.aborted) return decision;
-		const context = pptComposerContext(await service.state(agent.id));
+		const state = await service.state(agent.id);
+		const context = isPptSession(agent, state) ? pptComposerContext({ ...state, presentationMode: "ppt" }) : void 0;
 		if (signal.aborted) return decision;
 		if (context === void 0) {
 			clearAutomaticPptContext(agent);
@@ -3604,6 +3618,7 @@ const Config = z.object({
 	maxDecksPerSession: z.natural().min(1).default(50),
 	maxActivities: z.natural().min(1).default(200),
 	kimiPptSkillRoot: z.string(),
+	presetRoot: z.string(),
 	pptSkillRoot: z.string()
 });
 /** Compose storage, browser RPC, and bounded model tools. */
@@ -3663,8 +3678,29 @@ function registerPptRpcRoute(webCtx, channel, rpcHandler) {
 	}), `dsh-ppt: ${channel} rpc route`);
 }
 
+/** Make the package preset visible to the native DSH roster on first install. */
+async function ensurePptPreset(root) {
+	if (typeof root !== "string" || !path.isAbsolute(root)) return;
+	const source = fileURLToPath(new URL("../presets/ppt/", import.meta.url));
+	const target = path.join(root, "ppt");
+	await mkdir(target, { recursive: true });
+	for (const file of ["agent.cordis.yml", "preset.yml"]) {
+		const destination = path.join(target, file);
+		try {
+			await access(destination);
+		} catch {
+			await copyFile(path.join(source, file), destination);
+		}
+	}
+}
+
 async function apply(ctx, config) {
 	const bundledPptSkillRoot = fileURLToPath(new URL("../skills/dsh-ppt", import.meta.url));
+	try {
+		await ensurePptPreset(config.presetRoot ?? path.join(path.dirname(config.root), ".agent-presets"));
+	} catch (error) {
+		ctx.logger.warn(`dsh-ppt: could not install native PPT preset: ${error instanceof Error ? error.message : String(error)}`);
+	}
 	registerPreviewAssets(ctx, previewFiles, path.join(bundledPptSkillRoot, "references"));
 	registerPptSkill(ctx, config.pptSkillRoot ?? config.kimiPptSkillRoot ?? process.env.DSH_PPT_SKILL_ROOT ?? process.env.DSH_KIMI_PPT_SKILL_ROOT ?? bundledPptSkillRoot);
 	const service = new PptService(new PptStore(config.root, {
@@ -3685,4 +3721,3 @@ async function apply(ctx, config) {
 }
 //#endregion
 export { Config, apply, inject, name };
-

package/lib/preset.js

@@ -0,0 +1,4 @@
+/** Native agent-preset marker for @cola1900/dsh-ppt. */
+export const name = 'dsh-ppt-preset'
+export const inject = []
+export function apply() {}

package/lib/types/index.d.ts

@@ -15,6 +15,8 @@ export interface Config {
     maxDecksPerSession?: number;
     /** Maximum recent activity records retained in session state. */
     maxActivities?: number;
+    /** Absolute DSH agent-preset root used for the bundled PPT preset. */
+    presetRoot?: string;
     /** Absolute DSH PPT Skill override. The package-bundled Skill is the default. */
     pptSkillRoot?: string;
 }
@@ -22,4 +24,4 @@ export interface Config {
 export declare const Config: z<Config>;
 /** Compose storage, browser RPC, and bounded model tools. */
 export declare function apply(ctx: Context, config: Config): Promise<void>;
-export type { PptService } from './ppt-service.ts';
+export type { PptService } from './ppt-service.ts';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cola1900/dsh-ppt",
   "description": "Standalone DSH plugin for PPT authoring, template selection, validation and editable PPTX export",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/boe1900/dsh-ppt.git"
@@ -43,7 +43,8 @@
       "default": "./lib/pptd.js"
     },
     "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./preset": "./lib/preset.js"
   },
   "dsh": {
     "bundle": {
@@ -93,6 +94,7 @@
   "files": [
     "lib",
     "skills",
+    "presets",
     "cordis.patch.yml",
     "LICENSE",
     "THIRD_PARTY_NOTICES.md",

package/presets/ppt/agent.cordis.yml

@@ -0,0 +1,4 @@
+# The PPT tools and prompt are supplied by the installed dsh-ppt bundle.
+# This tiny entry makes the package's native PPT preset discoverable without
+# mounting a second copy of the bundle's server and tool registrations.
+- name: '@cola1900/dsh-ppt/preset'

package/presets/ppt/preset.yml

@@ -0,0 +1,4 @@
+name: PPT
+# 固定 PPT 创作工具和提示词；首次发送前选择一个模板。
+description: 使用 PPT 工作流，并在首次发送前选择模板。
+order: 30

package/skills/dsh-ppt/SKILL.md

@@ -7,7 +7,7 @@ description: DSH 演示文稿：编写本地 PPTD 工程并输出可编辑 PPTX
 
 <!-- DSH-PPT-AUTHORING-20260907-V3 -->
 
-本 Skill 仅由用户选中的 PPT 模式启用。
+本 Skill 仅由用户选中的 PPT 预设启用；预设一旦开始对话便保持不变。
 
 ## 工作过程