dsh-human-intent：AI 智能体的加密操作授权

AI 智能体可以执行真实的操作：删除数据、部署服务、花费资金、发送消息。拥有运行工具的能力并不代表人类授予了授权。现有的人机交互机制通常验证模糊的事实（“人类触碰了传感器”），然后给予智能体一个通用的 verified = true，通常有效一段时间。这无法将批准绑定到精确的操作。批准 rm -rf ./test-data 会静默授权 rm -rf ./production-data。dsh-human-intent 填补了这一空白。

这是什么¶

guhanfei-ai/dsh-human-intent 是一个 DSH 插件，用于验证人类意图并对 AI 智能体的操作进行加密授权。

它确保授权是精确动作绑定的、加密签名的、一次性的、过期的且可审计的。该插件通过将人类批准与要执行的特定命令精确绑定，解决了“能力 != 权限”的问题。

安装与启用¶

在本地开发环境中，使用以下命令安装插件：

dsh plugin --profile web add link:/Users/you/dsh-human-intent

核心功能¶

插件提供了以下核心能力：

精确动作绑定：批准被哈希并签名，覆盖精确的工具、目标和参数；任何变异都会使其失效。
加密签名：使用 WebAuthn（平台认证器、通行密钥或安全密钥）进行全服务器端验证。
一次性与过期：授权确切执行一次，且请求和收据具有短的有效期。
可审计：本地追加日志记录所有状态转换。
策略执行：通过 tools/pre-execute 策略钩子保护特定的 protectedTools。
API 与 UI：提供 human_intent_request、human_intent_verify、human_intent_status 接口，以及 Better Sidebar 审批面板和 WebAuthn UI。

典型用法¶

在安装并运行 DSH 客户端后，可以通过以下命令进行交互和调试：

运行交互式演示：

    npm run demo

这会打开浏览器进行注册（Touch ID / Windows Hello / passkey），展示智能体提出破坏性命令、人类批准/拒绝以及终端输出加密结果的全过程。

启动批准服务器：

    npm run serve

默认运行在 `http://localhost:8787`。

检查收据：
验证收据的结构、完整性和签名。

    node bin/dsh-human-intent.js inspect receipt.json

读取审计日志：
查看本地存储的审计记录。

    node bin/dsh-human-intent.js audit

适用场景与注意¶

环境要求：需要 Node.js >= 20.11。
本地开发：DSH 客户端 UI 必须从 localhost 提供服务，WebAuthn 功能才可用。DSH 主机来源必须在配置的 allowedOrigins 中。
安全模型：本项目不是指纹识别系统，也不识别具体的自然人。WebAuthn 证明的是持有注册凭据的用户执行了用户验证手势（User Verification），而不是证明特定自然人的身份。
概念区分：请注意“Capability”（智能体拥有调用工具的能力）与“Authority”（人类授予的执行权限）的区别。该插件只解决后者。

总结¶

该插件为 DSH 插件生态提供了一个基于 WebAuthn 的安全人机交互层。它通过密码学手段将人类批准与具体操作强绑定，确保智能体只能执行明确授权的动作。