让每一份文件都有归处。部署在个人 VPS 的文件收集与整理工作台。
当前版本 v0.3.0：一个链接收集文件，工作台成员集中整理与下载。支持断点续传、在线备份、正文检索与悬浮 AI，按任务选择本地或云端连接。部署建议使用 v0.3.0，main 用于日常开发。
main 正在开发 v0.4.0：收集模板、自定义提交字段、按字段自动命名、提交人 / 未交台账、私密回执补交替换、部署检查及失败同步批量重试。本轮没有创建新 Release，升级 main 前请完成备份（schema 5 不能直接用 v0.3 打开）。
- 新建收集，选择作业、报名材料、项目交付或空白模板，依次填写基本信息、提交规则并确认命名。按需添加「学号」「班级」「项目编号」等字段；选择姓名或一个必填字段作为提交人标识。
- 可填入应交名单，一行一个标识。名单用于统计，不限制名单外的人提交，也不是身份认证。
- 点击命名片段并按顺序组合，未选片段则保留原文件名。配置仅影响后续提交，已有文件可通过批量命名整理。
- 在任务详情的「提交人 / 未交名单」查看进度与重复内容，点击查看某人的文件，或导出完整台账。
- 提交者保存私密回执。同一人补交会合并统计；替换需要回执编号与私密凭证，仅替换对应批次。旧文件进入回收站，仍占配额。遗失凭证请联系发起人，旧版本回执没有替换凭证。
- 常用规则在任务详情「保存为模板」，下次新建时选择；模板管理可归档 / 恢复。
命名确认页可修改示例姓名、原文件名和字段值，即时查看结果；这些示例不会创建文件。最终名称由实际提交时的日期、序号和重名情况决定。
提交页按文件显示传输情况。「已传完」仍在等待整批校验与回执；失败可在对应文件继续，已确认分片不重传。回执响应中断时点击「重试并确认回执」，无需重新开始。更换文件清单、姓名或字段会新建批次。
任务详情点击「检查这项收集」，助手会在本机统计缺交、内容重复与重名。切换模型模式后可准备整理问题，再明确选择发送的文件；统计不等于模型实测，名单不会自动外发。
更换收集链接后，旧链接的回执查询入口一并失效，请使用新的收集链接查询。新设备可从私密回执文件取得编号与凭证；浏览器仅记住当前收集最新一次回执，其他批次需自行保存。
- 初始化管理员、登录退出、修改密码并撤销旧会话。
- 创建与编辑收集，设置截止、格式、单文件大小、单次数量和任务容量。
- 分享独立随机链接，暂停、结束、重新开放或更换链接；提交者无需账号。
- 4 MiB 分片上传、进度、24 小时断点续传和提交回执；公开接口不提供文件列表或下载。
- 本地文件持久化、SHA-256 校验、鉴权下载、搜索与 CSV 导出。
- 批量命名先预览，服务器原子应用，可撤销；按内容哈希检查重复文件。
- 勾选文件或打包当前筛选结果，预览后下载 ZIP；支持平铺、按任务、按提交人和任务/提交人分文件夹，重名自动加序号。
- 文件回收站与恢复；离线清理前先生成完整备份。
- 在线完整备份、定时计划和保留策略、校验恢复至全新目录。
- 管理员 / 编辑者 / 只读成员，成员管理与会话撤销。
- 图片 / PDF 预览、TXT / DOCX / PDF / 图片正文识别、中文检索与本机 OCR（容器自带工具）。
- WebDAV / S3 连接，百度 / OneDrive / Google Drive 官方应用授权适配，持久传输队列和校验；按步骤完成配置、授权与连接检查。
- Docker Compose + Caddy、HTTPS、数据持久卷、配额、日志轮转与健康检查。
- 中文暖纸色界面，桌面和手机布局，右下角悬浮助手。
- 可配置 Responses / Chat Completions 兼容模型，凭证在服务端加密保存；默认关闭。
- 每次确认发送范围，模型建议先预览、再确认应用，可撤销；调用次数限制与状态记录。
网盘需配置自己的凭证 / OAuth 应用并授权；当前已做协议验收，未使用用户真实账号完成联调。夸克入口已按用户要求移除。云端同步后仍保留完整本机副本，需为 VPS 配足正文空间。模型默认仅接收确认的元数据；正文摘录与提交人需要额外勾选，分类和命名均先预览再执行。未配置模型时使用本机规则。项目不提供病毒扫描。
在「文件管理」筛选后点击「打包筛选结果」，或勾选文件后点击「打包下载」。选择文件夹结构，生成预览后开始下载 ZIP。归档中的重名和不适合文件系统的名称会自动调整，原文件名保持不变；按提交人分组以填写的名称为准，相同名称会归在一起。
每次最多 500 个文件、10 GiB 原始内容，最多两个归档同时传输。计划绑定当前登录会话，需在 10 分钟内开始且只能使用一次；服务重启后需重新生成。下载直接交给浏览器，不在服务器生成 ZIP 副本，也不在前端内存缓存整个包。传输失败或文件已变化时，重新生成预览后重试。
管理员在「设置 → 模型服务」填写接口根地址、模型 ID 和自己的 API Key，选择协议后保存并启用。支持公网 HTTPS（443），不支持内网地址或重定向；模型需支持对应协议与 JSON 输出，兼容服务的参数支持以其实际接口为准。连接测试会实际调用一次模型，可能计费。
在文件表格选择最多 30 个文件，点击「AI 建议」，确认本次发送信息后提问。模型不会自动改名；点击建议进入预览并确认，才通过服务器校验后修改。更换服务商后需重新输入 Key，后台设置变化会让旧授权失效。对话仅在当前面板内显示，不作为后续问题的上下文；操作记录只保存状态和用量。
默认每天最多 50 次调用（按 UTC+8 重置，失败与取消也计入），可在设置中调整；次数不代表金额预算，费用和数据保留方式由所选服务商决定。完整备份包含凭证主密钥，必须按私密数据保存。详情见部署指南。
需要 Node.js 24.11+（24.x），使用 npm 和唯一 package-lock.json：
npm ci
npm test
npm run build
npm start打开 本机工作台。首次读取 data/setup-token 中的初始化口令，在页面设置管理员名称和至少 12 字符的密码。没有默认密码。正式数据默认保存在被 Git 忽略的 data/；VPS 采用独立持久卷。
npm run server:dev # 后端监听 3000，修改自动重启
npm run dev # 前端监听 5173，将 /api 代理到 3000
npm run check # 前后端 TypeScript 检查
npm run build # 检查并生成前端 dist/
npm test # 规则与真实文件服务集成测试分离开发时将服务端 JIYU_ORIGIN 设置成实际前端地址，例如 http://127.0.0.1:5173。正式运行用 npm start，由同一个服务提供前端和 API。
cp .env.example .env
# 编辑域名、外部 HTTPS 地址和配额
docker compose up -d --build
docker compose exec app cat /data/live/setup-token完整步骤、备份恢复、离线清理与升级参见 部署指南。不使用 docker compose down -v 删除数据卷。元数据导出不包含文件正文，不能替代完整备份。
一个仓库、一个前端应用与一个实际服务，无源码副本、空 packages 或微服务。前后端共享 TypeScript 数据结构；Fastify 处理 HTTP 与上传，Node 内置 SQLite 保存元数据，文件正文存独立目录。
src/ 前端界面、功能组件、共享类型和格式规则
server/ API、认证、持久化、备份 CLI 与集成测试
public/ 少量静态资源
docs/ 项目、架构、设计和部署说明
构建产物、依赖目录、缓存、截图、文件正文、数据库与密钥不进 Git。镜像只携带运行依赖、构建后的前端与服务代码，保留项目 LICENSE；开发依赖和本机数据不进入运行镜像。日常构建与测试通过后直接提交推送 main，GitHub CI 自动运行检查和容器启动测试。作者统一使用本仓库的 1Beyond1 与 GitHub 隐私邮箱。
集屿采用 MIT License，Copyright (c) 2026 1Beyond1。第三方依赖遵循各自的许可证。