# gitee-publish **Repository Path**: markets2022/gitee-publish ## Basic Information - **Project Name**: gitee-publish - **Description**: WorkBuddy 技能:把本地项目发布/维护到 Gitee(账号无关·一键OAuth授权·可分发) - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-30 - **Last Updated**: 2026-08-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: 技能skills, skills ## README # Gitee 发布助手(gitee-publish) 把本地项目**发布 / 维护到 Gitee** 的 WorkBuddy 技能。说一句"发布到 Gitee",模型就按标准流程帮你建仓库、提交、推送、设公开/私有、校验文件树,全程不用你记 git 命令。 > 适用 WorkBuddy(对话式 AI 助手)。技能文件:`SKILL.md` + 云函数 `oauth-proxy/`。 --- ## 它能做什么 | 场景 | 触发说法举例 | |---|---| | 首次发布项目到 Gitee | "把 `D:\xxx` 发布到 Gitee 公开仓库" | | 建私有/公开仓库 | "在 Gitee 建个私有仓库 yyy" | | 推送更新 | "把 zzz 推到 Gitee 并更新" | | 设公开/私有、列/删仓库 | "把 aaa 设为公开" / "删掉 bbb 仓库" | - **账号无关**:不写死任何 Gitee 账号,谁用谁的。 - **发布前自动脱敏**:项目里若含真实 token / 设备 ID / 密钥,会自动换成占位符再推,工作副本不动。 - **一次授权,处处可用**:授权一次后存本机,之后所有对话自动读取,不再每次索要。 --- ## 两种授权方式(首次用选一种) ### 方式 A:粘贴自己的 PAT(单人最省事,兜底) 1. Gitee「设置 → 私人令牌」新建一枚,勾 `projects` 权限。 2. 把令牌粘给模型一次。存进本机隔离文件,**不进仓库 / 不进聊天 / 不进任何配置**。 3. 之后全自动。 ### 方式 B:点链接一键登录(分发首选,用户零粘贴) 1. 模型给你一条授权链接,点开 → 浏览器登录 Gitee → 授权。 2. 本机自动换好 token 存好,页面显示"授权成功"。 3. **全程你不用看、不用粘那一串 token 字符串。** > 方式 B 的 `client_secret` 由部署者的 CloudBase 云函数代持,**技能文件里零 secret**——公开下载也不会泄露任何凭据。详见下方「分发者部署」。 --- ## 安全性(为什么可放心公开分发) - ✅ 真实令牌只存**用户自己本机** `~/.workbuddy/secrets/gitee_token.json`,不进技能文件、不进仓库、不进聊天。 - ✅ 技能本体**不含任何 client_secret**(只有公开的 client_id 和云函数地址)。 - ✅ 发布到公开仓库前强制脱敏。 - ⚠️ 令牌文件仅本机当前用户可读;若机器多人共用或曾泄露,删掉该 json 即吊销。 --- ## 分发者部署(想让"方式 B 一键授权"对世界可用) 技能已内置云函数源码 `oauth-proxy/`(Node18 HTTP 函数,零外部依赖): 1. 在 Gitee「设置 → 第三方应用」创建应用:回调 `http://localhost:8765/gitee-callback`,权限勾 `user_info` + `projects`,拿到 `client_id` / `client_secret`。 2. 在 CloudBase 建 HTTP 云函数(Nodejs18),上传 `oauth-proxy/` 下 `index.js` + `scf_bootstrap` + `package.json`。 3. 配置环境变量:`GITEE_CLIENT_ID`、`GITEE_CLIENT_SECRET`(真实 secret)、`GITEE_REDIRECT_URI=http://localhost:8765/gitee-callback`;函数安全规则允许匿名调用。 4. 拿到函数地址,填入 `SKILL.md` 顶部「OAuth 配置」的 `CLOUDBASE_TOKEN_URL`。 完成后,**别人拿到这个技能即可点链接授权**,你不用把 secret 交给任何人。 --- ## 已踩平的 Gitee 坑(写进流程,不用重踩) - 建仓 body 传 `private:false` 仍会被建成 private → 用 `PATCH` 改。 - 空仓库直接设公开报「空仓库不支持设置为公开仓库」→ **先 push 首提交,再 PATCH 设公开**。 - push 必须用 `用户名:令牌` 形式,且全程 `-c credential.helper=` 不落盘凭据。 --- ## 许可证 MIT(可自由分发、修改、二次发布)。保留原作者署名即可。