mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-01 14:57:38 +00:00
55fa2685ae
security（新模块 internal/kernelmod/security）
- 凭据闸门：出向拦截成 @{别名}、入向清洗、执行前回填（internal/security/{gate,runtime}.go）
- 工具黑白名单 + 沙箱（读写根、网络、.. 逃逸）：internal/security/policy.go
- 敏感词过滤 + 提示词注入预警（Finding 不带原文）：internal/security/content.go
- 按主体授权（hard-private 对非内部主体永久拒绝）：internal/security/principal.go
- 插件命名限式（可选档位，插件声明/内核执行，只能收窄）：internal/security/profile.go
- 启动装配从 cmd/homed 迁入模块；启动顺序判据改盯真实装配点
device（新模块）
- 正式内核模块，Provides FacDevice，KernelState.Device
- 内置工具路由表下沉到 internal/toolroute（避免 core↔kernelboot 环），
device 保留对外入口；agent 未挂载时退化本地 switch
- Agent 侧只留 api.ToolHost/DeviceSurface 适配层
SDK
- InjectOptions.SecurityProfile：插件按 inputch 声明本轮安全档位（可选）
- InjectOptions.TurnHint：插件注入**本轮事实**，内核以独立 system 消息注入，
不混进用户正文（人设负责怎么说话，TurnHint 只放这一轮成立的事实）
- FacilitySecurity / FacilityDevice
提示词
- 内核自带 prompt/skill/工具返回全面英文化（中文提示会让模型行为漂移）
- 机制解释下沉到 4 个内置 skill（memory/output/tool-order/plugins），
skill 描述压到 80 runes 内（原来 94–108 全被索引截断）
- 默认人格模板英文化；[Voice] 段删除，规则并入 persona 块（单一段落）
- 历史记忆工具改名 coldcontext_query/commit，图记忆语义改称 stable memory
修复
- tracker: exec mount → unix.Mount（降权运行 + AmbientCapabilities 下才能挂）、
区分 EPERM 与不支持；启动日志说明后果与恢复方式
- healthcheck_kernel 输出瘦身：status.Tools 只给摘要（原 98,989 tokens/151% 预算）
- plugin_list 描述讲清 auto_start（按需）与 alive（此刻是否在跑），
明确不能由 alive=false 推断能力不存在
- pluginmgr/webui 去掉写死的 /home/newqqagent 回退路径（env → pluginDir 反推 → 报错）
- lua: 盘上适配器与内置版本不一致且无基线时响亮告警（deepseek 流式丢失
tool_calls 导致'模型不调工具'的真因）
测试：go build ./... 通过；go test ./... 60 包全绿
89 lines
3.0 KiB
Go
89 lines
3.0 KiB
Go
package skillmgr
|
||
|
||
// 内核自带的 skill：把**技术机制**写进 skill，由 skillmgr 注入，而不是塞进
|
||
// 系统提示词。
|
||
//
|
||
// ## 为什么（用户 2026-10-26 的两次裁定）
|
||
//
|
||
// 1. 「系统提示词把机制讲得太深太技术化，导致 agent 说话没人味」——
|
||
// 机制留在提示词里，模型会连**语气**一起模仿：回复变成说明书腔。
|
||
// 2. 「技术相关下沉到 skill，由 skillmgr 自行管理注入」——
|
||
// 提示词只留"必须做什么"，"怎么实现"由 skill 讲。
|
||
//
|
||
// 所以提示词里只剩一两句行为约束，机制在下面这四个 skill 正文里：
|
||
//
|
||
// kernel-memory 记忆分层与 coldcontext_query 的回填语义
|
||
// kernel-output 同步/异步通道怎么真正送达用户
|
||
// kernel-tool-order 一次回复里多工具调用的调度与例外
|
||
// kernel-plugins 按需插件怎么发现与拉起
|
||
//
|
||
// ## 为什么内嵌在二进制里，而不是让用户自己装
|
||
//
|
||
// 它们是**内核行为**的一部分：提示词引用了它们，就必须保证它们一定存在。
|
||
// 若依赖外部安装，用户删掉/改名后提示词会指向不存在的 skill —— 那比不写更糟。
|
||
//
|
||
// ## 落盘纪律：不覆盖用户版本
|
||
//
|
||
// 只在目标目录**不存在**时写入（与 adapters 的 `.bundled` 语义一致）。
|
||
// 用户改过的同名 skill 一律保留：内核不该覆盖人的修改。
|
||
|
||
import (
|
||
"embed"
|
||
"io/fs"
|
||
"log"
|
||
"os"
|
||
"path/filepath"
|
||
)
|
||
|
||
//go:embed builtin
|
||
var builtinSkills embed.FS
|
||
|
||
// builtinSkillDir 是内嵌 skill 的根目录名。
|
||
const builtinSkillDir = "builtin"
|
||
|
||
// skillFileName 与 plugin.LoadSKILL 认的文件名一致。
|
||
const skillFileName = "SKILL.md"
|
||
|
||
// materializeBuiltinSkills 把内嵌 skill 落到 skillsDir，返回新写入的数量。
|
||
//
|
||
// 已存在的目录**不覆盖**：那是用户可能改过的版本。返回 0 表示无需写入。
|
||
func materializeBuiltinSkills(skillsDir string) int {
|
||
if skillsDir == "" {
|
||
return 0
|
||
}
|
||
entries, err := builtinSkills.ReadDir(builtinSkillDir)
|
||
if err != nil {
|
||
log.Printf("[skillmgr] read embedded skills: %v", err)
|
||
return 0
|
||
}
|
||
written := 0
|
||
for _, e := range entries {
|
||
if !e.IsDir() {
|
||
continue
|
||
}
|
||
name := e.Name()
|
||
dstDir := filepath.Join(skillsDir, name)
|
||
if _, statErr := os.Stat(dstDir); statErr == nil {
|
||
continue // 已存在（用户版本或上次落盘）：不覆盖
|
||
}
|
||
data, readErr := fs.ReadFile(builtinSkills, builtinSkillDir+"/"+name+"/"+skillFileName)
|
||
if readErr != nil {
|
||
log.Printf("[skillmgr] embedded skill %s: %v", name, readErr)
|
||
continue
|
||
}
|
||
if mkErr := os.MkdirAll(dstDir, 0755); mkErr != nil {
|
||
log.Printf("[skillmgr] create %s: %v", dstDir, mkErr)
|
||
continue
|
||
}
|
||
if wErr := os.WriteFile(filepath.Join(dstDir, skillFileName), data, 0644); wErr != nil {
|
||
log.Printf("[skillmgr] write %s: %v", dstDir, wErr)
|
||
continue
|
||
}
|
||
written++
|
||
}
|
||
if written > 0 {
|
||
log.Printf("[skillmgr] materialized %d kernel skills (mechanics live here, not in the system prompt)", written)
|
||
}
|
||
return written
|
||
}
|