环境管理器 zhiwuli0228/dsh-env-manager

DSH Environment Manager

一个 DSH（DeepSeek Harness） 插件，让每个会话都能共享一份可查询的视图，涵盖企业环境、服务、部署，以及操作与 Skill 的绑定关系。

支持 DSH Web 和 Desktop。

中文简介：这是一个 DSH 插件，让每个会话都能按需读取企业运行环境、服务目录、部署实例、分层规则以及操作与 Skill 的绑定关系。

功能

- 环境注册表 —— 主机、集群、逻辑角色、访问端点、主机账号和登录审计记录，统一存为一条记录。
- 服务目录 —— Git URL、默认分支、构建工具、产物和规则配置档引用。
- 部署绑定 —— 哪个服务跑在哪里，以 native、docker 或 kubernetes 形式运行，并带实例级变量。
- 规则解析器 —— 分层、字段级覆盖，来源完整可追溯：每个值都能说明它从哪来、受什么影响。
- 操作 Skill 路由 —— 把一项操作（deploy、redeploy、collect-logs、……）映射到唯一一个绑定的 Skill，检测冲突并执行审批策略。
- 会话上下文 —— 每个会话有默认环境，绝不泄漏到其他会话。
- 发现技能 —— 一个配置档级的 dsh-env-manager Skill 向插件注册，让同一配置档下任意工作区都能发现注册表；只有被调用时才加载完整工作流。
- 记忆桥 —— 一份契约，把限定范围、已脱敏的操作记录送入 DSH 记忆插件（P1）。

状态

环境/平面模型的 Phase 1 和 K8s 节点/执行模型的 Phase 1.1 已实现，并安装在 desktop 配置档中。

- 50 个 Vitest 测试通过；npm run build 输出 lib/。
- 十个 env_ 工具、同源 /env-manager/api 路由和侧边栏/主面板均已实现。
- 一个环境就是一张完整网络、一个配置页面。管理、业务、数据库、扩展是同一份 hosts[] 上的角色视图；一台节点承担两个平面，就是一台主机带两个角色。
- 环境详情页拆成概览、全部节点、每个平面一个标签页、登录记录、Kubernetes/集群、端点和 YAML。平面标签页过滤的是同一份节点集合。
- New environment 只创建环境外壳，并预置四个标准角色。节点在环境内部添加，可单个添加，也可批量导入。
- 添加/编辑节点支持多个角色、机器类型（vm、physical、K8s all-in-one、K8s worker、Pod host）、命令访问方式（ssh、kubectl、docker）和可选的登录凭据。K8s 类型引用一个集群；Pod host 是用 docker exec 连到的那台机器，不是每个 Pod 一条记录。批量导入（IP,name,roles,port,user）创建通用 VM 节点，绝不接受密码。节点搜索覆盖 id、名称、IP、平台、管理员用户、角色、类型、访问方式、集群、账号用户名和 Web 登录 URL。
- 账号可以带 Web 登录 URL 和用户名，用于管理控制台或业务控制台。
Add web login 会打开账户表单，协议为 web；Edit account 可以修改 URL，或轮换密码。密码写入 DSH 凭据服务，绝不写入 YAML。
- Kubernetes/clusters 标签页用于创建和编辑集群元数据（kind、topology、API endpoint、namespaces、credential reference），并从 clusterRef 推导节点数量。
- 密码写入 DSH 凭据服务；YAML 只保留 env-manager/<environmentId>/<hostId>-<username>。
- 环境 (Environments) 是默认标签页，常驻页头的 新增环境 操作在每个标签页都能用。记录 (Records) 只包含服务、部署、规则配置档和操作绑定。
- 待办：数据库主从/分片拓扑（Phase 2）、节点/账户/登录的行级删除、浅色主题视觉走查，以及 V4 和 V6 的实时审批/凭据探测。
- 不执行操作：路由只返回绑定的技能和策略，不运行它。

智能体如何发现注册表

插件随同一个包附带一个 发现技能，名为 dsh-env-manager。它不是单独的 SKILL.md，也不单独安装。

工作方式：

1. apply() 从插件的非作用域上下文调用 ctx.skills.register() 注册技能。DSH 把它归入当前配置档的全局技能层。
2. 技能目录只携带名称、描述和 whenToUse。这条描述就是 主动提及，让新工作区能发现注册表。
3. 只有模型或用户调用技能时，才加载完整的工作流正文。正文告诉智能体先使用 env_list / env_find，再使用 env_set_context、env_resolve 和 env_resolve_operation。
4. 插件 不 注入全局系统提示词段落。无关的编码会话不会收到环境管理器指令。
5. 注册在插件 effect 内创建，因此禁用或卸载插件也会移除技能。
6. 插件配置中的 registerSkill: false 会隐藏该条目，但不影响工具或面板。

作用域与限制：

- 同一 DSH 配置档： 每个工作区（包括新建的空工作区）都能在目录中看到技能；不需要工作区的 AGENTS.md。这一点已从空的临时工作区验证。
- 不同配置档或机器： 技能不共享；需在那里安装该包。
- 技能负责 发现，不负责执行。它不部署、不重启、不收集日志。这些操作仍需要指向执行技能的 operationBinding。
- 目录条目是触发入口，不是硬性保证。关键操作仍必须在执行技能或工具层强制执行。
- 技能由插件注册，因此内容随插件版本化；没有工作区副本会漂移。

插件自身的工具仍独立于该技能注册。技能只是让注册表可被发现，并说明预期的工作流。

中文：dsh-env-manager 随插件一起注册，不单独安装；同一 DSH profile 下的所有工作区都能在 Skill 目录看到它，正文按需加载；不注入全局系统提示。它只负责发现和指导，不执行部署/重启；真正的执行仍由 operationBinding 指向的执行 Skill 完成。

添加环境

1. 打开 环境管理器（Environment Manager），默认停在 环境（Environments） 标签页。
2. 在面板标题栏点 新增环境（New environment）。其他标签页也能触发同一操作。
3. 填写环境名称、可选 id、类别和描述。四个标准平面会自动创建。点 创建环境（Create environment）。
4. 打开新环境。用 全部节点（All nodes）或某个平面标签页，再点 添加节点（Add node）。一个节点可以承担多个角色。
5. 要批量登记节点，用 批量导入（Batch import）：每行 IP,name,roles,port,user，角色之间用 | 或 / 分隔。批量导入只创建通用 VM 节点和可选账号，不写密码。
6. 对 Kubernetes 或承载 Pod 的机器，先打开 K8s / 集群（Kubernetes / clusters）添加集群。然后在 添加节点（Add node）里选择节点类型、集群和命令访问方式。控制平面与工作节点共用一台机器时选 K8s 合设；通过 docker exec 操作的机器选 Pod 宿主机。Pod 本身不作为节点添加。
7. 对管理台或业务 Web 控制台，打开对应平面标签页，找到承载它的节点，在节点卡片上点 添加 Web 登录（Add web login）。填入 Web 登录 URL、用户名和（可选）密码。URL 存在账号上，密码写入 DSH 凭据服务，之后可用 编辑账号（Edit account）更新账号。

在节点或账号表单里输入的密码只发送一次到 Host，由 DSH 凭据服务保存。它不会出现在注册表 YAML、工具输出或日志里。只有需要粘贴高级 YAML 模板时，才用 新建记录。

设计参考：

- docs/01-architecture/design.md — 范围、算法、验收标准；
- docs/01-architecture/decisions/ADR-0010-environment-plane-model.md —为什么一个网络就是一个环境，平面只是角色视图；
- docs/01-architecture/decisions/ADR-0011-k8s-node-execution-model.md —为什么 K8s/Pod 宿主机是带命令入口的机器，而不是新平面；
- docs/01-architecture/detailed-design.md —模块契约、存储、工具、HTTP；
- docs/01-architecture/implementation-plan.md —任务顺序与 cut line；
- docs/01-architecture/api-verification.md —运行时事实与待验证项。

安装

npm 包名是 dsh-env-manager-plugin（npm 上的 dsh-env-manager 已被另一个无关的包占用）。请把它作为配置档 bundle 安装，不要用 npm install -g 安装。

从 npm 安装

dsh-env-manager-plugin@0.1.0 是首个发布版本。

dsh plugin --profile <name> add dsh-env-manager-plugin@0.1.0

从本地检出安装

使用 Harness 的 plugin_manager 工具：

action: install_bundle
target: <absolute path to this repository>

如果 bundle 之前已经安装过，请重启 DSH。

bundle 自带 dsh-env-manager 发现技能，不需要单独安装技能。如果只想隐藏技能目录条目，把 config.registerSkill 设为 false，工具和面板照常保留：

config:
registerSkill: false

要移除整个插件，调用 plugin_manager，传入 action: remove_bundle 和 target: dsh-env-manager-plugin。

注册表数据在首次运行时创建，位于解析后的 dataDir 下，不属于仓库内容。

项目结构

dsh-env-manager/
├── index.js # Host entry shim over lib/index.js
├── client.js # Web/Desktop client module
├── cordis.patch.yml # Cordis bundle patch
├── package.json # Bundle manifest
├── tsconfig.json # Host build config (V1)
├── .github/workflows/ # GitHub Actions release pipeline
├── src/ # TypeScript Host sources (V1)
│ └── skill.ts # bundled profile-wide discovery Skill
├── lib/ # Build output (git-ignored)
├── locale/ # en.json, zh.json
├── icon.svg
├── docs/ # Design, harness and operations docs
└── tests/ # Vitest tests (V1)

文档

从 docs/README.md 开始看。

主要文档：

| 文档 | 内容 |
| docs/00-project/project-brief.md | 定位与 V1 范围 |
| docs/01-architecture/design.md | 设计、算法、验收标准 |
| docs/01-architecture/detailed-design.md | 模块契约、工具、HTTP 传输 |
| docs/01-architecture/data-model.md | 记录 schema |
| docs/01-architecture/tool-contract.md | 面向模型的工具接口 |
| docs/01-architecture/ui-design.md | 面板设计与手动 QA |
| docs/01-architecture/implementation-plan.md | 实现顺序 |
| docs/01-architecture/security-model.md | 凭据与策略控制 |
| docs/06-operations/release.md | npm Trusted Publisher 与 GitHub Release 流水线 |

发布

v0.1.0 已发布到 npm 以及 GitHub Releases。
0.1.0 版本是手动引导发布的，目的是让包名先存在；之后的 tag 由工作流通过 npm Trusted Publisher（OIDC）发布。

推送带注释的 v tag 会触发 .github/workflows/release.yml：它校验 tag 与 package.json 是否一致，运行 npm run check，打包 npm tarball，用 npm Trusted Publisher（OIDC）发布，并创建 GitHub Release 附上 tarball。
如果 npm 版本已存在，工作流会跳过发布，但仍创建 Release，所以发布只完成一半时，可以重新触发同一个 tag 来恢复。

git tag -a v0.1.0 -m "v0.1.0"
git push origin v0.1.0

首次发布必须手动引导，让 npm 包先存在；之后再把 zhiwuli0228/dsh-env-manager + release.yml 绑定为 Trusted Publisher。完整步骤、权限和失败情形见 docs/06-operations/release.md。

开发

npm install
npm run build
npm test
npm run check

npm run check 会跑类型检查、构建、Vitest 测试套件和 node --check client.js。

见 docs/04-development/development-guide.md。

许可

MIT