@hyprnos/dsh-remote-plugin 0.0.0-stage → 0.8.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (211) hide show
  1. package/README.en.md +61 -0
  2. package/README.md +60 -2
  3. package/apk/dsh-remote.apk +0 -0
  4. package/approval-summary.mjs +115 -0
  5. package/client.js +197 -0
  6. package/cordis.patch.yml +5 -0
  7. package/doctor-skill.mjs +99 -0
  8. package/doctor-target.mjs +24 -0
  9. package/file-delivery.mjs +84 -0
  10. package/gateway-stats.cjs +501 -0
  11. package/gateway.cjs +8451 -0
  12. package/index.mjs +1788 -0
  13. package/insights.mjs +111 -0
  14. package/market.mjs +86 -0
  15. package/package.json +73 -4
  16. package/peak-reminders.mjs +50 -0
  17. package/plugin-center.mjs +777 -0
  18. package/plugin-transaction.mjs +300 -0
  19. package/public/activity.js +188 -0
  20. package/public/admin.html +820 -0
  21. package/public/admin.js +1167 -0
  22. package/public/announcement-forms.js +89 -0
  23. package/public/announcements.json +464 -0
  24. package/public/app.js +8826 -0
  25. package/public/approval-records.js +301 -0
  26. package/public/approval-summary.js +78 -0
  27. package/public/build.json +5 -0
  28. package/public/cache-upgrade.js +51 -0
  29. package/public/chat-copy.js +59 -0
  30. package/public/chat-files.js +87 -0
  31. package/public/desktop/desktop.css +816 -0
  32. package/public/desktop/desktop.html +871 -0
  33. package/public/desktop/desktop.js +4548 -0
  34. package/public/desktop/i18n.js +85 -0
  35. package/public/diagnostics.js +203 -0
  36. package/public/doctor-entry.js +94 -0
  37. package/public/doctor.css +205 -0
  38. package/public/doctor.js +769 -0
  39. package/public/donate.png +0 -0
  40. package/public/e2ee-transport.js +219 -0
  41. package/public/extensions.css +109 -0
  42. package/public/extensions.js +215 -0
  43. package/public/file-inbox.css +66 -0
  44. package/public/file-inbox.js +289 -0
  45. package/public/genui.css +8 -0
  46. package/public/genui.js +254 -0
  47. package/public/history.js +304 -0
  48. package/public/i18n.js +57 -0
  49. package/public/icon.svg +12 -0
  50. package/public/image-cache.js +141 -0
  51. package/public/image-preview.js +290 -0
  52. package/public/index.html +1568 -0
  53. package/public/insights.css +28 -0
  54. package/public/insights.js +290 -0
  55. package/public/jsqr.min.js +10104 -0
  56. package/public/lan-discovery.js +94 -0
  57. package/public/link-check.js +109 -0
  58. package/public/manifest.webmanifest +16 -0
  59. package/public/md.js +333 -0
  60. package/public/morphicons-init.js +41 -0
  61. package/public/motion.js +557 -0
  62. package/public/network.js +100 -0
  63. package/public/onboarding.css +36 -0
  64. package/public/onboarding.js +253 -0
  65. package/public/operations.js +141 -0
  66. package/public/permission-presets.js +159 -0
  67. package/public/plugin-center.css +120 -0
  68. package/public/plugin-center.js +666 -0
  69. package/public/plugin-icon.svg +5 -0
  70. package/public/plugin.html +68 -0
  71. package/public/plugin.js +211 -0
  72. package/public/qrcode.min.js +2297 -0
  73. package/public/relay-autopair.js +251 -0
  74. package/public/relay-devices.js +80 -0
  75. package/public/relay-settings.css +24 -0
  76. package/public/relay-settings.js +194 -0
  77. package/public/remote-state.js +27 -0
  78. package/public/remote-ui.css +148 -0
  79. package/public/remote-ui.js +243 -0
  80. package/public/session-deck.css +79 -0
  81. package/public/session-deck.js +180 -0
  82. package/public/session-presets.js +47 -0
  83. package/public/setup.css +18 -0
  84. package/public/setup.js +213 -0
  85. package/public/sha256.js +119 -0
  86. package/public/skills.css +81 -0
  87. package/public/skills.js +202 -0
  88. package/public/skins/blue-fish/DESIGN.md +24 -0
  89. package/public/skins/blue-fish/face.png +0 -0
  90. package/public/skins/blue-fish/icon-blush.png +0 -0
  91. package/public/skins/blue-fish/icon-sleep.png +0 -0
  92. package/public/skins/blue-fish/icon-smile.png +0 -0
  93. package/public/skins/blue-fish/icon-star.png +0 -0
  94. package/public/skins/blue-fish/icon-wink.png +0 -0
  95. package/public/skins/blue-fish/icon.png +0 -0
  96. package/public/skins/blue-fish/mascot.png +0 -0
  97. package/public/skins/blue-fish/pattern.png +0 -0
  98. package/public/skins/blue-fish/preview.html +12 -0
  99. package/public/skins/blue-fish/skin.css +122 -0
  100. package/public/skins/blue-fish/sparkles.svg +18 -0
  101. package/public/skins/bocchi/DESIGN.md +99 -0
  102. package/public/skins/bocchi/face.png +0 -0
  103. package/public/skins/bocchi/grain.png +0 -0
  104. package/public/skins/bocchi/icon-blush.png +0 -0
  105. package/public/skins/bocchi/icon-sleep.png +0 -0
  106. package/public/skins/bocchi/icon-smile.png +0 -0
  107. package/public/skins/bocchi/icon-star.png +0 -0
  108. package/public/skins/bocchi/icon-wink.png +0 -0
  109. package/public/skins/bocchi/icon.png +0 -0
  110. package/public/skins/bocchi/pattern-soft.png +0 -0
  111. package/public/skins/bocchi/pattern.png +0 -0
  112. package/public/skins/bocchi/preview.html +55 -0
  113. package/public/skins/bocchi/skin.css +233 -0
  114. package/public/skins/bocchi/stage-bg.png +0 -0
  115. package/public/skins/bocchi/stage-soft.png +0 -0
  116. package/public/skins/bocchi/stand.png +0 -0
  117. package/public/skins/bocchi/sticker-guitar.png +0 -0
  118. package/public/skins/kessoku/DESIGN.md +38 -0
  119. package/public/skins/kessoku/grain.png +0 -0
  120. package/public/skins/kessoku/skin.css +212 -0
  121. package/public/skins/kita/SOURCES.json +51 -0
  122. package/public/skins/kita/face.png +0 -0
  123. package/public/skins/kita/icon-live.png +0 -0
  124. package/public/skins/kita/icon-reddress.png +0 -0
  125. package/public/skins/kita/icon-seifuku.png +0 -0
  126. package/public/skins/kita/pattern.png +0 -0
  127. package/public/skins/kita/preview.html +56 -0
  128. package/public/skins/kita/skin.css +26 -0
  129. package/public/skins/kita/stand.png +0 -0
  130. package/public/skins/kita/sticker-live.png +0 -0
  131. package/public/skins/nijika/SOURCES.json +51 -0
  132. package/public/skins/nijika/face.png +0 -0
  133. package/public/skins/nijika/icon-live.png +0 -0
  134. package/public/skins/nijika/icon-reddress.png +0 -0
  135. package/public/skins/nijika/icon-seifuku.png +0 -0
  136. package/public/skins/nijika/pattern.png +0 -0
  137. package/public/skins/nijika/preview.html +56 -0
  138. package/public/skins/nijika/skin.css +25 -0
  139. package/public/skins/nijika/stand.png +0 -0
  140. package/public/skins/nijika/sticker-live.png +0 -0
  141. package/public/skins/penguin/DESIGN.md +33 -0
  142. package/public/skins/penguin/SOURCES.json +22 -0
  143. package/public/skins/penguin/aic-blueprint.svg +24 -0
  144. package/public/skins/penguin/endfield-triangles.svg +4 -0
  145. package/public/skins/penguin/face.png +0 -0
  146. package/public/skins/penguin/icon-blush.png +0 -0
  147. package/public/skins/penguin/icon-dizzy.png +0 -0
  148. package/public/skins/penguin/icon-laugh.png +0 -0
  149. package/public/skins/penguin/icon-sleep.png +0 -0
  150. package/public/skins/penguin/icon-smile.png +0 -0
  151. package/public/skins/penguin/icon-star.png +0 -0
  152. package/public/skins/penguin/icon-wink.png +0 -0
  153. package/public/skins/penguin/icon.png +0 -0
  154. package/public/skins/penguin/mascot.png +0 -0
  155. package/public/skins/penguin/pattern-night.png +0 -0
  156. package/public/skins/penguin/pattern.png +0 -0
  157. package/public/skins/penguin/preview.html +12 -0
  158. package/public/skins/penguin/skin.css +212 -0
  159. package/public/skins/ryo/SOURCES.json +51 -0
  160. package/public/skins/ryo/face.png +0 -0
  161. package/public/skins/ryo/icon-live.png +0 -0
  162. package/public/skins/ryo/icon-reddress.png +0 -0
  163. package/public/skins/ryo/icon-seifuku.png +0 -0
  164. package/public/skins/ryo/pattern.png +0 -0
  165. package/public/skins/ryo/preview.html +56 -0
  166. package/public/skins/ryo/skin.css +25 -0
  167. package/public/skins/ryo/stand.png +0 -0
  168. package/public/skins/ryo/sticker-live.png +0 -0
  169. package/public/sponsor-entry.js +21 -0
  170. package/public/styles.css +1526 -0
  171. package/public/subagents.css +61 -0
  172. package/public/subagents.js +275 -0
  173. package/public/task-board.js +109 -0
  174. package/public/teams.js +98 -0
  175. package/public/theme-picker.css +58 -0
  176. package/public/theme-vars.css +1044 -0
  177. package/public/theme.js +166 -0
  178. package/public/transcribe-core.js +74 -0
  179. package/public/turn-results.js +121 -0
  180. package/public/update.json +49 -0
  181. package/public/vendor/gsap/NOTICE.md +10 -0
  182. package/public/vendor/gsap/gsap.min.js +11 -0
  183. package/public/vendor/morphicons/LICENSE +21 -0
  184. package/public/vendor/morphicons/README.md +10 -0
  185. package/public/vendor/morphicons/controller-CXZuwJ_M.js +152 -0
  186. package/public/vendor/morphicons/dom.js +206 -0
  187. package/public/vendor/morphicons/element.js +261 -0
  188. package/public/vendor/morphicons/normalize-CYnN3Npw.js +540 -0
  189. package/public/vendor/morphicons/spring-CFHloqPP.js +623 -0
  190. package/public/version.json +3 -0
  191. package/public/voice-input.js +1151 -0
  192. package/public/workflow.css +365 -0
  193. package/public/workflow.js +419 -0
  194. package/session-file.mjs +39 -0
  195. package/skills/dsh-remote-doctor/SKILL.md +186 -0
  196. package/skills/dsh-remote-doctor/references/wiki/README.md +40 -0
  197. package/skills/dsh-remote-doctor/references/wiki/ai-guide.md +61 -0
  198. package/skills/dsh-remote-doctor/references/wiki/connection.md +76 -0
  199. package/skills/dsh-remote-doctor/references/wiki/errors.md +26 -0
  200. package/skills/dsh-remote-doctor/references/wiki/evidence.md +44 -0
  201. package/skills/dsh-remote-doctor/references/wiki/files.md +31 -0
  202. package/skills/dsh-remote-doctor/references/wiki/maintenance.md +30 -0
  203. package/skills/dsh-remote-doctor/references/wiki/notifications.md +33 -0
  204. package/skills/dsh-remote-doctor/references/wiki/operations.md +32 -0
  205. package/skills/dsh-remote-doctor/references/wiki/plugins.md +90 -0
  206. package/skills/dsh-remote-doctor/references/wiki/sessions.md +45 -0
  207. package/skills/dsh-remote-doctor/references/wiki/sources.md +27 -0
  208. package/skills.mjs +53 -0
  209. package/speech-whisper.mjs +705 -0
  210. package/task-board.mjs +57 -0
  211. package/teams.mjs +58 -0
@@ -0,0 +1,90 @@
1
+ # 插件管理、实验性插件与升级
2
+
3
+ [首页](README.md) · [日常操作](operations.md)
4
+
5
+ 操作入口为“更多 → 主机插件”,操作目标始终是当前主机确认的 profile。市场页面使用主机的官方 `pluginMarket` 索引;列表或搜索结果不是安全、兼容性或安装成功的背书。
6
+
7
+ ## KB-PLUGIN-01:已安装插件没显示、实验性插件找不到
8
+
9
+ **先看:** 当前连接主机/profile、名称与状态筛选,以及“内置插件”页;旧版可能把主机提供的实验性条目归在内置列表。
10
+
11
+ **当前源码行为:** 官方实验性条目在“已安装 → 实验性插件(数量)”中,默认收起。展开后显示,刷新/筛选保留展开状态,重新进入插件页恢复收起。这个改动在本库基线中尚未公开发布;用户当前旧包不一定有此行为。
12
+
13
+ **判断:** “已安装”“配置启用”“运行中”分别来自依赖/配置与运行快照。实验性、主机提供或核心包不等于 Remote 可管理的第三方依赖。
14
+
15
+ **验收:** 正确 profile 的条目可找到,名称/状态吻合;主机维护的包保持只读,不因显示出来就获得卸载、更新或启停权限。
16
+
17
+ ## KB-PLUGIN-02:插件中心只读,无法启停或更新
18
+
19
+ **先看:** 是否能确认 profile、对应 DSH CLI/桌面 carrier、实际运行时;条目是否核心包、主机提供或 Remote 本身。
20
+
21
+ **判断:** 无法验证管理入口时只读是保护行为。`@deepseek-ai/*` 核心包和非 profile 依赖不能按普通第三方包管理;Remote 自身只提供明确确认的精确版本更新。
22
+
23
+ **下一步:** 在主机官方管理入口确认版本与安装完整性。不要为了显示开关而强行设置 managed,也不要退回 PATH 中另一个全局 CLI。
24
+
25
+ **验收:** 管理目标可验证,正常第三方条目有恰当动作;受保护条目仍由主机维护。配置启停完成后通常还需重启 DSH,不能称为热生效。
26
+
27
+ **适配诊断(当前未发布源码):** 卡片区分配置、运行状态、待重启和实际读取证据。运行中但尚未打开页面时显示“接口待读取验证”;只有用户主动读取成功才显示成功。接口不兼容、缺失、认证拒绝、失败或超时应分别处理。证据仅关联当前主机/令牌/版本,不代表所有数据和所有会话都可读取;列表本身不查询余额、技能正文或任务快照。
28
+
29
+ ## KB-PLUGIN-03:更新卡住、任务锁或 pnpm 发布时间限制
30
+
31
+ **先看:** 操作记录中的目标包/版本、阶段、最后输出、错误与任务归属。阶段包括预检、备份、快照、CLI、核验和完成;关闭客户端不取消主机任务。
32
+
33
+ | 证据 | 意味着什么 | 下一步 |
34
+ | --- | --- | --- |
35
+ | `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | 发布时间策略阻止;可能是锁文件中另一个包 | 指明实际阻塞包、精确版本和规则;不要自动清锁或降低全局策略 |
36
+ | Windows `EPERM` rename | 文件占用/权限等,需要查操作对象与实例 | 保留备份和日志;不能宣称自动回滚,不能盲目重试安装 |
37
+ | 快照路径越界 | 快照安全检查失败,不等于下载失败 | 核对链接是否属于同 profile 的 local-plugins;不放开外部路径边界 |
38
+ | worker/CLI 仍活着 | 任务可能仍执行或静默等待 | 不删任务锁,不杀所有 node |
39
+ | 身份/权限查询失败 | 不知道是否有活进程 | 保留锁,记录权限限制;不能当作进程已退出 |
40
+
41
+ **恢复:** 自动死任务回收会核对已知进程;旧锁人工恢复仍要确认没有安装进程。还原是单独的、需要用户授权的动作,会核验指纹/版本,避免覆盖失败后的新修改。
42
+
43
+ **验收:** 任务进入明确终态,实际包版本与配置核验一致,必要时重启并读回运行版本。CLI 退出 0 或 HTTP 200 不单独证明更新成功。
44
+
45
+ ## KB-PLUGIN-04:安装、精确更新与还原的操作顺序
46
+
47
+ 1. 确认主机/profile、插件包名、精确版本与当前任务为空闲;读取插件要求和兼容状态。
48
+ 2. 发起预检,查看将修改的依赖、发布时间限制与恢复范围;用户确认后才执行写操作。
49
+ 3. 记录任务 ID,等待终态,读取实际安装版本和待重启状态。失联时先查原任务,不重新创建安装。
50
+ 4. 如失败,保存错误阶段;需要恢复时审阅“恢复更新前状态”的内容与校验结果,再执行。
51
+ 5. 更新 Remote 本体后,先确认安装任务完成,再重启 DSH 加载新插件。新插件会检查网关版本/上游,并通过已有令牌认证关闭旧网关、拉起新网关;随后读回运行版本与连接状态,不凭升级文件推断旧进程已获得修复。
52
+
53
+ **旧网关升级卡住:** 早期 0.7.x 的精简探活只有 `liveness.pid`。旧插件可能将它误判为未运行,随后只报告端口占用;当前工作区已兼容,尚未公开发布。不要仅因此要求用户更换端口。令牌不匹配时应保留旧服务、报告认证问题;Windows 旧进程占用包目录则按主机维护流程处理。已做 Windows 隔离宿主/网关/换包/恢复模拟及本地 registry 的真实 pnpm 自更新验证;这不代替报告者 macOS 或真实 Desktop ASAR 验收。详细记录位于源码仓库 `docs/remote-self-update-verification.md`。
54
+
55
+ 普通用户优先使用管理页流程。`pnpm remove/add` 本地 tgz 替换、特殊安装脚本或额外凭据配置只在已授权的主机维护中处理;不要把命令模板直接作用于用户真实 profile。
56
+
57
+ ## KB-PLUGIN-05:任务看板、费用或团队数据显示不完整
58
+
59
+ **任务看板:** 开发源码适配 `@linxin666/dsh-client-ui-task-board` 的只读 `taskBoard.snapshot()`、schema 6/7(0.4.8/0.4.13);已发布 Remote 0.8.3 只支持 schema 6。先确认插件已启用且运行,再在其卡片打开看板并选已注册工作区。只展示该工作区的任务;未绑定、其他工作区、隐藏任务不展示,归档需勾选。最多 200 条,活跃与最近任务优先。新 schema 的电源控制、外部 provider 凭据及卡片默认提示不转发;未知后续 schema 仍明确返回不兼容,不自行读取账本文件。
60
+
61
+ **执行与验收:** 看板列是任务状态,最近执行是执行记录,验收是另一个结果,三者不能互相替代。外部报告和不属于主机登记工作区的执行会话不提供跳转。计划时间使用规则/主机时区;没有下次时间保持未知。
62
+
63
+ **费用:** 自定义渠道余额和网关额度遵守主机启用/隐藏开关。不同币种和积分不能相加;未知、失败、缓存数据不等于余额为零。部分账户失败时仍可显示其他有效账户;保留供应商查询时间,不把界面刷新时间当作供应商刷新。设置与凭据仍由费用插件拥有。
64
+
65
+ **团队:** 分别查看计划审查、交付阻断和可展开警告。只有插件同时确认可交付且交付检查通过,才称可交付。等待审查反馈不能当作执行卡死,警告也不能直接当作验收失败。
66
+
67
+ **验收:** 对应主机/工作区/币种/时间和状态一致,切换工作区后不残留旧数据,刷新失败明确保留旧结果,返回插件列表能查看适配诊断。详细源码/模拟证据位于仓库 `docs/plugin-adaptation-2026-10-23.md`;这些功能尚未公开分发。
68
+
69
+ ## KB-PLUGIN-06:Windows 上 DSH 更新失败 / 被插件网关占用
70
+
71
+ **先看:** 安装是否真的执行过(安装目录当天是否有写入)、`resources\app.asar` 与卸载登记项版本是否更新,以及安装目录内的 `DeepSeek Harness.exe` 是否仍被进程占用。更新前 DSH 会退出,但 Remote 插件的常驻网关按设计继续运行。本条目依据 2026-10-24 在 Windows 10 + DSH Desktop 0.2.1-rc.3 上的实际事件核对,插件为修复前版本。
72
+
73
+ | 证据 | 意味着什么 | 下一步 |
74
+ | --- | --- | --- |
75
+ | DSH 已退出时,对 `<DSH 安装目录>\DeepSeek Harness.exe` 做 `r+` 打开仍报 `EBUSY`/`EPERM` | 仍有进程以该 exe 运行,Windows 无法替换;旧插件网关常用 `process.execPath` 启动 | 查网关进程与解释器路径,核对归属后停止或由新插件接管 |
76
+ | 安装器或更新流程提示占用/失败,Restart Manager 点名同一 exe 或 `gateway.cjs` | 插件网关持有安装目录内 exe,NSIS 原地替换被阻塞 | 不要反复重试安装;先解除占用 |
77
+ | Prefetch 有安装器记录、`%TEMP%` 有 `nsr*.tmp`,但安装目录当天 0 个文件更新 | 安装器运行过但未写入,不能当作下载或校验失败 | 按占用处理,再重试更新 |
78
+ | 卸载登记项 `DisplayVersion` 与 `resources\app.asar` 修改时间仍是旧值 | 新版本没有落盘 | 解除占用并重试后,再核对这两项 |
79
+
80
+ **0.8.1 起的行为:** 插件按 `DSH_REMOTE_NODE` → PATH `node` → 内置运行时副本 → `process.execPath` 的顺序选择网关解释器;旧插件需升级后才能获得。所选来源与告警显示在插件面板版本号旁,跳过原因写入 `~/.dsh-remote/plugin-gateway.log`。
81
+
82
+ 外部解释器通过版本检测但启动失败时,仍会先尝试内置副本再回退宿主。路径按真实位置检查,目录联接不能把安装目录内的 exe 伪装成外部候选。面板只显示当前网关 PID 对应的实际解释器;旧网关无法报告时显示「网关解释器待确认」,停止再启动后确认。重启桌面插件后,可认证迁移同版本遗留网关;已尝试并回退的实例不会被反复重启。
83
+
84
+ **判断:** 反直觉的是,更新时 DSH 本体已经关闭,所以「DSH 还在运行」通常不是占用源;遗留的插件网关才是常见阻塞者。Windows 不允许覆盖正在运行的 exe,而 NSIS 更新器会替换整个安装目录;Linux/macOS 的运行中可执行文件可以替换,不受影响。
85
+
86
+ **下一步:** 升级到含网关解释器修复的插件版本;重启 DSH 或从插件面板停止/启动网关,让旧网关被认证关闭并拉起新网关;确认网关解释器不在安装目录内,再重试内置更新。旧版插件遗留的网关可在插件面板停止。进程核对命令与选择顺序见仓库 `docs/troubleshooting.md` 的「Windows:DSH 更新点了没反应 / 提示安装更新失败」;`DSH_REMOTE_NODE` 等配置见仓库 `docs/configuration.md` 的「网关解释器」。
87
+
88
+ **验收:** 卸载登记项版本与 `resources\app.asar` 已更新,安装目录有实际写入;网关继续运行且 `ExecutablePath` 为 PATH node 或 `~/.dsh-remote/runtime/node-<版本>.exe`,不在安装目录内;插件面板不再显示「网关解释器位于 DSH 安装目录内,DSH 更新可能失败」告警。仍显示告警说明当前回退到安装目录内 exe,需按配置参考改用合格 Node。
89
+
90
+ 依据:仓库 `packages/plugin/plugin-center.mjs`、`plugin-transaction.mjs`、`task-board.mjs`、`insights.mjs`、`index.mjs`、`public/plugin-center.js`、`public/task-board.js`,以及 `docs/plugin-center.md`、`docs/plugin-update-transaction.md`。
@@ -0,0 +1,45 @@
1
+ # 会话、历史与发送结果
2
+
3
+ [首页](README.md) · [日常操作](operations.md)
4
+
5
+ ## KB-SESSION-01:历史一直加载、计数非零却空白
6
+
7
+ **先看:** 是一个会话还是全部会话;当前服务器/工作区/会话是否正确;显示的是缓存还是主机结果;本地操作日志中的 cache、load、render 阶段,以及 mux/host 错误。
8
+
9
+ **判断:** 读请求超时、IndexedDB 等待、格式迁移失败与渲染失败需要分开。历史总数不等于当前页有可显示消息;缓存计数也不证明本次主机读取成功。
10
+
11
+ **下一步:** 先用页面“重试”“加载更早记录”,保留当前失败阶段;迁移错误走 KB-SESSION-02。切换主机后旧响应不应覆盖新会话。不要先清除全部数据,否则会丢失缓存、连接设置和排障线索。
12
+
13
+ **验收:** 同一会话的主机历史可读取,记录与时间顺序正确,分页/回到最新可用;切网后恢复且没有永久加载。UI 正常不等于原会话所有历史都已核验。
14
+
15
+ ## KB-SESSION-02:migration-required、fallback、instruction-hint
16
+
17
+ **先看:** `session/migration-required` 或 `cannot safely transform unclassified message source`;是否只有特定旧会话失败。
18
+
19
+ **判断:** issue #18 的根因涉及 DSH 上游迁移器。Remote 识别并隔离单会话观察错误,显示说明与重试;不修复迁移器,不改原始日志。源码/协议回归不能证明报告者旧数据已恢复。
20
+
21
+ **下一步:** 在 DSH 中检查原会话,并按上游支持的升级/迁移方案处理。不要把 `fallback` 改为 `user`,不要让只读观察批量激活冷会话,或反复全局重连。
22
+
23
+ **验收:** 坏会话有明确提示;健康会话仍有历史与实时事件;审批仍可达;原日志不被 Remote 改写。原坏会话的完整恢复另行记录,#18 仍是已知限制。
24
+
25
+ ## KB-SESSION-03:发送超时、回执 pending/unknown
26
+
27
+ **先看:** 当前会话历史、原发送操作的回执、失败阶段与请求 ID;不复制消息正文到公开诊断。
28
+
29
+ **判断:** accepted 表示主机已接受,rejected 表示明确拒绝,pending/unknown 表示尚不能确定。5xx、断线或响应丢失可能发生在主机已执行之后。
30
+
31
+ **下一步:** 从“更多 → 审批与操作回执”及会话历史核对原操作;原意图的再次操作应查询/恢复原回执,不另建一次发送。不要把保留的草稿当成“主机肯定没收到”。
32
+
33
+ **验收:** 原操作进入明确终态,只有预期的一条主机消息;未知期间不发生重复发送。没有旧版未记录的错误信息时,不能事后补出具体根因。
34
+
35
+ ## KB-SESSION-04:插队、思考、分支或子智能体不符合预期
36
+
37
+ | 现象 | 核对 | 验收 |
38
+ | --- | --- | --- |
39
+ | 长按没有插队 | 是否开启长按功能、会话是否繁忙、按钮提示和主机是否支持 steer | 已接受请求与真正生效时机分开;当前工具可能继续执行 |
40
+ | 手机没有思考或档位无效 | 主机实际模型 ID、模型目录/路由、弱网设置是否隐藏流式输出 | 实时与已完成历史分别看;能选档位不代表提供方执行 |
41
+ | 分支后仍在旧会话 | 创建结果返回的目标会话、当前主机、历史边界 | 跳到新分支且可继续;不自动发送提示词验证 |
42
+ | 子智能体不在主列表 | “子代理”入口、父会话、已加载层级和 DSH 能力 | 子记录只读;不能把第三方团队当内置子代理 |
43
+ | 新会话突然提示旧错误 | 错误所属 sessionId、当前会话、Auto 集成状态 | 旧会话错误不串入;当前会话真实权限恢复错误仍显示 |
44
+
45
+ 没有 `session.delete` 能力时使用归档流程;不要直接删除持久化文件。权限切换与审批操作见 [日常操作](operations.md),源码依据见 [来源索引](sources.md)。
@@ -0,0 +1,27 @@
1
+ # 源码、契约与验证依据
2
+
3
+ [首页](README.md)
4
+
5
+ 下表是本库结论的本地检索入口。源码仓库中按这些相对路径阅读;插件安装包中网关名为 `gateway.cjs`,不携带整个测试目录。找不到文件时标注缺失,不搜索用户无关目录。
6
+
7
+ | 范围 | 实现位置 | 主要回归/专题 |
8
+ | --- | --- | --- |
9
+ | 网关 health、鉴权、文件、WS、supervisor | `gateway.js`;包内 `gateway.cjs` | `tests/gateway.test.js`、`tests/crash-recovery.test.js`、`tests/supervisor-endpoint.test.js` |
10
+ | 插件启动、端口、上游 Cookie | `packages/plugin/index.mjs` | `tests/plugin-autostart.test.js`、`tests/restart-connectivity.test.js`、`docs/configuration.md` |
11
+ | 会话迁移和按需订阅 | `gateway.js` 的 `translateModernRpc`、`handleModernStreamFailure`、现代 collector | `tests/dsh-021-compat.test.js`、`tests/session-observation.test.js`、`tests/session-observation-installed.test.js` |
12
+ | 历史、错误归属、发送回执 | `public/history.js`、`public/app.js`、`public/desktop/desktop.js`、`public/operations.js` | `tests/history-ui.test.js`、`tests/history-load-recovery.test.js`、`tests/receipt-errors.test.js` |
13
+ | 插件清单与事务 | `packages/plugin/plugin-center.mjs`、`plugin-transaction.mjs`、`market.mjs`,`public/plugin-center.js` | `tests/plugin-center.test.js`、`tests/plugin-center-ui.test.js`、`tests/plugin-transaction.test.js`、`docs/plugin-center.md` |
14
+ | 文件与上传 | `gateway.js`、`public/app.js`、`public/chat-files.js` | `tests/windows-files.test.js`、`tests/windows-gateway.test.js`、`tests/upload-ui.test.js` |
15
+ | 模型、权限、审批、子代理 | `public/permission-presets.js`、`approval-records.js`、`subagents.js`,网关协议适配 | `tests/permission-presets-ui.test.js`、`tests/approval-records-ui.test.js`、`docs/subagent-viewing.md` |
16
+ | Android 后台与峰谷 | `android/app/src/main/java/com/dshremote/app/`,`packages/plugin/peak-reminders.mjs` | `tests/android-background.test.js`、`tests/peak-reminders.test.js`、`docs/peak-reminders-and-issue18.md` |
17
+ | 诊断入口与本地日志 | `public/doctor.js`、`diagnostics.js`,`packages/plugin/doctor-target.mjs`、`doctor-skill.mjs` | `tests/doctor.test.js`、`tests/doctor-entry.test.js`、`tests/client-diagnostics.test.js` |
18
+ | 版本、构建与分发 | `scripts/android-version.mjs`、`scripts/release.mjs`、`scripts/sync-plugin.mjs` | `tests/android-version.test.js`、`tests/release.test.js`、`docs/release.md` |
19
+
20
+ ## 如何判断证据强度
21
+
22
+ 1. 文档说明设计与操作方法;源码说明该快照的实现;测试说明具体断言通过。
23
+ 2. 真实 DSH 联调需确认安装版本、隔离环境和覆盖路径,不能套用到所有 DSH 版本。
24
+ 3. 运行实例、真实渲染与原设备操作才能证明对应用户路径;构建成功或模拟数据截图不能替代。
25
+ 4. 分发还需核对 GitHub 资产、精确 npm 版本/tag/tarball 与实际安装;Gitee 单独核验。
26
+
27
+ 本库未声称包含个人配置或完整故障样本。历史证据在仓库 `docs/archive/` 及各 RC 报告中保留原日期,不能当作实时状态。
package/skills.mjs ADDED
@@ -0,0 +1,53 @@
1
+ // Read-only adapter for dsh-skill-explorer 0.4.x. Paths never come from clients.
2
+ import { createHash } from 'node:crypto'
3
+ const text = (value, max) => typeof value === 'string' ? value.slice(0, max) : ''
4
+ const idOf = (name, path, source) => createHash('sha256').update(JSON.stringify([name, path, source])).digest('hex')
5
+ const unavailable = code => ({ status: 200, body: { ok: true, available: false, code } })
6
+ export function createSkillsAdapter(requestNative) {
7
+ async function list() {
8
+ const raw = await requestNative('/api/dsh-skill-explorer/list')
9
+ if (!raw || !Array.isArray(raw.groups) || typeof raw.complete !== 'boolean') throw new Error('unsupported')
10
+ const items = [], identities = new Map()
11
+ let truncated = raw.groups.length > 50
12
+ for (const group of raw.groups.slice(0, 50)) {
13
+ if (!Array.isArray(group?.skills)) throw new Error('unsupported')
14
+ for (const row of group.skills) {
15
+ if (items.length >= 500) { truncated = true; break }
16
+ if (!row || typeof row.name !== 'string' || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(row.name) || row.name.length > 200) continue
17
+ const source = text(group.key, 100), path = text(row.path, 4096), id = idOf(row.name, path, source)
18
+ const item = { id, name: row.name, description: text(row.description, 3000), whenToUse: text(row.whenToUse, 3000), source,
19
+ modelInvocable: typeof row.modelInvocable === 'boolean' ? row.modelInvocable : null,
20
+ userInvocable: typeof row.userInvocable === 'boolean' ? row.userInvocable : null,
21
+ readable: !!path, workspace: text(row.workspaceName, 200) }
22
+ identities.set(id, { name: row.name, path, item }); items.push(item)
23
+ }
24
+ }
25
+ return { body: { ok: true, schema: 1, available: true, source: 'dsh-skill-explorer', complete: raw.complete, truncated,
26
+ generatedAt: Date.now(), items }, identities }
27
+ }
28
+ return { async handle(method, endpoint, query = new URLSearchParams()) {
29
+ if (method !== 'GET') return { status: 405, body: { ok: false, code: 'read-only' } }
30
+ if (!['/list', '/read'].includes(endpoint)) return { status: 404, body: { ok: false, code: 'unknown-route' } }
31
+ const keys = [...query.keys()]
32
+ if (endpoint === '/list' ? keys.length : keys.length !== 1 || keys[0] !== 'id' || !/^[a-f0-9]{64}$/.test(query.get('id') || '')) {
33
+ return { status: 400, body: { ok: false, code: 'invalid-query' } }
34
+ }
35
+ try {
36
+ const state = await list()
37
+ if (endpoint === '/list') return { status: 200, body: state.body }
38
+ const found = state.identities.get(query.get('id'))
39
+ if (!found) return { status: 409, body: { ok: false, code: 'skill-changed' } }
40
+ if (!found.path) return { status: 200, body: { ok: true, available: true, item: found.item, content: null } }
41
+ const params = new URLSearchParams({ name: found.name, path: found.path })
42
+ const detail = await requestNative('/api/dsh-skill-explorer/read?' + params)
43
+ if (!detail || detail.name !== found.name || detail.path !== found.path || typeof detail.content !== 'string') throw new Error('unsupported')
44
+ return { status: 200, body: { ok: true, available: true, item: found.item,
45
+ content: detail.content.slice(0, 100000), truncated: detail.content.length > 100000 } }
46
+ } catch (error) {
47
+ if (error.status === 404) return unavailable('not-installed')
48
+ if (error.status === 401 || error.status === 403) return { status: 502, body: { ok: false, code: 'host-denied' } }
49
+ if (error.status === 409) return { status: 409, body: { ok: false, code: 'skill-changed' } }
50
+ return { status: 502, body: { ok: false, code: error.message === 'unsupported' ? 'unsupported' : 'skills-unavailable' } }
51
+ }
52
+ } }
53
+ }