imccyu
ec601ca13d
Machine-produced by `pnpm run rescope-vendor --apply` plus the regeneration it prints: `pnpm install` for the lockfile, `pnpm run gen-third-party-notices`, `verify-translation-pairing --write` for the touched bilingual pairs, `gen-doc-graphs`, and one typert snapshot whose ids embed character offsets. `pnpm run rescope-vendor --check` verifies the result. Renames nine vendored packages (cordis, cosmokit, schemastery and the six @cordisjs plugins) and every reference that resolves them: manifest names and dependency keys, module specifiers including declare-module merges, cordis.yml plugin names, tsconfig paths, every Markdown fence, and `docs/` prose. Directory names, upstream versions, and dependency ranges are unchanged, so vendor/README.md still reads as an upstream snapshot; its manifest table gains an upstream-name column so THIRD_PARTY_NOTICES keeps MIT attribution pointed at each fork's origin. The tutorial tier follows the rename end to end: its yaml fences named plugins the Loader can no longer resolve, its `ts ignore-check` fences disagreed with the compiled fences beside them, and its prose quoted both. The contracts that told readers to keep upstream names — the root convention and the vendoring cookbook's tree comment and manifest invariant — now say to rescope instead. Two rules read `@deepseek-ai/` as "another workspace plugin": the client bundle purity gate now names the vendored libraries a browser bundle inlines, and the files where a bare `cordis` is an agent-preset id keep that product data.
2.7 KiB
2.7 KiB
dsh-environment
English | 中文
把本次运行的环境冻结为一份不可变快照，并记住每个值来自哪一层。消费方用它而不是 process.env 解析面向用户的值，因为各层的可信程度并不相同，而压平后的视图无法区分它们。
| 层 | 来源 id | 它是什么 |
|---|---|---|
| 继承的进程环境 | process |
启动 shell、CI 任务或容器传入的东西——本次运行的明确意图 |
<invocation cwd>/.env |
project-env |
harness 被启动于其中的项目；产品信任它配置自己的 agent（智能体） |
$DSH_HOME/.env |
user-env |
用户自己的机器级默认值 |
这些值同样会进入 process.env——用户自己的 --config 树和第三方库要读它——但那份压平的视图不是 harness 解析任何值的依据。
解析
get(name) 按可信度从高到低搜索所有层。getFrom(name, sources) 只搜索指定的层，不改变这一可信顺序。
省略某一层是拒绝，不是降级——绝不能接受某一层的调用方直接不把它列进去，后续任何重新排序都无法让它回来。提供方适配器三层全列，因为产品信任它所运行的项目；该机制是为那些「并非如此」的决策准备的。
变量名按平台自身的规则匹配：POSIX 上精确匹配，Windows 上不区分大小写。在 Windows 上做大小写敏感的查找会选错层——shell 里的 deepseek_api_key 与项目 .env 里的 DEEPSEEK_API_KEY 对操作系统而言是同一个变量，把它们当成两个就会让项目胜出。
import type { Context } from '@deepseek-ai/cordis'
import { environmentOf } from '@deepseek-ai/dsh-environment'
declare const ctx: Context
const endpoint = environmentOf(ctx).get('DEEPSEEK_BASE_URL')?.value
当产品 CLI（命令行界面）启动了这棵树时，environmentOf(ctx) 返回启动器的快照；否则返回只含继承环境的那一层。该回退并不削弱规则：SDK 宿主或裸 cordis.yml 从未发现过任何文件，因此它拥有的一切确实就是它被启动时的环境。
已知限制与暂缓事项
- 快照不是子进程边界：每一层同样会被物化进
process.env，因此项目里的普通变量会按dsh-subprocess的清洗规则抵达子进程。产品启动器的.env约定 会在物化之前拒绝 bootstrap 变量。 - 没有按工作区划分的层：项目层是调用目录，在启动时固定。之后在 Web UI 中选择的工作区不贡献任何内容，这是刻意的：跟随它等于让模型自己的工作区在会话中途改变 harness 的环境。