本地决策闸门 PerryLink/dsh-phocinae

English · · Español · Português · हिन्दी

dsh-phocinae

DeepSeek Harness 的本地非生成式决策层。 一个 150M 参数的模型，一次前向传播就能回答是/否题、选择题和 2–10 分评分题；另有一道 fail-closed 闸门，在工具调用执行前先做筛查。

- 跑在你自己的机器上；不用云 API，不用 API key。
- phocinae_ask 做带类型的批量决策；phocinae_gate 判断单条命令或动作。
- 闸门挂在 tools/pre-execute 上：服务连不上 → 问人，绝不悄悄放行。
- 模型不写文章，也不写代码。它只做一次结构化决策。

快速开始

pip install phocinae-server
huggingface-cli download Phocinae/Phocinae-Largha-150M-v1 --local-dir ./model
PHOC_MODEL_DIR=./model python -m phocinae.main
dsh plugin --profile web add dsh-phocinae@0.2.5
curl http://127.0.0.1:8155/health

{"status":"ok","model_loaded":true} 表示服务已就绪。请锁定 dsh-phocinae@0.2.5：直接写 add dsh-phocinae 可能解析到旧版本，因为 pnpm 的 minimumReleaseAge 闸门会压住刚发布的版本。

你能得到什么

| 入口 | 作用 |
| phocinae_ask | 针对同一份状态跑最多 64 道带类型的题；返回答案、校准后的置信度和一个建议性的 escalate 标志。 |
| phocinae_gate | 把单条命令或动作判为 allow、ask 或 deny；只检查，不执行。 |
| tools/pre-execute 闸门 | 执行前筛查每一条匹配 gate.tools 的工具调用；fail-closed。 |
| phocinae 技能 | 告诉模型什么时候该用本地决策，以及怎么读 escalate。 |

示例

针对同一份状态问两个问题：

{"state":"The user wants to delete /tmp/build. The path is inside the workspace.","questions":[{"id":"safe","type":"noul","threshold":0.8},{"id":"urgency","type":"score"}]}

返回结构如下：

{"answers":{"safe":true,"urgency":4},"confidence":{"safe":0.92,"urgency":0.71},"escalate":false}

拦截一条危险命令：

{"command":"rm -rf /","toolName":"shell","cwd":"/home/me/project"}

返回 decision: "deny"，附带原因和置信度；命令不会被执行。这些输出只用来展示结构，不是录制的真实结果。

工作原理

1. 宿主调用 phocinae_ask、phocinae_gate，或触发 pre-execute 闸门。
2. 插件把原始状态发到 http://127.0.0.1:8155/v1/systemone。
3. 服务为每道题返回一个结构化答案。
4. 闸门把答案映射为 allow / ask / deny；置信度低就转成 escalate，服务连不上时在 failMode: closed 下转成 ask。

配置

默认值在 cordis.patch.yml 和 lib/config.mjs 里。每个键都有默认值。

| 键 | 默认值 | 含义 |
| endpoint | http://127.0.0.1:8155/v1/systemone | 决策服务。默认只允许回环地址，除非设置 allowRemoteEndpoint: true。 |
| timeoutMs | 3000 | 每次请求的超时时间；只尝试一次。 |
| escalateAt | 0.6 | 置信度低于此值时，答案标记为 escalate: true。 |
| gate.mode | harm | 可选 harm、tri-state、noul 或 off。 |
| gate.tools | [''] | 要筛查的工具名：精确名、glob 或 。 |
| gate.failMode | closed | closed 表示服务不可达时转人工；open 表示放行。 |

只想使用工具、不做任何筛查：

- id: phocinae
config:
gate:
mode: off

安全与边界

- 仅限回环。 状态里包含原始工具调用文本；非回环地址会在加载时报错，除非显式允许。
- 失败即关闭。 服务报错或超时，被筛查的调用转人工；缺失的工具名不会进白名单。
- 不是沙箱。 网关只是额外的审批信号，不能替代宿主沙箱或人工审批。
- 不做生成。 模型无法回答知识问题、写代码或做摘要；这些请用对话模型。

兼容性

- Node ^22.19 或 >=24。
- DSH >=0.2.1-0 <0.3.0；bundle 行会挂载 phocinae_ask、phocinae_gate、网关和技能。
- phocinae-server 必须在配置的 endpoint 上可达。

故障排查

| 现象 | 处理 |
| PHOCINAE_SERVICE_UNAVAILABLE | 启动服务，并用 curl http://127.0.0.1:8155/health 检查。 |
| 直接 add 装到了旧版本 | 用 dsh-phocinae@0.2.5 重新 add；检查 dsh --profile web --dump-config。 |
| 网关什么都问 | 确认服务已启动；在 failMode: closed 下，服务不可达时本来就会转人工。 |
| 网关太严或太松 | 调整 gate.mode、gate.tools、gate.minConfidence、gate.autoAllow；不要盲目关掉。 |

许可证

Apache-2.0。模型卡和服务端是两个独立项目：Phocinae-Largha-150M-v1 和 phocinae-server。