Dessix Skill
Call the local Dessix bridge directly through a line-delimited JSON socket protocol.
Use scripts/dessix-bridge.mjs for all requests instead of re-implementing socket logic.
Workflow
- 1. (Optional) Locate bundled MCP script path dynamically:
CODEBLOCK0
- 2. Verify the bridge is reachable:
CODEBLOCK1
- 3. List workspaces:
CODEBLOCK2
- 4. Call target tool with JSON args:
CODEBLOCK3
- 5. Read a Skill prompt from an Action/Scene block:
CODEBLOCK4
Notes
- - Start Dessix desktop app first. The bridge is served by the Electron app process.
- To discover bundled MCP script path at runtime, use
node scripts/dessix-bridge.mjs locate-mcp-script.
- Override auto-detection with
DESSIX_MCP_SCRIPT_PATH (or
--mcpScriptPath <path>).
- Current built-in candidates include:
- macOS:
/Applications/Dessix.app/Contents/Resources/electron/compiled/dessix-mcp.js
- Windows:
%LOCALAPPDATA%\\Programs\\Dessix\\resources\\electron\\compiled\\dessix-mcp.js
- - If
DESSIX_MCP_BRIDGE_ENDPOINT is unset, this bridge client uses platform endpoint defaults:
- macOS/Linux:
~/.dessix/mcp/dessix-mcp-bridge.sock
- Windows:
\\\\.\\pipe\\dessix-mcp-bridge
- - Use compact JSON for
--args. Invalid JSON fails fast. - Read
references/dessix-tools.md for tool names and argument templates.
Multi-Step Workflows
Combine tools to achieve higher-level goals. Validate outputs before any write.
Skill Discovery
Build a skill map for the current workspace (read-only):
CODEBLOCK5
Topic to Skill Draft
Turn a discussion thread into a reusable Action/Scene block:
CODEBLOCK6
Skill Maintenance
Find and refresh stale skill blocks:
CODEBLOCK7
Safety
- - Run read-only workflows first; escalate to writes only after validating
block_id and result counts. - Compact JSON only for
--args.
Dessix 技能
通过基于行分隔的 JSON 套接字协议直接调用本地 Dessix 桥接服务。
所有请求请使用 scripts/dessix-bridge.mjs,无需重新实现套接字逻辑。
工作流程
- 1. (可选)动态定位捆绑的 MCP 脚本路径:
bash
node scripts/dessix-bridge.mjs locate-mcp-script
- 2. 验证桥接服务是否可访问:
bash
node scripts/dessix-bridge.mjs health
- 3. 列出工作区:
bash
node scripts/dessix-bridge.mjs invoke \
--tool dessixlistworkspaces \
--args {}
- 4. 使用 JSON 参数调用目标工具:
bash
node scripts/dessix-bridge.mjs invoke \
--tool dessixsearchblocks \
--args {query:MCP,limit:10}
- 5. 从 Action/Scene 块中读取技能提示:
bash
node scripts/dessix-bridge.mjs invoke \
--tool dessixgetskill \
--args {blockid:ID>}
注意事项
- - 请先启动 Dessix 桌面应用。桥接服务由 Electron 应用进程提供。
- 要在运行时发现捆绑的 MCP 脚本路径,请使用 node scripts/dessix-bridge.mjs locate-mcp-script。
- 可通过 DESSIX
MCPSCRIPT_PATH(或 --mcpScriptPath
)覆盖自动检测。
- 当前内置候选路径包括:
- macOS:/Applications/Dessix.app/Contents/Resources/electron/compiled/dessix-mcp.js
- Windows:%LOCALAPPDATA%\\Programs\\Dessix\\resources\\electron\\compiled\\dessix-mcp.js
- - 如果未设置 DESSIXMCPBRIDGE_ENDPOINT,此桥接客户端将使用平台默认端点:
- macOS/Linux:~/.dessix/mcp/dessix-mcp-bridge.sock
- Windows:\\\\.\\pipe\\dessix-mcp-bridge
- - 使用紧凑 JSON 格式传递 --args。无效 JSON 将快速失败。
- 请阅读 references/dessix-tools.md 获取工具名称和参数模板。
多步骤工作流程
组合多个工具以实现更高级别的目标。在执行任何写入操作前验证输出。
技能发现
为当前工作区构建技能映射(只读):
bash
node scripts/dessix-bridge.mjs invoke --tool dessixgetcurrent_workspace --args {}
node scripts/dessix-bridge.mjs invoke --tool dessixsearchblocks --args {types:[Action,Scene],limit:100}
对结果中的每个 block_id:
node scripts/dessix-bridge.mjs invoke --tool dessixgetskill --args {blockid:ID>}
从话题到技能草稿
将讨论线程转化为可复用的 Action/Scene 块:
bash
node scripts/dessix-bridge.mjs invoke --tool dessixgettopiccontext --args {topicid:BLOCK
ID>}
node scripts/dessix-bridge.mjs invoke --tool dessixsearchblocks --args {semantic:related skills and constraints,limit:20}
从合并的上下文中起草标题+内容,然后:
node scripts/dessix-bridge.mjs invoke --tool dessixcreateblock --args {patch:{type:Action,title:,content:}}
技能维护
查找并刷新过时的技能块:
bash
node scripts/dessix-bridge.mjs invoke --tool dessixsearchblocks --args {query:skill,types:[Action,Scene],limit:50}
node scripts/dessix-bridge.mjs invoke --tool dessixreadblock --args {blockid:ID>}
比较当前状态,然后修补:
node scripts/dessix-bridge.mjs invoke --tool dessixupdateblock --args {blockid:ID>,patch:{title:,content:}}
安全须知
- - 先执行只读工作流程;仅在验证 block_id 和结果计数后再升级到写入操作。
- --args 仅使用紧凑 JSON 格式。