【SoduWork测评】本机跑源码,找到并修了7个Bug

读完这篇,你能拿到:

  • 在 Windows 上把 SoduWork 桌面端装好、把源码版 Hub 跑起来的完整步骤和真实耗时;
  • 给 Agent 下小目标、装插件跑真任务的实测记录,包括中途停止再继续;
  • 7 个在本机运行时发现的问题:现象、对应源码、修复和维护者的审查意见,其中 1 个已合并;
  • 一套"先在本地复现、再读代码、最后补测试"的做法,可以照着去给开源项目提 PR。

文章目录

    • [1. 背景](#1. 背景)
    • [2. 上手实测](#2. 上手实测)
      • [2.1 安装与源码启动](#2.1 安装与源码启动)
      • [2.2 给 Agent 小目标](#2.2 给 Agent 小目标)
      • [2.3 用插件跑真任务](#2.3 用插件跑真任务)
    • [3. 对照源码](#3. 对照源码)
      • [3.1 中文渲染出错](#3.1 中文渲染出错)
      • [3.2 Office 内容丢失](#3.2 Office 内容丢失)
      • [3.3 Windows 存储](#3.3 Windows 存储)
      • [3.4 被合并的 PR](#3.4 被合并的 PR)
    • [4. 经验](#4. 经验)
      • [4.1 好用的地方](#4.1 好用的地方)
      • [4.2 踩到的坑](#4.2 踩到的坑)
      • [4.3 可复用的做法](#4.3 可复用的做法)

1. 背景

我把一段写着"工期 3~5 天,预算 100~200 元"的说明放进 SoduWork 资料库预览,这一行中间突然被划了一道横线,像是有人把预算删掉了。不是我写错了,是 SoduWork 把两个波浪号之间的文字当成了删除线。顺着这一行,我从"装好就用"一路走到了"把源码拉下来跑"。

SoduWork 是 mdiri 开源的团队 Agent 工作台:桌面端负责对话和本机执行,Hub 负责账号、需求、资料库和调度,执行底座可以选 Pi、Codex、Kimi 等。下面的测试都在我自己的电脑上完成:Windows 11、4K 屏、Node 24.14.0、Python 3.12.3,桌面端是官方最新的 1.13.17。

2. 上手实测

先说结论:日常对话、写文件、跑终端命令、装插件这些主路径很稳,我刻意用带空格、括号和 & 的中文路径做工作区,也没有出问题。

2.1 安装与源码启动

桌面端直接用安装包装好,登录后默认连官方 Hub,模型选的是 deepseek-v4.1-flash。

要看源码,就 fork 仓库,在本机用源码启动一个隔离的 Hub。项目自带一键脚本,第一次运行会建虚拟环境、装依赖、构建管理页面:

bash 复制代码
git clone https://github.com/<你的账号>/SoduWork.git
cd SoduWork
py -3.12 start.py --data-dir D:\sodu-data --prepare-only
py -3.12 start.py --data-dir D:\sodu-data --port 18990 --no-browser

--prepare-only 在我这里的实际耗时:建虚拟环境 5.2 秒,装后端依赖 55.2 秒(脚本默认走清华镜像),装管理页依赖 11.7 秒,构建 5.7 秒。第二条命令看到 SoduWork is ready: http://127.0.0.1:18990 就启动好了,数据库是 SQLite,文件存在本地磁盘,和线上部署是两套环境,这一点后面很关键。

2.2 给 Agent 小目标

第一个目标很简单:在工作区建一个 hello-sodu.txt,写入 hello,再告诉我完整路径。10 秒完成,回复里给出了路径,下方还有文件卡片,可以直接打开或保存到资料库。

第二个目标专门找麻烦:把工作区换成 Sodu 测试 (A&B) 工作区,要求用终端命令建子目录、写文件、列出所有文件。Windows 上路径里的空格、括号和 & 很容易把命令行搞坏,但它用 Git Bash 执行,pwd 打出的路径完整,点"打开所在文件夹"也能正确跳到资源管理器。

第三个目标是读附件:上传一个有两张工作表、C1 是公式 =B1*2 的 Excel,问它有几张表、C1 是什么公式、结果多少。42 秒后它答出两张表、公式和结果 84,还指出这个文件是程序生成的、没有公式缓存值,用 Excel 打开会自动计算。

2.3 用插件跑真任务

插件页自带 5 个内置插件,市场里还能装企业发布的插件。我装了"旅行计划撰写",安装时会先让你填偏好(出发地、预算口径、节奏),再展示权限边界。

任务是"下周末从上海去杭州玩两天,预算 2000 元"。它先读插件的技能说明,再去核实票价和照片链接:Unsplash 的随机图和杭州无关,它换到 Pexels,被反爬拦下后又换到 Wikimedia,每张图都看一遍再用。这个过程不快,但它没有拿错图凑数。

中途我切到别的对话再切回来,进度还在;点停止后发"继续",它从被打断的命令处接着跑。

3. 对照源码

主路径稳,问题都藏在"换一种环境"或"换一种用法"的地方:中文内容、Windows 默认路径、SQLite 本地部署、直接调用接口。下面每个问题都按"运行时看到什么 → 源码在哪 → 怎么修"来写,并附上维护者审查时提的意见。

3.1 中文渲染出错

开头那条删除线就是第一个问题。我把下面几行存成 .md,上传到资料库的"本地存储"再预览:

markdown 复制代码
预算 100~200 元,工期 3~5 天。
**注意:**这里需要先登录。
**结论**:这一行的加粗是正常的(对照)。

两处都错了:两个范围之间的文字被划掉;**注意:** 的星号原样显示,而对照行 **结论**: 是正常加粗的。

聊天回复、资料库预览、任务执行流都调用同一个内置的 marked 库。它严格按 GFM 和 CommonMark 规范解析:GFM 允许单个 ~ 表示删除线;CommonMark 规定,加粗结尾的 ** 如果紧跟在标点后面,后面必须是空格或标点才算闭合。英文句子里标点后面总有空格,中文没有,于是 **注意:**这里 永远闭合不了。国产模型的回复里这种写法非常多,所以聊天里也经常看到成对的星号。

我提了 issue #351 和 PR #352。维护者的回复说波浪号问题已经被同期的 #343 修掉了,加粗的修法还有两处要改:自定义规则不能把代码和链接文字里的 ** 当成闭合符号;规则只在 desk.html 里加载,主进程的附件预览用不到。我按意见把规则挪到公共入口 core/markdown.js,扫描闭合符号时跳过转义、代码和链接,并补了 15 条"必须和原版渲染完全一致"的对照用例。

3.2 Office 内容丢失

第二个问题是数据丢失。资料库的接口允许把文件读成文本、改完再写回去。我上传一个有 Summary、Details 两张表的 Excel,读出文本后一个字不改原样写回,再下载:

text 复制代码
HTTP upload / read / save / download: 200 200 200 200
Before: {'sheets': ['Summary', 'Details'], 'B1': (42, 'n'), 'C1': ('=B1*2', 'f')}
After:  {'sheets': ['Sheet1'], 'B1': ('42', 's'), 'C1': ('=B1*2', 's')}

四个请求都返回成功,但第二张表没了,数字和公式都变成了文本。原因在 library_formats.py:读取时只取当前工作表的文字,写回时用这些文字新建一个工作簿替换原文件。Word 和 PowerPoint 同理:表格、图片、加粗、页眉、演讲者备注全部丢失。

桌面端界面上没有按钮会走到这条路径,但插件、脚本或者以后的新功能只要调用这个接口,就会悄悄毁掉用户的文件。PR #311 的做法是:遇到这三类文件的纯文本覆盖,直接返回 400,提示"请下载后用桌面应用编辑",原文件一个字节都不动。

3.3 Windows 存储

第三组问题都和"本地磁盘 + Windows 默认路径"有关,只有源码部署才会遇到。

资料库写不进去(#330 / #334) :在默认长度的数据目录下,资料库上传和新建笔记全部返回 503"请配置资料库存储环境",而存储状态接口显示本地存储可用。对象路径由用户哈希、UUID 和对象 ID 拼成,写入时还要先写一个 .part-<uuid> 临时文件。默认根目录约 92 个字符,临时文件路径就有 279 个字符,超过了 Windows 默认 260 字符的路径上限。

同名附件互相覆盖(#331 / #335):管理端给需求上传两个同名附件,第一个的内容会被第二个覆盖。看磁盘就明白了:

text 复制代码
on disk: att__10101187-...__None__方案.txt (56 bytes) '第二版:预算调整为 80 万,删去华南试点'
download d42be7bd (recorded size 27): FAILED RemoteProtocolError

存储路径里本该是附件 ID 的位置写着 None:代码在附件对象写入数据库之前就拼了路径,而 ID 要到写入时才生成。修法只有一行,提前生成 ID。

长文件名直接 500(#332 / #336):70 个汉字的附件名上传失败;文件名里带冒号(Mac 上很常见)时,NTFS 会把它当成"备用数据流",磁盘上只剩一个 0 字节的文件。

这几个 PR 收到的审查意见很一致:修复本身确认有效,但新测试要接进 CI 的质量门禁;#336 还被指出,上传目录搬到更短的路径后,按哈希名存的旧文件会找不到。这说明维护者确实在真实 Windows 上把场景跑了一遍,而不是只看代码。

3.4 被合并的 PR

已合并的是 #328。另一位参与者在 issue #285 里报告:Windows 上用 Node 24 跑后端的发布检查,test_kimi_runtime 必挂。我在本机复现:4 个测试里 1 个失败,Node 在加载预置脚本前触发 CSPRNG 断言,退出码 134。

原因是测试为了隔离环境,只给子进程传了 PATH,而 Windows 上的 Node 需要 SystemRoot 才能初始化随机数生成器。修复是只在 Windows 上补传系统自带的 SystemRoot,测试其他断言不变,一共 3 行。11 月 17 日 23:09 合并。

另外,时间戳少了时区的问题(#333 / #337)也是本地 SQLite 部署才有:SQLite 读回的时间不带时区,前端按本地时间解析,同一个设备列表里,手机的"最近活动"比实际早了 480 分钟。

4. 经验

4.1 好用的地方

  • 主路径稳:对话、写文件、终端命令、插件安装和运行、停止后继续,都没出问题。
  • 源码可读:前后端分层清楚,测试覆盖细,几乎每个模块都有对应的测试文件,改完能在本地跑测试验证。
  • 维护者认真:每个 PR 都有人在真实环境里复验,意见具体到哪一行、缺哪类测试。

4.2 踩到的坑

  • 线上和本地是两套环境:官方 Hub 不会遇到 SQLite 和本地磁盘的问题,源码部署的用户会遇到。
  • 中文场景测得少:Markdown 渲染、长中文文件名这类问题,英文用户很难碰到。
  • 同一个问题可能有人在修:波浪号删除线和维护者的 #343 撞了车。动手前先搜一下 issue 和 PR,能省不少时间。

4.3 可复用的做法

给开源项目提 PR,我最后固定成三步:

  1. 先复现:用源码起一个隔离环境,把现象和日志截下来,写进 issue;
  2. 再读代码:从报错或接口顺着找到出问题的那一行,确认根因,不靠猜;
  3. 最后补测试:写一个修复前失败、修复后通过的测试,再跑一遍相关的现有测试,确认没有新增失败。

常用命令:

bash 复制代码
# 后端:在 hub-backend 目录跑指定测试
python -m unittest -v tests.test_library_integrity
# 客户端:在 client 目录跑指定测试
node --test tests/chat-message-renderer.test.cjs
# 提交前的公开源码与第三方检查(仓库根目录)
node tools/check-public-source.cjs
node tools/check-third-party.cjs

SoduWork 开源项目地址:https://github.com/mdiri-ai/SoduWork

如果这篇对你有帮助,欢迎去项目主页点个 Star,或者 Fork 下来在自己电脑上跑一跑。

相关推荐
jianqiang.xue16 分钟前
把Agent塞进MCU:工具次数和上下文长度怎么卡
java·前端·网络·单片机·esp32·ai编程
xx z21 分钟前
打开游戏提示 d3dx9_43.dll 缺失怎么办(DirectX 修复步骤)
windows·游戏·工具·软件
莪_幻尘36 分钟前
AI 编程的下一场战争,不在模型,在协议
agent·ai编程·mcp
oil欧哟2 小时前
AI Agent Skill 入门指南:文件夹本质、渐进式加载与挑选方法
人工智能·ai编程
挖掘狂人2 小时前
AI 三分钟写完的代码,你凭什么敢直接上线?
人工智能·程序员·ai编程
如夏倾城2 小时前
五大远程桌面协议:RDP、SSH、VNC/RFB、Citrix ICA/HDX 与 VMware Blast Extreme
运维·windows·网络协议·安全·自动化·ssh·远程工作
codigger3 小时前
AI 三分钟写完的代码,你凭什么敢直接上线?
ai·程序员·编程·ai编程·#人工智能
回家路上绕了弯3 小时前
让错误活不过 N 步
ai编程
可夫小子3 小时前
OpenAI 用 Codex 修 ChatGPT 性能,1700 次调查只直接合入 15 个 PR
openai·ai编程