diff --git a/README.md b/README.md index c523905..120be00 100644 --- a/README.md +++ b/README.md @@ -1,36 +1,61 @@ -# VCG 上传助手 +
+ VCGVisionHelper：把 CSV 里的标题和关键词批量填入 VCG 草稿页 -一个面向视觉中国供稿人的本地 Chrome 扩展。它读取 CSV 文件，按图片文件名匹配草稿，并辅助填写标题和关键词。 + # VCGVisionHelper -项目坚持三个原则：数据只在本地处理、用户保留最终确认权、代码保持可审计。 + **把 CSV 里的标题和关键词，批量填入 VCG 草稿页。** -## 功能 + 免费开源 · 纯本地处理 · 不上传数据 · 不自动提交 -- 支持 UTF-8、UTF-8 BOM、GB18030/GBK CSV -- 支持引号内逗号、换行和双引号 -- 导入前检查表头、空字段、重复文件名和关键词数量 -- 按 `title="文件名"` 精确匹配图片，不拼接不安全的 CSS 选择器 -- 兼容 React/Vue 受控输入框 -- 提供暂停、继续、立即停止、进度和逐条结果 -- 处理完成后可导出 CSV 报告 -- 不读取账号密码，不上传 CSV，不请求任何外部接口 -- 不自动点击最终提交，结果由用户检查后提交 + [![Release](https://img.shields.io/github/v/release/KanadeK/VCGVisionHelper?display_name=tag&sort=semver&style=flat-square)](https://github.com/KanadeK/VCGVisionHelper/releases/latest) + [![CI](https://img.shields.io/github/actions/workflow/status/KanadeK/VCGVisionHelper/ci.yml?branch=main&style=flat-square&label=checks)](https://github.com/KanadeK/VCGVisionHelper/actions/workflows/ci.yml) + [![License](https://img.shields.io/github/license/KanadeK/VCGVisionHelper?style=flat-square)](LICENSE) + ![No telemetry](https://img.shields.io/badge/telemetry-none-16794a?style=flat-square) -## 安装 + [下载最新版](https://github.com/KanadeK/VCGVisionHelper/releases/latest) · [1 分钟安装](#安装) · [下载 CSV 示例](docs/sample.csv) · [使用说明](docs/USAGE.md) +
+ +> [!IMPORTANT] +> 这是一个减少重复录入的**填写助手**，不是自动投稿机器人。它不负责登录、不上传图片、不抓取平台数据，也不会点击最终提交；填写结果始终由你检查并提交。 + +## 它解决什么问题 + +在 VCG 供稿草稿页逐张复制标题和关键词，耗时而且容易贴错。VCGVisionHelper 把这个过程压缩成一条可检查的本地流程： + +```text +准备 CSV → 导入并校验 → 按文件名匹配草稿 → 填写标题和关键词 → 导出报告 → 人工确认提交 +``` + +| 你关心的 | VCGVisionHelper 的做法 | +| --- | --- | +| 会不会传走 CSV？ | 不会。文件只在浏览器内存中解析。 | +| 会不会填错图片？ | 按带后缀的完整文件名精确匹配，并逐条记录结果。 | +| 页面卡住怎么办？ | 网页右上角提供暂停、继续和立即停止。 | +| 填完会直接提交吗？ | 不会。最终提交必须由用户手动完成。 | +| 需要购买卡密吗？ | 不需要。项目采用 MIT 许可证，永久免费开源。 | + +## 界面 -### 从 Release 安装 +
+ VCGVisionHelper 扩展弹窗 +
-1. 打开仓库的 [Releases](https://github.com/KanadeK/VCGVisionHelper/releases)。 -2. 下载 `VCGVisionHelper-v1.1.0.zip`，不要下载 GitHub 自动生成的 Source code 压缩包。 -3. 解压到固定目录。 -4. 打开 `chrome://extensions/`。 -5. 开启开发者模式，点击“加载已解压的扩展程序”，选择解压目录。 +导入前会检查表头、空字段、重复文件名和关键词数量；运行时可在网页悬浮控制台查看进度、暂停或停止；完成后可导出逐条处理报告。 + +## 安装 -Chrome 和基于 Chromium 的新版 Edge 均可使用。 +1. 打开 [最新 Release](https://github.com/KanadeK/VCGVisionHelper/releases/latest)。 +2. 下载附件 `VCGVisionHelper-v1.1.0.zip`。**不要下载** GitHub 自动生成的 Source code 压缩包。 +3. 解压到一个固定目录。 +4. 在 Chrome 打开 `chrome://extensions/`，开启“开发者模式”。 +5. 点击“加载已解压的扩展程序”，选择刚才的解压目录。 +6. 首次使用前刷新已经打开的 VCG 页面。 -## CSV 格式 +同样适用于基于 Chromium 的新版 Microsoft Edge；对应扩展管理页为 `edge://extensions/`。 -表头必须包含以下三列： +## 准备 CSV + +表头必须包含 `file_name`、`title`、`keywords` 三列： ```csv file_name,title,keywords @@ -39,26 +64,47 @@ IMG_0001.jpg,清晨湖面上的薄雾,"湖泊,薄雾,清晨,自然,风景" - `file_name`：包含后缀，并与网页显示的文件名完全一致。 - `title`：单行标题。 -- `keywords`：5-35 个关键词，使用英文逗号分隔。 +- `keywords`：5–35 个关键词，使用英文逗号分隔。 +- 编码：支持 UTF-8、UTF-8 BOM、GB18030 和常见 GBK CSV。 -示例文件见 [`docs/sample.csv`](docs/sample.csv)。 +可以直接下载 [`docs/sample.csv`](docs/sample.csv) 作为模板。CSV 内含逗号、换行或双引号时，扩展也能按标准 CSV 规则解析。 -## 使用 +## 开始填写 -1. 登录视觉中国供稿人后台，进入待编辑草稿页面并刷新。 -2. 点击扩展图标，选择 CSV 文件。 -3. 检查导入预览与校验结果。 +1. 登录 VCG 供稿人后台，进入待编辑草稿页面并刷新。 +2. 点击扩展图标，选择 CSV。 +3. 检查导入预览，并修正所有校验错误。 4. 点击“开始填写”。 -5. 通过网页右上角控制台暂停、继续或停止。 -6. 完成后检查标题、关键词与处理报告，再由你手动提交。 +5. 在网页右上角查看进度，需要时暂停、继续或停止。 +6. 完成后导出报告，人工核对标题与关键词，再手动提交。 + +建议第一次只用 2–3 张图片验证当前页面兼容性。更完整的故障排查见 [使用说明](docs/USAGE.md)。 + +## 功能与边界 + +### 已支持 + +- 用完整文件名精确匹配当前页面中的图片 +- 兼容 React/Vue 等受控输入框 +- 写入单行标题，并触发网站关键词分词流程 +- 逐条等待、失败隔离、暂停、继续和立即停止 +- 导出成功、失败、跳过结果的 CSV 报告 +- 确定性构建 ZIP 和 SHA-256 校验文件 +- 零第三方运行时依赖、零遥测、零外部接口 -完整说明见 [`docs/USAGE.md`](docs/USAGE.md)。 +### 不支持 + +- 自动登录、自动上传图片或自动提交稿件 +- 抓取平台数据、绕过验证码、访问控制或平台限制 +- 替代用户检查标题、关键词、版权与供稿合规性 + +VCG 页面结构发生变化时，DOM 适配可能需要更新。遇到问题请先停止任务，并提交一份不含账号、Cookie、合同或未公开原图的 [Bug 报告](https://github.com/KanadeK/VCGVisionHelper/issues/new?template=bug-report.yml)。 ## 隐私与安全 -扩展不包含统计、遥测、广告、卡密验证或网络请求。CSV 只在当前浏览器内存中解析，并发送给当前活动的 VCG 页面。详见 [`PRIVACY.md`](PRIVACY.md)。 +扩展不包含统计、遥测、广告、卡密验证或网络请求。CSV 只在当前浏览器内存中解析，并发送给当前活动的 VCG 页面。详见 [隐私说明](PRIVACY.md) 与 [安全策略](SECURITY.md)。 -本工具用于减少重复录入，不用于抓取平台数据、绕过访问控制或替代人工审核。使用前请确认你的供稿协议和平台规则允许相应辅助操作。 +本项目是独立的开源工具，与视觉中国或其关联公司不存在官方隶属、授权或背书关系。使用前请确认你的供稿协议和平台规则允许相应的辅助操作。 ## 本地开发 @@ -71,21 +117,21 @@ npm run build npm run check ``` -`npm run build` 会生成： - -- `dist/VCGVisionHelper-v1.1.0.zip` -- `dist/VCGVisionHelper-v1.1.0.zip.sha256` - -构建脚本使用固定 ZIP 元数据，同一源码会产生相同字节和 SHA-256。 +`npm run build` 会生成扩展 ZIP 与 SHA-256 文件。同一份源码会生成相同字节的构建产物。 -## 参与贡献 +## 参与维护 -问题报告和改进建议请阅读 [`CONTRIBUTING.md`](CONTRIBUTING.md)。安全问题请按 [`SECURITY.md`](SECURITY.md) 中的方式反馈。 +- 使用问题与改进建议：[Issues](https://github.com/KanadeK/VCGVisionHelper/issues) +- 贡献说明：[CONTRIBUTING.md](CONTRIBUTING.md) +- 版本变化：[CHANGELOG.md](CHANGELOG.md) +- 商店上架文案与素材清单：[docs/STORE_LISTING.md](docs/STORE_LISTING.md) -## 赞助与反馈 +
+ 赞助项目 -扩展内保留微信和支付宝赞助二维码。反馈邮箱：`1207048080@qq.com`。 + 如果这个工具确实节省了你的时间，可以在扩展内自愿支持维护。赞助不解锁功能，也不会影响使用。 +
## 许可证 -[MIT](LICENSE) +[MIT](LICENSE) © KanadeK diff --git a/docs/LAUNCH_KIT.md b/docs/LAUNCH_KIT.md new file mode 100644 index 0000000..6f9023e --- /dev/null +++ b/docs/LAUNCH_KIT.md @@ -0,0 +1,91 @@ +# 发布推广素材 + +推广时使用“批量填写”而不是“全自动上传”，避免让用户误解功能边界。不要宣传“绕过风控”“防封”或其他无法验证、也不符合项目定位的能力。 + +## 核心定位 + +**给 VCG 供稿人的免费开源小工具：用 CSV 批量填写草稿标题和关键词，数据留在本地，最后由你确认提交。** + +## 推荐发布顺序 + +1. **GitHub 项目页**：作为唯一可信下载入口，所有内容都引导用户搜索 `VCGVisionHelper`。 +2. **Microsoft Edge Add-ons**：个人开发者可免费注册，先获得可搜索、一键安装的商店入口。 +3. **Chrome Web Store**：完成一次性开发者注册后提交同一套 Manifest V3 扩展。 +4. **小红书首发**：发布“痛点 + 真实演示 + 免费开源”的 30–60 秒内容，不只贴项目链接。 +5. **B 站教程**：用 60 秒到 3 分钟讲清安装、CSV 格式、运行与人工确认。 +6. **精准社群**：在 VCG 供稿人、图库摄影师和摄影工作流群中征得管理员同意后分享，优先寻找 10 位真实测试者。 + +扩展商店是长期搜索入口，小红书和 B 站负责第一次看见，GitHub 负责建立信任与承接反馈。不要把主要精力放在泛程序员社区；这个项目的用户是供稿人，不是开发者。 + +- [Chrome Web Store 开发者注册](https://developer.chrome.com/docs/webstore/register) +- [Microsoft Edge Add-ons 发布说明](https://learn.microsoft.com/microsoft-edge/extensions/publish/publish-extension) + +## 小红书首发文案 + +### 标题 + +视觉中国供稿人：我把重复填标题关键词做成了免费插件 + +### 正文 + +每次给一批图片逐张复制标题、关键词，最麻烦的不是难，而是重复、容易贴错。 + +所以我做了一个免费的开源 Chrome 扩展：准备一份 `file_name / title / keywords` 三列 CSV，它会先校验数据，再按图片文件名匹配 VCG 草稿，辅助完成填写。 + +它不会上传 CSV，不读取账号密码，也不会替你点最终提交。运行中可以暂停、停止，结束后还能导出处理报告。 + +项目名：`VCGVisionHelper` + +GitHub：`KanadeK/VCGVisionHelper` + +第一次建议只试 2–3 张，确认页面兼容后再处理大批次。如果你遇到页面适配问题，欢迎带脱敏截图提 Issue。 + +### 标签建议 + +`#视觉中国` `#摄影师` `#图库供稿` `#摄影工作流` `#Chrome插件` `#开源工具` `#效率工具` + +## 60 秒演示脚本 + +| 时间 | 画面 | 字幕/旁白 | +| --- | --- | --- | +| 0–5 秒 | 一批待填写草稿 | “一批图片，标题和关键词还要逐张复制？” | +| 5–12 秒 | 打开三列 CSV | “准备文件名、标题、关键词三列 CSV。” | +| 12–22 秒 | 导入扩展，展示校验 | “插件先在本地校验，不上传文件。” | +| 22–38 秒 | 点击开始，展示进度控制台 | “按文件名匹配草稿，运行中随时暂停或停止。” | +| 38–48 秒 | 展示填写后的页面 | “标题和关键词填好，但不会自动提交。” | +| 48–55 秒 | 导出报告 | “成功、失败、跳过都有报告可查。” | +| 55–60 秒 | GitHub 项目页 | “免费开源，搜索 VCGVisionHelper。” | + +录屏必须使用虚构内容或已经公开的测试素材，并遮盖账号、头像、合同信息和未公开原图。 + +## B 站标题与简介 + +### 标题 + +我做了个免费开源的 VCG 供稿批量填写插件｜CSV 自动匹配标题关键词 + +### 简介 + +VCGVisionHelper 用本地 CSV 匹配 VCG 草稿页中的图片，辅助填写标题和关键词。项目免费开源，不上传 CSV，不自动提交稿件。 + +项目地址：`https://github.com/KanadeK/VCGVisionHelper` + +视频章节：安装 / CSV 格式 / 批量填写 / 暂停与报告 / 隐私说明 + +## 回复常见疑问 + +### 会不会封号？ + +不能承诺任何平台账号风险。项目不绕过登录、验证码或访问控制，也不自动提交；请先小批量测试，并遵守你的供稿协议和平台规则。 + +### 数据会上传吗？ + +不会。CSV 在浏览器本地内存中解析，扩展没有外部接口和遥测。 + +### 为什么不做 AI 自动写关键词？ + +当前版本专注于把用户已经准备好的元数据可靠地填入草稿页，不把图片或元数据发送给第三方。AI 生成可以作为未来可选、透明且明确授权的独立能力讨论。 + +### 为什么不自动提交？ + +标题、关键词和版权信息需要供稿人最终确认。保留人工提交也是项目明确的安全边界。 diff --git a/docs/STORE_LISTING.md b/docs/STORE_LISTING.md new file mode 100644 index 0000000..0fd6a6f --- /dev/null +++ b/docs/STORE_LISTING.md @@ -0,0 +1,79 @@ +# 扩展商店上架素材 + +这份文案用于 Chrome Web Store 与 Microsoft Edge Add-ons。上架时必须以实际版本行为为准，不要加入尚未实现的功能。 + +## 名称 + +**VCG 标题关键词助手** + +备选名称：**VCGVisionHelper - VCG 批量填写助手** + +## 一句话简介 + +从本地 CSV 按图片文件名匹配 VCG 草稿，辅助填写标题与关键词；不上传数据，不自动提交。 + +## 完整介绍 + +VCGVisionHelper 是一款面向 VCG 供稿人的免费开源浏览器扩展，用于减少逐张复制标题与关键词的重复操作。 + +准备包含 `file_name`、`title`、`keywords` 三列的 CSV，扩展会先在本地完成格式校验，再按完整文件名匹配当前草稿页中的图片，逐条填写标题和关键词。处理过程中可以暂停、继续或立即停止，结束后还可以导出逐条结果报告。 + +核心特点： + +- CSV 纯本地解析，不上传标题、关键词或页面内容 +- 支持 UTF-8、GB18030/GBK 和标准 CSV 引号规则 +- 按带后缀的完整文件名精确匹配 +- 支持暂停、继续、停止与处理报告 +- 不读取账号密码，不包含遥测、广告或卡密验证 +- 不自动执行最终提交，保留人工检查环节 + +首次使用建议只处理 2–3 张图片，并在提交前人工核对所有填写结果。 + +本扩展是独立的开源工具，与视觉中国或其关联公司不存在官方隶属、授权或背书关系。 + +## 搜索词 + +`VCG`、`视觉中国`、`供稿`、`标题`、`关键词`、`CSV`、`批量填写`、`图库摄影` + +## 权限说明 + +### activeTab + +仅在用户主动点击扩展并开始任务时，与当前活动的 VCG 页面通信。 + +### vcg.com 页面内容脚本 + +用于识别当前草稿页中的图片文件名、标题输入框和关键词输入区域，并显示本次任务的进度控制台。扩展不会把页面内容发送到外部服务器。 + +## 数据使用声明 + +- 不收集身份验证信息 +- 不收集个人通信 +- 不收集位置、浏览历史或用户活动 +- 不出售或向第三方传输用户数据 +- 不使用远程代码 +- CSV 与任务结果只在当前浏览器会话中处理 + +完整隐私说明：`https://github.com/KanadeK/VCGVisionHelper/blob/main/PRIVACY.md` + +## 素材清单 + +- [ ] 128 × 128 扩展图标 +- [ ] 1280 × 800 或 640 × 400 商店截图：CSV 导入与校验 +- [ ] 1280 × 800 或 640 × 400 商店截图：网页进度控制台 +- [ ] 1280 × 800 或 640 × 400 商店截图：处理完成与报告导出 +- [ ] 440 × 280 小型宣传图 +- [ ] 920 × 680 大型宣传图（可选） +- [x] 1280 × 640 GitHub 社交预览图：`docs/images/social-preview.png` + +所有截图必须使用虚构文件名和示例元数据，不得包含账号、Cookie、合同、未公开原图或其他真实供稿信息。 + +## 审核测试说明 + +1. 安装扩展后打开一个 VCG 草稿编辑页面并刷新。 +2. 点击扩展图标，导入三列表头的示例 CSV。 +3. 确认扩展展示导入预览和校验结果。 +4. 点击“开始填写”，观察网页右上角进度控制台。 +5. 扩展不会自动提交任何稿件；审核人员可以在填写后停止测试。 + +如果审核环境无法访问 VCG 供稿草稿页，请在提交备注中说明该功能依赖已登录的供稿人页面，并提供脱敏演示视频。 diff --git a/docs/images/hero.svg b/docs/images/hero.svg new file mode 100644 index 0000000..ec816e0 --- /dev/null +++ b/docs/images/hero.svg @@ -0,0 +1,70 @@ + + VCGVisionHelper + 把 CSV 里的标题和关键词批量填入 VCG 草稿页，免费开源并在本地处理。 + + + + + + + + + + + + + + + + + + + + + + VCG + VCGVisionHelper + 标题与关键词，批量填进 VCG 草稿页 + + + + + + 免费开源 + + + + + 纯本地处理 + + + + + 不自动提交 + + + + + + + + + + VCG + 批量填写助手 + CSV 只在本地解析 + + + 选择 CSV 文件 + file_name · title · keywords + + + + + 导入后先校验，再开始填写 + + + + 开始填写 + + diff --git a/docs/images/popup.png b/docs/images/popup.png new file mode 100644 index 0000000..1f7b83f Binary files /dev/null and b/docs/images/popup.png differ diff --git a/docs/images/social-preview.png b/docs/images/social-preview.png new file mode 100644 index 0000000..92b9372 Binary files /dev/null and b/docs/images/social-preview.png differ diff --git a/docs/images/social-preview.svg b/docs/images/social-preview.svg new file mode 100644 index 0000000..5439432 --- /dev/null +++ b/docs/images/social-preview.svg @@ -0,0 +1,76 @@ + + VCGVisionHelper social preview + VCG 标题关键词批量填写助手。免费开源，纯本地处理，不自动提交。 + + + + + + + + + + + + + + + + + + + + + + + VCG + + VCGVisionHelper + 标题与关键词，批量填进 VCG 草稿页 + + + + + + 免费开源 + + + + + 纯本地处理 + + + + + 不自动提交 + + + + github.com/KanadeK/VCGVisionHelper + + + + + + + + VCG + 批量填写助手 + CSV 只在本地解析 + + + 选择 CSV 文件 + file_name · title · keywords + + + + + 导入前校验数据 + + + 开始填写 + + 暂停 · 继续 · 停止 · 导出报告 + 最终提交由你确认 + +