所有命令 · evidence
pm item files
Manage files linked to an item.
Associates changed source files with tracker items for reproducibility.
用法
pm item files [options] [command] <id>参数
| <id> | Item id | 必填 |
|---|
选项
| --add <value> | Add linked file entry (CSV/markdown pairs or - for stdin) | 可选 |
|---|---|---|
| --add-glob <value> | Add linked file entries from a glob (plain glob or pattern=<glob>,scope=<scope>,note=<text>; repeatable) | 可选 |
| --remove <value> | Remove linked file by path only (path=<value>, path:<value>, plain path, or - for stdin); does not accept note=/scope= — record removal context with --message | 可选 |
| --migrate <value> | Migrate linked file paths in-place (from=<prefix>,to=<prefix>; repeatable) | 可选 |
| --note <value> | Note attached to every link added by --add/--add-glob in this invocation (embedded note= wins) | 可选 |
| --list | List linked files without mutating | 可选 |
| --append-stable | Preserve existing linked-file order and append new links without full-array resorting | 可选 |
| --validate-paths | Validate linked file paths for existence and file shape | 可选 |
| --author <value> | Mutation author | 可选 |
| --message <value> | History message | 可选 |
| --force | Force ownership override | 可选 |
示例
pm item files pm-a1b2 --add "path=src/cli/main.ts,note=help orchestration"