前言¶
在 DeepSeek Harness (DSH) 的开发流程中,会话的无状态特性有时会带来上下文管理的难题。如果需要在不同的对话会话之间保持任务状态的连续性,现有的基础能力往往无法直接满足。dsh-tasklist 插件正是为了解决这一问题而存在,它提供了一种持久化的任务列表记忆机制。
插件介绍¶
dsh-tasklist 是一个用于 DeepSeek Harness 的跨会话任务列表记忆插件,由开发者 lsLs-kid 维护。它通过提供任务创建、更新、转换和归档的能力,帮助开发者在对话上下文之外建立独立的工作流状态。
核心功能¶
该插件主要提供以下能力:
-
任务生命周期管理
使用tasklist_update工具,可以执行创建、更新、转换和归档任务的操作。 -
任务查询
使用tasklist_query工具,可以在需要时读取并过滤任务列表。 -
可视化面板
插件提供浮动 Web 小部件,面板会实时轮询并显示所有活跃任务,以及当前会话中各个代理正在处理的具体任务。
安装与启用¶
插件需要安装到特定的配置文件中。请确保当前环境满足依赖要求,然后执行以下命令:
dsh plugin --profile web add dsh-tasklist
依赖与运行要求¶
该插件对运行环境有硬性依赖,必须运行在支持 Web 服务器的环境中:
- 依赖注入:插件声明了
@deepseek-ai/dsh-host-webserver作为硬注入的 peer dependency(版本^0.1.1-rc.2)。 - 运行限制:由于依赖 Web 服务,插件无法在 headless 或 CLI 类型的 profile 中启动。
使用说明¶
安装后,可以通过调用相应的工具函数来管理任务:
- 更新任务:调用
tasklist_update来创建新任务、更新现有任务、改变任务状态或归档任务。 - 查询任务:调用
tasklist_query来按需读取过滤后的任务。
插件在 Web 环境下会挂载文件:
* /dsh-tasklist/widget.js
* /dsh-tasklist/recommended.json
* /dsh-tasklist/state.json(显示活跃任务及代理分配)
发布与构建¶
插件发布到 npm registry,安装时会携带完整性校验元数据。构建过程使用 pnpm,并在发布前自动运行 prepack 脚本进行构建。
适用场景与注意事项¶
该插件适用于需要持久化任务状态且运行在 Web 服务器环境下的 DSH 场景。
在安装前,请务必:
1. 检查插件的源代码以确保安全性。
2. 核对许可证信息(当前插件信息中缺少明确的许可证说明)。
结语¶
dsh-tasklist 为 DSH 生态提供了一个轻量级的任务管理方案。如需查看源代码或提交反馈,可访问其 GitHub 仓库:https://github.com/lsLs-kid/dsh-tasklist。