@capyclaw/ppt-workbench 2.4.0 → 2.4.1

package/server/shared/kit/tuning.mjs

@@ -1,82 +1,82 @@
-/**
- * dsh-plugin-kit 运行时调优层。
- *
- * 默认值与进化搜索（evolution/ NSGA-II）的 founder 基线保持一致；
- * 生产环境可用 DSH_TUNING_JSON 覆盖（按包名分组），测试/评估用 setTuning 注入。
- *
- * DSH_TUNING_JSON 形如：
- *   {"dsh-plugin-kit": {"fileLockPollMs": 25, "journalMaxBytes": 2097152}}
- */
-
-const DEFAULTS = {
-  /* fs-lock：元数据文件锁
-   * pollMs=10 由 NSGA-II 进化搜索固化（evolution/，2026-11-01）：
-   * 24 路竞争延迟 2202→1400ms；10ms 为延迟与轮询 IO 的膝点。 */
-  fileLockSyncTimeoutMs: 10000,
-  fileLockSyncStaleMs: 30000,
-  fileLockAsyncTimeoutMs: 30000,
-  fileLockPollMs: 10,
-  fileLockFreshGraceMs: 2000,
-
-  /* 编辑器租约：wait() 轮询节奏 */
-  leaseWaitPollMs: 200,
-  leaseWaitTimeoutMs: 4000,
-
-  /* JournalStore：journal 轮转阈值与尾读默认行数
-   * 512KB 由进化搜索固化：尾读 p95 4.3→1.9ms、磁盘 -70%、追加吞吐 +8%。 */
-  journalMaxBytes: 512 * 1024,
-  journalTailLimit: 8,
-
-  /* WorkspaceManager catalog 写节流（降低全局 catalog 锁竞争） */
-  catalogThrottleMs: 5000,
-
-  /* WorkspaceClient token 校验缓存 */
-  tokenVerifyCacheMs: 30000,
-
-  /* HTTP 服务三级超时（keepAliveTimeoutMs 必须小于 headersTimeoutMs） */
-  requestTimeoutMs: 30000,
-  headersTimeoutMs: 10000,
-  keepAliveTimeoutMs: 5000,
-}
-
-let overrides = {}
-let envLoaded = false
-
-function loadEnv() {
-  if (envLoaded) return
-  envLoaded = true
-  try {
-    const raw = process.env.DSH_TUNING_JSON
-    if (!raw) return
-    const parsed = JSON.parse(raw)
-    if (!parsed || typeof parsed !== 'object') return
-    const own = parsed['dsh-plugin-kit'] && typeof parsed['dsh-plugin-kit'] === 'object'
-      ? parsed['dsh-plugin-kit']
-      : parsed
-    for (const key of Object.keys(DEFAULTS)) {
-      if (own[key] !== undefined) overrides[key] = own[key]
-    }
-  } catch { /* 非法 JSON 静默忽略：调优失败不能阻塞启动 */ }
-}
-
-/** 当前生效参数（默认值 + env + setTuning 覆盖）。 */
-export function tuning() {
-  loadEnv()
-  return { ...DEFAULTS, ...overrides }
-}
-
-/** 测试/评估注入。只接受已知键，避免拼写错误静默生效。 */
-export function setTuning(patch = {}) {
-  loadEnv()
-  for (const [key, value] of Object.entries(patch)) {
-    if (key in DEFAULTS) overrides[key] = value
-  }
-}
-
-/** 恢复到默认值 + env 覆盖。 */
-export function resetTuning() {
-  overrides = {}
-  envLoaded = false
-}
-
-export const TUNING_DEFAULTS = { ...DEFAULTS }
+/**
+ * @capyclaw/plugin-kit 运行时调优层。
+ *
+ * 默认值与进化搜索（evolution/ NSGA-II）的 founder 基线保持一致；
+ * 生产环境可用 DSH_TUNING_JSON 覆盖（按包名分组），测试/评估用 setTuning 注入。
+ *
+ * DSH_TUNING_JSON 形如：
+ *   {"@capyclaw/plugin-kit": {"fileLockPollMs": 25, "journalMaxBytes": 2097152}}
+ */
+
+const DEFAULTS = {
+  /* fs-lock：元数据文件锁
+   * pollMs=10 由 NSGA-II 进化搜索固化（evolution/，2026-11-01）：
+   * 24 路竞争延迟 2202→1400ms；10ms 为延迟与轮询 IO 的膝点。 */
+  fileLockSyncTimeoutMs: 10000,
+  fileLockSyncStaleMs: 30000,
+  fileLockAsyncTimeoutMs: 30000,
+  fileLockPollMs: 10,
+  fileLockFreshGraceMs: 2000,
+
+  /* 编辑器租约：wait() 轮询节奏 */
+  leaseWaitPollMs: 200,
+  leaseWaitTimeoutMs: 4000,
+
+  /* JournalStore：journal 轮转阈值与尾读默认行数
+   * 512KB 由进化搜索固化：尾读 p95 4.3→1.9ms、磁盘 -70%、追加吞吐 +8%。 */
+  journalMaxBytes: 512 * 1024,
+  journalTailLimit: 8,
+
+  /* WorkspaceManager catalog 写节流（降低全局 catalog 锁竞争） */
+  catalogThrottleMs: 5000,
+
+  /* WorkspaceClient token 校验缓存 */
+  tokenVerifyCacheMs: 30000,
+
+  /* HTTP 服务三级超时（keepAliveTimeoutMs 必须小于 headersTimeoutMs） */
+  requestTimeoutMs: 30000,
+  headersTimeoutMs: 10000,
+  keepAliveTimeoutMs: 5000,
+}
+
+let overrides = {}
+let envLoaded = false
+
+function loadEnv() {
+  if (envLoaded) return
+  envLoaded = true
+  try {
+    const raw = process.env.DSH_TUNING_JSON
+    if (!raw) return
+    const parsed = JSON.parse(raw)
+    if (!parsed || typeof parsed !== 'object') return
+    const own = parsed['@capyclaw/plugin-kit'] && typeof parsed['@capyclaw/plugin-kit'] === 'object'
+      ? parsed['@capyclaw/plugin-kit']
+      : parsed
+    for (const key of Object.keys(DEFAULTS)) {
+      if (own[key] !== undefined) overrides[key] = own[key]
+    }
+  } catch { /* 非法 JSON 静默忽略：调优失败不能阻塞启动 */ }
+}
+
+/** 当前生效参数（默认值 + env + setTuning 覆盖）。 */
+export function tuning() {
+  loadEnv()
+  return { ...DEFAULTS, ...overrides }
+}
+
+/** 测试/评估注入。只接受已知键，避免拼写错误静默生效。 */
+export function setTuning(patch = {}) {
+  loadEnv()
+  for (const [key, value] of Object.entries(patch)) {
+    if (key in DEFAULTS) overrides[key] = value
+  }
+}
+
+/** 恢复到默认值 + env 覆盖。 */
+export function resetTuning() {
+  overrides = {}
+  envLoaded = false
+}
+
+export const TUNING_DEFAULTS = { ...DEFAULTS }

package/server/single-instance.mjs

@@ -1,2 +1,2 @@
-/** 兼容入口：单实例锁实现统一来自 dsh-plugin-kit 的构建快照。 */
-export * from './infra/single-instance.mjs'
+/** 兼容入口：单实例锁实现统一来自 @capyclaw/plugin-kit 的构建快照。 */
+export * from './infra/single-instance.mjs'

package/server/store/checkpoints.mjs

@@ -1,28 +1,28 @@
-/** 兼容层：checkpoint 名称与载荷沿用 PPT 字段，底层由 DocumentSession 写入。 */
-export { checkpointName } from 'dsh-document-workbench/session'
-
-export function buildCheckpoint(doc, name, meta = {}) {
-  const pending = (doc.seq | 0) > (doc.applied_seq | 0)
-  const deck = doc.deck || { title: '未命名', slides: [] }
-  return {
-    name,
-    seq: doc.seq | 0,
-    appliedSeq: doc.applied_seq | 0,
-    pending,
-    title: doc.title || deck.title || '未命名',
-    slides: Array.isArray(deck.slides) ? deck.slides.length : 0,
-    deck,
-    meta: meta && typeof meta === 'object' ? meta : {},
-    createdAt: new Date().toISOString(),
-  }
-}
-
-export function listCheckpoints(backend) {
-  return backend.listCheckpoints()
-}
-
-export function readCheckpoint(backend, name) {
-  const payload = backend.readCheckpoint(name)
-  if (!payload || !payload.deck) throw new Error('checkpoint 内容损坏: ' + name)
-  return payload
-}
+/** 兼容层：checkpoint 名称与载荷沿用 PPT 字段，底层由 DocumentSession 写入。 */
+export { checkpointName } from '@capyclaw/document-workbench/session'
+
+export function buildCheckpoint(doc, name, meta = {}) {
+  const pending = (doc.seq | 0) > (doc.applied_seq | 0)
+  const deck = doc.deck || { title: '未命名', slides: [] }
+  return {
+    name,
+    seq: doc.seq | 0,
+    appliedSeq: doc.applied_seq | 0,
+    pending,
+    title: doc.title || deck.title || '未命名',
+    slides: Array.isArray(deck.slides) ? deck.slides.length : 0,
+    deck,
+    meta: meta && typeof meta === 'object' ? meta : {},
+    createdAt: new Date().toISOString(),
+  }
+}
+
+export function listCheckpoints(backend) {
+  return backend.listCheckpoints()
+}
+
+export function readCheckpoint(backend, name) {
+  const payload = backend.readCheckpoint(name)
+  if (!payload || !payload.deck) throw new Error('checkpoint 内容损坏: ' + name)
+  return payload
+}

package/server/store/doc.mjs

@@ -1,52 +1,52 @@
-/** PPT 兼容层：标准会话信封 + PPT 的 deck 初始文档与标题同步。 */
-import {
-  applyAck as baseAck,
-  applyPush as basePush,
-  applyServer as baseServer,
-  applyShotRequest as baseShotRequest,
-  applyShotResult as baseShotResult,
-  applyState as baseState,
-  applyUi as baseUi,
-  createSessionState,
-  pendingOf,
-} from 'dsh-document-workbench/session'
-
-export const EMPTY_DECK = () => ({ title: '', slides: [] })
-
-export const EMPTY_DOC = () => createSessionState({ title: '' })
-
-export function applyPush(doc, cmds, title, now) {
-  return basePush(doc, cmds, title, now)
-}
-
-export function applyServer(doc, seq, applied, error, now) {
-  return baseServer(doc, seq, applied, error, {
-    now,
-    stateCompact: true,
-    onApplied: (next) => {
-      if (next.title && next.deck) next.deck.title = next.title
-    },
-  })
-}
-
-export function applyAck(doc, seq, applied, error, now) {
-  return baseAck(doc, seq, applied, error, now)
-}
-
-export function applyState(doc, deck, seq, now) {
-  return baseState(doc, deck, seq, { now, documentKey: 'deck' })
-}
-
-export function applyUi(doc, cmds, now) {
-  return baseUi(doc, cmds, now)
-}
-
-export function applyShotRequest(doc, now) {
-  return baseShotRequest(doc, now)
-}
-
-export function applyShotResult(doc, req, data, now) {
-  return baseShotResult(doc, req, data, now)
-}
-
-export { pendingOf }
+/** PPT 兼容层：标准会话信封 + PPT 的 deck 初始文档与标题同步。 */
+import {
+  applyAck as baseAck,
+  applyPush as basePush,
+  applyServer as baseServer,
+  applyShotRequest as baseShotRequest,
+  applyShotResult as baseShotResult,
+  applyState as baseState,
+  applyUi as baseUi,
+  createSessionState,
+  pendingOf,
+} from '@capyclaw/document-workbench/session'
+
+export const EMPTY_DECK = () => ({ title: '', slides: [] })
+
+export const EMPTY_DOC = () => createSessionState({ title: '' })
+
+export function applyPush(doc, cmds, title, now) {
+  return basePush(doc, cmds, title, now)
+}
+
+export function applyServer(doc, seq, applied, error, now) {
+  return baseServer(doc, seq, applied, error, {
+    now,
+    stateCompact: true,
+    onApplied: (next) => {
+      if (next.title && next.deck) next.deck.title = next.title
+    },
+  })
+}
+
+export function applyAck(doc, seq, applied, error, now) {
+  return baseAck(doc, seq, applied, error, now)
+}
+
+export function applyState(doc, deck, seq, now) {
+  return baseState(doc, deck, seq, { now, documentKey: 'deck' })
+}
+
+export function applyUi(doc, cmds, now) {
+  return baseUi(doc, cmds, now)
+}
+
+export function applyShotRequest(doc, now) {
+  return baseShotRequest(doc, now)
+}
+
+export function applyShotResult(doc, req, data, now) {
+  return baseShotResult(doc, req, data, now)
+}
+
+export { pendingOf }

package/server/store/index.mjs

@@ -1,34 +1,34 @@
-/**
- * PPT 桥存储 facade：通用版本化会话来自 dsh-document-workbench，
- * 本文件只保留 deck 的初始文档、summary 与标题同步。
- */
-import { DocumentSession, OWNER_TTL } from 'dsh-document-workbench/session'
-import { FileBridgeBackend } from './backends/file-backend.mjs'
-import { EMPTY_DOC } from './doc.mjs'
-
-export * from './sanitize.mjs'
-export { OWNER_TTL, FileBridgeBackend }
-
-export class BridgeStore extends DocumentSession {
-  constructor(fileOrOptions) {
-    let backend
-    if (typeof fileOrOptions === 'string') backend = new FileBridgeBackend(fileOrOptions)
-    else if (fileOrOptions && fileOrOptions.backend) backend = fileOrOptions.backend
-    else throw new Error('BridgeStore 需要 file 路径或 backend')
-
-    super({
-      backend,
-      initialDoc: EMPTY_DOC(),
-      documentKey: 'deck',
-      stateCompact: true,
-      summary: (doc) => ({
-        title: doc.deck && doc.deck.title ? doc.deck.title : '未命名',
-        slides: doc.deck && Array.isArray(doc.deck.slides) ? doc.deck.slides.length : 0,
-      }),
-      checkpointDocument: () => ({ title: '未命名', slides: [] }),
-      onApplied: (doc) => {
-        if (doc.title && doc.deck) doc.deck.title = doc.title
-      },
-    })
-  }
-}
+/**
+ * PPT 桥存储 facade：通用版本化会话来自 @capyclaw/document-workbench，
+ * 本文件只保留 deck 的初始文档、summary 与标题同步。
+ */
+import { DocumentSession, OWNER_TTL } from '@capyclaw/document-workbench/session'
+import { FileBridgeBackend } from './backends/file-backend.mjs'
+import { EMPTY_DOC } from './doc.mjs'
+
+export * from './sanitize.mjs'
+export { OWNER_TTL, FileBridgeBackend }
+
+export class BridgeStore extends DocumentSession {
+  constructor(fileOrOptions) {
+    let backend
+    if (typeof fileOrOptions === 'string') backend = new FileBridgeBackend(fileOrOptions)
+    else if (fileOrOptions && fileOrOptions.backend) backend = fileOrOptions.backend
+    else throw new Error('BridgeStore 需要 file 路径或 backend')
+
+    super({
+      backend,
+      initialDoc: EMPTY_DOC(),
+      documentKey: 'deck',
+      stateCompact: true,
+      summary: (doc) => ({
+        title: doc.deck && doc.deck.title ? doc.deck.title : '未命名',
+        slides: doc.deck && Array.isArray(doc.deck.slides) ? doc.deck.slides.length : 0,
+      }),
+      checkpointDocument: () => ({ title: '未命名', slides: [] }),
+      onApplied: (doc) => {
+        if (doc.title && doc.deck) doc.deck.title = doc.title
+      },
+    })
+  }
+}

package/server/store/lease.mjs

@@ -1,2 +1,2 @@
-/** 兼容层：deck owner 租约的通用实现位于 dsh-document-workbench/session。 */
-export { OWNER_TTL, claimOwner, ownerStatus, releaseOwner } from 'dsh-document-workbench/session'
+/** 兼容层：deck owner 租约的通用实现位于 @capyclaw/document-workbench/session。 */
+export { OWNER_TTL, claimOwner, ownerStatus, releaseOwner } from '@capyclaw/document-workbench/session'

package/server/store/sanitize.mjs

@@ -1,32 +1,32 @@
-/** 桥协议白名单：通用信封来自 dsh-document-workbench，PPT 只需声明 deck 字段与上限。 */
-import { createSessionSanitizers } from 'dsh-document-workbench/session'
-
-export const MAX_CMDS = 100               // 单队指令条数上限
-export const MAX_TOTAL = 8 * 1024 * 1024  // 单队总量上限（字节）
-export const MAX_SHOT = 4 * 1024 * 1024   // 截图 dataURL 上限
-
-const sanitizers = createSessionSanitizers({
-  documentKey: 'deck',
-  maxCmds: MAX_CMDS,
-  maxTotal: MAX_TOTAL,
-  maxShot: MAX_SHOT,
-  maxTitle: 120,
-  maxError: 2000,
-  maxId: 64,
-})
-
-const {
-  sanitizeAck,
-  sanitizeClaim,
-  sanitizePush,
-  sanitizeShotResult,
-  sanitizeState: baseSanitizeState,
-} = sanitizers
-
-export { sanitizeAck, sanitizeClaim, sanitizePush, sanitizeShotResult }
-
-/** 兼容旧 API：返回 { deck, seq }；通用 bridge 会把它归一化为 value。 */
-export function sanitizeState(body) {
-  const data = baseSanitizeState(body)
-  return data ? { deck: data.value, seq: data.seq } : null
-}
+/** 桥协议白名单：通用信封来自 @capyclaw/document-workbench，PPT 只需声明 deck 字段与上限。 */
+import { createSessionSanitizers } from '@capyclaw/document-workbench/session'
+
+export const MAX_CMDS = 100               // 单队指令条数上限
+export const MAX_TOTAL = 8 * 1024 * 1024  // 单队总量上限（字节）
+export const MAX_SHOT = 4 * 1024 * 1024   // 截图 dataURL 上限
+
+const sanitizers = createSessionSanitizers({
+  documentKey: 'deck',
+  maxCmds: MAX_CMDS,
+  maxTotal: MAX_TOTAL,
+  maxShot: MAX_SHOT,
+  maxTitle: 120,
+  maxError: 2000,
+  maxId: 64,
+})
+
+const {
+  sanitizeAck,
+  sanitizeClaim,
+  sanitizePush,
+  sanitizeShotResult,
+  sanitizeState: baseSanitizeState,
+} = sanitizers
+
+export { sanitizeAck, sanitizeClaim, sanitizePush, sanitizeShotResult }
+
+/** 兼容旧 API：返回 { deck, seq }；通用 bridge 会把它归一化为 value。 */
+export function sanitizeState(body) {
+  const data = baseSanitizeState(body)
+  return data ? { deck: data.value, seq: data.seq } : null
+}

package/server/validate.mjs

@@ -1,2 +1,2 @@
-/** 参数校验统一来自 dsh-tool-host 公共插件（底层为 dsh-plugin-kit）。 */
+/** 参数校验统一来自 dsh-tool-host 公共插件（底层为 @capyclaw/plugin-kit）。 */
 export { validateToolArguments } from './shared/tool-host.mjs'