dsh-projects

把零散的 Workspace 和会话，变成真正清晰、可搜索的项目工作流。

English · 简体中文

快速安装 · 功能总览 · 兼容性 · 报告问题

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

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

v0.3 新增

• 多文件夹项目：把多个现有 Workspace 组合为一个项目，并明确指定新会话使用的主文件夹。
• 待处理摘要：关闭、简洁数字或展开列表三种模式，直接看到等待输入、运行中和已完成的会话。
• 更好用的搜索：项目、标题和聊天正文结果直接按项目分组，命中文字清晰高亮。
• 更顺手的目录窗口：记住上次位置，也可固定从桌面、用户主目录或当前项目父目录开始。

所有高级能力均为可选项；不启用时仍然是轻量的 Workspace/Session 整理层。

一眼看懂

快速安装

当前版本为 0.3.0-alpha.2。插件兼容 DSH 0.1.0-rc.6 和 0.1.1-rc.2；后者已通过隔离 Web UI 启动与核心界面检查，DSH Desktop 2.0.3 的 Windows 官方目录窗口也已完成实际界面验收。详细边界见兼容性矩阵。

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。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 2.0.3 及以后优先使用 Desktop 官方 Windows 目录窗口。
• 旧版 Desktop 和本机 Web UI 保留插件 Host 桥；首次可从系统桌面打开，之后可记住上次项目的父目录。
• 官方窗口或兼容桥不可用时，再调用 DSH 自带 Workspace 选择器。
• 远程 Web UI 使用 Host 端应用内目录浏览器，不会要求远程机器弹出系统窗口。
• 用户取消选择时会直接结束，不会错误地连续弹出第二个窗口。

早期 Release 中的修复版 Desktop 已被官方实现取代，只作为历史兼容材料保留，不再推荐新用户安装。具体调用顺序见原生目录选择方案。

不选择项目也能聊天

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

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

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

兼容性

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

可选：聊天正文搜索

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

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

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

数据与卸载

基础模式不建立第二套项目数据库，也不会在卸载时删除项目文件夹或会话记录。按项目/单列表视图、排序方式、置顶、收藏等显示偏好保存在浏览器 localStorage。可选的多文件夹项目同样只在这里保存组合名称、Workspace ID 和主 Workspace ID，不保存聊天正文或移动磁盘文件；清除站点数据会拆分这些本地组合，但不会影响 DSH Workspace、聊天或项目文件。

多文件夹项目的中文边界说明见高级项目模式说明。

开发与反馈

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

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

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

如果 dsh-projects 解决了你的 Workspace 或侧边栏整理问题，欢迎点一个 Star。它能帮助更多 DSH 用户发现这个项目；实际平台反馈也会直接决定下一版优先修复什么。

许可证

MIT