@samp3ng/aster-plugin-kanban

协同看板插件 MVP。Aster 通过 kanban_* 和 org_* 工具调用看板兼容 API，完成组织、邀请码、成员、任务、进度、共享文件元数据和周报。

Kanban 是独立可选插件，不属于 @samp3ng/aster-web。用户安装并在 plugins.installed[] 中启用后，通用 Aster agent 才会获得这些工具。插件包同时携带独立 Web 界面，通过 aster-kanban-web 启动。

默认 API 地址：https://kb.xhopc.com/api。这对应线上汇总看板服务;本地开发要连本机 API 时再显式覆盖。

安装

pnpm add @samp3ng/aster-plugin-kanban
aster plugins install kanban --package @samp3ng/aster-plugin-kanban --enabled

本地 Aster 连接服务器端看板时,在插件配置里写:

plugins:
  installed:
    - name: kanban
      packageName: "@samp3ng/aster-plugin-kanban"
      enabled: true
      config:
        baseUrl: "https://kb.xhopc.com/api"

baseUrl 指向线上 aster-kanban web 的 /api。如果服务端开启 Bearer token,再补 authToken,插件会自动发送 Authorization: Bearer ...。

Web 界面

启动插件自带界面。默认本地页面写入线上 https://kb.xhopc.com/api,“汇总看板”按钮打开线上 https://kb.xhopc.com/：

aster-kanban-web --port 8788 --open

如果开发时要连本机平台 API：

aster-kanban-web --base-url http://127.0.0.1:8797/api --summary-url https://kb.xhopc.com/ --port 8788 --open

Web 界面由 @samp3ng/aster-plugin-kanban 提供。/ 是用户本地个人每周工作看板；/api/* 代理到配置的看板 API；点击“汇总本周”会先读取当前用户在 https://kb.xhopc.com/api 已加入的线上组织，用户选择组织或输入邀请码加入后，再通过 /summary-api/* 同步当前周项目、计划和每日工作，并跳转到 https://kb.xhopc.com/?org=<orgId>&token=<token>。

当前线上部署方式见 docs/ASTER_KANBAN_DEPLOYMENT.md: aster-kanban web 通过 systemd 运行在 127.0.0.1:8788,nginx 反代到 https://kb.xhopc.com/。

工具

• kanban_personal_board
• kanban_create_personal_task
• kanban_record_personal_progress
• org_create
• org_join
• org_invite_code
• org_members
• org_member_upsert
• kanban_create_task
• kanban_list_tasks
• kanban_update_task
• kanban_update_progress
• kanban_upload_file
• kanban_list_files
• kanban_weekly_summary
• kanban_stats

写操作默认 dry-run，传 confirm:true 后执行。