🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

抓虾工作台 howtimeschange/crawshrimp-harness

DeepSeek Harness
howtimeschange1 天前有提交已提供中文文档扫描:高危

用自然语言调度智能体完成电商运营与文档处理

30.8/100
综合分
1
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/11/2 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add howtimeschange/crawshrimp-harness
该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:仅索引
是什么
dsh 原生插件 · browser
装得上吗
本站尚未做安装检查
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
活跃:最近一次提交在 1 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
🔴 安全扫描发现高危能力自动 · 静态分析源码
v2.7.0
🔴 扫描:高危尚无人工评估

静态扫描发现安装期即执行代码,或命令参数由运行时变量拼接(参数来源无法静态判定,从严处理)。

命令参数由运行时变量拼接读写/删除本地文件写入剪贴板(不计风险)读取剪贴板或密钥环境变量发起外部网络请求
扫描于 2026/11/3(1 天前) · 范围 全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

抓虾 Harness|本地优先的桌面 AI 工作台,用自然语言处理网页、数据、文档与素材,让智能体完成重复工作。支持 macOS / Windows。

README

由 DeepSeek 最新模型翻译生成
Crawshrimp Harness / 抓虾智能体 访问抓虾 Harness 官网 · 查看介绍与下载 Crawshrimp Harness 把抓虾桌面应用与 DeepSeek Harness(DSH)组合成一个本地优先的电商运营智能体。DSH Web 会话是唯一主界面;抓虾提供任务、Adapter、文件、浏览器 CDP、媒体、审批和审计能力。 本仓库是独立的 Harness 开发线,不是上游 crawshrimp 发布仓的 README 镜像。当前桌面版本为 0.4.10,DSH 依赖族精确锁定在 @deepseek-ai/dsh@0.2.1-rc.2 与 @xmanrui/dsh-im@4.11.0;升级时必须重新验证 Web Profile/RPC、插件和 hash 类名。 合作交流与赞助 欢迎联系作者,交流本地 AI 智能体、电商任务编排与浏览器、文件和 Office 工作流,探讨工具接入、场景落地和项目合作,或赞助支持 Harness 持续开发。 使用微信扫描下方二维码添加好友,备注「抓虾 Harness + 合作 / 交流 / 赞助」即可。 个人账号与云端边界 Harness 面向个人本地使用,本地功能免登录。
展开完整文档(README 剩余 1 节)
Crawshrimp Harness / 抓虾智能体

访问抓虾 Harness 官网 · 查看介绍与下载

Crawshrimp Harness 把抓虾桌面应用与 DeepSeek Harness(DSH)组合成一个本地优先的电商运营智能体。DSH Web 会话是唯一主界面;抓虾提供任务、Adapter、文件、浏览器 CDP、媒体、审批和审计能力。

本仓库是独立的 Harness 开发线,不是上游 crawshrimp 发布仓的 README 镜像。当前桌面版本为 0.4.10,DSH 依赖族精确锁定在 @deepseek-ai/dsh@0.2.1-rc.2 与 @xmanrui/dsh-im@4.11.0;升级时必须重新验证 Web Profile/RPC、插件和 hash 类名。

合作交流与赞助

欢迎联系作者,交流本地 AI 智能体、电商任务编排与浏览器、文件和 Office 工作流,探讨工具接入、场景落地和项目合作,或赞助支持 Harness 持续开发。

使用微信扫描下方二维码添加好友,备注「抓虾 Harness + 合作 / 交流 / 赞助」即可。

个人账号与云端边界

Harness 面向个人本地使用,本地功能免登录。个人账号通过 ModelJetty 网页授权登录(OIDC + PKCE),可使用账号已开放的官方模型、查看套餐与额度,以及访问脚本市场;也可以配置自己的模型服务商与 API Key。模型可用性、上下文预算和用量以服务端目录与记录为准。

登录会话通过系统加密保存,账号登录不授予远程执行权限;本地 DSH 权限审批继续生效。请求中断后可以按原请求编号只读核对状态,未知结果不会自动重发。长期记忆保存在本机,工作区、全局与历史账号记忆保持各自范围;当前版本面向桌面使用,跨设备能力继续在后续版本开发。

当前形态

- 会话文件工作区支持持久标签、双栏比较、连续 Office / PDF 阅读及预览状态恢复。
- 会话浏览器支持内嵌和浮窗预览、鼠标键盘输入;设置页支持查看与恢复归档会话。
- 设置页支持管理内置和自定义服务商的模型列表;DeepSeek 和 GLM 支持发现上游模型后选择导入。
- 普通定时任务复用固定会话及其当前模型、工具与权限;任务中心支持直接调度已安装脚本。
- 默认安装包采用轻量 Office 运行时,首次需要原生预览、转换或字体资源时按需下载并校验。
- ModelJetty 官方模型与自备 Key 模型分别路由;账号切换或官方模型不可用时,不静默切换到其他计费来源。
- 本地长期记忆支持查询、保存、纠正和删除;文件产物保存会话内版本快照,超出快照限制时明确提示并提供经过校验的原文件入口。
- 图片和 PDF 预览在隐藏时释放图片资源或文档 Worker,保留缩放与阅读位置;后台资源轮询降低频率。
- Electron 44.7.0 主进程启动 FastAPI、托管 Chrome 和 Node Worker。
- FastAPI 默认监听 127.0.0.1:18765;冲突时在 +1..+100 内漂移。
- MCP 网关使用 API + 200;DSH Web host 使用 API + 300,并按 window.__DSH_BOOT__ 特征回查真实端口。
- Vite 开发服务器默认 5173;Electron 调试 CDP 为 9223;托管 Chrome CDP 为 9222。
- SQLite 保存产品投影和审计,DSH JSONL 保存模型会话真值。
- macOS arm64/x64 可构建;Windows unpacked 可在 macOS 验证,NSIS 安装器应在 Windows 构建机生成。

版本记录

v0.4.10

- 修复应用恢复焦点时后台检查版本与下载确认冲突,导致误报“当前没有可下载的桌面更新”的问题。
- 自动检查保留已发现版本、下载进度、任务等待与安装准备状态;下载前仍可手动检查最新版本。
- 补充更新竞态、下载进度与安装状态回归。更新继续沿用已有安装路径和用户数据目录。

完整说明见 v0.4.10 发布说明。

v0.4.9

- 接入 ModelJetty 统一账号与官方模型服务,支持网页登录、账号状态、套餐与用量查询;模型目录、权限和上下文预算与服务端保持一致,自备 Key 继续独立使用。
- 升级 DSH 至 0.2.1-rc.2,改进推理协议、视觉消息、工具结果投影与会话接续;官方文字和图片请求保留原编号,断线或超时后可只读核对,避免重复提交。
- 新增本地长期记忆,支持工作区、全局及历史账号范围;完善账号切换时的隔离与写入回滚。
- 文件产物新增版本快照与完整性校验;大文件、快照配额和源文件变化会明确提示,不将当前原文件冒充历史版本。
- 更新欢迎引导、C1 品牌图标、设置与湖光主题,改进图片会话、任务刷新、模型配置和运行时状态反馈。
- 优化长会话资源查询,隐藏图片/PDF 时释放资源并保留阅读状态,减少后台轮询;补齐跨平台持久化、内置 CLI 打包和生产依赖安全修复。

完整说明见 v0.4.9 发布说明。

v0.4.0

- 设置页新增服务商模型管理:支持新增、改名、编辑 ID、删除、批量编辑及逐模型预算与推理协议配置;DeepSeek 和 GLM 可从上游目录发现模型,由用户选择导入。
- 新增 GPT-6.1 Sol、GPT-6 Sol / Luna 网关模型,统一森马海外 OpenAI 默认地址;模型目录、会话选择与运行时路由保持同步。
- 恢复 DeepSeek 官方 V4 Pro 的同服务商 Flash 视觉桥接,为官方 GLM 5.3 / 5.2 增加 Flash / FlashX 识图桥接;新导入的官方 GLM 型号在明确拒收图片时可回退。国内网关和自定义同名模型不使用官方桥接,也不借用其他服务商凭据。
- 普通定时任务默认复用创建它的固定会话,沿用会话当前模型、工具、工作区、浏览器上下文及权限模式;旧 scoped 任务继续使用原授权范围。
- 任务中心新增脚本定时任务:选择已安装脚本和 JSON 参数,按每天或每周计划直接运行 Adapter,保存运行结果和输出文件,无需每轮调用模型。
- 默认安装包不再内置完整 LibreOffice 原生运行时;首次需要时按锁文件下载、校验并缓存。精简打包依赖、复用 OCR 资源,完整离线 Office 包可通过 CRAWSHRIMP_BUNDLE_OFFICE=1 构建。

v0.3.1

- 修复后台及最小化 Chrome 页面操作时的 CDP 输入超时,并确保切换到后台标签后及时显示首帧;页面焦点模拟不移动系统鼠标、不恢复最小化窗口。
- 输入失败后清理鼠标、按键、输入法和排队事件,避免旧标签的迟到结果干扰当前操作。
- 恢复缺少预览信息的 PPTX、DOCX、XLSX 文件预览,支持从已有作业找回页面或后台生成预览,并保留原文件。
- 修复 Office 标签切换后的图片重载与过期请求覆盖问题,完善错误反馈和重试。

v0.3.0

- 新增会话文件工作区:统一打开附件、文件链接和生成产物,支持持久标签、拖动排序、双栏比较及会话间布局恢复。
- Office / PDF 支持连续逐页阅读,切换标签或收起面板时保留阅读位置;音视频隐藏时暂停。
- 新增实时浏览器手动交互,支持鼠标、滚轮、键盘和输入法,在内嵌面板与浮窗间切换;使用 CDP 合成器推送画面,并在不支持时回退到截图。
- 设置页新增归档会话列表与恢复入口;改进附件上传、粘贴和会话绑定,并校验视频模型配置。
- 修复静态页面在短暂 CDP 故障后无法交互、断线后的预览交接不重连,以及迟到资源快照切回旧页面的问题;避免遗留按键和鼠标按下状态。
- 保留目录链接的系统打开行为,支持原生 bash 的显式 JSON 产物清单,并统一过滤失败的交付声明;补齐 CI 测试收集和相关回归。

v0.2.3

- 修复切换模型与恢复旧会话时沿用不兼容推理等级的问题,按当前供应商和模型能力恢复 Default 并保存。
- 区分 Default(使用供应商默认行为)与 Off(明确关闭思考),保留重启前的有效选择。
- 为森马 bailian-codingplan 网关的 DeepSeek V4 Pro、V4 Flash 和 V4.1 Flash 启用 Off / Low / High / Max 推理档位。
- 自定义 OpenAI 兼容模型可配置 DeepSeek 或 OpenAI 推理协议及供应商支持的档位,菜单按实际能力展示。

v0.2.2

- 修复任务投影写入失败影响智能体 Worker 生命周期的问题,增强连接中断后的恢复能力。
- 修复自动化任务错过执行时间后的恢复、任务取消与权限分类,扩展 CI 测试覆盖。
- 优化文件和图片预览、Office 渲染缓存、后台轮询、事件持久化与任务日志读取,改善桌面响应。
- 精简常驻模型上下文,新增可选的按领域工具发现,保留中文输出、脚本契约与审批边界。
- 修复 Windows 运行时链接与控制台启动、UTF-8 文件写入回读以及过期图片轮询。

v0.2.1

- 修复 Semir 网关鉴权,扩展国产模型配置和模型输出预算,兼容标量工具返回值。
- 统一生图供应商与天猫图片工作流,保留部分成功的生成结果并恢复图片预览。
- 移除旧 AI 工作流页面,优化桌面启动、图片缩略图、任务日志读取与下载性能。
- 改善 Windows 数据目录和权限处理,补齐相关回归验证。

v0.2.0

- 新增个人账号与使用统计偏好,保留本地功能免登录;停用旧云审批和任务机,继续使用本地 DSH 权限审批。
- 上线脚本市场:支持 ZIP 发布、元数据提取、自定义图标、审核、评分评论和一键安装,补齐版本管理、覆盖确认与包完整性校验。
- 优化市场、数据、平台和任务页面加载,支持请求超时与取消,改善刷新时的内容保留和异常恢复。
- 修复打包客户端内嵌 DSH 鉴权、会话资源区拖放遮罩,统一 Office 预览并支持原生保存会话日志。
- 新增自动化中心,支持通过智能体创建定时、循环和条件任务,补齐权限检查、状态恢复和取消处理。
- 内置 Word、PowerPoint、Excel 运行时与设计技能,支持可编辑文档生成、模板填充、公式重算、预览和逐页视觉审查。
- 统一会话文件与浏览器资源,浏览器按需启动;改善图片、Office 和 ZIP 预览,避免重复解压并及时移除已关闭页面。
- 升级 DSH 至 0.1.2-rc.1、dsh-im 至 4.11.0,默认 DeepSeek 模型迁移至 V4.1 Flash;完善首次使用引导、模型选择和 IM 权限控制。
- 内置桌面操作技能、DWS 和更新后的 CLI;macOS 设置新增应用自动化权限入口。
- 改善附件和媒体交付、长输出恢复、跨平台运行时恢复、加载状态及会话界面,修复真实客户端走查发现的问题。

发布渠道为本仓库 GitHub Release,提供 macOS Apple Silicon / Intel 和 Windows x64 安装包及自动更新元数据。

v0.1.13

- 修复 macOS Intel 版首次打开智能体页面时,后台端口切换与 renderer 首次请求并发导致的 Failed to fetch、页面停在启动画面和核心状态红绿抖动。
- 启动状态查询现在等待桌面服务就绪;本地 API、SSE 事件流和媒体签名请求在首次使用前统一同步当前端口与 token,避免依赖多次刷新恢复。
- 增加并发首次连接、服务恢复和 preload 连接契约回归测试,覆盖 macOS arm64/x64 共用的启动路径。

v0.1.12

- 修复 macOS Intel 版误携带 arm64 DSH 原生依赖导致智能体页面持续停留在启动态、核心服务反复崩溃的问题。
- macOS arm64/x64 分别生成并校验 sharp、koffi、ripgrep 运行时依赖;打包钩子按 Electron 目标架构选择对应 staging。
- 运行时启动失败不再伪装成无限“启动中”,会展示错误原因并提供重新连接入口。

v0.1.11

- 增强 IM 自然语言控制:支持在会话里列出/切换模型,并识别抓虾、GPT-5、Claude、Gemini、DeepSeek 等常用模型别名。
- 修复 IM 权限模式路由:去掉审批、开启完整访问等指令直接进入权限模式更新,减少误触发探索型工具调用。
- 优化 DSH 侧边栏展开/收起图标表现,补强 IM 与侧边栏视觉回归覆盖。
- 稳定 fresh install 后的 DSH runtime patch 测试路径,确保 CI 与本地测试使用同一套 IM 补丁产物。

v0.1.10

- 同步抓虾主线业务能力到 Harness 桌面端:脚本搜索、买家秀 AI、TEMU SCM 水洗附件兜底、唯品会 PDC 图片持久化、Shenhui 标签 / 鞋包处理和 Bala 视频工作流可靠性改进。
- 集成 IM 机器人设置面,并通过 ready handshake 与常驻 iframe 降低中间 DSH 页面闪现和切换状态丢失。
- 修复 LLM 服务商品牌 Logo 展示,补齐融合回归覆盖。

v0.1.9

- 加强长流式输出恢复、AI 视频材料状态清理和智能体 harness contract 覆盖。
- 优化缺少 LLM 服务商配置时的引导入口、设置页跳转和品牌化展示。
- 隐藏云审批相关入口,保持 Harness 桌面端能力边界更清晰。

v0.1.8

- 并入 DeepSeek 官方视觉模型、浏览器控制和图片生成参数修复。
- 支持并行抓虾 MCP contexts,减少跨会话工具上下文串扰。
- 加强 Windows 智能体 runtime 启动、SQLite sidecar ACL 和打包验证稳定性。

v0.1.3

- 修复智能体 DSH Web 端口漂移时的白屏问题:后端只暴露已验证的会话页面地址,并可从预期端口扫描修正到真实端口。
- 降低智能体启动过程中的误重启:前端在会话页面仍在就绪时等待,不再把暂未验证的 ready 状态当作故障恢复。
- 修复桌面更新误提示:同版本、缺少发布元数据、v0.1.3 与 0.1.3 等价版本不再显示可重试更新。
- 补强 Windows 桌面包验证:确认 NSIS 安装器、Windows Python bundle、DeepSeek Harness runtime 与更新 metadata 都能生成并通过校验。

v0.1.2

- 修复 DSH composer 的 📎 附件与 @ 命令 hover 标签:附件标签在深色主题中保持可读,命令标签只在 hover/focus 时显示,不再常驻或错位到附件按钮。
- 稳定 DSH 左侧注入菜单:展开全部时复用已有 DOM,只追加或移除必要按钮,避免整组重建造成侧栏闪烁。
- 去掉自定义菜单项入场动画,降低 DSH 原生会话列表刷新或展开时触发整栏闪一下的概率。
- 补充合同测试,锁定 tooltip、菜单 DOM 复用和无入场动画的行为。

v0.1.1

- 升级桌面应用版本号到 0.1.1,用于承接 DSH rc.8 集成后的桌面构建。

v0.1.0

- 首个独立 Harness 桌面版本,提供 macOS Apple Silicon / Intel 与 Windows x64 构建产物。
- 独立仓库发布,不发布到主抓虾项目的 Cloudflare R2 更新源。

flowchart LR
U["用户"] --> E["Electron + Vue shell"]
E --> I["DSH Web iframe\n唯一会话主界面"]
E --> A["FastAPI\n产品 API + SSE"]
A --> DB["SQLite\n产品真值与审计"]
A --> W["Node Worker"]
W --> D["DSH runtime\nElectron-as-Node"]
D --> M["MCP Gateway"]
M --> T["Task Instance / Adapter"]
M --> C["Chrome CDP 9222"]
E --> B["实时浏览器窗口\n按 grant.tab_id 绑定"]

产品约束

这些规则属于当前产品合同,维护时不要退回旧实现:

1. DSH Web 会话 iframe 常驻全幅;抓虾菜单注入会话侧边栏,其他页面显示为右侧 overlay,脚本详情是独立二级页面。
2. DSH 会话权限是审批真值。策略为 never 时抓虾侧自动批准并保留审计;策略为 ask 时使用 DSH 原生审批卡,不自造审批浮层。
3. fs_read / fs_list 全盘只读免审批;browser_navigate 自动执行不审批;fs_write、fs_exec 和风险任务受 DSH 权限策略控制。
4. 简单下载、找图、找款类任务自动批准,但上传、发布、删除和修改类任务不因名字相近而放行。
5. 智能体创建的脚本必须是抓虾 Adapter 包:manifest.yaml + 页面 JavaScript async IIFE,外层返回 { success, data, meta }。草稿、隔离测试和发布三道入口都会拒绝不合规内容。
6. 图片、视频和附件出现在 DSH 消息流末尾;上传入口是 composer 原生加号改造的 📎,旁边保留 @ 命令按钮。
7. 实时浏览器只聚合当前会话各 run 已绑定且仍存活的 grant.tab_id,一个页面一个窗口;活跃窗口置顶,页面关闭后自动清理。

权限与审批

| 操作 | 默认行为 |
| 本机文件/目录读取 | 全盘只读,免审批 |
| 写文件、执行命令 | 服从当前 DSH 会话权限;ask 显示原生卡,never 自动批准 |
| 浏览器观察、验证、请求捕获 | 已绑定 tab 内执行 |
| 浏览器导航 | 任意 http(s);自动执行,不触发额外审批 |
| 凭证字段输入 | 默认阻断;用户明确授权并给出指令后可由智能体填写,审计记录脱敏 |
| 提交、上传、发布、支付、删除等点击 | 原生审批卡 |
| 简单下载、找图、找款 | 自动批准,审计保留 |

审批等待使用独立有界 executor,不占用 asyncio 默认线程池。DSH Web 多会话通过 runtime-session → run 映射和请求级 MCP context lease 绑定,未知会话不会回退到“最近一次运行”,并行会话不会共享一个全局工具上下文。审批通过后更新的 grant 会在 lease 释放前写回 run 级缓存,因此下一次工具调用不会恢复旧授权。跨会话审批提示以 SQLite pending 列表定时校准,终态、后端重启或 SSE 中断都不会留下幽灵卡片。

Adapter 创作与发布

最小包结构:

my-adapter/
├── manifest.yaml
└── collect.js

页面脚本示例:

;(async () => {
const params = window.__CRAWSHRIMP_PARAMS__ || {}
const data = [{ query: params.query || '', title: document.title }]
return {
success: true,
data,
meta: { has_more: false },
}
})()

发布链路:

创建完整 Adapter 草稿 → 合同与 manifest schema 校验 → DSH 原生发布审批 → 安装到 review-<hash> 隔离命名空间 → 在正式 TaskRunner 中真实测试 → 测试后包哈希锁定 → 人工批准发布 → 正式 Adapter 事务安装 / 失败回滚

隔离测试不会覆盖同名生产 Adapter。首次智能体发布前会保存用户原包的长期基线。

附件与媒体

- 上传文件硬上限:200 MB;复制采用 1 MB 流式分块,并在复制过程中再次检查大小。
- attachment_read 解析上限:50 MB;附件只能被所属会话读取。
- 模型图片:PNG、JPEG、WebP、GIF;单张最多 8 MB,每轮最多 5 张。
- Excel:单文件 50 MB、解压后 256 MB、最多 10,000 个 ZIP 条目、32 个 sheet、100,000 行、512 列、2,000,000 个 cell。
- ZIP 媒体预览:单条目解压上限 64 MB;图片清单最多 20 条。
- 可执行安装文件按扩展名和 magic bytes 拒绝。

媒体 URL 不包含主 API token。前端先用认证 header 申请短期 HMAC capability;签名绑定 HTTP route、规范化文件路径、ZIP entry 和过期时间,只能读取 /agent/artifacts/file 或 /agent/artifacts/entry。

安全边界

- 本地 API 仅监听 loopback,默认要求 X-Crawshrimp-Token。
- token 从当前运行数据目录的 api-token 读取;不要把值写入文档、URL、命令历史、截图或 Git。
- preload 和开发 bridge 只允许访问 127.0.0.1 / localhost 的 18765..18865,且不接受 query token。
- 浏览器观察会隐藏 password 及 name/id/autocomplete 命中凭证特征的输入值;网络请求 URL、body、审批摘要和工具结果都会脱敏。
- 仓库工具以用户明确给出的 HTTP(S) Git URL 为准,不做 DNS 公网性拦截;仍拒绝嵌入账号密码的 URL,仓库名只能是单个安全目录段。
- 第三方 README、源码和注释一律按不可信资料处理,不提升为系统或技能指令。

开发环境

要求:

- macOS 或 Windows
- Python 3.10+
- Node.js ^22.19.0 || >=24.0.0
- Chrome

安装:

python3 -m venv venv
venv/bin/pip install -r core/requirements.txt
npm --prefix integrations/deepseek-harness ci
npm --prefix app ci

启动两个终端:

终端 1:FastAPI bash dev.sh

终端 2:Vite + Electron
npm --prefix app run dev

dev.sh 会从运行数据目录读取或创建 API token,但不会打印其值。需要手工 curl 时,在 shell 变量中读取 token 并使用 X-Crawshrimp-Token header;不要回显变量。

数据目录默认由 core.runtime_paths 解析,常见位置为 ~/.crawshrimp,也可用 CRAWSHRIMP_DATA=/absolute/path 显式指定。主要内容:

crawshrimp.db
config.json
api-token
adapters/
agent/
├── attachments/
├── workspace/
├── harness-sessions/
├── runtime-workdir/
└── published-baselines/

验证

Python 全量回归 venv/bin/python -m pytest tests/ -q

Electron / renderer / 构建脚本测试
npm --prefix app test

前端生产构建
npm --prefix app run vite:build

DSH 生产闭包 staging + Electron-as-Node boot check
npm --prefix app run stage:harness

空白与补丁检查
git diff --check

真实交付还需要:

- 从当前数据目录读取 token 后 curl 验证 /health、/agent/runtime、SSE cursor、媒体签名、附件会话绑定和脚本隔离测试。
- 用 Electron CDP 9223 检查主 frame 与 DSH iframe;iframe 重载后必须重新创建 isolated world/context。
- 检查 DSH iframe 常驻、菜单注入、📎 / @、媒体消息流、跨会话隔离、审批策略和 tab 窗口清理。

构建

默认桌面安装包是轻量版:保留 Office 生成能力和锁文件,但不内置完整 LibreOffice 运行时。首次需要预览、转换或原生字体资源时,客户端会按 runtime-locks/office-assets.json 下载并校验 Office 资源,写入用户数据目录缓存;缓存命中后,同一锁文件版本可离线继续使用。仅使用内置 Python 库的文档生成任务无需先下载 LibreOffice。

仅 Vite
npm --prefix app run vite:build

staging DSH + macOS 双架构安装包
npm --prefix app run build:mac:ci

Windows(NSIS 推荐在 Windows 构建机运行)
npm --prefix app run build:win

需要完全离线、安装包内置 Office 原生运行时时,显式打开 full bundle:

CRAWSHRIMP_BUNDLE_OFFICE=1 npm --prefix app run build:mac:ci
CRAWSHRIMP_BUNDLE_OFFICE=1 npm --prefix app run build:win

stage-runtime.mjs 使用独立 package-lock.json 生成生产依赖闭包,并执行禁用能力检查与 Electron-as-Node boot check。不要把开发期 .spike-*、运行数据、token 或构建缓存提交到 Git。
Office 运行时发布模式见 Office Runtime On Demand。

桌面自动更新

独立仓库 howtimeschange/crawshrimp-harness 的正式版先发布 GitHub Release,再由 CI 将完整安装包同步到腾讯云 COS。国内下载入口见 官网下载页。安装包保持原始字节、签名与 SHA256/SHA512 校验信息,GitHub Release 保留作为原始来源与回退。

替换发布的 v0.4.10 起,国内 IP 优先腾讯云 COS、海外 IP 优先 GitHub;更新检查或安装包下载失败时切换备用源。已安装旧版 0.4.10 的用户须手动覆盖安装本次包,或通过 GitHub 更新到后续 v0.4.11 才能获得双源能力。所有下载继续验证原始签名与 SHA512。COS 只保留最新正式版,GitHub 保留历史版本。本仓构建不发布到 https://updates.crawshrimp.com/,也不刷新主项目 desktop-latest。

同步流程、补传当前正式版与权限配置见 腾讯云 COS 发布镜像。

升级不需要卸载旧版:

- Windows 使用 NSIS 在原安装路径就地更新;未签名构建可能显示 Unknown Publisher。
- macOS 的应用内更新使用 ZIP/ShipIt;DMG 只用于首次安装、覆盖安装或应用内更新失败后的手动 fallback。
- 运行数据、Chrome profile、任务缓存和配置保存在系统用户数据目录,应用替换不会删除这些内容。
- 普通退出不会偷偷安装;下载完成后由用户点击 重启安装 才进入安装流程。

主界面把更新动作放在标题栏。进入具体脚本视图后,侧边栏保持展开,侧边栏底部默认只显示当前版本;只有检测到可用更新时才显示 更新。

目录

app/ Electron main、preload、Vue shell core/agent/ DSH 产品编排、MCP、SQLite、CDP、合同 integrations/deepseek-harness/ 锁版 runtime、Worker、host/client 插件、skills adapters/ 内置抓虾 Adapter tests/ Python 回归与安全/运行时合同测试 docs/crawshrimp-harness/ 提案、交付、媒体和维护交接 SPEC.md v1 规范与 v2 Harness 增补

维护文档

- Office 运行时按需下载与 full bundle 构建
- 交接与 code review 结论
- 会话内媒体实现与踩坑
- 交付能力与验证证据
- DSH Agent v2 提案与实现落账
- 产品规范

License

Apache-2.0。版权与第三方声明见 NOTICE。
预览分享卡片长什么样 ↓howtimeschange/crawshrimp-harness
分享 · DeepSeek Harness Hub
howtimeschange/crawshrimp-harness

用自然语言调度智能体完成电商运营与文档处理

这是你的仓库?认领条目

回到顶部