dsh-desktop

DSH 插件工作区

关于

DeepSeek Harness 的插件与桌面客户端工作区。包含以 Tauri + Rust 打包的 dsh-desktop（启动并捆绑 node + dsh、用 WebView 承载 SPA），以及 plugins 子模块（如 dsh-usage-stats）。适用于在 Windows 上生成 NSIS/MSI 安装包、便于将 Web 服务以原生桌面形式交付给用户。

本目录是 DeepSeek Harness（DSH）插件的统一管理工作区。

📄 文档

桌面客户端工程（dsh-desktop/）自计划 M0 起在本工作区根目录创建，与 plugins/ 插件工作区相互独立。

🔗 克隆与子模块

plugins/dsh-usage-stats 是独立 git 仓库,以 submodule 形式关联(见 .gitmodules)。克隆时同步拉取:

git clone --recurse-submodules <harness仓库地址>
# 或克隆后再执行:
git submodule update --init

子模块 URL 为 git@github.com:simune/dsh-usage-stats.git(SSH)。更新子模块:git submodule update --remote plugins/dsh-usage-stats(可选,平时跟随其自身仓库演进即可)。

📁 目录结构

dsh/
├── README.md                 # 本文件：工作区说明与约定
└── plugins/                  # 所有 DSH 插件及插件源码均存放于此
    └── <plugin-name>/        # 每个插件一个目录，目录名与插件名（npm 包名）一致
        ├── src/              # 插件源码
        ├── lib/              # 构建产物
        ├── tests/            # 测试
        ├── package.json      # 插件包定义
        └── ...               # 该插件的其余文件（README、配置等）

📌 目录约定

1. 所有 DSH 插件及其源码相关内容统一放在 plugins/ 目录下，不在工作区根目录或其他位置存放插件代码。
2. 每个插件按照插件名称（即 npm 包名，如 dsh-usage-stats）创建独立子目录：plugins/<plugin-name>/。
3. 新增、修改、构建、安装、卸载等所有针对插件的操作，均在本工作区目录下进行，具体命令在对应插件目录中执行。

📦 当前插件

🚀 常见操作

所有操作都在对应插件目录 plugins/<plugin-name>/ 下执行。

安装依赖

cd plugins/<plugin-name>
npm install

构建

npm run build          # tsdown 构建，产物输出到 lib/

类型检查与测试

npm run typecheck      # TypeScript 类型检查
npm run test           # vitest 单元测试
npm run check          # 类型检查 + 测试 + 构建

安装到 Harness

# 在插件目录构建完成后，回到工作区根目录或任意位置，通过 dsh CLI 安装
dsh plugin --profile web add <plugin-name>

更新或卸载：

dsh plugin --profile web update <plugin-name>
dsh plugin --profile web remove <plugin-name>

具体安装/更新命令以各插件 README 中的说明为准（例如 dsh-usage-stats 使用 --profile web）。

➕ 新增插件

1. 在 plugins/ 下创建与插件名一致的目录：mkdir plugins/<plugin-name>
2. 在目录内初始化包并编写源码（src/、package.json 等），可参考现有插件 plugins/dsh-usage-stats/ 的结构。
3. 完成构建与测试后，按上文方式安装到 Harness。
4. 在「当前插件」表中补充新插件条目。