code.8e.ink

完全独立的项目、教程和文件发布平台。项目直接上传并保存在自己的服务器，不依赖 GitHub、GitLab 或其他代码托管服务。

发布流程

1. 注册并登录平台账户
2. 创建项目，项目首先进入草稿状态
3. 填写版本号和更新说明，上传源码 ZIP
4. 检查 README，继续添加教程和附件
5. 确认内容无误后公开发布

代码更新流程

1. 准备并测试新版代码
2. 填写新的版本号和更新说明
3. 上传新版源码 ZIP
4. 当前源码自动更新，旧版本继续保留并可下载

脚本、CLI 和持续集成工具也可以通过 OpenAPI 完成自动化发布。

已实现

• 平台原生项目创建
• 注册登录、持久会话和项目所有权
• 独立项目列表与搜索
• 草稿、确认发布和公开展示
• 版本化源码上传、历史版本与更新说明
• README 渲染和源码目录浏览
• 项目文本文件读取 API
• Markdown 教程与附件发布
• 点赞、收藏和项目评论
• 虚拟硬币与项目投币支持
• 每用户自动化 API Key、写入鉴权和操作限流
• ZIP 路径穿越、符号链接和解压大小防护
• 拒绝包含 .git、node_modules、.env、.ssh 等敏感路径的项目包
• Docker 隔离运行，本地 data/ 持久化

社区互动规则

• 每个账户可以点赞或收藏项目，再次操作可取消
• 登录用户可以发表评论，评论者和项目作者可以删除
• 新账户初始获得 20 枚硬币
• 每个账户对同一项目最多投入 2 枚，投币后不可撤回
• 项目作者不能给自己的项目投币

启动

mkdir -p data
chown 1000:1000 data
docker compose up -d --build
curl http://127.0.0.1:3000/health

自动化发布

OpenAPI 文档：https://code.8e.ink/api/v1/openapi.json

先注册登录，在账户中心生成个人 API Key。脚本或开发工具使用该密钥发布的项目会自动归属这个账户。

创建项目：

curl -X POST 'https://code.8e.ink/api/v1/projects' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_KEY' \
  -d '{"title":"我的项目","summary":"项目介绍","tags":["Web","工具"]}'

上传源码：

zip -r project.zip . -x '.git/*' 'node_modules/*' '.env*'

curl -X POST 'https://code.8e.ink/api/v1/projects/PROJECT_ID/source' \
  -H 'X-API-Key: YOUR_KEY' \
  -F 'version=v1.0.0' \
  -F 'changelog=首次发布' \
  -F 'archive=@project.zip'

确认公开发布：

curl -X POST 'https://code.8e.ink/api/v1/projects/PROJECT_ID/publish' \
  -H 'X-API-Key: YOUR_KEY'

发布教程：

curl -X POST 'https://code.8e.ink/api/v1/projects/PROJECT_ID/tutorials' \
  -H 'X-API-Key: YOUR_KEY' \
  -F 'title=快速开始' \
  -F 'content=<docs/getting-started.md' \
  -F 'attachment=@manual.pdf'

本地数据

• data/projects.json：用户、会话、项目、教程和附件元数据
• data/projects/：解压后的项目源码
• data/uploads/：源码 ZIP 与附件

生产环境建议对 data/ 配置每日异机备份。