jikud 读取 ~/.config/jiku/config.toml(支持 --config 或 $JIKU_CONFIG 覆盖)以及 ~/.config/jiku/init.lua(支持 --policy 或 $JIKU_POLICY 覆盖)。所有配置项均内置经过校验的默认值,零配置即可通过 jikud --headless-check 或启动服务。
config.toml 核心配置参考
[daemon]
locale = "zh-CN" # "zh-CN" | "ja-JP" | "en-US"
socket_name = "jiku.sock" # 位于 $XDG_RUNTIME_DIR/
dropbox_dir = "~/JikuBox"
[koma]
default_workspace = "agent:work"
default_overlay = "grid_225" # "grid_225" | "som" | "none"
perceptual_hash_threshold = 4 # L0 dHash 汉明距离去重阈值
[providers.opencode_go]
kind = "opencode_go"
base_url = "https://opencode.ai/inference/go/openai/v1"
api_key_env = "OPENCODE_GO_API_KEY"
thinking = false
[providers.gemini]
kind = "google_gemini"
base_url = "https://generativelanguage.googleapis.com/v1beta"
api_key_env = "GEMINI_API_KEY"
[roles.planner]
provider = "opencode_go"
model = "deepseek-v4.1-flash"
driver = "turn_sse"
thinking = false
temperature = 0.2
[roles.decision_router]
provider = "gemini"
model = "gemini-decision-1" # 无密钥时自动无感回退至 EmulatedStructuredTextModel
driver = "decisions"
optional = true
fallback_to_primary_text_model = true
DecisionCompiler、GridSpec 与 TimeSlotMacro 参数
[decision_router.compiler] 与 [decision_router.compiler.grid] 暴露全部决策编译器超参数:
| 配置项 | 默认值 | 说明 |
|---|---|---|
grid.cols / grid.rows |
15 / 15 |
空间决策网格尺寸(1..=64,默认 225 格 A1–O15) |
fast_path_confidence |
0.85 |
允许跳过 System-2 规划直接下发 vseat 动作的置信度阈值 |
min_cell_prob |
0.05 |
grid_225 质心插值保留单元格概率下限 |
time_slot_min_confidence |
0.75 |
TimeSlotMacro 多步快捷键序列单步最低置信度 |
bernoulli_activation_threshold |
0.80 |
BernoulliExpectedStep 条件步骤触发阈值 |
probe_min_prob |
0.15 |
ThresholdProbe 候选保留下限 |
stop_sentinel / fallback_token |
"stop_done" / "NONE_OR_OTHER" |
序列终止哨兵与开放世界逃逸选项 |
桌面通知与可选语音合成([notify] / [tts])
- 桌面通知(
[notify]):默认desktop_dbus = true、app_name = "Jiku",在task_completed、task_failed、verification_needed、skill_staged时通过 D-Bus /notify-send提醒人类。 - 可选 TTS(
[tts],默认关闭enabled = false):显式启用后支持voicevox(http://127.0.0.1:50021,speaker_id = 3)、openai_speech与noop(对应VoicevoxProvider、OpenAiSpeechProvider、NoopTtsProvider)。
Phodopus Lua 策略(~/.config/jiku/init.lua)与 jikud.service
用户策略钩子运行在隔离的 Phodopus Lua 5.4 沙箱中,可通过 systemd --user 托管运行:
# ~/.config/systemd/user/jikud.service
[Unit]
Description=Jiku Desktop Orchestration Daemon
After=graphical-session.target
[Service]
ExecStart=/usr/bin/jikud --daemon
Restart=on-failure
[Install]
WantedBy=graphical-session.target