前言¶
在 DeepSeek Harness（DSH）里做电商相关自动化时，常见需求是让智能体在真实浏览器环境里执行可移植的页面脚本，而不是把站点逻辑硬编码进单一工作流。需要 manifest 校验、隔离浏览器实例，以及可选的已保存登录态时，还要把配置路径和工具接口说清楚，便于审计与迁移。
社区目录 howtimeschange/dsh-crawshrimp-scripts 曾提供独立的「页脚本」插件能力；维护者 howtimeschange 已将后续开发迁入 dsh-crawshrimp-browser。下文先说明该插件在 v0.1.0 阶段的定位与能力，再交代当前仓库状态与迁移方式。目录站点 SkillHub 与 DeepSeek / 幻方无官方从属关系，安装前请自行核对源码与许可证（本包为 MIT）。
这是什么¶
dsh-crawshrimp-scripts 是面向 DSH 的独立插件包（npm 包名 dsh-crawshrimp-scripts，版本 0.1.0），简介为：在 DeepSeek Harness 中独立执行电商场景页面脚本，支持 manifest 校验、隔离的 Chrome，以及可选的已保存登录状态。
分类标签为 admin-security：插件以当前 DSH 进程权限运行，涉及浏览器路径、CDP 端点、私有登录态文件等配置时，应按最小权限原则检查配置与源码。
当前 GitHub 仓库已标明 standalone 退役：不再发布独立的 Scripts 0.2.0；网页侧能力在 dsh-crawshrimp-browser 维护。历史 v0.1.0 源码与 Release 仍保留供查阅。
核心功能（v0.1.0 可核实部分）¶
根据包描述与迁移文档中的工具对照，v0.1.0 阶段主要提供：
- 可移植页脚本：通过 DSH 工具在浏览器中执行 Crawshrimp 风格页面脚本，面向电商（ecommerce）场景。
- Manifest 校验：对脚本清单做校验（后续 Browser 插件提供独立的离线校验工具
crawshrimp_browser_script_validate，Scripts 侧迁移说明中标注为「无离线校验器」）。 - 隔离 Chrome：通过 Playwright Core（依赖
playwright-core@1.64.1）驱动浏览器；配置项包括browserChannel（迁移后改名为channel）、executablePath、cdpEndpoint等。 - 可选登录态：支持
storageStatePath指向已保存的登录状态；artifact 与工作区默认目录为~/.dsh-crawshrimp-scripts（除非在配置中显式指定workspaceDir）。 - DSH 工具（旧名）：
-crawshrimp_scripts_list：列出脚本；
-crawshrimp_scripts_run：运行脚本。
运行时要求（来自 package.json）：Node ^22.19.0 || >=24.0.0；DSH 引擎约束为 >=0.2.1-alpha.4 <0.2.1-alpha.5。
仓库现状与推荐路径¶
README 明确：本独立仓库已退役，Browser 可独立运行，不依赖本包或 Crawshrimp 后端。若你仍在使用本插件，应迁移到 Browser，并避免在同一 profile 中同时加载两个插件。
新能力（交互式页面操作、显式登录态、可移植脚本、参数校验、分页、实时预览与人工接管等）均在 Browser 仓库维护，详见其文档。
从 Scripts 迁移到 Browser¶
迁移时，把已配置的 adapter 根目录、artifact 工作区与私有登录态路径复制到 Browser 对应配置行；若需继续使用旧 artifact，请显式保留原 workspaceDir。然后卸载旧插件并安装 Browser：
dsh plugin --profile ecommerce remove -w dsh-crawshrimp-scripts
dsh plugin --profile ecommerce add -w github:howtimeschange/dsh-crawshrimp-browser#v0.2.0
dsh --profile ecommerce --dump-config
从 profile overlay 中删除自定义的 crawshrimp-scripts 行，改为配置 crawshrimp-browser 行；不要同时加载两个插件。
工具与配置对照（节选）：
| 旧（Scripts） | 新（Browser） |
|---|---|
crawshrimp_scripts_list |
crawshrimp_browser_script_list |
crawshrimp_scripts_run |
crawshrimp_browser_script_run |
| 无离线校验器 | crawshrimp_browser_script_validate |
browserChannel |
channel |
timeoutMs |
scriptTimeoutMs |
adapterRoots、workspaceDir、storageStatePath、executablePath、cdpEndpoint |
同名显式取值 |
默认工作区 ~/.dsh-crawshrimp-scripts |
默认 ~/.dsh-crawshrimp-browser（可显式覆盖） |
请更新已保存的 prompt / 工作流中的工具名。已有 artifact 与私有登录态文件不会被自动移动或删除。完整 manifest 子集与配置细节见 Browser 仓库 migration-from-scripts.md；中文说明见原仓库 README.zh-CN.md。
适用场景与注意¶
适合查阅或维护 v0.1.0 历史的开发者：需要理解旧工具名、默认工作区路径，或从 Scripts 迁到 Browser 的配置映射。
新接入电商页脚本自动化：应直接采用 dsh-crawshrimp-browser（安装命令见上文迁移步骤），而不是继续依赖已退役的独立 Scripts 包。
安全与合规：插件分类为 admin-security；浏览器可执行路径、CDP、登录态文件均敏感。安装任何 DSH 插件前，应在 GitHub 阅读源码与 LICENSE，并确认 profile 权限范围。社区目录当前展示版本为 v0.1.0、星标为 0，不代表官方背书。
结尾¶
dsh-crawshrimp-scripts 在 v0.1.0 阶段为 DSH 提供了独立的电商页脚本执行、manifest 校验与隔离浏览器能力；维护路线已并入 dsh-crawshrimp-browser。查阅目录与简介：SkillHub 插件页；仓库与迁移说明：GitHub — howtimeschange/dsh-crawshrimp-scripts。
