@takboo/dsh-coopanion 0.4.9 → 0.4.10

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 (352) hide show
  1. package/README.md +60 -105
  2. package/desktop/keyboard-activity-win.cs +52 -0
  3. package/desktop/keyboard-activity-x11.py +77 -0
  4. package/desktop/keyboard-activity.cjs +54 -0
  5. package/desktop/keyboard-activity.jxa +27 -0
  6. package/desktop/lifecycle-state-macos.jxa +16 -0
  7. package/desktop/lifecycle-state.cjs +21 -0
  8. package/desktop/main.cjs +73 -13
  9. package/desktop/preload.cjs +3 -0
  10. package/dist/bridge.js.map +2 -2
  11. package/dist/build-info.json +6 -0
  12. package/dist/client.js +72 -1
  13. package/dist/companion-store.cjs +19907 -0
  14. package/dist/diagnostics.cjs +170 -0
  15. package/dist/figure-server.cjs +19725 -23
  16. package/dist/index.js +48 -3
  17. package/dist/index.js.map +3 -3
  18. package/docs/README.md +67 -0
  19. package/docs/archive/2026-10-m1-m6/roadmap.md +186 -0
  20. package/docs/{notification-implementation.md → archive/2026-10-notifications/notification-implementation.md} +3 -1
  21. package/docs/{notification-n0.md → archive/2026-10-notifications/notification-n0.md} +8 -6
  22. package/docs/{notification-n3.md → archive/2026-10-notifications/notification-n3.md} +2 -0
  23. package/docs/{notification-n4.md → archive/2026-10-notifications/notification-n4.md} +2 -0
  24. package/docs/{notification-plan.md → archive/2026-10-notifications/notification-plan.md} +4 -2
  25. package/docs/archive/2026-10-p1/roadmap-20261015.md +150 -0
  26. package/docs/archive/README.md +12 -0
  27. package/docs/archive/npm-bootstrap.md +18 -0
  28. package/docs/assets/README.md +16 -0
  29. package/docs/assets/showcase/appearance.png +0 -0
  30. package/docs/assets/showcase/companion.gif +0 -0
  31. package/docs/assets/showcase/conversation.png +0 -0
  32. package/docs/assets/showcase/inbox.png +0 -0
  33. package/docs/character-art-pipeline.md +122 -0
  34. package/docs/characters.md +10 -2
  35. package/docs/companionship-contract.md +70 -0
  36. package/docs/daily-rhythm-contract.md +4 -2
  37. package/docs/desktop-recovery-contract.md +4 -0
  38. package/docs/development.md +87 -0
  39. package/docs/diagnostics-contract.md +43 -0
  40. package/docs/evidence/AGENTS.md +5 -0
  41. package/docs/evidence/README.md +22 -0
  42. package/docs/evidence/p1/README.md +86 -0
  43. package/docs/evidence/p1/baseline-idle.json +8030 -0
  44. package/docs/evidence/p1/baseline-inbox-ui-native-access.log +47 -0
  45. package/docs/evidence/p1/baseline-inbox-ui-rerun.log +41 -0
  46. package/docs/evidence/p1/baseline-inbox-ui.log +15 -0
  47. package/docs/evidence/p1/baseline-unit.log +62 -0
  48. package/docs/evidence/p1/cadence-day.json +8394 -0
  49. package/docs/evidence/p1/cadence-night.json +8394 -0
  50. package/docs/evidence/p1/cadence-off.json +8034 -0
  51. package/docs/evidence/p1/companionship-installed-0.2.0-rc.2.json +13 -0
  52. package/docs/evidence/p1/companionship-installed-0.2.1-alpha.1.json +13 -0
  53. package/docs/evidence/p1/companionship-installed-s3-0.2.0-rc.2.json +13 -0
  54. package/docs/evidence/p1/companionship-installed-s3-0.2.1-alpha.1.json +13 -0
  55. package/docs/evidence/p1/companionship-invitation-s3.png +0 -0
  56. package/docs/evidence/p1/companionship-invitation.png +0 -0
  57. package/docs/evidence/p1/companionship-native-s3.json +22 -0
  58. package/docs/evidence/p1/companionship-native.json +22 -0
  59. package/docs/evidence/p1/companionship-small-menu-s3.png +0 -0
  60. package/docs/evidence/p1/companionship-small-menu.png +0 -0
  61. package/docs/evidence/p1/diagnostics-20261016/README.md +44 -0
  62. package/docs/evidence/p1/diagnostics-20261016/build-info.json +6 -0
  63. package/docs/evidence/p1/diagnostics-20261016/candidate-verification.json +7 -0
  64. package/docs/evidence/p1/diagnostics-20261016/installed-alpha1.json +15 -0
  65. package/docs/evidence/p1/diagnostics-20261016/installed-rc2.json +15 -0
  66. package/docs/evidence/p1/diagnostics-20261016/local-collector-processes.json +24 -0
  67. package/docs/evidence/p1/diagnostics-20261016/local-daily-files.json +6 -0
  68. package/docs/evidence/p1/diagnostics-20261016/local-daily-install.json +73 -0
  69. package/docs/evidence/p1/diagnostics-20261016/local-profile-update.json +9 -0
  70. package/docs/evidence/p1/diagnostics-20261016/local-progress-at-handoff.json +119 -0
  71. package/docs/evidence/p1/diagnostics-20261016/local-sampler-metadata.json +18 -0
  72. package/docs/evidence/p1/diagnostics-20261016/local-seven-day-launch.json +11 -0
  73. package/docs/evidence/p1/diagnostics-20261016/sha256.json +18 -0
  74. package/docs/evidence/p1/diagnostics-20261016/validation.json +40 -0
  75. package/docs/evidence/p1/diagnostics-20261016/vm-smoke-metadata.json +102 -0
  76. package/docs/evidence/p1/diagnostics-20261016/vm-smoke-summary.json +134 -0
  77. package/docs/evidence/p1/diagnostics-20261016/vm-two-hour-progress-at-handoff.json +145 -0
  78. package/docs/evidence/p1/diagnostics-20261016/vm-two-hour-start-metadata.json +102 -0
  79. package/docs/evidence/p1/diagnostics-followup-20261016/README.md +27 -0
  80. package/docs/evidence/p1/diagnostics-followup-20261016/candidate-ci-check.json +1 -0
  81. package/docs/evidence/p1/diagnostics-followup-20261016/documentation-checks.json +28 -0
  82. package/docs/evidence/p1/diagnostics-followup-20261016/local-configuration-check.json +85 -0
  83. package/docs/evidence/p1/diagnostics-followup-20261016/local-controller-check.json +11 -0
  84. package/docs/evidence/p1/diagnostics-followup-20261016/local-metadata.json +18 -0
  85. package/docs/evidence/p1/diagnostics-followup-20261016/local-progress.json +126 -0
  86. package/docs/evidence/p1/diagnostics-followup-20261016/remote-delivery-check.json +21 -0
  87. package/docs/evidence/p1/diagnostics-followup-20261016/sha256.json +10 -0
  88. package/docs/evidence/p1/diagnostics-followup-20261016/vm-progress.json +145 -0
  89. package/docs/evidence/p1/experience-rejected-20261016/README.md +24 -0
  90. package/docs/evidence/p1/experience-rejected-20261016/feedback-and-decision.json +22 -0
  91. package/docs/evidence/p1/experience-rejected-20261016/local-controller-final.json +13 -0
  92. package/docs/evidence/p1/experience-rejected-20261016/local-events.ndjson +58 -0
  93. package/docs/evidence/p1/experience-rejected-20261016/local-metadata.json +18 -0
  94. package/docs/evidence/p1/experience-rejected-20261016/local-samples.ndjson +112 -0
  95. package/docs/evidence/p1/experience-rejected-20261016/local-summary.json +112 -0
  96. package/docs/evidence/p1/experience-rejected-20261016/sha256.json +8 -0
  97. package/docs/evidence/p1/final-day.json +8394 -0
  98. package/docs/evidence/p1/final-night.json +8394 -0
  99. package/docs/evidence/p1/final-off.json +8034 -0
  100. package/docs/evidence/p1/final-resource-comparison-s2.json +27 -0
  101. package/docs/evidence/p1/implementation-day.json +8586 -0
  102. package/docs/evidence/p1/implementation-night.json +8394 -0
  103. package/docs/evidence/p1/implementation-off.json +8034 -0
  104. package/docs/evidence/p1/implementation-s1.json +29 -0
  105. package/docs/evidence/p1/implementation-s2.json +41 -0
  106. package/docs/evidence/p1/implementation-s3.json +54 -0
  107. package/docs/evidence/p1/keyboard-platforms-20261016/README.md +43 -0
  108. package/docs/evidence/p1/keyboard-platforms-20261016/SHA256SUMS +28 -0
  109. package/docs/evidence/p1/keyboard-platforms-20261016/build-info.json +6 -0
  110. package/docs/evidence/p1/keyboard-platforms-20261016/initial-record-at-e820baf.md +39 -0
  111. package/docs/evidence/p1/keyboard-platforms-20261016/install-0.2.0-rc.2.json +28 -0
  112. package/docs/evidence/p1/keyboard-platforms-20261016/install-0.2.1-alpha.1.json +28 -0
  113. package/docs/evidence/p1/keyboard-platforms-20261016/install-alpha.log +36 -0
  114. package/docs/evidence/p1/keyboard-platforms-20261016/install-rc.log +36 -0
  115. package/docs/evidence/p1/keyboard-platforms-20261016/invalid-attempts/README.md +11 -0
  116. package/docs/evidence/p1/keyboard-platforms-20261016/invalid-attempts/physical-confirmed.json +42 -0
  117. package/docs/evidence/p1/keyboard-platforms-20261016/invalid-attempts/physical-initial.json +40 -0
  118. package/docs/evidence/p1/keyboard-platforms-20261016/invalid-attempts/physical-mouse-package.json +48 -0
  119. package/docs/evidence/p1/keyboard-platforms-20261016/invalid-attempts/physical-panel-timeout.log +9 -0
  120. package/docs/evidence/p1/keyboard-platforms-20261016/package-linux-arm64-helper.log +8 -0
  121. package/docs/evidence/p1/keyboard-platforms-20261016/package-linux-keyboard.json +30 -0
  122. package/docs/evidence/p1/keyboard-platforms-20261016/package-linux-keyboard.log +1 -0
  123. package/docs/evidence/p1/keyboard-platforms-20261016/package-macos-keyboard.json +23 -0
  124. package/docs/evidence/p1/keyboard-platforms-20261016/package-macos-keyboard.log +1 -0
  125. package/docs/evidence/p1/keyboard-platforms-20261016/package-macos-npc.json +22 -0
  126. package/docs/evidence/p1/keyboard-platforms-20261016/package-macos-npc.log +1 -0
  127. package/docs/evidence/p1/keyboard-platforms-20261016/physical-acceptance-SHA256SUMS +4 -0
  128. package/docs/evidence/p1/keyboard-platforms-20261016/physical-acceptance.json +50 -0
  129. package/docs/evidence/p1/keyboard-platforms-20261016/physical-panel-focused-probe.mjs +45 -0
  130. package/docs/evidence/p1/keyboard-platforms-20261016/physical-panel-package.json +71 -0
  131. package/docs/evidence/p1/keyboard-platforms-20261016/physical-panel-probe.mjs +43 -0
  132. package/docs/evidence/p1/keyboard-platforms-20261016/physical-panel-waiting.log +3 -0
  133. package/docs/evidence/p1/keyboard-platforms-20261016/physical-panel.log +4 -0
  134. package/docs/evidence/p1/keyboard-platforms-20261016/previous-packages.json +12 -0
  135. package/docs/evidence/p1/keyboard-platforms-20261016/protected-bytes.json +5 -0
  136. package/docs/evidence/p1/keyboard-platforms-20261016/protected-final.json +6 -0
  137. package/docs/evidence/p1/keyboard-platforms-20261016/source-binding.json +13 -0
  138. package/docs/evidence/p1/keyboard-platforms-20261016/unit.log +74 -0
  139. package/docs/evidence/p1/keyboard-platforms-20261016/validation.json +40 -0
  140. package/docs/evidence/p1/keyboard-platforms-20261016/verification.json +7 -0
  141. package/docs/evidence/p1/keyboard-vm-20261016/README.md +51 -0
  142. package/docs/evidence/p1/keyboard-vm-20261016/SHA256SUMS +44 -0
  143. package/docs/evidence/p1/keyboard-vm-20261016/cleanup-vms.json +29 -0
  144. package/docs/evidence/p1/keyboard-vm-20261016/cleanup-vms.stderr +0 -0
  145. package/docs/evidence/p1/keyboard-vm-20261016/create-linux.log +14 -0
  146. package/docs/evidence/p1/keyboard-vm-20261016/create-windows.json +1 -0
  147. package/docs/evidence/p1/keyboard-vm-20261016/create-windows.stderr +0 -0
  148. package/docs/evidence/p1/keyboard-vm-20261016/dhcp-leases-after.stderr +2 -0
  149. package/docs/evidence/p1/keyboard-vm-20261016/dhcp-leases-after.txt +0 -0
  150. package/docs/evidence/p1/keyboard-vm-20261016/harness/cleanup-vms.py +49 -0
  151. package/docs/evidence/p1/keyboard-vm-20261016/harness/inject-vm.py +35 -0
  152. package/docs/evidence/p1/keyboard-vm-20261016/harness/install-linux.sh +17 -0
  153. package/docs/evidence/p1/keyboard-vm-20261016/harness/prepare-windows-console.ps1 +52 -0
  154. package/docs/evidence/p1/keyboard-vm-20261016/harness/retry-windows-validation.ps1 +17 -0
  155. package/docs/evidence/p1/keyboard-vm-20261016/harness/run-linux-package-probe.py +13 -0
  156. package/docs/evidence/p1/keyboard-vm-20261016/harness/run-linux-probe.py +13 -0
  157. package/docs/evidence/p1/keyboard-vm-20261016/harness/run-windows-probe.py +17 -0
  158. package/docs/evidence/p1/keyboard-vm-20261016/harness/setup-linux.sh +21 -0
  159. package/docs/evidence/p1/keyboard-vm-20261016/harness/setup-windows.ps1 +33 -0
  160. package/docs/evidence/p1/keyboard-vm-20261016/harness/start-windows-probe.ps1 +20 -0
  161. package/docs/evidence/p1/keyboard-vm-20261016/harness/vm-npc-probe-preflight.mjs +45 -0
  162. package/docs/evidence/p1/keyboard-vm-20261016/harness/vm-npc-probe.mjs +46 -0
  163. package/docs/evidence/p1/keyboard-vm-20261016/host-after-cleanup.txt +8 -0
  164. package/docs/evidence/p1/keyboard-vm-20261016/install-linux.log +8 -0
  165. package/docs/evidence/p1/keyboard-vm-20261016/linux-environment.txt +34 -0
  166. package/docs/evidence/p1/keyboard-vm-20261016/linux-keyboard-native.json +24 -0
  167. package/docs/evidence/p1/keyboard-vm-20261016/linux-qmp-npc.log +9 -0
  168. package/docs/evidence/p1/keyboard-vm-20261016/linux-qmp-package-npc.log +9 -0
  169. package/docs/evidence/p1/keyboard-vm-20261016/linux-rebuilt-preflight.json +100 -0
  170. package/docs/evidence/p1/keyboard-vm-20261016/linux-result.json +100 -0
  171. package/docs/evidence/p1/keyboard-vm-20261016/linux-validation.log +75 -0
  172. package/docs/evidence/p1/keyboard-vm-20261016/node-win-checksum.json +5 -0
  173. package/docs/evidence/p1/keyboard-vm-20261016/protected-bytes.json +6 -0
  174. package/docs/evidence/p1/keyboard-vm-20261016/setup-linux.log +765 -0
  175. package/docs/evidence/p1/keyboard-vm-20261016/setup-windows.log +92 -0
  176. package/docs/evidence/p1/keyboard-vm-20261016/summary.json +54 -0
  177. package/docs/evidence/p1/keyboard-vm-20261016/windows-autologin-cleanup.json +1 -0
  178. package/docs/evidence/p1/keyboard-vm-20261016/windows-console-preparation.json +6 -0
  179. package/docs/evidence/p1/keyboard-vm-20261016/windows-console-state-1.json +1 -0
  180. package/docs/evidence/p1/keyboard-vm-20261016/windows-final-state.txt +4 -0
  181. package/docs/evidence/p1/keyboard-vm-20261016/windows-keyboard-native.json +24 -0
  182. package/docs/evidence/p1/keyboard-vm-20261016/windows-keyboard-native.log +1 -0
  183. package/docs/evidence/p1/keyboard-vm-20261016/windows-qmp-console.log +110 -0
  184. package/docs/evidence/p1/keyboard-vm-20261016/windows-result.json +101 -0
  185. package/docs/evidence/p1/keyboard-vm-20261016/windows-validation-retry.log +90 -0
  186. package/docs/evidence/p1/keyboard-vm-20261016/windows-vm-raw.log +6 -0
  187. package/docs/evidence/p1/npc-capability-20261016/README.md +27 -0
  188. package/docs/evidence/p1/npc-capability-20261016/initial-probe.log +14 -0
  189. package/docs/evidence/p1/npc-capability-20261016/initial-probe.mjs +51 -0
  190. package/docs/evidence/p1/npc-capability-20261016/inventory.json +123 -0
  191. package/docs/evidence/p1/npc-capability-20261016/probe.log +1 -0
  192. package/docs/evidence/p1/npc-capability-20261016/probe.mjs +56 -0
  193. package/docs/evidence/p1/npc-capability-20261016/report.json +180 -0
  194. package/docs/evidence/p1/npc-capability-20261016/sha256.json +8 -0
  195. package/docs/evidence/p1/npc-life-20261016/README.md +56 -0
  196. package/docs/evidence/p1/npc-life-20261016/SHA256SUMS +47 -0
  197. package/docs/evidence/p1/npc-life-20261016/SHA256SUMS.initial +41 -0
  198. package/docs/evidence/p1/npc-life-20261016/actual-input.json +1069 -0
  199. package/docs/evidence/p1/npc-life-20261016/attempts/desktop-geometry-startup.log +96 -0
  200. package/docs/evidence/p1/npc-life-20261016/attempts/desktop-physical-cursor-interruption.log +19 -0
  201. package/docs/evidence/p1/npc-life-20261016/attempts/inbox-first.log +85 -0
  202. package/docs/evidence/p1/npc-life-20261016/attempts/initial-companion-ui.log +31 -0
  203. package/docs/evidence/p1/npc-life-20261016/attempts/install-rc-first.log +191 -0
  204. package/docs/evidence/p1/npc-life-20261016/attempts/native-first.log +11 -0
  205. package/docs/evidence/p1/npc-life-20261016/attempts/native-geometry-first.log +89 -0
  206. package/docs/evidence/p1/npc-life-20261016/baseline.json +1029 -0
  207. package/docs/evidence/p1/npc-life-20261016/build-info.json +6 -0
  208. package/docs/evidence/p1/npc-life-20261016/companionship-installed-0.2.0-rc.2.json +13 -0
  209. package/docs/evidence/p1/npc-life-20261016/companionship-installed-0.2.1-alpha.1.json +13 -0
  210. package/docs/evidence/p1/npc-life-20261016/controlled-idle.json +1069 -0
  211. package/docs/evidence/p1/npc-life-20261016/daily-rhythm-installed-0.2.0-rc.2.json +14 -0
  212. package/docs/evidence/p1/npc-life-20261016/daily-rhythm-installed-0.2.1-alpha.1.json +14 -0
  213. package/docs/evidence/p1/npc-life-20261016/desktop.log +12 -0
  214. package/docs/evidence/p1/npc-life-20261016/diagnostics-installed-0.2.0-rc.2.json +15 -0
  215. package/docs/evidence/p1/npc-life-20261016/diagnostics-installed-0.2.1-alpha.1.json +15 -0
  216. package/docs/evidence/p1/npc-life-20261016/final-integrity.json +12 -0
  217. package/docs/evidence/p1/npc-life-20261016/general-ui-source.log +24 -0
  218. package/docs/evidence/p1/npc-life-20261016/general-ui.log +24 -0
  219. package/docs/evidence/p1/npc-life-20261016/inbox-ui.log +67 -0
  220. package/docs/evidence/p1/npc-life-20261016/install-0.2.0-rc.2.json +28 -0
  221. package/docs/evidence/p1/npc-life-20261016/install-0.2.1-alpha.1.json +28 -0
  222. package/docs/evidence/p1/npc-life-20261016/install-alpha.log +36 -0
  223. package/docs/evidence/p1/npc-life-20261016/install-rc.log +36 -0
  224. package/docs/evidence/p1/npc-life-20261016/multi-display-installed-0.2.0-rc.2.json +581 -0
  225. package/docs/evidence/p1/npc-life-20261016/multi-display-installed-0.2.1-alpha.1.json +581 -0
  226. package/docs/evidence/p1/npc-life-20261016/notification-ui-source.log +5 -0
  227. package/docs/evidence/p1/npc-life-20261016/notification-ui.log +5 -0
  228. package/docs/evidence/p1/npc-life-20261016/npc-life-native-home.png +0 -0
  229. package/docs/evidence/p1/npc-life-20261016/npc-life-native.json +20 -0
  230. package/docs/evidence/p1/npc-life-20261016/npc-life-observe.png +0 -0
  231. package/docs/evidence/p1/npc-life-20261016/package-native.log +1 -0
  232. package/docs/evidence/p1/npc-life-20261016/preserved-originals.json +21 -0
  233. package/docs/evidence/p1/npc-life-20261016/resources.log +9 -0
  234. package/docs/evidence/p1/npc-life-20261016/source-binding.json +13 -0
  235. package/docs/evidence/p1/npc-life-20261016/source-verify.log +7 -0
  236. package/docs/evidence/p1/npc-life-20261016/text-scale-installed-0.2.0-rc.2.json +653 -0
  237. package/docs/evidence/p1/npc-life-20261016/text-scale-installed-0.2.1-alpha.1.json +653 -0
  238. package/docs/evidence/p1/npc-life-20261016/typecheck.log +4 -0
  239. package/docs/evidence/p1/npc-life-20261016/unit.log +69 -0
  240. package/docs/evidence/p1/npc-life-20261016/validation.json +33 -0
  241. package/docs/evidence/p1/npc-life-20261016/verification.json +7 -0
  242. package/docs/evidence/p1/npc-life-20261016/verify-source.py +22 -0
  243. package/docs/evidence/p1/p1-cadence-desktop.log +10 -0
  244. package/docs/evidence/p1/p1-cadence-inbox-ui.log +65 -0
  245. package/docs/evidence/p1/p1-cadence-notification-ui.log +5 -0
  246. package/docs/evidence/p1/p1-cadence-package-check.log +1 -0
  247. package/docs/evidence/p1/p1-cadence-ui-full.log +24 -0
  248. package/docs/evidence/p1/p1-final-desktop.log +10 -0
  249. package/docs/evidence/p1/p1-final-inbox-ui.log +63 -0
  250. package/docs/evidence/p1/p1-final-notification-ui.log +5 -0
  251. package/docs/evidence/p1/p1-final-typecheck.log +4 -0
  252. package/docs/evidence/p1/p1-final-ui.log +24 -0
  253. package/docs/evidence/p1/p1-final-unit.log +68 -0
  254. package/docs/evidence/p1/p1-s3-install-alpha1.redacted.log +34 -0
  255. package/docs/evidence/p1/p1-s3-install-rc2.redacted.log +34 -0
  256. package/docs/evidence/p1/p1-s3-metadata.log +5 -0
  257. package/docs/evidence/p1/p1-s3-resource.log +12 -0
  258. package/docs/evidence/p1/p1-s3-typecheck.log +4 -0
  259. package/docs/evidence/p1/p1-s3-unit.log +68 -0
  260. package/docs/evidence/p1/p1-verified-install-alpha1.redacted.log +35 -0
  261. package/docs/evidence/p1/p1-verified-install-rc2.redacted.log +35 -0
  262. package/docs/evidence/p1/p1-verified-package-check.log +1 -0
  263. package/docs/evidence/p1/paired-diagnostic-s2.json +61 -0
  264. package/docs/evidence/p1/paired-diagnostic-s3.json +61 -0
  265. package/docs/evidence/p1/resource-comparison-s3.json +33 -0
  266. package/docs/evidence/p1/resource-comparison.json +27 -0
  267. package/docs/evidence/p1/vm-20261016/README.md +43 -0
  268. package/docs/evidence/p1/vm-20261016/SHA256SUMS +6 -0
  269. package/docs/evidence/p1/vm-20261016/candidate-source-check.json +195 -0
  270. package/docs/evidence/p1/vm-20261016/environment-during-run.txt +70 -0
  271. package/docs/evidence/p1/vm-20261016/long-start-metadata.json +48 -0
  272. package/docs/evidence/p1/vm-20261016/observer-v1/observe-companion.mjs +279 -0
  273. package/docs/evidence/p1/vm-20261016/observer-v1/resource-observation.mjs +89 -0
  274. package/docs/evidence/p1/vm-20261016/observer-v1/run-resource-observation.sh +34 -0
  275. package/docs/evidence/p1/vm-20261016/observer-v1-SHA256SUMS +3 -0
  276. package/docs/evidence/p1/vm-20261016/old-run-partial-SHA256SUMS +3 -0
  277. package/docs/evidence/p1/vm-20261016/old-run-partial-samples.ndjson +554 -0
  278. package/docs/evidence/p1/vm-20261016/old-run-partial-summary.json +101 -0
  279. package/docs/evidence/p1/vm-20261016/old-run-stop.json +6 -0
  280. package/docs/evidence/p1/vm-20261016/smoke-metadata.json +48 -0
  281. package/docs/evidence/p1/vm-20261016/smoke-samples.ndjson +12 -0
  282. package/docs/evidence/p1/vm-20261016/smoke-summary.json +94 -0
  283. package/docs/evidence/releases/v0.4.9/README.md +18 -0
  284. package/docs/evidence/releases/v0.4.9/delivery-verification.json +480 -0
  285. package/docs/multi-display-contract.md +4 -4
  286. package/docs/notification-contract.md +7 -5
  287. package/docs/npc-daily-life-plan.md +80 -0
  288. package/docs/release-notes.md +15 -0
  289. package/docs/releasing.md +5 -16
  290. package/docs/roadmap.md +69 -153
  291. package/docs/text-readability-contract.md +2 -2
  292. package/docs/usage.md +157 -0
  293. package/npm-shrinkwrap.json +2 -2
  294. package/package.json +3 -2
  295. package/scripts/build.mjs +22 -1
  296. package/scripts/capture-showcase.mjs +81 -0
  297. package/scripts/check-package.mjs +8 -0
  298. package/scripts/diagnostics-client.mjs +89 -0
  299. package/scripts/measure-idle.mjs +11 -7
  300. package/scripts/observe-companion.mjs +166 -0
  301. package/scripts/preview.mjs +2 -1
  302. package/scripts/resource-observation.mjs +117 -0
  303. package/scripts/run-resource-observation.sh +34 -0
  304. package/scripts/sample-companion.mjs +156 -0
  305. package/src/bridge.ts +2 -1
  306. package/src/client/Settings.tsx +9 -3
  307. package/src/client/locales.ts +4 -0
  308. package/src/companion-store.ts +149 -0
  309. package/src/diagnostics.ts +98 -0
  310. package/src/figure-server.ts +18 -4
  311. package/src/index.ts +12 -7
  312. package/tests/bridge.test.ts +3 -3
  313. package/tests/companion-client.test.js +22 -0
  314. package/tests/companion-http.test.ts +24 -0
  315. package/tests/companion-store.test.ts +77 -0
  316. package/tests/companion-touch.test.js +20 -0
  317. package/tests/companionship-native.mjs +44 -0
  318. package/tests/companionship-ui.mjs +315 -0
  319. package/tests/companionship.test.js +57 -0
  320. package/tests/desktop.mjs +4 -0
  321. package/tests/diagnostics-native.mjs +82 -0
  322. package/tests/diagnostics.test.js +133 -0
  323. package/tests/helpers/body-startup.mjs +31 -0
  324. package/tests/helpers/companionship.mjs +25 -0
  325. package/tests/helpers/keyboard-x11-probe.py +60 -0
  326. package/tests/helpers/native-pointer.mjs +10 -0
  327. package/tests/helpers/npc-life.mjs +24 -0
  328. package/tests/install.mjs +42 -1
  329. package/tests/keyboard-activity-native.mjs +40 -0
  330. package/tests/keyboard-activity.test.js +102 -0
  331. package/tests/lifecycle-startup-native.mjs +47 -0
  332. package/tests/lifecycle-state.test.js +44 -0
  333. package/tests/npc-life-native.mjs +52 -0
  334. package/tests/npc-life.test.js +77 -0
  335. package/tests/plugin.test.ts +28 -0
  336. package/tests/render-cadence.test.js +20 -0
  337. package/tests/resource-observation.test.js +52 -0
  338. package/tests/session-replies-ui.mjs +3 -1
  339. package/tests/text-scale-ui.mjs +3 -1
  340. package/web/companion-client.js +32 -0
  341. package/web/companion-touch.js +15 -0
  342. package/web/companionship.d.ts +12 -0
  343. package/web/companionship.js +80 -0
  344. package/web/diagnostics.js +13 -0
  345. package/web/index.html +9 -0
  346. package/web/locale.js +2 -0
  347. package/web/npc-life.js +91 -0
  348. package/web/pet.js +186 -20
  349. package/web/render-cadence.js +6 -0
  350. package/web/style.css +13 -1
  351. package/web/upstream/LICENSE +661 -0
  352. package/web/upstream/UPSTREAM.md +2 -0
package/README.md CHANGED
@@ -1,150 +1,105 @@
1
- # DeepSeek 大肥鱼 · dsh-coopanion
1
+ # DeepSeek 大肥鱼
2
2
 
3
- 给 [DeepSeek Harness Desktop](https://github.com/deepseek-ai/deepseek-harness) 加一只桌面伙伴。她会陪你工作,在回复生成、目标完成、出错或需要确认时提醒你;双击角色,可以继续选中的 Harness 普通会话,包括尚未打开的历史会话。
3
+ **让 Harness 的工作,有个看得见的小伙伴。**
4
4
 
5
- **v0.4.9 使用 Coopanion 的原生动画与角色运行时,组合程序采用 AGPL-3.0-or-later。** 大肥鱼的网格变形、弹簧动作、动态五官、物理拖拽和八套配色直接复用上游固定版本。角色贴图保留独立权利声明,见 [第三方声明](THIRD_PARTY_NOTICES.md) 和 [上游版本记录](web/upstream/UPSTREAM.md)。
5
+ 大肥鱼住在你的桌面上,陪你一起用 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 工作。她会思考、挥手、陪你等结果,也会把回复和待办捎到桌边。双击她,就能接着刚才的对话聊下去。
6
6
 
7
- 本次更新改进目标完成判断、历史会话续接、异常恢复、文字大小与多屏定位,并新增默认关闭的日常陪伴节奏。查看 [最新修改记录](https://github.com/takboo/dsh-coopanion/releases/latest) 或 [完整版本记录](docs/release-notes.md)。
7
+ [![Release](https://img.shields.io/github/v/release/takboo/dsh-coopanion?color=4d6bfe)](https://github.com/takboo/dsh-coopanion/releases/latest)
8
+ [![CI](https://github.com/takboo/dsh-coopanion/actions/workflows/ci.yml/badge.svg)](https://github.com/takboo/dsh-coopanion/actions/workflows/ci.yml)
9
+ [![License: AGPL v3+](https://img.shields.io/badge/license-AGPL--3.0--or--later-blue)](LICENSE)
8
10
 
9
- M1–M6 的实现与本地验收记录已归档:[完成语义](docs/evidence/m1/README.md)、[会话续接](docs/evidence/m2/README.md)、[异常恢复](docs/evidence/m3/README.md)、[文字可读性](docs/evidence/m4/README.md)、[多屏适配](docs/evidence/m5/README.md)及[日常陪伴节奏](docs/evidence/m6/README.md)。这些历史记录绑定当时的源码与 v0.4.8 测试包;v0.4.9 分发产物由 CI 单独验证。物理多屏 / 混合 DPI、长期体验与资源表现、真实模型及系统通知中心验收仍待完成。
11
+ [**下载插件**](https://github.com/takboo/dsh-coopanion/releases/latest/download/dsh-coopanion.tgz) · [快速开始](#开始一起工作) · [使用指南](docs/usage.md) · [更新记录](https://github.com/takboo/dsh-coopanion/releases/latest)
10
12
 
11
- ## 功能
13
+ ![大肥鱼从思考到收到回复,双击打开聊天并继续输入](docs/assets/showcase/companion.gif)
12
14
 
13
- - 原生 WebGL 网格动画、眨眼与视线、动态嘴部、头发 / 鳍 / 尾巴的弹簧动作。
14
- - 上游动作和表情:走路、跑步、跳跃、挥手、鞠躬、跳舞、坐下、睡眠等;拖拽、抛掷与落地由同一物理系统处理。
15
- - 最终回复使用描边气泡,短预览在最多约 3 秒内显示;可立即显示、展开完整阅读和返回源会话。嘴部同步与合成音效可关闭,不是 TTS。
16
- - `figure.json` API 2 ZIP 角色包导入、动画预览、配色 / 多轴换装、切换、删除;角色和搭配在重启后保留。
17
- - 支持拖拽松手切换到原生鼠标所在显示器,也可从托盘 **移到显示器** 选择;拔掉当前屏后回到有效工作区,其他屏变化保持当前位置,阅读和草稿在当前窗口保留。物理多屏 / 混合 DPI 仍待实机验收,受控与本机结果见 M5 记录。
18
- - 透明、无边框、置顶桌宠;空白区域点击穿透。点击互动、双击聊天、右键菜单、闲时活动、休息和显示 / 隐藏。
19
- - 角色周围不显示常驻操作按钮或名称标签;有未读回复、待处理审批 / 提问或异常时出现小信封。聊天面板中点击当前会话可切换对话。
20
- - Harness 原生 **Settings → 桌宠** 页面:运行状态、启动 / 重启 / 关闭、显示 / 隐藏、角色管理及实时保存的偏好设置。
21
- - 实时思考 / 生成 / 工具工作动画;完成、审批、AI 提问、出错和各类停止通过角色表情与互动提示呈现。流式片段驱动嘴部,最终回复独立进入阅读气泡;只有已提交目标完成才庆祝,约 2.5 秒后回到待机。普通回合和目标中间轮保留全文及未读,提示“本轮回复已生成”;目标继续、暂停和阻塞分别呈现。
22
- - 角色显示时由角色提醒;运行中隐藏角色时,可由 Harness 发送系统通知并点击返回源会话。系统通知默认关闭,设置页提供权限申请、测试通知和送达回执。
23
- - 审批与 AI 提问的待处理列表、默认 10 分钟后的一次自动补提醒及“稍后提醒”;同一会话同时到期的请求合并提示。
24
- - 会话以真实提问、项目路径、时间和有效短编号区分,支持搜索及键盘切换;旧会话从公开历史恢复提问。
25
- - 菜单与聊天使用角色风格的描边卡片,颜色跟随换装;摸头、叫醒、拖拽等互动使用上游身体事件。
26
- - macOS 状态栏采用随系统明暗变化的角色模板图标与状态小图形,不显示状态文字;悬停和菜单保留会话、任务、未读及设置详情,与桌面共用状态判断和持久偏好。
27
- - 聊天输入通过正式 `sessionController.prompt`(`mode: queue`) 进入 Harness 的持久会话,使用其现有模型、工具和权限。互动和换装不会自动发起模型请求。
28
- - 菜单提供 **源码 · AGPL**,包含对应源代码、上游运行时、构建脚本和依赖锁文件。
15
+ <sub>实际浏览器界面演示:思考 → 收到回复 → 双击继续聊。演示中的 Harness 任务事件为模拟。</sub>
29
16
 
30
- 桌宠不作出审批,也不单独收集 API Key。聊天始终发给明确选中的关注会话,新建会话和后台任务不会自动切换目标。关注会话进行中时优先展示它的动作;空闲时用动作反映后台工作或确认 / 异常。状态栏图形优先提示任一会话的确认 / 异常,菜单显示详情。
17
+ 本页的 npm/Release 安装入口面向已发布版本。0.4.10 新增默认关闭的自主陪伴与本地诊断试用功能,实际发布身份及各项验收状态见[工程文档索引](docs/README.md)。
31
18
 
32
- 信封直接打开回复与待办收件箱:同一会话的多个未读回合合并展示最新回复,未读数量按会话计算。只有一份回复时展开全文;多份回复显示摘要和各自的 **继续对话 ↗**(在桌宠输入框继续来源会话),审批、提问及异常提供 **去处理 ↗**。全文支持 Markdown 标题、粗体、列表、表格和代码块。阅读不会切换正在聊天的会话;收件箱阅读器可连续读不同会话的结果,并返回收件箱查看新内容。正在阅读的回复不会被新结果替换。保留最近 200 份完整结果,优先淘汰已读;只有本次 Harness 运行中实时完成的回复计入未读,打开历史会话或重启 Harness 不会把旧回复重新标为未读。重启后原始对话仍由 Harness 保存;任务动画根据当前 Agent 的运行状态恢复。
19
+ ## 她会做些什么?
33
20
 
34
- 回复气泡展示或自动收起、查看收件箱摘要及收起收件箱均不会标记已读;主动展开阅读、关闭单份回复气泡或通过该回复回到源会话时,确认展示时合并的未读回合。阅读期间新到的回合继续保留未读,旧回合的完整结果仍可通过历史导航查看。审批与 AI 提问由 Harness 的实际答复、决定或取消结果结算;查看、收起互动提示或打开源会话均不会代替处理请求。
21
+ ### 桌边有个会回应你的小伙伴
35
22
 
36
- 高频流式事件仅发送动画元数据,完整结果只在结果列表或已读状态变化时传输,避免长回复和多会话拖慢桌面更新。
23
+ 眨眼、看向你、挥挥手,拖起来还会晃动、落地。点点她、打个招呼,或者换个模样继续工作。想安静一会儿,可以让她休息、关掉音效,或暂时隐藏。
37
24
 
38
- 角色脚本在 `sandbox="allow-scripts"` 的 opaque-origin iframe 中运行,只通过受控消息协议与宿主交互;没有 Node、Electron 桥、外部网络连接或顶层导航权限。本地资源服务只监听 `127.0.0.1`,桌面实例使用随机路径,API 写入要求可信页面来源。
25
+ 还可以开启默认关闭的「日常陪伴节奏」:白天偶尔做些小动作,夜间更安静;你在工作、阅读或输入时,她会先让位。
39
26
 
40
- ## 破坏式更新
27
+ ### 工作到哪一步,一眼就知道
41
28
 
42
- v0.4.0 移除了旧 Canvas 关键帧引擎、`dsh-character` v1 协议、`.dshpet` 包、旧 schema 和转换工具。旧角色不能直接加载,也不提供旧引擎兼容模式;需要重新制作或导入 API 2 包。
29
+ 思考、生成回复、使用工具,都有对应的表情和动作。目标真正完成时,她才会开心庆祝;需要审批、回答问题或查看异常时,小信封会为你留着入口。
43
30
 
44
- 桌面版改用独立数据目录 `figures-v2`,旧角色选择恢复为内置大肥鱼。旧 `characters` 数据不会被读取;不再需要时可自行删除。Harness 的会话与配置不受角色数据重置影响。
31
+ 角色隐藏后,还可以按需开启 Harness 系统通知。审批和问题始终由你在 Harness 中处理。
45
32
 
46
- ## 安装到 Desktop
33
+ ### 把回复带回来,也把对话接下去
47
34
 
48
- 支持 **DSH 0.2.0-rc.2 和 0.2.1-alpha.1**;其他版本未声明兼容。
35
+ 小信封收好不同会话的回复与待办。长回复可以展开阅读,支持 Markdown、表格和代码块;新消息到来时,正在读的内容保持原样。
49
36
 
50
- 1. 下载对应 [Release](https://github.com/takboo/dsh-coopanion/releases) 的 `dsh-coopanion-0.4.9.tgz`,或按下面步骤构建 `takboo-dsh-coopanion-0.4.9.tgz`。npm 包名为 `@takboo/dsh-coopanion`;本地 `npm pack` 的文件名包含 scope。
51
- 2. 在 Harness 侧边栏 **插件** 页安装压缩包的绝对路径,启用 `dsh-coopanion`。
52
- 3. 完全退出再重新打开 Harness。首次启动时会下载并校验 Electron 44 运行时。
53
- 4. 打开一段 Harness 会话,双击角色聊天,或从 **Settings → 桌宠** 管理角色。
37
+ 双击打开聊天,选择一段会话就能继续,包括还没在 Harness 中打开的历史会话。消息沿用该会话的模型、工具和权限,后台任务不会抢走你正在聊的对象。
54
38
 
55
- 也可使用 Desktop 自带的 CLI。先启动 Desktop 一次初始化 profile,完全退出应用,再执行:
39
+ <p align="center">
40
+ <img src="docs/assets/showcase/conversation.png" width="340" align="top" alt="大肥鱼聊天面板,保留选中的会话并继续输入">
41
+ <img src="docs/assets/showcase/inbox.png" width="340" align="top" alt="多会话回复收件箱,提供完整阅读和继续对话入口">
42
+ </p>
56
43
 
57
- ```bash
58
- dsh plugin --profile desktop add /absolute/path/dsh-coopanion-0.4.9.tgz
59
- ```
44
+ ### 换个模样,照你的习惯来
60
45
 
61
- npm 安装的 dsh 不能管理 Desktop 所拥有的 profile。Desktop 完全退出后执行包管理命令,再重新打开应用。
46
+ 内置大肥鱼提供多套配色,可以预览动作,也能导入社区制作的角色包。角色大小和文字大小分别调整,小小一只也能把回复看清楚。
62
47
 
63
- ## 开发与验证
48
+ <p align="center">
49
+ <img src="docs/assets/showcase/appearance.png" width="340" alt="角色面板中预览 Claude 配色与跳舞动作">
50
+ </p>
64
51
 
65
- 后续改进的范围、实施顺序与验收条件见[桌面伙伴改进路线图](docs/roadmap.md)。
52
+ 想制作自己的角色?从 [API 2 角色指南](docs/characters.md) 和 [最小示例](examples/star) 开始。
66
53
 
67
- 通知阶段及交付状态见 [通知执行计划](docs/notification-plan.md),本轮集成验收范围见 [N3 验收记录](docs/notification-n3.md)。
54
+ ## 开始一起工作
68
55
 
69
- 开发工具链固定 Node.js 24.21.0 和 npm 11.19.1。Electron 支持 Windows、macOS、Linux;Linux 的窗口测试需要 X11 / XWayland 或 Xvfb,以及 Python 3 和 libX11,用于同步原生鼠标位置。原生网格需要 Chromium 的 WebGL 支持。
56
+ 需要 **DeepSeek Harness Desktop 0.2.0-rc.2 或 0.2.1-alpha.1**。这是 Harness 插件,聊天使用你在 Harness 中配置的模型,无需另填 API Key。
70
57
 
71
- ```bash
72
- npm ci --ignore-scripts
73
- npm run verify:metadata
74
- npm run setup:electron
75
- npm run typecheck
76
- npm test
77
- npm run build
78
- npm run character:pack -- examples/star paper-star.zip
79
- npm run test:ui
80
- npm run test:notification-ui
81
- npm run test:desktop
82
- npm pack
83
- node scripts/check-package.mjs
84
- npm run test:install
85
- ```
58
+ ### 在 Harness 中从 npm 安装(推荐)
86
59
 
87
- 依赖锁使用 `npm-shrinkwrap.json`,随安装包及源码下载提供;`npm ci` 可以直接使用它。
60
+ 打开侧边栏 **插件 → 添加插件**,在「包名或地址」中填入:
88
61
 
89
- `npm run dev` 打开浏览器演示服务(默认 `http://127.0.0.1:4173`),`npm run demo` 启动桌面演示。演示中的任务事件是模拟的。浏览器预览和桌面版使用同一个 API 2 存储与沙箱运行时。
90
-
91
- 浏览器测试检查实际 WebGL 动画、逐字说话与嘴部同步、拖拽 / 落地、会话、聊天、换装、包导入、重启保存及脚本隔离。桌面测试验证真实 Electron 窗口、IPC、流式动画、最终回复与完整阅读、休息唤醒、实际状态栏图标和角色数据;CI 同时运行 Linux、macOS、Windows 原生窗口测试。安装测试使用官方 DSH profile loader 安装实际 `.tgz`,检查任务事件、会话导航、设置页、配置持久化和重启;`DSH_TEST_VERSION=0.2.1-alpha.1` 测试另一支持版本。
92
-
93
- CI 窗口测试使用隔离数据和测试沙箱参数;Linux 在虚拟显示中运行。普通安装保留 Chromium sandbox、contextIsolation,关闭 Node integration。安装测试中的通知适配器、原生可见性及答复器为受控边界;完整系统实机验收和外部真实模型会话尚未验证。
62
+ ```text
63
+ @takboo/dsh-coopanion
64
+ ```
94
65
 
95
- ## 新角色
66
+ 点击安装,完成后启用 `dsh-coopanion`,再完全退出并重新打开 Harness。
96
67
 
97
- 右键角色 → **换个模样** → **导入角色包**,选择包含 `figure.json` 的 API 2 ZIP。预览、试播动作、选择配色或搭配,再点击 **使用角色**。删除正在使用的自定义角色会恢复内置大肥鱼。
68
+ ### 使用 dsh 命令行安装
98
69
 
99
- `examples/star` 是基于上游 `kit.createBody()` 的最小 SVG 角色,具备共享动作、表情、说话和拖拽。复制目录、修改 id 和素材后打包:
70
+ 使用 **Desktop 自带的 `dsh` 命令**。先启动 Desktop 一次完成初始化,完全退出应用后执行:
100
71
 
101
72
  ```bash
102
- npm run character:pack -- examples/star paper-star.zip
73
+ dsh plugin --profile desktop add @takboo/dsh-coopanion
103
74
  ```
104
75
 
105
- 完整工厂接口、资源规则、动作映射及换装说明见 [角色对接文档](docs/characters.md)。内置大肥鱼的 `web/upstream/whale/figure.json` / `model.json` / `figure.js` 展示网格角色的完整实现。内置角色的 id 为 `whale`。
106
-
107
- ## 配置与会话
108
-
109
- **Settings → 桌宠** 沿用 Harness 的主题、中英文与系统语言设置。可控制随 Harness 启动、闲时活动、任务通知、系统通知、待处理请求补提醒、等待时间、角色尺寸(90–240)、文字大小(100% / 125% / 150%)和气泡时长(2–60 秒);数值按 Enter 或离开输入框保存。文字大小选择后立即保存并同步到当前桌宠,独立于角色尺寸,保留当前阅读、草稿与在途发送;旧配置默认 100%。
110
-
111
- **日常陪伴节奏** 默认关闭,旧配置沿用原有闲时动作。开启闲时走动及此偏好后,按系统本地时间在 07:00–22:00 每 45–90 秒尝试现有轻动作,夜间每 2–4 分钟仅轻点头或坐下;缺少动作时保持待机。任务、待办、阅读、输入、拖拽、用户休息及减少动态效果始终优先,占用解除后重新等待,动作结束恢复当前神态。偏好立即同步并持久保存,不增加模型请求或通知,详见[日常节奏契约](docs/daily-rhythm-contract.md)及[本地验证边界](docs/evidence/m6/README.md)。
112
-
113
- 桌宠意外退出后按 1、3、10 秒间隔最多自动恢复三次,连续稳定运行 60 秒后清零。设置页显示恢复次数和诊断,可随时关闭或在失败后手动重启;主动关闭不触发恢复。隐藏的角色恢复后仍隐藏,关注会话、完整结果、未读和有效待办保留,旧结果不再次主动提醒。窗口内草稿与阅读位置会随进程退出丢失,恢复不会重发聊天或任务。缺少图形环境、无效运行时路径或未确认清理的进程直接反馈错误,详见[恢复契约](docs/desktop-recovery-contract.md)。
114
-
115
- ```yaml
116
- - id: dsh-coopanion
117
- config:
118
- autoStart: true
119
- size: 180
120
- roam: true
121
- dailyRhythm: false
122
- notifications: true
123
- systemNotifications: false
124
- reminders: true
125
- reminderDelayMs: 600000
126
- bubbleDurationMs: 12000
127
- # electronPath: /absolute/path/to/electron
128
- ```
76
+ 完成后重新打开 Desktop。其他 profile 的安装方法见[使用指南](docs/usage.md#通过-dsh-命令行安装)。
129
77
 
130
- 最终回复气泡与事件互动提示分别显示。回复气泡时长从逐字显示完成后计时,鼠标停留或键盘聚焦时暂停收起;互动提示收起后,未处理的审批和提问仍保留在小信封列表。超过 180 字的回复展示按句子截取的开头(不做模型摘要),可展开完整阅读;原文保留且不截断,完整阅读器不会自动关闭。减少动态效果时禁用闲时活动与逐字显示,保留直接拖动及落地。
78
+ ### 下载压缩包安装
131
79
 
132
- 桌宠展示普通顶层会话,忽略子代理;首次可用会话成为当前对话,之后保持用户选中的关注会话。启动时从正式列表恢复最近最多 100 个普通会话,冷会话无需先在 Harness 中打开即可续接。发送中保留草稿,收到“已进入收件队列”回执后才清空;失败可重试,同一次提交复用请求 ID。切换关注会话不会改变在途消息的目标;会话缺失、其他进程占用、权限限制或模型不可用会明确反馈。接受不代表任务完成。详见[会话续接契约](docs/session-chat-contract.md)。桌面版通过公开的 `dsh://open` 协议唤回 Harness。多个本机客户端同时连接时,返回请求由首先领取的客户端处理。
80
+ [下载最新插件包 `dsh-coopanion.tgz`](https://github.com/takboo/dsh-coopanion/releases/latest/download/dsh-coopanion.tgz),在 **插件 → 添加插件** 中填入压缩包的绝对路径,安装并启用,然后重启 Harness。
133
81
 
134
- ## 提醒与系统通知
82
+ 安装后在 **Settings → 桌宠** 查看运行状态。首次启动需要联网下载并校验 Electron 运行时。
135
83
 
136
- 开启任务通知后,角色显示时用动作、表情和互动提示提醒;输入、阅读或拖拽期间先排队,结束后再呈现。最终回复与未读列表独立保留。审批/提问可预览内容、返回源会话或选择“稍后提醒”;限时提问标记“仍可回答”时,回合结束后仍可处理。
84
+ | 操作 | 会发生什么 |
85
+ |---|---|
86
+ | 单击角色 | 和她互动 |
87
+ | 双击角色 | 打开聊天;点击当前会话可换一段聊 |
88
+ | 右键角色 | 换装、休息、音效和其他偏好 |
89
+ | 点击小信封 | 查看回复、审批、问题和异常 |
137
90
 
138
- 补提醒默认开启,等待时间可设为 1–1440 分钟。新的待处理请求自动补提醒一次;“稍后提醒”按当前等待时间重新计时。处理、取消或销毁会话后撤销该请求的计时。历史恢复保留待处理入口,不重放旧提醒。关闭任务通知会停止主动提醒,保留会话状态和未读回复。
91
+ 系统通知与日常陪伴节奏默认关闭,可在设置中开启。更多配置、CLI 安装和旧角色迁移见[使用指南](docs/usage.md)。
139
92
 
140
- 系统通知默认关闭。在 **Settings → 桌宠 → 提醒与通知** 开启后,点击 **申请/刷新权限**,隐藏运行中的角色,再发送 **测试系统通知**。Desktop 使用 DeepSeek Harness 的应用身份,本机 `dsh web` 使用浏览器身份;点击通知请求打开源会话。角色关闭、启动中、失败或锁屏/休眠期间暂停主动投递。
93
+ ## 了解更多与参与
141
94
 
142
- 网页权限“允许”、已请求和收到显示回执分别表示不同步骤;系统送达需在通知中心核对,并点击检查源会话。macOS 在 **系统设置 → 通知 → DeepSeek Harness** 管理授权;Windows 在 **设置 → 系统 → 通知**,Linux 在桌面通知设置中管理。权限或客户端不可用时,待处理入口仍保留;恢复显示不会补发旧系统通知。
95
+ - **使用遇到问题:** 查看[使用指南](docs/usage.md),或[提交 Issue](https://github.com/takboo/dsh-coopanion/issues)。
96
+ - **参与开发:** 从[开发指南](docs/development.md)开始,完整契约与验证状态见[工程文档索引](docs/README.md)。
97
+ - **关注后续改进:** 查看[路线图](docs/roadmap.md)和[版本记录](docs/release-notes.md)。
143
98
 
144
- ## CI 与发布
99
+ 支持平台为 Windows、macOS 和 Linux。物理多屏/混合 DPI、系统通知中心实机体验、真实模型会话及长期资源表现的验证范围见[当前状态](docs/README.md#当前交付)。
145
100
 
146
- CI 在 **Linux、macOS、Windows** 执行元数据检查、类型检查、单元测试、浏览器交互及真实 Electron 窗口测试,并在三平台分别验证两个 DSH 版本的实际安装。稳定 `v<major>.<minor>.<patch>` 标签派发 main 上的发布流程;全部检查通过后,用 npm OIDC 发布已验证的同一份 `.tgz`,再创建 GitHub Release,附带版本化和固定名称的插件包、示例角色、校验值、源码提交报告及当前版本说明。
101
+ ## 致谢与许可
147
102
 
148
- 首次 npm 包创建和 Trusted Publisher 绑定需要维护者认证;dshmarket 通过社区目录 PR 收录,再自动关联 npm 包。具体操作、首次启用和失败重跑见 [发布说明](docs/releasing.md),市场条目的收录状态见 [目录 PR](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/7073)。
103
+ 大肥鱼的动画与角色运行时来自 [Pal-AI-Lab / Coopanion](https://github.com/Pal-AI-Lab/Coopanion)。感谢原作者与角色创作者,让她有了灵动的表情、动作和配色。
149
104
 
150
- 插件没有遥测或独立模型 API。上游代码和角色资源已固定在仓库中,不在启动时在线拉取。Electron 首次准备仍从官方发行源下载并校验;Node 24 可用 `NODE_USE_ENV_PROXY=1` 沿用已有代理变量。
105
+ 组合程序采用 [AGPL-3.0-or-later](LICENSE),保留原项目的 [MIT 署名](LICENSE-MIT)。角色贴图和商标有独立权利声明,详见[第三方声明](THIRD_PARTY_NOTICES.md)与[上游版本记录](web/upstream/UPSTREAM.md)。
@@ -0,0 +1,52 @@
1
+ // Raw Input notification only: never call GetRawInputData or inspect key payloads.
2
+ using System;
3
+ using System.Diagnostics;
4
+ using System.Runtime.InteropServices;
5
+ using System.Windows.Forms;
6
+
7
+ public sealed class KeyboardActivity : NativeWindow {
8
+ [StructLayout(LayoutKind.Sequential)]
9
+ struct Device { public ushort page, usage; public uint flags; public IntPtr target; }
10
+ [DllImport("user32.dll", SetLastError = true)]
11
+ static extern bool RegisterRawInputDevices(Device[] devices, uint count, uint size);
12
+ [DllImport("user32.dll", SetLastError = true)]
13
+ static extern IntPtr OpenInputDesktop(uint flags, bool inherit, uint access);
14
+ [DllImport("user32.dll")]
15
+ static extern bool CloseDesktop(IntPtr desktop);
16
+ readonly Stopwatch clock = Stopwatch.StartNew();
17
+ long last = -1;
18
+ protected override void WndProc(ref Message message) {
19
+ if (message.Msg == 0x00ff) last = clock.ElapsedMilliseconds;
20
+ // Includes required foreground raw-input cleanup, without dereferencing lParam.
21
+ base.WndProc(ref message);
22
+ }
23
+ [STAThread]
24
+ public static void Run(int parentPid) {
25
+ using (var parent = Process.GetProcessById(parentPid)) {
26
+ var window = new KeyboardActivity();
27
+ // Message-only window; never takes focus or suppresses normal keyboard input.
28
+ window.CreateHandle(new CreateParams { Parent = new IntPtr(-3) });
29
+ var devices = new[] { new Device { page = 1, usage = 6, flags = 0x100, target = window.Handle } };
30
+ if (!RegisterRawInputDevices(devices, 1, (uint)Marshal.SizeOf(typeof(Device)))) {
31
+ window.DestroyHandle(); throw new InvalidOperationException();
32
+ }
33
+ using (var timer = new Timer { Interval = 500 }) {
34
+ timer.Tick += delegate {
35
+ if (parent.HasExited) { Application.ExitThread(); return; }
36
+ var desktop = OpenInputDesktop(0, false, 1);
37
+ bool available = desktop != IntPtr.Zero && Environment.UserInteractive && !SystemInformation.TerminalServerSession;
38
+ if (desktop != IntPtr.Zero) CloseDesktop(desktop);
39
+ // A fresh registration needs an observation window before claiming idle.
40
+ string state = !available || window.clock.ElapsedMilliseconds < 1500 ? "unknown"
41
+ : window.last >= 0 && window.clock.ElapsedMilliseconds - window.last < 1500 ? "active" : "idle";
42
+ Console.Out.WriteLine(state); Console.Out.Flush();
43
+ };
44
+ try { timer.Start(); Application.Run(); }
45
+ finally {
46
+ RegisterRawInputDevices(new[] { new Device { page = 1, usage = 6, flags = 1, target = IntPtr.Zero } }, 1, (uint)Marshal.SizeOf(typeof(Device)));
47
+ window.DestroyHandle();
48
+ }
49
+ }
50
+ }
51
+ }
52
+ }
@@ -0,0 +1,77 @@
1
+ """XInput2 event category only. Never fetch cookie data, key codes or key maps."""
2
+ import ctypes as C
3
+ import os
4
+ import select
5
+ import sys
6
+ import time
7
+
8
+
9
+ def run():
10
+ if os.environ.get('WAYLAND_DISPLAY') or os.environ.get('XDG_SESSION_TYPE', '').lower() == 'wayland' or not os.environ.get('DISPLAY'):
11
+ raise RuntimeError()
12
+ x = C.CDLL('libX11.so.6')
13
+ xi = C.CDLL('libXi.so.6')
14
+ # Only the generic-event header is represented. The opaque payload is not fetched.
15
+ class Header(C.Structure):
16
+ _fields_ = [('type', C.c_int), ('serial', C.c_ulong), ('send_event', C.c_int),
17
+ ('display', C.c_void_p), ('extension', C.c_int), ('evtype', C.c_int)]
18
+ class Event(C.Union):
19
+ _fields_ = [('header', Header), ('padding', C.c_long * 24)]
20
+ class Mask(C.Structure):
21
+ _fields_ = [('deviceid', C.c_int), ('mask_len', C.c_int), ('mask', C.POINTER(C.c_ubyte))]
22
+ x.XOpenDisplay.argtypes = [C.c_char_p]; x.XOpenDisplay.restype = C.c_void_p
23
+ x.XDefaultRootWindow.argtypes = [C.c_void_p]; x.XDefaultRootWindow.restype = C.c_ulong
24
+ x.XQueryExtension.argtypes = [C.c_void_p, C.c_char_p, C.POINTER(C.c_int), C.POINTER(C.c_int), C.POINTER(C.c_int)]
25
+ x.XConnectionNumber.argtypes = [C.c_void_p]; x.XConnectionNumber.restype = C.c_int
26
+ x.XPending.argtypes = [C.c_void_p]
27
+ x.XNextEvent.argtypes = [C.c_void_p, C.POINTER(Event)]
28
+ x.XFlush.argtypes = [C.c_void_p]
29
+ x.XCloseDisplay.argtypes = [C.c_void_p]
30
+ xi.XIQueryVersion.argtypes = [C.c_void_p, C.POINTER(C.c_int), C.POINTER(C.c_int)]
31
+ xi.XISelectEvents.argtypes = [C.c_void_p, C.c_ulong, C.POINTER(Mask), C.c_int]
32
+ display = x.XOpenDisplay(None)
33
+ if not display:
34
+ raise RuntimeError()
35
+ try:
36
+ opcode, first, error = C.c_int(), C.c_int(), C.c_int()
37
+ if x.XQueryExtension(display, b'XWAYLAND', C.byref(opcode), C.byref(first), C.byref(error)):
38
+ raise RuntimeError()
39
+ if not x.XQueryExtension(display, b'XInputExtension', C.byref(opcode), C.byref(first), C.byref(error)):
40
+ raise RuntimeError()
41
+ major, minor = C.c_int(2), C.c_int(1)
42
+ if xi.XIQueryVersion(display, C.byref(major), C.byref(minor)) != 0 or (major.value, minor.value) < (2, 1):
43
+ raise RuntimeError()
44
+ bits = (C.c_ubyte * 2)()
45
+ for kind in (13, 14): # XI_RawKeyPress / XI_RawKeyRelease, not key identifiers.
46
+ bits[kind >> 3] |= 1 << (kind & 7)
47
+ mask = Mask(1, 2, bits) # XIAllMasterDevices; avoid duplicate slave notifications.
48
+ if xi.XISelectEvents(display, x.XDefaultRootWindow(display), C.byref(mask), 1) != 0:
49
+ raise RuntimeError()
50
+ x.XFlush(display)
51
+ fd, parent = x.XConnectionNumber(display), os.getppid()
52
+ started, last, due = time.monotonic(), None, time.monotonic()
53
+ event = Event()
54
+ while parent > 1 and os.getppid() == parent:
55
+ # Bound each drain so an input flood cannot starve heartbeats or termination.
56
+ for _ in range(256):
57
+ if not x.XPending(display):
58
+ break
59
+ x.XNextEvent(display, C.byref(event))
60
+ h = event.header
61
+ if h.type == 35 and h.extension == opcode.value and h.evtype in (13, 14):
62
+ last = time.monotonic()
63
+ now = time.monotonic()
64
+ if now >= due:
65
+ print('unknown' if now - started < 1.5 else 'active' if last is not None and now - last < 1.5 else 'idle', flush=True)
66
+ due = now + .5
67
+ select.select([fd], [], [], max(0, due - time.monotonic()))
68
+ finally:
69
+ x.XCloseDisplay(display)
70
+
71
+
72
+ if __name__ == '__main__':
73
+ try:
74
+ run()
75
+ except Exception:
76
+ print('unknown', flush=True)
77
+ sys.exit(1)
@@ -0,0 +1,54 @@
1
+ const { spawn } = require('node:child_process');
2
+ const { join, win32 } = require('node:path');
3
+ const STATES = new Set(['active', 'idle', 'unknown']);
4
+ const BACKENDS = { darwin: 'macos', win32: 'windows', linux: 'x11' };
5
+ // Helpers reduce input to a bounded enum stream before it reaches Electron.
6
+ exports.createKeyboardActivity = ({ platform = process.platform, env = process.env, start = spawn, now = () => performance.now() } = {}) => {
7
+ let child, value = 'unknown', at = -Infinity, pending = '', enabled = false, status = 'disabled', startedAt = 0;
8
+ const backend = BACKENDS[platform] ?? 'none';
9
+ const stop = reason => {
10
+ const old = child; child = undefined; value = 'unknown'; at = -Infinity; pending = ''; status = reason; old?.kill();
11
+ };
12
+ function inspect() {
13
+ if (child && status === 'starting' && now() - startedAt > 15000) stop('failed');
14
+ const stale = ['available', 'unavailable'].includes(status) && now() - at > 2500;
15
+ return { value: stale ? 'unknown' : value, backend, status: stale ? 'stale' : status };
16
+ }
17
+ return {
18
+ configure(on) {
19
+ if (!on) { enabled = false; stop('disabled'); return; }
20
+ if (enabled) return; // No restart storm: disable/re-enable retries a failed helper.
21
+ enabled = true;
22
+ if (backend === 'none') { status = 'unsupported-platform'; return; }
23
+ if (platform === 'linux' && (env.WAYLAND_DISPLAY || env.XDG_SESSION_TYPE?.toLowerCase() === 'wayland' || !env.DISPLAY)) { status = 'unsupported-session'; return; }
24
+ let command, args;
25
+ if (platform === 'darwin') { command = '/usr/bin/osascript'; args = ['-l', 'JavaScript', join(__dirname, 'keyboard-activity.jxa')]; }
26
+ else if (platform === 'win32') {
27
+ if (!env.SystemRoot || !win32.isAbsolute(env.SystemRoot)) { status = 'missing-dependency'; return; }
28
+ command = win32.join(env.SystemRoot, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
29
+ const source = join(__dirname, 'keyboard-activity-win.cs').replace(/'/g, "''");
30
+ args = ['-NoLogo', '-NoProfile', '-STA', '-NonInteractive', '-WindowStyle', 'Hidden', '-Command', `$ErrorActionPreference='Stop'; try { Add-Type -Path '${source}' -ReferencedAssemblies System.Windows.Forms; [KeyboardActivity]::Run(${process.pid}) } catch { [Console]::Out.WriteLine('unknown'); exit 1 }`];
31
+ } else { command = '/usr/bin/python3'; args = ['-I', '-u', join(__dirname, 'keyboard-activity-x11.py')]; }
32
+ status = 'starting'; startedAt = now();
33
+ let next;
34
+ try { next = start(command, args, { stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true }); }
35
+ catch (error) { stop(error.code === 'ENOENT' ? 'missing-dependency' : 'failed'); return; }
36
+ child = next;
37
+ next.stdout.on('data', bytes => {
38
+ if (child !== next) return;
39
+ pending += bytes.toString();
40
+ if (pending.length > 256) { stop('protocol-error'); return; }
41
+ let index;
42
+ while ((index = pending.indexOf('\n')) >= 0) {
43
+ const line = pending.slice(0, index).replace(/\r$/, ''); pending = pending.slice(index + 1);
44
+ if (!STATES.has(line)) { stop('protocol-error'); return; }
45
+ value = line; at = now(); status = line === 'unknown' ? 'unavailable' : 'available';
46
+ }
47
+ });
48
+ next.on('error', error => { if (child === next) stop(error.code === 'ENOENT' ? 'missing-dependency' : 'failed'); });
49
+ next.on('exit', () => { if (child === next) stop('failed'); });
50
+ },
51
+ sample() { return inspect().value; },
52
+ inspect,
53
+ };
54
+ };
@@ -0,0 +1,27 @@
1
+ // Query only aggregate event ages; event-listening authorization is a separate API.
2
+ // No event tap, event objects, key codes, text or combined mouse/keyboard idle time.
3
+ ObjC.import('Foundation');
4
+ ObjC.bindFunction('CGEventSourceSecondsSinceLastEventType', ['double', ['int', 'unsigned int']]);
5
+ ObjC.bindFunction('getppid', ['int', []]);
6
+ ObjC.bindFunction('puts', ['int', ['char *']]);
7
+ ObjC.bindFunction('fflush', ['int', ['void *']]);
8
+ ObjC.bindFunction('usleep', ['int', ['unsigned int']]);
9
+ var combinedSessionState = 0, keyDown = 10, keyUp = 11;
10
+ function sample() {
11
+ try {
12
+ var down = $.CGEventSourceSecondsSinceLastEventType(combinedSessionState, keyDown);
13
+ var up = $.CGEventSourceSecondsSinceLastEventType(combinedSessionState, keyUp);
14
+ // Reject API sentinels as well as negative/nonfinite results (not false idle).
15
+ if (!isFinite(down) || !isFinite(up) || down < 0 || up < 0 || down >= 1e10 || up >= 1e10) return 'unknown';
16
+ return Math.min(down, up) < 1.5 ? 'active' : 'idle';
17
+ } catch (_) { return 'unknown'; }
18
+ }
19
+ function run(args) {
20
+ if (args[0] === '--once') return sample();
21
+ var parent = $.getppid();
22
+ while (parent > 1 && $.getppid() === parent) {
23
+ $.puts(sample());
24
+ $.fflush(null);
25
+ $.usleep(500000);
26
+ }
27
+ }
@@ -0,0 +1,16 @@
1
+ // Inspect only three aggregate flags; never unwrap or emit the session identity dictionary.
2
+ ObjC.import('CoreGraphics');
3
+ var state = 'unknown';
4
+ try {
5
+ var session = ObjC.castRefToObject($.CGSessionCopyCurrentDictionary());
6
+ function flag(key) {
7
+ try {
8
+ var value = ObjC.unwrap(session.objectForKey($(key)));
9
+ return value === true || value === 1 ? true : value === false || value === 0 ? false : value === undefined || value === null ? null : 'unknown';
10
+ } catch (_) { return 'unknown'; }
11
+ }
12
+ var locked = flag('CGSSessionScreenIsLocked');
13
+ if (locked === true) state = 'locked';
14
+ else if ((locked === false || locked === null) && flag('kCGSessionOnConsoleKey') === true && flag('kCGSessionLoginDoneKey') === true) state = 'unlocked';
15
+ } catch (_) {}
16
+ state;
@@ -0,0 +1,21 @@
1
+ const { execFileSync } = require('node:child_process');
2
+ const { join } = require('node:path');
3
+
4
+ /** Aggregate session state only; unavailable adapters never imply an unlocked desktop. */
5
+ function initialLockState({ platform = process.platform, env = process.env, monitor, run = execFileSync } = {}) {
6
+ // Native regression profiles explicitly control their desktop lifecycle.
7
+ if (env.DSH_PET_TEST_NO_SANDBOX === '1') {
8
+ const value = env.DSH_PET_TEST_INITIAL_LOCK_STATE ?? 'unlocked';
9
+ if (value !== 'system') return ['locked', 'unlocked', 'unknown'].includes(value) ? value : 'unknown';
10
+ }
11
+ try {
12
+ if (platform === 'darwin') {
13
+ const value = run('/usr/bin/osascript', ['-l', 'JavaScript', join(__dirname, 'lifecycle-state-macos.jxa')],
14
+ { encoding: 'utf8', timeout: 1500, maxBuffer: 128, stdio: ['ignore', 'pipe', 'ignore'] }).trim();
15
+ return ['locked', 'unlocked'].includes(value) ? value : 'unknown';
16
+ }
17
+ const value = monitor?.getSystemIdleState(1);
18
+ return value === 'locked' ? 'locked' : ['active', 'idle'].includes(value) ? 'unlocked' : 'unknown';
19
+ } catch { return 'unknown'; }
20
+ }
21
+ module.exports = { initialLockState };