magpie-ducoro 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.
package/README.md CHANGED
@@ -1,15 +1,50 @@
1
- # Magpie-Ducoro-Plugin
1
+ # magpie-ducoro 0.4.10
2
2
 
3
- **English** | [简体中文](README.zh-CN.md)
3
+ **English** | [简体中文](https://github.com/YE4IM/magpie-ducoro/blob/main/README.zh-CN.md)
4
4
 
5
- ## Ducoro 0.4.9
6
-
7
- Version 0.4.9 publishes the plugin to the npm registry as [`magpie-ducoro`](https://www.npmjs.com/package/magpie-ducoro) and fixes the packaged `bin` entry so the `magpie-ducoro-status` diagnostic command works after an npm install. Synchronization logic is unchanged from 0.4.8. See the [release notes](docs/RELEASE-NOTES.md).
5
+ Version 0.4.10 improves the npm installation guide, first-use steps and compatibility notes. Synchronization behavior and management record formats are unchanged from 0.4.9. The npm package is [`magpie-ducoro`](https://www.npmjs.com/package/magpie-ducoro).
8
6
 
9
7
  Sync Magpie models, connectors, skills, instructions and explicitly selected subagents to Ducoro, and manage per-Bot assignments from the plugin page. Changes go through previews with confirmation before saving; failures are recorded by category with per-item retry; verification distinguishes saved settings, written configuration, readback and session loading.
10
8
 
11
9
  Full history: [CHANGELOG.md](docs/CHANGELOG.md) · Release notes: [RELEASE-NOTES.md](docs/RELEASE-NOTES.md).
12
10
 
11
+ ## Requirements
12
+
13
+ - [Magpie](https://usemagpie.ai) with support for plugin agents and page services (`magpie.agent` and `magpie.page.service`).
14
+ - [Ducoro](https://ducoro.ai) installed and signed in, with its background service running. Install its [CLI](https://ducoro.ai/download/cli) and make `ducoro-cli` available on the PATH used to launch Magpie.
15
+ - Access to the local Ducoro device and the Bots to manage. The plugin's page service uses `127.0.0.1:3487` by default; choose another `servicePort` if that port is occupied.
16
+
17
+ The plugin does not install Ducoro or its CLI. Exact minimum Magpie and Ducoro versions have not been established. This documentation release does not claim new end-to-end synchronization verification or Windows/Linux compatibility; confirm the CLI and page-service support on your platform before use.
18
+
19
+ ## Installation
20
+
21
+ In Magpie, open **Plugins → Add a plugin** and enter `magpie-ducoro@0.4.10`. Alternatively, use Magpie's CLI:
22
+
23
+ ```sh
24
+ magpie plugin add magpie-ducoro@0.4.10
25
+ ```
26
+
27
+ `npm install magpie-ducoro` downloads the package into an npm project; it does not register the plugin with Magpie. Use the Magpie command or plugin dialog above for normal installation.
28
+
29
+ For a source installation, download a version from [GitHub Releases](https://github.com/YE4IM/magpie-ducoro/releases), extract it and add its absolute folder path to Magpie. A GitHub version can also be added as `github:YE4IM/magpie-ducoro#v0.4.9`; that tag contains the same synchronization implementation as this documentation patch.
30
+
31
+ ### First use
32
+
33
+ 1. Open **Ducoro** in Magpie's sidebar. If the page is unavailable, check `ducoro-cli`, the background service and the configured page-service port.
34
+ 2. In **Sync settings**, review the connection identifier, enabled resource types and target Bots. Assign the Magpie library resources you want Ducoro to receive; select per-Bot assignments where needed.
35
+ 3. Use **Preview changes**, review additions and removals, then **Preview and save** and confirm. Saving reloads the plugin host and starts synchronization.
36
+ 4. Open **Sync status** and review saved, written, read-back and session-loaded results. Resolve items marked unverified; a successful CLI command alone does not prove a running Bot has loaded the changes.
37
+
38
+ For a read-only check of the Ducoro background service, run:
39
+
40
+ ```sh
41
+ npm exec --package=magpie-ducoro@0.4.10 -- magpie-ducoro-status --doctor
42
+ ```
43
+
44
+ Upgrading: stop the previous host, then update the package or replace the plugin path before loading the new version, so two versions never write the same management state. Existing settings and compatible v1/v2 records carry forward without reconfiguration.
45
+
46
+ Downgrading: stop the current host first, then run `npm run state:compact -- /absolute/path/to/state.json` from this package directory to merge the journal under the shared lock. After an interrupted run, recover with the current version first. Do not manually delete an uncompacted journal.
47
+
13
48
  ## Features
14
49
 
15
50
  ### Sync and assignment
@@ -49,13 +84,6 @@ Full history: [CHANGELOG.md](docs/CHANGELOG.md) · Release notes: [RELEASE-NOTES
49
84
  - Restore preflight failures do not introduce a new pause. Failures after the state-writing stage begins retain the pause until the result can be reviewed.
50
85
  - **Clean up local records** previews counts and sizes before confirming: it removes completed operation history (up to 500 records), old state backups (latest 5 unretained kept) and skill caches unused for over 7 days, and compacts the journal. Current ownership, permission-recovery data, unfinished operations and skills in use are retained.
51
86
 
52
- ## Installation
53
-
54
- Install the npm package `magpie-ducoro` (`npm install magpie-ducoro@0.4.9`), add `github:YE4IM/magpie-ducoro#v0.4.9` in Magpie's plugin settings, or download the GitHub Release's automatically generated Source code, extract it and add the folder's absolute path. Open **Ducoro** in the sidebar. Magpie must support plugin page services, and `ducoro-cli` and the Ducoro daemon must be available locally.
55
-
56
- Upgrading: stop the previous host, then replace the plugin path or package before loading the new version, so two versions never write the same management state. Existing settings and compatible v1/v2 records carry forward without reconfiguration.
57
-
58
- Downgrading: stop the 0.4.9 host first, then run `npm run state:compact -- /absolute/path/to/state.json` from this package directory to merge the journal under the shared lock. After an interrupted run, recover with 0.4.9 first. Do not manually delete an uncompacted journal.
59
87
 
60
88
  ## Page and assignments
61
89
 
package/README.zh-CN.md CHANGED
@@ -1,15 +1,50 @@
1
- # Magpie-Ducoro-Plugin
1
+ # magpie-ducoro 0.4.10
2
2
 
3
- [English](README.md) | **简体中文**
3
+ [English](https://github.com/YE4IM/magpie-ducoro/blob/main/README.md) | **简体中文**
4
4
 
5
- ## Ducoro 0.4.9
6
-
7
- 0.4.9 将插件发布到 npm 注册表([`magpie-ducoro`](https://www.npmjs.com/package/magpie-ducoro)),并修正安装包的 `bin` 入口,npm 安装后 `magpie-ducoro-status` 诊断命令可正常调用。同步逻辑与 0.4.8 一致。完整升级说明见 [版本说明](docs/RELEASE-NOTES.md)。
5
+ 0.4.10 完善 npm 安装说明、首次使用步骤与兼容性说明,同步行为和管理记录格式与 0.4.9 一致。npm 包名为 [`magpie-ducoro`](https://www.npmjs.com/package/magpie-ducoro)。
8
6
 
9
7
  把 Magpie 的模型、连接器、技能、指令与显式选择的子代理同步到 Ducoro,并在插件页面内按 Bot 管理分配。同步带变更预览与保存前确认;失败按类别记录并支持按项重试;配置核验区分保存、写入、读回与会话加载四个阶段。
10
8
 
11
9
  完整版本历史见 [CHANGELOG.md](docs/CHANGELOG.md),本次升级说明见 [RELEASE-NOTES.md](docs/RELEASE-NOTES.md)。
12
10
 
11
+ ## 运行前提
12
+
13
+ - 安装支持插件 Agent 与页面服务的 [Magpie](https://usemagpie.ai)(`magpie.agent`、`magpie.page.service`)。
14
+ - 安装并登录 [Ducoro](https://ducoro.ai),启动其后台服务;安装 [CLI](https://ducoro.ai/download/cli),确保启动 Magpie 时的 PATH 能找到 `ducoro-cli`。
15
+ - 当前账户能够访问要管理的本地 Ducoro 设备与 Bot。插件页面服务默认使用 `127.0.0.1:3487`;端口被占用时修改 `servicePort`。
16
+
17
+ 本插件不会自动安装 Ducoro 或 CLI。目前未确定 Magpie 与 Ducoro 的精确最低版本。本次文档发布不新增端到端同步验收结论,也不声明已验证 Windows/Linux 兼容性;使用前请确认当前平台的 CLI 与页面服务支持情况。
18
+
19
+ ## 安装
20
+
21
+ 在 Magpie 的「插件 → 添加插件」中输入 `magpie-ducoro@0.4.10`。也可使用 Magpie 命令行:
22
+
23
+ ```sh
24
+ magpie plugin add magpie-ducoro@0.4.10
25
+ ```
26
+
27
+ `npm install magpie-ducoro` 只会把包下载到 npm 项目中,不会自动将插件注册到 Magpie。正常使用请通过上面的 Magpie 命令或插件对话框安装。
28
+
29
+ 源码安装:从 [GitHub Releases](https://github.com/YE4IM/magpie-ducoro/releases) 下载某个版本,解压后在 Magpie 中添加文件夹的绝对路径。也可添加 GitHub 版本 `github:YE4IM/magpie-ducoro#v0.4.9`;该标签的同步实现与本次文档补丁相同。
30
+
31
+ ### 首次使用
32
+
33
+ 1. 从 Magpie 侧边栏打开 **Ducoro**。页面不可用时,检查 `ducoro-cli`、后台服务与页面服务端口。
34
+ 2. 在「同步设置」核对连接标识、启用的资源类型与目标 Bot;将要交给 Ducoro 的 Magpie 资源库资源分配给它,按需设置各 Bot 的单独分配。
35
+ 3. 点击「预览变化」核对新增与撤销,再点击「保存设置」查看预览并确认。保存会重载插件宿主并开始同步。
36
+ 4. 打开「同步诊断」,检查保存、写入、读回与会话加载的结果;处理待核实项。CLI 命令成功不代表运行中的 Bot 已加载变化。
37
+
38
+ 只读检查 Ducoro 后台服务可执行:
39
+
40
+ ```sh
41
+ npm exec --package=magpie-ducoro@0.4.10 -- magpie-ducoro-status --doctor
42
+ ```
43
+
44
+ 升级:停止旧版宿主,更新安装包或替换插件路径后再加载新版本,避免两个版本同时写入共享管理状态。已有设置和兼容的 v1/v2 管理记录自动沿用,无需重新配置。
45
+
46
+ 回退:先停止当前版本宿主,再在本包目录执行 `npm run state:compact -- /管理记录的绝对路径/state.json`,在共用锁内合并增量日志;异常中断后先由当前版本恢复记录再回退。不要手动删除尚未合并的日志。
47
+
13
48
  ## 功能总览
14
49
 
15
50
  ### 同步与分配
@@ -49,13 +84,6 @@
49
84
  - 恢复前校验失败不会新增暂停;进入状态写入阶段后失败则保持暂停,避免在结果未确认时继续自动同步。
50
85
  - 「清理本地记录」先预览数量与空间再确认:清理已完成操作历史(最多 500 条)、历史状态备份(保留最近 5 份未标记保留)与超过 7 天未使用的技能缓存,并合并增量记录;保留当前归属、权限恢复数据、未完成操作与使用中的技能。
51
86
 
52
- ## 安装
53
-
54
- 安装 npm 包 `magpie-ducoro`(`npm install magpie-ducoro@0.4.9`),在 Magpie 插件页面添加 `github:YE4IM/magpie-ducoro#v0.4.9`,或从 GitHub Release 下载自动生成的 Source code 并解压后添加文件夹的绝对路径。从侧边栏 **Ducoro** 打开页面。需要 Magpie 支持插件页面服务,且本机已安装 `ducoro-cli` 并启动 Ducoro 后台。
55
-
56
- 升级:停止旧版宿主,替换插件路径或安装包后再加载新版本,避免两个版本同时写入共享管理状态。已有设置和兼容的 v1/v2 管理记录自动沿用,无需重新配置。
57
-
58
- 回退:先停止 0.4.9 宿主,再在本目录执行 `npm run state:compact -- /管理记录的绝对路径/state.json`,在共用锁内合并增量日志;异常中断后先由 0.4.9 恢复记录再回退。不要手动删除尚未合并的日志。
59
87
 
60
88
  ## 页面与分配
61
89
 
package/docs/CHANGELOG.md CHANGED
@@ -1,3 +1,13 @@
1
+ ## 0.4.10
2
+
3
+ - 完善 npm 中英文说明:通过 Magpie 添加插件的正确命令、运行前提、首次预览保存与诊断流程,以及兼容性验证边界。
4
+ - 将安装步骤提前,区分 npm 下载与 Magpie 插件注册;同步行为与管理记录格式不变。
5
+
6
+ ### English
7
+
8
+ - Improve the bilingual npm guide with the correct Magpie installation command, prerequisites, first-use preview/save and diagnostic steps, and compatibility verification limits.
9
+ - Move installation before the feature reference and distinguish npm downloads from Magpie plugin registration. Synchronization behavior and management record formats are unchanged.
10
+
1
11
  ## 0.4.9
2
12
 
3
13
  - 将插件发布到 npm 注册表(`magpie-ducoro`),修正安装包 `bin` 入口路径(移除前导 `./`),npm 安装后 `magpie-ducoro-status` 诊断命令可正常调用。
@@ -1,11 +1,11 @@
1
- # Ducoro 0.4.9
1
+ # Ducoro 0.4.10
2
2
 
3
- 0.4.9 将插件发布到 npm 注册表([`magpie-ducoro`](https://www.npmjs.com/package/magpie-ducoro)),并修正安装包的 `bin` 入口路径(移除前导 `./`):通过 npm 安装后,`magpie-ducoro-status` 诊断命令可正常调用。同步逻辑、页面行为与管理记录格式均无变化。
3
+ 0.4.10 完善 npm 包 [`magpie-ducoro`](https://www.npmjs.com/package/magpie-ducoro) 的中英文说明:安装步骤提前,明确通过 Magpie 添加插件的命令、Ducoro CLI 与后台服务要求、首次预览保存和诊断流程,以及尚未验证的兼容性范围。同步行为和管理记录格式与 0.4.9 一致。
4
4
 
5
- Version 0.4.9 publishes the plugin to the npm registry as [`magpie-ducoro`](https://www.npmjs.com/package/magpie-ducoro) and fixes the packaged `bin` entry path (dropping the leading `./`) so the `magpie-ducoro-status` diagnostic command works after an npm install. Synchronization logic, page behavior and management record formats are unchanged.
5
+ Version 0.4.10 improves the bilingual documentation for the npm package [`magpie-ducoro`](https://www.npmjs.com/package/magpie-ducoro): installation comes first, with the Magpie plugin-add command, Ducoro CLI and background-service requirements, first-use preview/save and diagnostic steps, and compatibility verification limits. Synchronization behavior and management record formats are unchanged from 0.4.9.
6
6
 
7
- 安装方式:`npm install magpie-ducoro@0.4.9`、在 Magpie 插件页面添加 `github:YE4IM/magpie-ducoro#v0.4.9`,或下载 GitHub Release 自动生成的 Source code 解压后添加绝对路径。升级沿用现有兼容设置与管理记录,无需重新配置。GitHub Release 仅提供自动生成的 Source code,不上传额外附件。
7
+ 在 Magpie 的「插件 → 添加插件」中输入 `magpie-ducoro@0.4.10`,或运行 `magpie plugin add magpie-ducoro@0.4.10`。单独执行 `npm install` 不会将插件注册到 Magpie。升级沿用已有兼容设置与管理记录;请先停止旧版宿主。
8
8
 
9
- Installation: `npm install magpie-ducoro@0.4.9`, add `github:YE4IM/magpie-ducoro#v0.4.9` in Magpie's plugin settings, or download the GitHub Release's automatically generated Source code and add the extracted folder's absolute path. Compatible settings and management records carry forward without reconfiguration. GitHub Release provides only its automatically generated Source code, with no uploaded assets.
9
+ Enter `magpie-ducoro@0.4.10` in Magpie's **Plugins → Add a plugin**, or run `magpie plugin add magpie-ducoro@0.4.10`. An `npm install` alone does not register the plugin with Magpie. Compatible settings and management records carry forward; stop the previous host before upgrading.
10
10
 
11
11
  完整更新说明见 [CHANGELOG.md](CHANGELOG.md) · Full history: [CHANGELOG.md](CHANGELOG.md)
@@ -110,7 +110,7 @@ function summarize(report) {
110
110
  }
111
111
 
112
112
  export function buildDiagnostics({ options = {}, reason, stages = {}, retries = [], state = {}, total, capabilities, startedAt, roundId, now = new Date() } = {}) {
113
- const report = { schemaVersion: 1, pluginVersion: '0.4.9', updatedAt: new Date(now).toISOString(), reason: safeReason(reason), status: 'unknown', runtimeLoaded: 'unknown', features: {}, issues: [], targets: [] }
113
+ const report = { schemaVersion: 1, pluginVersion: '0.4.10', updatedAt: new Date(now).toISOString(), reason: safeReason(reason), status: 'unknown', runtimeLoaded: 'unknown', features: {}, issues: [], targets: [] }
114
114
  if (validRoundId(roundId)) report.roundId = roundId
115
115
  for (const feature of FEATURES) {
116
116
  report.features[feature] = safeFeature(stages[feature])
@@ -176,7 +176,7 @@ function safeReason(reason) {
176
176
  // never become part of a support export or the CLI's output.
177
177
  export function sanitizeDiagnostics(input) {
178
178
  if (!object(input) || input.schemaVersion !== 1 || !object(input.features) || !timestamp(input.updatedAt)) return null
179
- const report = { schemaVersion: 1, pluginVersion: '0.4.9', updatedAt: timestamp(input.updatedAt), reason: safeReason(input.reason), status: 'unknown', runtimeLoaded: 'unknown', features: {}, issues: [], targets: [] }
179
+ const report = { schemaVersion: 1, pluginVersion: '0.4.10', updatedAt: timestamp(input.updatedAt), reason: safeReason(input.reason), status: 'unknown', runtimeLoaded: 'unknown', features: {}, issues: [], targets: [] }
180
180
  if (validRoundId(input.roundId)) report.roundId = input.roundId
181
181
  for (const feature of FEATURES) report.features[feature] = safeFeature(input.features[feature])
182
182
  for (const feature of FEATURES) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "magpie-ducoro",
3
- "version": "0.4.9",
3
+ "version": "0.4.10",
4
4
  "description": "Sync Magpie models, connectors, skills and instructions with Ducoro.",
5
5
  "author": {
6
6
  "name": "YE4IM",
package/ui/index.html CHANGED
@@ -25,7 +25,7 @@
25
25
  <body>
26
26
  <main class="console">
27
27
  <header class="hero">
28
- <div class="brand"><img src="ducoro.svg" width="24" height="24" alt=""><div><h1>Ducoro <span class="version">0.4.9</span></h1></div></div>
28
+ <div class="brand"><img src="ducoro.svg" width="24" height="24" alt=""><div><h1>Ducoro <span class="version">0.4.10</span></h1></div></div>
29
29
  <p>在一处管理连接、同步范围和每个 Bot 的资源。</p>
30
30
  <div class="connection-note"><span class="dot" aria-hidden="true"></span><span id="connection-state">正在读取插件配置…</span></div>
31
31
  </header>