dsh-default-prompt

DeepSeek Harness 基础默认系统提示词插件

像 OpenAI Codex 一样，将核心行为规范与基础指令直接注入底层系统提示词（System Prompt），赋予模型最高系统级权威度。

核心设计 · 功能特性 · 安装与更新 · 配置指南 · 斜杠指令 · 质量验证

> [!NOTE]
> 当前稳定版本为 v1.1.1。支持全局文件、项目工作区配置、Web 控制台实时预览与一键同步 OpenAI Codex 规则。

🌟 为什么需要这个插件？

在 DeepSeek Harness 默认机制下，用户的自定义全局规则或 AGENTS.md 是通过 dsh-agent-instructions 包装在带有 `` 的 用户消息（User Role Message） 中注入对话历史的，并且附带了：
> "They do not override system, developer, or direct user instructions."

这会导致大语言模型（尤其是长轮次对话或遵循系统提示词能力极强的模型）降低对用户全局指令的服从优先级甚至被模型忽略。

而 OpenAI Codex 的标准做法是：将用户的全局/开发者规则（如 ~/.codex/AGENTS.md、developer instructions）直接编入最顶层的 System Prompt 中，紧跟在 Assistant 角色定义之后。

✨ 功能特性

📦 安装与更新

方式一：使用 DSH 命令行从 GitHub 在线安装（推荐）

通过 DeepSeek Harness 官方插件管理命令一键拉取并安装：

# 安装到 Web Profile（推荐，包含 Web 设置面板界面）
dsh plugin --profile web add github:new-Beginner/dsh-default-prompt

# 安装到 Desktop Profile
dsh plugin --profile desktop add github:new-Beginner/dsh-default-prompt

方式二：下载 GitHub Release 安装包（离线安装）

从 GitHub Releases 下载预打包好的 .tgz 归档文件：

# 下载 Release 安装包后安装
dsh plugin --profile web add ./dsh-default-prompt-1.1.1.tgz

> [!TIP]
> 也可以直接使用 Release 直链安装：
> bash > dsh plugin --profile web add https://github.com/new-Beginner/dsh-default-prompt/releases/download/v1.1.1/dsh-default-prompt-1.1.1.tgz >

方式三：通过 1024 社区商店安装

在安装了 dsh-1024store 插件后，可在 DSH 设置的 1024 Store 中直接搜索 dsh-default-prompt 点击安装，或使用 CLI：

npx @dsh-1024store/cli add new-Beginner/dsh-default-prompt --profile web

> [!IMPORTANT]
> 安装或更新后请重启 DSH。DSH 会在重启时重新加载 Cordis 补丁树并生效。初次启动后，插件会自动在 ~/.dsh/DEFAULT_PROMPT.md 初始化一份高品质默认指令模板。

⚙️ 配置指南

插件的所有配置均会自动持久化到 ~/.dsh/settings.yaml 中的 dsh-default-prompt 节点下：

配置示例

dsh-default-prompt:
enabled: true
position: 'after-persona'
customOrder: 10
sourceMode: 'file'
filePath: ''
promptText: ''
enableWorkspaceFile: true
syncCodex: false
sectionTitle: ''

配置项详细说明

💬 斜杠指令支持

在聊天输入框中输入以下指令即可快速管理提示词：

🛡️ 质量验证与测试

本项目遵循严谨的测试驱动与向后兼容设计，完整覆盖核心调度、生命周期管理与 Web 端点：

# 运行单元测试
npm test

测试覆盖矩阵：
- ✅ Plugin Lifecycle：验证在 Cordis 容器中正确注册 systemPrompt.section 与设置服务
- ✅ Order Resolution：验证 5 种位置模式与自定义权重的排序映射
- ✅ Home Expansion：验证跨平台路径 ~ 自动展开
- ✅ PromptManager：涵盖行内模式、全局文件缓存机制、多源合并模式及标题包裹
- ✅ Web API：验证状态获取、实时保存与 Codex 导入端点

详细测试报告可查阅 VERIFICATION.md。

🛠️ 项目目录结构

dsh-default-prompt/
├── package.json          # 模块规范、ESM 配置与 DSH bundle 声明
├── cordis.patch.yml      # Cordis 宿主层与 Web 层自动挂载补丁契约
├── index.js              # 宿主核心：注册 systemPrompt.section、设置与 /prompt 指令
├── client.js             # 客户端界面：DSH Settings 可视化配置与实时预览卡片
├── src/
│   ├── config.js         # Schemastery Schema、位置权重与默认模板定义
│   ├── promptManager.js  # 提示词读取、多来源组合、mtime 缓存与 Codex 导入
│   └── web.js            # 后端 HTTP API (/api/dsh-default-prompt) 路由
├── test/
│   ├── promptManager.test.js # 提示词管理器单元测试
│   ├── plugin.test.js        # 插件生命周期与注入测试
│   ├── web.test.js           # Web API 接口测试
│   └── run.js                # 统一轻量测试执行入口
├── VERIFICATION.md       # 自动化验证报告
└── README.md             # 用户与开发者使用指南

📄 开源许可证

MIT License © 2026 new-Beginner