工作室插件

文档 社区

技能解读

当前原文的自动摘译,尚未人工审校。

产品语言(请勿混淆)

Studio AI 助手 — Studio 中面向产品的助手(助手、表单控制、可选的自主运行)。在面向作者的副本和文档中更喜欢这一点。两种交付模式 - (1) 交互式聊天 - 作者驱动每个回合(助手、表单引擎控制、预览/XB、可选的 TinyMCE)。 (2) 自主助手(实验性)——AutonomousAssistants工具面板小部件运行预定的服务器端步骤;参见docs/internals/spec.md。

规范的本地政策(首先阅读)

.cursor/rules/ — 项目规则(通常是alwaysApply: true)。他们推翻了随意的假设。 crafterq-form-panel-contract.mdc — 表单引擎助手:config.properties的代理可见性,AiAssistantFormControlPanel.tsx中的手风琴式面板,同步sources/control/ai-assistant/main.js副本,TS或React更改后的yarn package。 no-unauthorized-ui-changes.mdc — 不要更改可见的 UI 或 UX 或交互,除非用户在同一任务中明确请求;功能工作默认为仅布线、API、服务器、类型和构建。

文档地图

docs/using-and-extending/installation.md — 安装插件(Studio UI、CLI、Marketplace copy、安装前构建)。 docs/using-and-extending/configuration-guide.md — 管理员配置站点:ui.xml、插件 ID、代理、密钥、§1e studio-ui.json + 项目工具 UI、表单。截图:主播#cg-screenshots。 docs/README.md - 文档索引(使用和扩展与内部)。 docs/using-and-extending/product-requirements.md — 产品义务(作者、管理员、集成商);在spec.md和链接指南中连接和构建合同。

机械检查表(非 UI 更改)

表单控件main.js:仅编辑sources/control/ai-assistant/main.js。 Rollup yarn package 将其复制到authoring/static-assets/plugins/.../studio/control/ai-assistant/main.js。仅编辑 authoring/... 副本会在下一个包中被覆盖 - 该模式使修复“消失”。 TS/React 更改后:从 sources/ 运行 yarn package;不要手动编辑authoring/.../aiassistant/components/index.js(生成的包)。

不

在没有明确维护者请求的情况下重新设计表单助手面板、手风琴行或共享聊天位置(请参阅规则)。将 cqVisibleAgentsFromProperties 或属性包接线替换为快捷方式,当 Studio 发送松散的属性值时,这些快捷方式会过滤掉所有代理。来源:craftercms/ai-assistant-plugin — 由 TomeVault 分发。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
文档
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# AI Assistant Studio plugin (this repository)

Use this skill when editing **this repo**: `plugin-studio-crafterq` — Studio plugin (React bundle, form control `main.js`, server scripts, `authoring/static-assets`).

## Product language (do not conflate)

- **Studio AI assistant** — The product-facing assistant in Studio (Helper, form control, optional autonomous runs). Prefer this in **author-facing** copy and docs.
- **Two delivery modes** — **(1) Interactive chat** — authors drive each turn (Helper, form-engine control, preview/XB, optional TinyMCE). **(2) Autonomous assistants (experimental)** — the **`AutonomousAssistants`** Tools Panel widget runs **scheduled** server-side steps; see **`docs/internals/spec.md`**.
- **CrafterQ** — The **CrafterQ API / SaaS integration** when an agent uses **`llm: crafterQ`**. It is a **tool/backend**, not the name of the whole assistant. **`openAI`** is another tool on the same assistant.

## Canonical local policy (read first)

1. **`.cursor/rules/`** — Project rules (often `alwaysApply: true`). They override casual assumptions.
   - **`crafterq-form-panel-contract.mdc`** — Form Engine assistant: agent visibility from `config.properties`, accordion-style panel in `AiAssistantFormControlPanel.tsx`, sync `sources/control/ai-assistant/main.js` copies, `yarn package` after TS or React changes.
   - **`no-unauthorized-ui-changes.mdc`** — Do not change visible UI or UX or interaction unless the user explicitly requests it in the same task; feature work defaults to wiring, API, server, types, and build only.

2. **`.cursor/skills/`** — Other Cursor skills for this repo. Prefer extending **this** skill when guidance applies repo-wide.

## Documentation map

- **`docs/using-and-extending/installation.md`** — Install the plugin (Studio UI, CLI, Marketplace **`copy`**, build-before-install).
- **`docs/using-and-extending/configuration-guide.md`** — Admins configure a site: `ui.xml`, plugin id, agents, keys, **`§1e`** **`studio-ui.json`** + Project Tools UI, forms. **Screenshots:** anchor **`#cg-screenshots`**.
- **`docs/README.md`** — Documentation index (**using & extending** vs **internals**).
- **`docs/using-and-extending/product-requirements.md`** — Product obligations (authors, admins, integrators); wire and build contracts live in **`spec.md`** and linked guides.
- **`docs/internals/spec.md`** — **Official** product requirements & mechanics; update when behavior or contracts change. **Studio UI flags:** anchor **`#studio-ui-flags-studio-uijson`** (`studio-ui.json`, Project Tools).
- **`docs/using-and-extending/`** — **`llm-configuration.md`**, **`studio-plugins-guide.md`**, **`README.md`** (`user-tools/`, script LLM paths, other guides).
- **`docs/internals/`** — Maintainers: **`docs/internals/README.md`**, **`docs/internals/spec.md`**, **`docs/internals/stream-endpoint-design.md`**, MCP client notes in **`chat-and-tools-runtime.md`**.

## Mechanical checklist (non-UI changes)

- **Form control `main.js`:** Edit **`sources/control/ai-assistant/main.js` only**. Rollup **`yarn package`** copies it into **`authoring/static-assets/plugins/.../studio/control/ai-assistant/main.js`**. Editing only the `authoring/...` copy is overwritten on the next package — that pattern makes fixes “disappear.”
- After TS/React changes: run **`yarn package`** from **`sources/`**; do not hand-edit **`authoring/.../aiassistant/components/index.js`** (generated bundle).
- After edits to `sources/src` form or chat bundle: run **`yarn package`** from `sources/`.
- If behavior or API visible to authors changes: update **`docs/internals/spec.md`** (and **`README.md`** / **`docs/using-and-extending/studio-plugins-guide.md`** when install or `ui.xml` contracts change; **this skill** or **`.cursor/rules/`** when contributor-only policy changes).

## Do not

- Redesign the form assistant panel, accordion rows, or shared chat placement without explicit maintainer request (see rules).
- Replace `cqVisibleAgentsFromProperties` or property-bag wiring with shortcuts that filter all agents out when Studio sends loose property values.

---
> Source: [craftercms/ai-assistant-plugin](https://github.com/craftercms/ai-assistant-plugin) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。