mirror of
https://github.com/modelstudioai/cli.git
synced 2026-09-14 19:49:23 +08:00
inhai
9ab5de8c2e
- Add Skills / MCP / Agents / Assets inventory views with click-to-open right-side detail drawers (reusable infoDrawer) - Render SKILL.md as Markdown via a self-contained, XSS-safe inline renderer (HTML-escape first, strip YAML frontmatter, no external deps) - Add local vs remote origin badges to Skills and MCP items - Add quick-launch for coding agents (allowlisted id->binary, execFile, no shell); gate the button on Connected AND the CLI binary being on PATH - Add per-category model catalog surfaced as click-to-fill suggestion chips under each default_*_model field, sourced from real bl pipeline model names - Add assets browser (categorized, time-sorted) with preview, open-locally and delete, backed by path-traversal-guarded file serving - Convert Profiles to a tile grid with an add-tile and design-consistent new-profile modal; make view headers sticky and use drawers for editing - Tests for inventory, agent-launch, assets and config-ui endpoints
79 lines
5.6 KiB
Markdown
79 lines
5.6 KiB
Markdown
# Config Profile 与激活状态变更清单
|
||
|
||
适用于新增 Profile 预设、修改命名 Profile 选择规则、调整 `active_config`，或新增/修改 `bl config list/use/show/ui` 等 Profile 管理能力。
|
||
|
||
## 1. 保持存储边界
|
||
|
||
- Profile 业务字段继续由 `ConfigFile` / `CONFIG_FILE_KEYS` 管理。
|
||
- `active_config` 是 `config.json` 顶层元数据，不得进入命名 Profile block，也不得被 `config set` 当作普通字段写入。
|
||
- 识别命名 Profile 时必须排除业务字段和顶层元数据。
|
||
- 旧配置缺少 `active_config` 时继续等价于激活 `default`。
|
||
|
||
## 2. 保持选择语义
|
||
|
||
```text
|
||
显式 --config <name> > active_config > default
|
||
```
|
||
|
||
- 解析阶段用局部变量保留“是否显式传入 `--config`”的信息；完成 Config 选择后不进入 `Settings`。
|
||
- `--config default` 必须显式选择顶层配置并绕过命名激活项。
|
||
- 普通命令的显式 `--config` 只覆盖本次选择，不修改持久化激活状态；例外是
|
||
`auth login --config ...`，凭证验证并落盘成功后自动激活该 Profile。
|
||
- 激活状态只选择配置 block，不改变字段优先级；字段仍为 flag > env > selected config > 默认值。
|
||
- Pipeline 等进程内调用链也要复用统一的 `buildSources()`，避免绕过激活状态。
|
||
- Console access token 自动刷新等后台读写必须携带 `settings.configName`，不得直接读写顶层 default。
|
||
|
||
## 3. 保持读写命令交互一致
|
||
|
||
- `auth login`、`config set` 等写命令未传 `--config` 时修改当前激活项。
|
||
- `auth login --config <name>` 显式指定不存在的 Profile 时，仅在凭证验证成功并实际落盘时
|
||
创建和激活；`config set --config <name>` 可创建但不自动激活。
|
||
- `config show`、`auth status` 和业务消费等读命令不得因为显式指定不存在的名称而创建 Profile。
|
||
- `auth logout` 默认只清理当前激活项；显式 `--config` 只清理指定项。
|
||
- 按凭证域退出时必须清理该域的完整字段集合，例如 OpenAPI 同时清理 AK、SK 和 STS `security_token`。
|
||
- 所有生产代码读取“当前配置”时优先经过 `buildSources()` 或携带解析后的 `configName`；直接调用无名称的 `readConfigFile()` / `writeConfigFile()` 只适用于明确操作顶层 default 的底层能力。
|
||
|
||
## 4. 保持状态一致性
|
||
|
||
- `config use` 只能激活已经存在的命名 Profile；`default` 始终有效。
|
||
- 配置文件中的 `active_config` 指向不存在的 Profile 时返回 usage error，不静默回退。
|
||
- 删除当前激活的命名 Profile 时，同一次落盘切回 `default`，不得留下悬空引用。
|
||
- 配置写入继续使用临时文件 + rename，避免中断后留下半写文件。
|
||
|
||
## 5. 命令与展示联动
|
||
|
||
- 新增/重命名命令时同步 `packages/commands/src/index.ts` 和产品入口 `packages/cli/src/commands.ts`。
|
||
- `config list` 标识所有 Profile 与当前激活项。
|
||
- `config show`、`auth status` 只输出本次最终选择的 `config` 和 `config_file`，不重复携带激活状态。
|
||
- `config ui` 从持久化元数据读取激活项，提供显式激活操作，并在删除激活项后刷新为 `default`。
|
||
- `config ui` 展示并可编辑完整 `ConfigFile`（含 `console_*`、`telemetry`），保存时按类型（数字/布尔/枚举）归一化写回；`config set` 仍只暴露较窄的 `VALID_KEYS`。UI 未管理的顶层元数据（如 `active_config`）不进入 Profile block，仍由写盘逻辑单独保留。
|
||
- `config ui` 只读展示本地 agent 生态：Skills 跨全部 agent skill 目录（`~/.agents/skills` 及各 agent 的 `skills/`，含软链接）按 id 聚合并标注安装来源；MCP、Agents 从各 agent 本地配置读取。
|
||
- `config ui` 提供 Assets 资产管理：扫描 `output_dir`（默认 `~/bailian-output`）下的 `images/videos/speech/omni` 分类及根目录散落文件，按分类与生成时间（mtime）标记，支持按分类筛选、内联预览（图/视频/音频）与删除单个文件；文件读取与删除均通过限定在输出目录内的路径校验（防目录穿越）。
|
||
- 同步 E2E topic routes、Skill setup 和自动生成 reference。
|
||
|
||
## 6. 最小测试矩阵
|
||
|
||
- 旧配置无 `active_config` -> `default`。
|
||
- 激活命名 Profile 后，无 `--config` 的命令选择该 Profile。
|
||
- 显式命名 `--config` 和 `--config default` 均覆盖激活项且不修改磁盘状态。
|
||
- 激活不存在的 Profile 失败且不写盘。
|
||
- 悬空 `active_config` 明确失败。
|
||
- 删除激活 Profile 后切回 `default`。
|
||
- 登录、退出、`config set` 分别覆盖“当前激活项”和“显式不存在名称成功后创建”。
|
||
- 显式 `auth login --config <name>` 成功后激活该 Profile，失败或 dry-run 不创建、不切换；
|
||
`--config default` 成功后切回 `default`。
|
||
- Console token 自动刷新不从其他 Profile 借用 AK/SK，也不把新 token 写入其他 Profile。
|
||
- `config list/show/use/ui`、`auth status` 和依赖默认模型的消费命令覆盖对应 E2E。
|
||
- `config ui` 覆盖保存时保留顶层元数据（如 `active_config`），继续允许空值清除字段，并覆盖 `console_*`/`telemetry` 的类型归一化与枚举校验。
|
||
- Assets:`listAssets` 覆盖分类归类、时间倒序、目录缺失返回空；`resolveAssetPath` 覆盖目录穿越拦截;`contentType` 覆盖常见扩展名映射。
|
||
|
||
## 7. 完成检查
|
||
|
||
```sh
|
||
pnpm run sync:skill-assets
|
||
vp check
|
||
vp test
|
||
```
|
||
|
||
命令 E2E 会启动本地子进程，Config UI 测试还会监听 `127.0.0.1` 临时端口；受限沙箱内出现 `EPERM` 时，需要在允许本地进程和端口的环境中复跑。
|