✨ Feature: add picgo server and cloud and config sync (#190)

Author: Molunerfinn

.env.example

@@ -0,0 +1,2 @@
+PICGO_API_URL=https://xxx.com
+PICGO_CLOUD_URL=https://xxx.com

.github/workflows/release.yml

@@ -31,7 +31,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: 20
+          node-version: 22
           registry-url: https://registry.npmjs.org
           cache: pnpm
 

.husky/pre-commit

@@ -1 +1 @@
-pnpm lint
+pnpm lint

.npmignore

@@ -15,3 +15,5 @@ eslint.config.js
 CHANGELOG.md
 .github/
 test.js
+specs/
+dist/__tests__/

AGENTS.md

@@ -30,13 +30,17 @@ Always ask questions before create proposal files if unsure about anything in th
 - **Exports**: do not use `export default` for new/modified modules. Prefer named exports (e.g. `export { ServerManager }`) and named imports (e.g. `import { ServerManager } from '...'`).
 - Keep TypeScript types explicit; avoid ad-hoc `any` when possible.
 - Don't write `as any` in TypeScript code unless absolutely necessary. Always prefer explicit types.
+- **i18n / user-facing text**: do not hard-code user-facing strings (logs, errors, HTML result pages). Add i18n keys under `src/i18n/zh-CN.ts` and provide corresponding entries in `src/i18n/en.ts` and `src/i18n/zh-TW.ts`, then use `ctx.i18n.translate<ILocalesKey>(...)` (supports `${var}` placeholders via args). CLI option descriptions are exempt unless explicitly requested.
 - **Commander actions**: prefer `.action(async (...) => { ... })` and avoid wrapping an IIFE like `.action(() => { (async () => { ... })().catch(...) })`.
 - **Commander prompts**: avoid `prompt<any>` / `prompt<IStringKeyMap<any>>`; declare a concrete answer type (e.g. `prompt<{ operation: 'list' | 'rename' }>(...)`).
+- **Commander option descriptions**: for CLI options, use plain strings without i18n keys unless explicitly requested.
+- **TypeScript enums**: when representing a fixed set of values, prefer `enum` over union string literal types unless explicitly requested otherwise.
 - **Config persistence**: use `ctx.saveConfig(...)` for changes that must persist to disk; use `ctx.setConfig(...)` only for in-memory/session updates.
 
 ## Execution Rules
 - If a command fails due to insufficient permissions, rerun with elevated approval.
 - For `pnpm` commands that hit network issues, retry first.
+- After completing a task, run `pnpm lint` and `pnpm test` and ensure they pass before handing work back.
 
 ## Serena MCP & Context7 Tools
 When starting work or if you hit issues, try checking MCP for Serena or Context7 tooling. If available, use those tools to navigate, edit, or fetch docs efficiently.

README.md

@@ -29,7 +29,7 @@ A tool for picture uploading. Both CLI & api supports. It also supports plugin s
 
 ## Installation
 
-PicGo should be installed with node.js >= 16 (v1.5.0-alpha.5 and small) & node.js >= 20 (since v1.6.0).
+PicGo requires Node.js >= 20.19.0 or >= 22.12.0. For older PicGo versions (<= v1.5.x), Node.js >= 16 is sufficient. Cause we need the [stability of ES Module support](https://joyeecheung.github.io/blog/2025/12/30/require-esm-in-node-js-from-experiment-to-stability/).
 
 ### Global install
 
@@ -81,6 +81,9 @@ $ picgo -h
     use [module] [name] [configName]         use module (uploader/transformer/plugin) of picgo
     i18n [lang]                              change picgo language
     uploader                                 manage uploader configurations
+    server [options]                         run PicGo as a standalone server
+    login [token]                            login to cloud.picgo.app
+    logout                                   logout from cloud.picgo.app
     help [command]                           display help for command
 ```
 
@@ -100,6 +103,26 @@ picgo upload
 
 Thanks to [vs-picgo](https://github.com/Spades-S/vs-picgo) && [Spades-S](https://github.com/Spades-S) for providing the method to upload picture from clipboard.
 
+#### Run as a server
+
+```bash
+picgo server -p 36677 -h 127.0.0.1
+```
+
+#### Login to PicGo Cloud
+
+```bash
+picgo login
+# or
+picgo login <token>
+```
+
+#### Logout from PicGo Cloud
+
+```bash
+picgo logout
+```
+
 #### Manage uploader configs
 
 Since v1.8.0, PicGo-Core supports multiple configurations per uploader. Just like the configuration of the Electron version of PicGo.

package.json

@@ -13,7 +13,7 @@
   },
   "scripts": {
     "start": "node ./bin/picgo",
-    "lint": "tsc --noEmit && eslint src --ext .ts",
+    "lint": "pnpm lint:dpdm && tsc --noEmit && eslint src --ext .ts",
     "test": "vitest run",
     "build": "cross-env NODE_ENV=production rimraf ./dist && rollup -c rollup.config.js",
     "dev": "cross-env NODE_ENV=development rollup -c rollup.config.js -w",
@@ -23,7 +23,8 @@
     "cz": "git-cz",
     "release": "bump-version",
     "prepare": "husky",
-    "commitlint": "commitlint --edit"
+    "commitlint": "commitlint --edit",
+    "lint:dpdm": "dpdm -T --tsconfig ./tsconfig.json --no-tree --no-warning --exit-code circular:1 src/index.ts"
   },
   "keywords": [
     "picture",
@@ -74,6 +75,7 @@
     "copyfiles": "^2.1.0",
     "cross-env": "^7.0.3",
     "cz-customizable": "^7.5.1",
+    "dpdm": "^3.14.0",
     "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
@@ -89,6 +91,7 @@
     "vitest": "^4.0.16"
   },
   "dependencies": {
+    "@hono/node-server": "^1.19.7",
     "@picgo/i18n": "^1.0.0",
     "@picgo/store": "^2.0.2",
     "axios": "^1.13.2",
@@ -97,8 +100,13 @@
     "comment-json": "^4.5.1",
     "cross-spawn": "^6.0.5",
     "dayjs": "^1.7.4",
+    "dotenv": "^17.2.3",
+    "ejs": "^3.1.10",
     "form-data": "^4.0.5",
     "fs-extra": "^6.0.1",
+    "giget": "^2.0.0",
+    "globby": "^11.0.4",
+    "hono": "^4.11.3",
     "image-size": "^0.8.3",
     "inquirer": "^6.0.0",
     "is-wsl": "^2.2.0",
@@ -107,6 +115,7 @@
     "md5": "^2.2.1",
     "mime-types": "3.0.2",
     "minimist": "^1.2.5",
+    "open": "^11.0.0",
     "resolve": "^1.8.1",
     "tunnel": "^0.0.6"
   },
@@ -119,6 +128,6 @@
   },
   "plugins": {},
   "engines": {
-    "node": ">= 22.12.0"
+    "node": ">= 20.19.0"
   }
 }