1264459640/dsh-trellis 预览 preview

1264459640/dsh-trellis

Plugin插件 Native原生 ⭐ 7 Subagents & Orchestration子代理与编排

Self-contained Trellis 工作流触发器,用于 DeepSeek Harness(DSH / Cordis)

Project Overview项目介绍

dsh-trellis is a workflow engineering plugin built exclusively for the DeepSeek Harness (DSH) agent platform. It draws inspiration from the stage specification and state machine design of the original Trellis project, and addresses common pain points that arise when large language models handle long-form coding tasks. Common issues it solves include starting code edits before finalizing a solution, scattered task todos across multiple files, and missing acceptance checks before marking tasks complete. To install the plugin, you first need to ensure your system has Node.js version 20 or higher installed, then run the DSH CLI install command and restart the DSH service after the installation finishes.

After installation, you must add the absolute paths of project root directories you want to use the plugin with to the plugin's allowlist, which you can do via the DSH web settings panel or the global DSH settings file. The plugin provides three built-in standard workflow tracks for feature development, bug fixes, and code refactoring, each with a predefined sequence of stages to follow. It also includes a five-state step machine with quality acceptance gates that require either AI automated verification or human approval before steps can be marked complete. This plugin is designed for developers working on complex long-term coding tasks with DSH, who want to enforce structured workflow constraints on the agent.

The plugin supports optional read-only protection during the planning stage, which disables code writing tools until the solution is approved to prevent premature code changes. It also supports session-level state isolation, so multiple concurrent sessions or parallel subagents do not interfere with each other's tasks. It includes a built-in dual-mode task board that can switch between a dense compact list view and a full-screen swimlane kanban view. When tasks are completed or archived, it automatically checks the cleanliness of the Git workspace to catch any uncommitted changes. The plugin is released under the open-source MIT license, and users can add the keyword no-trellis to a message to skip all workflow constraints for that single turn.

dsh-trellis 是专为 DeepSeek Harness (DSH) 开发的工程化工作流原生插件,借鉴了 Trellis 的阶段规范与状态机设计思想,用于解决大模型长程编程任务中常见的提前改码、待办分散、缺乏验收约束等问题。它通过 DSH 插件命令行工具安装集成,要求运行环境 Node.js 版本不低于 20,安装完成后必须重启 DSH 服务才能正常启用。

本插件提供了功能开发、缺陷修复、代码重构三类标准工作流轨道,内置五状态步骤状态机与质量验收门禁机制,还支持可选的规划期只读防止模型提前修改代码。用户需要先将目标项目根目录添加到插件白名单才能在对应项目启用功能,适合需要规范大模型复杂长程编程工作流的开发者使用。

本插件支持会话级状态隔离,避免多会话或并发子代理工作时相互干扰,内置双模态任务看板,支持紧凑任务列表与阶段泳道两种展示模式,任务完成归档时会自动校验 Git 工作区干净度。项目基于 MIT 许可证开源,用户可在单次对话中添加 no-trellis 关键词临时跳过工作流约束。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 7 stars - very few users, little community feedback星标只有 7,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add @banana-peeljj12/dsh-trellis@latest

把 1264459640/dsh-trellis 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-trellis

Trellis 工作流扩展 · DeepSeek Harness
结构化阶段流转 · 步骤状态机 · 质量验收门禁 · 可选规划期只读保护

License: MIT Node Version Step State Machine Verification Gate
🌏 中文 · English

紧凑任务列表与详情面板 泳道看板与空泳道折叠

重构泳道与任务详情


项目简介

dsh-trellis 是为 DeepSeek Harness (DSH) 开发的工程化工作流插件,借鉴了 Trellis 的阶段规范与状态机设计思想。

在大模型长程编程任务中,常见以下协作问题:

  1. 未理清方案便直接修改代码:容易引入方向性错误或破坏现有架构;
  2. 任务待办散落各处:需求文档、草稿文件与上下文记录多处待办,状态脱节;
  3. 缺乏验收约束:代码编写完成后直接标记完成,缺少自测验证或人工审核卡点。

dsh-trellis 通过统一的步骤状态机、任务阶段流转和运行时工具过滤,帮助大模型在复杂任务中遵循“先方案后编码、验证后再完结”的工程规范。


核心特性

  • 结构化阶段流转:提供特性开发(feat)、缺陷修复(issue)与代码重构(refactor)三条标准阶段轨道,引导模型逐步推进。
  • 统一执行清单:以任务根目录下的 task.json.steps 作为唯一的执行状态依据,避免分散维护清单带来的状态不一致。
  • 质量验收门禁:细化步骤流转状态(pending、in_progress、verifying、blocked、completed),支持区分自动化测试(AI 验证)与人工审批卡点,并在任务完结时严格检查验收状态。
  • 可选规划期只读保护:开启配置项后,可在方案获批前于运行时过滤掉代码写工具(write / edit),仅开放文档受控修改通道,确保方案敲定后再动代码。
  • 会话级状态隔离:各会话的任务绑定关系独立存储在 .trellis/.runtime/sessions/ 中,多会话与并发子代理并行工作时互不串扰。
  • 双模态任务看板:常态为高密度紧凑任务列表(类型徽章 + 标题 + 阶段 + 步骤简标),可一键展开为全屏泳道看板(按工作流阶段细分泳道、空泳道自动折叠、实时搜索与类型筛选、归档泳道);操作全面图标化(自包含内联 SVG 图标体系),右侧详情面板内置 Step Tracker 步骤流水线、产物文件树与胶囊属性标签。看板保持克制交互——不直接改任务状态,只提供「▶ 推进任务」将指令注入输入框由 Agent 执行,产物点击生成 @.trellis/tasks/... 原生文件引用交给 DSH 原生查看。
  • Git 干净度校验(支持局部校验):任务完成和归档时自动检查 Git 工作区状态,防止遗留未提交的脏代码。若工作区存在与任务无关的未提交改动,可在 trellis_task_update / trellis_task_archive 中通过 modified_files 声明任务实际改动文件,校验将限缩到清单内文件(须已提交),清单外未提交改动仅告警、不再阻塞;未传该参数时保持全局严格校验。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-all-in 下一个 Next Solarized-dsh-theme →