前言¶
DSH 通过插件扩展客户端能力。原生 Workspace 适合直接进入单个工作目录，但 Workspace 和会话增多后，目录选择、会话列表和归档内容会变得不好找。
dsh-projects 是一个 DSH 插件，由 WenhongPan 维护，目标是把零散的 Workspace 和会话整理成清晰、可搜索的项目工作流。它继续使用 DSH 自己的 Workspace 和 Session 数据，基础模式不建立第二套项目数据库。
当前版本为 0.3.0-alpha.2，属于 Alpha 版本，许可证为 MIT。
这是什么¶
dsh-projects 提供项目入口、项目侧边栏、全局搜索、归档查看和目录选择能力。适合使用 DSH Desktop 或 DSH Web UI，并希望按项目组织 Workspace 和会话的用户。
它兼容 DSH 0.1.0-rc.6 和 0.1.1-rc.2。DSH Desktop 2.0.3 的 Windows 官方目录窗口已完成实际界面验收。
核心功能¶
项目与侧边栏¶
- 选择项目、创建项目、整理侧边栏。
- 侧边栏可按项目或单列表显示，提供最近、置顶、收藏、拖动排序。
- 待处理摘要支持关闭、简洁数字或展开列表三种模式。
全局搜索¶
全局搜索的结果按项目分组，可搜索项目、标题；启用 DSH 索引后，还可以搜索聊天正文。
多文件夹项目¶
可以把多个现有 Workspace 组合为一个项目，并明确指定新会话使用的主文件夹。
归档与项目管理¶
项目管理包括：
- 重命名
- 在文件管理器中打开
- 归档聊天
- 移除项目注册
归档中心用于集中查看已归档聊天；恢复能力取决于 DSH 是否公开取消归档接口。
目录窗口¶
DSH Desktop 2.0.3 及以后优先使用 Desktop 官方 Windows 目录窗口。
远程 Web UI 使用 Host 端应用内目录浏览器，不打开远程机器的系统窗口。
安装与启用¶
Desktop 和 Web 是两个独立 profile，需要分别安装。源码安装要求 node >=20。
DSH Desktop¶
dsh plugin --profile desktop add https://github.com/WenhongPan/dsh-projects/releases/download/v0.3.0-alpha.2/dsh-projects-0.3.0-alpha.2.tgz
DSH Web UI¶
dsh plugin --profile web add https://github.com/WenhongPan/dsh-projects/releases/download/v0.3.0-alpha.2/dsh-projects-0.3.0-alpha.2.tgz
安装或升级后，完整退出并重新启动对应的 DSH 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
典型用法¶
不选择项目直接聊天¶
普通聊天会自动获得独立任务目录：
~/Documents/DSH-Default/YYYY-MM-DD/new-chat[-N]
启用聊天正文搜索¶
聊天正文搜索需要在目标 profile 的 cordis.patch.yml 中启用 DSH 会话索引。配置项如下：
- id: session-query-sqlite
config:
path: dshHomePath('session-search.sqlite')
openAt: first-search
聊天正文索引包含由聊天内容派生的数据，应与原始会话数据采用同等隐私保护。
远程 Web UI¶
远程 Web UI 下，目录选择使用 Host 端应用内目录浏览器，不打开远程机器的系统窗口。
注意¶
- 这是 Alpha 版本，使用时应按 Alpha 版本对待。
- macOS Apple Silicon 和 macOS/Linux 本机 Web UI 的部分验证待人工确认。
- 显示偏好保存在浏览器
localStorage；清除站点数据会拆分本地组合，但不影响 DSH Workspace、聊天或项目文件。 - 基础模式不建立第二套项目数据库，也不会在卸载时删除项目文件夹或会话记录。
- 归档恢复能力取决于 DSH 是否公开取消归档接口。
- 插件会以当前 DSH 进程权限运行；安装前应检查源码和 MIT 许可证。
结尾¶
dsh-projects 的价值在于把现有 Workspace 和 Session 整理成项目视图：侧边栏可按项目组织，搜索可按项目分组，归档和目录选择也有了统一入口。
GitHub：
https://github.com/WenhongPan/dsh-projects
