@banana-peeljj12/dsh-trellis
Self-contained Trellis workflow trigger for DeepSeek Harness: per-turn breadcrumb injection via agent/pre-step, a bundled skill provider, and DSH-native task/phase state resolution. No Trellis AGPL code is vendored; workflow semantics are rewritten and licensed MIT.
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:1264459640/dsh-trellis说明文档
阅读完整 README ↗2. 配置白名单目录(重要)
为避免非预期介入,插件默认不会拦截未授权的目录。请在 Web 端或配置文件中添加生效路径:
- 打开 DSH Web 客户端,进入左下角 设置 → 插件 → Trellis 工作流;
- 在 白名单项目 (allowlist) 中添加需要启用该工作流的项目根目录绝对路径——既可手动输入, 也可点击 浏览… 按钮弹出系统文件夹选择器直接选取,保存后即时生效。
提示:若希望在方案定稿前限制模型修改源码,可在该设置页同时开启 规划期只读保护 (enforceReadonlyPlanning) 开关。
3. 开始使用
在对话中提出较复杂的需求时,模型会引导创建或推进工作流任务:
- 新增功能:创建
feat-mm-dd-name,推进prd→design→design-review→impl→review→check; - 修复问题:创建
issue-mm-dd-name,推进report→analyze→fix→fix-note; - 重构优化:创建
refactor-mm-dd-name,推进scan→design→apply→done。
如需在某轮对话中临时跳过工作流拦截,在消息中包含 no-trellis 即可。
配置项参考
可在 Web 设置面板(设置 → 插件 → Trellis 工作流)或 ~/.dsh/settings.yaml 中进行配置:
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
allowlist | string[] | [] | 生效白名单:允许插件接入的项目根目录绝对路径列表。为空时不介入任何项目 |
enforceReadonlyPlanning | boolean | false | 规划期只读保护:开启后,方案定稿前在运行时移除代码修改工具 |
skipKeywords | string[] | ['no-trellis'] | 跳过关键词:用户消息包含这些词时,该轮跳过工作流注入与拦截 |
injectStep | number | 1 | 面包屑提示词的注入步数,默认仅在每轮交互第 1 步注入 |
inline | boolean | false | 是否开启 codex-inline 风格的阶段解析模式 |