@xiaopb/dsh-mobile-compose 0.0.0-stage → 0.6.4

package/lib/config.js

@@ -0,0 +1,93 @@
+'use strict'
+
+/**
+ * dsh-mobile-compose 配置归一化：apply 对缺省配置宽容，不抛错。
+ *
+ *   - enabled：false 时装载但零路由、零行为（客户端拿到 404 后走内置默认）。
+ *   - hideNativeButtons：隐藏输入框左下角原生的「添加文件」「调用指令」两个
+ *     小按钮（由加号面板统一承载）。默认 true；关掉后原生按钮保留，面板作为
+ *     额外入口并存。
+ *   - actions：动作开关表，键为动作 id（pick-image / take-photo / pick-file /
+ *     command），值为 true/false。宿主端只负责把开关透传给客户端做能力协商；
+ *     客户端自身还有一层桌面端硬约束（桌面没有相机路由时 take-photo 自动禁用）。
+ *   - hiddenCommands：从指令列表里剔除的指令名（与内置动作同义的指令，如
+ *     /file —— 图片 / 文件 瓦片已覆盖）。数组或逗号/空白分隔字符串，默认
+ *     ['file']；空数组/空串 = 全部展示。
+ */
+
+const DEFAULT_ACTIONS = {
+  'pick-image': true,
+  'take-photo': true,
+  'pick-file': true,
+  command: true,
+}
+
+const DEFAULT_HIDDEN_COMMANDS = ['file']
+
+/** 指令名归一：去斜杠、小写、去空白；数组或逗号/空白分隔字符串均可。 */
+function normalizeHiddenCommands(raw) {
+  const source = Array.isArray(raw)
+    ? raw
+    : typeof raw === 'string'
+      ? raw.split(/[,\s]+/)
+      : null
+  if (source === null) return null
+  const out = []
+  for (const item of source) {
+    if (typeof item !== 'string') continue
+    const name = item.trim().replace(/^\//, '').toLowerCase()
+    if (name && !out.includes(name)) out.push(name)
+  }
+  return out
+}
+
+function normalizeConfig(input = {}) {
+  const raw = input && typeof input === 'object' ? input : {}
+
+  const enabled = raw.enabled !== false
+
+  const hideNativeButtons = raw.hideNativeButtons !== false
+
+  const actionsSource = raw.actions && typeof raw.actions === 'object' ? raw.actions : {}
+  const actions = {}
+  for (const key of Object.keys(DEFAULT_ACTIONS)) {
+    const v = actionsSource[key]
+    actions[key] = typeof v === 'boolean' ? v : DEFAULT_ACTIONS[key]
+  }
+
+  // hiddenCommands：显式给出（含空串/空数组 = 全部展示）才生效；缺省或类型
+  // 非法（非字符串/数组）回落默认集。
+  const hiddenCommands = normalizeHiddenCommands(raw.hiddenCommands)
+  const hasHiddenKey = raw !== null && typeof raw === 'object' && raw.hiddenCommands !== undefined
+
+  return {
+    enabled,
+    hideNativeButtons,
+    actions,
+    hiddenCommands: hasHiddenKey && hiddenCommands !== null
+      ? hiddenCommands
+      : DEFAULT_HIDDEN_COMMANDS.slice(),
+  }
+}
+
+/**
+ * 设置页 section → 生效配置的合并：
+ *   - `enabled` 只属于插件装载配置（base），设置页不暴露（改它要重装插件）；
+ *   - `hideNativeButtons` / `actions` 以设置页 section 为准（用户层覆盖），
+ *     section 缺字段时回落 base 值。
+ * 宽容缺省：section 非对象 / 字段缺失都不抛错。
+ */
+function mergeSettingsSection(base, section) {
+  const b = normalizeConfig(base)
+  const raw = section && typeof section === 'object' ? section : {}
+  return normalizeConfig({
+    enabled: b.enabled,
+    hideNativeButtons: typeof raw.hideNativeButtons === 'boolean' ? raw.hideNativeButtons : b.hideNativeButtons,
+    actions: raw.actions && typeof raw.actions === 'object'
+      ? { ...b.actions, ...raw.actions }
+      : b.actions,
+    hiddenCommands: raw.hiddenCommands !== undefined ? raw.hiddenCommands : b.hiddenCommands,
+  })
+}
+
+module.exports = { normalizeConfig, mergeSettingsSection, normalizeHiddenCommands, DEFAULT_ACTIONS, DEFAULT_HIDDEN_COMMANDS }

package/lib/index.js

@@ -0,0 +1,97 @@
+'use strict'
+
+/**
+ * dsh-mobile-compose v0.2.0 宿主端入口：cordis 插件（inject + apply）。
+ *
+ * 定位：**手机端输入体验**。客户端（lib/client.js，随 web GUI 加载）做全部
+ * UI 工作 —— 输入框左下角加号入口、QQ 式动作面板（图片 / 拍照 / 文件 / 指令）、
+ * 隐藏原生小按钮，并把选中的文件送回官方 addFiles 通道。宿主端提供两件事：
+ *
+ *   1. GET /api/dsh-mobile-compose/capabilities —— 动作能力协商（capabilities.js）。
+ *      来源是「设置页实时值」：用户在 DSH 设置页改动后，客户端下一次拉取即生效。
+ *   2. `dsh-mobile-compose` 设置页 namespace —— schemastery schema 经
+ *      ctx.settings.installSection 注册，DSH 设置页自动渲染表单（settings.js）。
+ *      settings 服务缺席（headless / 异常安装）时静默跳过，仅用插件装载配置。
+ *
+ * 契约：inject 恒为 []（webServer / settings 都是可选服务，动态获取，缺席即
+ * 降级）；apply(ctx, config) 装载，返回卸载函数；所有失败路径绝不上抛。
+ */
+
+const { normalizeConfig, mergeSettingsSection } = require('./config')
+const { createCapabilitiesRoute } = require('./capabilities')
+const { buildSettingsSchema } = require('./settings')
+
+const SETTINGS_NAMESPACE = 'dsh-mobile-compose'
+
+function apply(ctx, config) {
+  const base = normalizeConfig(config)
+
+  const log = (level, ...args) => {
+    try {
+      const lg = ctx && ctx.logger
+      if (lg && typeof lg[level] === 'function') lg[level](`[dsh-mobile-compose]`, ...args)
+    } catch (_) {
+      /* 日志丢失不影响主流程 */
+    }
+  }
+
+  if (base.enabled === false) {
+    log('info', 'disabled (enabled=false)，装载但零路由')
+    return function dispose() {}
+  }
+
+  // ---- 设置页 namespace（可选服务）----
+  // current 恒为「当前生效配置」的 thunk：初始为插件配置；settings 服务把它
+  // 换成实时来源（attach 时与 detach 时都会回调 setSource）。
+  let current = () => base
+  try {
+    const settings = typeof ctx.get === 'function' ? ctx.get('settings') : undefined
+    const schema = buildSettingsSchema()
+    if (settings && typeof settings.installSection === 'function' && schema) {
+      const entry = {
+        hideNativeButtons: base.hideNativeButtons,
+        actions: { ...base.actions },
+        hiddenCommands: base.hiddenCommands.join(','),
+      }
+      settings.installSection(ctx, SETTINGS_NAMESPACE, schema, entry, {
+        setSource: (source) => {
+          current = () => mergeSettingsSection(base, typeof source === 'function' ? source() : source)
+        },
+        onChange: () => {
+          log('info', '设置页配置已更新，capabilities 下一次拉取即生效')
+        },
+      })
+    } else {
+      log('debug', 'settings 服务或 schema 不可用，仅用插件装载配置')
+    }
+  } catch (error) {
+    log('warn', '设置页 namespace 注册失败（不影响 capabilities，仅少一处 UI 配置入口）：', error instanceof Error ? error.message : String(error))
+  }
+
+  // ---- capabilities 路由（可选服务）----
+  // webServer 是可选服务（headless profile 没有它）：动态 inject 保证本插件
+  // 在任何 profile 都可装载，服务出现时才挂路由。
+  ctx.inject(['webServer'], (scoped) => {
+    try {
+      const route = createCapabilitiesRoute(() => current())
+      const dispose = scoped.webServer.register(route)
+      log('info', `capabilities 路由已挂载：${route.path}`)
+      return function disposeRoutes() {
+        try {
+          dispose()
+        } catch (_) {
+          /* 静默 */
+        }
+      }
+    } catch (error) {
+      log('warn', 'capabilities 路由挂载失败（客户端将走内置默认动作集）：', error instanceof Error ? error.message : String(error))
+      return undefined
+    }
+  })
+
+  return function dispose() {
+    // 路由与 namespace 的注销由各自动态注入的返回函数托管（fiber unload 级联）。
+  }
+}
+
+module.exports = { inject: [], apply, SETTINGS_NAMESPACE }

package/lib/settings.js

@@ -0,0 +1,46 @@
+'use strict'
+
+/**
+ * dsh-mobile-compose 设置页 namespace（`dsh-mobile-compose`）。
+ *
+ * 宿主端通过 ctx.settings.installSection(ctx, ns, schema, entry, hooks) 注册；
+ * DSH 设置页（schema-form）按 schemastery schema 自动渲染表单 —— 客户端 UI
+ * 零代码。用户在设置页的修改经 settings 服务落盘并触发 hooks.onChange，本插件
+ * 把「当前生效值」作为 capabilities 路由的实时来源，客户端每次打开面板都重拉
+ * capabilities，因此设置改动无需刷新页面即可生效。
+ *
+ * schemastery 缺失（异常安装）时 buildSettingsSchema 返回 null，宿主端跳过
+ * namespace 注册，仅用插件装载配置 —— 全部路径宽容降级。
+ */
+
+let zCache
+function getZ() {
+  if (zCache !== undefined) return zCache
+  try {
+    // eslint-disable-next-line global-require
+    zCache = require('@deepseek-ai/schemastery')
+  } catch (_) {
+    zCache = null
+  }
+  return zCache
+}
+
+/** 设置页 section 的形状（与插件配置的子集同形：不含 enabled）。 */
+function buildSettingsSchema() {
+  const z = getZ()
+  if (!z || typeof z.object !== 'function') return null
+  return z.object({
+    hideNativeButtons: z.boolean().default(true),
+    actions: z.object({
+      'pick-image': z.boolean().default(true),
+      'take-photo': z.boolean().default(true),
+      'pick-file': z.boolean().default(true),
+      command: z.boolean().default(true),
+    }),
+    // 逗号分隔的指令名（不带斜杠）；留空 = 全部展示。默认剔除 /file
+    // （官方「添加文件」指令，与面板的 图片/文件 瓦片重复）。
+    hiddenCommands: z.string().default('file'),
+  })
+}
+
+module.exports = { buildSettingsSchema }

package/package.json

@@ -1,6 +1,77 @@
 {
   "name": "@xiaopb/dsh-mobile-compose",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.6.4",
+  "description": "DSH web-UI plugin: mobile-first composer experience. Replaces the composer's add-file/command buttons with one plus entry that opens a QQ-style action sheet (image picker / camera / file / command tiles; command execution follows the official dispatch decision table (input commands claim the draft, bare commands execute via the official Enter channel)), feeds every picked file back through the official addFiles intake, exposes a host capability route plus a DSH settings-page namespace so the panel can be configured in-app, and documents the bridge contract for routing actions to native Android intents.",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "test": "node --test --test-force-exit test/*.test.js",
+    "smoke": "node tools/smoke-e2e.mjs",
+    "verify:paging": "node tools/verify-paging.js",
+    "verify:lang": "node tools/verify-lang.js",
+    "check": "npm test && npm run smoke && node scripts/verify-package.mjs",
+    "pack:dry": "npm pack --dry-run"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "engines": {
+    "node": ">=22.12.0",
+    "dsh": ">=0.2.1-rc.2"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.5-rc.1",
+    "@deepseek-ai/schemastery": ">=3.18.1 <4"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@deepseek-ai/schemastery": "^3.18.5",
+    "jsdom": "^30.1.3",
+    "playwright": "^1.64.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XiaoPb/dsh-mobile-compose.git"
+  },
+  "homepage": "https://github.com/XiaoPb/dsh-mobile-compose#readme",
+  "bugs": {
+    "url": "https://github.com/XiaoPb/dsh-mobile-compose/issues"
+  },
+  "author": "XiaoPb",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "plugin",
+    "composer",
+    "mobile",
+    "android",
+    "chat-ui",
+    "action-sheet"
+  ]
+}