dsh-superagent 部署跑不通？新手配置、权限与工具调用的排查指南

dsh-superagent 部署跑不通新手配置、权限与工具调用的排查指南【免费下载链接】dsh-superagent-prototypeTowards a More Autonomous Agent System项目地址: https://gitcode.com/gh_mirrors/ds/dsh-superagent-prototypedsh-superagent 是一个面向单个 GitHub 仓库的主动编码智能体当被允许的账号在 Issue、评论或飞书群里 它之后它会自动创建任务、在独立的会话和目录里修改代码然后回到原对话交付结果通常是 Pull Request。它打包在 DeepSeek Harness 框架上运行并附带一个网页面板展示需要人工介入的事项。这篇文章不讲解代码实现只回答一个问题为什么你配了之后它就是不工作。它写给三类人有 GitHub 仓库、希望减少重复性开发流程、并且由几个人小团队协作的人。如果你只是想找一个写文案的聊天机器人可以关掉本页。下面把跑不通拆成可判断的信号给你一套从现象到修复的标准动作。先判断它适不适合你的场景在排查之前先确认边界能省掉大量无效调试。适合你维护一个 GitHub 仓库github.com 公有云不支持 GitHub Enterprise Server希望 Issue/评论里的需求能被自动接单并产出代码变更。你有 Node22.19 或 24、git、pnpm、Python 3.8、tmux 这些基础设施并且配置了可用的模型服务商账号——模型能力来自你配置的提供商本地不需要 GPU 或大模型。你接受一个仓库、一个代理账号的克制设计飞书接入作为可选项lark-cli 自建应用机器人。不适合需要同时处理多个仓库、或希望覆盖多个代码托管平台。期望开箱即全自动默认策略偏保守先观察它本会做什么再逐步放开授权。把它当生产级软件它是研究原型README 明确提醒可能存在 bug、风格不一致接入前需自行审查。判断清楚之后再往下排障。新手最常卡住的三类信号绝大多数报错可以归入信号的三个阶段身份没通过、请求没触发、任务没执行。对号入座比逐个试错快得多。身份信号先确认代理账号和 CLI 本身可用这一类现象是请求明明发到了正确的地方但系统表现为无反应或反复提示账号问题。根因几乎都在它能不能以自己的身份干活GitHub 侧面板提示代理的gh命令行未设置、找不到、或读不到账号时依次确认三件事——CLI 包装脚本装好了没有、脚本是否已用自己的凭据登录、该账号对目标仓库是否有写权限。写权限缺失的典型提示是某账号读不了/推不上去某仓库。飞书侧它要求一个纯机器人身份的lark-cli配置。如果你把带个人登录的配置指过去检查会直接拒绝原因是这个 CLI 能以人的身份发言。给它一个独立的配置目录和只限机器人身份的 strict-mode 设置即可。排查顺序固定为先验身份再验权限最后验仓库地址是否写错。面板上这类需要你动手的提示一般会直接链到对应设置项顺着点比翻日志快。触发信号没有生成任务时先查触发源没触发和参数不对是两件事面板上有没有生成工单Ticket是一秒区分法没有工单说明请求根本没被接收查触发链路有工单但失败才去查执行链路。没工单时按顺序检查喊话方式在 GitHub 上编辑旧 Issue 正文追加 不算触发必须发一条新评论轮询间隔默认一分钟先稍等再看。白名单Policy 里对应来源的允许账号列表为空或你的账号不在名单里任何请求都无法变成任务。来源开关对应 Source 是否处于开启状态。全局暂停处理流程被暂停时一切输入都会被挂起。执行信号任务失败时先看执行目录和依赖版本工单已生成但卡在失败通常落在执行环境。系统内部有几档完全不同的时间预算超时的含义是耐心到了而不是进程崩溃调用外部命令行工具约90 秒无响应即判超时为工单准备目录的操作最长约10 分钟一轮任务结束后后台仍在跑的任务最多再保留30 分钟到点被回收判断这条请求该不该接的评估超时可在30 秒到 10 分钟之间调整。两个高频误判输出被截断不等于结果不全。命令行输出有上限超出会直接提示打印内容过多上下文读取要分页提示词配置也有字数上限、超了拒存。对策是分次读取、先要摘要再要细节这是使用智能体类工具的基本功。很多超时背后是一个卡住的交互提示比如在等登录确认。用同一个账号、同一套环境手动执行一遍那条命令真实报错会立刻显形。把慢操作放到后台执行不要让它们堵在关键路径上。从报错到修复的标准动作拿到现象后按看现象 → 归类 → 执行动作 → 避开误区走不要先重启。第一步看面板和状态。scripts/dsh-superagent status的退出码是一张体检表0服务正常运行别动它。1没跑起来、跑了两个实例、无响应、或运行时报错——只有这一档重启才有意义。2服务活着但某个部件如某个来源同步报错——重启无效要修那个部件errors字段会点名具体部件。3服务在等你的配置补齐——重启更无效补完设置它自己恢复。第二步给报错归类。现象关键词归属动作CLI 未设置/找不到/读不到账号身份修 CLI 路径、重新登录读不了/推不上去仓库权限给代理账号仓库写权限没有工单生成触发查喊话方式、白名单、来源开关、是否暂停准备命令失败、路径不认路径修正准备命令与目录根重试该工单凭据配置读不到版本升级 git2.32等依赖到要求范围403/409/400接口见下一节改请求方式而不是重试第三步改对地方。身份和权限问题改账号与配置路径问题改执行环境设置版本问题对齐依赖接口问题改请求。只有第 1 档状态适合重启——对 2 和 3 反复重启属于无效操作。常见误区把重启当万能药用编辑正文的方式 代理拿着个人账号配置去配机器人来源看到超时就断定服务坏了。版本、配置与接口边界这三类问题看起来毫无逻辑实际都有确定解法。版本不对齐。典型症状git 太旧读不到代理凭据配置dsh版本超出package.json里engines.dsh声明的范围日志提示插件与运行框架不兼容升级 DeepSeek Harness 后面板加载不出插件会话恢复时报agent-preset/not-found。共同点是代码和配置都没错只是版本没对齐。处理办法两条依赖版本装进项目声明的范围升级框架后重启运行中的实例让它重新加载对应产物。另外被新版本迁移过的数据库无法被旧版本打开回滚必须依赖升级前的备份。占位符没替换。示例配置 examples/profile.cordis.patch.yml 里所有placeholder必须逐一替换。两个硬约束stateDir必须是绝对路径出现任何系统不认识的配置键会直接阻止启动日志会指出键名。还有一类隐蔽拦截如果它发现自己管理的worker-bin、worker-gitconfig目录里存在非它写入的文件会停止设置流程——这是防止更新时覆盖你的手写内容。解法是把文件移走或换一个stateDir。接口状态码不是服务器故障。管理 API 限定从本机访问127.0.0.1或localhost且请求需携带约定头x-orchestrator-request: 1403请求方式不合规——不是从本机地址发出或缺少约定请求头、Origin来自其他站点。它不是你没权限而是敲门姿势不对。409你提交时携带的是旧版本号revision服务端已有更新。重新拉取最新 revision 再提交即可。400值不合法响应会列出具体字段路径、账号检查未通过、或请求体不是合法 JSON / 过大。读懂状态码指向的约束比盲目重试有用得多。收尾三条行动清单先让看板变绿再谈效果。依次完成CLI 安装与登录 → 仓库写权限 → 白名单与来源开关 → 执行目录与准备命令。状态码为 0 之前任何它不聪明的结论都不成立。报错先分类再动手。没听见查触发、没权限查账号、没参数查目录与命令、没等到查超时与交互卡点、版本不对查依赖范围——分类错了努力全白费。先窄后宽。保持默认的低主动策略观察它本来会做什么确认靠谱后再逐步放开授权让服务状态稳定比追求全自动更重要。它只盯一个仓库、只接一个平台、飞书可选项——这种克制反而让配置问题都有确定的排查路径。如果你部署时卡在了某个状态码或某条提示上欢迎在留言里贴出现象和面板状态也许正好能帮到下一个遇到同样问题的人。【免费下载链接】dsh-superagent-prototypeTowards a More Autonomous Agent System项目地址: https://gitcode.com/gh_mirrors/ds/dsh-superagent-prototype创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考