SkillClaw Dashboard 实战指南：如何可视化管理技能版本、验证进度与会话追踪
【免费下载链接】SkillClawLet Skills Evolve Collectively with Agentic Evolver项目地址: https://gitcode.com/gh_mirrors/sk/SkillClaw
SkillClaw Dashboard 是 SkillClaw 内置的可视化看板，帮你一屏管理技能版本、查看验证进度、追踪会话来源。你只需两条命令，就能把"技能库像杂物箱"变成"清晰的技能生命周期视图"，新手也能快速上手。
为什么你需要 SkillClaw Dashboard
SkillClaw 会让 AI Agent 的技能从每一次真实会话中不断演化：自动去重、自动改进、自动验证。但随之而来的问题是——
- 我本地的技能，和共享库里的正式版一致吗？
- 哪些候选技能正在等待验证？卡在哪个环节？
- 这个技能为什么被更新？背后是哪次会话贡献的经验？
Dashboard 就是为这三个问题而生的本地可视化管理层：它把本地技能、共享库、候选验证任务、历史版本和会话记录汇总成一个网页面板，无需盯着日志和文件目录。
最快启动方法：sync + serve 两条命令
Dashboard 与skillclaw同一套安装，无需额外依赖。核心流程就两步：
- 同步快照：
skillclaw dashboard sync— 把本地技能、共享技能、验证任务、会话记录构建成一份本地数据快照 - 启动面板：
skillclaw dashboard serve— 默认监听127.0.0.1:3788，浏览器打开即可
如果你用了本地共享目录（多 Agent / 多设备场景），可以显式指定共享根目录和分组：
skillclaw dashboard sync --sharing-local-root /path/to/shared/root --sharing-group-id my-group skillclaw dashboard serve --host 127.0.0.1 --port 3791小贴士：如果刚刚执行过sync，serve时加--no-sync-on-start可以跳过启动时重建，启动更快。命令实现见 cli.py。
五大核心视图：技能版本到会话追溯全覆盖
打开面板后，左侧导航对应五个视图，覆盖技能管理的全生命周期：
总览页：一屏看懂技能演化链路状态
总览页汇总四类关键状态：本地同步、候选验证、最终发布和会话来源。右侧的"最近事件"按时间倒序展示候选生成、验证反馈、最终决策等流程事件，先抓变化，再下钻细节。适合每次打开 Dashboard 的第一站。
我的技能：本地版本和共享正式版一致吗
"我的技能"视图列出所有本地技能，并标注它们是否与共享库的正式版本同步。点击某个技能，右侧详情区会显示：
- 同步状态（本地/共享/是否一致）
- 完整版本链
- 该技能最近关联了哪些会话
支持按名称、描述或分类搜索，本地技能杂乱时尤其好用。
候选池：验证进度一目了然
这是 Dashboard 最有价值的视图之一。当演化服务器采用"先验证、后发布"模式时，候选技能会先进入候选池，等待验证客户端反馈。视图按状态分类：
| 状态 | 含义 |
|---|---|
| 待验证 | 候选已生成，还没有验证反馈 |
| 已有反馈 | 至少收到一份验证结果，等待阈值判定 |
| 已入最终池 | 验证达标，已发布到共享库 |
| 已拒绝 | 验证不达标 |
选中某个候选，可以查看它的候选内容、验证客户端、决策时间，以及它依赖哪些会话证据——彻底告别"不知道技能为什么变了"的焦虑。
最终池：共享技能版本历史与一键切换
"最终池"只显示已经进入共享库的正式技能，用来观察版本演进：每个版本的时间、动作（创建/更新/回滚）和内容摘要都在这里。更实用的是版本激活功能：一键把某个技能切换回"本地当前版本"、"共享当前版本"或任意历史版本（如 v3），多文件技能包也会完整还原。版本激活逻辑见 dashboard_server.py。
会话追溯：每次技能更新都能找到证据
"会话追溯"默认展示你的本地会话，可一键切换到"全部会话"或"共享会话"。每个会话可展开查看逐轮对话内容、关联的技能，以及它是否进入了候选池。当你在候选池里看到"这个技能依赖哪些会话证据"时，点进去就是这里的数据——形成从会话 → 候选 → 发布的完整可追溯链路。
看板背后：SQLite 快照 + FastAPI 轻量服务
Dashboard 的设计非常克制，值得了解它的原理：
- 快照投影：
skillclaw dashboard sync调用 dashboard_ingest.py 扫描本地技能目录、本地会话记录、共享存储和验证任务，把结果写入一个本地 SQLite 文件 - 面板服务：dashboard_server.py 用 FastAPI 提供 Web 界面与 REST API（如
/api/v1/skills、/api/v1/validation/jobs、/api/v1/sessions），面板前端就是 dashboard_assets/ 下的静态页面
好处是：面板打开快、查询快，且数据是"某一时刻的快照"，即使共享存储暂时不可用，你仍能看到最近一次同步的结果。面板界面源码可以从 index.html 查看。
进阶玩法：在面板里手动评审与触发演化
Dashboard 不只是"看"，还支持动手操作：
- 手动评审验证任务：对候选技能直接提交"通过/拒绝"及评分，评审结果会写回验证存储（接口见 dashboard_server.py），达到阈值后自动进入发布流程
- 触发演化：在面板中手动触发一次演化周期，让服务器立即消费新会话、更新技能，适合想"马上看到效果"的场景
- 技能推拉：面板内可以直接执行 pull / push / sync，把共享技能拉到本地或把本地技能推上去
这些操作都复用你现有的共享配置（OSS / S3 / 本地目录），无需额外部署。
新手常见问题速查
Q：Dashboard 和skillclaw status有什么区别？status看进程是否存活；Dashboard 看"数据"——技能、版本、验证、会话的全貌。
Q：只想单机自用，能开 Dashboard 吗？可以。开启本地共享存储（如~/.skillclaw/local-share）后，sync会同时纳入本地与共享数据；纯单机也可只看本地技能与本地会话。
Q：面板数据不是最新的怎么办？点页面右上角"刷新数据"重新拉 API，或执行skillclaw dashboard sync重建快照。
Q：端口被占用了？用skillclaw dashboard serve --port 3791换一个端口即可。
SkillClaw Dashboard 把"技能从哪来、现在到哪一步、将来往哪走"变成了可见、可查、可操作的事。装好 SkillClaw 之后，花一分钟跑一次dashboard serve，你的技能演化之旅就有了仪表盘。
【免费下载链接】SkillClawLet Skills Evolve Collectively with Agentic Evolver项目地址: https://gitcode.com/gh_mirrors/sk/SkillClaw
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
