• 实操手册:审阅持久化类型变更

    description: "在创建 PR 前,本地生成、确认并验证会话持久化类型变更。" 实操手册:审阅持久化类型变更 English | 中文 概述 在已安装依赖的贡献者检出目录中修改会话持久化类型声明后,使用本教程。提供双语兼容性说明,再用一条命令分类变更并生成记录。记录参考解释文件和自动规则。

  • 在堆叠 PR 链中回应评审意见

    English | 中文 评审意见可能同时针对一条依赖堆叠(A ← B ← C …)中的多个 PR(Pull Request)。请通过 GitHub 官方的堆叠 PR 功能保持这条链的关联。本指南负责评审修复的归属与传播;dsh-merging-stacked-prs skill(技能)负责检查关联

  • 维护 dsh-code-review skill

    English | 中文 dsh-code-review skill(技能)由一名指定操作员通过私有的周期维护工具持续更新。本实操手册既是该操作员和接任者的入口,也帮助仓库贡献者理解为何 skill 更新会以小型周期 PR(Pull Request)的形式出现,而不是一次性审计。工作流本身由人工评审

  • 实操手册:扩展插件形态

    English | 中文 harness 扩展的参考模式。代码片段省略了 import 和辅助实现,无法直接复制运行。具体编写路径见包检查清单、第一个工具教程、工具参考、LLM(大语言模型)适配器指南和 Session 格式版本教程;系统与扩展点映射由架构文档负责。 工具插件 工具在 ctx.too

  • 实操手册:添加 LLM(大语言模型)适配器

    English | 中文 如何接入一个新的模型提供方。参考实现:packages/llm/llm-deepseek(直接 HTTP,SSE(Server-Sent Events)由 eventsource-parser 分帧)与 packages/llm/llm-pi-ai(封装 LLM 库)。请先

  • 实操手册:添加一个 vendored 包

    English | 中文 当 harness 需要引入另一个上游 Cordis 包(如 @cordisjs/plugin-http)时,应将其作为固定版本的源码 vendor 到 vendor/ 下,而非作为 NPM 依赖添加。vendor/README.md 说明其原因并介绍如何更新已有的 ven

  • 工具编写参考

    English | 中文 面向模型的工具必须满足哪些约定,均以本文为准。如需按步骤构建第一个工具,请阅读构建工具。packages/shell/tool-bash 是生产级的三包示例。 最小形态 import { readFile } from 'node:fs/promises' import t

  • 实践指南:即时配置表单

    English | 中文 在插件 Config schema 中声明即时字段,并通过产品所属的设置卡片提供编辑入口。导出的 Config 接口描述插件收到的值,包括每个 Volatile<T> 引用。 1. 声明即时字段 import type { Context, Volatile } from

  • 实操手册:添加 Session 日志格式版本

    English | 中文 概述 本教程介绍如何添加下一个结构性 Session 日志版本,同时不改写已发布数据。阅读版本与发布状态真源,确定工作区写入器与最新已发布格式。令 N 表示经核实的已发布格式,N+1 表示目标版本;名称与元数据中的这些占位符须替换为数字。开始前,请准备可用的贡献者工作区,并

  • 实操手册:新增一个 Remote API

    English | 中文 新增或改动一个 ctx.remote 端点按本页五步走:声明方法、声明失败、在包上注册、在 Client 消费、写测试。decorator 语义、lookup 解析、生成管线与 /api 路由属于机制,由 API Gateway 参考负责;本页给的是每一步的动作与必须遵守的