JianFeeeee 7351c6ca2e feat(c-core): 内核编解码层 C 化第一刀 —— L1 纯函数层落地并打通构建链 ...

第一刀只做三个纯函数（窗口推断 / token 估算 / token 截断），
价值不在功能（Go 版没问题），而在打通「Go → cgo → C」全链路并
建立可复现的对照范式，后面每扩一个函数都复用它。

## 为什么是这三个

按「无状态 → 有状态」分层，L1 协议编解码最安全：纯 string in → struct out，
不碰网络、不碰 Lua、不碰 goroutine。三个函数更是同一组纯算术，最小可验证切片。

## 关键设计：包内符号链接，不链接静态库、不 include 包外源

三种做法都实测过，只有一种同时满足「可构建 + 可交叉编译 + 缓存可跟踪」：

1. ❌ 链接 `csrc/build/libha_codec.a`（原方案）
   - .a 是构建产物、不入库（.gitignore 的 build/ 命中 csrc/build/），
     而发布脚本原先并不产出它 ⇒「不入库 + 不生成」两头空，
     实测报 `cannot find .../libha_codec.a`
   - 交叉编译 linux/arm64（homed 真实发布目标）时，宿主 x86-64 的 .a
     被链进目标产物，实测报 `file in wrong format`

2. ❌ `#include "../../../csrc/src/ha_codec.c"`（包外相对包含）
   ★ Go 构建缓存**不跟踪包外被 #include 的 C 文件**。实测：包外源把返回值
   7→8，`go test` 依然通过（缓存命中、静默沿用旧代码）；同样改动落在包内
   文件时立即判红。对「逐步推进 C 化」这是致命的——改 C 源码不生效且无报错。
   （包内 shim `#include` 包外源同样漏跟踪，已实测排除。）

3. ✅ 包内符号链接 `internal/agent/api/ha_codec.{c,h}` → `csrc/`
   文件在包目录内 ⇒ 缓存按内容正确跟踪；只有一份权威源 ⇒ 无副本漂移，
   也不需要「同步 C 源」的 make 目标。

## 不需要额外 build tag

ha_codec 是零依赖纯 C99 源码内联编译，不需要外部库或工具链前提；
而 homed 本就强制 cgo（sqlite3 + gojieba），故 C 路径自然生效。
只用 `cgo` / `!cgo` 一组约束（对比 onnxruntime：那个需运行期 .so，故必须显式 tag）。

## 顺带修掉的既有缺陷（非 C 化引入，但一直缺覆盖）

- Makefile 的 arm64 目标缺 CC/CXX：cgo 回退到宿主 g++，报
  `gcc_arm64.S: no such instruction: 'stp x29,x30,[sp,'`
  （deploy/packaging/build.sh:49 一直是对的，Makefile 漏了）
- Makefile 的 arm64 目标缺 .syso 隔离：cmd/{homed,waiter}/*.syso 是 Windows
  COFF 资源对象，Go 会把同目录 .syso 无条件链进任何目标，交叉到非 Windows
  平台报 `file format not recognized`（build.sh 有 hide_syso_for_target）

## 验证（每条可复现）

- `make build-linux-arm64` → ELF 64-bit LSB executable, ARM aarch64（82MB）
- `bash deploy/packaging/build.sh linux/arm64 homed` → ELF aarch64（79MB）
- 移走 csrc/build/ 后 homed（cgo）与 waiter（CGO=0）均能构建
- 变异 C 源（131072→777）后**同一缓存**下 go test 立即 FAIL（改前：仍报 ok）
- `make check-codec-paths` 两条路径 OK；`make csrc-test` C 契约测试 100%
- 黄金对照：手写用例 + 2000 次随机对拍，C 与纯 Go 逐值相等
- 全量 `go test -count=1 ./...` → 57 包：38 ok + 19 无测试 + 0 FAIL

新增 `make check-codec-paths` 防回归：只测一条路径时，另一条的破坏不会被发现。

## 文档

- `docs/zh/c-core/llm-orchestration-c.md` 同步为「已落地」，并更正因
  「Windows 原生已放弃」而过时的 §2.3（回退路径的理由需重述）
- plan.md 的 P0-1 标记为已修复，附实测证据

2026-09-25 14:45:08 +08:00

..

agent_functions_test.go

fix(llm): 参数无法解析时给出真因，不再静默丢弃整条调用

2026-09-19 16:49:16 +08:00

agent_helpers_test.go

fix(memory): doc→graph 补回常用词闸门 + 存量噪音/孤立节点清理

2026-09-15 07:47:16 +08:00

agent_tools_test.go

refactor(memory): 拆除描述式媒体索引，媒体成为一等块并按原生向量融合

2026-09-11 11:45:24 +08:00

agent.go

feat(scheduler): 主 agent 忙时把积压任务自动转投给驻留子

2026-09-19 16:59:47 +08:00

context_test.go

fix(memory): 记忆层启动接线/并发/落盘一致性整备

2026-09-15 06:32:36 +08:00

context.go

fix(memory): 记忆层启动接线/并发/落盘一致性整备

2026-09-15 06:32:36 +08:00

crossmodal.go

refactor(memory): 拆除描述式媒体索引，媒体成为一等块并按原生向量融合

2026-09-11 11:45:24 +08:00

device_tool_auth_test.go

feat(remotedevice): 设备能力 outputch 化 —— 每设备一个 device/<id> 通道 + 设备指令类工具补授权闸

2026-09-13 12:23:28 +08:00

distill.go

feat(memory): 场景从「声明」改为「涌现」——场面指纹自己长成场景

2026-09-15 09:27:39 +08:00

eventloop.go

feat(resident): 分诊助手定位 + 残余任务由父显式决定

2026-09-19 17:43:16 +08:00

gpttest_test.go

feat: 插件工具按需拉取(get_plugin_tools) + 设备命令类型拆分(shell-cmd/homeagent-cmd)

2026-08-18 09:07:21 +08:00

graphmedia_test.go

fix(rel): 场景贯穿流水线到块层 + 编辑不再丢置信度/场景 + 构建默认带 onnxruntime

2026-09-15 09:03:36 +08:00

graphmedia.go

feat(rel): 文档层接入场景（document 节点挂场景）

2026-09-15 09:16:22 +08:00

inputch_test.go

feat(channel): N1a —— inputch 一等化（归属插件/归属 agent/容量/共享登记表）+ 单工具多视图总览

2026-09-13 09:06:50 +08:00

inputch.go

feat(memory): 新增可声明的召回轴 RecallPolicy（与 prune 正交）

2026-09-14 23:14:38 +08:00

inputroute_test.go

fix(resident): 子的「轮次」一直显示 0 —— info() 根本没填 Rounds

2026-09-13 15:41:07 +08:00

inputroute.go

fix(scheduler): inputch 划给子后输入只流向子 —— 补上「进内核之前」的输入路由

2026-09-13 15:35:59 +08:00

inputunify_test.go

feat(memory): 场景双通道——主动声明与被动涌现并存，且互不吞噬

2026-09-15 09:37:29 +08:00

lightprofile_test.go

feat(memory): 场景双通道——主动声明与被动涌现并存，且互不吞噬

2026-09-15 09:37:29 +08:00

media.go

v0.7.3: 重构 Provider 层 + 计算层隔离 + Cleaner/NoMemory 架构

2026-07-28 11:42:29 +08:00

medialive_test.go

feat(memory): 场景式关联召回——给记忆节点赋场景引用，场面重现即取回

2026-09-15 08:13:52 +08:00

medialoop_test.go

feat(memory): 千问三段式 ONNX 嵌入补齐——可复现导出脚本 + Go 侧首次完整验证

2026-09-11 13:45:25 +08:00

medialoop.go

feat(memory): 千问三段式 ONNX 嵌入补齐——可复现导出脚本 + Go 侧首次完整验证

2026-09-11 13:45:25 +08:00

mediaref_test.go

refactor(memory): 拆除描述式媒体索引，媒体成为一等块并按原生向量融合

2026-09-11 11:45:24 +08:00

mediaref.go

feat(scheduler): M3a+M3b 任务生命周期重构 + 四级优先级抢占

2026-09-13 00:25:52 +08:00

memoryface.go

fix(lightkernel): 传统上下文落到实处 —— 子不做策略性裁剪（并修掉裁剪估算的字节/rune 单位混用）

2026-09-13 10:36:04 +08:00

memorypass_test.go

feat(memory): 场景式关联召回——给记忆节点赋场景引用，场面重现即取回

2026-09-15 08:13:52 +08:00

memorypass.go

feat(memory): 场景双通道——主动声明与被动涌现并存，且互不吞噬

2026-09-15 09:37:29 +08:00

modalfallback_test.go

fix(multimodal): 修多模态假成功 + 落地视觉回退链 + see_video 帧数语义

2026-09-04 06:25:51 +08:00

modalfallback.go

fix(multimodal): 修多模态假成功 + 落地视觉回退链 + see_video 帧数语义

2026-09-04 06:25:51 +08:00

offload_test.go

fix(offload): 内核说明不能被再转投（自我循环）+ offload_owned 未接线

2026-09-19 17:47:44 +08:00

offload.go

feat(resident): 分诊助手定位 + 残余任务由父显式决定

2026-09-19 17:43:16 +08:00

output_grant_test.go

feat(channel): N1b —— 输出通道授权集合（三处过滤一致）+ 输出通道→目标 agent 的 inputch 解析

2026-09-13 09:13:19 +08:00

output_rules_test.go

fix(prompt): 去掉"每轮只能发一次 output_send"的凭空限制；type 缺省即 text

2026-09-13 16:04:16 +08:00

output.go

fix(prompt): 去掉"每轮只能发一次 output_send"的凭空限制；type 缺省即 text

2026-09-13 16:04:16 +08:00

persona_test.go

feat(persona): 首启人格门禁跨通道化 + 内核 persona_set 工具

2026-09-12 13:57:06 +08:00

persona.go

feat(persona): 首启人格门禁跨通道化 + 内核 persona_set 工具

2026-09-12 13:57:06 +08:00

plugin_health.go

fix(llm): 参数无法解析时给出真因，不再静默丢弃整条调用

2026-09-19 16:49:16 +08:00

plugins.go

feat: 插件工具按需拉取(get_plugin_tools) + 设备命令类型拆分(shell-cmd/homeagent-cmd)

2026-08-18 09:07:21 +08:00

preempt_logging_test.go

fix(obs): 抢占日志改在判决点打（修自伤）+ scheduler 事件接进 SSE

2026-09-19 11:57:50 +08:00

process.go

fix(llm): 参数无法解析时给出真因，不再静默丢弃整条调用

2026-09-19 16:49:16 +08:00

promptvars_test.go

fix(prompt): 系统提示词支持版本占位符 —— 人格卡不再写死版本号

2026-09-13 14:34:44 +08:00

prunepolicy_test.go

feat(core): 注入行为的记忆/裁剪标志位落地 + jieba 词库内嵌 + Windows 改走 WSL

2026-09-11 20:31:50 +08:00

prunequery_test.go

fix(ctx): prune 的查询向量改用插件 Cleaner 清洗后的有效内容(§13.8)

2026-09-10 23:59:12 +08:00

recallpolicy_test.go

feat(memory): 场景式关联召回——给记忆节点赋场景引用，场面重现即取回

2026-09-15 08:13:52 +08:00

resident_output_test.go

fix(resident): 驻留子继承父的输出通道 —— 修「子侧 childIO 空壳、子不会发消息」

2026-09-13 15:09:44 +08:00

resident_test.go

fix(resident): 销毁驻留子时注销其入站 inputch（child/<id>）—— 修登记表脏数据累积

2026-09-13 20:19:37 +08:00

resident_tools.go

feat(resident): 分诊助手定位 + 残余任务由父显式决定

2026-09-19 17:43:16 +08:00

resident.go

fix(offload): 内核说明不能被再转投（自我循环）+ offload_owned 未接线

2026-09-19 17:47:44 +08:00

scene_test.go

feat(memory): 场景双通道——主动声明与被动涌现并存，且互不吞噬

2026-09-15 09:37:29 +08:00

scheduler_channel_routing_test.go

refactor(core)!: N0 无状态化 —— 删除 Agent.currentOutputChannel，通道只跟输入事件/帧走

2026-09-13 08:59:15 +08:00

scheduler_critical_test.go

feat(status+webui): 运行态图形化 —— 排队/四级中断队列/中断栈/驻留子/通道拓扑

2026-09-14 09:05:14 +08:00

scheduler_e2e_test.go

feat(scheduler)!: 中断/排队两类别模型 + 插件声明 L1-L3、L4 内核独占

2026-09-13 07:00:51 +08:00

scheduler_kernel_test.go

feat(scheduler): L4 也归内核级插件 —— WebUI 终止按钮可用“立即打断”

2026-09-13 07:18:03 +08:00

scheduler_preempt_test.go

feat(scheduler)!: 中断/排队两类别模型 + 插件声明 L1-L3、L4 内核独占

2026-09-13 07:00:51 +08:00

scheduler_rearm_test.go

fix(scheduler): 安全点重新求值中断队列 + 抢占/背压计数修正 + 停机补终态

2026-09-14 10:39:25 +08:00

scheduler_regression_test.go

fix(scheduler): 补齐 M3 与设计稿的两处语义偏离（发现即修）

2026-09-13 06:10:44 +08:00

scheduler_stack_test.go

feat(scheduler)!: 中断/排队两类别模型 + 插件声明 L1-L3、L4 内核独占

2026-09-13 07:00:51 +08:00

scheduler_starvation_test.go

feat(scheduler)!: 中断/排队两类别模型 + 插件声明 L1-L3、L4 内核独占

2026-09-13 07:00:51 +08:00

scheduler_stress_test.go

test(scheduler): 优先级压力测试（100 排队 + 100 中断各级混合、嵌套到 4 帧上限）

2026-09-13 07:31:32 +08:00

scheduler_test.go

feat(scheduler)!: 中断/排队两类别模型 + 插件声明 L1-L3、L4 内核独占

2026-09-13 07:00:51 +08:00

scheduler.go

fix(offload): 内核说明不能被再转投（自我循环）+ offload_owned 未接线

2026-09-19 17:47:44 +08:00

spawn_test.go

fix(agent): 工具循环占位不再驱动重复发送，输出回执/子任务结果幂等

2026-09-10 20:36:39 +08:00

spawn.go

refactor(core)!: N0 无状态化 —— 删除 Agent.currentOutputChannel，通道只跟输入事件/帧走

2026-09-13 08:59:15 +08:00

stage.go

refactor(core)!: N0 无状态化 —— 删除 Agent.currentOutputChannel，通道只跟输入事件/帧走

2026-09-13 08:59:15 +08:00

stages_plugin_test.go

fix(proc): 子进程崩溃自愈 + 集中台账 + 注册面摘除

2026-09-03 12:37:58 +08:00

stages_test.go

refactor: pluginize text cleaning and tool NoMemory control

2026-07-24 14:49:08 +08:00

stages.go

fix(llm): 参数无法解析时给出真因，不再静默丢弃整条调用

2026-09-19 16:49:16 +08:00

status_onnx_test.go

feat(healthcheck): 内核状态快照报出内核版本号与 ONNX 模型启用状态

2026-09-12 14:56:25 +08:00

status.go

feat(resident): 分诊助手定位 + 残余任务由父显式决定

2026-09-19 17:43:16 +08:00

stop_semantics_test.go

fix(stop): 配额须计入停在输入 channel 的待处理消息

2026-09-18 11:39:04 +08:00

stream_accumulate_test.go

fix(llm): 参数无法解析时给出真因，不再静默丢弃整条调用

2026-09-19 16:49:16 +08:00

stream_index_test.go

fix(llm): 参数无法解析时给出真因，不再静默丢弃整条调用

2026-09-19 16:49:16 +08:00

task_lifecycle_test.go

fix(scheduler)!: D1 更正为「中断从上一个任务之前的完整状态开始」，并实现现场合回

2026-09-13 06:24:20 +08:00

task_terminal_test.go

feat(scheduler)!: 中断/排队两类别模型 + 插件声明 L1-L3、L4 内核独占

2026-09-13 07:00:51 +08:00

task_test.go

fix(scheduler)!: 撤掉“优先级=可配置策略表”的错误设计，回归内核内部属性

2026-09-13 06:17:49 +08:00

task.go

fix(stop): 停止按钮真正生效——停止 ≠ 空中断；鸿蒙 screensue 支持 HTML

2026-09-18 11:26:12 +08:00

terminal_registry_test.go

refactor(terminal): 内核开终端/命令历史权威视图，WebUI 与 CLI 都改接内核

2026-09-17 18:56:15 +08:00

terminal_registry.go

refactor(terminal): 内核开终端/命令历史权威视图，WebUI 与 CLI 都改接内核

2026-09-17 18:56:15 +08:00

tokenbudget_test.go

feat(llm): 声明真实上下文窗口 + 工作区间与窗口分离

2026-09-19 14:24:31 +08:00

tokenbudget.go

feat(c-core): 内核编解码层 C 化第一刀 —— L1 纯函数层落地并打通构建链

2026-09-25 14:45:08 +08:00

toolcall.go

fix(llm): 参数无法解析时给出真因，不再静默丢弃整条调用

2026-09-19 16:49:16 +08:00

tooldefs.go

feat(resident): 分诊助手定位 + 残余任务由父显式决定

2026-09-19 17:43:16 +08:00

tooloop_test.go

fix(core): 插件拒绝工具时把 ctx.Response 的理由透给模型

2026-09-14 16:45:04 +08:00

utils.go

feat(sdk): 多模态贯通插件边界——公开接口、内核桥接与统一输入主干

2026-09-06 09:51:31 +08:00