工作室插件
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 文档
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# 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 -->
章节与文件索引
按说明文件中的顺序排列。
产品语言(请勿混淆)
规范的本地政策(首先阅读)
文档地图
机械检查表(非 UI 更改)
不
文件/命令 -> plugin-studio-crafterq · main.js · authoring/static-assets · AutonomousAssistants · docs/internals/spec.md · llm: crafterQ · openAI · .cursor/rules/
内容校验值 -> f29b6ae2007f
当前原文的自动摘译,尚未人工审校。
产品语言(请勿混淆)
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、Marketplacecopy、安装前构建)。docs/using-and-extending/configuration-guide.md— 管理员配置站点:ui.xml、插件 ID、代理、密钥、§1estudio-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。 Rollupyarn 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 分发。