@mhfire/dsh-im-bridge 0.1.2 → 0.1.3

package/README.en.md

@@ -0,0 +1,82 @@
+[中文](./README.md) | English
+
+# @mhfire/dsh-im-bridge
+
+WeCom AI Bot ⇄ DeepSeek Harness Agent bridge — a **DSH plugin**.
+
+Creates Agents **in-process** inside a dsh profile (no child-process spawn): per-sender durable sessions (the same WeCom user reuses one session with memory), sessions registered with the Web GUI (live view and continue-chat), plus a Settings → Plugins card (`allowFrom` / `agentTimeoutSec` / `startHint`, written to `settings.yaml` with hot reload).
+
+## Install
+
+### Recommended: npm package
+
+```powershell
+dsh plugin --profile web add @mhfire/dsh-im-bridge
+# Or pin a version:
+# dsh plugin --profile web add @mhfire/dsh-im-bridge@0.1.2
+```
+
+In `$DSH_HOME/profiles/web/cordis.patch.yml` (or your profile), supply credentials only (other fields ship as bundle defaults and can be overridden):
+
+```yaml
+- id: im-bridge
+  config:
+    botId: "<your BotID>"
+    secret: "<your Secret>"
+    # optional: workspace / personaFile / … — see Configuration below
+```
+
+Restart dsh to apply (e.g. `dsh web` / `pnpm dsh web`).
+
+### Optional: local development
+
+Install from this repo’s `plugin/` directory or a `file:` path:
+
+```powershell
+dsh plugin --profile web add <package-path>
+```
+
+If `botId` / `secret` are missing, the plugin still loads (does not block `dsh web`); logs warn that WeCom connect is skipped. You can fill credentials in Settings → Plugins; **restart** is required to connect (this release does not hot-start the WebSocket).
+
+## Configuration
+
+The bundle `cordis.patch.yml` supplies defaults for every field except `botId` / `secret`. Full field list:
+
+| Field | Description |
+|---|---|
+| `botId` / `secret` | WeCom AI Bot credentials (`role('secret')`, redacted in UI); when empty, WeCom side is skipped and the host keeps running |
+| `workspace` | Agent working directory (session cwd) |
+| `allowFrom` | Allowed sender userids; empty = allow everyone |
+| `agentTimeoutSec` | Max seconds per task; also drives progress / ETA |
+| `startHint` | Placeholder text when processing starts |
+| `agentPreset` | Agent preset to mount (default `standard`) |
+| `persona` / `personaFile` | Bot persona (system prompt); `personaFile` wins; do not commit secrets |
+| `maxReplyBytes` | Reply size cap in bytes (default 20000) |
+| `deniedMessage` | Reply when the sender is not on `allowFrom` (editable in Settings) |
+| `welcomeMessage` | Welcome text on `enter_chat` (editable in Settings) |
+| `thinking` | Streaming “thinking” animation: `phases` / `spin` / `eggs` / `eggAfterSec` / `intervalMs` / `activityPrefix`; override via profile patch (not the simple Settings card) |
+
+Example `thinking.phases` override:
+
+```yaml
+thinking:
+  intervalMs: 1500
+  phases:
+    - atSec: 0
+      text: '🤔 Understanding your request…'
+```
+
+## Persona
+
+`persona.md` is the bot persona: role and behavior rules, injected as a system prompt each session.
+Copy `persona.example.md` to `persona.md` and edit; supports `{{model}}` / `{{cwd}}`.
+The file may contain credentials and is gitignored — do not commit it.
+
+## Security
+
+- Do not commit secret-bearing files such as `config.json` / `persona.md`
+- Session and tool output may contain adversarial text; the plugin’s safety prompt tells the agent not to treat tool output as instructions
+
+## License
+
+MIT

package/README.md

@@ -1,3 +1,5 @@
+中文 | [English](./README.en.md)
+
 # @mhfire/dsh-im-bridge
 
 企业微信智能机器人 ⇄ DeepSeek Harness Agent 桥接 **DSH 插件**。
@@ -6,27 +8,40 @@
 
 ## 安装
 
+### 推荐：从 npm 安装
+
 ```powershell
-dsh plugin --profile web add <本包路径>
+dsh plugin --profile web add @mhfire/dsh-im-bridge
+# 或钉版本：
+# dsh plugin --profile web add @mhfire/dsh-im-bridge@0.1.2
 ```
 
-在 profile 的 `cordis.patch.yml` 中配置：
+在 `$DSH_HOME/profiles/web/cordis.patch.yml`（或对应 profile）中补密钥即可（其余项已有 bundle 默认，可按需覆盖）：
 
 ```yaml
 - id: im-bridge
   config:
     botId: "<你的 BotID>"
     secret: "<你的 Secret>"
-    workspace: "<Agent 工作目录>"
-    personaFile: "<绝对路径>/persona.md"
+    # 可选：workspace / personaFile 等，见下方配置项
 ```
 
-重启 dsh 进程即可使用。
+重启 dsh 进程即可使用（例如 `dsh web` / `pnpm dsh web`）。
+
+### 备选：本地开发
+
+从本仓库 `plugin/` 目录或 `file:` 路径安装：
+
+```powershell
+dsh plugin --profile web add <本包路径>
+```
 
 未配置 `botId` / `secret` 时插件仍会加载（不阻塞 `dsh web`），日志会提示跳过企微连线；Settings → 插件配置页仍可填写，保存后**重启**进程才会连接（本版本不做热启连）。
 
 ## 配置项
 
+bundle 的 `cordis.patch.yml` 已为除 `botId` / `secret` 外的字段提供默认值；下表为完整说明。
+
 | 字段 | 说明 |
 |---|---|
 | `botId` / `secret` | 企业微信智能机器人凭证（`role('secret')`，UI 自动脱敏）；缺省时跳过企微侧，不阻塞主进程 |
@@ -37,6 +52,19 @@ dsh plugin --profile web add <本包路径>
 | `agentPreset` | Agent 加入的 preset（默认 `standard`） |
 | `persona` / `personaFile` | 机器人「人设」（系统提示词）；`personaFile` 优先，含敏感信息请勿入库 |
 | `maxReplyBytes` | 回复上限（字节，默认 20000） |
+| `deniedMessage` | 非白名单用户的拒绝文案（Settings 可编） |
+| `welcomeMessage` | 进入会话欢迎语（Settings 可编） |
+| `thinking` | 流式思考动画：`phases` / `spin` / `eggs` / `eggAfterSec` / `intervalMs` / `activityPrefix`；结构请在 profile patch 覆盖，简易卡片不编辑 |
+
+`thinking.phases` 示例（profile 覆盖时可只改文案）：
+
+```yaml
+thinking:
+  intervalMs: 1500
+  phases:
+    - atSec: 0
+      text: '🤔 正在理解你的需求…'
+```
 
 ## 人设（persona）
 

package/cordis.patch.yml

@@ -1,6 +1,47 @@
-# dsh-im-bridge bundle patch: 声明插件行。
-# 密钥(botId/secret)等敏感配置由 profile 层($DSH_HOME/profiles/web/cordis.patch.yml)覆盖,
-# 不要写在这里。
+# dsh-im-bridge bundle patch: 插入插件行并给出非密钥默认配置。
+# botId/secret 由 profile 层 ($DSH_HOME/profiles/<name>/cordis.patch.yml) 或 Settings 覆盖。
 - insert:
     - id: im-bridge
       name: '@mhfire/dsh-im-bridge'
+      config:
+        workspace: !!js process.cwd()
+        allowFrom: []
+        startHint: '🧠 正在思考...'
+        agentTimeoutSec: 600
+        agentPreset: standard
+        persona: ''
+        personaFile: ''
+        maxReplyBytes: 20000
+        deniedMessage: '无权访问本服务'
+        welcomeMessage: '👋 办公助手已就绪。直接发消息即可，例如查文件、整理文档、查资料或处理日常事务。'
+        thinking:
+          eggAfterSec: 240
+          intervalMs: 1500
+          activityPrefix: '🛠️ 正在执行 '
+          spin:
+            - '🧠'
+            - '💭'
+            - '✨'
+            - '🔎'
+            - '⚡'
+          eggs:
+            - '📎 顺手把要点整理好了，稍后一起给你'
+            - '📶 网络有点忙，让它慢慢跑'
+            - '🎯 结果快出来了，坚持一下'
+            - '🗂️ 资料较多，正在汇总中'
+            - '🌙 别盯着了，完成会自动通知你'
+          phases:
+            - atSec: 0
+              text: '🤔 正在理解你的需求…'
+            - atSec: 8
+              text: '📋 正在整理任务清单'
+            - atSec: 25
+              text: '🔍 正在查找相关资料'
+            - atSec: 55
+              text: '✍️ 正在处理文档/数据'
+            - atSec: 120
+              text: '🧠 正在思考最佳方案…'
+            - atSec: 240
+              text: '⏳ 任务较繁琐，请稍候…'
+            - atSec: 420
+              text: '☕ 快好了，正在收尾…'

package/lib/client.js

@@ -18,6 +18,8 @@ var FIELDS = [
   { field: 'allowFrom', label: '允许的发送者 userid（逗号分隔，空 = 所有人）', kind: 'text' },
   { field: 'agentTimeoutSec', label: '单任务超时（秒）', kind: 'number' },
   { field: 'startHint', label: '开始处理时的占位提示', kind: 'text' },
+  { field: 'deniedMessage', label: '非白名单拒绝文案', kind: 'text' },
+  { field: 'welcomeMessage', label: '进入会话欢迎语', kind: 'text' },
 ];
 
 function fmt(f, v) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhfire/dsh-im-bridge",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "企业微信智能机器人 ⇄ DeepSeek Harness Agent 桥接插件：进程内创建 Agent(per-sender 持久会话)，会话在 GUI 实时可见；含 Settings 插件配置卡片",
   "license": "MIT",
   "repository": {
@@ -19,7 +19,8 @@
     "src",
     "lib",
     "cordis.patch.yml",
-    "persona.example.md"
+    "persona.example.md",
+    "README.en.md"
   ],
   "dsh": {
     "bundle": {

package/src/index.js

@@ -19,7 +19,7 @@ import z from '@deepseek-ai/schemastery'
 import { createUserMessage } from '@deepseek-ai/dsh-llm'
 import { SessionId } from '@deepseek-ai/dsh-session'
 import { installModelSelection } from '@deepseek-ai/dsh-agent'
-import { startThinking, sendFinal, truncate, footerOf, fmtDuration } from './wecom.js'
+import { startThinking, sendFinal, truncate, footerOf, fmtDuration, DEFAULT_THINKING } from './wecom.js'
 
 /** 稳定插件名 */
 export const name = 'im-bridge'
@@ -27,6 +27,20 @@ export const name = 'im-bridge'
 /** 依赖的核心服务 */
 export const inject = ['agents', 'sessions', 'agentDefaultModel']
 
+const ThinkingPhase = z.object({
+  atSec: z.number(),
+  text: z.string(),
+})
+
+const ThinkingConfig = z.object({
+  phases: z.array(ThinkingPhase).default(DEFAULT_THINKING.phases),
+  spin: z.array(String).default(DEFAULT_THINKING.spin),
+  eggs: z.array(String).default(DEFAULT_THINKING.eggs),
+  eggAfterSec: z.number().default(DEFAULT_THINKING.eggAfterSec),
+  intervalMs: z.number().default(DEFAULT_THINKING.intervalMs),
+  activityPrefix: z.string().default(DEFAULT_THINKING.activityPrefix),
+})
+
 /** 插件配置(zod): 敏感项由 profile 层 patch 或 Settings 提供；缺省时跳过企微连线，不阻塞主进程 */
 export const Config = z.object({
   botId: z.string().default('').role('secret'),
@@ -47,6 +61,12 @@ export const Config = z.object({
   personaFile: z.string().default(''),
   /** 回复上限(字节) */
   maxReplyBytes: z.number().default(20000),
+  /** 流式思考动画素材(阶段/表情/彩蛋等); 可在 profile patch 覆盖 */
+  thinking: ThinkingConfig.default(DEFAULT_THINKING),
+  /** 非白名单用户的拒绝文案 */
+  deniedMessage: z.string().default('无权访问本服务'),
+  /** 用户进入会话时的欢迎语 */
+  welcomeMessage: z.string().default('👋 办公助手已就绪。直接发消息即可，例如查文件、整理文档、查资料或处理日常事务。'),
 })
 
 /** 收集一次 turn 内最后一条 assistant 文本与结束原因 */
@@ -158,8 +178,9 @@ export function apply(ctx, config) {
     // 会话事件 → 真实活动状态(工具调用名), 让动画显示"正在做什么"
     ctx.on('session/event', (session, event) => {
       if (event.type !== 'tool/call') return
+      const prefix = cfg().thinking?.activityPrefix ?? DEFAULT_THINKING.activityPrefix
       for (const st of senders.values()) {
-        if (st.sessionId === session.id) st.lastActivity = `🛠️ 正在执行 ${event.data.name}`
+        if (st.sessionId === session.id) st.lastActivity = `${prefix}${event.data.name}`
       }
     })
 
@@ -173,7 +194,11 @@ export function apply(ctx, config) {
       let stopThinking = null
       try {
         await ws.replyStream(frame, streamId, cfg().startHint, false)
-        stopThinking = startThinking(ws, frame, streamId, startedAt, cfg().agentTimeoutSec, () => st.lastActivity || '')
+        stopThinking = startThinking(
+          ws, frame, streamId, startedAt, cfg().agentTimeoutSec,
+          () => st.lastActivity || '',
+          cfg().thinking,
+        )
       } catch (e) {
         console.error(`[im-bridge] 占位回复失败: ${e.message}`)
       }
@@ -217,7 +242,7 @@ export function apply(ctx, config) {
       if (!content) return
       const sender = frame.body?.sender?.userid || frame.body?.from?.userid || frame.body?.userid || 'unknown'
       if (cfg().allowFrom.length > 0 && !cfg().allowFrom.includes(sender)) {
-        ws.replyStream(frame, generateReqId('stream'), '无权访问本服务', true).catch(() => {})
+        ws.replyStream(frame, generateReqId('stream'), cfg().deniedMessage, true).catch(() => {})
         return
       }
       console.log(`[im-bridge] 收到 from=${sender}: ${content.slice(0, 100)}`)
@@ -233,7 +258,7 @@ export function apply(ctx, config) {
       console.log(`[im-bridge] 用户 ${sender} 进入会话`)
       ws.replyWelcome(frame, {
         msgtype: 'text',
-        text: { content: '👋 云PC 诊断助手已就绪。直接发消息即可让我诊断设备/服务状态。' },
+        text: { content: cfg().welcomeMessage },
       }).catch((e) => console.error(`[im-bridge] 欢迎语失败: ${e.message}`))
     })
 

package/src/wecom.js

@@ -4,6 +4,30 @@
  */
 import { generateReqId } from '@wecom/aibot-node-sdk'
 
+/** 流式思考动画的默认素材(可被 Config.thinking / cordis patch 覆盖) */
+export const DEFAULT_THINKING = {
+  phases: [
+    { atSec: 0, text: '🤔 正在理解你的需求…' },
+    { atSec: 8, text: '📋 正在整理任务清单' },
+    { atSec: 25, text: '🔍 正在查找相关资料' },
+    { atSec: 55, text: '✍️ 正在处理文档/数据' },
+    { atSec: 120, text: '🧠 正在思考最佳方案…' },
+    { atSec: 240, text: '⏳ 任务较繁琐，请稍候…' },
+    { atSec: 420, text: '☕ 快好了，正在收尾…' },
+  ],
+  spin: ['🧠', '💭', '✨', '🔎', '⚡'],
+  eggs: [
+    '📎 顺手把要点整理好了，稍后一起给你',
+    '📶 网络有点忙，让它慢慢跑',
+    '🎯 结果快出来了，坚持一下',
+    '🗂️ 资料较多，正在汇总中',
+    '🌙 别盯着了，完成会自动通知你',
+  ],
+  eggAfterSec: 240,
+  intervalMs: 1500,
+  activityPrefix: '🛠️ 正在执行 ',
+}
+
 /** 毫秒 → 人类可读时长(如 "9 分 47 秒") */
 export function fmtDuration(ms) {
   const s = Math.floor(ms / 1000)
@@ -37,46 +61,42 @@ export function truncate(text, max) {
 }
 
 /**
- * 流式动画 v3(办公助手人设): 阶段化人格台词 + 旋转表情 + 进度条 + 已用时/剩余估算 + 长任务彩蛋。
- * 每 1.5s 更新一次同一条流式消息(共用 streamId), 直到 agent 完成。返回停止函数。
- * @param {() => string} [activity] - 可选: 返回当前真实活动描述(如 "📋 正在执行 <操作>"), 覆盖阶段台词。
+ * 流式动画 v3: 阶段化台词 + 旋转表情 + 进度条 + 已用时/剩余估算 + 长任务彩蛋。
+ * 每 intervalMs 更新一次同一条流式消息(共用 streamId), 直到 agent 完成。返回停止函数。
+ * @param {() => string} [activity] - 可选: 返回当前真实活动描述, 覆盖阶段台词。
+ * @param {typeof DEFAULT_THINKING} [thinking] - 动画素材; 缺省用 {@link DEFAULT_THINKING}。
  */
-export function startThinking(ws, frame, streamId, startedAt, timeoutSec, activity) {
-  const PHASES = [
-    [0, '🤔 正在理解你的需求…'],
-    [8, '📋 正在整理任务清单'],
-    [25, '🔍 正在查找相关资料'],
-    [55, '✍️ 正在处理文档/数据'],
-    [120, '🧠 正在思考最佳方案…'],
-    [240, '⏳ 任务较繁琐，请稍候…'],
-    [420, '☕ 快好了，正在收尾…'],
-  ]
-  const SPIN = ['🧠', '💭', '✨', '🔎', '⚡']
-  const EGGS = [
-    '📎 顺手把要点整理好了，稍后一起给你',
-    '📶 网络有点忙，让它慢慢跑',
-    '🎯 结果快出来了，坚持一下',
-    '🗂️ 资料较多，正在汇总中',
-    '🌙 别盯着了，完成会自动通知你',
-  ]
+export function startThinking(ws, frame, streamId, startedAt, timeoutSec, activity, thinking) {
+  const t = { ...DEFAULT_THINKING, ...(thinking || {}) }
+  const phases = Array.isArray(t.phases) && t.phases.length > 0 ? t.phases : DEFAULT_THINKING.phases
+  const spin = Array.isArray(t.spin) && t.spin.length > 0 ? t.spin : DEFAULT_THINKING.spin
+  const eggs = Array.isArray(t.eggs) && t.eggs.length > 0 ? t.eggs : DEFAULT_THINKING.eggs
+  const eggAfterSec = Number.isFinite(t.eggAfterSec) ? t.eggAfterSec : DEFAULT_THINKING.eggAfterSec
+  const intervalMs = Number.isFinite(t.intervalMs) && t.intervalMs > 0 ? t.intervalMs : DEFAULT_THINKING.intervalMs
   const total = Number.isFinite(timeoutSec) && timeoutSec > 0 ? timeoutSec : 600
   let i = 0
   const timer = setInterval(() => {
     const secs = Math.floor((Date.now() - startedAt) / 1000)
     const live = activity ? activity() : ''
-    let stage = PHASES[0][1]
-    if (!live) for (const [t, s] of PHASES) if (secs >= t) stage = s
+    let stage = phases[0].text
+    if (!live) {
+      for (const p of phases) {
+        if (secs >= p.atSec) stage = p.text
+      }
+    }
     const pct = Math.min(Math.floor((secs / total) * 100), 99)
     const filled = '█'.repeat(Math.floor(pct / 10))
     const bar = secs < 3 ? '' : `\n${filled}${'░'.repeat(10 - filled.length)} ${String(pct).padStart(2)}%`
     const remain = Math.max(total - secs, 0)
     const remainTxt = secs < 3 ? '' : ` · 预计还剩 ${Math.floor(remain / 60)}分${remain % 60}秒`
-    const egg = secs >= 240 ? `\n${EGGS[Math.floor(secs / 60) % EGGS.length]}` : ''
-    const emoji = SPIN[i % SPIN.length]
+    const egg = secs >= eggAfterSec && eggs.length > 0
+      ? `\n${eggs[Math.floor(secs / 60) % eggs.length]}`
+      : ''
+    const emoji = spin[i % spin.length]
     i++
     const status = live || stage
     ws.replyStream(frame, streamId, `${emoji} ${status}   ⏱ ${secs} 秒${remainTxt}${bar}${egg}`, false).catch(() => {})
-  }, 1500)
+  }, intervalMs)
   return () => clearInterval(timer)
 }