搜索结果

English | 中文 @deepseek-ai/dsh-* harness 包之间的 peer 依赖关系。peer 表示消费端需要提供共享实例，不包括普通运行时 dependency 或仅开发期关系。该图按 packages/<group>/<pkg> 层级分组；边 a --> b 表示包 a peer 依赖包 b。名称中的 @deepseek-ai/dsh- 前缀已移除。 flowchart TD subgraph group_util["packages/util"] pkg_atomic_w...

English | 中文 会话持久事件日志中可能出现的所有事件类型：完整持久化的 SessionEvent 信封，以及可通过合并扩展的 SessionEventMap 中的每个成员，包括 @deepseek-ai/dsh-session 所属的词汇和本仓库中每个插件对 @deepseek-ai/dsh-session/types 的声明合并，并附有源 JSDoc、完整 payload 声明、surface 标记和声明位置。本文档是 session.md（surface 排序与 deriveMessages() 投...

English | 中文 Cordis 框架及其基础库以源码形式 vendored 在 vendor/ 下，并以 @deepseek-ai scope 发布：每个 harness 包都把框架声明为 peer dependency，发布 harness 就会连带发布这一层，用上游名发布等于在 registry 上占用别人的名字。本页是名字映射表；决策与影响见 改名 Agent Note，上游 commit 见 vendor/README.md。 名字映射 目录 上游名 发布名 上游版本 角色 vendo...

English | 中文 本文说明本仓库的分层测试方式，以及保持绿色测试套件有意义的规则。命令见根目录 AGENTS.md；相关 Agent Note 承载设计动机。 层级 单元测试（pnpm run test）：vitest 运行包和示例各自的 tests/** 目录下的测试，以及匹配 scripts/**/*.spec.ts 的仓库脚本测试；测试文件与其所覆盖的代码区域放在一起。每个注册表都有一个 HMR（热模块替换）安全测试（对向该注册表贡献内容的 fiber 执行 dispose（资源释放），并断言清理...

English | 中文 已发布插件向 ctx.tools 提供的所有面向模型的工具：模型通过系统提示词组装获得的 name、description 和 JSON Schema parameters。本目录是子系统页面（类型及每页生成的 cordis-surface 接线区域）的补充；本页列出的是向 agent（智能体）提供的工具。 英文源文件由系统生成，并通过 pnpm run verify-tool-catalog（doc-sync（文档同步门禁）的一部分）验证新鲜度；本中文文件作为经评审对侧通过双语配对维护...

English | 中文 此图展示策略、钩子、沙箱、文件系统守卫、结果重写、最终结果观察和 UI 渲染在不改变循环的情况下何时运行。tools/pre-execute waterfall（瀑布式事件）首先运行，随后是单调守卫，然后运行 tools/execute 和 tools/post-execute waterfall；这三个 waterfall 可以改写一次调用。由定义自身控制的 finalizeContent 和 tools/result 在此之后运行。 flowchart TD model["Ass...

English | 中文 本文规定浏览器客户端包的样式职责归属与组件规则。当前 token 值位于 packages/client/ui-theme/src/styles/；本文不重复这份由源码生成的清单。 职责归属 ui-theme 负责 --dsw-* 静态色阶、语义别名、排版、动效、渐变、阴影、滚动条样式以及明暗主题偏好。ui-layout 将解析后的主题快照应用到文档。功能包使用语义别名，不得另行定义全局主题。 全局样式表归 ui-theme/src/styles/ 所有。组件样式以 CSS Modules...

--- description: "DeepSeek Harness 包工作区：packages/ 下的 npm 包如何分组、每个组负责什么，以及约束它们的约定。" kind: "package-group" --- 包 English | 中文 概述 harness 由 packages/ 下的 npm 包组装而成，按能力系列分组：会话与 agent 循环、面向模型的工具、shell 与文件系统执行、Web 访问、subagent 等等。把本页当作顶层地图使用：先找到拥有某能力的组，再打开其 README 查看...

--- description: "core 分组地图：构成产品 API 主干的会话日志、系统提示词组装、工具注册表、agent 词汇与默认循环。" kind: "package-group" --- English | 中文 概述 core 分组提供 DeepSeek Harness 的产品 API 主干：仅追加的会话日志、系统提示词组装、工具注册表、Agent 句柄，以及驱动它们的具体循环。每个组合都会启动这些包，插件与消费方构建所依赖的正是它们稳定的约定。一个轮次会流经其中全部环节——循环领取提示词，在会话...

--- description: "应用 Remote 层的包映射：类型化的 Client 到 Host 能力调用、结果与转发事件，供用户与维护者浏览该组。" kind: "package-group" --- English | 中文 概述 api/ 组提供应用的 Remote 层：Client 环境可以调用运行在 Host 上的业务能力——管理目标、运行命令、查看插件清单、发现文件与会话引用——调用方式是类型化方法，并接收结果或转发的 Host 事件。remotes 决定暴露哪些能力、以及每次调用如何到达正确...

--- description: "typert 组地图：构建时类型图生成器、运行时注册表、Loader 集成与共享 Remote 协议，它们共同支撑类型化的 Host 到 Client 调用。" kind: "package-group" --- English | 中文 概述 借助 typert 组，Client 环境能以类型化方法调用 Host 能力，并在无需手写协议代码的情况下共享生成的 schema 与反射信息。构建时生成器把源代码类型声明转换为与编译器无关的模型与运行时产物，运行时注册表保存这些产物，...

--- description: "goal 组地图：每会话一个持久的完成目标，以及模型工具、用户命令与自动续行，供浏览本组的用户与维护者阅读。" kind: "package-group" --- English | 中文 概述 goal 组为 agent 会话提供一个持久的完成目标，在重启、resume（恢复）与 fork 后依然存在：goal 服务持久保存状态与生命周期，模型工具让 agent 创建和更新 goal，/goal 命令让用户无需模型轮次即可直接控制 goal，续行驱动器则把 active 的 ...

--- description: "schedule 组地图：基于会话日志的会话本地持久提醒，供浏览本组的用户与维护者阅读。" kind: "package-group" --- English | 中文 概述 schedule 组为运行中的会话提供会话本地提醒：让 agent 在稍后、绝对时间或固定间隔提醒你，每条提醒到期时都会作为同一会话中的普通消息到达。它的宿主包拥有三个管理工具，并可通过可选的 Session projection registry 发布完整活动记录集合。独立的 ui-schedule 浏...

--- description: "feedback 包组：关于会话与 assistant 消息的用户反馈，供用户与维护者选择、组合或排查反馈采集。" kind: "package-group" --- English | 中文 概述 feedback 组收集用户对 harness 工作成果的意见：用户可以提交一条关于整个会话的自由文本评价，也可以对单条 assistant 消息评分或加备注。两类反馈都不会到达模型——它们是关于输出的信号，绝不是输入。用户通过 /feedback 命令记录会话评价；产品界面通过 ...

--- description: "identity 包组：由遥测、反馈与 DeepSeek 提供方请求共享的匿名按 harness home 关联 id。" kind: "package-group" --- English | 中文 概述 identity 组为每个 harness home 提供一个匿名 id，该安装的遥测、反馈与 DeepSeek 请求会把它附加到各自的记录上，因此离开同一个 home 的所有内容都能被识别为来自同一套安装，而无需识别用户身份。无需配置任何东西：id 会在这些功能之一首次运...

--- description: "LLM 能力包组：一个提供方无关的模型调用服务、DeepSeek 与 pi-ai 提供方适配器、请求重试执行器，以及具备回放感知的 token 计量。" kind: "package-group" --- English | 中文 概述 llm 组提供 harness 的模型调用能力：一个提供方无关的服务，任何组合都可以通过它向模型提供方发起流式请求，外加适配器、提供方专用请求元数据、重试执行与计量。核心 llm 包定义所有插件与会话日志使用的消息、内容块与流式分片词汇；提供方...

--- description: "E2B 远程运行时组映射：把文件与命令工作放进一个远程 Linux 沙箱，供 E2B 家族的用户与维护者浏览。" kind: "package-group" --- English | 中文 概述 e2b 组把 agent（智能体）的文件与命令工作移入远程 Linux 沙箱：文件读写、shell 命令与终端都在同一个远程世界中运行，而不是在你的机器上。三个包协同工作——一个提供共享沙箱，一个让文件操作在其中运行，一个让命令与终端在其中运行。启用本家族后，现有的 shell、终端...

--- description: "subprocess 组地图：共享的子进程服务及其本地宿主提供方，供浏览本组的用户与维护者阅读。" kind: "package-group" --- English | 中文 概述 harness 运行的每个子进程与终端会话——bash 命令、语言服务器、持久 shell 与进程外 subagent 后端——都经由一个共享服务（ctx.subprocess）启动、观察与终止，并由一个本地提供方在宿主机器上执行。它不是独立的产品功能：消费方能力 seam 决定每个进程的含义，命...

--- description: "面向部署方与维护者的 bash 能力家族说明，用于选择并组合 shell 执行器、沙箱化与面向模型的 bash 与 pwsh 工具。" kind: "package-group" --- English | 中文 概述 shell 组为 agent 提供命令执行能力：运行前台命令并读取其有界输出，或启动后台进程并轮询它——在 POSIX 上用 Bash，在 Windows 上用 PowerShell。每个组合恰好挂载一个执行器实现；沙箱执行器会通过沙箱能力限制每条命令，面向模型...

--- description: "持久终端能力家族的包映射：限定所有者范围的 ctx.terminals 服务、启动交互式 bash 或 pwsh 的 shell 后端，以及 6 个面向模型的工具。" kind: "package-group" --- English | 中文 概述 terminal/ 组为 agent 提供持久且限定所有者范围的终端会话：shell 与 REPL 状态——cwd、导出的变量、激活的环境、正在运行的交互式子进程——都能跨工具调用存活。三个包共同覆盖整个家族：terminal/ ...