前言¶
DeepSeek Harness（DSH）是一个基于插件化架构的框架，允许开发者通过编写插件来扩展智能体的行为能力。在实际开发中，Agent 执行某些操作（如删除文件、修改配置）时，开发者往往只能看到操作是否成功，却难以直观评估该操作带来的实际损失（Silent Loss）。这种信息不对称可能导致开发者做出不理性的决策。
dsh-project-guard 是一个旨在解决这一痛点的插件。它通过后果分析，在 Agent 触碰机器之前或之后，明确告知用户某个操作的成本与损失。
插件定位¶
- 名称：
dsh-project-guard - 核心价值：Consequence analysis for DeepSeek Harness: states what an action will cost you.
- 维护者：Inceptzws
- 分类：admin-security
- 许可证：MIT
核心能力¶
该插件不依赖任何外部模型调用，而是通过确定性表格查询来完成判断。它主要提供以下功能：
- 预执行后果预览：在 Agent 执行操作前，展示该操作可能带来的后果。它会列出不同选项（执行、拒绝、备份后执行、重写）对应的损失。
- 执行后报告：在操作执行后生成报告，对比预测值与实际值，帮助开发者发现“静默损失”。
- 多维度兴趣管理：支持 21 个兴趣维度，开发者可以配置权重和层级。
- 零依赖：无需构建步骤，无额外依赖。
配置与使用¶
1. 设置触发机制¶
插件通过 discloseOn 配置项决定何时显示后果信息。默认情况下，插件仅在 Agent 需要额外权限确认时运行。
# 配置示例：仅在询问时显示
discloseOn: asks
# 配置示例：对所有已知操作显示
discloseOn: all
2. 启用执行后报告¶
Post-execution Report 默认是关闭的。如果需要记录操作后的预测与实际对比，需要开启此开关。
# 开启执行后报告
reportExecuted: true
3. 定义自定义兴趣维度¶
开发者可以在 YAML 配置中定义自己的兴趣维度，指定其权重和层级。
interests:
my_data:
weight: 0.95
tier: 1
label: "自定义数据维度"
4. 查看报告¶
执行后的报告默认保存在项目根目录下的 .dsh-project-guard/reports.l 文件中。
设计与注意事项¶
- 静默策略：这是插件的设计决策。只有超过阈值且排在前列的后果才会被展示。低于阈值的后果会被完全忽略，以避免信息过载。
- 置信度限制：不同层级（Tier）的维度，其计算出的置信度上限不同。层级越高（Tier 3），置信度上限越低，甚至只做标记不进行评分。
- 价值判断：插件无法预测具体的价值判断，只能标记出涉及价值判断的情况。
- 版本：当前版本为 1.1.1。
