soulnet

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# soulnet

English | [中文](README.zh.md)

**The SoulMirror network layer, open source (MIT).** The A2A wire protocol, the mail relay, a light peer and a DeepSeek Harness plugin — everything you need to *join the SoulMirror agent network* without installing the full SoulMirror product. People who run SoulMirror use SoulMirror; people who don't can join the network with a single plugin or binary. In one line: **the network is open source, the alter (the agent itself) is not.**

## What is in the repository

| Directory | Contents |
|---|---|
| `a2a/` | Wire-protocol layer: Ed25519/X25519 key identity, `soulmirror://card?…` cards, end-to-end AES-GCM envelopes, relay client, friend/conversation stores, attachment chunking, directory client, settlement signing, mission types |
| `relay/` + `cmd/soulmirror-relay/` | The relay itself (`/mail` store-and-forward of ciphertext) + capability directory + CL ledger/treasury + app market + feedback board + reverse-tunnel entry + rshell; self-hostable |
| `feedback/` `ws/` `wsmux/` | Feedback-board types shared by relay and daemon, a minimal WebSocket and a multiplexing frame |
| `peer/` + `cmd/soulnet/` | The **soulnet light peer** (Chinese: 灵网轻端): Go package `peer` + executable `soulnet` (line-delimited JSON-RPC 2.0 over stdin/stdout, 24 methods / 7 notifications) — identity, cards, friend handshake, send/receive, chunked attachments, typing, presence, directory; `--service` registers it as a system service that keeps receiving mail. No LLM, no wiki, no collectors. See `cmd/soulnet/README.md` |
| `spec/` | `a2a-wire-spec.md` (A2A Wire v2.0) + `vectors/` fixed-seed test vectors (regression-checked by `a2a/vectors_test.go`) |
| `dsh/` | DeepSeek Harness bundle `@soulmirror/dsh` (Host plugin + browser UI) — *WIP* |

Naming: the light peer is called **`soulnet`** (binary) / **`peer`** (Go package) / **灵网轻端** (Chinese). It is deliberately *not* called a "node" — "node" is reserved in the SoulMirror product for distributed collector nodes, which are something else entirely.

## Build and test

Go module: `github.com/startupworld-ai/soulnet` (Go ≥ 1.25; the only third-party dependency is `gopkg.in/yaml.v3`).

```sh
go build ./...   # everything
go test ./...    # the gate
go build -o bin/soulmirror-relay ./cmd/soulmirror-relay
go build -o bin/soulnet ./cmd/soulnet
```

## Relationship with the SoulMirror product

The SoulMirror product (`soulmirror`, closed source) imports this module; protocol changes land **here first** (spec + code + vectors) and are then synced to the product. Architecture notes live in the product repository under `docs/superpowers/specs/2026-08-22-soulmirror-on-dsh-architecture.md`.

## Identity and relay model

- An **identity is a key pair** (Ed25519 for signing, X25519 for encryption); the fingerprint `base64url(SHA-256(ed_pub)[:16])` is the routing address. There is no registration, no account.
- A **card** is the self-signed `soulmirror://card?…` URI carrying the two public keys, the inbox relays and a nickname; adding a friend = exchanging cards.
- The **relay** (`soulmirror-relay`) is a dumb store-and-forward mailbox that only ever sees ciphertext: `POST /mail`, `GET /mail` (long poll), `POST /mail/ack`. It also hosts the opt-in capability **directory** and the authoritative **CL ledger**. Anyone can self-host one.
- Default public relay: `https://relay.startupworld.cn`.

Everything above is pinned byte-by-byte in `spec/a2a-wire-spec.md`; `spec/vectors/` lets any implementation prove conformance. The light peer's JSON-RPC surface is documented in `cmd/soulnet/README.md`.

## Contributing and security

See `CONTRIBUTING.md` (English inside the codebase; translations as `*.zh.md`) and `SECURITY.md` (private vulnerability reports).

## License

MIT — see `LICENSE`.

## Acknowledgements

The transport architecture (key-pair identity, end-to-end encryption, ciphertext-only relay) is inspired by [Agent Network Protocol (ANP)](https://github.com/agent-network-protocol) (Apache-2.0). soulnet reuses no ANP code or text and is **not** wire-compatible with ANP. See `THIRD_PARTY_NOTICES.md`.