命令索引

Seed 建议用根目录命令面板统一入口。先查看：

npm run scripts:help

如果项目没有启用 npm 面板，可以直接运行 ops/scripts/ 下对应脚本。

本地开发

目标	命令
默认本地入口	npm run dev
启动前端	npm run client:dev
构建前端	npm run client:build
启动后端	npm run server:start
重启后端	npm run server:restart

测试

目标	命令
生成测试计划	npm run test:plan
执行测试套件	npm run test:run
直接调用测试脚本	python3 ops/scripts/run-project-tests.py --format json

配置读取

目标	命令
合并配置域	npm run config:merge -- components --format json
读取配置键	npm run config:get -- components components.0.key --format text
读取逻辑 key	npm run key:get -- module.dossier --module-key <module-key> --format text

文档和元数据

目标	命令
提取项目元数据	npm run metadata:extract
提取 Markdown 元数据	npm run metadata:extract:markdown
提取文档索引	npm run docs:index
写入文档索引	npm run docs:index:write
查看最近会话概要	npm run session:recent

检查

目标	命令
常用检查组合	npm run check:all
模块档案	npm run check:template-module-docs
技术地图	npm run check:technical-map
仓库身份	npm run check:repository-identity
项目健康	npm run check:project-health-context
文档读契约	npm run check:doc-read-contract
脚本规范	npm run check:ai-python-script-contract
本机边界	npm run check:local-boundary
开源就绪	npm run ops:check-seed-open-source-readiness

任务包

目标	命令
下载任务包	npm run taskpack:download -- <url>
检查任务包结构	先校验 manifest.json、EXECUTE_PROMPT.md、PLAN.md、SESSION_STATE.md。
恢复任务	从 SESSION_STATE.md 读取下一步。

公开任务包不要在命令中写一次性 token 或访问密码。

公开发布和镜像计划

目标	命令
查看公开发布计划	npm run publish-mirror:plan
执行公开发布	npm run publish-mirror:publish -- --execute
查看仓库镜像计划	npm run mirror:plan
推送仓库镜像	npm run mirror:push

公开发布写入前必须先看计划，并通过脱敏和 open-source readiness 检查。

交付导出

目标	命令
脱敏包	npm run delivery:desensitize
导出交付包	npm run delivery:package
检查 code-only 交付	npm run delivery:code:check
code-only dry-run	npm run delivery:code:export:dry-run

风险标记

命令面板会尽量标记风险类型：

• read-only：只读检查或计划。
• local-runtime：启动本地服务。
• build：生成构建产物。
• writes-artifacts：写过程记录。
• remote-write：可能写远端，必须人工确认。

下一步

阅读 快捷脚本入口，查看更具体的脚本用法。