@collect-flow2/dsh
v0.35.0
Published
采集方案 V2 操作接口、skills 与 DSH 工作台入口
Readme
@collect-flow2/dsh
collect-flow-plugin 的 DSH 宿主包,包名保持 @collect-flow2/dsh,版本以本包 package.json 为准。全局图标挂载到 shell.overlay,位于页面右上角,复用 DSH 原生 Button 和 Tooltip,打开右侧抽屉,抽屉右上角提供刷新和关闭按钮。功能包括公告解析岗位、快速集成采集目标、采集方案生成、存量采集方案调度及结果看板。
从仓库根执行 npm run build,然后 npm run pack:dsh。生成包包含服务端路由、客户端入口和完整工作台 HTML,可独立安装到提供 shell.overlay 和 theme 服务的 DSH Web profile。本机固定目录由 node .scripts/release-dsh.mjs 准备,之后还需插件管理器安装、启用和实际宿主核验;打包完成不表示已采用。
分发形态的 cordis.patch.yml 只能插裸包名 @collect-flow2/dsh:DSH 的 dsh-client-modules 只把裸包名或路径/URL 认作插件来源,包内子路径行(@collect-flow2/dsh/entry-*)会被跳过,服务端半边仍能加载但客户端半边不注册,右上角入口按钮不会出现。dist/entry-* 仍随包提供,供 release-dsh.mjs 的固定目录用绝对路径入口做热重载;两条路径的差异由 test/hosts.test.mjs 与 npm run publish:dsh 的发布前校验守住。
发布到 npm 用 npm run publish:dsh(默认只构建、物化真实文件、裁剪历史入口、打包并执行 npm publish --dry-run 校验,产物写 ~/.artifacts/crawl-next/collect-flow-plugin/exports/<版本>-<id>/);确认后 npm run publish:dsh:release 真正上传,需要 2FA 时追加 -- --skip-build --otp <6 位码>。发布目录只保留当前 bundle 入口和 package.json 声明的字面量入口,files 白名单同时覆盖 index.js 的 host-services.mjs 依赖,.env 凭据不入包。已发布版本见 registry;当前可用版本为 @collect-flow2/[email protected](2026-10-21,registry.npmjs.org 公开包,shasum 56c4b2e563ba314e60bda130c1e65c51039cae28,与仓库 HEAD 2ce49a1 的本机校验产物一致)。0.30.0 是子路径 patch 的缺陷版本,装上去没有右上角入口按钮,不要使用。
界面改动前读取 DESIGN.md,按其中的原生组件、主题和检查清单复核。
快速适配网站采集方案 按 hostname 复用 Adapter/目标并生成当前范围的目标,附带无依赖只读定位脚本;Zhiye、Moka、Hotjob 的参数由命中 host 的 RULES.md 提供;其余官方平台族(除自建站 web)按参考目标复用或生成目标文件。全部已覆盖服务商(含 Zhiye)先执行一页 dry-run,再核对两条详情的可见 Markdown 与序列化提交 JSON,通过后按授权范围首采。当前受限自动执行器尚未完成该内容审计门禁,使用有权限的普通网站任务/CLI 路径;能力不足时保持未首采。完成按本轮 t_collect 新增和有效重复收据核验。读取规则不启动采集;安装与启用按用户授权处理。
包内 skills/ 与 dist/flow.mjs 提供领取、状态/阶段、元数据、岗位快照及 runtime 检索操作。Codex 同时提供同名 MCP 工具;DSH HTTP 操作路径为 /collect-flow2/api/v1/operations/<工具名>,仅接受 POST。通过 .env/.env.dev 或宿主环境配置 COLLECT_FLOW2_API_URL、COLLECT_FLOW2_API_TOKEN、CRAWLER_RUNTIME_ROOT。Token 只在服务器发送。开发验证使用隔离模拟 API,不对生产数据库领取或提交。
快速集成只处理网站方案,受限 API 覆盖 Zhiye/Moka/Hotjob;API quick-adapt 能力须为 1.0.0,runtime 需要支持 --allow-unverified。技能覆盖清单与自动执行器能力分别核对;读取和刷新不执行采集。当前本机安装状态和待部署事项记录在源码项目 README,不从本包版本推定已安装或启用。
