151 lines
12 KiB
Markdown
151 lines
12 KiB
Markdown
# dww11 自动化流程检查与 Git 文件清单
|
|
|
|
检查日期：2026-10-31（北京时间）。本轮仅检查本地说明、源码和离线测试；没有访问网站、消耗下载 API 额度、登录、上传或发表，最初检查时未执行 Git 操作。用户随后已确认仓库范围并授权本地初始化和首次提交；下面保留检查发现，并补充本次整理结果。
|
|
|
|
## 一、检查结论
|
|
|
|
当前是可以人工衔接的组件集合，尚不是已实现的端到端自动流程。
|
|
|
|
```text
|
|
探数 Key → 下载 Markdown 和图片
|
|
→ 手工选择文章目录，或运行打包器生成文章包
|
|
→ 已登录的论坛新帖页面导入并上传图片
|
|
→ 点击独立“一键排版”并核对标题、正文、配图和来源
|
|
→ 用户审核并亲手点击发表
|
|
→ 核对受理/审核结果，登记去重，再决定下一篇或换号
|
|
```
|
|
|
|
发表与再次尝试发表均由用户亲手点击，这是现有流程规范要求。下载器、打包器、导入器、排版器和换号扩展之间没有完整的任务调度连接。
|
|
|
|
## 二、逐环节检查
|
|
|
|
| 环节 | 主要文件 | 当前能力 | 缺口或注意事项 |
|
|
| --- | --- | --- | --- |
|
|
| 下载 | `tanshuapi_news_downloader/app.py`、`article_writer.py`、`static/` | 频道、分页、正文图片落盘、下载历史去重、进度和停止 | 下载历史仅保存指纹与目录，没有供发布队列可靠消费的完整文章清单和完成标记；停止需要等待当前请求/保存结束 |
|
|
| 打包 | `dww11_make_package.py` | 将目录转换为 v1 Markdown/base64 图片包；可直接作为 Python 函数调用 | 不会自动把文章送进浏览器；仅收集 JPG/JPEG/PNG/GIF，没有完整的 Markdown 引用预检或整包大小上限 |
|
|
| 导入 | `dww11-article-importer.user.js` | 选目录或文章包、预览、按正文引用上传、附件登记、填写校验与失败回滚 | 标题超过 80 个 Unicode 码点直接拒绝；没有对外取消接口；非空编辑器确认仍使用模态弹窗 |
|
|
| 排版 | `dww11-wechat-oneclick.user.js` v1.0.9 | 独立“一键排版”，识别文末来源并重建尾注；无来源时要求补充 | 没有公开可等待/取消的排版接口，仍有 prompt/alert；复杂尾注、重复执行和发布后的图片位置仍需浏览器回归 |
|
|
| 发布 | `auto_news_upload/` 两份流程文档和两份记录 JSON | 已有单篇人工操作的历史记录 | 本目录没有完整发布执行程序、持久任务库、自动受理计数、全量历史对账或统一终止功能 |
|
|
| 换号 | `dww11-extension/` v3.0.4 | CSV 导入、扩展 IndexedDB 帐号库、抽号与登录、暂停恢复 | 未与文章任务的 min/max、受理计数和统一终止联动；扩展内部路由不能直接视作油猴接口 |
|
|
|
|
### 优先处理的问题
|
|
|
|
1. **图片格式衔接不一致。** 下载器可保存 WebP/AVIF/SVG，打包器和导入器只支持 JPG/JPEG/PNG/GIF。打包器会跳过不支持格式，导入时可能报缺图；应在打包/入队前给出明确错误，或另外实现保留原文件的转码。
|
|
2. **长标题衔接未实现。** 规范要求保留原题并派生截断标题，现导入器却在编译时直接拒绝超过 80 字的标题。需在导入前生成并展示提交标题，站点真实计数方式仍需实测。
|
|
3. **缺少可靠调度和统一终止。** 下载完成不等于可以发布；目录存在也不等于完整保存。现有模块停止行为不贯通，不能直接启动无人看管的批量链路。
|
|
4. **发布去重仍是手工记录。** 下载去重不能替代跨帐号、跨版块的发布去重。需要持久队列、未决结果核对、唯一受理登记及恢复逻辑。
|
|
5. **历史样本的图片位置有异常。** 原记录显示 26 张图片中正文 21 张、附件区 5 张，总数相同不能证明位置正确。应按附件 ID 对照最终待提交快照与结果页。
|
|
6. **旧路径已整理。** 原导入测试与打包说明引用了搬迁前目录；首次提交准备时改用 `tests/fixtures/article/` 的自造 Markdown 和 PNG，消除 legacy 依赖。
|
|
7. **扩展测试资料缺失。** 扩展 README 提到 `tests/core.test.mjs`、`tests/browser-integration.mjs`、`tests/browser-restart.mjs` 和 `测试说明.md`，当前项目中未找到，不能把文档中的历史测试声明当成本轮复验结果。
|
|
|
|
历史记录中的主题 23697411 已被网站受理并显示审核中，必须保留其本地去重证据。本轮没有核实现在是否已经公开。
|
|
|
|
## 三、运行时需要帐号或凭据的文件
|
|
|
|
下表区分“程序需要凭据才能运行”和“源码里保存真实凭据”。程序需要登录不代表源码不能进入 Git。
|
|
|
|
| 文件 | 所需帐号/凭据 | 使用和保存方式 | Git 建议 |
|
|
| --- | --- | --- | --- |
|
|
| `tanshuapi_news_downloader/app.py` | 探数 API Key | 调用新闻 API；Key 从页面传入，在运行内存使用 | 源码可纳入；不写入真实 Key |
|
|
| `tanshuapi_news_downloader/static/app.js`、`static/index.html` | 用户填写探数 API Key | 页面输入和内存变量，经本机会话接口传给服务；源码未配置固定 Key | 可纳入 |
|
|
| `dww11-article-importer.user.js` | 已登录的大湾网帐号及页面上传凭据 | 从当前页面读取上传参数，使用当前登录会话上传图片；无须写入密码 | 可纳入源码 |
|
|
| `dww11-wechat-oneclick.user.js` | 发布页面的登录会话 | 独立排版入口在当前编辑器操作；微信 URL 入口属于另一条采集路径 | 可纳入源码 |
|
|
| `dww11-extension/manager.js`、`manager.html`、`core.js` | 帐号 CSV | 选择、解析、确认导入帐号和密码 | 可纳入程序及虚拟模板，排除真实 CSV |
|
|
| `dww11-extension/db.js`、`service.js` | 扩展帐号库 | 明文密码保存在浏览器扩展来源的 IndexedDB；列表返回时去除密码 | 可纳入程序；排除浏览器资料及数据库备份 |
|
|
| `dww11-extension/background.js`、`content.js` | 当前抽取的帐号和密码 | 扩展消息传递，并填入目标网站登录表单 | 可纳入程序 |
|
|
| `today-jobs.user.js` | 可访问招聘管理列表的登录帐号/权限 | 使用当前页面和同源会话读取职位 | 辅助功能，按需纳入 |
|
|
| `dww-today-threads.user.js` | 论坛后台管理权限与页面 formhash | 使用当前管理会话执行统计查询 | 辅助功能，按需纳入 |
|
|
| `legacy/acc_switch_lite_python_legacy/server.py`、两个 lite 目录的 `import_excel.py` 与换号油猴脚本 | 旧版帐号文件、Excel 和网站登录 | 旧版实现；与当前扩展分开 | 不属于当前主链路；归档时排除真实数据 |
|
|
| `legacy/acc_switch_heavy_sqlite_legacy/init_db.py`、`import_excel.py` | 旧版帐号 Excel/数据库 | 可生成并导入保存密码的 `accounts.db` | 不属于当前主链路；数据库不纳入 |
|
|
|
|
`dww11_make_package.py` 仅处理本地文件，不需要帐号、API Key 或网站 Cookie。
|
|
|
|
## 四、已经存在的帐号数据文件：排除真实版本
|
|
|
|
| 文件 | 本轮确认 | 建议 |
|
|
| --- | --- | --- |
|
|
| `账号密码-去重可导入.csv` | 表头外 1152 条数据行、3 列；为真实帐号导入文件 | 本地保留，不纳入 Git |
|
|
| `legacy/acc_switch_lite/accounts.json` | 169 条帐号记录，169 个非空 password 字段 | 本地保留，不纳入 Git |
|
|
| `legacy/acc_switch_lite_python_legacy/accounts.json` | 169 条帐号记录，169 个非空 password 字段 | 本地保留，不纳入 Git |
|
|
|
|
以上仅统计结构和数量，不展示用户名、密码或密钥。没有执行帐号有效性验证，也没有核对 CSV 行与 JSON 记录之间的对应关系。
|
|
|
|
当前扩展运行帐号库在浏览器内，不在 `dww11-extension/` 源码目录。不要把浏览器配置目录、Cookie 导出文件或 IndexedDB 备份作为源码提交。`example.csv` 是示例模板，需保持为虚拟凭据。
|
|
|
|
## 五、拟纳入 Git 的文件清单
|
|
|
|
### A. 当前主链路源码与说明
|
|
|
|
```text
|
|
dww11_make_package.py
|
|
dww11-article-importer.user.js
|
|
dww11-wechat-oneclick.user.js
|
|
本地文章导入脚本使用说明.md
|
|
tanshuapi_news_downloader/app.py
|
|
tanshuapi_news_downloader/article_writer.py
|
|
tanshuapi_news_downloader/requirements.txt
|
|
tanshuapi_news_downloader/start.command
|
|
tanshuapi_news_downloader/README.md
|
|
tanshuapi_news_downloader/.gitignore
|
|
tanshuapi_news_downloader/static/index.html
|
|
tanshuapi_news_downloader/static/app.js
|
|
tanshuapi_news_downloader/static/style.css
|
|
tanshuapi_news_downloader/tests/test_downloader.py
|
|
dww11-extension/manifest.json
|
|
dww11-extension/background.js
|
|
dww11-extension/content.js
|
|
dww11-extension/core.js
|
|
dww11-extension/db.js
|
|
dww11-extension/service.js
|
|
dww11-extension/manager.html
|
|
dww11-extension/manager.js
|
|
dww11-extension/manager.css
|
|
dww11-extension/example.csv
|
|
dww11-extension/README.md
|
|
auto_news_upload/实施计划.md
|
|
auto_news_upload/发布流程操作记录与自动化规范.md
|
|
auto_news_upload/流程检查与Git文件清单.md
|
|
```
|
|
|
|
两份流程文档的帐号名称、UID 和电脑绝对路径已匿名化，原版保存在被排除的 `auto_news_upload/local-records/`。历史帖子编号与链接保留为受理证据说明。本文不含密码，但也引用了本地敏感文件名和数量，可按仓库公开范围进一步精简。
|
|
|
|
### B. 修复或检查后再决定
|
|
|
|
- `test-dww11-importer.cjs`：已改用仓库内自造测试稿与三张 PNG，一并纳入首次提交。
|
|
- `auto_news_upload/演示任务记录.json`、`发布去重记录.json`：属于真实运行状态。建议保留本地，另提供匿名结构模板；不因 Git 排除而删除原去重记录。
|
|
- `dww11-extension-3.0.4.zip`：本轮逐文件比对，与当前扩展目录的 11 个文件一致。可作为发行附件；日常优先跟踪源码，避免双份维护。
|
|
- `today-jobs.user.js`、`dww-today-threads.user.js`：辅助工具，不是四步主流程的必需文件，按你的范围选择。
|
|
- `.wechat-script-test/`：本地排版验证页、源码副本、截图和结果，需整理为可复现测试后再选择纳入。
|
|
- `legacy/`：默认不进入主链路首批提交；若保留历史实现，必须逐项排除帐号数据、虚拟环境、缓存及下载文章。
|
|
- `credits-video/`：滚动字幕视频工具，与本次流程无直接关系，默认不纳入本批。
|
|
|
|
### C. 建议排除的本地产物
|
|
|
|
真实帐号 CSV/JSON、下载文章及图片、下载历史数据库、真实发布记录与截图、文章包 `*.dww11.json`、浏览器配置和 Cookie、`.venv/`、`__pycache__/`、`*.pyc`、`.DS_Store`、视频输出和临时诊断文件。
|
|
|
|
首次提交准备时已增加根目录 `.gitignore`，覆盖真实帐号、运行记录、下载目录及本批范围之外的组件；按白名单添加源码和说明。
|
|
|
|
## 六、本轮验证结果
|
|
|
|
| 检查 | 结果 |
|
|
| --- | --- |
|
|
| Git 状态 | 当前目录不是 Git 仓库；本轮没有新建仓库 |
|
|
| 原始导入测试 `node --test test-dww11-importer.cjs` | 8 项中 3 项通过、5 项因旧素材目录不存在失败 |
|
|
| 只在内存中修正素材路径后执行同一测试 | 8/8 通过，覆盖打包与直接导入一致、缺图/长标题拦截、上传失败保留原文、富文本丢图回滚、无发表请求；磁盘测试文件未修改 |
|
|
| 下载器单元测试 | 默认 Python 3.15 与 Python 3.12 均因缺少 `requests` 无法加载测试；未安装依赖，不能认定通过或认定下载逻辑失败 |
|
|
| JavaScript 语法 | 6 个扩展 JS 按 ES 模块检查通过；4 个根目录油猴脚本检查通过 |
|
|
| Python 语法 | 打包器、下载器 app 与保存器均通过语法解析 |
|
|
| 扩展 ZIP | 11 个文件与源码目录逐一一致 |
|
|
| 在线验收 | 本轮未执行；历史文档中的单篇演示不等于当前版本全链路验收 |
|
|
|
|
## 七、首次提交整理范围
|
|
|
|
用户已授权新建本地仓库并完成 initial commit，范围为总流程文档、当前换号扩展、新闻下载器、文章打包/导入/排版及相关说明与测试。
|
|
|
|
- 增加根目录 README 与 `.gitignore`。
|
|
- 导入测试改用项目自有测试稿及三张程序生成的 PNG，修正打包说明路径。
|
|
- 原始流程说明备份到本地排除目录，再匿名化仓库文档中的帐号名称、UID 与电脑路径。
|
|
- 真实帐号、下载历史、演示 JSON、截图及原始说明均保留本地，不纳入提交。
|
|
- 下载器测试仍需先安装依赖，扩展缺失的测试文件尚未补齐；不以首次提交表示全流程已经完成。
|
|
- 本次只建立本地版本历史，未配置远程仓库或推送。
|