前言¶
DeepSeek Harness (DSH) 的核心设计之一是插件化。插件 dsh-ditto 针对的是批量任务的人工审核痛点。当需要处理 30 个相似文件时，直接让 AI 执行容易累积错误，且缺乏人工复核的环节。该插件引入“先审核，后应用”的机制，通过少量样本的校验来确立标准，再进行全量预览和执行。
是什么¶
dsh-ditto 是一款 DeepSeek Harness (DSH) 插件，作者为 darrien1998。它是一个 Review-first（先审核）的批量自动化工具。其核心流程为：先让 AI 抽取并处理 3 个样本供人工审核和修正，确立标准；随后基于此标准预览所有剩余文件；最后在人工确认后，安全地批量写入文件。
安装与启用¶
插件通过 DSH 的插件命令安装。安装前需确保目标 profile 的 pnpm 可用。
dsh plugin --profile web add dsh-ditto
安装后，可通过 doctor 命令检查环境与权限：
dsh plugin --profile web exec dsh-ditto doctor
注：--profile 参数需根据实际环境替换（如 headless、acp 或自定义名称）。
核心功能¶
该插件提供以下能力：
- Review-first batch automation：先审核，后批量。
- Evidence-backed Code to Spec：生成带行号证据的代码转规格文档。
- Safe bulk file organization with manifests：安全的批量文件组织，支持生成 CSV、SQL、Markdown 等清单。
- Deterministic ZIP delivery：确定性的 ZIP 交付，支持校验清单和侧边栏文件。
- Human-in-the-loop approval：全量预览前必须经过人工审批。
使用示例¶
Code → Spec¶
从代码库生成统一的 Markdown 规格文档：
- Discover：扫描目录，报告作用域与排除项。
- Review：抽取 3 个结构不同的样本（如导出最多的、导入最多的、最小的），生成带行号证据的草稿，人工编辑直至满意。
- Approve：确认样本为标准。
- Preview：基于样本标准，预览所有剩余模块的文档。无法由证据支持的内容会被标记为“Needs confirmation”。
- Apply：审批通过后，将 Markdown 文件写入输出文件夹（不修改源文件）。
File organization¶
对 PDF 文件进行批量重命名和迁移：
- Define Rule：使用正则表达式匹配文件名，设定源路径和目标路径。
- Review：预览所有 proposed copy 和 deliverable。
- Manifests：在审批前，可导出 CSV、JSON 或 Markdown 格式的映射清单，或生成 SQL Server INSERT 语句（仅文本生成，不执行）。
- Apply：确认无误后，执行复制操作。生成 ZIP 归档。
注意事项¶
- 不涉及模型调用：插件本身不调用大模型 API，也不存储 API Key。模型调用由 DSH agent 负责，插件仅接收结构化证据和草稿。
- 数据安全：原始文件永不移动或修改；现有文件永不被覆盖。所有操作基于预览，仅在确认后写入。
- 环境要求：需要 Node.js 22 或更高版本，以及 DSH 0.1.5-rc.1 或更高版本。
- SQL 安全：插件虽能生成 SQL 语句，但绝不连接数据库或执行 SQL。
结语¶
dsh-ditto 为 DSH 提供了一种在批量自动化场景下保持安全与可控的方案。通过将“决策”权保留给人类，将“执行”权交由确定性的插件逻辑，它降低了批量任务出错的风险。
