@exagone313/dsh-podman 1.2.0 → 1.3.0

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.
Files changed (98) hide show
  1. package/dist/card-route.d.ts +8 -0
  2. package/dist/card-route.js +19 -8
  3. package/dist/client/ContainerCard.js +147 -110
  4. package/dist/client/card-protocol.d.ts +4 -0
  5. package/dist/client/card-protocol.js +34 -0
  6. package/dist/client/container-card-caches.d.ts +1 -1
  7. package/dist/client/container-card-caches.js +19 -17
  8. package/dist/client/container-card-config.d.ts +47 -0
  9. package/dist/client/container-card-config.js +160 -0
  10. package/dist/client/container-card-controller.d.ts +35 -3
  11. package/dist/client/container-card-controller.js +263 -41
  12. package/dist/client/container-card-create-modal.d.ts +5 -1
  13. package/dist/client/container-card-create-modal.js +111 -94
  14. package/dist/client/container-card-defaults.d.ts +16 -0
  15. package/dist/client/container-card-defaults.js +147 -0
  16. package/dist/client/container-card-dialog-styles.d.ts +7 -0
  17. package/dist/client/container-card-dialog-styles.js +70 -0
  18. package/dist/client/container-card-dialog.d.ts +12 -0
  19. package/dist/client/container-card-dialog.js +47 -0
  20. package/dist/client/container-card-directory-styles.d.ts +1 -1
  21. package/dist/client/container-card-directory-styles.js +5 -5
  22. package/dist/client/container-card-directory.js +8 -7
  23. package/dist/client/container-card-edit-modal.d.ts +39 -0
  24. package/dist/client/container-card-edit-modal.js +29 -0
  25. package/dist/client/container-card-editors.d.ts +5 -2
  26. package/dist/client/container-card-editors.js +109 -134
  27. package/dist/client/container-card-field-styles.d.ts +7 -0
  28. package/dist/client/container-card-field-styles.js +63 -0
  29. package/dist/client/container-card-form.d.ts +47 -0
  30. package/dist/client/container-card-form.js +61 -0
  31. package/dist/client/container-card-group.d.ts +9 -0
  32. package/dist/client/container-card-group.js +22 -0
  33. package/dist/client/container-card-images.d.ts +6 -2
  34. package/dist/client/container-card-images.js +63 -23
  35. package/dist/client/container-card-paths.js +43 -52
  36. package/dist/client/container-card-ports.d.ts +3 -4
  37. package/dist/client/container-card-ports.js +74 -38
  38. package/dist/client/container-card-resources.d.ts +38 -0
  39. package/dist/client/container-card-resources.js +73 -0
  40. package/dist/client/container-card-row.d.ts +11 -19
  41. package/dist/client/container-card-row.js +122 -122
  42. package/dist/client/container-card-secrets.d.ts +31 -3
  43. package/dist/client/container-card-secrets.js +174 -56
  44. package/dist/client/container-card-shared.d.ts +173 -6
  45. package/dist/client/container-card-shared.js +616 -57
  46. package/dist/client/container-card-status.d.ts +18 -0
  47. package/dist/client/container-card-status.js +166 -0
  48. package/dist/client/container-card-styles.d.ts +49 -7
  49. package/dist/client/container-card-styles.js +396 -40
  50. package/dist/client/container-card-table-styles.d.ts +15 -0
  51. package/dist/client/container-card-table-styles.js +237 -0
  52. package/dist/client/container-card-tabs-styles.d.ts +5 -0
  53. package/dist/client/container-card-tabs-styles.js +46 -0
  54. package/dist/client/container-card-toast.d.ts +5 -0
  55. package/dist/client/container-card-toast.js +10 -0
  56. package/dist/client/container-card-volumes.d.ts +1 -0
  57. package/dist/client/container-card-volumes.js +14 -19
  58. package/dist/client/container-card-workspace.d.ts +8 -12
  59. package/dist/client/container-card-workspace.js +76 -14
  60. package/dist/client/index.js +6488 -3474
  61. package/dist/client/locales.d.ts +10 -1
  62. package/dist/client/locales.js +268 -114
  63. package/dist/client/relative-time.d.ts +10 -0
  64. package/dist/client/relative-time.js +74 -0
  65. package/dist/client/slot-contract.d.ts +8 -0
  66. package/dist/client/tool-views.js +1 -1
  67. package/dist/container-env.js +1 -1
  68. package/dist/env-rows.d.ts +9 -11
  69. package/dist/env-rows.js +72 -40
  70. package/dist/generated/version.d.ts +2 -2
  71. package/dist/generated/version.js +2 -2
  72. package/dist/guest-terminal.js +1 -1
  73. package/dist/mount-enums.d.ts +11 -0
  74. package/dist/mount-enums.js +60 -0
  75. package/dist/subprocess.js +1 -1
  76. package/dist/terminal-sessions.js +2 -2
  77. package/dist/terminal-shells.js +1 -1
  78. package/dist/tool-handlers.js +1 -1
  79. package/dist/workspace-binding.js +2 -2
  80. package/docs/architecture.md +6 -4
  81. package/docs/architecture.zh.md +3 -1
  82. package/docs/configuration.md +28 -25
  83. package/docs/configuration.zh.md +15 -11
  84. package/docs/development-prompt.md +9 -7
  85. package/docs/development-prompt.zh.md +9 -7
  86. package/docs/development.md +25 -18
  87. package/docs/development.zh.md +22 -18
  88. package/docs/install-dsh-and-dsh-podman.md +15 -12
  89. package/docs/install-dsh-and-dsh-podman.zh.md +15 -9
  90. package/docs/uninstall.md +2 -0
  91. package/docs/uninstall.zh.md +2 -0
  92. package/docs/update.md +2 -0
  93. package/docs/update.zh.md +2 -0
  94. package/docs/usage.md +191 -39
  95. package/docs/usage.zh.md +150 -29
  96. package/package.json +8 -4
  97. package/dist/client/container-card-default-env.d.ts +0 -10
  98. package/dist/client/container-card-default-env.js +0 -69
@@ -6,6 +6,8 @@ SPDX-License-Identifier: MIT
6
6
 
7
7
  # Development container setup prompt
8
8
 
9
+ English | [中文](development-prompt.zh.md)
10
+
9
11
  This page carries the prompt that builds a development image, creates the
10
12
  toolchain volume and wires the workspace container to it, as described in
11
13
  [Development](development.md#development-container-toolchain). Nothing it needs
@@ -32,10 +34,10 @@ what is missing or different, keeping whatever is already configured. Use the
32
34
  container tools; never run `make` or edit files on the host.
33
35
 
34
36
  1. Image: build a custom image named `dsh-podman-tooling` from the `archlinux`
35
- base with packages `go`, `nodejs-lts-jod`, `npm`, `deno`, `reuse` and
36
- `python-chardet`, unless an image of that name already exists in this
37
- workspace. It is a local image, not a published one; leave an existing one
38
- alone.
37
+ base with packages `go`, `nodejs`, `npm`, `reuse` and
38
+ `python-chardet`. It is a local image, not a published one; leave an existing
39
+ one alone when it already carries exactly these packages, and rebuild it from
40
+ this list when it does not.
39
41
  2. Volume: create the workspace volume `dsh-podman-toolchain` unless it already
40
42
  exists.
41
43
  3. Container: inspect the default container's image, mounts, PATH additions and
@@ -51,13 +53,13 @@ container tools; never run `make` or edit files on the host.
51
53
  `GOMODCACHE=/opt/toolchain/gomodcache`, `GOPATH=/opt/toolchain/gopath`,
52
54
  `npm_config_cache=/opt/toolchain/npm-cache`,
53
55
  `npm_config_prefix=/opt/toolchain/npm-global`,
54
- `PNPM_HOME=/opt/toolchain/pnpm-home`,
55
- `DENO_DIR=/opt/toolchain/deno-dir` and
56
+ `PNPM_HOME=/opt/toolchain/pnpm-home` and
56
57
  `GOENV=/opt/toolchain/home/.config/go/env`, merged with the variables
57
58
  already on the container.
58
59
  4. pnpm: the volume, not the image, carries pnpm. If `pnpm --version` does not
59
60
  report the version `package.json` pins in `packageManager`, install it with
60
- `npm install -g pnpm@<that version>` and check again.
61
+ `npm install -g pnpm@<that version>` and check again. dprint, the formatter,
62
+ is a project devDependency and arrives with `pnpm install`.
61
63
  5. Git identity: do not write a `~/.gitconfig`. If no Git identity is
62
64
  configured, tell me to set it once on the Podman page (sidebar **Plugins**
63
65
  panel → **Installed** → **dsh-podman**): **Default
@@ -6,6 +6,8 @@ SPDX-License-Identifier: MIT
6
6
 
7
7
  # 开发容器设置提示词
8
8
 
9
+ [English](development-prompt.md) | 中文
10
+
9
11
  本页给出用于构建开发镜像、创建工具链卷并把工作区容器接好的提示词,参见[开发](development.zh.md#开发容器工具链)。其中没有任何东西是现成的。
10
12
 
11
13
  把下面的文本块粘贴到已接入该工作区的 dsh
@@ -29,10 +31,10 @@ what is missing or different, keeping whatever is already configured. Use the
29
31
  container tools; never run `make` or edit files on the host.
30
32
 
31
33
  1. Image: build a custom image named `dsh-podman-tooling` from the `archlinux`
32
- base with packages `go`, `nodejs-lts-jod`, `npm`, `deno`, `reuse` and
33
- `python-chardet`, unless an image of that name already exists in this
34
- workspace. It is a local image, not a published one; leave an existing one
35
- alone.
34
+ base with packages `go`, `nodejs`, `npm`, `reuse` and
35
+ `python-chardet`. It is a local image, not a published one; leave an existing
36
+ one alone when it already carries exactly these packages, and rebuild it from
37
+ this list when it does not.
36
38
  2. Volume: create the workspace volume `dsh-podman-toolchain` unless it already
37
39
  exists.
38
40
  3. Container: inspect the default container's image, mounts, PATH additions and
@@ -48,13 +50,13 @@ container tools; never run `make` or edit files on the host.
48
50
  `GOMODCACHE=/opt/toolchain/gomodcache`, `GOPATH=/opt/toolchain/gopath`,
49
51
  `npm_config_cache=/opt/toolchain/npm-cache`,
50
52
  `npm_config_prefix=/opt/toolchain/npm-global`,
51
- `PNPM_HOME=/opt/toolchain/pnpm-home`,
52
- `DENO_DIR=/opt/toolchain/deno-dir` and
53
+ `PNPM_HOME=/opt/toolchain/pnpm-home` and
53
54
  `GOENV=/opt/toolchain/home/.config/go/env`, merged with the variables
54
55
  already on the container.
55
56
  4. pnpm: the volume, not the image, carries pnpm. If `pnpm --version` does not
56
57
  report the version `package.json` pins in `packageManager`, install it with
57
- `npm install -g pnpm@<that version>` and check again.
58
+ `npm install -g pnpm@<that version>` and check again. dprint, the formatter,
59
+ is a project devDependency and arrives with `pnpm install`.
58
60
  5. Git identity: do not write a `~/.gitconfig`. If no Git identity is
59
61
  configured, tell me to set it once on the Podman page (sidebar **Plugins**
60
62
  panel → **Installed** → **dsh-podman**): **Default
@@ -6,6 +6,8 @@ SPDX-License-Identifier: MIT
6
6
 
7
7
  # Development
8
8
 
9
+ English | [中文](development.zh.md)
10
+
9
11
  This page is for **contributors** building the plugin from this repository.
10
12
 
11
13
  ## Repository layout
@@ -20,8 +22,8 @@ This page is for **contributors** building the plugin from this repository.
20
22
 
21
23
  ## Building
22
24
 
23
- Prerequisites: Go 1.27, Node ≥ 22, pnpm 12, Deno ≥ 2.9 (formatting), and (for
24
- the browser half) the `@deepseek-ai/dsh-client-*` packages published on npm.
25
+ Prerequisites: Go 1.27, Node ≥ 22, pnpm 12, and (for the browser half) the
26
+ `@deepseek-ai/dsh-client-*` packages published on npm.
25
27
 
26
28
  ```sh
27
29
  pnpm install
@@ -34,17 +36,20 @@ host C headers; `make` applies the same tags automatically.
34
36
  The `Makefile` wraps the common workflows:
35
37
 
36
38
  ```sh
37
- make build-go # build both Go binaries into bin/<os>-<arch>/
39
+ make build-go # build the Go binaries into bin/<os>-<arch>/
38
40
  make build # build-go + pnpm-build
39
41
  make vet # gofmt -s check + go vet with the build tags
42
+ make lint # vet + oxlint over the TypeScript sources
43
+ make lint-ts # oxlint only
40
44
  make test-go # go test with the build tags
41
45
  make test # test-go + pnpm test (JS tests, which run against dist/)
42
- make fmt # gofmt -s + deno fmt (TypeScript and Markdown)
46
+ make fmt # gofmt -s + dprint (TypeScript and Markdown)
43
47
  make fmt-check # verify the formatting without rewriting anything
44
48
  make proto # regenerate the protobuf Go bindings with buf
45
49
  make proto-check # buf lint + buf breaking + check the committed bindings are current
46
50
  make download-licenses # generate third-party-licenses.pkg from the project and third-party Go licenses
47
- make image # build the orchestrator, guest-agent and dsh container images
51
+ make image-go # build the Go container images (orchestrator, guest-agent, gateway)
52
+ make image # image-go + the dsh container image
48
53
  ```
49
54
 
50
55
  `make image` depends on `third-party-licenses.pkg`: the `download-licenses`
@@ -168,7 +173,7 @@ containers yourself:
168
173
  image**;
169
174
  - with `container_recreate`, for a named container or the default one.
170
175
 
171
- To rebuild a whole workspace instead, use **Remove pod** on its row (or
176
+ To rebuild a whole workspace instead, use **Remove containers** on its row (or
172
177
  `RemoveWorkspace`): the pod and all its containers are removed, and the next
173
178
  attach creates the pod and its default container again. Restarting the two
174
179
  services never touches workspace containers, and neither action removes volumes,
@@ -186,24 +191,26 @@ A workspace container's root filesystem is read-only and disposable, so the
186
191
  toolchain a contributor builds with needs a workspace volume. No development
187
192
  image is distributed: build a custom one — the
188
193
  [setup prompt](development-prompt.md) builds `dsh-podman-tooling` from the
189
- `archlinux` base with `go`, `nodejs-lts-jod`, `npm`, `deno`, `reuse` and
194
+ `archlinux` base with `go`, `nodejs` (Node 26), `npm`, `reuse` and
190
195
  `python-chardet` — and create a workspace volume for the state an image cannot
191
196
  keep: the Go and npm caches, `gopath` with the `go install`ed tools, and pnpm,
192
- which `package.json` pins to a version the Arch repositories do not carry.
197
+ which `package.json` pins to a version the Arch repositories do not carry
198
+ (dprint ships with the project's `pnpm install`).
193
199
 
194
200
  The prompt mounts that volume as `dsh-podman-toolchain` at `/opt/toolchain`
195
201
  (read-write) and points the container's caches at it, so commands work without
196
202
  sourcing anything:
197
203
 
198
- | Container setting | Value |
199
- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
200
- | PATH additions | `/opt/toolchain/gopath/bin`, `/opt/toolchain/npm-global/bin`, `/opt/toolchain/pnpm-home` |
201
- | Environment | `GOCACHE=/opt/toolchain/gocache`, `GOMODCACHE=/opt/toolchain/gomodcache`, `GOPATH=/opt/toolchain/gopath`, `npm_config_cache=/opt/toolchain/npm-cache`, `npm_config_prefix=/opt/toolchain/npm-global`, `PNPM_HOME=/opt/toolchain/pnpm-home`, `DENO_DIR=/opt/toolchain/deno-dir`, `GOENV=/opt/toolchain/home/.config/go/env` |
204
+ | Container setting | Value |
205
+ | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
206
+ | PATH additions | `/opt/toolchain/gopath/bin`, `/opt/toolchain/npm-global/bin`, `/opt/toolchain/pnpm-home` |
207
+ | Environment | `GOCACHE=/opt/toolchain/gocache`, `GOMODCACHE=/opt/toolchain/gomodcache`, `GOPATH=/opt/toolchain/gopath`, `npm_config_cache=/opt/toolchain/npm-cache`, `npm_config_prefix=/opt/toolchain/npm-global`, `PNPM_HOME=/opt/toolchain/pnpm-home`, `GOENV=/opt/toolchain/home/.config/go/env` |
202
208
 
203
209
  Set the commit identity once on the Podman page (sidebar **Plugins** panel →
204
210
  **Installed** → **dsh-podman**) under
205
- [Default environment](configuration.md#default-environment) → **Git identity**,
206
- so containers get `GIT_AUTHOR_*`/`GIT_COMMITTER_*` without a `~/.gitconfig`.
211
+ [Default environment variables](configuration.md#default-environment-variables)
212
+ → **Git identity**, so containers get `GIT_AUTHOR_*`/`GIT_COMMITTER_*` without a
213
+ `~/.gitconfig`.
207
214
 
208
215
  The prompt applies all of this from inside dsh and can be pasted again to repair
209
216
  a workspace. Podman stores managed volumes with `DSH_PODMAN_VOLUME_PREFIX`
@@ -248,16 +255,16 @@ image) exactly, upgrading or downgrading the profile's copy to match.
248
255
 
249
256
  CI runs on every **branch** push and pull request, split across
250
257
  `.github/workflows/ci-common.yml` (REUSE lint and zizmor), `ci-code.yml` (Go,
251
- JS, images, Trivy), `ci-docs.yml` (Deno fmt) and `ci-dsh-image.yml`. A **tag**
258
+ JS, images, Trivy), `ci-docs.yml` (dprint) and `ci-dsh-image.yml`. A **tag**
252
259
  push runs only `release.yml`, which repeats the build, vet and tests itself:
253
260
 
254
261
  - **actions-lint** — zizmor scans the workflows for insecure practices.
255
262
  - **reuse** — REUSE license compliance.
256
263
  - **go** — build, `gofmt -s` check, vet, tests, and govulncheck (Go
257
264
  vulnerabilities). Unfixed findings don't fail the job; fixable ones do.
258
- - **js** — TypeScript formatting check, install, typecheck, build, tests, and
259
- `pnpm audit`.
260
- - **docs** — Markdown formatting check (`deno fmt` via `make fmt-check-md`).
265
+ - **js** — install, TypeScript formatting check, lint, typecheck, build, tests,
266
+ and `pnpm audit`.
267
+ - **docs** — Markdown formatting check (`dprint` via `make fmt-check-md`).
261
268
  - **images** — builds the orchestrator and guest-agent images (runs only after
262
269
  the test jobs pass); **dsh image** builds `Containerfile.dsh`.
263
270
  - **trivy** — filesystem vulnerability scan (unfixed ignored) and container
@@ -6,6 +6,8 @@ SPDX-License-Identifier: MIT
6
6
 
7
7
  # 开发
8
8
 
9
+ [English](development.md) | 中文
10
+
9
11
  本页面向从本仓库构建插件的**贡献者**。
10
12
 
11
13
  ## 仓库结构
@@ -19,8 +21,7 @@ SPDX-License-Identifier: MIT
19
21
 
20
22
  ## 构建
21
23
 
22
- 前置要求:Go 1.27、Node ≥ 22、pnpm 12、Deno ≥
23
- 2.9(用于格式化),以及(浏览器端所需的)发布在 npm 上的
24
+ 前置要求:Go 1.27、Node ≥ 22、pnpm 12,以及(浏览器端所需的)发布在 npm 上的
24
25
  `@deepseek-ai/dsh-client-*` 包。
25
26
 
26
27
  ```sh
@@ -34,17 +35,20 @@ Go 构建标签会跳过 btrfs 和 devicemapper 存储驱动,它们需要宿
34
35
  `Makefile` 封装了常见的工作流:
35
36
 
36
37
  ```sh
37
- make build-go # build both Go binaries into bin/<os>-<arch>/
38
+ make build-go # build the Go binaries into bin/<os>-<arch>/
38
39
  make build # build-go + pnpm-build
39
40
  make vet # gofmt -s check + go vet with the build tags
41
+ make lint # vet + oxlint over the TypeScript sources
42
+ make lint-ts # oxlint only
40
43
  make test-go # go test with the build tags
41
44
  make test # test-go + pnpm test (JS tests, which run against dist/)
42
- make fmt # gofmt -s + deno fmt (TypeScript and Markdown)
45
+ make fmt # gofmt -s + dprint (TypeScript and Markdown)
43
46
  make fmt-check # verify the formatting without rewriting anything
44
47
  make proto # regenerate the protobuf Go bindings with buf
45
48
  make proto-check # buf lint + buf breaking + check the committed bindings are current
46
49
  make download-licenses # generate third-party-licenses.pkg from the project and third-party Go licenses
47
- make image # build the orchestrator, guest-agent and dsh container images
50
+ make image-go # build the Go container images (orchestrator, guest-agent, gateway)
51
+ make image # image-go + the dsh container image
48
52
  ```
49
53
 
50
54
  `make image` 依赖 `third-party-licenses.pkg`:`download-licenses` 目标会运行
@@ -159,7 +163,7 @@ guest agent 之后,请自行重建容器:
159
163
  image**;
160
164
  - 或使用 `container_recreate`,作用于命名容器或默认容器。
161
165
 
162
- 若要重建整个工作区,可在其行上使用 **Remove pod**(或 `RemoveWorkspace`):pod
166
+ 若要重建整个工作区,可在其行上使用 **移除容器**(或 `RemoveWorkspace`):pod
163
167
  及其所有容器都会被移除,下次接入时会重新创建 pod
164
168
  与默认容器。重启这两个服务绝不会触及工作区容器,上述两种操作也都不会删除卷、机密或项目数据。
165
169
 
@@ -171,20 +175,19 @@ guest agent 之后,请自行重建容器:
171
175
  ### 开发容器工具链
172
176
 
173
177
  工作区容器的根文件系统是只读且一次性的,因此贡献者构建所用的工具链需要工作区的一个卷。项目并不分发开发镜像:请自行构建一个自定义镜像——[设置提示词](development-prompt.zh.md)
174
- 会以 `archlinux` 为父镜像构建 `dsh-podman-tooling`,包含
175
- `go`、`nodejs-lts-jod`、`npm`、`deno`、`reuse` 和
176
- `python-chardet`——并为镜像无法保存的状态创建工作区卷:Go 与 npm 缓存、含
177
- `go install` 工具的 `gopath`, 以及 `package.json` 固定版本、Arch 仓库没有的
178
- pnpm。
178
+ 会以 `archlinux` 为父镜像构建 `dsh-podman-tooling`,包含 `go`、`nodejs`(Node
179
+ 26)、`npm`、`reuse` 和 `python-chardet`——并为镜像无法保存的状态创建工作区卷:Go
180
+ 与 npm 缓存、含 `go install` 工具的 `gopath`, 以及 `package.json`
181
+ 固定版本、Arch 仓库没有的 pnpm(dprint 随项目的 `pnpm install` 一并安装)。
179
182
 
180
183
  提示词会把该卷以 `dsh-podman-toolchain` 挂载到
181
184
  `/opt/toolchain`(读写),并让容器的缓存都指向它,因此无需 source
182
185
  任何脚本即可使用:
183
186
 
184
- | 容器设置 | 值 |
185
- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
186
- | PATH 追加项 | `/opt/toolchain/gopath/bin`、`/opt/toolchain/npm-global/bin`、`/opt/toolchain/pnpm-home` |
187
- | 环境变量 | `GOCACHE=/opt/toolchain/gocache`、`GOMODCACHE=/opt/toolchain/gomodcache`、`GOPATH=/opt/toolchain/gopath`、`npm_config_cache=/opt/toolchain/npm-cache`、`npm_config_prefix=/opt/toolchain/npm-global`、`PNPM_HOME=/opt/toolchain/pnpm-home`、`DENO_DIR=/opt/toolchain/deno-dir`、`GOENV=/opt/toolchain/home/.config/go/env` |
187
+ | 容器设置 | 值 |
188
+ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
189
+ | PATH 追加项 | `/opt/toolchain/gopath/bin`、`/opt/toolchain/npm-global/bin`、`/opt/toolchain/pnpm-home` |
190
+ | 环境变量 | `GOCACHE=/opt/toolchain/gocache`、`GOMODCACHE=/opt/toolchain/gomodcache`、`GOPATH=/opt/toolchain/gopath`、`npm_config_cache=/opt/toolchain/npm-cache`、`npm_config_prefix=/opt/toolchain/npm-global`、`PNPM_HOME=/opt/toolchain/pnpm-home`、`GOENV=/opt/toolchain/home/.config/go/env` |
188
191
 
189
192
  在 Podman 页面(侧边栏 **插件** 面板 → **已安装** →
190
193
  **dsh-podman**)的[默认环境变量](configuration.zh.md#默认环境变量) → **Git
@@ -231,7 +234,7 @@ Environment=DSH_PODMAN_PLUGIN_SOURCE=/mnt/dsh-podman.tgz
231
234
 
232
235
  CI 在每次**分支**推送和拉取请求时运行,分散在
233
236
  `.github/workflows/ci-common.yml`(REUSE lint 与
234
- zizmor)、`ci-code.yml`(Go、JS、镜像、Trivy)、`ci-docs.yml`(Deno fmt)和
237
+ zizmor)、`ci-code.yml`(Go、JS、镜像、Trivy)、`ci-docs.yml`(dprint)和
235
238
  `ci-dsh-image.yml` 中。推送**标签**时只运行 `release.yml`,它自身会重复构建、vet
236
239
  和测试:
237
240
 
@@ -239,8 +242,9 @@ zizmor)、`ci-code.yml`(Go、JS、镜像、Trivy)、`ci-docs.yml`(Deno f
239
242
  - **reuse** — REUSE 许可证合规检查。
240
243
  - **go** — 构建、`gofmt -s` 检查、vet、测试和 govulncheck(Go 漏洞)。未修复的
241
244
  发现不会导致任务失败;可修复的会导致失败。
242
- - **js** — TypeScript 格式检查、安装、类型检查、构建、测试和 `pnpm audit`。
243
- - **docs** — Markdown 格式检查(通过 `make fmt-check-md` 运行 `deno fmt`)。
245
+ - **js** — 安装、TypeScript 格式检查、lint、类型检查、构建、测试和
246
+ `pnpm audit`。
247
+ - **docs** — Markdown 格式检查(通过 `make fmt-check-md` 运行 `dprint`)。
244
248
  - **images** — 构建 orchestrator 和 guest-agent
245
249
  镜像(仅在测试任务通过后运行);**dsh image** 构建 `Containerfile.dsh`。
246
250
  - **trivy** — 文件系统漏洞扫描(未修复的被忽略)和容器 错误配置扫描(DS-0002
@@ -6,6 +6,8 @@ SPDX-License-Identifier: MIT
6
6
 
7
7
  # Install DeepSeek Harness & dsh-podman with rootless Podman
8
8
 
9
+ English | [中文](install-dsh-and-dsh-podman.zh.md)
10
+
9
11
  ## Goals
10
12
 
11
13
  The goal of this guide is to install:
@@ -152,21 +154,22 @@ which requires online access.
152
154
 
153
155
  ## Verification
154
156
 
155
- - Open the sidebar's **Plugins** panel → **Installed** → **dsh-podman**: the
156
- page should list the base images and, for a workspace, offer to create its
157
- default container.
158
- - In a dsh session, run a shell command. It should execute inside a Podman
159
- container for the current workspace (the plugin auto-creates the workspace's
160
- default container on first use).
157
+ 1. Open the sidebar's **Plugins** panel.
158
+ 2. In the **Installed** section, click on **dsh-podman**.
159
+ 3. Open the **Status** tab.
160
+ 4. Check that **dsh-podman**, **dsh-podman-orchestrator** and
161
+ **dsh-podman-gateway** are **ready** and the versions match.
161
162
 
162
163
  ## Set Git identity (recommended)
163
164
 
164
- - Open settings from the sidebar's **Plugins** panel → **Installed** →
165
- **dsh-podman**
166
- - Scroll down to **Default environment**
167
- - Click on **Git identity**
168
- - Enter the name and email to use for Git and click on **Apply**
169
- - Click on **Apply default environment variables** and then **Confirm**
165
+ 1. Open the sidebar's **Plugins** panel.
166
+ 2. In the **Installed** section, click on **dsh-podman**.
167
+ 3. Open the **Defaults** tab.
168
+ 4. Next to **Default environment variables**, click on **Git identity**.
169
+ 5. Enter the name, the email and click on **Apply**.
170
+ 6. Click on **Save**.
171
+ 7. Click on **Add missing variables to containers**.
172
+ 8. Choose **All containers** and click on **Apply**.
170
173
 
171
174
  ## Updating dsh & dsh-podman
172
175
 
@@ -6,6 +6,8 @@ SPDX-License-Identifier: MIT
6
6
 
7
7
  # 使用 rootless Podman 安装 DeepSeek Harness 与 dsh-podman
8
8
 
9
+ [English](install-dsh-and-dsh-podman.md) | 中文
10
+
9
11
  ## 目标
10
12
 
11
13
  本指南的目标是安装:
@@ -132,18 +134,22 @@ SPDX-License-Identifier: MIT
132
134
 
133
135
  ## 验证
134
136
 
135
- - 打开侧边栏的 **插件** 面板 → **已安装** →
136
- **dsh-podman**:页面应列出基础镜像,并针对工作区提供创建其默认容器的选项。
137
- - 在 dsh 会话中运行一条 shell 命令。它应在当前工作区的 Podman
138
- 容器内执行(插件会在首次使用时自动创建工作区的默认容器)。
137
+ 1. 打开侧边栏的 **插件** 面板。
138
+ 2. 在 **已安装** 部分中,点击 **dsh-podman**。
139
+ 3. 打开 **状态** 标签页。
140
+ 4. 检查 **dsh-podman**、**dsh-podman-orchestrator** 和 **dsh-podman-gateway**
141
+ 是否**就绪**且版本一致。
139
142
 
140
143
  ## 配置 Git 身份(推荐)
141
144
 
142
- - 打开侧边栏的 **插件** 面板 → **已安装** → **dsh-podman**
143
- - 向下滚动到 **默认环境**
144
- - 点击 **Git 身份**
145
- - 输入用于 Git 的名称和邮箱,然后点击 **应用**
146
- - 点击 **应用默认环境变量**,然后点击 **确认**
145
+ 1. 打开侧边栏的 **插件** 面板。
146
+ 2. 在 **已安装** 部分中,点击 **dsh-podman**。
147
+ 3. 打开 **默认设置** 标签页。
148
+ 4. 在 **默认环境变量** 旁边,点击 **Git 身份**。
149
+ 5. 输入姓名和邮箱,然后点击 **应用**。
150
+ 6. 点击 **保存**。
151
+ 7. 点击 **为容器补上缺失的变量**。
152
+ 8. 选择 **所有容器**,然后点击 **应用**。
147
153
 
148
154
  ## 更新 dsh 与 dsh-podman
149
155
 
package/docs/uninstall.md CHANGED
@@ -6,6 +6,8 @@ SPDX-License-Identifier: MIT
6
6
 
7
7
  # Uninstall
8
8
 
9
+ English | [中文](uninstall.zh.md)
10
+
9
11
  This page undoes the [installation guide](install-dsh-and-dsh-podman.md): it
10
12
  assumes dsh runs from the dsh-podman image with the orchestrator and the
11
13
  gateway, all started from Quadlet units.
@@ -6,6 +6,8 @@ SPDX-License-Identifier: MIT
6
6
 
7
7
  # 卸载
8
8
 
9
+ [English](uninstall.md) | 中文
10
+
9
11
  本页用于撤销[安装指南](install-dsh-and-dsh-podman.zh.md)中的操作:其中假设 dsh
10
12
  运行在 dsh-podman 镜像中,并与编排器和 gateway 一同由 Quadlet 单元启动。
11
13
 
package/docs/update.md CHANGED
@@ -6,6 +6,8 @@ SPDX-License-Identifier: MIT
6
6
 
7
7
  # Update
8
8
 
9
+ English | [中文](update.zh.md)
10
+
9
11
  You should run updates only when no agents are running.
10
12
 
11
13
  Existing guest containers will be recreated afterwards, so running processes and
package/docs/update.zh.md CHANGED
@@ -6,6 +6,8 @@ SPDX-License-Identifier: MIT
6
6
 
7
7
  # 更新
8
8
 
9
+ [English](update.md) | 中文
10
+
9
11
  只应在没有 agent 运行时进行更新。
10
12
 
11
13
  现有的 guest 容器随后会被重建,因此运行中的进程和守护进程会被终止。