Vyane 功能
board
读写爟（Beacon）任务账本
vyane board 用来看和改爟（Beacon）任务账本。爟记下任务、决定和证据；这块命令是它在偃里的读写入口。board 命令、MCP 工具、HTTP API 三种入口共用同一套后端。
现行 authority 模式以服务端数据库为真值源，Git 只是投影。旧的 legacy 路径把 Git 仓里的结构化文件当真值源；未单独打开 authority 时，代码仍走这条路径。authority 不可用时，写入直接失败，不会自动退回 Git。另有只读的 shadow 模式，写操作会被拒绝。
常用子命令
# 看板列表(只看自己名下的)
uv run vyane board status --mine
# 看单张卡详情
uv run vyane board show ISSUE-42
# 认领一张卡(标记为进行中)
uv run vyane board take ISSUE-42
# 追加一条进展日志(日志内容用 --m)
uv run vyane board log ISSUE-42 --m "已完成鉴权层重构"
# 标记完成(可选 --m 附收尾说明)
uv run vyane board done ISSUE-42 --m "auth 模块重构完毕并通过测试"
# 新建一张卡(标题是位置参数,不加 --title)
uv run vyane board new "接入新的 provider" --project CORE子命令速查
| 子命令 | 作用 |
|---|---|
status | 列出卡片(可按状态 / 项目 / 归属过滤) |
show | 看单张卡详情 |
take | 认领卡片 |
log | 追加进展日志 |
done | 标记完成 |
drop | 放弃,退回待办 |
cancel | 取消卡片 |
new | 新建卡片 |
render | 预览 / 写出 BOARD.md、board.json 等看板产物 |
三种入口
⌨️
CLI
uv run vyane board ...
🔌
MCP
vyane_board_status 等工具,给 Claude Code / Codex 调用。
🌐
HTTP API
daemon 暴露的 /api/board/write 等,给 dashboard / 外部集成用。
Git 提交只在 legacy
只有 legacy 路径里，写操作（take / log / done / new）默认会提交并推送 Git。不想推送，加 --no-push。
authority 模式写入服务端数据库；这次写入不提交、不推送 Git。
想只预览不动手，--dry-run 目前只有 board render 支持。