# myboard

**Repository Path**: larntin/myboard

## Basic Information

- **Project Name**: myboard
- **Description**: 个人工作台方案
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-22
- **Last Updated**: 2026-09-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 一人公司驾驶舱

本地运行的个人工作台：按项目组织时间线、专家会话和定时采集任务；专家基于上游 Skill 原文给出有依据的建议，采集任务定时读取数据并在被纠正后自我改进。

产品定位与决策见 [docs/000_index.md](./docs/000_index.md)。

## 运行

需要 Node.js 24 和 git。模型提供商在设置页添加（只填接口地址和 Key，例如火山方舟 Agent Plan 的 `https://ark.cn-beijing.volces.com/api/plan/v3`）；第一次启动时会自动导入本机 Pi（`~/.pi/agent`）已有的凭证。模型在会话输入框里选，默认 Auto。采集任务要读已登录的网站时，需要以 `--remote-debugging-port=9224` 启动 Chrome（端口可在「专家 · MCP」页编辑 chrome-devtools 一项）。

- 安装：`npm install`
- 开发：`npm run dev`，打开 http://127.0.0.1:8734
- 日常使用：`npm run build` 一次，之后 `npm start`，打开 http://127.0.0.1:8787
- 测试：`npm test`（单元与接口）、`npm run e2e`（浏览器冒烟，使用假模型）
- 不用真实模型试用：`WORKBENCH_FAUX=1 npm start`（在项目任务页点「新建第一个任务」，或输入框菜单里的「新建采集任务」，再发“新建示例任务”，可走完整任务流程）
- 真模型场景测试：`npm run scenarios`（会产生调用费用，见 docs/010）
- 同步专家上游 Skill（需联网）：`npm run experts:sync`

## 数据在哪里

- 业务数据：`data/workbench.db`（不进版本库；升级数据库结构前会自动备份为 `workbench.db.bak-v<版本>`）
- 专家与系统 Skill：`skills/`，专家结构见 [docs/003](./docs/003_专家Skill规范.md)、结构见 [docs/006](./docs/006_Harness与Skill架构.md)
- 各项目的资料（`README.md` 档案、`decisions.md`、`notes/`、`reviews/`，独立 git 仓库）、采集任务 Skill、会话记录：`data/projects/<英文名>/`，见 [docs/007](./docs/007_项目文本存储.md)（任务 Skill 目录是另一个独立 git 仓库）；不属于任何项目的会话（如周审）记录在 `data/global/sessions/`
- 模型提供商的 Key 与模型定义：`data/pi/`（工作台独占，不影响本机的 Pi）
- MCP 配置与 AI 自己写的 MCP 服务：`data/mcp/`（独立 git 仓库，AI 和「专家 · MCP」页都会改它），adapter 的缓存与 OAuth 在 `data/pi-agent/`，见 [docs/006](./docs/006_Harness与Skill架构.md)
- 知识库：登记的目录列表存在数据库；在知识库里删除的文件移到 `data/knowledge-trash/`（没有界面，需要时手动取回），见 [docs/008](./docs/008_知识库.md)

## 环境变量

| 变量 | 默认值 | 说明 |
|---|---|---|
| `PORT` | `8787` | 服务端口，只监听 127.0.0.1 |
| `WORKBENCH_DATA_DIR` | `data/` | 数据目录（数据库与上面列出的各子目录） |
| `WORKBENCH_SKILLS_DIR` | `skills/` | 全局 Skill 目录 |
| `WORKBENCH_PI_IMPORT_FROM` | `~/.pi/agent` | 第一次启动时从这里导入模型凭证（`data/pi/` 已存在就不再导入） |
| `WORKBENCH_FAUX` | 未设置 | 设为 `1` 时使用内置假模型，不调用真实模型 |
| `WORKBENCH_SCHEDULER` | 未设置 | 设为 `0` 时不自动定时运行任务（手动运行不受影响） |