Merge codex/goal-session into codex/commands
This commit is contained in:
Tianyi Cui
@@ -601,7 +601,7 @@ Goal mutation accepted by one live agent. The matching context event is already
|
||||
* adapter's stream, or yield your own chunks to short-circuit.
|
||||
* @param options - the full request. A LOOP-built request arrives
|
||||
* deep-frozen (mutation throws): its content is a pure function of the
|
||||
* session log (the reconstructability RFC), so listeners read it, never
|
||||
* session log (the reconstructability Agent Note), so listeners read it, never
|
||||
* rewrite it. A hand-built one-shot (compaction summarize) is the
|
||||
* caller's own object and stays mutable here.
|
||||
* @mode waterfall
|
||||
@@ -611,7 +611,7 @@ Goal mutation accepted by one live agent. The matching context event is already
|
||||
|
||||
Waterfall around every streaming model call (retry, replay, routing). Bound to the LlmService; call `next()` to reach the resolved adapter's stream, or yield your own chunks to short-circuit.
|
||||
|
||||
- `options` — the full request. A LOOP-built request arrives deep-frozen (mutation throws): its content is a pure function of the session log (the reconstructability RFC), so listeners read it, never rewrite it. A hand-built one-shot (compaction summarize) is the caller's own object and stays mutable here.
|
||||
- `options` — the full request. A LOOP-built request arrives deep-frozen (mutation throws): its content is a pure function of the session log (the reconstructability Agent Note), so listeners read it, never rewrite it. A hand-built one-shot (compaction summarize) is the caller's own object and stays mutable here.
|
||||
|
||||
[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/llm/llm/src/index.ts#L43)
|
||||
|
||||
|
||||
@@ -6,38 +6,38 @@
|
||||
|
||||
Cordis 微内核提供的基础能力，所有插件开发都建立在这些 API 之上：
|
||||
|
||||
- [Context](./cordis/context) — 上下文对象，所有服务和方法的入口
|
||||
- [Events](./cordis/events) — 事件系统 API（on / emit / bail / serial / waterfall）
|
||||
- [Fiber](./cordis/fiber) — 插件生命周期（状态机、effect、dispose）
|
||||
- [Registry](./cordis/registry) — 插件注册（plugin / inject）
|
||||
- [Service](./cordis/service) — 服务基类
|
||||
- [Context](cordis/context) — 上下文对象，所有服务和方法的入口
|
||||
- [Events](cordis/events) — 事件系统 API（on / emit / bail / serial / waterfall）
|
||||
- [Fiber](cordis/fiber) — 插件生命周期（状态机、effect、dispose）
|
||||
- [Registry](cordis/registry) — 插件注册（plugin / inject）
|
||||
- [Service](cordis/service) — 服务基类
|
||||
|
||||
## Harness API
|
||||
|
||||
每个 `ctx.*` 服务一页，按服务名索引：
|
||||
|
||||
- [ctx.agentLoop](./harness/agent-loop) — ReAct 循环的创建与恢复
|
||||
- [ctx.agents](./harness/agents) — Agent 注册表与工厂
|
||||
- [ctx.approval](./harness/approval) — 用户审批
|
||||
- [ctx.bash](./harness/bash) — Bash 执行接口（抽象缝）
|
||||
- [ctx.codeRuntime](./harness/code-runtime) — 代码执行接口（抽象缝）
|
||||
- [ctx.compact](./harness/compact) — 上下文压缩接口（抽象缝）
|
||||
- [ctx.fs](./harness/fs) — 文件系统接口（抽象缝）
|
||||
- [ctx.llm](./harness/llm) — LLM 服务与适配器注册
|
||||
- [ctx.permission](./harness/permission) — 权限策略
|
||||
- [ctx.sandbox](./harness/sandbox) — 沙箱执行接口（抽象缝）
|
||||
- [ctx.sessionPersistence](./harness/session-persistence) — 会话持久化接口（抽象缝）
|
||||
- [ctx.sessionQuery](./harness/session-query) — 会话检索
|
||||
- [ctx.sessions](./harness/sessions) — 会话存储
|
||||
- [ctx.skills](./harness/skills) — 技能加载
|
||||
- [ctx.subagents](./harness/subagents) — 子代理委派
|
||||
- [ctx.systemPrompt](./harness/system-prompt) — 系统提示词组装
|
||||
- [ctx.tasks](./harness/tasks) — 后台任务
|
||||
- [ctx.tools](./harness/tools) — Tool 注册表
|
||||
- [ctx.userInteraction](./harness/user-interaction) — 用户交互接口
|
||||
- [ctx.web](./harness/web) — Web 搜索与抓取
|
||||
- [ctx.workflows](./harness/workflows) — 动态工作流引擎（抽象缝）
|
||||
- [ctx.agentLoop](harness/agent-loop) — ReAct 循环的创建与恢复
|
||||
- [ctx.agents](harness/agents) — Agent 注册表与工厂
|
||||
- [ctx.approval](harness/approval) — 用户审批
|
||||
- [ctx.bash](harness/bash) — Bash 执行接口（抽象缝）
|
||||
- [ctx.codeRuntime](harness/code-runtime) — 代码执行接口（抽象缝）
|
||||
- [ctx.compact](harness/compact) — 上下文压缩接口（抽象缝）
|
||||
- [ctx.fs](harness/fs) — 文件系统接口（抽象缝）
|
||||
- [ctx.llm](harness/llm) — LLM 服务与适配器注册
|
||||
- [ctx.permission](harness/permission) — 权限策略
|
||||
- [ctx.sandbox](harness/sandbox) — 沙箱执行接口（抽象缝）
|
||||
- [ctx.sessionPersistence](harness/session-persistence) — 会话持久化接口（抽象缝）
|
||||
- [ctx.sessionQuery](harness/session-query) — 会话检索
|
||||
- [ctx.sessions](harness/sessions) — 会话存储
|
||||
- [ctx.skills](harness/skills) — 技能加载
|
||||
- [ctx.subagents](harness/subagents) — 子代理委派
|
||||
- [ctx.systemPrompt](harness/system-prompt) — 系统提示词组装
|
||||
- [ctx.tasks](harness/tasks) — 后台任务
|
||||
- [ctx.tools](harness/tools) — Tool 注册表
|
||||
- [ctx.userInteraction](harness/user-interaction) — 用户交互接口
|
||||
- [ctx.web](harness/web) — Web 搜索与抓取
|
||||
- [ctx.workflows](harness/workflows) — 动态工作流引擎（抽象缝）
|
||||
|
||||
事件总表：[Harness events](./harness/events) — 全部事件按作用域分组，含触发模式与载荷签名。
|
||||
事件总表：[Harness events](harness/events) — 全部事件按作用域分组，含触发模式与载荷签名。
|
||||
|
||||
想学"怎么写一个 tool / 插件"？教程在[开发指南](../develop/basic/)；本节只做精确的接口参考。
|
||||
|
||||
@@ -52,8 +52,8 @@ Cordis 选择了不同的路径——在运行时层面解决可组合性问题
|
||||
|
||||
这由两个互补机制实现：
|
||||
|
||||
- **[可逆作用](./revertible-effects)** — 将副作用形式化为可逆的群操作
|
||||
- **[响应式余作用](./reactive-coeffects)** — 将依赖建模为具有生命周期的服务
|
||||
- **[可逆作用](revertible-effects)** — 将副作用形式化为可逆的群操作
|
||||
- **[响应式余作用](reactive-coeffects)** — 将依赖建模为具有生命周期的服务
|
||||
|
||||
## 在 Agent 开发中的意义
|
||||
|
||||
|
||||
@@ -16,11 +16,11 @@ Harness 追求三种可组合性的统一：
|
||||
|
||||
## 目录
|
||||
|
||||
- [可组合性与插件系统](./composability) — 组合的本质，以及传统插件系统为什么不可靠
|
||||
- [作用与余作用](./effects-coeffects) — Cordis 效果系统的理论模型
|
||||
- [可逆作用](./revertible-effects) — 时间可组合性的形式化定义与证明
|
||||
- [响应式余作用](./reactive-coeffects) — 空间可组合性的服务语义
|
||||
- [上下文模型](./context-model) — Context 如何将作用与余作用统一
|
||||
- [可组合性与插件系统](composability) — 组合的本质，以及传统插件系统为什么不可靠
|
||||
- [作用与余作用](effects-coeffects) — Cordis 效果系统的理论模型
|
||||
- [可逆作用](revertible-effects) — 时间可组合性的形式化定义与证明
|
||||
- [响应式余作用](reactive-coeffects) — 空间可组合性的服务语义
|
||||
- [上下文模型](context-model) — Context 如何将作用与余作用统一
|
||||
|
||||
## 设计如何映射到 Harness
|
||||
|
||||
|
||||
@@ -159,5 +159,5 @@ export function apply(ctx: Context) {
|
||||
|
||||
## 下一步
|
||||
|
||||
- [开发一个 Tool](./tool) — 详细了解 tool 定义 DSL
|
||||
- [插件配置](./config) — 让插件接受用户配置
|
||||
- [开发一个 Tool](tool) — 详细了解 tool 定义 DSL
|
||||
- [插件配置](config) — 让插件接受用户配置
|
||||
|
||||
@@ -238,5 +238,5 @@ export function apply(ctx: Context) {
|
||||
|
||||
## 下一步
|
||||
|
||||
- [插件配置](./config) — 让你的 tool 可配置
|
||||
- [插件配置](config) — 让你的 tool 可配置
|
||||
- [能力三件套](../practice/) — 了解 seam/impl/consumer 模式
|
||||
|
||||
@@ -153,5 +153,5 @@ effect cleaned up
|
||||
|
||||
## 下一步
|
||||
|
||||
- [服务与依赖](./service) — 让你的插件对外提供能力
|
||||
- [事件系统](./events) — 插件间通信的核心机制
|
||||
- [服务与依赖](service) — 让你的插件对外提供能力
|
||||
- [事件系统](events) — 插件间通信的核心机制
|
||||
|
||||
@@ -177,5 +177,5 @@ export function apply(ctx: Context) {
|
||||
|
||||
## 下一步
|
||||
|
||||
- [事件系统](./events) — 插件间松耦合通信
|
||||
- [事件系统](events) — 插件间松耦合通信
|
||||
- [能力三件套](../practice/) — 服务在 seam 模式中的应用
|
||||
|
||||
@@ -153,4 +153,4 @@ export function apply(ctx: Context) {
|
||||
|
||||
## 下一步
|
||||
|
||||
- [LLM 适配器](./llm-adapter) — 实现一个 LLM 后端（最常见的 seam 扩展）
|
||||
- [LLM 适配器](llm-adapter) — 实现一个 LLM 后端（最常见的 seam 扩展）
|
||||
|
||||
@@ -28,7 +28,7 @@ Harness 将一个 AI Agent（智能体） 所需要的所有能力——LLM 调
|
||||
2. 填写 API key
|
||||
3. 运行
|
||||
|
||||
不需要写任何代码。详见 [快速开始](./quickstart)。
|
||||
不需要写任何代码。详见 [快速开始](quickstart)。
|
||||
|
||||
### 插件开发者
|
||||
|
||||
|
||||
@@ -94,5 +94,5 @@ echo-agent 和 repl-agent 用的是同一个应用框架(`@deepseek-ai/dsh-stdio
|
||||
|
||||
## 下一步
|
||||
|
||||
- [配置文件](./config) — 了解 `cordis.yml` 的完整语法
|
||||
- [配置文件](config) — 了解 `cordis.yml` 的完整语法
|
||||
- [开发插件](../develop/basic/) — 编写你自己的 tool 或后端
|
||||
|
||||
Reference in New Issue
Block a user