用途:把一个随 vault 存放的本地工作台装进用户知识库并保证可用。仪表盘是入口层,不替代笔记系统,Markdown 仍是唯一真源。适用于“给知识库装工作台”“启动/重启仪表盘”“打不开或数据不对”“升级工作台”等诉求。
主要能力:提供总览、审核队列、进展看板、搜索、灵感速记;安装只写 50-系统/40-自动化/知识仪表盘/ 一个目录,并在上一级补齐缺失的 review_protocol.json / board_protocol.json 默认协议,已有协议不覆盖;config.json 永不覆盖;用户已改动的代码默认保留,只有明确要求升级时才用 --upgrade 替换并逐项报告。默认只监听 127.0.0.1,仅在用户明确要求手机通过自己的 Tailscale 网络访问时才加 --tailnet。
使用方式:先确定知识库根目录(与 ray-obsidian 同一套定位顺序:用户明确给出的目录、.ray-obsidian.json、同时存在 10-创作/ 20-知识/ 30-资料/ 50-系统/ 的兼容库,否则只问一个问题)。安装前先检查:python3 <skill-base>/scripts/dashboard_setup.py check --vault <知识库目录>,按 status 分流。安装与升级先预演再执行:python3 <skill-base>/scripts/dashboard_setup.py install --vault <目录> --dry-run,install --vault <目录> 只补缺失文件,加 --upgrade 用于用户要求升级时。启动:python3 <skill-base>/scripts/dashboard_setup.py start --vault <目录> [--port 8765] [--open],停止:python3 <skill-base>/scripts/dashboard_setup.py stop [--port 8765]。启动完成标准是 healthz 探测通过并交付可点击 URL,手动复核端点是 /api/healthz。诊断请求只诊断,不代为启停或改配置。
适用场景:本地知识库的可视化入口、审核与流转、进展查看。限制:本技能只装仪表盘和两份协议,不装采集管线、发布归档脚本及反馈卡模板;「让 Codex 起草」「登记发布」「网页复盘」依赖完整 rays-brain-kit 中的脚本,缺脚本时相应入口报错或自动隐藏。launchd 常驻自启仅有文档、未自动化;Windows/Linux 的 stop 依赖 lsof 回退、未充分验证。安装、启动、升级、诊断链路已实测。