Overview
dsh-clarify
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- **约束是提示词级的,不是沙箱。** 「澄清阶段只读不写」靠指令和确认门,插件不拦 `write`/`bash`。 - **本机进程受信任。** 见「安全边界」:同机的 curl 级别调用仍能读卡片、答问题;插件防的是跨站与局域网匿名访问。 - **面板靠心跳判定在线。** 面板 15 秒内没轮询,宿主就认为没有面板,退回内置问答(一次一题)。所以面板只由 `conversation.input.dock` 里的组件启动轮询——胶囊按钮只读一次状态,绝不冒充心跳。 - **超时会退回聊天。** 面板 20 分钟没人答(`interviewTimeoutMs`),工具返回 `timeout`,模型会把问题整理成一段话贴到回复里。 - **子 Agent 里不能确认**,会拿到 `no_client`,不会卡死。 - **状态按 session id 记**,fork/重命名成新 id 后不带模式;重新点一下开关即可。 - **「已开工」只在当前进程内记。** 它来自 `session/event` 的写文件类工具调用,重启后从头判断;`bash` 不算开工(它可能只是 `ls`),所以用 bash 生成的交付物不会触发 goal 过滤。 - **指标是本地文件,不是遥测。** 记录写在 `$DSH_HOME/clarify/metrics.json`,最多 500 条;`invalid`/`busy` 这类没有真实访谈的尝试不记录。 - **提示词是中文写的**,英文会话能跑,但模型会用中文问。 ---
