DSH Web 提供了会话级别的交互能力,但缺乏持久化的项目概念。开发者在协作或长期维护复杂任务时,需要将项目指令、文件上下文与特定工作目录绑定。dsh-projects 插件引入了 Cowork/WorkBuddy 风格的项目管理机制,解决了在 DSH Web 中缺乏结构化项目入口和文件夹记忆的问题。
dsh-projects 是 DeepSeek Harness Web 的一个记忆类插件,旨在为 DSH Web 提供类似 Cowork 或 WorkBuddy 的项目中心。它支持创建绑定真实文件夹的项目,管理项目指令,并通过双向同步机制与 CLAUDE.md 保持一致。该插件由用户 alwaysmid-19990 维护,采用 MIT 许可证。
安装与启用¶
插件通过 DSH 的插件管理器安装。安装后需要重启 DSH Web 服务以加载侧边栏入口。
dsh plugin --profile web add github:alwaysmid-19990/dsh-projects
安装完成后,无需额外配置,插件会通过自带的 cordis.patch.yml 自动注册。
核心功能¶
该插件提供了一整套项目管理工作流,主要包含以下功能:
- 侧边栏入口:在 DSH Web 侧边栏添加项目入口。如果安装了
dsh-automation,该入口位于 Automations 下方;若未安装,则位于 task-board/SSH/skill-explorer 附近。 - 项目卡片网格:展示所有已创建项目的卡片,包含项目名称、描述、更新时间和文件夹标识,支持搜索。
- 新建项目:支持定义项目名称、设置项目指令(Prompt),并将项目绑定到本地现有文件夹。
- 项目详情:在项目详情页可编辑指令、浏览关联文件夹文件、手动置顶关键文件,并支持修改关联文件夹。
- CLAUDE.md 双向同步:支持将项目指令导出为
CLAUDE.md中的 fenced section,或从文件夹载入现有的CLAUDE.md作为项目指令。 - 数据持久化:项目数据以 JSON 格式存储在本地,便于备份和版本控制。
典型用法¶
下面介绍使用该插件进行项目创建和管理的典型步骤。
- 进入项目中心:点击侧边栏的「项目」入口,打开项目卡片网格。
- 创建项目:点击「+ 新项目」,输入项目名称和指令,然后点击「选择文件夹」链接现有的工作目录。
- 管理项目:打开项目卡片进入详情页,在此处可以继续编辑指令、浏览文件列表或通过「选择文件」置顶关键文件。
- 记忆同步:在保存项目时,可以勾选「同步到 CLAUDE.md」将指令写入文件夹的
CLAUDE.md文件中;或者点击「载入为项目说明」将文件夹中已有的CLAUDE.md内容读入项目指令。同步功能默认关闭,仅在保存时按需启用。
注意事项¶
- 数据存储:项目数据存储在
~/.dsh/dsh-projects/projects.json。 - 依赖环境:插件依赖 Node.js 环境版本 >= 18.0.0。
- 权限与安全:插件以当前 DSH 进程的权限运行,安装前建议检查源码与许可证。
- 同步机制:默认情况下,编辑指令不会自动修改
CLAUDE.md,只有保存时手动启用同步才会写入文件。
dsh-projects 通过提供结构化的项目管理和记忆同步能力,使 DSH Web 更适合处理长期、多文件的开发任务。相关源码与文档可参考 GitHub 仓库。