Skip to content

Chatbot

DevStar Bot edited this page Nov 18, 2026 · 4 revisions

DevStar Chatbot 使用指南

Chatbot 是 DevStar 的对话助手,可在网页、微信或飞书中使用。它能基于你有权限访问的仓库回答问题、创建工单、执行相关API,以及触发Agent执行任务。微信、飞书和网页使用同一套DevStar平台能力,但各渠道的会话分别保存;在微信里选中的仓库不会自动成为网页会话的当前仓库。

网页用户可以直接使用右下角的 AI 助手,内置 AI 有兜底 API,无需先配置模型。设置了自定义 API 时按现有优先级使用,见Agent Team 使用指南。只有需要在微信或飞书中使用时,才进行下面的绑定。

可选:绑定微信或飞书

点击 DevStar 右上角用户账号图标,打开「设置 → AI设置 → IM绑定」(/user/settings/ai/im)。

  • 微信用户:按页面指引扫描二维码绑定个人 Bot,然后用扫码的同一个微信账号与 Bot 私聊;换号使用需要重新绑定。
  • 飞书用户:在飞书开放平台创建一个自建应用,拿到它的 App ID 和 App Secret;将 App ID 和 App Secret 填入同一设置页并保存。保存后 DevStar 会通过长连接把该机器人接上线,之后在飞书里私聊它即可对话。

按钮交互:要让卡片上的「允许 / 选项 / 运行」按钮可用,飞书应用后台还需订阅卡片回传交互事件(card.action.trigger,订阅方式选长连接)。不订阅则卡片能显示、但点击无响应。

绑定成功不代表已经选择仓库。Chatbot 只能访问当前 DevStar 用户有权限的仓库;某仓库若未启用工单功能,无法在其中创建工单。

IM 的默认仓库会保存,服务重启后也可能继续使用。首次欢迎消息会显示当前仓库;开始新项目之前,请用 当前仓库 核对,或明确发送 使用仓库 owner/repo 切换。

网页端使用方法

在仓库 / 工单页面右下侧点击图标打开「DevStar AI 助手」面板,直接用自然语言提问或下达指令,例如「查看 issue #12 的内容和状态」。需要确认的操作会弹出确认条,点「允许」后执行;结果会直接呈现在对话里。

微信 / 飞书三步上手

先发 列出仓库。Bot 会返回带序号的可访问仓库列表,例如 3. team/project。直接回复 3、复制整行 3. team/project,或发送 使用仓库 team/project 都可以选中它。发送 当前仓库 可以核对是否已选中。列表中的序号对应当次展示的仓库;重新列出后请按新列表选择。

然后明确说出要做的事,例如:

创建一个工单:标题「增加用户注册与登录」;正文「用户可以注册账号并登录。请先给出实现方案,验收标准是注册成功后可登录,错误凭据有明确提示。」

创建工单属于写操作。Bot 会先展示目标仓库、标题和正文的确认请求;核对无误后,微信里回复 确认 或菜单中的「允许」序号,飞书里点击「允许」。只有确认成功后才算创建,请以返回的工单编号和链接为准。若内容不对,回复 取消,然后重新描述。不要把最初的“收到,正在处理…”当成创建成功。

也可以只发送 创建一个工单,为项目增加注册登录。Bot 应保留这句话表达的需求,整理简洁草稿并发起确认;实现细节可以留待工单内补充。若需要先检查项目是否已有该功能,请明确说 先检查当前注册登录功能,再帮我整理工单。只有草稿文字、没有系统生成的确认请求时,还没有进入提交步骤。

如果 Bot 仅说“已记录仓库”,但 当前仓库 仍显示未选中,请使用明确的 使用仓库 owner/repo 指令重试;自然语言里提到仓库名称不等于切换会话仓库。

常用操作

输入 作用
列出仓库 / 我的仓库 列出当前账号可访问的仓库,支持回复列表序号
使用仓库 owner/repo 为当前 IM 会话选仓库;切换到另一仓库时会开启该仓库的新对话上下文
当前仓库 / 状态 查看当前仓库
清除仓库 清除当前仓库,回到无仓库会话
列出 Agent / 在线 Agent 查看当前仓库可用的在线 Agent
@Agent名 具体任务 把任务交给已启动、且在此仓库可用的 Agent
新对话 清空当前对话上下文;不会清除已选仓库
帮助 查看 Bot 内置指令

对当前仓库的已有工单,可发送 查看工单 #17、owner/repo#17 或工单链接,读取真实标题、正文和状态;查询其他仓库时请先切换仓库。需要根据工单继续规划时,打开工单,在评论中说明目标或使用侧栏“分析当前讨论”,按 Agent Team 的讨论规划设置处理。

结果要求补充信息时,在对应讨论中回答具体问题并核对下一轮建议。已提交的任务可根据返回链接查看;历史固定步骤的任务记录不能作为新的执行入口。

任务、审批与交付

  • 可以用自然语言查询可用 Agent、任务进度、Issue/PR 和当前 CI。创建工单后,AI Issues 分析和 Planner 建议会显示为讨论卡片;需要补充信息时直接回答,内容会写回真实讨论。
  • 正文草案和 Planner 委派通过卡片授权。草案与委派同时存在时,先按保存的草案应用正文,再投递 Agent。重复操作返回原结果,不重复创建任务。
  • Agent 候选改动必须通过「批准发布」才能发布;「暂不批准」只收起当前会话的提示,不取消任务,也不消费网页审批。
  • 交付卡片区分 artifact 与 approved:前者只核验任务与真实 PR/提交的关联,后者表示按候选审批校验。两者都不等于测试通过或允许合并。平台 CI 按对应交付提交展示,不使用 Agent 自述代替真实检查。
  • 终态结果会尽力推送到原渠道;重复通知按业务版本去重。通知不是可靠队列,若暂时缺少回执,请查询任务或打开 Issue/PR 核对,不要重复提交相同操作。

网页端可在仓库或工单页面打开「DevStar AI 助手」面板使用同样的功能。切换仓库或开启新对话不会取消已提交的后台任务;旧任务仍会回到原渠道,但会标明原仓库和任务,不把旧问题或菜单带入当前对话。

打开返回的工单后,可按 AI Issues 查看默认创建分析;需要继续评论规划或委托时,再按 Agent Team 开启相关功能,不依赖固定步骤链。

功能边界与排查

  • Chatbot 不会仅凭“已记录目标仓库”的自然语言回复切换仓库;以 当前仓库 的服务端状态为准。
  • 查仓库文件、分支、差异等需要已选中仓库及相应访问权限;仓库不可访问或未启用对应功能时,工具不可用。创建工单需要仓库启用工单功能,并在用户确认后执行。
  • Chatbot 可以创建和查询工单、委派可用 Agent。委托和写入遵循当前权限与授权规则;分析结论应以实际仓库内容、工单和工具结果为依据。
  • 微信是纯文本交互:飞书/网页中的按钮会变成文字菜单,回复最新菜单的序号或指令;不要把旧菜单序号用于新菜单。
  • 重复点击同一个确认会返回原结果,不会再次执行。若操作已获确认但结果尚未结算,不会自动重放;补充提交失败也不自动重试。先核对工单/任务,再明确发起新操作,不要把暂时没有回执当成失败。
  • 如果 列出仓库 为空,先确认 DevStar 账号对目标仓库有访问权限。如果 当前仓库 正确但 Bot 仍无法创建工单,检查该仓库是否启用了工单功能及 AI 模型配置;若确认请求未出现,先不要反复发送 确认 或重复提交创建请求。

Clone this wiki locally