jcs-plugin

JCS（云际存储）插件仓：所有 JCS 插件的源码统一在本仓管理，与核心仓（JCS-pub / common / JCS-front）解耦，插件开发者在本仓内自由协作。

仓库结构

jcs-plugin/
├── README.md        # 本文（人读）
├── AGENTS.md        # AI 编程助手规则（AI 读）
├── .gitignore       # 排除构建产物与敏感文件
├── docs/
│   └── 插件开发规范.md   # 插件开发规范（精简版）
├── album/           # 相册（最小本地 Docker 骨架样例）
├── finance/         # 票务报销
├── menduner/        # 科研助理
└── <your-plugin>/   # 你的新插件

快速开始

1. 拉取代码

git clone https://gitlink.org.cn/JointCloud/jcs-plugin.git

插件开发还需要核心仓（用于编译 client.exe 与提交注册迁移脚本 PR），见《JCS 插件开发规范与教程》。

2. 开发一个新插件

1. 复制最小骨架：cp -r album <your-plugin>
2. 改后端（backend/）与前端（frontend/）
3. 改容器三件套（Dockerfile / nginx.conf / supervisord.conf）
4. 向核心维护者申请迁移 ID 与宿主端口（全局唯一）
5. 在 JCS-pub fork 上提交注册迁移脚本的单文件 PR
6. 构建验证后在本仓提交代码

完整规范见 docs/插件开发规范.md 与核心仓的《JCS 插件开发规范与教程》。

修改范围（重要）

• ✅ 可自由修改：你自己负责的插件目录（jcs-plugin/<your-plugin>/）。
• ⚠️ 修改他人插件目录：必须先征得对方同意（PR 审批）。
• ❌ 禁止直接修改核心仓（JCS-pub / common / thirdparties / JCS-front），一律走 PR。
• ❌ 禁止提交 node_modules / dist / __pycache__ / venv / *.db / 数据目录 / 镜像 tar / token / 证书。

版本管理要点

• 提交前先 git pull --rebase；禁止 git push --force。
• 迁移 ID = 当前最大 ID + 1；宿主端口 32771 起递增，由核心维护者统一分配。
• 镜像版本语义化（x.y.z），与迁移脚本 ImageRef 保持一致。

详见 AGENTS.md（AI 规则）与 docs/插件开发规范.md。