dsh-workspace-prompts

Readme

# dsh-workspace-prompts

> Per-workspace custom system prompts for **DeepSeek Harness (DSH)**.
> 给 **DeepSeek Harness (DSH)** 的「工作区自定义提示词」插件。

[![npm](https://img.shields.io/npm/v/dsh-workspace-prompts)](https://www.npmjs.com/package/dsh-workspace-prompts)
[![license](https://img.shields.io/npm/l/dsh-workspace-prompts)](./LICENSE)
[![dsh-plugin](https://img.shields.io/badge/dsh-plugin-deepseek--harness-4D6BFE)](https://github.com/topics/dsh-plugin)

---

## What is it? / 这是什么

dsh-workspace-prompts lets you attach **one custom system prompt to each workspace**. When you create a new session in that workspace, the prompt is captured into the session's system prompt — alongside the fixed system prompt. Edit it any time from a dialog in the session header.

dsh-workspace-prompts 让你给**每个工作区配一条自定义提示词**。在该工作区新建会话时，提示词会固化进该会话的系统提示词（叠加在固定系统提示词之上）；随时可从会话头部的弹窗增删改查。

- **Per-workspace / 按工作区**：每个工作区一条生效提示词，互不影响。
- **Captured at creation / 创建即固化**：提示词在「新建会话」那一刻固化，之后修改配置不影响已存在会话。
- **Inline management / 会话内管理**：会话头部「工作区提示词」入口 + 弹窗完成增删改查、设为生效。

## Features / 特性

- 🏷️ 会话头部入口按钮（复用 DSH 原生 header action 样式，明暗主题自适应）
- 🪟 弹窗管理：列表 / 新建 / 编辑 / 删除 / 设为生效，含空态与错误态
- 📌 单条生效：`activeId` 单选语义，Host 强制一致性
- 💾 数据落盘：工作区根目录 `.workspace-prompts.json`（跟随工作区走，可进 git）
- ♻️ 跨重启保留：固化快照随配置文件落盘，会话 resume 后仍用创建时的版本
- 🤖 Agent 工具：`workspace_prompt_get` / `workspace_prompt_set`，Agent 可自主查看/更新当前工作区提示词

## Install / 安装

```bash
dsh plugin --profile web add dsh-workspace-prompts
```

然后重启 `dsh web`。

> 也可手动：在 profile 的 `package.json` 加入依赖，并在 `dsh.profile.bundles` 里加入 `"dsh-workspace-prompts"`。

## Usage / 使用

1. 在任一工作区的会话里，点会话头部右侧的「工作区提示词」。
2. 弹窗里新建一条提示词，点「设为生效」。
3. 在该工作区**新建会话**，系统提示词末尾会自动带上「## 工作区提示词 + 正文」。
4. 或直接让 Agent 调用 `workspace_prompt_get` / `workspace_prompt_set` 工具管理（无需打开弹窗）。

## Capture semantics / 固化语义（重要）

- 提示词在**新建会话**时固化进该会话；之后编辑/删除/切换生效，只影响**之后新建**的会话。
- 已存在会话（含跨重启 resume）始终使用创建时固化的版本。

## FAQ / 常见问题

**Q: 它和 dsh-polling / dsh-office 有什么区别？**
A: dsh-polling 管定时任务，dsh-office 管可视化总览；本插件管工作区级自定义系统提示词，三者可共存。

**Q: 数据存在哪？会不会丢？**
A: 每个工作区根目录一个 `.workspace-prompts.json`（隐藏文件），跟随工作区迁移/备份，重启不丢。

**Q: 为什么编辑后旧会话没变？**
A: 这是有意的固化语义——旧会话继续用创建时的版本，避免历史会话行为漂移。

## Ecosystem / 生态

- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — the harness this plugin runs on
- [dsh-plugin topic](https://github.com/topics/dsh-plugin) — more DSH plugins

## License

MIT