@mhfire/dsh-im-bridge 0.3.0 → 0.4.3

package/package.json

@@ -1,77 +1,94 @@
-{
-  "name": "@mhfire/dsh-im-bridge",
-  "version": "0.3.0",
-  "description": "企业微信智能机器人 ⇄ DeepSeek Harness Agent 桥接插件：进程内按企微窗口创建 Agent（单聊一人一条、同一群共用一条），会话在 GUI 实时可见；含 Settings 插件配置卡片",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MHfire/dsh-im-bridge.git"
-  },
-  "type": "module",
-  "main": "lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./client": "./lib/client.js",
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "src",
-    "lib",
-    "tsdown.host.ts",
-    "tsdown.client.ts",
-    "tsconfig.json",
-    "cordis.patch.yml",
-    "persona.default.md",
-    "persona.default.en.md",
-    "persona.example.md",
-    "README.md",
-    "README.en.md"
-  ],
-  "scripts": {
-    "build": "tsdown --config tsdown.host.ts && tsdown --config tsdown.client.ts",
-    "prepare": "tsdown --config tsdown.host.ts && tsdown --config tsdown.client.ts",
-    "test": "node --experimental-strip-types --test tests/reply-images.test.ts tests/session-key.test.ts"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-client-ui-settings-plugins",
-        "@deepseek-ai/dsh-api-remotes"
-      ],
-      "platform": "web"
-    }
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "*",
-    "@deepseek-ai/dsh-agent": "*",
-    "@deepseek-ai/dsh-llm": "*",
-    "@deepseek-ai/dsh-session": "*",
-    "@deepseek-ai/dsh-settings": "*",
-    "@deepseek-ai/schemastery": "*"
-  },
-  "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": { "optional": true },
-    "@deepseek-ai/dsh-agent": { "optional": true },
-    "@deepseek-ai/dsh-llm": { "optional": true },
-    "@deepseek-ai/dsh-session": { "optional": true },
-    "@deepseek-ai/dsh-settings": { "optional": true },
-    "@deepseek-ai/schemastery": { "optional": true }
-  },
-  "dependencies": {
-    "@wecom/aibot-node-sdk": "^1.0.7"
-  },
-  "devDependencies": {
-    "@types/react": "~18.3.1",
-    "lightningcss": "^1.32.0",
-    "react": "^18.2.0",
-    "tsdown": "^0.22.2"
-  }
-}
+{
+  "name": "@mhfire/dsh-im-bridge",
+  "version": "0.4.3",
+  "description": "企业微信智能机器人 ⇄ DeepSeek Harness Agent 桥接插件：进程内按企微窗口创建 Agent（单聊一人一条、同一群共用一条），会话在 GUI 实时可见；含 Settings 插件配置卡片",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MHfire/dsh-im-bridge.git"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "tsdown.host.ts",
+    "tsdown.client.ts",
+    "tsconfig.json",
+    "cordis.patch.yml",
+    "persona.default.md",
+    "persona.default.en.md",
+    "persona.example.md",
+    "README.md",
+    "README.en.md"
+  ],
+  "scripts": {
+    "build": "tsdown --config tsdown.host.ts && tsdown --config tsdown.client.ts",
+    "prepare": "tsdown --config tsdown.host.ts && tsdown --config tsdown.client.ts",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "test": "npm run typecheck && node --experimental-strip-types --test tests/reply-images.test.ts tests/session-key.test.ts tests/wecom-cli.test.ts"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins",
+        "@deepseek-ai/dsh-api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "*",
+    "@deepseek-ai/dsh-agent": "*",
+    "@deepseek-ai/dsh-llm": "*",
+    "@deepseek-ai/dsh-session": "*",
+    "@deepseek-ai/dsh-settings": "*",
+    "@deepseek-ai/schemastery": "*"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@wecom/aibot-node-sdk": "^1.0.7",
+    "@wecom/cli": "^1.2.0",
+    "fflate": "^0.8.3",
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.0",
+    "@types/react": "~18.3.1",
+    "lightningcss": "^1.32.0",
+    "react": "^18.2.0",
+    "tsdown": "^0.22.2",
+    "typescript": "^6.0.3"
+  }
+}

package/src/client/WecomCard.tsx

@@ -5,6 +5,7 @@ import type { ImBridgeLocaleKey } from './locales.ts'
 import type { WecomCardFace, WecomCardState } from './card-controller.ts'
 import { PluginCard } from './PluginCard.tsx'
 import { SecretField, ValueField } from './fields.tsx'
+import css from './fields.module.css'
 
 /** Props the slot renderer binds for this card. */
 export interface WecomCardProps {
@@ -20,6 +21,8 @@ export interface WecomCardProps {
   save: WecomCardFace['save']
   /** Drop every staged edit. */
   discard: WecomCardFace['discard']
+  /** Download official wecomcli-* into the Host-resolved directory. */
+  installSkills: WecomCardFace['installSkills']
 }
 
 /**
@@ -66,6 +69,16 @@ export function WecomCard(props: WecomCardProps): ReactElement | null {
         stateLabel={state.secretConfigured ? t('secretConfigured') : t('secretUnset')}
         onEdit={text => { props.edit('secret', text) }}
       />
+      <SkillsInstall
+        t={t}
+        disabled={disabled}
+        available={state.skillsInstallAvailable}
+        status={state.skillsInstallStatus}
+        dest={state.skillsDest}
+        count={state.skillsCount}
+        error={state.skillsError}
+        onInstall={props.installSkills}
+      />
       <ValueField
         id="im-bridge-allowFrom"
         label={t('allowFrom')}
@@ -133,3 +146,65 @@ export function WecomCard(props: WecomCardProps): ReactElement | null {
     </PluginCard>
   )
 }
+
+function skillsStatusText(
+  t: (key: ImBridgeLocaleKey) => string,
+  status: WecomCardState['skillsInstallStatus'],
+  dest: string,
+  count: number,
+  error: string,
+  available: boolean,
+): string {
+  if (!available) return t('skillsUnavailable')
+  if (status === 'ok') {
+    return t('skillsInstalled').replace('{count}', String(count)).replace('{dest}', dest)
+  }
+  if (status === 'error') {
+    return error === '' ? t('skillsFailed') : `${t('skillsFailed')} ${error}`
+  }
+  return t('skillsHint')
+}
+
+/**
+ * Host-side install of official wecomcli-* (browser never chooses the path).
+ * @param props - copy, status, and the install action.
+ * @returns the labelled control.
+ */
+function SkillsInstall(props: {
+  t: (key: ImBridgeLocaleKey) => string
+  disabled: boolean
+  available: boolean
+  status: WecomCardState['skillsInstallStatus']
+  dest: string
+  count: number
+  error: string
+  onInstall: () => void
+}): ReactElement {
+  const installing = props.status === 'installing'
+  const status = skillsStatusText(
+    props.t,
+    props.status,
+    props.dest,
+    props.count,
+    props.error,
+    props.available,
+  )
+  return (
+    <div className={css.field}>
+      <div className={css.head}>
+        <span className={css.label}>{props.t('skillsTitle')}</span>
+      </div>
+      <button
+        type="button"
+        className={css.install}
+        disabled={props.disabled || !props.available || installing}
+        onClick={props.onInstall}
+      >
+        {props.t(installing ? 'skillsInstalling' : 'skillsInstall')}
+      </button>
+      <p className={props.status === 'error' || !props.available ? css.invalid : css.hint}>
+        {status}
+      </p>
+    </div>
+  )
+}

package/src/client/card-controller.ts

@@ -1,6 +1,7 @@
 /** Staged form over the `im-bridge` settings namespace. */
 
-import type { SettingsScope, SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client'
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store'
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client'
 import {
   CardForm,
   csvField,
@@ -59,28 +60,59 @@ export interface WecomCardState extends CardShell {
   welcomeMessage: CardFieldState
   provider: CardFieldState
   model: CardFieldState
+  /** Whether the Host Connection RPC is available. */
+  skillsInstallAvailable: boolean
+  /** idle / installing / ok / error. */
+  skillsInstallStatus: 'idle' | 'installing' | 'ok' | 'error'
+  /** Destination after a successful install. */
+  skillsDest: string
+  /** Loaded wecomcli-* count after a successful install. */
+  skillsCount: number
+  /** Host error message after a failed install. */
+  skillsError: string
 }
 
 /** Face the card's slot registration injects. */
 export interface WecomCardFace extends CardActions {
+  /** Download official wecomcli-* into the Host-resolved directory. */
+  installSkills: () => void
   hooks: {
     /** Card snapshot bound by the renderer as useWecomCard. */
     wecomCard: SnapshotStore<WecomCardState>
   }
 }
 
+/** Unary RPC caller used by the install button. */
+export interface SkillsInstallRpc {
+  call(
+    channel: string,
+    endpoint: string,
+    payload: unknown,
+    signal?: AbortSignal,
+  ): Promise<
+    | { ok: true; value: unknown }
+    | { ok: false; error: { message: string } }
+  >
+}
+
 /** Bridges the `im-bridge` scope onto the staged card form. */
 export class WecomCardController {
   private readonly form: CardForm<WecomCardSettings>
   private readonly store: SnapshotStore<WecomCardState>
+  private skillsInstallStatus: WecomCardState['skillsInstallStatus'] = 'idle'
+  private skillsDest = ''
+  private skillsCount = 0
+  private skillsError = ''
 
   /**
    * @param scope - bound settings scope for the `im-bridge` namespace.
    * @param describe - Host describe face; secret literals never ride it.
+   * @param rpc - optional Connection RPC for the skills install button.
    */
   constructor(
     private readonly scope: SettingsScope<WecomCardSettings>,
     private readonly describe: SettingsDescribeFace,
+    private readonly rpc: SkillsInstallRpc | undefined,
   ) {
     this.form = new CardForm(
       scope,
@@ -115,6 +147,11 @@ export class WecomCardController {
       welcomeMessage: this.form.field('welcomeMessage'),
       provider: this.form.field('provider'),
       model: this.form.field('model'),
+      skillsInstallAvailable: this.rpc !== undefined,
+      skillsInstallStatus: this.skillsInstallStatus,
+      skillsDest: this.skillsDest,
+      skillsCount: this.skillsCount,
+      skillsError: this.skillsError,
     }
   }
 
@@ -139,8 +176,45 @@ export class WecomCardController {
     return this.secretConfigured(field)
   }
 
+  /**
+   * Download official wecomcli-* into the Host-resolved directory.
+   * The browser does not choose the path.
+   */
+  installSkills(): void {
+    void this.runInstall()
+  }
+
+  private async runInstall(): Promise<void> {
+    if (this.rpc === undefined || this.skillsInstallStatus === 'installing') return
+    this.skillsInstallStatus = 'installing'
+    this.skillsError = ''
+    this.form.notify()
+    try {
+      const result = await this.rpc.call('/im-bridge', 'wecomcli.installSkills', {})
+      if (!result.ok) {
+        this.skillsInstallStatus = 'error'
+        this.skillsError = result.error.message
+        this.form.notify()
+        return
+      }
+      const value = result.value as { dest?: unknown; count?: unknown }
+      this.skillsInstallStatus = 'ok'
+      this.skillsDest = typeof value.dest === 'string' ? value.dest : ''
+      this.skillsCount = typeof value.count === 'number' ? value.count : 0
+      this.skillsError = ''
+    } catch (error) {
+      this.skillsInstallStatus = 'error'
+      this.skillsError = error instanceof Error ? error.message : String(error)
+    }
+    this.form.notify()
+  }
+
   /** Face the slot registration injects. */
   inject(): WecomCardFace {
-    return { hooks: { wecomCard: this.store }, ...this.form.actions() }
+    return {
+      hooks: { wecomCard: this.store },
+      ...this.form.actions(),
+      installSkills: () => { this.installSkills() },
+    }
   }
 }

package/src/client/card-form.ts

@@ -3,12 +3,8 @@
  * Mirrors the Host Plugins section model without importing its chrome.
  */
 
-import {
-  createSnapshotStore,
-  type SettingsScope,
-  type SettingsScopeSnapshot,
-  type SnapshotStore,
-} from '@deepseek-ai/dsh-client-runtime/client'
+import { createSnapshotStore, type SnapshotStore } from '@deepseek-ai/dsh-client-store'
+import type { SettingsScope, SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client'
 
 /** Write one staged field performs on save. */
 export type FieldWrite =
@@ -260,6 +256,11 @@ export class CardForm<T> {
     this.publish()
   }
 
+  /** Rebuild bound projections for card-owned state outside the settings draft. */
+  notify(): void {
+    this.publish()
+  }
+
   private spec(field: string): CardFieldSpec {
     const spec = this.specs.get(field)
     if (spec === undefined) throw new Error(`im-bridge card has no field ${field}`)

package/src/client/fields.module.css

@@ -93,6 +93,10 @@
   cursor: default;
 }
 
+.input::placeholder {
+  color: var(--dsw-alias-label-tertiary);
+}
+
 .inputInvalid {
   height: 34px;
   padding: 0 12px;
@@ -122,3 +126,31 @@
   line-height: 1.5;
   color: var(--dsw-alias-label-tertiary);
 }
+
+.install {
+  appearance: none;
+  align-self: flex-start;
+  border: 1px solid transparent;
+  border-radius: 8px;
+  padding: 5px 14px;
+  font: inherit;
+  font-size: 13px;
+  line-height: 1.5;
+  cursor: pointer;
+  background: var(--dsw-alias-label-primary);
+  color: var(--dsw-alias-bg-layer-3);
+}
+
+.install:hover:not(:disabled) {
+  opacity: 0.92;
+}
+
+.install:disabled {
+  opacity: 0.4;
+  cursor: default;
+}
+
+.install:focus-visible {
+  outline: 2px solid var(--dsw-alias-brand-primary);
+  outline-offset: 1px;
+}

package/src/client/fields.tsx

@@ -79,7 +79,8 @@ export function ValueField(props: FieldProps & {
 
 /**
  * Write-only credential control. The literal never rides a response, so the
- * control starts blank and reports only whether one is configured.
+ * control starts blank and reports only whether one is configured. A configured
+ * empty draft shows a dots placeholder so the box does not look unset.
  * @param props - the field's copy, staged text, and configured state.
  * @returns the labelled control.
  */
@@ -103,6 +104,7 @@ export function SecretField(props: Pick<FieldProps, 'id' | 'label' | 'hint' | 't
         type="password"
         autoComplete="off"
         value={props.text}
+        placeholder={props.configured && props.text === '' ? '••••••••' : undefined}
         disabled={props.disabled}
         onChange={(event) => { props.onEdit(event.target.value) }}
       />

package/src/client/index.ts

@@ -2,12 +2,16 @@
  * Browser half: Settings card keyed by the `im-bridge` namespace.
  */
 
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
-// Type-only: ctx.settingsScope.describe and the keyed slot declaration.
+import type { Context as ClientContext } from '@deepseek-ai/cordis'
+// Type-only: ctx.slots, ctx.locale, ctx.settingsScope.describe, and the keyed
+// slot declaration. Behavior crosses packages through services and slots only.
+import type {} from '@deepseek-ai/dsh-client-ui-slots'
+import type {} from '@deepseek-ai/dsh-client-ui-renderer/client'
+import type {} from '@deepseek-ai/dsh-client-locale/client'
 import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
 import type {} from '@deepseek-ai/dsh-client-ui-settings-plugins/client'
 import { WecomCard } from './WecomCard.tsx'
-import { WecomCardController } from './card-controller.ts'
+import { WecomCardController, type SkillsInstallRpc } from './card-controller.ts'
 import { en, zh } from './locales.ts'
 
 /** Settings namespace shared with the Host half. */
@@ -21,9 +25,11 @@ export const inject = ['slots', 'locale', 'connection', 'remote', 'settingsScope
  * @param ctx - browser plugin context.
  */
 export function apply(ctx: ClientContext): void {
+  const connection = ctx.get('connection') as { rpc?: SkillsInstallRpc } | undefined
   const card = new WecomCardController(
     ctx.settingsScope.bind({ namespace: NS }),
     ctx.settingsScope.describe(),
+    connection?.rpc,
   )
 
   ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'im-bridge: locale dicts')

package/src/client/locales.ts

@@ -32,6 +32,13 @@ export type ImBridgeLocaleKey =
   | 'providerHint'
   | 'model'
   | 'modelHint'
+  | 'skillsTitle'
+  | 'skillsHint'
+  | 'skillsInstall'
+  | 'skillsInstalling'
+  | 'skillsInstalled'
+  | 'skillsFailed'
+  | 'skillsUnavailable'
 
 /** English copy for the im-bridge card. */
 export const en: Record<ImBridgeLocaleKey, string> = {
@@ -50,7 +57,7 @@ export const en: Record<ImBridgeLocaleKey, string> = {
   invalidNumber: 'Enter a finite number.',
   botId: 'Bot ID',
   secret: 'Secret',
-  secretHint: 'Leave blank to keep the stored value. Save, then restart the process to open the WebSocket.',
+  secretHint: 'The box stays empty on purpose (the stored value never rides the wire). A Configured badge means it is saved; type a new value to replace it. Save, then restart the process to open the WebSocket.',
   secretConfigured: 'Configured',
   secretUnset: 'Not configured',
   allowFrom: 'Allowed sender userids',
@@ -67,6 +74,13 @@ export const en: Record<ImBridgeLocaleKey, string> = {
   providerHint: 'Empty follows the GUI default model. Both provider and model must be set to override.',
   model: 'WeCom-only model',
   modelHint: 'Takes effect only together with provider.',
+  skillsTitle: 'WeCom office skills',
+  skillsHint: 'Installs wecomcli-* into the plugin directory ($DSH_HOME/wecom-cli-skills). Do not use npx skills add -g; that CLI has no --dir. An empty Bot ID / Secret box is normal.',
+  skillsInstall: 'Install official skills',
+  skillsInstalling: 'Installing…',
+  skillsInstalled: 'Installed {count} skills into {dest}',
+  skillsFailed: 'Install failed.',
+  skillsUnavailable: 'Install needs the Web host Connection.',
 }
 
 /** Chinese copy for the im-bridge card. */
@@ -86,7 +100,7 @@ export const zh: Record<ImBridgeLocaleKey, string> = {
   invalidNumber: '请输入有效数字。',
   botId: 'Bot ID',
   secret: 'Secret',
-  secretHint: '留空保留已存值。保存后需重启进程才会连 WebSocket。',
+  secretHint: '框空是正常的（已存值不会传到浏览器）。徽章「已配置」即已保存；重新输入可覆盖。保存后需重启进程才会连 WebSocket。',
   secretConfigured: '已配置',
   secretUnset: '未配置',
   allowFrom: '允许的发送者 userid',
@@ -103,6 +117,13 @@ export const zh: Record<ImBridgeLocaleKey, string> = {
   providerHint: '空 = 跟随 GUI 默认模型。须与 model 同时填写才覆盖。',
   model: '企微专用 model',
   modelHint: '仅在同时填写 provider 时生效。',
+  skillsTitle: '企微办公 skills',
+  skillsHint: '装到程序目录 $DSH_HOME/wecom-cli-skills。不要用 npx skills add -g；CLI 没有 --dir。Bot ID / Secret 框空是正常的。',
+  skillsInstall: '安装官方 skills',
+  skillsInstalling: '正在安装…',
+  skillsInstalled: '已装 {count} 个到 {dest}',
+  skillsFailed: '安装失败。',
+  skillsUnavailable: '安装需要 Web Host 的 Connection。',
 }
 
 declare module '@deepseek-ai/dsh-client-ui-slots' {