npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@dsh-mobile/mobile-remote

v3.3.0

Published

DSH Mobile:把 DeepSeek Harness 变成随身控制台——手机远程发消息派活、看进度、收通知、审批决策、管理会话;配套 Flutter App(Android、iPhone / iPad)

Readme

DSH Mobile(dsh-mobile-remote)

把 DeepSeek Harness 变成随身控制台:手机远程操作电脑上的 agent —— 发消息派活、看进度、收通知、审批决策、管理会话。电脑端跑着,人不在电脑前也能全程操作。App 同一套 Flutter 业务代码覆盖 Android 与 iOS(iPhone / iPad,已在 App Store 上架)。

截图

以下为 iOS 模拟器里的演示模式(内置示例数据,不连接任何电脑),界面与真实连接一致。

| 连接 | 首页 | 对话 | |---|---|---| | 连接 | 首页 | 对话 |

| 通知 | 会话列表 | 设置 | 新建会话 | |---|---|---|---| | 通知 | 会话 | 设置 | 新建会话 |

功能

推送与公网访问配置说明(重要):内置端到端加密中继(wss://dsh.claud.ing)自 3.2.6 起默认可用,但电脑只在配对过手机之后才去连它(没配对过手机的电脑不连我们的服务器;不想用可设 relay.enabled: false),局域网直连的地址与口令不变;其余非局域网使用方式(蒲公英 / Tailscale / FRP 内网穿透等)均为按需自配置,没有统一标准——cordis.patch.yml 里的 pushUrls(推送通道)、trustedHosts(公网中继域名)、lanBridge(桌面版 LAN 桥)、approvalMode(审批位置:both 双端 / mobile 手机独占 / desktop 仅桌面,默认 both)等字段请按自己的需求修改,文档(用户指南的安装与安全须知)只给示例与安全边界,不强制任何固定方案。

  • 📱 手机远程操作:发消息/派任务、流式回复、Markdown 渲染、token 用量、微信式无限上翻(滑到顶部自动加载更早 + 回到底部浮钮)
  • ❓ 问询/审批弹窗:agent 思考中途要你拍板(选选项/输入自定义答案)或工具要权限(允许一次/拒绝)时,手机弹卡片——与 PC 端同一待办,任一端回答两端同步消失(v3.1.3 起默认双端呈现,approvalMode 可切手机独占/仅桌面)
  • 🔔 系统通知:agent 完成 / 需要你回答 / 失败 → 手机弹窗(Server酱 / ntfy / Bark 任选;同会话同类型自动聚合);通知页支持单删/批量/清空
  • 💬 会话管理:查看/切换/续接全部会话,标题与 PC 端实时同步,按工作区分组(子目录自动归属最近工作区),归档与 PC 端同源
  • ➕ 新建会话:选 Agent 模式(标准/PTC/极简/创造)+ 选工作目录(跨盘浏览、可新建文件夹)
  • ⚙️ 配置对齐 PC 端:模型、推理强度、权限预设(危险权限需风险确认)、默认 Agent 预设 / 默认权限预设可直接修改(作用于之后新建的会话)
  • 🏢 模型提供商互通:PC 端「设置 → 模型」与手机同一配置通道——37 个内置提供商(anthropic / openai / google / groq 等)手机可见可配(baseURL + API Key 即激活),模型选择器按提供商分组,设置页「模型提供商」可搜索/编辑/探测模型
  • 👀 过程可见性:活动条(思考中 / 正在调用工具实时状态行)+ 可折叠思考面板(默认只显示状态)
  • 🛠️ 会话工具:运行中的后台任务实时卡片(可取消)+ 三页签弹层——任务 / 子代理(查看+中断)/ 目标(查看、创建、暂停、继续、标记完成,与 PC 端 goal 服务同源)
  • 🧍 桌面宠物:Android 悬浮宠物就是首页的那个女孩(动画由角色包渲染);首页角色是一张插画(App 内会轻微浮动并对点击做出反应)。宠物常驻桌面——任务/通知/余额驱动 16 组动作(思考、处理、等待、完成、出错、待机微动作);点头部/身体/尾巴互动,双击摸头,拖动悬空+落地,长按打开迷你面板(运行中会话 / 通知 / 用量与额度 / 余额 / 打开 App);拖到边缘或角落会探头(只露出头和手扒着屏幕边,悬浮窗只有露出的那一块,不挡旁边的触摸),点一下跳出来,完成/等待/出错时也会跳出来提示;随机眨眼;默认约 50dp 高,四档大小与减少动效;App 在前台时自动收起(不与首页角色同屏、不挡按钮);错过的通知也会补提示(气泡/角标/横幅)
  • 🎨 外观:皮肤与图标:四套皮肤(默认 / 深潜夜航 / 海盐汽水 / 鲸落星海,各含明暗两套)——三套角色皮肤下首页换成角色 Hero + 动态背景(气泡/声呐环/星尘月盘的 30fps 上限动画),角色可点头部/身体/尾巴互动、长按开面板;App 图标 8 款(默认 / 深海荧光 / 贝壳徽章 / 月夜潮线 / 奶油贴纸 / 邮票 / 霓虹灯牌 / 单色剪影,「默认」是项目方提供的标志,其余 7 款由代码绘制),用 activity-alias 切换;全部图标与插图由 dsh-mobile-app/tools/brand/build.sh 一键生成,素材清单与重新生成方式见 Part C
  • 💾 体验打磨:Agent 状态 bootstrap 同步(按钮/活动条即时反映 PC 状态)、下拉刷新收集地址(蒲公英/Tailscale 自动进候选)、聊天草稿保留(退出重进自动恢复)、首页改版(角色插画 / 新欢迎语 / 状态胶囊 / 最近会话卡片滑动)、语言切换(中/英)
  • 📶 扫码连接:桌面 dsh 设置页出现「连接移动端设备」二维码 → 手机 App 扫码即连(免输 IP/口令)
  • 🩺 环境诊断:一键查看当前环境各项能力(含问询/审批桥状态),升级/排障一目了然
  • 🧭 连接可解释:连接失败按九类归因(网络不可达 / 超时 / TLS / 不是 DSH / 口令 / 订阅 / 版本 / 5xx / 未知),口令错与订阅过期这类不再无限重试;设置页「连接路径」显示走直连还是加密中继、耗时、RTT、上次退回原因;Wi-Fi ⇄ 蜂窝切换立即重连;「连接诊断包」一键导出(已脱敏)。订阅票据抖动时提示「暂时读不到订阅状态」,不弹付费墙
  • 🧠 长期记忆与助手模式:电脑端 SQLite 记忆库(scope = work / life / shared,默认关闭,只存本机并入库前脱敏),App 内可查看 / 搜索 / 编辑 / 删除 / 手动添加;工作模式两份记忆都用,生活模式按查询条件硬过滤工作记忆;人格卡(JSON,schema: "dsh-mobile.persona/1"):三张原创卡(工作狂 / 生活助理 / 游戏玩家)免费,导入自己写的卡是订阅功能(只检查结构、不审内容、未知字段保留);模型看到的人格就是当前卡片的原文,只换说法不改事实;安静时段(默认 23:30–08:30)内不弹通知;回复按行拆成 1–3 条短气泡并做文本清洗
  • 🧩 插件动作区:第三方插件注册的动作自动出现在移动端(可选)
  • 🖼️ 原生 App:dsh-mobile-app/ 子目录,Flutter 原生实现,与网页端共享同一 API 与设计

安装 App

| 平台 | 说明 | |---|---| | iPhone / iPad | App Store 搜索「DSH Mobile」安装(同一套 Flutter 代码,iPad 有宽屏布局);扫码连接、系统通知 | | Android | Google Play 搜索「DSH Mobile」(公开网络的订阅走 Play 内购,也能自动更新);没有 Google 服务的手机,从官网 https://dsh.claud.ing/ 下载 APK,或用 dsh-mobile-app/ 自行构建。官网 APK 和 Play 版签名不同,换渠道要先卸载再装、并重新配对电脑。扫码连接、系统通知、可选的桌面宠物 |

微信入口(可选):dsh-im

想「在微信里直接给 agent 说话派活」?本插件不内置 IM 机器人(那是另一层协议),官方推荐安装 @xmanrui/dsh-im——一个独立的 DeepSeek Harness 插件,支持微信(个人号扫码)/ 飞书 / 钉钉 / 企业微信 / QQ / Slack / Telegram / Discord / WhatsApp 等 9 种 IM 通道。与本插件互补:

  • dsh-im:微信/IM 对话入口(在微信里直接聊天派活、收到回复)
  • 本插件:手机控制台(进度 / 审批 / 会话管理)+ 干活完成提醒(推送桥,不依赖 App 常驻后台)

装法(电脑端):dsh plugin add @xmanrui/dsh-im → 微信扫码登录 → 完成。干活完成提醒走本插件推送桥(用户指南 §6:企业微信机器人 / Server酱 / Bark 任选)。

架构

手机(原生 App) ──HTTP/SSE──► 电脑上的 dsh 进程(本插件)
                                  │ ctx 服务(agents/sessions/llm/…)
                                  │ /api 桥(与 PC 端 GUI 同一协议)
                                  ▼
                             dsh 内核(会话唯一真源)
  • 会话唯一真源在 PC 端:移动端不存状态,实时读写——天然一致,不存在"同步"
  • 移动端零插件感知:核心功能只依赖 dsh 内核语义;个性化(模型/权限/预设)全部动态读取
  • 桌面端/命令行双形态兼容:同一 profile,插件自动加载

安装(一条命令,推荐)

v3.2.4 起插件自带启用补丁(dsh.bundle.patch):用 DSH 自己的 plugin add 装上就自动启用——不用编辑 cordis.patch.yml、不用自己生成口令、不用手写 LAN 桥。

# web 版(DSH 0.2.x):
npx @deepseek-ai/dsh plugin --profile web add @dsh-mobile/mobile-remote
# 然后照常启动(--no-open = 不自动打开浏览器):
npx @deepseek-ai/dsh web --no-open

启动后终端自动打印手机 App 要填的两项:

mobile-remote ▶ 手机 App 连接信息 / Phone app connection
  电脑地址 Address : http://192.168.1.5:3081
  访问口令 Token   : <自动生成的强口令>
  (口令保存在 $DSH_HOME/mobile-remote/auth-token,默认即 ~/.dsh/mobile-remote/;重启不变)

DSH 的 设置 → 连接移动端设备 里也会自动出现二维码、地址、口令(带复制按钮)。手机 App:设置 → 重新配置连接,填这两项或扫码。

  • 口令:首次启动自动生成并保存,之后不变(手机只需配对一次)。你自己在配置里写了 authToken 就以你的为准,且不会打进日志。
  • LAN 桥:自动判断——只有 DSH 的 web 服务只听回环时才开(dsh web 0.2.1 就是回环);端口和 DSH 自己撞车会自动让到下一个,所以地址常是 :3081。
  • 想装本地打好的包(比如还没发布的改动):npm pack,再 npx @deepseek-ai/dsh plugin --profile web add file:<路径>/dsh-mobile-mobile-remote-<版本>.tgz(这条路径在 DSH 0.2.1-rc.5 上验证过)。
  • 之前手写过 mobile-remote 配置行? 先删掉那一行,否则会重复加载。
  • DSH Desktop:同一个包,--profile desktop——我没有在 Desktop 上测过。
  • 想完全手动控制(固定口令、关桥、改端口),见下面的手动配置。

安装(手动配置,高级)

🤖 让 DSH 的 agent 自动安装:直接告诉 agent「按本仓库 docs/USER-GUIDE.zh-CN.md 安装 @dsh-mobile/mobile-remote 插件」即可(上面那条 plugin add 命令就是它要做的事)。需要与手机 App 精确配对时,把依赖固定到具体版本号(见下面「版本与兼容」)。

方式一:命令行 dsh web(web 版流程)

# 1. 在 profile 声明插件
# 编辑 C:\Users\<你>\.dsh\profiles\web\package.json,dependencies 加:
#   "@dsh-mobile/mobile-remote": "file:<本插件路径>"

# 2. 安装依赖
cd C:\Users\<你>\.dsh\profiles\web
corepack pnpm install

# 3. 启用插件(cordis.patch.yml,见下方配置节)后启动
npx @deepseek-ai/dsh web

方式二:DeepSeek Harness 桌面端(当前主线)

安装插件后重启 DSH Desktop 即可(desktop profile 自动加载;移动端经插件 LAN 桥,默认 0.0.0.0:3080,见「LAN 桥」节与用户指南 §3)。

LAN 桥(桌面版必开,手机局域网直连)

# cordis.patch.yml(mobile-remote 行 config 内)
        lanBridge:
          enabled: true
          port: 3080
          host: 0.0.0.0

⚠️ 不要覆盖 webserver 行:桌面版(0.1.1-rc.2)webserver 强制回环(覆盖 host 直接报错),移动端用上方 LAN 桥;DSH 0.1.x 的 web 版默认是 0.0.0.0:3080,无需覆盖;0.2.1 起 dsh web 也只听回环,插件会自动开 LAN 桥(端口常是 3081)——仅当你想改端口时才写覆盖行,且必须写全必填字段(host + port),否则启动报 $port missing required value(--dump-config/smoke 测不出来,只有真启动才暴露)。

# 仅 web 版需要改端口时适用:覆盖 webserver 行必须写全字段!
- id: webserver
  config:
    host: 0.0.0.0
    port: 3080

配置(cordis.patch.yml)

- insert:
    - id: mobile-remote
      name: '@dsh-mobile/mobile-remote'
      config:
        path: /m
        authToken: <访问口令;留空时只有在服务仅本机可达时才关闭认证,否则自动生成口令>
        pushUrls: []   # 见下方推送配置
        # pushContent: standard  # 默认 minimal:推送只含事件类型+会话短码(通用 webhook 另带完整会话 ID 和时间);standard 才含标题/详情
        # rateLimit: { maxFailures: 10, windowMs: 60000, blockMs: 60000 }  # 登录失败限流
        # trustedHosts: ["<内网穿透中继地址>"]  # 仅 frp 等中继方案需要,见 docs/USER-GUIDE.zh-CN.md §4.2

桌面设置页入口(客户端模块)

插件启用后,dsh 设置页会出现**「连接移动端设备」**一页:显示连接二维码(含地址+口令)、电脑地址列表与口令(可复制)。手机 App 扫此二维码自动连接。该页数据仅电脑本机可读取(/m/api/qr-config 仅允许 loopback 访问)。

推送配置(可选,3 分钟)

不配置则无系统推送,其余功能不受影响。三种任选,也可同时配置多个(事件会推送到全部通道)。同会话同类型 60 秒内合并(pushCooldownMs 可调),通知中心按会话聚合。 隐私(v2.6 起):推送默认只含「事件类型 + 会话短码」,会话标题/错误详情等核心内容不经过第三方通道;通用 webhook(format: generic)另外会收到完整的会话 ID 和时间戳;确需完整内容(信任通道时)设 pushContent: standard。

Server酱(微信推送,最省事)

  1. 手机微信扫码打开 https://sc3.ft07.com/sendkey → 复制 API URL(形如 https://<uid>.push.ft07.com/send/<key>.send,免备案;老 Turbo 接口 sctapi.ftqq.com 已不可用,2026-08 实测)
  2. 配置:
pushUrls:
  - name: 微信
    url: https://<uid>.push.ft07.com/send/<sendkey>.send
    format: serverchan

⚠️ Server酱³ 免费版每天限 5 条(AUTH 40001),需更多条数请升级。

ntfy(安卓系统通知栏,原生弹窗)

  1. 手机安装 ntfy App(Google Play / F-Droid / 酷安)
  2. 生成随机主题并订阅:dsh-<随机串>(例如 dsh-a1b2c3d4e5f6)
  3. 配置:
pushUrls:
  - name: 系统通知
    url: https://ntfy.sh/<你的主题>
    format: ntfy

Bark(iPhone)

  1. iPhone 安装 Bark App → 复制推送 key
  2. 配置:
pushUrls:
  - name: Bark
    url: https://api.day.app/<你的key>
    format: bark

验证

配置后重启,让 agent 跑一个任务——手机收到"✅ 任务完成"通知即成功。

手机使用

  1. 下载 App:iPhone / iPad 在 App Store 搜索「DSH Mobile」。Android 首选 Google Play(公开网络的订阅走 Play 内购,Play 版也能自动更新);没有 Google 服务的手机,从官网 https://dsh.claud.ing/ 下载 APK,或按 dsh-mobile-app/README 自行构建。官网 APK 和 Play 版的签名不同,不能互相升级:从一个渠道换到另一个,要先卸载再装,并重新配对电脑
  2. 与电脑同一 WiFi;人不在家:用蒲公英组网等虚拟组网方案(已实测,见用户指南 §4,App 自动切换地址),或用公开网络(端到端加密中继)——插件默认允许使用(3.2.6 起),指向已部署的 wss://dsh.claud.ing(也可自建);在桌面「远程访问」里扫码配对一台手机之后,电脑才开始连中继。公开网络需要登录并订阅(App Store / Google Play 内购),局域网直连始终免费;手机访问中继必须带订阅票据(服务端 2026-11-17 起强制)。见用户指南 §5
  3. 打开 App:第一次进入连接页会弹出「怎么连接你的电脑」引导(六步:下载安装电脑版 DeepSeek Harness 并登录 → 更多 → 浏览更多插件 → 添加插件 → 输入插件下载地址 @dsh-mobile/mobile-remote(可复制)→ 彻底重新启动 → 点左下角的用户名打开设置页 → 在「连接移动端设备」页面扫码;之后点连接页的「怎么连接?」或设置页的「怎么连接电脑?」可再看)。然后「扫码连接」对准桌面 dsh 设置页「连接移动端设备」的二维码(或手动输地址+口令;手机和电脑需在同一 Wi-Fi)。不在同一 Wi-Fi:在同一个设置页下方的「远程访问」点「生成配对二维码」(或「复制配对链接」),回到 App 扫这个配对码或点「粘贴配对链接」——这条路要登录并订阅公开网络,且只需配对一次,之后异地会自动走中继
  4. 首页直接发消息派活;对话页实时流式回复;通知页看完成/提问/失败

⚠️ 注意事项

安全

  • 访问口令(authToken)是唯一凭据:每台电脑用不同口令,扫码二维码含口令,请勿截屏转发;怀疑泄露立即更换(改配置重启后二维码自动更新,旧码作废)。
  • 仅限局域网/可信内网使用;禁止将 3080 端口映射/穿透到公网(详见用户指南 · 安全须知)。要在外网使用,请用虚拟组网或加密中继(电脑只向外连接,不开放端口),不要裸映射。
  • /m/api/qr-config(桌面二维码数据)仅允许电脑本机读取。

使用

  • 会话数据实时存于 PC 端;删除插件/断网不影响已存会话,重装后自动恢复。
  • agent 处理上一轮时继续发消息会排队(dsh 机制),移动端会提示"正在处理上一轮"。
  • 新建会话选的工作目录不在任何已注册工作区时,PC 端按"未分组"显示;在工作区子目录下会自动归属。

已知限制

  • 移动端默认以普通模式展示对话时间线与工具活动摘要;可切换调试模式查看原始参数/结果、事件元数据与未知可见事件。图片/Markdown 结果支持预览,文件结果可下载到应用私有目录(保存后提示完整路径,系统相册/下载列表不收录);旧服务端未保存的详情会明确显示不可用。协议/运行时元数据(会话标题、模型选择等)只出现在调试模式;系统提示词、请求快照与压缩摘要不呈现。
  • 长任务期间建议等待上一轮完成再发新消息,避免排队混乱。
  • 归档(archive)会话与 PC 端同源显示,行为一致。
  • 问询/审批弹窗链路随内核版本走对应机制:0.1.2-rc.1+ 为 Agent 作用域瀑布 + 插件 answerer(both 双端呈现走内核 $events 远程事件通道,与 PC 端 GUI 同通道);更早内核走 apiProxy 帧桥(私有协议,未来大版本可能断桥,插件干净降级、随版本更新恢复)。手机不弹时先跑环境诊断看 approvalMode/remoteEvents(见 FAQ「问询/审批弹窗类」)。
  • 通知删除只清记录不"静音":同会话同类新事件仍会产生新通知。
  • App 构建签名:正式分发须自建 keystore(换签名 = 换应用,用户需重装重扫);详见 Part 06 §8.2 与 Part 09 §6。
  • 与 dsh-web 的移动端远程(@linxin666/dsh-remote-web-ui)同装会冲突:对方把手机页面/API 整体写死在 /m 前缀(不可配置),本插件默认也挂在 /m——两者抢同一路由前缀可能导致异常/崩溃。共存方法:给本插件配 path: /mr(任意非 /m 单段)并重启 DSH,手机 App 自动适配无需重装(详见 FAQ「设备/兼容类」)。

环境诊断

设置页 → 环境诊断:检测服务(agents/sessions/llm/权限/预设/工作区)与端点实测,✅/❌ 一目了然,含检测时间。升级 dsh 后先跑一次诊断,红了就是需要适配的地方。

兼容性

  • dsh 版本:当前在 DSH 0.2.x(npm 最新是 0.2.2-rc.5)上适配;package.json 的 engines.dsh 声明 >=0.1.0-rc.6 <0.4.0-0,engines.node 是 >=24.9.0(与 DSH 自己的要求一致)。更早的基线:v3.1.2/v3.1.3 为 0.1.2-rc.1 服务包 = DSH Desktop v2.0.5(approval/request 瀑布 answerer、$events 远程事件双端审批、RPC 网关直通、桌面浏览器门禁适配);v3.0.0–v3.1.1 为 0.1.1-rc.2 = DSH Desktop v2.0.2(commands.execute 四参、桌面版强制回环 → LAN 桥)。更低版本按功能降级,服务依赖与降级行为详见 Part 09
  • 平台(App):iPhone / iPad(App Store,iOS 15+);Android 7.0+ 全品牌(渲染 Impeller 自动回退;实测小米 17 Pro Max)。iOS 与 Android 的功能差异见 Part 09 §4
  • 平台(桌面):Windows/macOS;命令行 dsh web 与桌面端均支持(纯 headless 形态插件静默无操作)
  • 个性化:模型/权限/Agent 预设动态读取 PC 端真实目录,用户自定义自动出现;自定义动作经 mobileActions 注册自动上架
  • 深度魔改 web profile(禁用标准服务):对应功能自动降级,不崩溃——诊断页可查每个服务状态

版本与兼容

  • 版本号统一:App 版本和插件版本用同一条版本线(目前插件 3.3.0,App 3.2.7,下一版 App 跟上)。插件发布在 npm(@dsh-mobile/mobile-remote),手机 App 在 App Store 和官网 https://dsh.claud.ing/。
  • 版本差矩阵(一句话:谁旧谁吃亏,但都不崩):

| 组合 | 结果 | |---|---| | 同版本 | ✅ 完美 | | 插件新 + App 旧 | ✅ 老功能正常,新功能不可见(协议只加不删,未知帧一律忽略) | | App 新 + 插件旧 | ✅ 老功能正常,新功能提示升级 | | 破坏性变更 | ❌ 禁止——已发布接口只加字段(Part 08 约定) |

  • 固定插件版本:在 profile 里把 @dsh-mobile/mobile-remote 写成具体版本号(不写版本取最新)。
  • 实际配对可在 App 设置 → 关于 → 版本(App vX · 插件 vY)或环境诊断页对照。

文档

  • README.md — 项目总览:功能、安装、配置、注意事项
  • FAQ.md — 常见问题速查(连接/使用/安全/弹窗/设备)
  • CHANGELOG.md — 版本历史
  • CONTRIBUTING.md — 贡献指南
  • docs/USER-GUIDE.zh-CN.md — 中文用户指南:安装与启用、局域网直连、外出访问与加密中继、推送、App 使用手册、安全须知
  • docs/CONSOLIDATED-DOCUMENTATION.en.md — 英文文档合集(只在仓库里,不随 npm 包发布):方案与进度(Part 00)、需求 / 架构 / API / 安全 / 测试 / 部署 / 手册(Part 01–07)、二次开发(Part 08)、兼容性(Part 09)、加密中继(Part 11)、商店上架材料(Part A–I)
  • docs/PRIVACY-POLICY.md / docs/PRIVACY-POLICY.en.md、docs/TERMS-OF-SERVICE.md / docs/TERMS-OF-SERVICE.en.md、docs/SUPPORT.md — 隐私政策、服务条款、支持页

开发

lib/index.js    服务端装配:路由、认证、事件桥、catalog、会话、通知、动作(纯逻辑已拆到下面的模块)
lib/*.js        从 index.js 拆出的模块:config / push / rate-limit / http-util / rpc-adapter / session-list /
                timeline / turn-outline / host-compat / api-helpers / account-usage-query /
                notify-copy(三段式汇报与通知措辞、安静时段)
lib/memory/     长期记忆库(node:sqlite,scope 硬过滤 + BM25 + 入库脱敏)、/api/memory 路由、
                对话自动写入(extract.js,一轮结束时按规则提取用户明确陈述的事实)与上下文注入(context.js)
lib/relay/      端到端加密中继(电脑端连接器 + 手机端参考实现;fingerprint.js 是配对指纹的权威定义)
lib/client.js   桌面 GUI 客户端模块(设置页「连接移动端设备」)
relay/          可独立部署的中继服务(不随插件发布)
dsh-mobile-app/ Flutter 原生 App(扫码连接 + 全部移动界面;对话页按功能拆在 lib/screens/chat/)
tools/          联调脚本(e2e-check / timeline-contract-check / verify-no-model-session);其余校验都在 test/
prototype/      界面原型(v7 定稿,设计参考)

许可

MIT