跳到主要内容
dsh marketplace

dsh-dev-loop

已验证

dsh-dev-loop · v0.10.0 · MIT · Web 界面

DSH Dev Loop — project-level Build/Test/Run/Restart development panel for DeepSeek Harness

安装

dsh plugin add dsh-dev-loop

用 dsh --profile default --dump-config 确认 layer 已生效 —— 参见安装指南。

源码

发布到 npm 但没有公开仓库。安装前请检查包内容。

标签

说明文档

dsh-dev-loop

项目级 Build / Test / Run / Restart 开发循环面板 for DeepSeek Harness (DSH)。

在 DSH Web 里，基于当前 workspace 的 .dsh/devloop.yml 定义动作（build/test/package/run/logs…），一键执行、流式输出、查看退出码/耗时、取消、打开完整日志，并能把最近一次失败输出发送给当前 Agent。

Why

Agent 改完代码后，需要反复手动跑构建、测试、重启，才能确认项目状态。DSH 内部没有统一的开发循环面板。

dsh-dev-loop 解决：

  • 把重复的 build/test/run 动作变成面板按钮
  • 输出流式可见，失败可一键发给 Agent
  • Watch Mode 和 After Agent Turn 让验证自动化

Features

  • 自动识别当前 workspace，读取其 .dsh/devloop.yml
  • 动作按钮：Build / Test / Package / Run-Restart / Stop / Open logs
  • 每次命令执行：child_process.spawn 流式输出、退出码、耗时、可取消
  • ANSI 安全渲染（内存中剥离转义序列）、输出最大长度（默认 200k 字符）
  • 完整日志本地保存：~/.dsh/dev-loop/logs/<project>/<timestamp>-<project>-<action>.log
  • secrets redaction：env 里 KEY/TOKEN/SECRET/PASSWORD 等敏感键的值在输出中替换为 ***
  • Send last error to Agent：把最近一次失败输出（bounded context）经 DSH agent 接口送给当前会话（Agent 不可用时回退为提示复制）
  • Trust boundary：命令完全来自 workspace 自身的配置文件，首次执行前需确认信任；信任记录持久化在 ~/.dsh/dev-loop/trust.json
  • 配置支持 cwd / env / timeout / shell / dependsOn / watch / afterAgent
  • 预设模板：Node / Python / Rust / .NET / Godot —— 只生成 yml，不写死框架
  • Watch Mode（默认关闭）：监听路径变化，去抖后自动执行指定 action；内置防无限循环、防重入、queued-latest
  • After Agent Turn（默认关闭）：Agent 完成一轮后自动执行指定 action；失败只显示 FAIL，不自动让 Agent 无限修
  • Generate preset：面板内生成模板，或 CLI pnpm preset --framework <fw> --output PATH 写盘

Screenshots

Main UI

Useful state

Install

前置条件：已安装 DSH CLI（@deepseek-ai/dsh），且本机已有目标 profile（示例为 web）。

git clone https://github.com/nzl153/dsh-devtools.git
cd dsh-dev-loop
pnpm install
pnpm build
dsh plugin --profile web add link:"$(cygpath -m "$PWD")"

装完重启 dsh web。之后 client-only 改动走 HMR：

pnpm dev

Usage

  1. 在项目根目录创建 .dsh/devloop.yml，定义 actions
  2. 安装插件并重启 DSH
  3. 打开 Dev Loop 面板，首次执行某个动作时确认信任
  4. 点击 Build / Test / Run 等按钮
  5. 失败时使用 Send last error to Agent

最小配置示例：

name: my-app
actions:
  build:
    command: npm run build
  test:
    command: npm test
    dependsOn: [build]
  run:
    command: node .
  logs:
    file: logs/app.log

更多示例见 examples/。

Development

pnpm install
pnpm dev
pnpm dev:client
pnpm test
pnpm build

工程命令：

pnpm typecheck    # tsc --noEmit
pnpm test         # vitest 单测 + client bundle smoke
pnpm build        # 双 half 构建 + verify-build
pnpm verify:hmr   # 校验 profile link / realpath / graph rev 与本地 bundle hash 一致
pnpm preset       # 生成预设模板（--framework node|python|rust|dotnet|godot）
pnpm e2e          # 不启动 DSH 的端到端执行验证（先 build）

HMR 约定：

  • client-only 改动：DSH 运行时 HMR 自动生效
  • host 改动（src/host/**、package.json 结构、cordis.patch.yml）：需要重启 DSH

Compatibility

  • 测试过的 DSH：@deepseek-ai/dsh 0.1.0-rc.6
  • 测试过的 profile：web
  • 测试过的平台：Windows（Git Bash / MSYS）

未在其他 DSH 版本上验证，不承诺跨版本兼容。

Privacy

  • 命令输出与日志保存在本地 ~/.dsh/dev-loop/logs/
  • 信任记录保存在 ~/.dsh/dev-loop/trust.json
  • secrets redaction 在本地输出前完成，不联网
  • 不向 DSH Session durable log 写自定义事件

Security

风险等级：Medium（会执行 workspace 配置中的命令）。

  • 命令完全来自当前 workspace 的 .dsh/devloop.yml，不是来自插件作者
  • 首次执行前，面板明确提示信任边界并要求确认
  • 确认后写入 ~/.dsh/dev-loop/trust.json（按项目根记一条），后续同项目不再重复确认
  • HTTP API 只接受回环地址 + 同源请求（127.0.0.1 / ::1、sec-fetch-site 非 cross-site、origin 与 host 同源）
  • 撤销信任：删除 trust.json 中对应条目或清空该文件
  • secrets redaction 是基础文本替换，不保证覆盖所有输出路径

Limitations

  • Watch 使用目录级 fs.watch 递归守护，删除整个监听根目录后需要重新 Start 才能恢复
  • Watch 的自动执行仅在项目已 trust 时生效；未信任时面板会提示，需先确认信任再 Start
  • After Agent Turn 只监听 reason=completed 的完整回合；用户主动 abort/error 回合不会触发自动执行
  • Windows 下取消命令使用 taskkill /T /F 杀进程树；非 Windows 用 SIGTERM
  • stdout/stderr 合并到同一输出流；不做分离着色
  • logs 类动作只返回文件路径信息，不实时 tail
  • Send last error to Agent 依赖目标会话存在 live agent；离线/无 agent 时回退为提示复制

Roadmap

  • 日志实时 tail
  • stdout/stderr 分离视图
  • 更完善的 secrets redaction（结构化输出路径识别）
  • 多项目同时管理

以上均未实现。

License

MIT