Skip to content

semi2-dsh

Verified

@fa-software/semi2-dsh · v0.0.19 · MIT · Web UI

Semi2 单插件:semi2-hub 配置引导 + 公共 Web 能力。

Install

dsh plugin add @fa-software/semi2-dsh

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Creators

Readme

@fa-software/semi2-dsh

跑在 DeepSeek Harness(dsh)之上的单插件,两个运行端共用。它从 semi2-hub 领取用户级配置 (身份、模型目录与密钥、技能目录、自画像、已登记工作区命中的项目绑定),把结果落成 dsh 的设置 命名空间与服务,并注册设置页用的登录 / 登出 / 健康路由。

Redmine 走另一条路:地址与密钥都来自 hub,插件按 hub 下发的 runtimeRedmine 在运行期用官方 @deepseek-ai/dsh-mcp-client 起 redmine-mcp-server(mcp__redmine__*,只读)。未配置即不挂, 配置变化先卸旧光纤再挂新的,登出时卸载。

Config

每个字段都在 patch 行不写 config 时取默认值,消费方 overlay 才覆盖。

字段 默认值 说明
contractTimeoutMs 5000 等运行端契约 semi2Runtime 出现的上限;超时按宿主直跑处理
domainAttachTimeoutMs 2000 等领域装配的上限;超时的领域记「本端不提供该能力」
settingsTimeoutMs 5000 等 settings 服务的上限;本端无该服务时不阻塞启动
namespaceWaitMs 2000 等命名空间注册完成再做的盘上清理写入上限
writeTimeoutMs 3000 单次覆盖应用 / 写盘的上限:到点只让调用方降级,那一笔仍留在队列里落定
credentialRetryTries 10 凭据存储首次读盘的重试次数
credentialRetryIntervalMs 150 凭据重试间隔(ms)
webFenceTimeoutMs 5000 webServer 在而校验接口迟迟不出现时补一条诊断日志的上限

状态与工作区映射都不落盘:状态由 GET /semi2/status 按请求现算(浏览器半边拉取),工作区映射只在进程内, 启动时按 dsh 工作区基线重新登记。本端无网页服务(NPC 一次性容器)时不注册状态路由。 设置写入只剩带着自铸名字的路由与密钥引用的维护。

提供的服务与事件

apply 第一句同步 provide 四个能力(NPC 端按 semi2Config 等配置 settle 后才起会话):

服务 读取接口 缺省语义
semi2Config state / ready / platform / selectHeadlessModel 配置未就绪 state.status != 'ready'
semi2Session login / logout 部署目录给了凭据时登录以 CREDENTIAL_SOURCE_READONLY 拒绝
semi2Health snapshot() 每项 ok / degraded / unavailable / failed
semi2Audit report(event) 未连接时返回 ok:false + MISSING_ACCESS_TOKEN

事件:semi2/config-updated(状态每次发布)、semi2/workspaces-updated(工作区映射变化)。

用到的官方 seam

settings、systemPrompt、webServer(register)、workspaceController(follow)、 agentDefaultModel、credentials、connection(Host/Origin 校验 + 浏览器鉴权)。 形状直接取自官方类型的 Pick / Partial<Pick<…>>,只在本插件刻意消费更松形状的地方写结构类型。

提示词段位置不写魔数:SEMI2_SECTION_ORDERS(persona + 1/2/3/4)与 semi2SectionOrder 从 getSectionOrder('DEPLOYMENT_PERSONA_PREFIX') 推导,老宿主没有该方法时回落偏移值。

降级口径与已知边界

  • 任何解析 / 注入 / 领取失败只 warn,绝不 reject 或阻断会话;单块失败只降级该块。
  • 三个能力之外的领域按自身依赖自门禁:缺 skills / systemPrompt 的宿主上领域光纤停在等待, 编排层记为「本端不提供该能力」,插件整体照常加载。
  • Redmine 领域挂载 MCP 服务:REDMINE_MCP_READ_ONLY=true 保证只读;runtimeRedmine 读取失败时 保持现状(不动已挂服务),两项任缺即卸载;挂载 / 就绪失败只 warn 并把健康项记为 degraded。 缺 redmine-mcp-server(PATH)或 @deepseek-ai/dsh-mcp-client(闭包)都只影响这一项, 可用 SEMI2_REDMINE_MCP_BIN 指到别处的可执行文件。
  • 每次会话由 service/sessions.ts 旁听 dsh 的 session/created / session/disposed 各回一条;进程被 SIGKILL / 容器停止没有销毁行(控制台显示「无结束行」),子 agent 会话不上报。
  • personaPrefix 无法运行时改:dsh-system-prompt 不注册 settings 命名空间,那份配置只来自组合文件。