前言¶
在 DeepSeek Harness(DSH)里写代码时,主会话模型往往刚改完就自检:读的是同一份上下文、沿同一条思路,很难发现自己刚才的判断错在哪。换一套模型、另一套工具循环去读同一份代码,得到的是独立判断——这就是「第二意见」的价值。
下面介绍社区工作流插件 dsh-connect-atomcode(维护者 eghrhegpe):把本机已登录的官方 AtomCode 二进制接到 DSH,让主模型通过工具或斜杠命令发起评审,并在输入框下方查看本机 AtomGit CodingPlan 的 5 小时滚动窗口用量。插件当前 npm 版本为 0.6.2,许可证 MIT。
这是什么¶
一句话:无外部 API Key,走本机 AtomCode daemon,在 DSH 里提供 atomcode_ask 工具、/atomcode-review 命令,以及 CodingPlan 额度显示。
- 目录页:skillhub.cn 插件页
- 源码与文档:GitHub — eghrhegpe/dsh-connect-atomcode
- 分类:工作流
消耗的是你本机 atomcode login 后账号自带的 CodingPlan 免费额度(按 5 小时滚动窗口计量),不计入当前 DSH 会话的 token 账单,但窗口用满需等待重置。
核心功能¶
插件 README 归纳了三项交付物:
| 能力 | 形态 | 说明 |
|---|---|---|
atomcode_ask |
主会话模型可调用的工具 | 一条消息进、一个完整自主回合出(自带工具循环,可自行决定读哪些文件、跑哪些命令);底层为 daemon POST /chat(SSE),token 来自 ~/.atomcode/daemon-13459.json |
/atomcode-review |
斜杠命令 + 回复下方「锐评」按钮 | 宿主侧执行,不占用主模型回合;适合对已知的 diff、未提交改动、分支或 PR 做有界自查 |
| CodingPlan 额度 | 输入框下紧凑标签 + 详情 | 本地解析额度文本,例如 atom · 4% · 48m50s 后重置;不接外部 Key |
边界:模型工具表里只有 atomcode_ask。/atomcode-review 只能围绕一个 diff 做窄口自查;需要顺着调用链追问题时,应让主模型调用 atomcode_ask。早先的 atomcode_review 工具已退役。
安装与启用¶
前置条件¶
- AtomCode 官方二进制(v5.x) 在 PATH 中可用(也可用环境变量
ATOMCODE_BIN或 patch 配置项binary)。macOS 从访达启动 DSH 时 PATH 可能与终端不同,插件会在自动探测失败后依次尝试/opt/homebrew/bin/atomcode与/usr/local/bin/atomcode。 - 已登录:
~/.atomcode/auth.toml(可用atomcode status检查)。 - 默认模型可用:
~/.atomcode/config.toml的default_model,或在调用时指定provider。 - daemon:
atomcode daemon --port 13459;默认配置下插件会在需要时 detached 拉起(冷启动约 1.5–4.5s)。若设置auto_start: false,需自行启动 daemon。
安装命令(任选其一)¶
普通用户从 npm 安装:
dsh plugin add dsh-connect-atomcode
从 GitHub 安装 main 分支:
dsh plugin add eghrhegpe/dsh-connect-atomcode
本地开发 link(示例为 web profile):
dsh plugin --profile web add link:<开发目录>
bundle 自带 cordis.patch.yml,一般无需再手写 profile patch。安装后需重启 DSH 进程(patch 在启动时读取;仅改前端 client.js 时刷新浏览器即可)。
典型用法¶
让主模型去问(日常主力)¶
在对话里说明意图即可,例如:
用 atomcode_ask 锐评一下当前代码
主模型会组织提问;返回的判断来自 AtomCode,而非主模型自行补写。需要续接同一条 AtomCode 会话时可使用 continue: true;daemon 会话过期时用 reset_session: true 重新开线。
斜杠命令与按钮¶
已知评审目标时,可直接输入:
/atomcode-review <评审目标>
命令由宿主侧执行,结论以卡片形式回到会话。每条助手回复下方的 「锐评」 会把该条内容填成 /atomcode-review 的目标,不会自动发送,按回车后才执行。
工作目录¶
atomcode_ask 与 /atomcode-review 都需要可解析的 working_dir(调用参数、patch 配置 working_dir 或宿主会话 cwd 三层之一)。三层都取不到时会拒绝该回合(除非调用方传 allow_unattended: true)。
配置要点¶
完整字段语义以仓库内 cordis.patch.yml 为准。常用项包括:
| 键 | 默认 | 作用 |
|---|---|---|
port |
13459 |
ask 使用的 daemon 端口 |
auto_start |
true |
探测不到 daemon 时自动拉起 |
approval_mode |
bypass |
ask 回合内 AtomCode 侧工具审批档(build / accept_edits / bypass / plan) |
default_provider |
'' |
缺省模型档位名,ask 与 review 共用 |
ask_max_rounds |
25 |
工具调用次数上限(按 SSE tool_start 计) |
quota_refresh_secs |
60 |
CodingPlan 额度刷新间隔;0 关闭额度显示 |
部分字段(如 approval_mode、working_dir、ask_max_rounds)只能在 patch 中修改,面板不提供输入框。
适用场景与注意¶
适合:改动涉及核心逻辑、并发、安全或数据正确性,或你对结果没把握时,花一次 CodingPlan 额度换独立评审;已明确 diff 范围时用 /atomcode-review 更省主会话 token。
不必每次都用:改样式、改文案等小改动,可等需要时再跑。
安全与信任:插件以当前 DSH 进程权限运行,会拉起本机 AtomCode daemon、读写配置与会话状态。安装前请阅读源码与 MIT 许可证,确认与本机安全策略一致。ask 与 review 均走本机 daemon token,不接任何外部 API Key。
生态说明:DSH 奉行「一切皆插件」;skillhub.cn 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-connect-atomcode 把「写完代码,换一双眼睛再读一遍」落到 DSH 工作流里:主模型保留编排权,AtomCode 提供另一套上下文下的判断,并在界面里透明展示 5 小时窗口用量。