@aicloud360/360-aidrive 0.8.28

package/package.json

@@ -0,0 +1,118 @@
+{
+  "name": "@aicloud360/360-aidrive",
+  "version": "0.8.28",
+  "main": "build/index.js",
+  "type": "module",
+  "bin": {
+    "360aidrive": "build/cli.js"
+  },
+  "cli": {
+    "name": "360aidrive",
+    "description": "360 AI Drive CLI - 面向 AI Agent 的云存储操作工具"
+  },
+  "scripts": {
+    "start": "echo \"start\" && node build/index.js --sse",
+    "clean": "rm -rf build",
+    "build:ts": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
+    "build": "rollup -c && node scripts/postbuild.js",
+    "build:dev": "rollup -c --environment NODE_ENV:development && node scripts/postbuild.js",
+    "build:prod": "rollup -c --environment NODE_ENV:production && node scripts/postbuild.js",
+    "watch": "rollup -c -w",
+    "prepublishOnly": "npm run build:prod",
+    "skill:convert": "npm run version:sync && node skill-converter/scripts/converter.js",
+    "skill:convert:tool": "node skill-converter/scripts/converter.js --tool",
+    "skill:list": "node skill-converter/scripts/list-tools.js",
+    "skill:validate": "node skill-converter/scripts/validate.js",
+    "skill:test": "cd skill-output && python3 executor.py user-info",
+    "version:sync": "node skill-converter/scripts/sync-version.js",
+    "release": "standard-version && npm run version:sync && npm run skill:convert",
+    "release:patch": "standard-version --release-as patch && npm run version:sync && npm run skill:convert",
+    "release:minor": "standard-version --release-as minor && npm run version:sync && npm run skill:convert",
+    "release:major": "standard-version --release-as major && npm run version:sync && npm run skill:convert",
+    "skill:output": "npm run skill:convert && npm run skill:package",
+    "skill:package": "node skill-converter/scripts/package.js",
+    "skill:package:no-version": "node skill-converter/scripts/package.js --no-version",
+    "skill-cli:package": "node scripts/package-skill-cli.js",
+    "skill-cli:package:no-version": "node scripts/package-skill-cli.js --no-version",
+    "skill:deploy": "node skill-converter/scripts/deploy-skill.js",
+    "skill:deploy:manual": "node skill-converter/scripts/deploy-skill.js --manual",
+    "skill-cli:deploy": "node scripts/deploy-skill-cli.js",
+    "skill-cli:deploy:manual": "node scripts/deploy-skill-cli.js --manual",
+    "publish:mcp": "node scripts/publish-pkg.js mcp",
+    "publish:cli": "node scripts/publish-pkg.js cli",
+    "publish:aidrive": "node scripts/publish-pkg.js aidrive",
+    "test:cli-batch": "bash tests/test-cli-batch-real.sh",
+    "test:cli-full": "bash tests/test-cli-full.sh",
+    "test:cli-e2e": "bash tests/test-cli-e2e.sh",
+    "auto-backup-monitor": "node tools/auto-backup-monitor/server.mjs --open"
+  },
+  "files": [
+    "build",
+    "tools/auto-backup-monitor"
+  ],
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "ecs",
+    "uploader",
+    "cloud storage",
+    "360",
+    "file manager",
+    "cli",
+    "ai-agent"
+  ],
+  "author": "@aicloud360",
+  "license": "Apache-2.0",
+  "description": "360 AI Drive CLI",
+  "homepage": "https://github.com/Qihoo360/ecs_mcp_server#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Qihoo360/ecs_mcp_server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Qihoo360/ecs_mcp_server/issues"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/jimp": "^0.2.1",
+    "@types/node": "^22.10.0",
+    "@types/qrcode-terminal": "^0.12.2",
+    "@types/uuid": "^9.0.8",
+    "rollup": "^4.12.0",
+    "rollup-plugin-delete": "^2.0.0",
+    "standard-version": "^9.5.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.7.2"
+  },
+  "dependencies": {
+    "@aicloud360/sec-sdk-node": "^0.1.9",
+    "@modelcontextprotocol/sdk": "1.15.0",
+    "@types/cors": "^2.8.18",
+    "@types/express": "^5.0.1",
+    "better-sqlite3": "^12.9.0",
+    "chokidar": "^4.0.3",
+    "commander": "^14.0.3",
+    "cors": "^2.8.5",
+    "dotenv": "^16.5.0",
+    "express": "^5.1.0",
+    "iconv-lite": "^0.6.3",
+    "jimp": "^1.6.1",
+    "jsqr": "^1.4.0",
+    "pino": "^9.5.0",
+    "pino-pretty": "^11.2.2",
+    "qrcode-terminal": "^0.12.0",
+    "uuid": "^9.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "directories": {
+    "doc": "docs",
+    "test": "tests"
+  }
+}

package/tools/auto-backup-monitor/README.md

@@ -0,0 +1,208 @@
+# 自动备份监控页使用说明
+
+这个目录里的工具是一个**独立的本地网页监控工具**，用来读取云盘 CLI 的 `claw-auto-backup` 写出的事件日志，并实时展示（命令名示例：`360disk` 或 `@aicloud360/360-aidrive` 提供的 `360aidrive`）：
+
+- 监听到文件变化
+- 进入备份队列
+- 开始备份
+- 备份成功 / 失败
+- 单次备份耗时
+
+它**不是** CLI 二进制本身的一部分，而是一个单独启动的本地网页服务。
+
+## 一、使用前提
+
+使用这个监控页前，需要满足两个条件：
+
+1. 本机在 PATH 中已安装可用的云盘 CLI（见上）
+2. 启动自动备份时，**显式传入** `--event-log <日志路径>`
+
+注意：
+
+- 如果不传 `--event-log`，CLI 进程不会写任何监控日志
+- 监控页没有默认日志路径，必须在启动参数里预填，或者打开页面后手动输入
+
+## 二、推荐使用流程
+
+### 1. 启动自动备份，并显式指定事件日志文件
+
+示例：
+
+```bash
+360disk claw-auto-backup enable \
+  --source /private/tmp/auto-backup-src \
+  --dest /auto-backup-test/ \
+  --event-log /tmp/360disk-claw-auto-backup-events.ndjson
+```
+
+这里最重要的是：
+
+```bash
+--event-log /tmp/360disk-claw-auto-backup-events.ndjson
+```
+
+监控页后面也要读取这个同一路径。
+
+### 2. 启动监控页
+
+在仓库根目录执行：
+
+```bash
+node tools/auto-backup-monitor/server.mjs --open
+```
+
+默认会启动本地网页服务：
+
+```text
+http://127.0.0.1:3210
+```
+
+`--open` 会自动打开浏览器。
+
+### 3. 在页面里填写日志路径
+
+如果你启动监控页时**没有**传 `--event-log`，打开页面后，需要在输入框里填写：
+
+```text
+/tmp/360disk-claw-auto-backup-events.ndjson
+```
+
+然后点击 `Connect`。
+
+如果启动时已经预填：
+
+```bash
+node tools/auto-backup-monitor/server.mjs \
+  --event-log /tmp/360disk-claw-auto-backup-events.ndjson \
+  --open
+```
+
+页面会自动用这个路径连接。
+
+## 三、常用命令
+
+### 启动监控页并自动打开浏览器
+
+```bash
+node tools/auto-backup-monitor/server.mjs --open
+```
+
+### 启动监控页并预填事件日志路径
+
+```bash
+node tools/auto-backup-monitor/server.mjs \
+  --event-log /tmp/360disk-claw-auto-backup-events.ndjson \
+  --open
+```
+
+### 自定义端口
+
+```bash
+node tools/auto-backup-monitor/server.mjs \
+  --port 3211 \
+  --open
+```
+
+### 自定义状态文件路径
+
+一般不用传。只有在你确认状态文件不在默认位置时才需要：
+
+```bash
+node tools/auto-backup-monitor/server.mjs \
+  --state-file /path/to/claw-auto-backup.json
+```
+
+## 四、页面能看到什么
+
+页面主要展示两部分：
+
+### 1. Status
+
+显示当前自动备份 watcher 的状态，例如：
+
+- 是否启用
+- 是否正在运行
+- PID
+- 最近一次事件时间
+- 最近一次备份时间
+- 最近一次备份结果
+
+### 2. Timeline
+
+显示事件时间线，例如：
+
+- `watch_event`
+- `backup_scheduled`
+- `backup_started`
+- `backup_finished`
+- `backup_failed`
+
+如果有失败，页面里会显示失败信息和耗时。
+
+## 五、排查思路
+
+### 情况 1：页面打开了，但没有任何事件
+
+优先检查：
+
+1. 启动 `360disk claw-auto-backup enable` 时有没有传 `--event-log`
+2. 页面里填的日志路径，和 `--event-log` 的路径是否完全一致
+3. watcher 是否真的在运行
+
+可以执行：
+
+```bash
+360disk claw-auto-backup status
+```
+
+### 情况 2：页面提示“日志读取失败”
+
+常见原因：
+
+- 路径写错了
+- 日志文件还没生成
+- 传了一个目录路径，而不是文件路径
+- 当前用户没有读权限
+
+### 情况 3：自动备份有触发，但页面没显示最新事件
+
+建议先确认：
+
+```bash
+360disk claw-auto-backup status
+```
+
+然后看你指定的日志文件是否真的有内容：
+
+```bash
+tail -f /tmp/360disk-claw-auto-backup-events.ndjson
+```
+
+如果 `tail -f` 有新行，而页面没有更新，再检查页面里当前连接的是不是同一个文件。
+
+## 六、发给同事怎么用
+
+如果同事已经有支持 `--event-log` 的新版 `360disk`，你只需要把这个目录发给他：
+
+```text
+tools/auto-backup-monitor/
+```
+
+他本地执行：
+
+```bash
+node server.mjs --open
+```
+
+然后：
+
+1. 先用 `360disk claw-auto-backup enable --event-log <path>` 启动自动备份
+2. 再在网页输入框里填入同一个 `<path>`
+3. 点击 `Connect`
+
+## 七、注意事项
+
+1. 这个工具目前更适合在**源码仓库环境**里直接运行
+2. 监控页和 `360disk` 是两个独立进程
+3. 页面读取的是**事件日志文件**，不是直接连 `360disk` 进程
+4. 只要日志路径一致，监控页就能工作