前言¶
在 DeepSeek Harness (DSH) 的插件生态中，系统提示词和工具目录的管理往往依赖于多个插件的协同工作。这容易导致提示词段相互污染、工具目录臃肿，且难以针对不同的会话阶段或 Agent 预设进行精细化控制。dsh-prompt-customizer 插件提供了一个集中的能力台，旨在解决这些问题。
插件定位¶
dsh-prompt-customizer 是 DeepSeek Harness 的能力台，提供提示词定制、技能集合管理和 MCP Server 接入功能。该插件由 DreamsTOF 维护，采用 MIT 许可证。
它解决的核心问题是：
1. 提示词污染：允许按名称屏蔽、替换、注入和排序提示词段。
2. 层级管理：支持按会话阶段（引导期/常驻期/压缩受控期）与 Agent 预设分层管理。
3. 工具控制：允许从模型可见目录中隐藏工具，并提供技能集合管理。
核心能力¶
插件主要包含以下三个维度的管理能力：
- 提示词定制：
- 支持屏蔽（移除该段）、替换（编辑文本）、注入（新建段）和排序（拖拽调整）。
- 支持按会话阶段分层：引导期、常驻期、压缩受控期各自拥有独立的屏蔽名单、排序空间和工具目录。
- 支持按 Agent 预设分层：选中特定预设后，修改仅对该预设生效，未设置的字段回落全局。
- 技能集合管理：
- 支持技能包的导入、分组、开关以及健康检查。
- 支持通过拖拽将技能添加到特定阶段。
- MCP Server 接入：
- 支持接入 MCP Server 并进行工具级启停。
- 支持分层遮蔽（全局与预设层）。
典型用法¶
会话阶段控制¶
会话阶段由持久事件推导，分为引导期、常驻期和压缩受控期。
- 引导期配置：在引导期仅给模型 1 个工具和几段提示词，限制其初始能力。
- 常驻期配置：首个 durable 信号（如
tool/call）触发晋级后，放开全套工具和提示词。 - 压缩受控期配置：当会话经历压缩后，可以再次收紧配置，进入压缩受控期。
Agent 预设覆盖¶
- 在侧边栏“能力”面板的顶部选择特定的 Agent 预设。
- 对该预设进行提示词屏蔽、替换或注入操作。
- 改动只对该预设生效；未修改的字段将继承全局设置。
强制覆盖机制¶
插件默认开启 forceSections 功能。这意味着它会包装宿主的装配入口，最终提示词段直接从注册表原始段重建。因此，预设插件自身的阶段裁段（如引导期 20→1）与 persona 的 complete: true 整段接管，无法再改写本插件的屏蔽/替换/注入/排序结果。这确保了插件在提示词层面的控制权。
交互操作¶
- 拖拽：可以将“本系统全部提示词”或“本系统全部工具”池中的项，拖拽到指定阶段或池中，实时生效。
- 实时预览：在修改配置时，右侧面板会实时展示装配后的系统提示词和工具目录。
已知限制¶
- 覆盖层级：由于
forceSections默认开启，预设插件自身的阶段裁段与 persona 的complete: true接管无法再改写本插件的屏蔽、替换、注入和排序结果。 - 视图状态：阶段视图展示的是解析后的状态，而非历史会话状态。
- 技能注册：本插件不重复注册技能，与 DSH 内核插件分工。会话里的
/技能源与技能工具行由 DSH 内核的@deepseek-ai/dsh-client-ui-skill提供。
结语¶
dsh-prompt-customizer 为 DeepSeek Harness 提供了一个精细化的提示词与工具管理入口。通过按阶段和预设分层的能力，开发者可以更可控地引导模型行为。插件通过 MIT 许可证开源，适合需要在复杂智能体系统中进行提示词工程和工具编排的开发者使用。
