dsh-agent-kit

更新日志

更新日志

v0.3.0 2026-10-21

  • 支持 dsh 0.2.1-rc.2：agentTasks 改为直接调用 provider 的 start()（dsh 0.2 移除了 subagents.start），peer 依赖放宽到 cordis 4.0.5 与 dsh-typert-protocol 0.2.1-rc.2，CI 新增 dsh-021 任务。dsh 0.2 起某一行配置有误时只有该行不运行。
  • 新增渠道公共约定 ChannelService 与 ChannelAtMessage，为接入飞书、企业微信做准备；钉钉消息新增 senderId，原有字段不变。
  • 钉钉收件的路由、去重、队列与超时逻辑抽为与渠道无关的 MessageRouter，行为不变。
  • ctx.notify：未指定 targets 时发往默认渠道，指定了则只发这些渠道并行发送；返回 { deliveries }，单个渠道的失败只出现在它自己的结果中。
  • 删除 notify.use() 运行时切换；status() 改为 { defaultChannel, channels }；login() / logout() 必须指定渠道。
  • admin：doctor 与 setup 按默认通知渠道检查与配置。
  • 新增 ctx.feishu：飞书机器人（自建应用）身份，进程内使用 @larksuiteoapi/node-sdk（可选依赖）；发送文本或 Markdown 卡片，长连接接收群内 @ 机器人与私聊机器人的消息并按会话分发。
  • 新增 ChannelInbox 约定与通用的未命中消息存储；notify 的 targets 可写 'default' 表示使用该渠道的默认目标。
  • admin：设置页新增飞书卡片（App ID、域名、App Secret、会话路由、未命中消息），doctor 检查 SDK、凭据与机器人能力，setup 引导配置；钉钉的路由与未命中面板改为通用组件。
  • 新增 ctx.wecom：企业微信智能机器人（长连接），进程内使用 @wecom/aibot-node-sdk（可选依赖）；以 Markdown 发送，接收群内 @ 机器人与单聊消息并按会话分发，记录与机器人说过话的会话作为主动发送目标。
  • 消息处理函数的第二个参数新增 reply()：钉钉、飞书发回原会话，企业微信基于收到的消息回复。
  • admin：设置页新增企业微信卡片，收件人选择组件改为三个渠道共用；doctor 检查 SDK、BotID 与 Secret（不在线检查，避免挤掉运行中的连接），setup 提供需确认的连接测试。

v0.2.0 2026-09-28

  • 移除飞书 Service、CLI 检查与文档；钉钉只保留当前 dws 登录账号的 user 身份，不再支持机器人或 webhook 身份。
  • 钉钉新增群内 @ 当前 user 的消息监听：设置页按群 ID 指定业务插件，未命中消息按账号留存并可查看群名；业务插件决定是否回复及如何处理。
  • 业务插件可以搜索当前账号可见的群或个人，并在自己的设置字段中选择稳定 ID 作为发送目标；群消息接收路由与主动发送目标分别配置。
  • Agent 任务支持为代码任务创建独立 Git worktree；项目选择、仓库路径和可写权限由下游业务插件负责，不自动提交、推送或合并。
  • 设置页隐藏钉钉发送身份、默认目标、dryRun 与通知 Service 卡片；钉钉设备授权链接可在本机生成二维码，授权是否成功仍取决于 dws 和组织权限。
  • ctx.jev 可在 TypeSafe Jev 与本地部署的 Laya 之间二选一：新增 provider、baseURL、apiKeyRef 配置；选 laya 时不读取、也不发送 TypeSafe Key，业务代码不用改。
  • admin 包：设置页、setup 与 doctor 支持 Laya（服务地址、可选的 Laya Key、连接检查）。
  • Laya 截断告警：新增 contextTokens 配置，输入占满上下文窗口时记 warn 日志，judge() 结果带 truncated: true，health() 计数器 truncated 加一。

v0.1.0 2026-09-24

  • 五个 Service：ctx.agentWs（WebSocket 客户端）、ctx.dingtalk（钉钉 user 推送）、ctx.notify（通知转发至钉钉）、ctx.agentTasks（Agent 任务）、ctx.jev（Jev 判断），默认禁用、按需启用。
  • 统一的 KitError 错误模型、health() 健康状态与 agent-kit/service-failed 事件、日志统一脱敏。
  • 钉钉 user 登录状态与设备流登录：status()、login()、logout()；ctx.notify.status() / login() / logout() 转给钉钉。
  • 两个包：@baoyx/dsh-agent-kit 是给业务包用的库；可选的 @baoyx/dsh-agent-kit-admin 提供 doctor 检查、setup 交互式配置、dsh Web「设置 → Agent Kit」页与业务包设置入口的登记。
  • TypeSafe Key 可来自环境变量、macOS 钥匙串（ai.typesafe.api-key）或 dsh 凭据文件。
  • Linux、macOS、Windows 三平台 CI 通过。
  • @baoyx/dsh-agent-kit/testing：本地 WebSocket 测试服务端、假 subagent provider、Jev mock、假 dws。