CallMeHFK — ~/index.html 项目展厅 → zh-CN
CallMeHFK 终端标识

CallMeHFK · UTC+8

给 agent 的过程和输出加约束

upstream PR 5 merged · 3 open qwenpaw plugins 7 项目展厅 12 项目 · 3D 星座
python typescript go c cpp linux windows git WDK · APO Renode MCP AgentScope · QwenPaw

仓库速览

项目展厅 → · 12 repos
仓库是什么版本推送
dispatch-guard ↗编排 Agent 输出路由的 tool-seam 中间件v0.1.1110-14
agent-shepherd ↗智能体过程监督:两层检测器 + 离线反事实基准v0.4.010-19
jev-kernel ↗mu 式判定内核:tool seam 上的分级裁决与校准概率(上游移植适配)v0.2.110-12
agent-task-callback ↗跨 Agent 后台任务的 push 侧回调v0.1.510-12
qwenpaw-secret-input ↗运行中途向人要密钥:明文不进模型上下文,只回一次性 refv0.2.010-21
qwenpaw-openviking ↗OpenViking 记忆服务的 QwenPaw 原生插件(上游移植适配)v0.2.010-14
site-kg ↗站点 URL 或本地目录 → 知识图谱 → 10 工具 MCP 服务—10-22
qwenpaw-consensus-rank ↗多评审 LLM 位次平均共识排序v1.4.1010-09
niclane ↗本地 SOCKS5 / HTTP 代理的 per-NIC 出口隔离(Go,候选车道自动故障转移,fail-closed)v0.4.010-22
sovereign-echo ↗把个人数据主权声明注入每一场对话(Shell)—10-19
agent-chatroom ↗多 Agent 聊天室:@ 点名、并行应答、SSE 流式、共享画布—10-22
raspberry-pi ↗派上实时语音通话(WebRTC),后端是真能执行工具的 CLI agent—10-19

推送列是各仓库默认分支最近一次推送。live 表示距 2026-10-22 复核日不到 7 天,12 个仓库里 7 个。行序与展厅卡片一致,即 3D 星座的四个簇。

系统设计

3 个

只展开自己从零写的三个系统;宿主插件与上游移植走上表,不占这一节。

agent-shepherd过程监督

观测 QwenPaw / Claude Code / Codex 的 reasoning 与 tool call 流,偏航时注入纠正。

  • 两层检测。Tier 0 是确定性检测器,覆盖 loop、regression、越权编辑、binding drift、context rot,另有一路 CUSUM 漂移告警。Tier 1 是 PRM 式 LLM 判定,只在 natural checkpoint 或 CUSUM 接近告警线时唤醒。
  • 阈值来自测量。漂移阈值用蒙特卡洛仿真标定到会话级误报预算,判定阈值用 conformal risk control 按实测拟合。工具结局先做 failed / ok / unknown 三态分类,错误串文法只作兜底。规则本条目按 Wilson 下界排序。
  • shepherd eval 注入单点故障,按检测器报 precision、recall、detection latency、supervision cost,CI 以 --fail-under-f1 0.8 为门。
  • 0.4.0 把判定层接回规则本:每条真正注入的纠偏留待下次 judge review,按准入线标 agreed 或 disagreed;条目排序混合 adherence 与贴否率的收缩 Wilson 下界,累计 4 次以上且贴否过半的条目从 header 剔除。
  • shepherd uninstall 只删安装写进去的条目,改前备份,--dry-run 出计划。shepherd stop 按 /health 报的 pid 分拣手动进程与 systemd unit。

v0.4.0 · 不在 PyPI,从 git 或 release wheel 安装

dispatch-guard输出路由

把派发约束从 system prompt 移到 tool seam:on_acting 拦截交付物形状的写入并 deny,回填该派给谁。

  • 写入按交付物目录与扩展名加白名单判定,命中且存在归属专家 agent 时拒绝,并回填该派给谁。shell 侧默认 warn,开 shell_enforce 才拦重定向旁路。spawn_subagent 是配置层之外的兜底 deny。读与基础文件 IO 不拦。
  • routes.json 按 mtime 热加载,并自审矛盾规则、死规则、未知 mode。无配置时从各 agent 声明的派发策略草拟 warn 模式的 routes.draft.json,改名后才生效。
  • jev 是 opt-in 第二层,默认关,只补确定性规则判不出的两处:草拟路由的 P0,和关键词路由指不到在册 owner 的 P1。p ≥ 0.85 才在 enforce 下 deny 并点名 owner,0.6 到 0.85 转 warn。判定端点与模型取自 jev-kernel 的 jev.json,kernel 停这层也停。

v0.1.11 · release 一行安装

agent-chatroom多 Agent 运行时

用户与多个 CLI agent 同室互聊:@ 点名,agent 之间也能互相唤起。零框架 node:http + SSE,前端单页零构建。

  • 和 dispatch-guard 同一条主张:回复路由是策略层,不写在 prompt 里。@ 精确点名、无 @ 全员接力、replyTo 链深 ≤ 3 防无限对轰、发言冷却防抢话;并行应答默认开,同一轮被点名的多个 agent 同时发言,流式事件天然交错
  • 三种 driver 并存(ACP 常驻会话 / 本地一次性 CLI / 远程 SSH),所以「本机已装的各家 agent」不必先被改造成同一个协议才能进屋。abort 是一等公民:Driver.send 第三个参数就是 AbortSignal,acp 发 session/cancel,cli / ssh 杀进程组
  • SSE 事件对齐 AG-UI 分类法(TEXT_MESSAGE_* / THINKING_* / CUSTOM / STATE_*),字段名本身就是前后端契约——PLAN.md 的 T8–T12 标题直接写着「前端契约已定,字段不得更改」
  • 接入结论落在实现里:ACP 驱动 qodercli 时默认不调 authenticate(会挂起),直接 session/new,失败且 authMethods 非空时才回退一次。国际版端点 *.qoder.sh 被 TLS 拦截,默认配置改用国内版 qoderclicn。

package.json 写 0.1.0 但未打 tag · 仓库无 LICENSE

上游 PR

5 merged · 3 open
仓库PR状态内容
skillsgate#31merged 2026-10-12投递 Qoder / Qoder CN / QwenPaw / ZCode 四个宿主,+47/−5
sepia#289merged 2026-10-09零 Skill 安装改为显式失败,撤掉 /sepia 命令,+199/−171
sepia#250merged 2026-09-17.qwenpaw-plugin/ 插件包 + /sepia 斜杠命令,+318/−25
ncdownloader#158merged 2024-06-06修复「搜索音乐」条目下载失败(issue #136),+1/−1
nacos#12127merged 2024-06-03Python services sample,+198/−2
SemaPLC#6openQwenPaw / Claude Code / Cursor 三平台接入,+2907/−2465
ResearchStudio#60open安装器并列加 QwenPaw 与 Qoder 两个宿主,+289/−71
text-to-cad#429openREADME 与首页补 ZCode / QwenPaw 安装路径,+108/−2

同一套 Skill 内容不动,只改 manifest 与路由。数字与状态对 2026-10-22 的 GitHub 复核(8 条逐个查过 state 与 merged_at)。

图解

folded
技能循环与决策边界
Agent Skill 生态闭环:安装 → 运行 → 蒸馏 → 评分(SkillLens 9 维),再由 SkillOpt 门控优化回到安装
决策边界:参数调优触及物理上限即立即转向;回路由建立基线、改进、对比基线构成

技能侧按带 SKILL.md 的目录安装,配 9 维评分与门控优化,评分口径参照 SkillLens 的实证基线。

运行原则

principles.txt

用数据与事实做决策,不用感觉。先盘点再行动,确认了快速推进。

质量是底线,效率是目标。

CallMeHFK:~$ cat principles.txt
[0]先盘点,再行动建立基线 → 改进 → 对比基线,不盲目启动
[1]数据驱动不迷信源码 > 配置 > 运行态;禁止口算,工具算完再输出
[2]逐字保真源数据神圣不可改;可加标注,禁止「优化」改写
[3]物理极限即边界参数调优空间可迭代,碰物理上限立即转向,不死磕
[4]诚实纠错新数据推翻旧结论 → 明确记录「上一轮我说 X 是错误的」
[5]工具链即基础设施按任务安装不膨胀;必须有退路,否则不上
CallMeHFK:~$

「写得进去的部分,已经足够强大。」—— 但做不出来,比说不清楚更致命。