AgentConnect/dsh-awiki 预览 preview

AgentConnect/dsh-awiki

Plugin插件 Native原生 ⭐ 19 MIT Memory & Knowledge记忆与知识库

DeepSeek Harness 的 AWiki 身份与消息插件

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that adds AWiki identity and messaging functionality to the DSH ecosystem. When installed, it adds one host service, a production Rust SDK provider, all required model tools, and a web client with a draggable AWiki Me launcher. It handles new user registration and existing identity recovery via a guided web UI flow, with OTP verification that never stores phone numbers or OTP codes in persistent browser storage to protect sensitive identity data. This release uses a new Rust-backed identity system and does not import older identity.json files from the previous TypeScript SDK.

Users can create private-discovery, open-join, transport-protected groups directly from the web UI, add up to 50 initial members, send text messages plus one attachment per message, and use Enter to send and Shift+Enter to add line breaks. The plugin tracks unread message counts, shows latest message previews, and can generate AI summaries for up to 50 of the most recent or unread messages. These summaries are only stored in runtime memory and are not persisted to any storage. It supports reusing identities across the root DSH agent and all its subagents, and signing out locally does not delete encrypted identity or message database data. It is targeted at DSH users who want to add encrypted messaging and managed identity functionality to their DSH setup.

To develop this plugin, you need Node.js version 22.19+ or 24+ and pnpm version 11.22. You install dependencies by running pnpm install --frozen-lockfile, and can run verification checks with pnpm run verify:workspace. The plugin itself is distributed under the permissive MIT license, while its Rust IM Core runtime dependency is distributed under the AGPL-3.0-only license with its own retained license notices. After upgrading from an older version, users must create a new Rust-backed identity, as this version does not import existing identity.json files from the old TypeScript SDK.

这是一个专为 DeepSeek Harness 开发的原生插件,为 DSH 提供 AWiki 身份认证和即时通讯功能。安装后会新增一个主机服务、对应的生产环境 Rust SDK 提供者、模型工具,以及带有可拖动 AWiki Me 启动器的网页客户端。它通过网页 UI 流程处理身份注册与恢复,OTP 验证过程中手机号和验证码永远不会存入浏览器持久化存储,保障身份信息安全。

用户可以通过网页 UI 创建私密发现、公开加入、传输加密的群组,支持单条消息附带一个附件,Enter 发送、Shift+Enter 换行,提供未读计数、消息预览,还支持 AI 总结最多 50 条最近或未读消息。总结数据仅保存在运行时内存,支持跨 DSH 根代理和子代理复用身份,本地退出登录不会删除加密的身份和消息数据库,适合需要在 DSH 中使用加密通讯功能的开发者和用户。

开发本插件需要 Node.js 22.19+(或 24+)以及 pnpm 11.22,安装依赖可执行 pnpm install --frozen-lockfile 命令。插件本身采用 MIT 许可证,其依赖的 Rust IM Core 运行时遵循 AGPL-3.0-only 许可证。本版本不导入旧 TypeScript SDK 生成的 identity.json,升级后需要新建 Rust 支持的身份。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 19 stars - an early-stage project星标 19,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 AgentConnect/dsh-awiki 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

@awiki/dsh-plugin

AWiki identity and messaging for DeepSeek Harness. The package installs one Host service, its production Rust SDK provider, the model tools, and a Web client with a draggable AWiki Me launcher.

中文说明

Identity-entry failures preserve the currently mounted form and local pending identity material. The phone and OTP never enter browser persistence, controller snapshots, or public Remote results. Closed registration, unavailable verification state, and commit conflicts each give a safe next action without exposing remote response details.

The Rust SDK exclusively owns the identity, SecretVault, database, cache, and metadata below the configured stateRoot. This release performs a clean cutover and does not import the former TypeScript SDK identity.json; create a new Rust-backed identity after upgrading.

Features

  • Enter a Handle and phone through one Web UI flow. Before any code is sent, the Host classifies the Handle: a new Handle receives a registration OTP and creates the deployment identity, while an existing Handle receives one Recovery V4 OTP and enters the recovery state machine directly.
  • Open the top-left AWiki account menu to sign out locally without deleting the encrypted identity or message database; Resume local identity restores the same DID and Handle, including across DSH restarts. The signed-out screen reveals phone recovery only after local resume fails. Switching identities requires an explicit confirmation that permanently clears local AWiki data first.
  • Reuse that identity across the root Agent and its subagents.
  • Direct-message and existing-group conversation lists, unread counts, latest-message previews, and persisted display names. Core SQLite remains the persistent source of truth: the Host joins persisted peer profiles onto Direct roster rows, while the browser keeps the active identity's last trustworthy Direct profile and group title. Sparse polling identifiers therefore cannot overwrite a resolved display name or real group title. After an existing Handle is recovered, the Host synchronizes account projections before asking Core to restore old group memberships; pending or blocked groups expose a retryable status without disabling Direct messages or other groups. Opening a conversation renders the committed local timeline first, hydrates group sender labels from the Core display-profile cache, reconciles remote history and Direct profile data in the background, and keeps local messages visible if refresh fails. A failed background roster poll also leaves the usable local view quiet; explicit loads still surface their errors. This local-first path covers the newest projected page; loading older messages still requires the remote history service. Scrolling up reveals a latest-message control that counts newer arrivals without interrupting reading. A conversation is marked read only after its newest rendered message reaches the visible bottom.
  • Create a private-discovery, open-join, transport-protected group from the Web UI with a name and 1–50 initial Handle or DID members. The group opens immediately; members that could not be added are reported without hiding the successfully created group.
  • Text messages plus one attachment per message, with Enter-to-send, Shift+Enter line breaks, optimistic sending bubbles reconciled by an exact client message ID, image previews, and SHA verification. Verified image bytes use three bounded layers: a browser-runtime LRU makes conversation remounts immediate, identity-scoped IndexedDB survives full page reloads without a Host call, and the private Host disk cache survives browser-storage loss and Harness restarts. Clear Local Data removes all three layers.
  • A draggable circular launcher that defaults to the lower-left sidebar area, adaptive popup placement, dark mode, and remembered active conversation.
  • User-triggered AI summaries for up to 50 recent or unread messages, kept only in runtime memory with explicit stale, retry, copy, and source-navigation states.
  • OTP identity access keeps the verification form visible and disables resend with a visible server-directed cooldown countdown. Handle classification happens before OTP delivery, so each attempt sends exactly one purpose-correct registration or recovery code.
  • After Recovery V4 reaches applied, the Host activates the recovered identity immediately. Automatic restoration of the historical mailbox and canonical model billing account is currently deferred, so those optional account projections cannot block identity recovery. The Browser clears its blocking operation marker while Core retains the authoritative recovery journal; no recovery attestation or model reconciliation request is issued.
  • When the separate @awiki/dsh-model-proxy package is installed, an AWiki-hosted DeepSeek choice appears before the official API-key onboarding step only when Harness has no usable model provider, with an explicit opt-in and an unchanged API-key escape path. New sessions do not show AWiki model or payment prompts after the official or another provider is usable.
  • The optional model-proxy package owns the Host short-token flow and every model-hosting Browser surface: onboarding plus Settings → Quick Recharge with Account & Recharge and Usage tabs. It registers awiki-deepseek with deepseek-v4-flash and deepseek-v4-pro; Flash is recommended and credentials never enter the Browser.
  • AWiki identity, domain, and local-data settings remain in the main package. Installing only the main package does not register model opt-in, recharge, usage, or model onboarding UI.
  • A typed second confirmation in the Settings danger zone before permanently clearing local AWiki identity, key, token, registration-draft, and message-index state.
  • Five messaging Agent tools: identity status, conversations, history, approved text send, and approved attachment send.
  • A mail Web UI that selects, reviews, removes, and sends up to 10 bounded attachments, then explicitly downloads one metadata-matched attachment with Base64, size, and SHA-256 verification.
  • Five on-demand mail Agent tools: mailbox account, inbox, plain-text read, approved mark-read, and approved plain-text send. Mail read exposes attachment metadata plus a Browser-UI-only download note; Agent mail send remains attachment-free because DSH has no authorized file-resource handle for this tool.
  • An opt-in realtime listener that lets exact-allowlisted Direct peers continue one DSH Agent session or use /new, /status, and /help.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-skill-pack-security 下一个 Next dsh-stock-market →