Skip to content

docs: repackage project presentation #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
KanadeK merged 1 commit into from
Aug 3, 2026
+407 −45
Merged

docs: repackage project presentation #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
136 changes: 91 additions & 45 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,36 +1,61 @@
# VCG 上传助手
<div align="center">
<img src="docs/images/hero.svg" alt="VCGVisionHelper：把 CSV 里的标题和关键词批量填入 VCG 草稿页" width="100%">

一个面向视觉中国供稿人的本地 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)
</div>

> [!IMPORTANT]
> 这是一个减少重复录入的**填写助手**，不是自动投稿机器人。它不负责登录、不上传图片、不抓取平台数据，也不会点击最终提交；填写结果始终由你检查并提交。

## 它解决什么问题

在 VCG 供稿草稿页逐张复制标题和关键词，耗时而且容易贴错。VCGVisionHelper 把这个过程压缩成一条可检查的本地流程：

```text
准备 CSV → 导入并校验 → 按文件名匹配草稿 → 填写标题和关键词 → 导出报告 → 人工确认提交
```

| 你关心的 | VCGVisionHelper 的做法 |
| --- | --- |
| 会不会传走 CSV？ | 不会。文件只在浏览器内存中解析。 |
| 会不会填错图片？ | 按带后缀的完整文件名精确匹配，并逐条记录结果。 |
| 页面卡住怎么办？ | 网页右上角提供暂停、继续和立即停止。 |
| 填完会直接提交吗？ | 不会。最终提交必须由用户手动完成。 |
| 需要购买卡密吗？ | 不需要。项目采用 MIT 许可证，永久免费开源。 |

## 界面

### 从 Release 安装
<div align="center">
<img src="docs/images/popup.png" alt="VCGVisionHelper 扩展弹窗" width="390">
</div>

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
Expand All @@ -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)。

本工具用于减少重复录入，不用于抓取平台数据、绕过访问控制或替代人工审核。使用前请确认你的供稿协议和平台规则允许相应辅助操作。
本项目是独立的开源工具，与视觉中国或其关联公司不存在官方隶属、授权或背书关系。使用前请确认你的供稿协议和平台规则允许相应的辅助操作。

## 本地开发

Expand All @@ -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)

## 赞助与反馈
<details>
<summary>赞助项目</summary>

扩展内保留微信和支付宝赞助二维码。反馈邮箱：`1207048080@qq.com`。
如果这个工具确实节省了你的时间，可以在扩展内自愿支持维护。赞助不解锁功能，也不会影响使用。
</details>

## 许可证

[MIT](LICENSE)
[MIT](LICENSE) © KanadeK
91 changes: 91 additions & 0 deletions docs/LAUNCH_KIT.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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 生成可以作为未来可选、透明且明确授权的独立能力讨论。

### 为什么不自动提交？

标题、关键词和版权信息需要供稿人最终确认。保留人工提交也是项目明确的安全边界。
79 changes: 79 additions & 0 deletions docs/STORE_LISTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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 供稿草稿页，请在提交备注中说明该功能依赖已登录的供稿人页面，并提供脱敏演示视频。
Loading
Loading