v0.7.0

应用版本 0.7.0 · 底座 DeepSeek Harness 0.1.5-rc.3

TOP5 更新日志

1. Windows · 修「清完 C 盘后应用起不来、凭证全失效」（本版最重要）：应用的用户数据目录原先放在系统临时目录（%LOCALAPPDATA%\Temp）里，而 Windows 的加密密钥（供保存 API Key 使用）就存在该目录的 Local State 文件中。用清理软件清 C 盘会把整个临时目录删掉，于是下次启动应用拿到一把全新的密钥，之前保存的所有 API Key 再也解不开，启动时直接失败、界面只剩「后台启动失败：进程提前退出（code 1）」，点「重试启动」永远无效。

   本版把用户数据目录移到每用户的持久目录（%APPDATA%），并在升级后的首次启动时把旧目录里的密钥文件迁移过来，使已保存的 API Key 继续可用。macOS / Linux 的落点也一并移出临时目录（它们的密钥本就在系统钥匙串 / 密钥环里，不受此问题影响）。

2. Windows · 内置 VC++ 运行库：安装包内自带 VC++ 运行库，启动时检测到缺失即静默安装，不再出现「缺少 vcruntime140.dll」导致应用打不开。

3. 编排 · 移除 script 模式：编排只保留声明式 tasks，去掉了容易误用的 script 模式。

4. Windows · 8.3 短名工作区：工作区路径是 8.3 短名时，改动不再被误判成「工作区外」。

5. 编辑器 · 主题与显示偏好：对齐主题配色，并启用显示项偏好设置。

注意事项

• 升级后 API Key 会保留：从 0.6.0 及更早版本升级时，首次启动会自动迁移密钥文件，已保存的 API Key 无需重新录入。若你的机器此前已经被清理工具删过临时目录（即已经出现过「code 1」启动失败），那批凭证在主密钥重建时已不可恢复，仍需重新录入 API Key；本版只是防止它再次发生。
• Windows 资产未签名：首次运行安装器会被 SmartScreen 拦截 —— 点「更多信息」→「仍要运行」即可。这是预期行为，不是病毒告警。
• Windows / Linux 暂无托盘：关闭主窗口即退出应用（托盘仅在 macOS 提供）。macOS 关窗为隐藏到菜单栏。
• Windows 按用户安装：默认装到当前用户目录，不需要管理员权限。
• Linux 迁移行为未实测：本版的三平台门禁覆盖 macOS 与 Windows 真机；Linux 侧的用户数据目录迁移按机制判定为「无需迁移」（密钥在密钥环），但未在 Linux 真机上验证过。

v0.6.0

发布预览（基线 v0.5.0 → HEAD）

版本：0.6.0 → 0.7.0（minor，自动判定）
提交：43 个（有效 43，自动提交 0）

TOP5 更新日志

1. corum-web-search：联网搜索聚合 provider（默认 DeepSeek，可添加并启用其他供应商）（feat，61775be）
2. desktop：register issue reporter plugin and expose openExternal bridge（feat，1b1bff9）
3. models：供应商清单改由 pi-ai 目录驱动 + 供应商名中英双语（feat，7e0ac30）
4. startup：合并 env 与 spawn 为一段，去掉为观感白等的 sleep（feat，6283e17）
5. ui：report the runtime platform in the issue environment block（feat，0292ef1）

注意事项（0 条，来自台账）

（本轮无 lesson/risk/constraint 条目）

（预览模式，未改任何文件。加 --write 才会递增版本号。）

v0.5.0

发布预览（基线 v0.4.0 → HEAD）

版本：0.5.0 → 0.6.0（minor，自动判定）
提交：31 个（有效 31，自动提交 0）

TOP5 更新日志

1. desktop：add installable HTML and video startup themes（feat，2ba469f）
2. import-wizard：冲突处理 diff split-view 详情面板 + per-item 选择 + zip 安装修复（feat，08f8907）
3. skill：win11-remote 技能进仓 + 新增 Windows 10 测试机支持 (#46)（feat，a8a15c7）
4. startup：分段视频主题——按启动阶段切换播放片段（feat，654ffc6）
5. win：安装包自带便携版 Git（修干净系统 spawn git ENOENT） (#49)（feat，ff37025）

注意事项（0 条，来自台账）

（本轮无 lesson/risk/constraint 条目）

（预览模式，未改任何文件。加 --write 才会递增版本号。）

v0.4.0

应用版本 0.4.0 · 底座 DeepSeek Harness 0.1.5-rc.3

TOP5 更新日志

1. 活动栏 · 用户菜单：修复点击「我的」弹出的用户菜单被会话列表遮挡、看不到也点不到的问题。根因是活动栏的毛玻璃（backdrop-filter）创建了独立图层上下文，菜单的 z-index 被困其中抬不出去；同时把菜单底色从半透明改为不透明（消除与背后会话列表的内容重叠）、菜单位置从偏右上调整到紧贴按钮上方弹出。

2. 活动栏 · 默认头像：活动栏底部的「我的」头像从原来的线条占位图标换成日系立绘头像（通用助手形象），深色主题下头像底色比按钮更深一档形成层次，与其它图标视觉重量一致。

3. 会话栏 · 搜索与新建：按设计稿重构会话栏顶部。新建任务从占满整行的品牌色大按钮改为面板标题右侧的小按钮（方笔图标）；搜索从「点击展开的搜索胶囊」改为常驻搜索框（始终可见，输入即检索）。视图选项与添加工作区按钮一并归入面板标题行。

4. 右键菜单：注册了应用内的右键上下文菜单，选中文字后可右键复制（此前选中后无法右键复制，三平台通用）。

5. 提交卡片：提交卡片改为 turn-scoped 快照对比——只算当前这一轮对话新增的改动，不再把工作区里已有的旧改动也算进卡片，让「这次提交了什么」更准确。

注意事项

• Windows 资产未签名：首次运行安装器会被 SmartScreen 拦截 —— 点「更多信息」→「仍要运行」即可。这是预期行为，不是病毒告警。
• Windows / Linux 暂无托盘：关闭主窗口即退出应用（托盘仅在 macOS 提供）。macOS 关窗为隐藏到菜单栏。
• Windows 按用户安装：默认装到当前用户目录，不需要管理员权限。

开发约束

• 给一个已有容器加 backdrop-filter（或 will-change: transform）会创建独立 stacking context，把它内部每一个 position: fixed/absolute 且依赖父级 z-index 排序的浮层困在该容器内部——这是活动栏用户菜单被遮挡的根因。修复方式：给容器自身设一个高于兄弟列的 z-index，让整个容器作为一个整体抬上去。
• --corum-glass-4 是比 --corum-glass-1 更不透明一档的玻璃底色（深色 #1D112BD9，85% 不透明），用于需要遮住背后内容的浮层（用户菜单、头像底）。

v0.3.0

应用版本 0.3.0 · 底座 DeepSeek Harness 0.1.5-rc.3

本页为手工调校版（RELEASE-NOTES/v0.3.0.md）：TOP5 按用户可见影响重排，
注意事项剔除了已被推翻的台账条目、补上用户侧的 Windows 须知。

TOP5 更新日志

1. Windows：桌面端首次随版本正式发布（NSIS 安装向导 + 免安装 zip）。含两个阻断级缺陷的修复——交叉打出的包白屏起不来（平台上专属原生依赖按命名规律整体校正 + 产物启动硬门禁）、新建工作区 exit 128（git 属主 safe.directory）；并让 git/node 子进程不再弹出控制台黑框。

2. 预设模块：Agent 预设模块化落地——导入向导 + 发布流程。把一个 Agent 连它引用的技能与 MCP 依赖收成一个自洽目录，可以导出给别人安装，不再出现「拷个 agent.json 过去，技能和 MCP 全不存在」。

3. MCP：修「服务配了 guidance 就让整个 preset 挂载失败、Agent 完全打不开」（issue #3）。根因是守卫读了未 inject 的服务属性、抛错发生在 try/catch 之外。

4. 提交卡片：卡片改挂会话流（不再悬停输入框上方）；且卡片出现后的提交过程（思考 / 工具调用 / 结论）收进卡片内部，默认收起、点头部才展开。

5. 三处可见缺陷：子 Agent 模型下拉选供应商不再回弹「未设置」；有工作区但无会话时侧栏正确显示工作区分组（不再误进空态）；「新建任务」的工作区下拉恢复首项「打开本地文件夹」。

注意事项

• Windows 资产未签名：首次运行安装器会被 SmartScreen 拦截 —— 点「更多信息」→「仍要运行」即可。这是预期行为，不是病毒告警。
• Windows / Linux 暂无托盘：关闭主窗口即退出应用（托盘仅在 macOS 提供）。macOS 关窗为隐藏到菜单栏。
• Windows 按用户安装：默认装到当前用户目录（perMachine: false），不需要管理员权限；换过安装目录后重装会记住上次路径。
• （开发）@deepseek-ai/dsh-client-ui-primitives 无法用 pnpm patch 修 —— 补丁会静默无效。
• （开发）给一个已有容器加 backdrop-filter（或 will-change: transform）会把它内部每一个 position: fixed 浮层从「相对视口」改成「相对该容器」—— 这是跨组件的静默语义变更：改的是 A（玻璃皮肤），坏的是 B（提示气泡 / 下拉 / 悬浮卡），而 B 一行没动。
• （开发）saveProfile RPC 会静默丢掉任何不在 SaveProfileInput 白名单里的 profile 字段 —— 新增字段时必须同步白名单。

Corum Harness v0.2.2

Corum Harness v0.2.2

基于 DeepSeek Harness 底座构建的通用 Agent 软件——把 agent loop、工具系统、多 Agent 编排、记忆、技能打包成开箱即用的产品，面向编程场景与通用 Agent 场景。

本版是 macOS 的修复发布：修掉「启动时弹出钥匙串密码框、点取消后应用直接起不来」。

⚠️ 如果你下载过 v0.2.1 的 macOS 包，请改用本版。 v0.2.1 的 dmg / zip 含该缺陷（在用户机上会弹密码框且应用无法启动）。v0.2.1 的 Linux 资产不受影响，无需更换。

下载

平台	文件	大小	说明
macOS (Apple Silicon)	Corum-0.2.2-arm64.dmg	384 MB	标准安装镜像（推荐）：挂载后拖入「应用程序」
macOS (Apple Silicon)	Corum-0.2.2-arm64-mac.zip	381 MB	等价压缩包（解压即得 Corum.app）
Windows (x64)	Corum-0.2.2-win-x64.exe	301 MB	NSIS 安装向导（推荐）：可选安装目录，「设置 → 应用」里显示为 Corum 0.2.2
Windows (x64)	Corum-0.2.2-win-x64.zip	391 MB	绿色压缩包：解压即用，不写注册表

Linux（AppImage / deb）仍为 v0.2.1，可在 v0.2.1 release 下载——不受本缺陷影响。Windows 首版即为本版（v0.2.2），见上表。

⚠️ 安装前必读（Windows）

• 平台：Windows 10 1809+ / Windows 11，x64。
• 未签名：首次运行会被 SmartScreen 拦截——点「更多信息」→「仍要运行」即可（预期行为）。
• 按用户安装：默认装到当前用户目录，不需要管理员权限；安装向导内展示 LICENSE（Apache-2.0）全文。
• 差异：暂无托盘（关窗即退出）；凭据走 Windows DPAPI。详见仓内 RELEASE-NOTES/v0.2.2-win.md。
• 安装慢（释放文件很久）：多半是 Defender 逐文件扫描 3 万+ 小文件。可给安装目录加排除（管理员 PowerShell）：Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\Programs\Corum"（默认位置；改过安装目录就换成实际路径）。下个版本会直接砍掉一半文件，届时无需此操作。

⚠️ 安装前必读（macOS）

• 平台：仅 Apple Silicon（arm64）。Intel Mac 暂无预编译包。
• 未签名 / 未公证：本 release 未做 Apple 公证。首次打开会被 Gatekeeper 拦截——请右键点击 Corum.app → 打开（或在「系统设置 → 隐私与安全性」里点「仍要打开」），之后即可正常使用。
• 首次启动可能出现一次钥匙串授权框（「Corum 想要使用钥匙串中的机密信息」）：这是本应用用系统钥匙串加密保存 API Key 的正常机制。请点「始终允许」，之后不再询问。

  ⚠️ 请勿点「拒绝」：打包版遇到密钥不可用时按设计拒绝启动（绝不静默降级）。本版修的是弹框的成因——不再因为依赖版本变动而突然要求重新授权；正常情况下装好即用、不再弹框。

本版变更

修复：macOS 启动时要求输入钥匙串密码、取消后应用起不来

症状：启动时弹出「想要使用钥匙串中的机密信息 → 请输入登录密码」；点「拒绝」后应用不再启动。

根因：本应用用 safeStorage（macOS 钥匙串）封装凭据主密钥，而钥匙串条目的访问权绑定请求方的代码身份（二进制哈希）。此前 electron 依赖写成浮动范围 ^43.4.0，一次依赖安装把它从 43.4.1 升到了 43.7.9 —— 二进制哈希随之改变，钥匙串条目不认新身份，于是弹框；而读取密钥的调用在等待授权时会阻塞，取消后主密钥取不到，最终整棵插件树拒绝加载、应用无法启动。

修复：

• 钉死 electron 版本（43.4.1，进 pnpm-workspace.yaml 的 overrides），杜绝依赖安装再次悄悄换掉二进制身份。这是本缺陷不再复发的机制保证。
• 开发态允许降级：开发机拿不到主密钥时凭证视为未配置、应用照常启动，不再因为开发环境的钥匙串授权状态而起不来。
• 发布产物保持严格：打包版遇到该情况仍然响亮失败（绝不静默降级），并由新增的发布前冒烟门禁拦住——这类问题不会再流到用户手里。

修复：corum-instance.sh 两处隐患

• 「自动解出凭据主密钥」的逻辑原先硬编码了 Electron 路径 electron@43.4.1；一旦某次安装不再装该版本，这条通路会静默失效（打包态带着"取不到主密钥"的状态继续启动）。现改为按当前实际安装版本动态解析。
• 同一处漏了 app.setName('corum-desktop')，导致它读取的是错误的钥匙串条目、必然解密失败——该子命令其实一直是坏的（现实测可正常解出）。

新增：pnpm smoke:packaged 发布门禁

发布前对打包产物本身（而非开发树）跑冒烟：断言启动日志无钥匙串/主密钥/插件树加载错误、.master-key 权限为 0600、且 host 子进程真正起来。同时让冲烟测试落盘应用的启动日志——此前这些关键行被直接丢弃，「窗口起不来」只能看到超时、拿不到原因。

一并包含（自 v0.2.1 起）

• turn-stopping 阻塞式提交卡片：Agent 结束一轮且有改动时，由机制注入指令让模型自己按逻辑主题分笔提交，取代原先的 wip(turn-*) 流水号灌水提交。
• Windows 目标纳入打包链（尚未发布产物）：修正按平台的 Node 路径、终端 shell 选择、Node 运行时暂存。
• 平台特化 P0–P2：把平台差异收进显式模块，加入构建期目标平台注入与运行期一致性断言。

已知问题

• macOS 未签名 / 未公证：首次打开需右键 →「打开」绕过 Gatekeeper。彻底解决需 Apple Developer ID 签名与公证。
• Intel Mac 与 Windows 暂无正式发布包。
• macOS 系统通知与 Dock 未读徽标在本版仍不可用（依赖代码签名，与上述签名项同一前置）。

Corum Harness v0.2.1

Corum Harness v0.2.1

基于 DeepSeek Harness 底座构建的通用 Agent 软件——把 agent loop、工具系统、多 Agent 编排、记忆、技能打包成开箱即用的产品，面向编程场景与通用 Agent 场景。

本版重点：新增 Linux 桌面端（AppImage / deb），并修掉一批平台相关缺陷。

下载

平台	文件	大小	说明
macOS (Apple Silicon)	Corum-0.2.1-arm64.dmg	384 MB	标准安装镜像（推荐）：挂载后拖入「应用程序」
macOS (Apple Silicon)	Corum-0.2.1-arm64-mac.zip	381 MB	等价压缩包（解压即得 Corum.app）
Linux (x86_64)	corum-desktop_0.2.1_amd64.deb	225 MB	Debian/Ubuntu 安装包（最省事，推荐）
Linux (x86_64)	Corum-0.2.1.AppImage	369 MB	免安装；需系统有 FUSE（见下）

⚠️ 安装前必读

macOS

• 平台：仅 Apple Silicon（arm64）。Intel Mac 与 Windows 暂无预编译包。
• 未签名 / 未公证：本 release 未做 Apple 公证。首次打开会被 Gatekeeper 拦截——请右键点击 Corum.app → 打开（或在「系统设置 → 隐私与安全性」里点「仍要打开」），之后即可正常使用。

Linux

• 建议装 deb：sudo dpkg -i corum-desktop_0.2.1_amd64.deb，然后从应用菜单启动，或跑 /opt/Corum/corum-desktop。
• AppImage 需要 FUSE（libfuse.so.2），Ubuntu 24.04 默认不带：

  sudo apt install libfuse2t64     # 旧版发行版用 libfuse2
  chmod +x Corum-0.2.1.AppImage && ./Corum-0.2.1.AppImage

  装不了 FUSE 时可退化为 ./Corum-0.2.1.AppImage --appimage-extract-and-run（降级方案，不是默认路径）。
• Agent 的 bash 工具依赖 bubblewrap——缺它时沙箱会 fail-closed（每一次 bash 调用都失败，而不是"退化成无沙箱"）：

  sudo apt install bubblewrap

• 不要以 root 运行（会需要 --no-sandbox 且窗口可能空白）；用普通桌面用户。

本版变更

新增：Linux 桌面端

• 完整的 Linux 打包链路：build → pack:host → pack:node → pack:app:linux，产出 AppImage 与 deb。
• 原生依赖在 Linux 上验证可用：node-pty 真能开出 PTY、koffi 真能调用 libc、landlock 沙箱 probe() 返回 full、bubblewrap 真能拒绝越界写。
• 沙箱在 Linux 上真的在约束（不是摆设）：工作区内可写，区外写入被拒。

修复

• Linux 上凭证无法保存（界面提示「暂时无法保存确认状态」）：Chromium 在 Linux 上不会自动选中密钥环后端，已显式指定 gnome-libsecret。修完主密钥可正常封装（.master-key 0600 落盘）。
• Linux 上应用起不来：AppImage 的运行依赖 libfuse2（已在上面说明）。
• fetch-node.mjs 曾硬编码 darwin/arm64：在 Linux 上出包会不报错地把 macOS 的 Node 塞进 Linux 包。现按运行平台取归档（win32 走 .zip）。
• pack:linux 曾跳过前置三步（只调 electron-builder）：会把 Mac 上物化的 Node 打进 Linux 包。已补全为完整四步链。
• corum-instance.sh 的沙箱探针是 macOS 专用（sandbox-exec），导致 Linux 上验证实例拒绝启动。现按平台分派。

改进（用户可见）

• 启动直接进入主界面：项目已收敛为单一编程 Agent 应用，不再停在「选择一个工作流」的壳页。
• 「新建任务」表单去掉「选择新目录」：注册工作区统一走侧栏的「添加工作区」，同一动作不再有两处入口。

工程

• 立「三平台覆盖」为核心开发原则：任何改动都要检查 darwin / linux / win32 是否同步覆盖——本仓最贵的失败是隐式假设（硬编码 /bin/zsh、~/.corum-desktop、只用 / 拼路径等），它们在第三个平台上不报错、只是行为不同。
• 新增 Linux 实机验证技能与冲烟测试：corum-linux-verify 技能（远程访问 / 分块传输 / 环境引导）+ corum-smoke.mjs（快档 / 全档，含真实像素呈现判据——只测 DOM 会漏掉「窗口没显示」）。

版本与基座

• 应用版本：0.2.1
• 底座版本：DeepSeek Harness 0.1.5-rc.3（基座号只在「复制诊断信息」中可见；应用版与基座版分两条线维护）
• 环境要求（自行构建）：Node ^22.19.0 || >=24.0.0，pnpm 11.7.0

从源码构建

pnpm install
pnpm shell:dev                                 # 开发态启动桌面应用
pnpm --filter corum-desktop run pack           # 打包 macOS（.dmg / .zip）
pnpm --filter corum-desktop run pack:linux     # 打包 Linux（AppImage / deb，须在 Linux 上跑）

反馈与交流

• 微信扫码加入「Corum 交流群」（见仓库 README），或个人微信 hjkkclife（备注 corum）
• 问题与建议请提 Issue

项目状态

早期开发阶段，接口与配置仍在快速演进。许可证 Apache-2.0。

---

English summary: Corum Harness is a general-purpose Agent application built on DeepSeek Harness — packaging agent loop, tool system, multi-agent orchestration, memory and skills into a ready-to-use product for coding and general agent scenarios. v0.2.1 adds the Linux desktop app (AppImage / deb; AppImage needs libfuse2, the agent's bash tool needs bubblewrap) alongside the existing macOS Apple Silicon build. macOS is unsigned and not notarized — on first launch, right-click Corum.app → Open to bypass Gatekeeper. Early development, Apache-2.0.

Corum Harness v0.2.0

Corum Harness v0.2.0

基于 DeepSeek Harness 底座构建的通用 Agent 软件——把 agent loop、工具系统、多 Agent 编排、记忆、技能打包成开箱即用的产品，面向编程场景与通用 Agent 场景。

本仓库为 open core 模式的开源形态：任务模式（Task Mode）——单任务泳道 + 指挥模式 + 完整 Agent 能力面（编排、子 Agent、记忆、MCP、技能、编程工作台）。

⚠️ 安装前必读（macOS）

• 平台：本包仅供 macOS Apple Silicon（arm64）。Windows / Linux 尚在规划中。
• 未签名 / 未公证：本 release 未做 Apple 公证。首次打开会被 Gatekeeper 拦截——请右键点击 Corum.app → 打开（或在「系统设置 → 隐私与安全性」里点「仍要打开」），之后即可正常使用。
• 推荐下载 Corum-0.2.0-arm64.dmg（挂载后拖入「应用程序」）；Corum-0.2.0-arm64-mac.zip 为等价压缩包（解压即得 Corum.app）。

下载

文件	格式	大小	说明
Corum-0.2.0-arm64.dmg	UDZO/APFS	680 MB	macOS 标准安装镜像（推荐）
Corum-0.2.0-arm64-mac.zip	zip	391 MB	等价压缩包

核心能力

• 多 Agent 编排：orchestrate 声明式 fan-out，子 Agent 在独立 git worktree 中工作并自动集成；子 Agent 卡片可见可控（查看提示词 / 改动 / 跳转会话）
• 指挥模式（Conductor Mode）：技术负责人带队伍的基础模式——指挥者只读门禁 + 三阶段调研 + 委派闸门，人类指挥 + AI 执行的协作范式成为可选 Agent 形态
• Agent 预设：岗位 / 人格 / 职责 / 域边界 / 模型路由（主 / 子 / 调查三档独立配置）
• 记忆底座：事实级存储、存续期与衰减
• MCP 集成 + 技能库 + 本地模型（Ollama）+ 文生图
• 编程工作台：Monaco 编辑器 + 文件树 + 终端 + 对话区，可拖拽重组

版本与基座

• 应用版本：0.2.0
• 底座版本：DeepSeek Harness 0.1.5-rc.3（基座号只在「复制诊断信息」中可见；应用版与基座版分两条线维护）
• 环境要求（自行构建）：Node ^22.19.0 || >=24.0.0，pnpm 11.7.0

从源码构建

pnpm install
pnpm shell:dev        # 开发态启动桌面应用
cd packages/desktop && pnpm run pack   # 打包 macOS 应用（.app / .dmg）

反馈与交流

• 微信扫码加入「Corum 交流群」（见仓库 README），或个人微信 hjkkclife（备注 corum）
• 问题与建议请提 Issue

项目状态

早期开发阶段，接口与配置仍在快速演进。许可证 Apache-2.0。

---

English summary: Corum Harness is a general-purpose Agent application built on DeepSeek Harness — packaging agent loop, tool system, multi-agent orchestration, memory and skills into a ready-to-use product for coding and general agent scenarios. This release ships the macOS (Apple Silicon) desktop app, unsigned and not notarized — on first launch, right-click Corum.app → Open to bypass Gatekeeper. Early development, Apache-2.0.