dsh-mnemon 0.5.30 → 0.5.32

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 (31) hide show
  1. package/README.md +12 -12
  2. package/README.zh-CN.md +12 -12
  3. package/SECURITY.md +4 -4
  4. package/lib/bundle.js +1 -1
  5. package/lib/client.js +4021 -3355
  6. package/lib/contracts.js +3 -1
  7. package/lib/core.js +1 -1
  8. package/lib/{definitions-j9QPbrXb.js → definitions-DU7MLBhu.js} +3 -1
  9. package/lib/extension-sdk.js +2 -2
  10. package/lib/index.js +11049 -10764
  11. package/lib/{runtime-Bk6lFgxd.js → runtime-zuuBe8x1.js} +1 -1
  12. package/lib/{starter-resolution-CKedUNe4.js → starter-resolution-DoFp9FLr.js} +5 -5
  13. package/lib/starter.js +1 -1
  14. package/lib/{strategy-configuration-sVkKToSW.js → strategy-configuration-CLHxaPOb.js} +1 -1
  15. package/lib/testing.js +2 -2
  16. package/lib/types/src/client/GlobalLocationSetting.d.ts +19 -0
  17. package/lib/types/src/client/component-ui.d.ts +68 -0
  18. package/lib/types/src/client/extension-sdk.d.ts +5 -1
  19. package/lib/types/src/client/feedback.d.ts +65 -0
  20. package/lib/types/src/client/locales.d.ts +130 -127
  21. package/lib/types/src/client/page-controls.d.ts +7 -0
  22. package/lib/types/src/client/settings-controls.d.ts +66 -0
  23. package/lib/types/src/client/settings-panel.d.ts +58 -0
  24. package/lib/types/src/client/ui-icons.d.ts +0 -1
  25. package/lib/types/src/core/contracts/view.d.ts +9 -0
  26. package/lib/types/src/host/config-values.d.ts +1 -1
  27. package/lib/types/src/host/memory-tools.d.ts +139 -0
  28. package/lib/types/src/host/protocol.d.ts +112 -24
  29. package/lib/types/src/host/starter-components.d.ts +20 -0
  30. package/lib/types/src/host/sync-rules.d.ts +30 -0
  31. package/package.json +45 -45
package/README.md CHANGED
@@ -17,13 +17,13 @@
17
17
 
18
18
  <p align="center">
19
19
  <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/ui-guide.md#in-a-conversation">
20
- <img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.19/en/recall.gif" alt="A question answered from working memory, Project Documents and Memory Spaces; the expanded turn memory bar opens the document it read in Project Documents" width="880" />
20
+ <img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.32/en/recall.gif" alt="A question answered from working memory and Project Documents; the expanded turn memory bar opens the document it read in Project Documents" width="880" />
21
21
  </a>
22
22
  </p>
23
23
 
24
24
  <p align="center">
25
25
  <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/installation.md"><strong>Install and start</strong></a> ·
26
- <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/webui-v0.5.19/README.md">Watch the demo</a> ·
26
+ <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/webui-v0.5.32/README.md">Watch the demo</a> ·
27
27
  <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/README.md">Documentation</a> ·
28
28
  <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/development/extensions.md">Build a plugin</a>
29
29
  </p>
@@ -36,7 +36,7 @@ An Agent that starts every session from scratch keeps asking what it was already
36
36
  - **You can see what a turn used.** Under each reply, the turn memory bar lists the documents and memories the turn read and wrote, and one click opens each in the Memory System. The Memory System shows everything that is stored and lets you edit it.
37
37
  - **Save to memory in one click.** When a conversation turns up a fact worth keeping, the brain mark under the reply hands it to a task Agent, which removes duplicates, distils it and writes it to the right Memory Space, or saves it where you choose: working memory, your profile or a Memory Space. The receipt says where it went.
38
38
  - **Compose it on the Plugins page.** Choose a main strategy and optional enhancements, and switch them without moving any data. Every component has its own page for its settings.
39
- - **Keep data where you want it.** Local by default with Mnemon Native, or one of eight third-party Providers. Storage can be global, per workspace or centralized, with ZIP backup.
39
+ - **Keep data where you want it.** Local by default with Mnemon Native, or one of eight third-party Providers. Storage can be global, per workspace, centralized or in a directory you choose, with ZIP backup.
40
40
  - **Extend it.** Sources and Strategies are ordinary DSH plugins built on public SDKs. An installed component gets the same pages and switches as the shipped ones.
41
41
 
42
42
  ## See it in action
@@ -46,22 +46,22 @@ These recordings come from a real WebUI with the live DeepSeek model answering,
46
46
  **Save a new fact to memory.** A reply reports a new measurement. Select the brain mark under it, cut the candidate down to the sentence worth keeping and send it to the task Agent; the receipt names the Memory Space it went to and opens it in one click.
47
47
 
48
48
  <p align="center">
49
- <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/ui-guide.md#save-to-memory"><img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.19/en/save.gif" alt="Save to memory: edit the candidate, send it to the task Agent, then view the new memory from the Saved receipt" width="880" /></a>
49
+ <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/ui-guide.md#save-to-memory"><img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.32/en/save.gif" alt="Save to memory: edit the candidate, look at where it can go and keep Let the Agent decide, send it to the task Agent, then view the new memory from the Saved receipt" width="880" /></a>
50
50
  </p>
51
51
 
52
52
  **See all memory in one place.** Status, runtime memory, Project Documents and Memory Spaces live in the Memory System. The graph links memories through the entities they mention, and Ask Agent answers with the memories it cites, by content.
53
53
 
54
54
  <p align="center">
55
- <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/ui-guide.md#the-memory-system"><img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.19/en/memory.gif" alt="The Memory System: status, runtime memory, a document, the Memory Spaces graph, then an Agent answer with citations" width="880" /></a>
55
+ <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/ui-guide.md#the-memory-system"><img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.32/en/memory.gif" alt="The Memory System: status, runtime memory, a document, the Memory Spaces graph, then an Agent answer with citations" width="880" /></a>
56
56
  </p>
57
57
 
58
58
  **Compose memory on the Plugins page.** One main strategy, its memory sources and optional enhancements, each switch applying at once. Every component has its own page, and storage, backup and interface settings live here too.
59
59
 
60
60
  <p align="center">
61
- <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/ui-guide.md#on-the-plugins-page"><img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.19/en/plugins.gif" alt="The Plugins page: memory composition, the main strategy menu, the Layered strategy's and Memory Spaces' pages, then storage and interface" width="880" /></a>
61
+ <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/ui-guide.md#on-the-plugins-page"><img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.32/en/plugins.gif" alt="DSH's Plugins page, then dsh-mnemon's page: memory composition, the main strategy menu, the Layered strategy's and Memory Spaces' pages, then storage and interface" width="880" /></a>
62
62
  </p>
63
63
 
64
- Every step is explained in the [UI guide](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/ui-guide.md); all screens, recordings and the capture environment are in the [v0.5.19 gallery](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/webui-v0.5.19/README.md).
64
+ Every step is explained in the [UI guide](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/ui-guide.md); all screens, recordings and the capture environment are in the [v0.5.32 gallery](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/webui-v0.5.32/README.md).
65
65
 
66
66
  ## Three kinds of memory
67
67
 
@@ -92,7 +92,7 @@ npx @deepseek-ai/dsh web
92
92
  4. For Memory Spaces, install the Mnemon CLI for Mnemon Native with `npm install --global @mnemon-dev/mnemon`, or enable another Provider on the Memory Spaces page.
93
93
  5. Choose the main strategy and enhancements under **Plugins → dsh-mnemon**.
94
94
 
95
- dsh-mnemon supports DSH `0.2.0-rc.2` (npm `latest` and `next`) and `0.1.7-rc.2`. The same package serves the desktop app's Plugins page, `dsh plugin --profile web add dsh-mnemon` on the command line, and Headless with `dsh plugin --profile headless add dsh-mnemon`; keep `v0.5.16` on older hosts. [Getting started](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/getting-started.md) continues from here, and [compatibility and upgrades](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/reference/compatibility.md) covers existing installations.
95
+ dsh-mnemon supports DSH `0.2.0-rc.2` (npm `latest`) and `0.2.1-rc.2` (npm `next`). The same package serves the desktop app's Plugins page, `dsh plugin --profile web add dsh-mnemon` on the command line, and Headless with `dsh plugin --profile headless add dsh-mnemon`; older hosts keep the release [compatibility and upgrades](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/reference/compatibility.md) names for them. [Getting started](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/getting-started.md) continues from here, and [compatibility and upgrades](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/reference/compatibility.md) covers existing installations.
96
96
 
97
97
  ## How it works
98
98
 
@@ -110,7 +110,7 @@ The Starter pins a tested combination of independently versioned packages. One m
110
110
 
111
111
  | Package | Role | Default |
112
112
  |---|---|---|
113
- | [dsh-mnemon-source-runtime](https://github.com/omdsh-dev/dsh-mnemon/blob/main/plugins/dsh-mnemon-source-runtime/README.md) | Runtime memory: USER.md, MEMORY.md, revisions and local hot storage | On |
113
+ | [dsh-mnemon-source-runtime](https://github.com/omdsh-dev/dsh-mnemon/blob/main/plugins/dsh-mnemon-source-runtime/README.md) | Runtime memory: USER.md, MEMORY.md, revisions and local storage | On |
114
114
  | [dsh-mnemon-source-documents](https://github.com/omdsh-dev/dsh-mnemon/blob/main/plugins/dsh-mnemon-source-documents/README.md) | Project Documents: Markdown, search, revisions and archiving | On |
115
115
  | [dsh-mnemon-source-memory-spaces](https://github.com/omdsh-dev/dsh-mnemon/blob/main/plugins/dsh-mnemon-source-memory-spaces/README.md) | Memory Spaces: durable evidence and their Providers | On |
116
116
  | [dsh-mnemon-strategy-default-three-tier](https://github.com/omdsh-dev/dsh-mnemon/blob/main/plugins/dsh-mnemon-strategy-default-three-tier/README.md) | Layered strategy: resident runtime memory, the rest on demand | Selected |
@@ -125,17 +125,17 @@ Memory Spaces Providers: [Mnemon Native](https://github.com/omdsh-dev/dsh-mnemon
125
125
 
126
126
  Define a Source or Strategy with `dsh-mnemon/extension-sdk`, add an enhancement through the standard slots, or write a Memory Spaces driver with `dsh-mnemon-source-memory-spaces/provider-sdk`. A component can also add its own settings and Status card to the pages dsh-mnemon shows. Your repository owns its manifest, dependencies, tests and build; DSH installs and mounts it, and choosing it as the main strategy is a separate decision.
127
127
 
128
- Start with the [plugin author guide](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/development/extensions.md). Discuss new capabilities and Providers in an Issue before a pull request; see [CONTRIBUTING](https://github.com/omdsh-dev/dsh-mnemon/blob/8466e3560a3b9de4e9f4b7302cbf005c84e8e69f/CONTRIBUTING.md).
128
+ Start with the [plugin author guide](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/development/extensions.md). Discuss new capabilities and Providers in an Issue before a pull request; see [CONTRIBUTING](https://github.com/omdsh-dev/dsh-mnemon/blob/main/CONTRIBUTING.md).
129
129
 
130
130
  ## Data and trust
131
131
 
132
132
  - Runtime memory and Project Documents are local files; Mnemon Native is local. Third-party Providers use their own services and scopes.
133
133
  - Turning a component off does not erase its memory, and changing the storage location does not move data. Use ZIP backup to carry it.
134
- - Git sync publishes the same Mnemon Pack payload to a repository you own, as readable files, so another machine can pull it. Connect a repository by signing in with GitHub (search, pick or create a private one; a public one asks first) or by its address, with a token field only for HTTPS. **Sync now** merges the repository into this machine and pushes the result, **Check remote** shows what a sync would change before anything is written, and **Automatic sync** repeats the same sync at an interval from an hour to a week. When the repository cannot be read, the row says why (credentials, not found, network or timeout) and how to fix it, and **Backup history** lists every machine's versions by time and computer. Both directions are refused where `writeEnabled` is false. Two machines that wrote one subject differently keep both wordings until **Reconcile** under **Memory reconciliation** proposes a plan, which arrives as a pending proposal to **Accept** and then **Apply**, or to annotate with an opinion first; a rejected plan has to be **reopened** before your words reach the next run. Reconciliation takes your own words as guidance, and an accepted plan is applied operation by operation, so you can take part of it.
134
+ - Git sync publishes the same Mnemon Pack payload as readable files to a repository you own, so another machine can pull it, with **Sync now**, **Check remote** before anything is written, or **Automatic sync**. When two machines wrote one subject differently, both wordings stay until you accept and apply a **Memory reconciliation** plan; see [Git repository sync](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/operations.md#git-repository-sync).
135
135
  - Saved Provider credentials stay on the Host and are never exported. Backups still contain private memory; protect them.
136
136
  - Sources and Strategies are trusted in-process JavaScript, not sandboxed code. Remembered history never outranks current instructions.
137
137
 
138
- [Backup and recovery](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/operations.md) · [Security policy](https://github.com/omdsh-dev/dsh-mnemon/blob/8466e3560a3b9de4e9f4b7302cbf005c84e8e69f/SECURITY.md) · [Release history](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/releases/README.md) · [Roadmap](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/roadmap.md)
138
+ [Backup and recovery](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/guides/operations.md) · [Security policy](https://github.com/omdsh-dev/dsh-mnemon/blob/main/SECURITY.md) · [Release history](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/releases/README.md) · [Roadmap](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/roadmap.md)
139
139
 
140
140
  ## Develop and verify
141
141
 
package/README.zh-CN.md CHANGED
@@ -18,13 +18,13 @@
18
18
 
19
19
  <p align="center">
20
20
  <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/ui-guide.md#在对话中">
21
- <img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.19/zh-CN/recall.gif" alt="提问后,回答同时用到工作记忆、项目档案与记忆空间;展开回合记忆栏,点击读到的档案,直接在项目档案中打开它" width="880" />
21
+ <img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.32/zh-CN/recall.gif" alt="提问后,回答用到工作记忆、项目档案与记忆空间;展开回合记忆栏,点击读到的档案,直接在项目档案中打开它" width="880" />
22
22
  </a>
23
23
  </p>
24
24
 
25
25
  <p align="center">
26
26
  <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/installation.md"><strong>安装与启动</strong></a> ·
27
- <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/webui-v0.5.19/README.md">观看演示</a> ·
27
+ <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/webui-v0.5.32/README.md">观看演示</a> ·
28
28
  <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/README.md">文档中心</a> ·
29
29
  <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/development/extensions.md">制作插件</a>
30
30
  </p>
@@ -37,7 +37,7 @@
37
37
  - **看得见这一轮用了什么。** 每条回复下方的回合记忆栏列出这一轮读到和写入的档案与记忆,点一下就在记忆系统中打开它;记忆系统展示全部已保存的内容,并可直接编辑。
38
38
  - **一键存入记忆。** 对话里出现值得保留的事实,点击回复下的脑形图标,由任务 Agent 去重、提炼并写入合适的记忆空间,也可以直接存到你选择的位置:工作记忆、用户画像或某个记忆空间。回执写明存到了哪里。
39
39
  - **在插件页组合。** 选择一个主策略和若干可选增强,切换时无需迁移任何数据;每个组件都有自己的设置页。
40
- - **数据放在你想放的地方。** 默认由 Mnemon Native 在本地保存,也可以接入八种第三方 Provider;存储范围可选全局、按工作区或集中存储,并支持 ZIP 备份。
40
+ - **数据放在你想放的地方。** 默认由 Mnemon Native 在本地保存,也可以接入八种第三方 Provider;存储范围可选全局、按工作区、集中存储或你指定的目录,并支持 ZIP 备份。
41
41
  - **可以扩展。** Source 与 Strategy 都是基于公开 SDK 的普通 DSH 插件;安装的组件与随附组件拥有同样的页面和开关。
42
42
 
43
43
  ## 看看实际效果
@@ -47,22 +47,22 @@
47
47
  **把新事实存进记忆。** 回复中出现了新的测量结果:点击回复下的脑形图标,把候选内容改成要记住的那一句,交给任务 Agent;回执写明存进了哪个记忆空间,一键即可查看。
48
48
 
49
49
  <p align="center">
50
- <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/ui-guide.md#存入记忆"><img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.19/zh-CN/save.gif" alt="存入记忆:编辑候选内容,交给任务 Agent,收到已存入的回执后在记忆空间中查看新记忆" width="880" /></a>
50
+ <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/ui-guide.md#存入记忆"><img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.32/zh-CN/save.gif" alt="存入记忆:编辑候选内容,查看可以存到哪里并保留“由 Agent 决定”,交给任务 Agent,收到已存入的回执后在记忆空间中查看新记忆" width="880" /></a>
51
51
  </p>
52
52
 
53
53
  **在一处查看全部记忆。** 状态、运行时记忆、项目档案与记忆空间集中在记忆系统中;图谱按实体把记忆连接起来,Agent 查询给出按内容引用记忆的回答。
54
54
 
55
55
  <p align="center">
56
- <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/ui-guide.md#记忆系统"><img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.19/zh-CN/memory.gif" alt="记忆系统:依次查看状态、运行时记忆、项目档案、记忆空间图谱,再用 Agent 查询得到带引用的回答" width="880" /></a>
56
+ <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/ui-guide.md#记忆系统"><img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.32/zh-CN/memory.gif" alt="记忆系统:依次查看状态、运行时记忆、项目档案、记忆空间图谱,再用 Agent 查询得到带引用的回答" width="880" /></a>
57
57
  </p>
58
58
 
59
59
  **在插件页组合记忆。** 一个主策略、它的记忆来源与可选增强,每个开关即时生效;每个组件都有自己的页面,存储、备份与界面设置也在这里。
60
60
 
61
61
  <p align="center">
62
- <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/ui-guide.md#在插件页中"><img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.19/zh-CN/plugins.gif" alt="插件页:记忆组合、主策略菜单、分层策略与记忆空间的组件页,以及存储与界面" width="880" /></a>
62
+ <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/ui-guide.md#在插件页中"><img src="https://raw.githubusercontent.com/omdsh-dev/dsh-mnemon/main/docs/assets/webui-v0.5.32/zh-CN/plugins.gif" alt="DSH 的插件页,再进入可组合记忆的页面:记忆组合、主策略菜单、分层策略与记忆空间的组件页,以及存储与界面" width="880" /></a>
63
63
  </p>
64
64
 
65
- 更多画面与每一步的说明见[界面指南](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/ui-guide.md),全部截图、录屏与采集环境见 [v0.5.19 图集](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/webui-v0.5.19/README.md)。
65
+ 更多画面与每一步的说明见[界面指南](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/ui-guide.md),全部截图、录屏与采集环境见 [v0.5.32 图集](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/assets/webui-v0.5.32/README.md)。
66
66
 
67
67
  ## 三类记忆
68
68
 
@@ -93,7 +93,7 @@ npx @deepseek-ai/dsh web
93
93
  4. 使用记忆空间时,可用 `npm install --global @mnemon-dev/mnemon` 安装 Mnemon Native 所需的 CLI,或在记忆空间页面启用其他 Provider。
94
94
  5. 在**插件 → 可组合记忆**中选择主策略与增强。
95
95
 
96
- dsh-mnemon 支持 DSH `0.2.0-rc.2`(npm `latest` 与 `next`)与 `0.1.7-rc.2`。同一个包也用于桌面版的插件页、命令行 `dsh plugin --profile web add dsh-mnemon`,以及 Headless:`dsh plugin --profile headless add dsh-mnemon`;更早的宿主请继续使用 `v0.5.16`。接下来可以看[快速开始](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/getting-started.md),已有安装的升级见[兼容性与升级](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/reference/compatibility.md)。
96
+ dsh-mnemon 支持 DSH `0.2.0-rc.2`(npm `latest`)与 `0.2.1-rc.2`(npm `next`)。同一个包也用于桌面版的插件页、命令行 `dsh plugin --profile web add dsh-mnemon`,以及 Headless:`dsh plugin --profile headless add dsh-mnemon`;更早的宿主请继续使用[兼容性与升级](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/reference/compatibility.md)为其列出的版本。接下来可以看[入门指南](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/getting-started.md),已有安装的升级见[兼容性与升级](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/reference/compatibility.md)。
97
97
 
98
98
  ## 工作原理
99
99
 
@@ -111,7 +111,7 @@ Starter 固定一组经过测试、各自独立版本的包。同一时间只运
111
111
 
112
112
  | 包 | 作用 | 默认 |
113
113
  |---|---|---|
114
- | [dsh-mnemon-source-runtime](https://github.com/omdsh-dev/dsh-mnemon/blob/main/plugins/dsh-mnemon-source-runtime/README.md) | 运行时记忆:USER.md、MEMORY.md、修订与本地热存储 | 开启 |
114
+ | [dsh-mnemon-source-runtime](https://github.com/omdsh-dev/dsh-mnemon/blob/main/plugins/dsh-mnemon-source-runtime/README.md) | 运行时记忆:USER.md、MEMORY.md、修订与本地存储 | 开启 |
115
115
  | [dsh-mnemon-source-documents](https://github.com/omdsh-dev/dsh-mnemon/blob/main/plugins/dsh-mnemon-source-documents/README.md) | 项目档案:Markdown、检索、修订与归档 | 开启 |
116
116
  | [dsh-mnemon-source-memory-spaces](https://github.com/omdsh-dev/dsh-mnemon/blob/main/plugins/dsh-mnemon-source-memory-spaces/README.md) | 记忆空间:长期证据及其 Provider | 开启 |
117
117
  | [dsh-mnemon-strategy-default-three-tier](https://github.com/omdsh-dev/dsh-mnemon/blob/main/plugins/dsh-mnemon-strategy-default-three-tier/README.md) | 分层策略:运行时记忆常驻,其余按需读取 | 选中 |
@@ -126,17 +126,17 @@ Starter 固定一组经过测试、各自独立版本的包。同一时间只运
126
126
 
127
127
  用 `dsh-mnemon/extension-sdk` 定义 Source 或 Strategy,通过标准插槽编写增强,或用 `dsh-mnemon-source-memory-spaces/provider-sdk` 编写记忆空间驱动。组件还可以把自己的设置和状态卡片加入 dsh-mnemon 的页面。你的仓库自己负责清单、依赖、测试与构建;DSH 负责安装和挂载,是否把它选为主策略是另一个独立决定。
128
128
 
129
- 从[插件开发指南](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/development/extensions.md)开始。新能力与新 Provider 请先在 Issue 中讨论,再提交 PR,详见 [CONTRIBUTING](https://github.com/omdsh-dev/dsh-mnemon/blob/8466e3560a3b9de4e9f4b7302cbf005c84e8e69f/CONTRIBUTING.zh-CN.md)。
129
+ 从[插件开发指南](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/development/extensions.md)开始。新能力与新 Provider 请先在 Issue 中讨论,再提交 PR,详见 [CONTRIBUTING](https://github.com/omdsh-dev/dsh-mnemon/blob/main/CONTRIBUTING.zh-CN.md)。
130
130
 
131
131
  ## 数据与信任
132
132
 
133
133
  - 运行时记忆与项目档案是本地文件,Mnemon Native 也在本地;第三方 Provider 使用各自的服务与作用域。
134
134
  - 关闭组件不会删除其中的记忆,更换存储位置也不会搬移数据;需要迁移时使用 ZIP 备份。
135
- - Git 同步把同一份 Mnemon Pack 载荷以可读文件发布到你自己的仓库,另一台机器可以拉取。可以用 GitHub 登录连接仓库(搜索、选择或新建私有仓库,选择公开仓库前会先确认),也可以填写地址,只有 HTTPS 地址才需要访问令牌。**立即同步**先把仓库合并到本机,再推送结果;**检查远端**在写入任何内容之前说明一次同步会带来什么;**自动同步**按一小时到一周的间隔重复同样的同步。读不到仓库时,这一行会说明原因(凭据、找不到、网络或超时)以及如何修正;**备份历史**按时间与设备列出每台机器的版本。`writeEnabled=false` 时两个方向都会被拒绝。两台设备对同一主题写法不同时,两种写法都会保留,直到**记忆整理**里的**整理记忆**给出方案;方案以待审查建议出现,可以**接受**后**执行**,也可以先留下意见——已拒绝的方案要先**重新打开**,你的意见才会进入下一次整理。整理记忆可以填写你的要求,已接受的方案可以逐条勾选执行,因此可以只采纳其中一部分。
135
+ - Git 同步把同一份 Mnemon Pack 载荷以可读文件发布到你自己的仓库,另一台机器可以拉取;可以**立即同步**、在写入前**检查远端**,或按间隔**自动同步**。两台设备对同一主题写法不同时,两种写法都会保留,直到你接受并执行**记忆整理**给出的方案,见 [Git 仓库同步](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/operations.md#git-仓库同步)。
136
136
  - 已保存的 Provider 凭据只留在宿主上,不会被导出;但备份仍包含私有记忆,请妥善保护。
137
137
  - Source 与 Strategy 是受信任的进程内 JavaScript,**不是沙箱代码**;历史记忆永远不会凌驾于当前指令之上。
138
138
 
139
- [备份与恢复](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/operations.md) · [安全策略](https://github.com/omdsh-dev/dsh-mnemon/blob/8466e3560a3b9de4e9f4b7302cbf005c84e8e69f/SECURITY.md) · [版本历史](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/releases/README.md) · [路线图](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/roadmap.md)
139
+ [备份与恢复](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/guides/operations.md) · [安全策略](https://github.com/omdsh-dev/dsh-mnemon/blob/main/SECURITY.md) · [版本历史](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/releases/README.md) · [路线图](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/roadmap.md)
140
140
 
141
141
  ## 开发与验证
142
142
 
package/SECURITY.md CHANGED
@@ -9,7 +9,7 @@
9
9
  | Latest stable `dsh-mnemon` Starter and its pinned official plugins | Security fixes |
10
10
  | Older releases | Upgrade to the latest stable Starter |
11
11
 
12
- Only the latest stable release receives security fixes. Official Source, Strategy and Provider packages in this repository are in scope even when published independently; report both the Starter version and the affected package version. The Starter pins a tested combination. See the verified Host and runtime baselines in [Compatibility](./docs/en/reference/compatibility.md).
12
+ Only the latest stable release receives security fixes. Official Source, Strategy and Provider packages in this repository are in scope even when published independently; report both the Starter version and the affected package version. The Starter pins a tested combination. See the verified Host and runtime baselines in [Compatibility](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/reference/compatibility.md).
13
13
 
14
14
  ## Reporting a vulnerability
15
15
 
@@ -66,7 +66,7 @@ Out of scope:
66
66
  | 最新稳定版 `dsh-mnemon` Starter 及其固定的官方插件组合 | 提供安全修复 |
67
67
  | 较旧版本 | 升级到最新稳定版 Starter |
68
68
 
69
- 仅最新稳定版本获得安全修复。本仓库的官方 Source、Strategy 和 Provider 包即使独立发布,也属于报告范围;请同时提供 Starter 与受影响包的版本。Starter 固定经过验证的组合,已验证的宿主和运行环境见[兼容性说明](./docs/zh-CN/reference/compatibility.md)。
69
+ 仅最新稳定版本获得安全修复。本仓库的官方 Source、Strategy 和 Provider 包即使独立发布,也属于报告范围;请同时提供 Starter 与受影响包的版本。Starter 固定经过验证的组合,已验证的宿主和运行环境见[兼容性说明](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/reference/compatibility.md)。
70
70
 
71
71
  ### 报告漏洞
72
72
 
@@ -90,7 +90,7 @@ Out of scope:
90
90
 
91
91
  ### 已知限制
92
92
 
93
- - 当前没有确定性的凭据/秘密检测,请勿向热记忆、Documents 或 Memory Spaces 写入密钥、token、私钥。
93
+ - 当前没有确定性的凭据/秘密检测,请勿向运行时记忆、项目档案或记忆空间写入密钥、token、私钥。
94
94
  - Cordis isolate 提供生命周期所有权和作用域组合,不是安全沙箱。Source、其内部 Provider 与 Strategy 都是在 DSH Host 进程执行的普通 JavaScript,只能安装受信任来源的扩展。
95
95
  - 模型生成的 Strategy 源码不会自动执行。manifest、限定范围的 grant、replay 与 Core/Host 校验可以降低意外越权,但无法让恶意同进程代码变安全。
96
- - Runtime Memory 与 Documents 为本地存储,Mnemon Native 默认本地;显式启用的三方 Provider 可能按配置 endpoint 与凭据发起网络调用或本地进程调用,并向对应服务暴露数据。
96
+ - 运行时记忆与项目档案为本地存储,Mnemon Native 默认本地;显式启用的三方 Provider 可能按配置 endpoint 与凭据发起网络调用或本地进程调用,并向对应服务暴露数据。
package/lib/bundle.js CHANGED
@@ -1,4 +1,4 @@
1
- import { t as prepareStarterResolution } from "./starter-resolution-CKedUNe4.js";
1
+ import { t as prepareStarterResolution } from "./starter-resolution-DoFp9FLr.js";
2
2
  //#region src/bundle.ts
3
3
  const groupKey = Symbol.for("cordis.group");
4
4
  const init = Symbol.for("cordis.init");