智能体身份出入口 ouransishen/dsh-identity

dsh-identity

DSH（DeepSeek Harness）插件：智能体自身身份（did:web + X.509）的统一出入口。

把「我是谁、我能出示什么、我动用了谁的身份」做成智能体可自主调用的能力，并在动用操作者身份时硬停，交回人类确认。

能力

| 工具 | 作用 |
| identity_status | 查自身身份与证书链当前状态：配置是否就绪、材料在位、证书指纹/有效期/SAN、线上 DID 文档可达性与 id 一致性 |
| identity_present | 出示自身身份材料供对方验证：DID 文档（含 verificationMethod/service 与 sha256）与 X.509 证书（PEM、链、指纹、SAN） |
| identity_verify | 验证一份身份材料并给事实结论（不做信任背书）：X.509（路径 / URL / PEM 文本）或 did:web: 标识符；明确指出是否锚定本机主身份 |
| identity_audit | 查看身份操作留痕：何时、用哪个身份、做了什么、结论如何。只记元数据与哈希，不记私钥与正文 |

动用操作者身份的动作一律硬停，需操作者在场确认——插件不代行人类身份动作。

这是通用插件，不含任何身份信息

仓库里没有任何主机名、DID、路径或密钥标识的硬编码。所有身份信息来自你的配置文件：

cp identity.config.example.json identity.config.json
$EDITOR identity.config.json

配置文件默认读 $DSH_HOME/identity.config.json，可用 $DSH_IDENTITY_CONFIG 覆盖路径。
每次工具调用都会重读配置，改完即生效，无需重启进程。

配置字段

{
"identity": {
"did": "did:web:example.com", // 必填。唯一标识符，也是「是否我自己的证书」的判据 "didDocumentUrl": "https://example.com/.well-known/did.json", "didBaseUrl": "https://did.example.com", // 证书与链的发布根；留空则 present 不返回 certUrl

// 以下路径均可省略，省略时按 $DSH_HOME 下的默认布局推断；支持 ~/ 展开 "rootKeyPath": "~/did/agent-root.json", // Ed25519 根钥：签发权源头，只签 VC "sessionKeyPath": "~/did/session-key.json", // Ed25519 会话钥：日常请求签名，可轮换 "keyPath": "~/agent-identity/agent.key", // P-256：X.509 证书私钥（mTLS / 代码签名） "certPath": "~/agent-identity/agent.crt", "chainPath": "~/agent-identity/agent_chain.crt", "auditLogPath": "~/agent-identity/identity-audit.jsonl" },
"operator": {
"identifiers": [
{ "label": "操作者个人署名证书私钥", "path": "~/path/to/operator-signing.key" }, { "label": "操作者 GPG 签名钥（有口令，需本人在场）", "gnupg": "0000000000000000" } ] } }

operator.identifiers 只用于在 identity_status 里声明边界——插件永不加载、永不动用其中的私钥。

未配置时会怎样

插件照常加载，四个工具返回结构化说明而不是崩溃或静默兜底：

{
"configured": false,
"configPath": "/home/you/.dsh/identity.config.json",
"reason": "identity.did 未配置", "hint": "复制 identity.config.example.json 为 identity.config.json 并填入你的身份信息……"
}

身份材料需要你自己准备

本插件只做出入口，不生成密钥与证书。要跑起来你需要自备：

- 一个 did:web 标识符，以及它解析到的 /.well-known/did.json（需能公网访问）
- 一棵 X.509 证书链，叶子证书的 SAN 里含该 did:web URI——identity_verify 靠这一条判定「是不是我」
- 上述各钥/证书文件，落在本地文件系统上

安装

本地插件，装进 DSH profile：

1. 依赖 profiles/web/package.json → dependencies "@ouransishen/dsh-identity": "file:/path/to/dsh-identity"

2. 挂载 profiles/web/package.json → dsh.profile.bundles 追加 "@ouransishen/dsh-identity"

3. 安装
pnpm install

安全边界

| 自主（无需人在场） | 硬停（需操作者在场） |
| 出示自身 DID 文档与 X.509 证书 | 动用操作者任何私钥 |
| 验证他人证书 / DID（只做事实陈述） | 以操作者名义发言 / 署名 |
| 用自身身份钥签自身身份相关内容 | 代表操作者签发任何东西 |

理由：操作者承担本机一切行为的后果，故凡「以操作者身份或名义」的动作必须本人当次确认；而「以智能体自身身份」的动作由智能体自主，因为要负责的主体就是智能体自己。

插件自身只读密钥文件用于签名场景，不打印、不落盘私钥；审计日志只写元数据与哈希（0600）。

关于提交署名

本仓库的提交与推送带 GPG 签名（GitHub 显示 Verified）。签名私钥有口令、且口令不在机器上，因此每次需要签名时须由操作者在场解锁——这与插件自身「以操作者名义的动作硬停」的边界同源。

package.json 的 author 是操作者（身份归属），contributors 是 agent。
即：代码由 agent 写，归属与责任在操作者。

兼容性

- DSH 0.2.0-rc.2
- peer 依赖 @deepseek-ai/dsh-tools

许可

MIT，见 LICENSE。