在 DeepSeek Harness (DSH) 环境中开发智能体时，需要实时查看当前任务进度、PRD 检查清单以及规范使用情况。dsh-trellis-dashboard 插件为此提供了一个集中式视图。
插件定位¶
这是一个 DeepSeek Harness 插件，在 DSH Web UI 的对话视图环中添加一个 Trellis 标签页，展示当前工作区的 .trellis/ 状态。插件由 QianziTech 维护，采用 MIT 许可证。
安装与启用¶
先决条件是安装了 DeepSeek Harness (dsh CLI) 并带有 web profile，以及目标工作区已使用 Trellis 初始化。
安装命令如下：
dsh plugin --profile web add dsh-trellis-dashboard
安装完成后，重启 Web 应用即可。可以通过 dsh --profile web --dump-config 验证配置层是否已插入。
使用方法¶
- 安装后，打开任意对话。
- 在对话视图环中点击“Trellis”标签。
- 插件会解析当前工作区，并每 5 秒轮询一次主机 JSON API。
- 点击“Set as current task”按钮以写入会话指针。
核心功能¶
插件提供以下信息展示与操作：
- 任务与进度：显示任务列表和当前任务的解析结果。如果当前会话未绑定任务，会显示“No trellis task”而非随机任务。
- PRD 检查清单：在任务卡片中展示
prd.md的接受检查清单。 - 规范与技能使用：实时读取规范文件（通过
fs/observed访问.trellis/spec/**、.agents/skills/**、.dsh/skills/**）以及技能工具加载情况（tools/result）。所有读取均基于exec.agent.id范围化，确保不同会话的活动不会泄漏。 - 会话摘要：展示工作区的开发者日志索引和最新的
journal-N.md条目。 - 设置当前任务：通过“Set as current task”按钮写入会话指针，这是插件唯一执行的写入操作。
技术架构¶
- 通信方式：仅通过 HTTP。客户端通过轮询
webServer路由获取状态，因为不存在主机到客户端的推送通道。 - 文件系统：主机端（
lib/index.js）通过ctx.fs读取.trellis/目录，不执行 Python 任务脚本。目录保持只读，仅对set-current-task接口进行写入。 - 渲染：内置 Markdown 渲染器，在标签内渲染标题、列表、表格、代码等，无需外部运行时依赖。
- 依赖：插件依赖-free plain JavaScript，无构建步骤。
注意事项¶
- 必须使用带有
webprofile 的 DSH CLI。 - 目标工作区必须使用 Trellis 初始化。
- 插件不依赖外部运行时，Markdown 渲染在浏览器端完成。
插件源码托管在 GitHub。
