返回目录
界面增强 插件

dsh-projects

WenhongPan/dsh-projects

Codex-inspired project and session management for DeepSeek Harness.

Stars
1
Forks
0
Issues
0
更新
1 天前

PROJECT TOPICS

项目标签

INSTALL REFERENCE

安装参考

未验证
dsh plugin --profile web add github:WenhongPan/dsh-projects

该命令指向仓库当前默认分支;尚无绑定当前 commit 的完整验证结果。

PROJECT README

README

dsh-projects

English · 简体中文

把 DeepSeek Harness 零散的 Workspace 和会话,整理成可搜索、可排序的项目。

Release CI License

dsh-projects:为 DeepSeek Harness 提供项目化工作流

dsh-projects:选择项目、创建项目并打开 Windows 原生目录窗口

全屏真实录制:目录窗口由 Windows 原生接口直接打开;画面仅做裁切、镜头缩放和 GIF 压缩,没有重绘系统界面。

DSH 原生界面擅长直接进入 Workspace,但项目多起来以后,目录选择和会话列表很快会变得混乱。dsh-projects 在 DSH 原生 Workspace/Session 数据之上增加一层项目体验:选择项目、创建项目、整理侧边栏、搜索聊天和查看归档内容,不复制或迁移已有会话。

一眼看懂

能力 使用效果
项目入口 在输入框上方搜索和切换项目;也可以不选项目直接开始聊天
创建项目 显示名称和磁盘文件夹相互独立;本机优先使用操作系统目录窗口
侧边栏 按项目或单列表显示,提供“最近”、置顶、收藏和拖动排序
项目管理 重命名、在文件管理器中打开、归档聊天、移除项目注册
全局搜索 搜索项目名、聊天标题;启用 DSH 索引后还能搜索聊天正文
归档中心 集中查看已归档聊天;恢复能力取决于 DSH 是否公开取消归档接口
外观与数据 跟随 DSH 浅色/深色主题;继续使用 DSH 自己的 Workspace 和 Session 数据

可搜索的项目选择器 创建项目

快速安装

当前版本为 0.2.0-alpha.2,主要验证环境是 Windows x64、DSH Desktop 2.0.1 和 DeepSeek Harness 0.1.0-rc.6。

DSH Desktop

dsh plugin --profile desktop add https://github.com/WenhongPan/dsh-projects/releases/download/v0.2.0-alpha.2/dsh-projects-0.2.0-alpha.2.tgz

DSH Web UI

dsh plugin --profile web add https://github.com/WenhongPan/dsh-projects/releases/download/v0.2.0-alpha.2/dsh-projects-0.2.0-alpha.2.tgz

安装或升级后,完整退出并重新启动对应的 DSH profile。Desktop 和 Web 是两个独立 profile,需要分别安装。

如果更喜欢从源码安装:

git clone https://github.com/WenhongPan/dsh-projects.git
cd dsh-projects
npm install
npm run verify
dsh plugin --profile desktop add link:/absolute/path/to/dsh-projects

Windows PowerShell 示例路径可写为 link:C:/path/to/dsh-projects

原生目录窗口

dsh-projects 已经自带原生目录桥,普通用户不需要替换 Desktop:

  • DSH Desktop 调用 Electron 的操作系统目录窗口。
  • 同一台电脑上的本机 Web UI 调用 DSH 官方跨平台目录选择器。
  • 远程 Web UI 或调用失败时,自动回退到 DSH 应用内目录浏览器。

如果希望让其他兼容插件也获得 Desktop 级原生目录窗口,可以选择安装仓库 Release 中的 修复版 DSH Desktop。它是可选方案,不是安装 dsh-projects 的前置条件。具体区别和校验方式见原生目录选择方案

Windows 原生目录窗口

不选择项目也能聊天

普通聊天会自动获得独立任务目录:

~/Documents/DSH-Default/YYYY-MM-DD/new-chat[-N]

默认任务不会混入项目列表,但仍会出现在“最近”区域。每次聊天都有自己的工作目录,不会把整个 Documents 或用户主目录当作 Workspace。

兼容性

场景 当前状态
DSH Desktop 2.0.1 / Windows x64 ✅ 已进行实际界面与原生目录窗口验证
本机 DSH Web UI / Windows 🟡 设计支持;仍需更多人工回归
DSH Desktop / macOS Apple Silicon 🟡 CI 通过;原生目录窗口和文件管理器操作待人工验证
本机 Web UI / macOS、Linux 🟡 CI 通过;Host 路径和本地目录规则待人工验证
远程 Web UI ✅ 使用 Host 端应用内目录浏览器,不打开远程机器的系统窗口

完整边界见兼容性矩阵架构说明。DeepSeek Harness 仍处于 Developer Preview,升级后可能需要适配。

可选:聊天正文搜索

项目名和聊天标题搜索开箱即用。聊天正文搜索需要在目标 profile 的 cordis.patch.yml 中启用 DSH 会话索引:

- id: session-query-sqlite
  config:
    path: !!js dshHomePath('session-search.sqlite')
    openAt: first-search

索引包含由聊天内容派生的数据,应与原始会话数据采用同等隐私保护。

数据与卸载

插件不建立第二套项目数据库,也不会在卸载时删除项目文件夹或会话记录。按项目/单列表视图、排序方式、置顶、收藏等显示偏好保存在浏览器 localStorage;清除站点数据只会重置这些偏好。

开发与反馈

npm install
npm run verify
npm pack --dry-run

这是 Alpha 版本。遇到问题可以提交缺陷报告,也欢迎填写平台兼容性报告或提出功能建议。提交前请移除私密路径、提示词和凭据。

贡献方式见 CONTRIBUTING.md,版本变化见 CHANGELOG.md,后续方向见公开路线图

许可证

MIT

CLASSIFICATION EVIDENCE

分类依据

项目类型插件
功能分类界面增强
规则置信度

系统优先读取 GitHub Topics,再与站内分类词典和词根规则比对。当前命中: web-ui。