Skip to content
Back to search

Corum-Harness

基于 Deepseek-Harness 核心底座打造的桌面版 Agent.继承底坐全部能力。并补全 IDE 相关功能。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/kukucaiCndy/Corum-Harness with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/kukucaiCndy/Corum-Harness'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kukucaicndy--corum-harness/badge.svg)](/listings/kukucaicndy--corum-harness)

HTML

<a href="/listings/kukucaicndy--corum-harness"><img src="/api/listings/kukucaicndy--corum-harness/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 272 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="packages/desktop/assets/icon.png" alt="Corum Harness" width="160">
  3. </p>
  4. <h1 align="center">Corum Harness</h1>
  5. <p align="center">
  6. 基于 <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> 底座构建的
  7. <b>通用 Agent 软件</b>——把 agent loop、工具系统、多 Agent 编排、记忆、技能打包成开箱即用的产品,
  8. 面向编程场景与通用 Agent 场景。
  9. </p>
  10. <p align="center">
  11. <img alt="Node" src="https://img.shields.io/badge/node-%5E22.19.0%20%7C%7C%20%3E%3D24.0.0-blue">
  12. <img alt="pnpm" src="https://img.shields.io/badge/pnpm-11.7.0-orange">
  13. <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-strict-3178c6">
  14. <img alt="Status" src="https://img.shields.io/badge/status-early%20development-yellow">
  15. </p>
  16. <p align="center">
  17. <b>📣 进交流群</b>:微信扫码加入「Corum 交流群」,反馈问题、共建工作流<br>
  18. <img src="docs/assets/wechat-group-qrcode.webp" alt="Corum 交流群二维码" width="200">
  19. <br>个人微信:<b>hjkkclife</b>(备注 corum,欢迎交流共建)
  20. </p>
  21. ---
  22. ## 这是什么
  23. Corum Harness 把 DeepSeek Harness 从一个 **Agent 运行时**,扩展成一个**可直接使用的 Agent 产品**:
  24. dsh 运行时内核 + Electron 桌面承载层 + 38 个自研插件 + 一套默认配置。
  25. > **定位类比**:DeepSeek Harness 是「Linux 内核」(Cordis 插件框架 + agent loop + capability seam),
  26. > 本项目是「发行版」(产品化的 Agent 能力 + 插件 + 默认配置)。**不改内核,只做用户空间。**
  27. 底座能力(context 管理、工具系统、LLM 适配、会话存储、subagent 机制)全部继承自 dsh;
  28. 本项目的价值集中在**把 Agent 能力做成可直接使用的产品**——编程助手是最先落地的场景。
  29. ---
  30. ## 核心能力
  31. - **多 Agent 编排**:`orchestrate` 声明式 fan-out;子 Agent 在独立 git worktree 中工作并自动集成;
  32. 子 Agent 卡片可见可控,编排进度一目了然。
  33. - **指挥模式(Conductor Mode)**:「一个技术负责人带一支队伍」的基础模式
  34. (`baseMode: 'conductor'`,与 `standard` / `ptc` / `minimal` / `cordis` 并列):
  35. - 指挥者是技术负责人,不是调度员——判断问题是什么、该怎么解、结果是否真的达标;
  36. - 恒只读:不给写工具、只给只读 shell,约束走机制层门禁,用户权限档位只对 worker 生效;
  37. - 三阶段调研:入门自己看(有界)→ 深入交给 research 子 Agent → 收尾只做点读验收;
  38. - 子 Agent 的报告是**主张**不是证据,验收必须亲自看 diff。
  39. - **Agent 预设(persona)**:岗位、人格、职责、域边界、模型路由(主 / 子 / 调查三档独立配置)。
  40. - **记忆底座**:事实级存储、存续期与衰减,设置中心可配。
  41. - **MCP 集成**:MCP 服务管理与授权,工具自动装配进 Agent。
  42. - **技能库**:可绑定的可复用技能(含项目自带开发规范技能)。
  43. - **本地模型**:支持 Ollama 等本地 provider,云端 / 本地随配置切换。
  44. - **文生图**:本地文生图能力(`corum-artgen`)。
  45. - **编程工作台**(编程场景的落地形态):Monaco 编辑器 + 文件树 + 终端 + 对话区,可拖拽重组。
  46. ### 工程化
  47. - **插件化发行**:38 个插件包按 `ui` / `session` / `agent` 分组,能力与界面同包。
  48. - **最小内核侵入**:官方包尽量从 npm registry 原样引用;必要的定制集中在 **16 个 fork 包**
  49. (修补底座在上层暴露的能力缺口),差异全部登记在 [`docs/fork-delta.md`](docs/fork-delta.md)
  50. 并由 `scripts/verify-fork-drift.sh` 守卫字节级一致性——其余定制仍通过「写插件 + overlay 覆盖行」完成。
  51. - **可验证性优先**:CDP 实机验证技能 + 声明式断言跑器,界面改动必须跑真机三层验证
  52. (渲染 / 行为 / 零控制台错误)。
  53. ---
  54. ## 快速开始
  55. **环境要求**:Node `^22.19.0 || >=24.0.0`,pnpm `11.7.0`。
  56. ```sh
  57. pnpm install
  58. pnpm shell:dev # 开发态启动桌面应用
  59. pnpm pack # 打包 macOS 应用(.app / .dmg)
  60. ```
  61. > **平台说明**:当前打包链路面向 **macOS(Apple Silicon)**;跨平台(Windows / Linux)尚在规划中。
  62. ### 构建与检查
  63. ```sh
  64. pnpm build # 全量构建(packages/**)
  65. pnpm typecheck # 全量类型检查
  66. pnpm shell:smoke # 冒烟启动
  67. # fork 与官方基线的漂移守卫(改 fork 包后必跑)
  68. ./scripts/verify-fork-drift.sh
  69. ```
  70. ---
  71. ## 仓库结构
  72. ```
  73. packages/
  74. ├── desktop/ # Electron 桌面承载层(壳 + 宿主桥 + 打包)
  75. │ ├── src/host/ # host 侧:桥接、IPC、打包闭包
  76. │ ├── src/client/ # renderer 侧:壳、编辑器、布局
  77. │ └── assets/ # 品牌与图标资源
  78. └── plugins/ # 38 个插件包,按能力分组
  79. ├── ui/ (12) # 界面区域:面板、插件中心、主题基座
  80. ├── session/ (11) # 会话与交互:对话、审批、提问、模型选择
  81. └── agent/ (15) # Agent 能力:编排、子 Agent、记忆、MCP、工具
  82. profile/corum/ # 发行版 profile 清单
  83. cordis.patch.yml # 发行版 overlay(覆盖官方默认行 + 插入插件行)
  84. docs/ # fork 差异台账与开源资产
  85. scripts/ # 开发 / 验证 / 打包 / 审计脚本
  86. skills/ # 项目自带技能(开发规范、CDP 实机验证)
  87. ```
  88. **插件是怎么被加载的**:每个插件包自带 `cordis.patch.yml` 声明挂载行,发行版
  89. `cordis.patch.yml` 只放跨包覆盖;新增插件须同时登记进 `packages/desktop/package.json`
  90. 与 `packages/desktop/desktop-host/package.json`(打包闭包按后者补齐,遗漏会导致
  91. **仅打包态**功能缺失)。
  92. ---
  93. ## 启动主题
  94. 桌面端在“设置 → 外观 → 启动”中管理启动主题,支持导入 ZIP、预览、切换和删除。主题可使用 HTML 动画或本地视频,播放结束且主界面就绪后进入,也可按 Esc 跳过。
  95. 主题包格式、HTML 示例、视频模板与打包工具见 [启动主题制作说明](packages/desktop/startup-theme-kit/README.md)。仓库提供内置 HTML 终端动画和源文件模板,视频素材由主题作者自行放入包内。
  96. ## 插件开发
  97. Corum 支持不修改宿主源码的第三方插件:一个包可同时包含 **host 宿主半**与可选的
  98. **client 客户端半**,提供 Cordis 服务、注册 Agent 工具、读取会话信息,或扩展指定 UI 区域。
  99. 插件使用 `dsh.bundle` 形态分发,由自带的 `cordis.patch.yml` 完成挂载。
  100. - **完整开发指南**:[插件开发指南](packages/sdk/corum-plugin-sdk/GUIDE.md)(能力 API、安装、调试与故障排查)
  101. - **最小示例**:[hello-plugin](examples/hello-plugin/README.md)
  102. - **完整示例**:[region-replacement-plugin](examples/region-replacement-plugin/README.md)(UI 区域覆盖、设置页、工具注入与会话信息)
  103. ### 从脚手架开始
  104. 在独立目录中创建插件;`@you/my-plugin` 换成自己的包名,`my-plugin` 换成目标目录:
  105. ```sh
  106. npx --yes --package @corum/plugin-sdk corum-plugin-init \
  107. --name @you/my-plugin --dir my-plugin
  108. cd my-plugin
  109. pnpm install
  110. pnpm build
  111. ```
  112. 脚手架默认生成同时包含 host 与 client 的 K2 插件;只开发宿主能力时可加 `--kind k1`。
  113. SDK、构建配置、挂载声明和兼容字段会一并生成,无需手写 bundle 闭包。
  114. 若镜像源尚未同步 `@corum` 包,请在项目的 `.npmrc` 中配置:
  115. ```ini
  116. @corum:registry=https://registry.npmjs.org/
  117. ```
  118. ### 一个最小宿主插件
  119. ```ts
  120. import { definePlugin, type Context } from '@corum/plugin-sdk'
  121. export const name = 'hello-plugin'
  122. export const inject: string[] = []
  123. export function apply(ctx: Context): void {
  124. ctx.provide('helloPlugin', {
  125. greet: (who: string) => `hello, ${who}`,
  126. })
  127. }
  128. export default definePlugin({ name, inject, apply })
  129. ```
  130. 宿主半导出 `name`、依赖声明 `inject` 和装配函数 `apply`;副作用放进 `apply`,
  131. 不要放在模块顶层。客户端半可以注册 `corum.editor`、`corum.trajectory`、`corum.panel`
  132. 三个区域的覆盖组件,或添加「设置 → 扩展」页面;布局与内部槽位仍由宿主管理。
  133. ### 构建、安装与验证
  134. UI 插件必须完整执行三步构建,脚手架已配置好,**不要只运行 `tsdown`**:
  135. ```sh
  136. pnpm build # tsc -b && tsdown && corum-inline-css
  137. pnpm typecheck
  138. pnpm test # 若已添加测试
  139. ```
  140. 将插件安装到当前 Corum profile,然后重启应用使宿主半生效:
  141. ```sh
  142. cd ~/.corum/profiles/web
  143. pnpm add @you/my-plugin
  144. ```
  145. 开发者也可在「设置 → 高级」开启开发者模式,通过「集成中心 → 扩展包 → 导入本地扩展包」
  146. 导入目录或 ZIP。启动失败的插件会显示具体原因,并可从已装列表移除。
  147. 提交前至少通过类型检查、测试和构建;本仓插件还需运行:
  148. ```sh
  149. pnpm verify:plugin-spec
  150. pnpm verify:plugin-ui
  151. pnpm verify:plugin-guide
  152. ```
  153. ### 开发红线
  154. 1. **跨 bundle 共享状态一律用 Cordis 服务**,不要挂 window 全局或模块级单例
  155. (bundle 各自内联 `@corum/*` 源码,模块级状态会被复制成多份且永不收敛)。
  156. 服务通过 `inject` 声明后消费,不要对未装配的服务直接调用 `ctx.get`。
  157. 2. **不要随意 external 化 `@corum/*`**:底座的共享模块表有硬编码种子,
  158. 自建共享模块走 `dsh.client` 路径会导致白屏——用 Cordis 服务绕开。
  159. 3. **依赖分层不能混**:`@corum/plugin-sdk` 放 `dependencies`;`@deepseek-ai/*` 和
  160. `react` 放 `peerDependencies`,并镜像到 `devDependencies`,避免加载两份基座实例。
  161. 4. **host 插件改动必须重启应用**(renderer 改动才走 HMR);跨包状态 / 壳 / 调度器
  162. 改动必须过 **CDP 实机三层验证**(UI 渲染 + 行为 + 零控制台错误)。
  163. **「编译通过」不等于「做完了」。**
  164. 5. **本仓内置插件**使用 `pnpm create:plugin --name @you/my-plugin --dir packages/plugins/<组>/my-plugin`
  165. 生成,并登记到 `packages/desktop/package.json` 与 `packages/desktop/desktop-host/package.json`;
  166. 修改 fork 包前先读 [fork 差异台账](docs/fork-delta.md)。第三方 `dsh.bundle` 插件不需要这些登记。
  167. ---
  168. ## 与 DeepSeek Harness 的关系
  169. | | DeepSeek Harness | Corum Harness |
  170. |---|---|---|
  171. | 角色 | Agent 运行时内核 | Agent 产品发行版 |
  172. | 提供 | Cordis 框架、agent loop、工具系统、capability seam | Agent 能力产品化、38 个插件、默认配置 |
  173. | 依赖方式 | — | 大部分从 npm registry 引用官方包(`@deepseek-ai/dsh-*`);另维护 **16 个 fork 包**修补能力缺口 |
  174. 本项目维护 16 个 **fork 包**(用于修补底座在上层暴露的能力缺口),差异全部登记在
  175. [`docs/fork-delta.md`](docs/fork-delta.md),并有 `scripts/verify-fork-drift.sh` 守卫字节级一致性。
  176. ---
  177. ## 开源范围
  178. 本项目采用 **open core** 模式:
  179. - **开源(本仓库)**:**任务模式(Task Mode)**——单任务泳道 + 指挥模式 + 完整的 Agent
  180. 能力面(编排、子 Agent、记忆、MCP、技能、编程工作台)。
  181. - **闭源(独立维护)**:**项目模式(Project Mode)**——项目制工作区、多 Agent 团队协作、
  182. 需求 / 任务 / BUG 管理与项目级知识治理。**开源发行版只呈现任务模式**,不提供项目模式入口。
  183. > **剥离已完成(2026-09-27)**:项目模式的实现**已迁出本仓库**,现位于独立闭源仓
  184. > [Corum-Harness-Project](https://github.com/kukucaiCndy/Corum-Harness-Project);
  185. > **本仓库为纯任务模式的开源形态**(侧栏不再出现「项目」tab,无相关依赖与挂载行)。
  186. > 若要构建含项目模式的闭源形态,需把闭源仓的插件(`@corum/corum-project` 等)经 cordis patch
  187. > 挂载到本仓之上,具体步骤见该仓的 README。历史规划文档已不入库。
  188. ## 项目状态
  189. **早期开发阶段**,接口与配置仍在快速演进,尚未发布稳定版本(当前 `0.1.0`)。
  190. > **0.2.1-rc3 升级**:阶段0(备份与真实基线) ✅ 完成(远程经 PR #155)——fork-drift 真实 N=3,完整备份已建立,远程回滚点经 PR 合并完成。升级文档见 [`docs/UPGRADE-0.2.1-rc3.md`](docs/UPGRADE-0.2.1-rc3.md)。
  191. 欢迎通过 Issue 反馈问题与建议。
  192. ## 许可证
  193. [Apache License 2.0](LICENSE)。
  194. 选择 Apache-2.0 而非 MIT 的原因:它**显式授予专利许可**(第 3 节),对商业使用与
  195. 企业贡献者更友好,同时保留商标条款(第 6 节)。上游 DeepSeek Harness 为 MIT,
  196. 与本许可证兼容。
  197. ## 致谢
  198. 本项目构建于 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 与
  199. [Cordis](https://github.com/deepseek-ai/cordis) 之上,感谢底座团队的工作。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.