# 熵加密 · Entropy Cipher

> 用一张只有双方知道的字符表，把文本编码成汉字。链接结构与账号一并被替换。加密在浏览器本地完成，支持 MCP 服务与开放接口。

## 页面
- [产品说明](/)：它解决什么问题、怎么用、为什么难破；页面上有可直接试的实时加密框
- [加密工具](/app.html)：浏览器端加解密，含字符集建表、掩码模式、约定卡导出
- [接口文档](/api/openapi.json)：OpenAPI 3.1 描述
- [隐私说明](/privacy)：无账号、无 Cookie、无内容留存

## 两种模式
- **字节级**：密钥是一段字符表文本，密文逐字节换字
- **词级**（`mode=word`）：密钥只有一个**种子**，密文读起来像中文；不传 `source`，`fingerprint` 是种子的指纹
- 词级模式可以直接传**会话串** `EC1:口令:词表指纹:掩码`（一次约定一整串），响应会给出 `session` 与 `share_link`
- 种子可以写成**带校验位的口令**（`芦苇-湖泊-9066-0MKN`），抄错会被拦下；接口参数 `seed_phrase`
- 词级模式可选传 `words`（自定义词表），指纹会覆盖它，双方必须一致

## 核心规则
1. 字符表 = 一段文本按出现顺序的前 N 个不重复汉字（N=256 时恰好一字节一字）
2. 明文按 UTF-8 字节逐个查表；`,` `.` `!` `?` `，` `。` `！` `？` 原样透传
3. 可选掩码：字节先与一条由字符表哈希播种的伪随机流异或，重复模式被摧毁
4. 表私有时它就是密钥；双方只需约定同一段文本

## 接口
- `GET /api/agent-kit`：上手包：能力、场景、工作流、坑
- `GET /api/endpoints`：本目录本身：每个端点的用途、参数与示例
- `GET /api/self-check`：端到端自检：建表→加密→解密→会话串→词级往返→认领→识别→吞吐，逐项返回结论与耗时
- `GET /api/health`：存活检查
- `GET /api/stats`：埋点聚合计数（事件名→次数）与关键路径（产品动作链每步的计数与比例）。只对同源请求开放，运维可用 X-Stats-Token 头
- `POST /api/encrypt`：加密：字节级传 source，词级传 session/seed；支持 items 批量与 recipients 群发
- `POST /api/decrypt`：解密；传 sessions 数组即可认领（逐个会话串试解）
- `POST /api/phrase`：生成一份能念的口令：口令、实际种子、念读版、会话串与模式指纹一次给全
- `POST /api/identify`：识别字符集来源：给指纹或原文，返回是哪个内置经典还是自定义表
- `POST /api/session-check`：会话串体检：校验位过不过、词表指纹对不对、生效种子、念读版、有效期
- `POST /api/event`：第一方埋点：只记事件名与日期
- `POST /api/mcp`：MCP 服务器（JSON-RPC 2.0）：tools/list、tools/call、resources/list、prompts/list
- `POST /api/mcp`：MCP 服务器（JSON-RPC 2.0），工具 `build_table` / `encrypt` / `decrypt` / `generate_phrase` / `self_check` / `check_session` / `identify_sender` / `identify_table`；资源 `entropy://tables/index`、`entropy://tables/qianziwen`、`entropy://tables/baijiaxing`、`entropy://tables/sanzijing`、`entropy://tables/zengguang`、`entropy://tables/shenglv`、`entropy://tables/qianjiashi`、`entropy://tables/daodejing`、`entropy://tables/sanshiliu`、`entropy://tables/sanlue`、`entropy://tables/weiliaozi`、`entropy://endpoints`、`entropy://agent-kit`、`entropy://index`、`entropy://self-check`、`entropy://events`、`entropy://recipes`、`entropy://skill`；另有 `prompts/list`（8 个提示词）
- 批量：`encrypt` / `decrypt` 都接受 `items` 数组（最多 50 条，单条出错不影响整批）
- 群发：`encrypt` 接受 `recipients` 数组，同一段明文按各人自己的会话串各加密一份
- 技能包：`/skills/entropy-cipher/` 整份可下载（`SKILL.md` + `scripts/ec.py` 命令行 + `references/` 参考文档），MCP 侧用 `entropy://skill` 读同一份
- 认领：`decrypt` 接受 `sessions` 数组，逐个会话串试解；返回 `confidence`（none/single/multiple）与 `candidates`（带相似度的候选列表）。只有一条能解出时 `decoded_by` 才给序号；多条都能解出时不猜赢家，靠语义确认。MCP 工具 `identify_sender`
- 体检：MCP 工具 `check_session` 或 `POST /api/session-check`，校验口令校验位与词表指纹是否一致（支持批量）
- `dry_run`：`encrypt` / `decrypt` 传 `dry_run: true` 只校验不出密文/明文，适合批量预检

## 给 Agent 的提示
调用 MCP 时，先用 `build_table` 得到表与指纹，双方核对指纹一致后再加解密。字符集本身是密钥，不要外传。

埋点只记事件名与日期：来源地址、浏览器标识、Cookie、明文与密文、字符表与口令、接口请求体一律不记 —— 想看完整账本读 MCP 资源 `entropy://events`。