deepseek-harness/packages/settings/README.zh.md

description, kind

description	kind
用户设置能力族的包映射：解析各 namespace 配置的 ctx.settings 服务，以及存储它的 YAML/JSON 文件提供方。	package-group

settings/：用户可编辑配置

English | 中文

概述

settings/ 组让插件配置变为用户可编辑：插件用一个 schema 注册具名 namespace，用户在一份文档里覆盖值，无需改动 cordis.yml。用户覆盖优先于部署自身的配置与 schema 默认值，变更实时生效。两个包覆盖该能力：settings/ 提供设置服务，settings-file/ 把所有 namespace 存进一个用户可编辑的 YAML 或 JSON 文档。设置是可选的：没有挂载提供方时，配置保持组合原样。

目录

• 包
• 相关文档
• 开发备注

---

包

两个包覆盖该能力；完整约定由各子级 README 负责，穷尽式服务接口面由子系统参考负责。

包	角色	ctx 键
settings/	设置服务：注册 namespace 并读取或修改其值	ctx.settings
settings-file/	把设置存进一个本地 YAML/JSON 文件并热发布外部编辑	注册 ctx.settings

---

相关文档

先从子系统参考了解共享词汇，再看本家族遵循的能力 seam 拆分。

• 设置子系统参考——namespace、分层解析、descriptor、变更提交与生成的 cordis 接口面。
• 能力 seam——本家族遵循的 Service Definition / Service Provider / Consumer 拆分。

开发备注

维护者的工作上下文——点击展开

无。