jiay98528-dev/dsh-plugin-weaknet-adaptor

✨ Features / 特性

🚀 Install / 安装

npm install dsh-plugin-weaknet-adaptor

Add to your composition (cordis.yml), e.g. in the DSH profile you run:

plugins:
  - name: dsh-plugin-weaknet-adaptor

The Host half activates automatically; the browser half (settings page + status dock) is picked up through the package’s dsh.client declaration and served by client-modules — no extra wiring needed. Peer dependencies (@deepseek-ai/*, cordis) are installed automatically by npm.

💡 为什么用正式包而不是动态插件？ 动态插件（会话内 cordis_define 创建）只存在于进程内存，进程崩溃或重启后即丢失；本包由 cordis.yml 静态加载，重启后依然生效，真正”安装即用”。

💡 Why a real package instead of a dynamic plugin? Dynamic plugins live only in process memory and vanish on crash/restart; this package is loaded statically from cordis.yml and survives restarts.

⚙️ Configuration / 参数配置

All parameters can be changed live from Settings → Weak Network（设置 → 弱网适配）. Changes persist best-effort to <workspaceRoot>/.dsh/weaknet-params.json.

🧠 How it works / 工作原理

模型请求
   │
   ▼
llm/stream 瀑布（本插件 prepend 挂载）
   │
   ├─ 缓存命中？ ──► 本地重放（零 token，不调 next()）
   │
   ├─ online 模式：流式转发 + 收集缓存 + 观察失败（网络类失败 → degrade）
   │
   └─ degraded 模式：全缓冲 → finish 判定
        ├─ 成功 → 写缓存 + 被动恢复 online + 整体交付
        └─ 网络类失败 → 指数退避 sleep（可被取消中断）→ 重试（≤ maxAttempts）
                               │
                               ▼
                   心跳任务（仅 degraded 时运行）
                   探测 probeUrl → 失败：间隔 ×factor（封顶 10 分钟）
                                 → 连续成功 ≥successThreshold：恢复 online

• 重试为何放在 llm/stream 而不是 agent/request-error？ 宿主 llm-retry 默认已接管 agent/request-error（DEFAULT_RETRYABLE_CODES 覆盖 TRANSPORT/TIMEOUT 等），后注册的监听器会被短路；llm/stream 是每个模型请求必经的瀑布，可确定性接管。agent/request-error 仅作降级观察。
• 缓存指纹：provider + model + reasoningEffort + temperature + maxTokens + stop + system + tools + messages + purpose（键排序规范序列化）。只有逐字节一致的请求才命中。
• 不做什么：不做工具集裁剪（动态插件沙箱白名单限制不适用于本包，但裁剪工具集会改变模型能力面，保持克制）；不做流中断”前缀续传”（LLM API 不支持续传，重试即重新生成）。
• RPC：设置页通过 @Remote（dsh-typert-protocol）的 SRC markers 机制调用 weaknet/* 命名空间（getParamDefs / getParams / setParams / getStatus / resetStats），无需手写 typert 生成物。

🧪 Quick verification / 快速验证

1. 打开 设置 → 弱网适配：状态卡 + 7 组参数（每项有双语说明与「▸ 预期效果」）。
2. 把 心跳探测地址 改为 http://127.0.0.1:1/x 并保存 → composer 底部信息栏依次变黄（弱网）→ 红（网络中断，连续 3 次探测失败），”下次探测”秒数随指数退避逐次拉长（封顶 10 分钟）；改回默认 → 变绿自动恢复。
3. 切换界面语言（中/英）：设置页文案即时跟随。

🛠 Development / 开发

git clone https://github.com/<your-user>/dsh-plugin-weaknet-adaptor.git
cd dsh-plugin-weaknet-adaptor
npm install
npm run check   # node --check lib/index.js && node --check lib/client.js
npm pack        # build the tarball

Layout:

lib/index.js        Host half (cordis plugin + weaknet Remote service)
lib/client.js       Browser half (ModuleLoader bundle: settings page + status dock)
lib/types/index.d.ts  Type declarations

📜 Changelog / 更新日志

See CHANGELOG.md — 1.0.3 (WiFi icon + settings diagnostics), 1.0.2 (critical WebUI-hang fix), 1.0.1 (dsh plugin add support), 1.0.0 (first release).

📄 License / 许可证

MIT — see LICENSE.