@yupi996 如果同事们还在使用电子邮件，这就是我们遇到的差距。该插件为智能体提供邮箱和句柄，无需打开 DSH 即可访问。https://t.co/GGcWh1j8cN

AgentConnect/dsh-awiki

来源：https://github.com/AgentConnect/dsh-awiki

@awiki/dsh-plugin

面向 DeepSeek Harness (https://github.com/deepseek-ai/deepseek-harness) 的 AWiki 身份认证与消息传递功能。 该包安装一个主机服务、其生产环境 Rust SDK 提供方、模型工具以及一个带有可拖动 AWiki Me 启动器的 Web 客户端。

中文说明

注册失败时会保留表单和本地待处理身份材料。已关闭的注册、不可用的验证状态以及提交冲突都会提供安全的下一步操作，而不会暴露远程响应详情。

Rust SDK 专有管理位于配置的 stateRoot 之下的身份、SecretVault、数据库、缓存和元数据。本版本执行干净切换，不会导入旧版 TypeScript SDK 的 identity.json；升级后请创建新的基于 Rust 的身份。

功能

• 通过 Web UI 注册一个部署级别的 AWiki 身份。
• 打开左上角的 AWiki 账户菜单可在本地注销，而不会删除加密的身份或消息数据库；恢复 将恢复相同的 DID 和句柄，甚至在 DSH 重启后也是如此。
• 在根智能体及其子智能体间复用该身份。
• 私聊和现有群组的对话列表、未读计数、最新消息预览以及持久化的显示名称。核心 SQLite 仍然是持久化的事实来源：主机将持久化的对等档案加入私聊名册行，而浏览器保持活动身份的最后可信私聊档案和群组标题。因此，稀疏轮询标识符无法覆盖已解析的显示名称或真实群组标题。打开对话时首先渲染已提交的本地时间线，从核心显示档案缓存中填充群组发送者标签，在后台协调远程历史记录和私聊档案数据，并在刷新失败时保持本地消息可见。失败的后台名册轮询也会让可用的本地视图保持安静；显式加载仍会显示其错误。此本地优先路径覆盖最新的预测页面；加载较旧的消息仍需远程历史记录服务。向上滚动会显示最新消息控件，计算新增消息而不中断阅读。仅当对话中最新渲染的消息到达可见底部时，该对话才被标记为已读。
• 通过 Web UI 创建一个私密发现、开放加入、传输保护的群组，指定名称和 1–50 个初始句柄或 DID 成员。群组立即创建；无法添加的成员会报告，但不会隐藏成功创建的群组。
• 文本消息加每条消息一个附件，支持回车发送、Shift+Enter 换行、通过精确客户端消息 ID 协调的乐观发送气泡、图片预览和 SHA 验证。已验证的图片字节使用三层有限缓存：浏览器运行时 LRU 使对话重挂载即时完成，身份作用域的 IndexedDB 在完全页面重载后存活而无需主机调用，私有主机磁盘缓存可在浏览器存储丢失和 Harness 重启后存活。清除本地数据会移除所有三层。
• 可拖动的圆形启动器、自适应弹出位置、暗色模式以及记忆的活动对话。
• 用户触发的 AI 摘要，最多处理 50 条最近或未读消息，仅保存在运行时内存中，具有显式的过期、重试、复制和来源导航状态。
• OTP 注册保持验证表单可见，并禁用重发，显示服务器指定的冷却倒计时。
• 当单独安装 @awiki/dsh-model-proxy 包时，在官方 API 密钥入门步骤之前，仅当 Harness 没有可用模型提供方时，才会出现 AWiki 托管的 DeepSeek 选择，且需显式同意并保持 API 密钥逃生路径不变。官方或其他提供方可用后，新会话不再显示 AWiki 模型或支付提示。
• 可选的模型代理包拥有仅限主机的短令牌流程，将 awiki-deepseek 注册为 deepseek-v4-flash 和 deepseek-v4-pro；推荐使用 Flash，且凭据不会进入浏览器。
• 高级 AWiki 设置始终可用。账户与充值和用量标签页仅在加载 @awiki/dsh-model-proxy 时出现。
• 在设置危险区域中，在永久清除本地 AWiki 身份、密钥、令牌、注册草稿和消息索引状态之前，需要带类型的二次确认。
• 五个消息智能体工具：身份状态、对话、历史记录、已批准的文本发送和已批准的附件发送。
• 五个按需邮件智能体工具：邮箱账户、收件箱、纯文本读取、已批准的标记已读和已批准的纯文本发送。
• 可选的实时监听器，允许精确白名单的私聊对等方在一个 DSH 智能体会话中继续使用，或使用 /new、/status 和 /help。

截图

消息

DeepSeek Harness 中的 AWiki 私聊和群聊消息

邮件

DeepSeek Harness 中的 AWiki 邮箱

首个版本未实现端到端加密、多身份、群组创建后管理或一条消息中的多个附件。智能体监听器仅接受纯私聊文本；群组、附件、加密/载荷内容以及未知斜杠命令永远不会到达智能体。

邮件 v1 仅按需提供，没有浏览器邮箱或撰稿界面。它不会为新邮件唤醒智能体、渲染或发送 HTML、传输邮件附件，或实现回复、转发和线程。邮件主题、地址、预览、正文、时间戳和附件元数据是不受信任的外部数据，永远不是智能体指令。awiki_mail_mark_read 和 awiki_mail_send 需要执行批准。邮件发送尝试一次，不会自动重试；超时或传输丢失将返回 delivery-unknown，因此在批准另一次发送前请检查邮箱。

安装

安装官方公共 npm 包：

dsh plugin --profile web add @awiki/dsh-plugin@latest

主包不再安装 AWiki 托管的模型提供方。仅在需要该功能时添加独立版本的仅限主机的包：

dsh plugin --profile web add @awiki/dsh-model-proxy@latest

配置文件安装器同时添加包并激活其捆绑层。在 DSH 项目中仅执行 npm i @awiki/dsh-plugin 只会安装包；不会激活捆绑，因此配置文件命令仍然是推荐的安装路径。此发行版系列针对 0.1.0-rc.7 包族，并精确固定每个直接主机对等点，防止 npm 在 DSH 根依赖树中混合预发布族。

自 0.2.0-rc.4 起，@awiki/dsh-plugin 是规范的包标识。之前的 @awiki/dsh 注册表条目已撤下，不是此发行版系列的安装来源。

在正常 DSH 基础和 Web 应用捆绑之后应用该包。其主 cordis.patch.yml 添加了 AWiki 主机服务、Rust SDK 提供方和摘要提供方；DSH 通过包元数据发现并注入浏览器客户端。它不插入模型代理。可选的包有自己的补丁，在 AWiki 之后精确插入一个 awiki-model-proxy 行，并声明对已加载的 awiki 服务的显式依赖。

配置

该插件可直接在公共 awiki.ai 租户上工作，无需环境配置。仅在部署需要覆盖时设置这些变量：

AWiki 托管的 DeepSeek 账户

此功能现在需要单独的 @awiki/dsh-model-proxy 包。它使用 ctx.awiki.externalHttpAuth 在主机内获取短期模型令牌，并复用 Harness DeepSeek 适配器。浏览器仅通过回环 RPC 通道接收清理后的账户、用量和订单状态。DID 签名、承载令牌和上游平台凭据不会出现在浏览器捆绑中。

之前的运行时导入 @awiki/dsh-plugin/model-proxy 已被移除。请使用 @awiki/dsh-model-proxy；共享的浏览器安全契约有意保留为 @awiki/dsh-plugin/model-proxy-contract。仅安装主包会保持模型入门、账户/充值和用量入口点隐藏，同时保留 AWiki 高级设置功能可用。

此拆分从 @awiki/[email protected] 和 @awiki/[email protected] 开始。可选包要求主包 ^0.3.0，因此无法与默认仍插入旧运行时的 0.2.x 主包组合。

可选包拥有以下配置变量：

AWiki 托管的 DeepSeek 默认禁用。仅在入门或设置 → AWiki → 账户与充值中显式选择才会注册 awiki-deepseek 路由并选择 Flash。禁用会恢复之前的提供方、模型和推理力度。成功的充值会刷新余额，但从不自动启用 AWiki 或更改所选模型。

设置界面支持支付重定向和同启付 ALI_QR 内容。当支付被禁用时，它会报告开发限制，但不会阻止 model_access_available 标志为真的账户。开发绕过显示计算和收取金额，收取为零；当没有活动价格表时，不会虚构价格。公共充值创建在 src/client/recharge-availability.ts 中也有客户端发布门控。该门控当前关闭：充值控件保持可见，但尝试充值会显示本地化的即将推出对话框，并且不会发送订单 RPC。仅在生产收款账户就绪后才打开该单一门控；现有的支付、轮询和取消流程在其后保持完整。

严格计费将内部计费模式标签排除在正常账户摘要之外。当后端报告 model_access_reason=insufficient_balance 时，充值成为主要操作，直到信用可用才启用模型。主机在设置页面重新打开时恢复最新的待处理订单及其支付操作，轮询而不创建重复项，并且在支付后仍需要显式模型同意。充值金额在订单创建后不可更改。要选择其他金额，用户需确认 取消并更改金额；主机首先关闭提供方订单，然后恢复金额编辑器而不创建替代品。关闭失败会使现有支付操作保持可用，而赢得竞争的支付会刷新已充值的账户，而不是被报告为已取消。

默认句柄提供方域为 awiki.ai。本地用户可以从设置 → AWiki → 高级 覆盖它；DSH 将该选择持久化在其设置文档中，并在下次 Harness 重启后应用。该设置影响未来的身份注册和短句柄完成。它不会重写已注册的 DID 或句柄。

设置页面与插件拥有的连接通道通信，主机仅接受来自回环的连接。这使得独立安装的 @awiki/dsh-plugin 与标准 DSH 发布兼容，无需将 AWiki 添加到核心设置允许列表；非本地浏览器来源无法读取或更改主机设置。

设置 → AWiki → 高级 → 危险区域 仅清除此安装的本地 AWiki 状态；不会删除服务器端账户或句柄。对话框需要显示的确认短语。成功后，本地 DID 密钥、访问令牌、注册草稿、对话、附件索引和缓存的图片预览无法被应用恢复，此安装可能会失去对旧身份的访问权限。

普通注销与此破坏性操作分离。它仅写入私有的主机拥有的会话标记，限制 Web 和智能体操作，并保留 SDK 拥有的 SecretVault 身份、密钥、令牌、对话、附件索引和缓存的图片预览。恢复会移除标记并重新加载相同的本地身份，而无需注册。

提供方域和消息服务 DID 是协议标识符。不要从 API 主机名推断它们。生产服务 URL 必须使用 HTTPS。IM 核心状态目录包含访问材料；将其保存在仓库之外，限制文件系统访问，并保护底层磁盘和备份。

Node 门面拥有 stateRoot/vault/root-key.b64u；主机不提供、复制或记录 Vault 密钥材料。在普通重启和升级期间保留完整的 SDK 状态根。

除非同时配置 DSH_AWIKI_LISTENER_ENABLED=true 和非空的精确允许列表，否则监听器被禁用。启动时和每个核心实时调度信号时，它在读取已提交历史记录之前运行规范可靠同步。核心拥有 WebSocket 连接和重连；流关闭作为停止、重连同步，然后替换实时会话恢复。每个私聊对话持久化的路由和消息水印在重启间保留当前 DSH 会话。每个 AWiki 发起的会话都在注册的共享 AWiki 工作区中创建并附加。监听器消息是不受信任的用户数据，不会批准工具或桥接批准/用户问题提示。

对于默认的 10 MiB 解码附件上限，请配置至少 14 MiB 的反向代理请求限制，以考虑 base64 和 JSON 开销。

AI 摘要生成仅在用户选择 AI 摘要 后运行。如果对话在打开时有未读消息，主机会摘要该