From 1aee5106661f37c156ca325eaabc5c0431b96b29 Mon Sep 17 00:00:00 2001 From: xueyan Date: Thu, 20 Aug 2026 18:29:45 +0800 Subject: [PATCH] docs: strengthen Deckuse automation value --- README.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d5dea40..165d52d 100644 --- a/README.md +++ b/README.md @@ -11,9 +11,9 @@ -Deckuse is a local-first, schema-driven Office document automation engine for coding agents. It opens a document into a versioned workspace, lets an agent inspect and target its structure, applies explicit JSON commands, validates the result, and exports a new document. +Deckuse is a local-first, schema-driven Office document automation engine for coding agents. It turns document editing into an explicit, reviewable workflow: open a versioned workspace, inspect and target its structure, apply JSON commands, validate the result, and export a new document. -PPTX is the currently implemented format. DOCX, XLSX, Keynote, and Numbers adapters deliberately return `FORMAT_NOT_IMPLEMENTED`; they are not supported editing targets yet. +The engine is built around format adapters. PPTX is the currently implemented format; DOCX, XLSX, Keynote, and Numbers adapters return `FORMAT_NOT_IMPLEMENTED` today, so agents fail clearly instead of silently producing unsafe edits. ## Why Deckuse @@ -25,6 +25,20 @@ existing.pptx → init → inspect / query → apply JSON commands → validate It preserves untouched XML and unknown package parts where possible. It is not a rendering engine and cannot reliably judge whether a slide is visually attractive or whether a layout is visually correct. +## Where it creates value + +Deckuse is designed for document changes that need to be precise, repeatable, +and auditable: + +- **Recurring content updates** — refresh dates, metrics, names, pricing, and + disclaimers without rebuilding a presentation. +- **Customer and market variants** — create controlled versions with explicit + selectors and reviewable operations. +- **Content governance** — query sensitive or outdated content, inspect every + match, and validate before export. +- **Agent-driven automation** — use structured JSON, revision checks, dry runs, + atomic batches, and operation logs in larger workflows. + ## Installation Requirements: Node.js 18 or later.