dsh-projects
把零散的 Workspace 和会话，变成真正清晰、可搜索的项目工作流。
English · 简体中文
快速安装 · 功能总览 · 兼容性 · 报告问题
全屏真实录制：目录窗口由 Windows 原生接口直接打开；画面仅做裁切、镜头缩放和 GIF 压缩，没有重绘系统界面。 DSH 原生界面擅长直接进入 Workspace，但项目多起来以后，目录选择和会话列表很快会变得混乱。`dsh-projects` 在 DSH 原生 Workspace/Session 数据之上增加一层项目体验：选择项目、创建项目、整理侧边栏、搜索聊天和查看归档内容，不复制或迁移已有会话。 ### v0.3 新增 - **多文件夹项目**：把多个现有 Workspace 组合为一个项目，并明确指定新会话使用的主文件夹。 - **待处理摘要**：关闭、简洁数字或展开列表三种模式，直接看到等待输入、运行中和已完成的会话。 - **更好用的搜索**：项目、标题和聊天正文结果直接按项目分组，命中文字清晰高亮。 - **更顺手的目录窗口**：记住上次位置，也可固定从桌面、用户主目录或当前项目父目录开始。 所有高级能力均为可选项；不启用时仍然是轻量的 Workspace/Session 整理层。 ## 一眼看懂 | 能力 | 使用效果 | | --- | --- | | 项目入口 | 在输入框上方搜索和切换项目；也可以不选项目直接开始聊天 | | 创建项目 | 显示名称和磁盘文件夹相互独立；本机优先使用操作系统目录窗口 | | 侧边栏 | 按项目或单列表显示，提供“最近”、置顶、收藏、拖动排序；待处理状态可关闭、显示简洁数字或展开列表 | | 项目管理 | 重命名、在文件管理器中打开、归档聊天、移除项目注册 | | 多文件夹项目 | 可选地把多个现有 Workspace 组合成一个项目；不移动文件或聊天，随时可以拆分 | | 全局搜索 | 结果按项目直接分组；启用 DSH 索引后还能搜索聊天正文 | | 归档中心 | 集中查看已归档聊天；恢复能力取决于 DSH 是否公开取消归档接口 | | 外观与数据 | 跟随 DSH 浅色/深色主题；继续使用 DSH 自己的 Workspace 和 Session 数据 |
## 快速安装 当前版本为 `0.3.0-alpha.1`，主要验证环境是 Windows x64、DSH Desktop 2.0.1 和 DeepSeek Harness 0.1.0-rc.6。 ### DSH Desktop ```powershell dsh plugin --profile desktop add https://github.com/WenhongPan/dsh-projects/releases/download/v0.3.0-alpha.1/dsh-projects-0.3.0-alpha.1.tgz ``` ### DSH Web UI ```bash dsh plugin --profile web add https://github.com/WenhongPan/dsh-projects/releases/download/v0.3.0-alpha.1/dsh-projects-0.3.0-alpha.1.tgz ``` 安装或升级后，完整退出并重新启动对应的 DSH profile。Desktop 和 Web 是两个独立 profile，需要分别安装。 如果更喜欢从源码安装： ```bash 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` 的前置条件。具体区别和校验方式见[原生目录选择方案](docs/native-picker-options.md)。  ## 不选择项目也能聊天 普通聊天会自动获得独立任务目录： ```text ~/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 端应用内目录浏览器，不打开远程机器的系统窗口 | 完整边界见[兼容性矩阵](docs/compatibility.md)和[架构说明](docs/architecture.md)。DeepSeek Harness 仍处于 Developer Preview，升级后可能需要适配。 ## 可选：聊天正文搜索 项目名和聊天标题搜索开箱即用。聊天正文搜索需要在目标 profile 的 `cordis.patch.yml` 中启用 DSH 会话索引： ```yaml - id: session-query-sqlite config: path: !!js dshHomePath('session-search.sqlite') openAt: first-search ``` 索引包含由聊天内容派生的数据，应与原始会话数据采用同等隐私保护。 ## 数据与卸载 基础模式不建立第二套项目数据库，也不会在卸载时删除项目文件夹或会话记录。按项目/单列表视图、排序方式、置顶、收藏等显示偏好保存在浏览器 `localStorage`。可选的多文件夹项目同样只在这里保存组合名称、Workspace ID 和主 Workspace ID，不保存聊天正文或移动磁盘文件；清除站点数据会拆分这些本地组合，但不会影响 DSH Workspace、聊天或项目文件。 多文件夹项目的中文边界说明见[高级项目模式说明](docs/advanced-projects.zh-CN.md)。 ## 开发与反馈 ```bash npm install npm run verify npm pack --dry-run ``` 这是 Alpha 版本。遇到问题可以提交[缺陷报告](https://github.com/WenhongPan/dsh-projects/issues/new?template=bug.yml)，也欢迎填写[平台兼容性报告](https://github.com/WenhongPan/dsh-projects/issues/new?template=compatibility.yml)或提出[功能建议](https://github.com/WenhongPan/dsh-projects/issues/new?template=feature.yml)。提交前请移除私密路径、提示词和凭据。 贡献方式见 [CONTRIBUTING.md](CONTRIBUTING.md)，版本变化见 [CHANGELOG.md](CHANGELOG.md)，后续方向见[公开路线图](docs/roadmap.md)。 如果 `dsh-projects` 解决了你的 Workspace 或侧边栏整理问题，欢迎点一个 **Star**。它能帮助更多 DSH 用户发现这个项目；实际平台反馈也会直接决定下一版优先修复什么。 ## 许可证 MIT