@deepseek-ai/dsh-shell-env 0.1.5-rc.2 → 0.1.6-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.i18n.yaml +1 -1
- package/README.zh.md +6 -6
- package/package.json +10 -10
package/README.i18n.yaml
CHANGED
|
@@ -3,4 +3,4 @@
|
|
|
3
3
|
# after editing either side, bring the other along and re-record with:
|
|
4
4
|
# pnpm run verify-translation-pairing --write packages/shell/shell-env/README.md
|
|
5
5
|
README.md: f85fb0005e94dc59939cfd2e9f0d69e5cdc7d133
|
|
6
|
-
README.zh.md:
|
|
6
|
+
README.zh.md: b9f763a247fc792335326d8945dfeb2db1690fc7
|
package/README.zh.md
CHANGED
|
@@ -9,7 +9,7 @@ kind: "package-reference"
|
|
|
9
9
|
|
|
10
10
|
## 概述
|
|
11
11
|
|
|
12
|
-
`dsh-shell-env` 提供每次模型 shell 调用——bash 或 pwsh——所运行的受信 `DSH_*` 环境：内置事实如 `DSH_HOME`、`DSH_SHELL=1` 与 agent（智能体）的 `DSH_SESSION_ID
|
|
12
|
+
`dsh-shell-env` 提供每次模型 shell 调用——bash 或 pwsh——所运行的受信 `DSH_*` 环境：内置事实如 `DSH_HOME`、`DSH_SHELL=1` 与 agent（智能体）的 `DSH_SESSION_ID`。插件作者可以注册自己的事实，带声明键、按每次执行收集，并随插件释放；重复所有权或未声明的运行时键会明确报错，而不是静默覆盖。注册表不会改变模型看到的其他任何内容——shell 工具拥有各自的 schema 与提示词。任何挂载了模型 shell 工具的组合都适合选择它；配置只决定 Harness 主目录。
|
|
13
13
|
|
|
14
14
|
## 目录
|
|
15
15
|
|
|
@@ -64,7 +64,7 @@ contributor 必须声明它返回的每个键；返回未声明或非字符串
|
|
|
64
64
|
|
|
65
65
|
### 可能出什么问题
|
|
66
66
|
|
|
67
|
-
两个 contributor 声明同一个键，或 contributor 声称拥有保留内置键（`DSH_HOME`、`DSH_SHELL`、`DSH_SESSION_ID
|
|
67
|
+
两个 contributor 声明同一个键，或 contributor 声称拥有保留内置键（`DSH_HOME`、`DSH_SHELL`、`DSH_SESSION_ID`），都会导致插件加载时明确报错。`DSH_*` 键必须全大写并带下划线（例如 `DSH_REGION`），缺少描述也会让注册失败。
|
|
68
68
|
|
|
69
69
|
-----
|
|
70
70
|
|
|
@@ -79,7 +79,7 @@ contributor 必须声明它返回的每个键；返回未声明或非字符串
|
|
|
79
79
|
### 设计理念
|
|
80
80
|
|
|
81
81
|
- **受信命名空间，每次调用重建。** 环境是归 Harness 所有的 `DSH_*` 命名空间：shell 执行器丢弃继承的 `DSH_*` 值，并为每次执行合并注册表的当前快照，因此嵌套 harness 与并发的父子 agent 无法泄漏陈旧身份，`process.env` 也永不被修改。
|
|
82
|
-
-
|
|
82
|
+
- **声明所有权，冲突明确报错。** contributor 预先声明键，使重复所有权在第一条命令之前就被发现；resolver 只能返回已声明的键。
|
|
83
83
|
- **内置键留在这里。** `DSH_HOME`、`DSH_SHELL` 与 `DSH_SESSION_ID` 为注册表保留；contributor 不能声称拥有它们。
|
|
84
84
|
|
|
85
85
|
### 源码地图
|
|
@@ -87,7 +87,7 @@ contributor 必须声明它返回的每个键；返回未声明或非字符串
|
|
|
87
87
|
| 文件 | 职责 |
|
|
88
88
|
|---|---|
|
|
89
89
|
| [`src/index.ts`](src/index.ts) | 插件入口、`ShellEnvRegistry` 服务与内置事实 |
|
|
90
|
-
| — |
|
|
90
|
+
| — | 不发布运行时不变式伴生入口；环境注册表会在每次注册和收集时校验所有权与收集值，也不发布可供伴生入口交叉检查的独立快照。 |
|
|
91
91
|
|
|
92
92
|
### 收集
|
|
93
93
|
|
|
@@ -118,7 +118,7 @@ contributor 必须声明它返回的每个键；返回未声明或非字符串
|
|
|
118
118
|
|
|
119
119
|
#### KV Cache 影响
|
|
120
120
|
|
|
121
|
-
|
|
121
|
+
受管环境永远不会进入请求前缀，因此不会使提供方缓存复用失效；任何前缀变更都取决于 shell 工具定义与当前请求信封。
|
|
122
122
|
|
|
123
123
|
## 已知限制与延期工作
|
|
124
124
|
|
|
@@ -127,7 +127,7 @@ contributor 必须声明它返回的每个键；返回未声明或非字符串
|
|
|
127
127
|
|
|
128
128
|
这些限制说明注册表何时不合适或需要小心使用。它们是当前包约束，不是任务积压。
|
|
129
129
|
|
|
130
|
-
- **`list()` 只枚举插件贡献的变量**——注册表自有的内置键（`DSH_HOME`、`DSH_SHELL`、`DSH_SESSION_ID
|
|
130
|
+
- **`list()` 只枚举插件贡献的变量**——注册表自有的内置键（`DSH_HOME`、`DSH_SHELL`、`DSH_SESSION_ID`）不包含在内，因此诊断、提示词或 UI 代码不得把 `list()` 当作完整的环境目录。
|
|
131
131
|
|
|
132
132
|
<a id="dev-note"></a>
|
|
133
133
|
### 开发备注
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@deepseek-ai/dsh-shell-env",
|
|
3
3
|
"description": "Tool-independent managed DSH_* shell environment registry",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.6-alpha.1",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public"
|
|
7
7
|
},
|
|
@@ -27,20 +27,20 @@
|
|
|
27
27
|
],
|
|
28
28
|
"license": "MIT",
|
|
29
29
|
"peerDependencies": {
|
|
30
|
-
"@deepseek-ai/dsh-
|
|
31
|
-
"@deepseek-ai/
|
|
32
|
-
"@deepseek-ai/dsh-
|
|
33
|
-
"@deepseek-ai/
|
|
30
|
+
"@deepseek-ai/dsh-shell": "^0.1.6-alpha.1",
|
|
31
|
+
"@deepseek-ai/dsh-home-paths": "^0.1.6-alpha.1",
|
|
32
|
+
"@deepseek-ai/dsh-tools": "^0.1.6-alpha.1",
|
|
33
|
+
"@deepseek-ai/cordis": "^4.0.2"
|
|
34
34
|
},
|
|
35
35
|
"dependencies": {
|
|
36
36
|
"@deepseek-ai/schemastery": "^3.18.2"
|
|
37
37
|
},
|
|
38
38
|
"devDependencies": {
|
|
39
|
-
"@deepseek-ai/dsh-agent": "^0.1.
|
|
40
|
-
"@deepseek-ai/dsh-shell": "^0.1.
|
|
41
|
-
"@deepseek-ai/dsh-llm": "^0.1.
|
|
42
|
-
"@deepseek-ai/dsh-home-paths": "^0.1.
|
|
43
|
-
"@deepseek-ai/dsh-tools": "^0.1.
|
|
39
|
+
"@deepseek-ai/dsh-agent": "^0.1.6-alpha.1",
|
|
40
|
+
"@deepseek-ai/dsh-shell": "^0.1.6-alpha.1",
|
|
41
|
+
"@deepseek-ai/dsh-llm": "^0.1.6-alpha.1",
|
|
42
|
+
"@deepseek-ai/dsh-home-paths": "^0.1.6-alpha.1",
|
|
43
|
+
"@deepseek-ai/dsh-tools": "^0.1.6-alpha.1",
|
|
44
44
|
"@deepseek-ai/cordis": "^4.0.2"
|
|
45
45
|
}
|
|
46
46
|
}
|