DeepSeek Harness (DSH) 是一个以插件为核心架构的模型推理工具。在 Vibe Coder 模式下，开发者习惯直接在编辑器中写下自然语言请求，这些请求往往包含自我修正、碎片化表达或冗余信息。如果直接发送给模型，容易导致指令不清、产生幻觉或执行不必要的操作。
vibe-intent-compiler 是一个 DeepSeek Harness 插件，由 Shhaaawwww 维护。它读取 composer 中未发送的完整草稿，仅重组用户实际表述的内容，并将结果填回原位。该插件不生成新的细节，专注于提升指令的清晰度与忠实度。
安装与前置要求¶
安装前请确保环境满足以下条件：
- Node.js 版本为
22.19.x或24+。 - DeepSeek Harness 版本为
0.1.1-rc.2或更高。 - 系统已安装
pnpm（DSH 内部依赖此包管理插件）。
在终端执行以下命令安装插件：
dsh plugin --profile web add "github:Shhaaawwww/vibe-intent-compiler#v0.4.0"
安装完成后，启动 Web UI 并进入对话页面，composer 中会出现 ✦ Clarify 按钮。
典型用法¶
- 在 composer 中输入自然、碎片化或自我修正的请求草稿。
- 可选：输入
@符号，从 Harness 中选择最多 3 个文件。只有被选中的文件会被读取，用于解决草稿中已有的模糊引用。 - 点击
✦ Clarify按钮。 - 审查插件重写后的草稿，如有需要可手动编辑，然后自行发送。
示例：
Before: Login keeps breaking lately, maybe it's the token. Make the UI nicer too—actually, leave the UI alone for now.
After: Fix the recent recurring login issue. Treat the token as a possible cause to investigate, and do not change the UI.
核心功能¶
1. 忠实上下文重写 (Faithful Context Beta)
插件版本 0.4 处于 Faithful Context Beta 阶段。它会检查重写后的文本是否保留了原始草稿中的受保护文本，并拒绝那些省略了关键信息或引入了新的 @reference 的结果。如果无法验证安全且忠实的结果，原始草稿将保持不变。
2. 智能处理修正与撤回
插件会将后续的修正视为对先前措辞的替换，仅当它们与之前的表述冲突时生效。同时，它会移除被明确撤回的想法，但会保留其中的约束条件、偏好和不确定性说明。
3. 技术细节保护
在重组过程中，插件会保留代码片段、命令、路径、URL、错误消息、标识符、Schema 键和专有名词，防止因自然语言转换导致的技术信息丢失。
4. 上下文引用解析
当用户显式选择文件时，插件仅使用这些文件来解析草稿中已存在的引用，无需在项目中进行全局搜索或启动代理循环。
边界与限制¶
- 自动执行限制：插件永远不会自动执行任务或发送消息，所有操作由用户触发。
- 文件上下文限制：文件上下文是确定性的，最多 3 个文件，每个文件 24 KiB，总计 48 KiB。
- 超长草稿：如果草稿长度超过 20,000 字符，插件将保持草稿不变。
- 安全路径拦截：敏感路径（如
.env、凭据文件、SSH 密钥等）会被拦截，且草稿和选中的文件内容在发送前会检查常见的凭证模式。 - 输入日志保护：原始草稿不会出现在命令输入日志中，仅重写后的结果会作为命令结果保留在会话中。
生态位置¶
本插件遵循 MIT 许可证，可通过 GitHub 仓库获取源码。它属于 DeepSeek Harness 社区插件生态的一部分，与 DeepSeek 官方无官方从属关系。
- GitHub: https://github.com/Shhaaawwww/vibe-intent-compiler
- 插件目录: https://www.skillhub.cn/plugins/Shhaaawwww/vibe-intent-compiler
