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 命名空间,那份配置只来自组合文件。