# hecong_agent **Repository Path**: hecong9402/hecong_agent ## Basic Information - **Project Name**: hecong_agent - **Description**: 基于cordis的插件化工程。带agent,但是我希望不止是agent,感谢deepseek harness的开源代码参考。 - **Primary Language**: Unknown - **License**: AGPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-25 - **Last Updated**: 2026-10-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # hecong_code 基于 Cordis 插件架构的 agent 工程:插件之间通过**服务名**装配、通过**事件**协作、通过**配置**决定挂载什么,而不是靠编译期的 import 硬连。 > 这份文件**只做目录介绍**。规范与注意事项在 [`AGENTS.md`](./AGENTS.md),长篇设计记录在 [`.doc/`](./.doc/README.md)。 ## 目录 ``` framework/ 框架层(vendored,源码内嵌,见 framework/MANIFEST.md) core/ Context / Service / Fiber / Events / Logger cosmokit/ 工具集 + Volatile 不可变配置引用 schemastery/ 配置 Schema:校验 + 默认值 + 类型反推 loader/ 运行时插件树(按名字 import、跟踪 Fiber) include/ cordis.yml → 插件树,patch 叠加、!!js、回写闸门 group/ yml 里的嵌套插件组 timer/ 随插件卸载自动清理的定时器 hmr/ 热模块替换 + 配置热重载 platform/ 基座(与 agent 无关的基础设施) core/ workspace/ 记录落点:.config / .data / .log / agents 四条线 + 项目分组 config/ 配置层:域注册表 + 每域一个值文件 + 变更事件(ctx.settings) storage/ 非会话持久化:domain KV logging/ core/ 日志共享契约(调用点 / 归属 / 脱敏 / 序列化) console/ 控制台 exporter file/ 磁盘 exporter(JSONL 切分 + 保留) agent/ agent 能力域(编排内核 + 它依赖的平台能力) agent-core/ loop/ agent/ agent 循环:turn/step、inbox、流式落盘、崩溃修复、压缩、工具并发 prompt/ 系统提示词装配:多贡献者 + 运行时上下文 + 装配 waterfall tools/ 工具域:唯一调用入口(注册表 + 五段流水线 + 会话感知可见性)+ 内置工具 ptc/ runtime/ PTC 执行的服务定义:跑一段程序,宿主绑定成为它的全局函数 node/ PTC 的 Node 提供方:每段程序一条新进程(空环境 + 沙箱约束) guard/ approval/ 人类介入:审批与提问的 seam(fail-closed) plan/ 只读规划模式:写入类工具在提交计划前被拒 fs-observe/ 读后才可改:write/edit 前必须读过且文件未被改过 spill/ 超大工具输出落盘:头 + 提示 + 尾(read 除外) preset/ agent 定义:目录即定义(<数据根>/agents/<名字>/:人设 + 工具白名单 + 技能 + 调用方式) runner/ 会话运行器:按会话 header 恢复 agent,收发消息、取消、状态 worker/ 干活型插件的执行器:外放进程 + 传参 + 收结果(崩溃不带走宿主) mcp/ MCP 客户端:连本地(stdio)/ 远程(streamable-http)server,把工具接成一等工具 agent-platform/ model/ 模型能力域:注册表 + 4 门面 + 3 个驱动 sandbox/ 最底层约束:可读 / 可写 / 可执行三轴 + ctx.fs + 可替换后端 context/ 会话上下文:工作目录 + AGENTS.md 指令链 session/ log/ 会话事件日志:header 版本戳 + 不可变世代 + 原子追加 attachment/ 附件存储:内容寻址去重 + 图片尺寸探测 stats/ 会话统计:轮/步、模型与工具用时、首 token 平均、token 与缓存命中 connect/host/ 本地 Host:方法表(HTTP /rpc)+ 事件推送(SSE /events)+ 内置界面 connect/ 基础设施层容器(其余部分待建):远程 Cordis 事件入口 + 广播出口 worker_plugin/ 干活型插件(进程外跑):一个子目录一个插件(plugin.json + index.mjs) apps/dev/ 装配层:main.ts 离线验收、live.ts 真模型跑一轮 apps/desktop/ 桌面壳(Electron,只起 Host + 开窗口) media/ 跨层的设备/媒体 I/O(谁都能用,不是 agent 能力) voice/ 语音播报:服务 ctx.voice(放音频 + 串行队列)+ 配置域 voice(事件 → 文件)+ 工具 speak ui/ 界面(块 ui;workbench/ = 工作台) .doc/ 长篇设计记录(为什么这样设计) ``` ## 目录即模块即块 **块从磁盘推导**:目录里有 `intro.md` 就是一个模块(= 块树上的一个块),块 id 就是目录名; 目录里有 `package.json` 就是它的一个包(= 块里的一行)。所以: - 加模块 = 建目录 + 写一份 `intro.md`,不用改任何声明(`package.json` 里不再有 `plugin-block-tree`); - 只写 `intro.md` 不写代码 = 空块(`state: 'empty'` + `code: false`),不算插件;蓝图叶子只允许出现在 `worker_plugin/`; - 细节见 [`.doc/directory-blocks.md`](./.doc/directory-blocks.md)。 ## 各目录的详细说明 每一层都有自己的 `README.md`,逐个目录一句话介绍它下面的东西: | 目录 | README | |---|---| | 框架层 | [`framework/` 来源清单](./framework/MANIFEST.md) · 各包 `README.md` | | 能力域 | [`agent/README.md`](./agent/README.md) · 各模块目录的 `intro.md` | | 基座 | `platform/catalog/intro.md`(扫代码树出插件清单)· `platform/core/intro.md` · `platform/logging/intro.md` | | 装配层 | [`apps/dev/README.md`](./apps/dev/README.md) | | 设计记录 | [`.doc/README.md`](./.doc/README.md) | ## 三份文档各管什么 | 文件 | 职责 | 不该写什么 | |---|---|---| | `README.md`(本文件) | **目录介绍**:有什么、在哪、怎么找 | 规范、命令、取舍理由 | | `AGENTS.md` | **规范与注意事项** + agent 需要知道的事实 + 全库索引 | 目录逐个介绍(指回这里) | | `.doc/*.md` | **长篇记录**:为什么这样设计、实测结论 | 用法、逐目录介绍 |