@modesto_ma/dsh-channels 0.1.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modesto_ma/dsh-channels",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "DeepSeek Harness (DSH) 飞书渠道插件：一个 dsh 实例对应一个飞书机器人，私聊/群聊/话题群 @ 触发会话，话题绑定 session，卡片 2.0 流式回复；Web 设置里提供「飞书渠道」状态与常用配置面板",
   "repository": {
     "type": "git",

package/src/cards/index.ts

@@ -7,5 +7,6 @@
 
 export * from './primitives.ts'
 export * from './streaming.ts'
+export * from './onboarding.ts'
 export * from './approval.ts'
 export * from './question.ts'

package/src/cards/onboarding.ts

@@ -0,0 +1,23 @@
+/**
+ * One-time onboarding card: what the bot does, how workspaces are scoped, and
+ * the command cheat sheet. Sent on the first private message of a chat.
+ *
+ * Static content, deliberately kept apart from the streaming reply card.
+ *
+ * @module dsh-channels/cards/onboarding
+ */
+
+import { card, markdown, note } from './primitives.ts'
+
+/** First-contact onboarding card (private chats only, once per chat). */
+export function buildOnboardingCard(): object {
+  return card([
+    markdown('**👋 欢迎使用飞书 DSH**'),
+    markdown('直接发消息即可开始一个会话，我会在话题里流式回复；话题内继续发消息无需再 @ 我。'),
+    markdown('**工作区**：私聊一人一个；群里每位成员各自一个，互不影响。'),
+    markdown('**常用命令**：`/help` 命令列表 · `/status` 会话状态 · `/workspace` 工作目录\n'
+      + '`/effort` 推理强度 · `/model` 模型 · `/permissions` 权限预设\n'
+      + '`/new` 新建会话 · `/stop` 中断当前回合 · `/history` 历史 · `/export` 导出日志'),
+    note('需要授权或补充信息时，我会发一张卡片，点按钮或直接回复即可。'),
+  ])
+}

package/src/cards/primitives.ts

@@ -57,6 +57,26 @@ export function textButton(options: TextButtonOptions): object {
   }
 }
 
+/**
+ * Collapsible fold panel: collapsed by default, grey rounded border, and a
+ * built-in right-aligned chevron that flips when expanded. Used for the
+ * streaming card's reasoning window and any future "secondary detail" area.
+ */
+export function foldPanel(title: string, content: string, iconToken: string): object {
+  return {
+    tag: 'collapsible_panel',
+    expanded: false,
+    border: { color: 'grey', corner_radius: '8px' },
+    header: {
+      title: { tag: 'plain_text', content: title },
+      icon: { tag: 'standard_icon', token: iconToken },
+      icon_position: 'right',
+      icon_expanded_angle: 180,
+    },
+    elements: [markdown(content)],
+  }
+}
+
 /** A row of equal-width columns, each holding one element. */
 export function columnSet(
   columns: object[],