SajoLuo/dsh-trellis ↗★ 1

dsh-trellis

集成Trellis工作流状态面包屑与命令 适合需要深度整合Trellis工作流并追踪每轮对话状态的用户。

包名
dsh-trellis
兼容性
待验证
Harness 依赖范围
^0.1.0-rc.6 || ^0.1.1-rc.1 || ^0.1.2-alpha.1 || ^0.1.3-alpha.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.2 || ^0.1.7-rc.1 || ^0.2.0-rc.1
Cordis 依赖范围
^4.0.2
版本
0.1.10
许可证
MIT
最近更新
2026年9月29日

同名包的其他仓库

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:SajoLuo/dsh-trellis

装进实际使用的 profile(均在该 profile 下次启动时生效)

dsh plugin --profile web add dsh-trellis dsh plugin --profile headless add dsh-trellis

配置

支持 Settings 的 DSH Web profile,在新版打开“插件 → dsh-trellis”,旧版 RC 打开“设置 → 插件 → 插件配置 → Trellis 工作流”。0.1.7-rc.1 起(含 0.2.0-rc.1)保存到当前 profile 的 cordis.patch.yml,全局 patch 和命令行覆盖仍优先,无法生效的表单写入会被拒绝;旧宿主仍保存到 settings.yaml。

升级前备份 settings.yaml 和各 profile 配置。新版宿主会把旧文件改名为 settings.yaml.imported,并向首次启动的 profile 按 entry id 一次性导入;拒绝的 section 只保留在备份文件,不会自动重试。插件不会自行重命名、删除或跨 profile 复制配置;应先安装兼容插件,再启动迁移,并核对其他 profile 的需要。

Headless、rc.6 或需要声明部署默认值时,仍可在 profile 的 cordis.patch.yml 里覆盖(整行替换);Web 卡片的“恢复配置文件值”会清除用户层字段并重新继承这里的值:

- id: dsh-trellis
  config:
    maxBytes: 4096          # 面包屑注入的字节预算(0 = 关闭注入)
    skipKeyword: no-trellis # 提示词中的独立单词可跳过当轮注入(空 = 禁用)
    pythonCmd: ""           # 空 = 自动选择:Windows 先 py -3 再 python;其他系统先 python3 再 python
    commandsEnabled: true

0.1.6:Trellis 会话隔离与任务错误兼容

  • 跟随 Trellis #608:只读取当前 DSH 会话的精确指针。缺少身份或匹配指针时返回 no_task,不再借用唯一的其他会话;也不从派发提示词反向建立会话绑定。子代理继续通过明确的 Active task: 派发上下文读取任务。
  • 对齐 官方 task_error 工作流:已绑定任务的 task.json 缺失、不可读、JSON 损坏或状态为空时,保留任务路径,提示先修复记录,不把它当成“没有任务”。不修改或删除任何任务与指针。
  • 旧项目没有 [workflow-state:task_error] 块时,插件提供保守的修复提示;恢复有效记录后,下一轮自动恢复正常状态。因此无需先更新 Trellis CLI 才能使用本插件的修复。
  • 插件修复不替代 Trellis Python 脚本升级:旧版 task.py current/finish 的回退策略、归档恢复和上下文清单检查仍由项目中的 .trellis/scripts 实现。