@capyclaw/ppt-workbench 0.0.0-stage → 2.4.1

package/server/tools/capabilities/text.mjs

@@ -0,0 +1,82 @@
+/** 文本能力：按页/元素改文本，文字槽位填充。 */
+import { clamp, normalizeSlides, okText } from '../domains/tooling.mjs'
+import { normalizeTextStyle } from '../domains/text-style.mjs'
+import { defineCapability, defineTool } from '../kernel/define.mjs'
+
+export const textCapability = defineCapability({
+  id: 'text',
+  title: '文字与槽位',
+  tags: ['write', 'content'],
+  requires: ['deck'],
+  features: ['deck.write'],
+  tools: [
+    defineTool({
+      name: 'ppt_text',
+      description: '改文字：某页或某几页（缺省全部页）的首个文本，或指定 element_id 的文本；可同时改字号/颜色/加粗/对齐。首个文本优先取 text 元素，纯图形文字页回退到带文字的 shape。',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          text: { type: 'string', maxLength: 2000 },
+          slide: { type: 'integer', description: '0 起页号' },
+          slides: { type: 'array', maxItems: 100, items: { type: 'integer' }, description: '0 起页号数组（缺省=全部）' },
+          element_id: { type: 'string', description: '元素 id（缺省=首个文本）' },
+          font_size: { type: 'integer' },
+          color: { type: 'string', description: 'CSS 颜色或中文色名' },
+          bold: { type: 'boolean' },
+          align: { type: 'string', enum: ['left', 'center', 'right', 'justify'] },
+        },
+        required: ['text'],
+        additionalProperties: false,
+      },
+      kind: 'write',
+      since: '1.0.0',
+      handler: async ({ text, slide, slides, element_id, ...style }, ctx) => {
+        const base = { text: String(text ?? '') }
+        if (element_id) base.elementId = String(element_id)
+        Object.assign(base, normalizeTextStyle(style))
+        const targets = normalizeSlides(slides)
+          || (slide !== undefined && slide !== null ? [clamp(Number(slide) | 0, 0, 999)] : null)
+        if (targets) {
+          const r = await ctx.deck.write(targets.map(i => Object.assign({ op: 'set-text', id: i }, base)))
+          return okText(r, `已改 ${targets.length} 页文本`)
+        }
+        const doc = await ctx.deck.read()
+        const n = doc.deck && Array.isArray(doc.deck.slides) ? doc.deck.slides.length : 0
+        if (!n) throw new Error('桥上没有 deck')
+        const r = await ctx.deck.write(Array.from({ length: n }, (_, i) => Object.assign({ op: 'set-text', id: i }, base)))
+        return okText(r, `已改全部 ${n} 页文本`)
+      },
+    }),
+    defineTool({
+      name: 'ppt_fill',
+      description: '填充文字槽位：把某页的第 slot 个文字载体（0 起，含带文字的 shape）改成 text，可带字号/颜色/加粗/对齐。保留原版式。',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          slide: { type: 'integer', description: '0 起页号' },
+          slot: { type: 'integer', description: '该页第几个文字载体（0 起，含图形内文字）' },
+          text: { type: 'string' },
+          font_size: { type: 'integer' },
+          color: { type: 'string' },
+          bold: { type: 'boolean' },
+          align: { type: 'string' },
+        },
+        required: ['slide', 'slot', 'text'],
+        additionalProperties: false,
+      },
+      kind: 'write',
+      since: '1.0.0',
+      handler: async ({ slide, slot, text, ...style }, ctx) => {
+        const cmd = {
+          op: 'fill-slot',
+          slide: clamp(Number(slide) | 0, 0, 999),
+          slot: clamp(Number(slot) | 0, 0, 99),
+          text: String(text ?? ''),
+          ...normalizeTextStyle(style),
+        }
+        const r = await ctx.deck.write([cmd])
+        return okText(r, `已填第 ${slide} 页槽位 ${slot}`)
+      },
+    }),
+  ],
+})

package/server/tools/domains/color.mjs

@@ -0,0 +1,4 @@
+/** 工具侧颜色入口：唯一实现仍在 core/color.js。 */
+export {
+  COLORS, resolveColor, parseColor, luminance, contrastRatio, relativeLuminance, contrastColor,
+} from '../../../core/color.js'

package/server/tools/domains/image.mjs

@@ -0,0 +1,49 @@
+/** 图片域：字节嗅探 / 尺寸解析 / 聊天附件定位（实际落盘由 assets 端口负责）。 */
+import fs from 'node:fs'
+import path from 'node:path'
+
+export function imageMime(buf) {
+  if (buf[0] === 0x89 && buf[1] === 0x50) return 'image/png'
+  if (buf[0] === 0xff && buf[1] === 0xd8) return 'image/jpeg'
+  if (buf.slice(0, 3).toString('ascii') === 'GIF') return 'image/gif'
+  if (buf.slice(8, 12).toString('ascii') === 'WEBP') return 'image/webp'
+  return null
+}
+
+export function imageSize(buf) {
+  if (buf[0] === 0x89 && buf[1] === 0x50 && buf.length > 24) {
+    return [buf.readUInt32BE(16), buf.readUInt32BE(20)]
+  }
+  if (buf.slice(0, 3).toString('ascii') === 'GIF' && buf.length > 10) {
+    return [buf.readUInt16LE(6), buf.readUInt16LE(8)]
+  }
+  if (buf[0] === 0xff && buf[1] === 0xd8) {
+    let i = 2
+    while (i + 8 < buf.length) {
+      if (buf[i] !== 0xff) { i++; continue }
+      const m = buf[i + 1]
+      i += 2
+      if (m === 0xd8 || m === 0xd9 || m === 0x01) continue
+      const len = buf.readUInt16BE(i)
+      if ([0xc0, 0xc1, 0xc2, 0xc3, 0xc5, 0xc6, 0xc7, 0xc9, 0xca, 0xcb, 0xcd, 0xce, 0xcf].includes(m)) {
+        return [buf.readUInt16BE(i + 5), buf.readUInt16BE(i + 3)]
+      }
+      i += len
+    }
+  }
+  return null
+}
+
+export function resolveAttachmentFile(id) {
+  const hex = String(id || '').replace(/^sha256:/i, '')
+  if (!/^[0-9a-f]{64}$/i.test(hex)) throw new Error('attachment_id 必须是 sha256:<64位hex>')
+  const roots = []
+  if (process.env.DSH_HOME) roots.push(path.join(process.env.DSH_HOME, 'attachments', 'v1', 'objects'))
+  if (process.env.DSH_ATTACHMENTS_DIR) roots.push(process.env.DSH_ATTACHMENTS_DIR)
+  if (process.env.USERPROFILE) roots.push(path.join(process.env.USERPROFILE, '.dsh', 'attachments', 'v1', 'objects'))
+  for (const root of roots) {
+    const p = path.join(root, hex.slice(0, 2), hex)
+    if (fs.existsSync(p)) return p
+  }
+  throw new Error('找不到聊天附件：' + id + '（请在聊天里重新粘贴图片）')
+}

package/server/tools/domains/index.mjs

@@ -0,0 +1,7 @@
+/** 工具域辅助桶：只给 tools.mjs 兼容导出用，能力模块按需直接 import 具体文件。 */
+export { COLORS, resolveColor, parseColor, contrastColor, relativeLuminance } from './color.mjs'
+export { expandRecolorOps, resolveForeground } from './recolor.mjs'
+export { simpleSlide } from './slide.mjs'
+export { imageMime, imageSize, resolveAttachmentFile } from './image.mjs'
+export { clamp, sleep, okText, normalizeSlides } from './tooling.mjs'
+export { normalizeTextStyle } from './text-style.mjs'