Back to Details

openpress

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

OpenPress

OpenPress

Use this skill first for OpenPress CLI and delivery work.
处理OpenPress CLI和交付工作时，请优先使用此技能。

Route

路由

NeedSkill
Page artifact creation
openpress-create-pages
Slide creation or editing
openpress-create-slide
Authored-content analysis, proposal, or revision
openpress-collaborate
Pending 
@openpress-comment
markers
openpress-apply-comments
External plugins (diagrams, visual tools, writing helpers)
openpress-plugins
Package upgrade or migration
openpress-upgrade
Deploy or publish
openpress-deploy
Load portable language or genre skills only when the content requires them.
需求技能
页面制品创建
openpress-create-pages
幻灯片创建或编辑
openpress-create-slide
原创内容分析、提案或修订
openpress-collaborate
待处理的
@openpress-comment
标记
openpress-apply-comments
外部插件（图表、可视化工具、写作助手）
openpress-plugins
包升级或迁移
openpress-upgrade
部署或发布
openpress-deploy
仅当内容需要时，才加载可移植语言或类型技能。

Source Boundary

源边界

LayerPathsRule
Workspace source
press/*/press.tsx
, registered MDX/TSX sources, 
press/<slug>/{components,theme,media}/
, optional 
press/shared/
, 
press/design.md
, 
openpress/settings.json
editable
Skill source
skills/
, 
.agents/skills/
, 
.claude/skills/
editable for skill work
Framework source
packages/core/
, 
packages/cli/
, 
apps/web/
, root config/docs/tests		framework work only
Review handoff
.openpress/review/current.json
openpress-collaborate
may replace or delete; never deliver or commit
Installed framework
node_modules/@open-press/{core,cli}/
read-only; fix upstream
Generated/cache
public/openpress/
, 
dist-react/
, 
.deploy/
, other 
.openpress/
, 
.turbo/cache/
never hand-edit
openpress/settings.json
owns workspace Appearance, page defaults, caption numbering, PDF filename, and deploy configuration. Press visual design remains in 
press/design.md
and each Press theme.
If 
memory/AGENTS.md
exists, read it first; it identifies a downstream workspace and its project rules.
层级路径规则
工作区源
press/*/press.tsx
、已注册的MDX/TSX源、
press/<slug>/{components,theme,media}/
、可选的
press/shared/
、
press/design.md
、
openpress/settings.json
可编辑
技能源
skills/
、
.agents/skills/
、
.claude/skills/
仅技能工作可编辑
框架源
packages/core/
、
packages/cli/
、
apps/web/
、根目录配置/文档/测试		仅框架工作可编辑
审核交接
.openpress/review/current.json
openpress-collaborate
可替换或删除；禁止交付或提交
已安装框架
node_modules/@open-press/{core,cli}/
只读；需修复上游问题
生成/缓存
public/openpress/
、
dist-react/
、
.deploy/
、其他
.openpress/
、
.turbo/cache/
禁止手动编辑
openpress/settings.json
管理工作区外观、页面默认值、标题编号、PDF文件名和部署配置。Press视觉设计保存在
press/design.md
和各个Press主题中。
如果存在
memory/AGENTS.md
，请先阅读它；它会指明下游工作区及其项目规则。

Local Review Gate

本地审核关卡

After content, layout, component, Press Tree, or pagination-sensitive theme changes:
bash
npm run build
npm run dev              # downstream workspace
在内容、布局、组件、Press Tree或分页敏感主题变更后：
bash
npm run build
npm run dev              # 下游工作区

npm run dev:workspace # framework dogfood repo

npm run dev:workspace # 框架内部测试仓库


Open Vite's `/workspace` and inspect the affected Press for page count,
overflow/cropping, pagination, typography/media, and pending comments. Fix
source and repeat when needed.

Export only a requested delivery format, after local Workbench review:

```bash
npm run openpress:pdf
npm run openpress:image
npm run openpress:word
PDF/image/Word export does not replace Workbench review.

打开Vite的`/workspace`，检查受影响的Press的页面数量、溢出/裁剪、分页、排版/媒体以及待处理评论。如有需要，修复源文件并重复此步骤。

仅在本地Workbench审核后，导出请求的交付格式：

```bash
npm run openpress:pdf
npm run openpress:image
npm run openpress:word
PDF/图片/Word导出不能替代Workbench审核。

Refresh Boundary

刷新边界

Vite HMR does not regenerate 
public/openpress/<slug>/document.json
. After MDX, Press Tree, component, metadata, or pagination-sensitive theme edits, run 
npm run build
before reviewing. For a faster inner loop, run 
open-press export .
and refresh the browser. Pure CSS edits that do not move content may use HMR alone.
Vite HMR不会重新生成
public/openpress/<slug>/document.json
。在MDX、Press Tree、组件、元数据或分页敏感主题编辑后，需先运行
npm run build
再进行审核。为了更快的内部循环，运行
open-press export .
并刷新浏览器。不涉及内容移动的纯CSS编辑可仅使用HMR。

CLI And References

CLI与参考资料

  • Prefer package scripts. Downstream commands without a wrapper use 
    open-press
    ; the framework repo uses 
    node packages/core/engine/cli.mjs
    because its binary is not built locally.
  • Read 
    references/cli-commands.md
    only for commands not shown above, source search/replace, inspect, or nonstandard verification depth.
  • Read 
    references/local-review.md
    whenever the review gate applies or Workbench controls are needed.
  • Read 
    references/render-boundary.md
    only for framework work that changes the Press Tree/runtime contract, not ordinary workspace authoring.
  • New artifacts are owned by 
    openpress-create-pages
    or 
    openpress-create-slide
    ; do not use create commands as upgrade tools.
  • 优先使用包脚本。无包装器的下游命令使用
    open-press
    ；框架仓库使用
    node packages/core/engine/cli.mjs
    ，因为其二进制文件未在本地构建。
  • 仅当上述未列出命令、需要源文件搜索/替换、检查或非标准验证深度时，才阅读
    references/cli-commands.md
    。
  • 每当审核关卡适用或需要Workbench控件时，阅读
    references/local-review.md
    。
  • 仅当框架工作涉及更改Press Tree/运行时契约时，才阅读
    references/render-boundary.md
    ，普通工作区创作无需阅读。
  • 新制品由
    openpress-create-pages
    或
    openpress-create-slide
    负责；请勿将创建命令用作升级工具。