@zhin.js/adapter-sandbox 1.0.22

package/CHANGELOG.md

@@ -0,0 +1,187 @@
+# @zhin.js/adapter-process
+
+## 1.0.22
+
+### Patch Changes
+
+- Updated dependencies [3bc5d56]
+  - @zhin.js/console@1.0.13
+  - zhin.js@1.0.17
+
+## 1.0.21
+
+### Patch Changes
+
+- zhin.js@1.0.16
+
+## 1.0.20
+
+### Patch Changes
+
+- f9e75ce: fix: 一致性调整,文档调整
+- f9e75ce: fix: recall,文档统一,mcp,githubnotifiy
+  - zhin.js@1.0.15
+
+## 1.0.19
+
+### Patch Changes
+
+- Updated dependencies [9bc8dc4]
+  - @zhin.js/console@1.0.12
+
+## 1.0.18
+
+### Patch Changes
+
+- Updated dependencies [8f75b7f]
+  - @zhin.js/console@1.0.11
+
+## 1.0.17
+
+### Patch Changes
+
+- f4a7dd7: fix: force build
+
+## 1.0.16
+
+### Patch Changes
+
+- 547028f: fix: 优化包结构,优化客户端支持
+- Updated dependencies [547028f]
+  - @zhin.js/console@1.0.10
+  - @zhin.js/types@1.0.5
+  - @zhin.js/http@1.0.7
+  - zhin.js@1.0.14
+
+## 1.0.15
+
+### Patch Changes
+
+- Updated dependencies [4034b94]
+  - @zhin.js/console@1.0.9
+  - zhin.js@1.0.13
+
+## 1.0.14
+
+### Patch Changes
+
+- zhin.js@1.0.12
+
+## 1.0.13
+
+### Patch Changes
+
+- zhin.js@1.0.11
+
+## 1.0.12
+
+### Patch Changes
+
+- Updated dependencies [c1a539e]
+- Updated dependencies [c8c3996]
+  - @zhin.js/console@1.0.8
+  - @zhin.js/types@1.0.4
+  - zhin.js@1.0.10
+
+## 1.0.11
+
+### Patch Changes
+
+- Updated dependencies [c490260]
+  - @zhin.js/console@1.0.7
+  - @zhin.js/client@1.0.5
+  - @zhin.js/http@1.0.6
+  - zhin.js@1.0.9
+
+## 1.0.10
+
+### Patch Changes
+
+- 551c4d2: fix: 插件支持配置文件读取,优化 test 用例
+- Updated dependencies [551c4d2]
+  - @zhin.js/console@1.0.6
+  - @zhin.js/types@1.0.3
+  - @zhin.js/client@1.0.4
+  - zhin.js@1.0.8
+  - @zhin.js/http@1.0.5
+
+## 1.0.9
+
+### Patch Changes
+
+- Updated dependencies [47845fb]
+  - @zhin.js/console@1.0.5
+  - zhin.js@1.0.7
+
+## 1.0.8
+
+### Patch Changes
+
+- Updated dependencies [c2d9047]
+- Updated dependencies [c2d9047]
+- Updated dependencies [b213bbc]
+  - @zhin.js/console@1.0.4
+  - @zhin.js/client@1.0.3
+  - @zhin.js/http@1.0.4
+  - zhin.js@1.0.6
+
+## 1.0.7
+
+### Patch Changes
+
+- Updated dependencies [5e2bddc]
+  - @zhin.js/console@1.0.3
+
+## 1.0.6
+
+### Patch Changes
+
+- f347667: fix: runtime error
+- Updated dependencies [f347667]
+  - @zhin.js/http@1.0.3
+  - zhin.js@1.0.5
+
+## 1.0.5
+
+### Patch Changes
+
+- Updated dependencies [d291005]
+  - @zhin.js/console@1.0.2
+  - @zhin.js/client@1.0.2
+  - @zhin.js/http@1.0.2
+
+## 1.0.4
+
+### Patch Changes
+
+- zhin.js@1.0.4
+
+## 1.0.3
+
+### Patch Changes
+
+- 727963c: fix: 修复 sqlite 数据错误;优化 console 展示
+- 89bc676: fix: 类型反射优化
+- Updated dependencies [727963c]
+- Updated dependencies [89bc676]
+  - @zhin.js/console@1.0.1
+  - @zhin.js/client@1.0.1
+  - @zhin.js/types@1.0.2
+  - zhin.js@1.0.3
+
+## 1.0.2
+
+### Patch Changes
+
+- Updated dependencies [15fc934]
+- Updated dependencies [3ecd487]
+  - @zhin.js/core@1.0.2
+
+## 1.0.1
+
+### Patch Changes
+
+- efdd58a: fix: init
+- Updated dependencies [efdd58a]
+  - @zhin.js/core@1.0.1
+  - @zhin.js/types@1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 凉菜
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# @zhin.js/adapter-process
+
+基于进程标准输入输出的 Zhin 机器人适配器，用于命令行环境下的测试和开发。
+
+## 功能特性
+
+- 🖥️ 命令行交互界面
+- ⌨️ 标准输入输出处理
+- 🧪 测试和开发友好
+- 📝 简单的消息格式
+- 🔄 实时消息处理
+
+## 安装
+
+```bash
+npm install @zhin.js/adapter-process
+```
+
+## 配置
+
+```javascript
+// zhin.config.ts
+export default {
+  bots: [
+    {
+      context: 'process',
+      name: 'console-bot', // 机器人名称
+    }
+  ]
+}
+```
+
+## 使用方式
+
+启动后，直接在命令行中输入消息即可：
+
+```bash
+$ npm run dev
+> 你好
+[Bot] 收到消息：你好
+[Bot] 回复：Hello World!
+```
+
+## 消息处理
+
+- 监听 `process.stdin` 输入
+- 将输入内容转换为标准消息格式
+- 消息发送只会在日志中显示，不会输出到终端
+
+## 消息格式
+
+消息对象包含：
+- `id`: 基于时间戳的消息ID
+- `sender.id`: 当前进程PID
+- `sender.name`: 进程标题
+- `channel.id`: 进程PID
+- `channel.type`: 固定为 'private'
+- `content`: 文本消息内容
+- `timestamp`: 消息时间戳
+
+## 适用场景
+
+- 🧪 插件开发测试
+- 🔍 功能调试
+- 📚 学习和演示
+- 🛠️ 开发环境验证
+
+## 依赖项
+
+- `zhin.js` - Zhin核心框架
+- Node.js 内置模块
+
+## 开发
+
+```bash
+npm run build  # 构建
+npm run clean  # 清理构建文件
+```
+
+## 注意事项
+
+- 此适配器仅用于开发和测试
+- 不支持图片、文件等复杂消息类型
+- 消息发送仅在日志中显示

package/client/RichTextEditor.tsx

@@ -0,0 +1,359 @@
+import { useRef, useEffect, forwardRef, useImperativeHandle } from 'react'
+
+export interface MessageSegment {
+    type: 'text' | 'at' | 'face' | 'image' | 'video' | 'audio' | 'file'
+    data: Record<string, any>
+}
+
+export interface RichTextEditorProps {
+    placeholder?: string
+    onSend?: (text: string, segments: MessageSegment[]) => void
+    onChange?: (text: string, segments: MessageSegment[]) => void
+    onAtTrigger?: (show: boolean, searchQuery: string, position?: { top: number; left: number }) => void
+    minHeight?: string
+    maxHeight?: string
+}
+
+export interface RichTextEditorRef {
+    focus: () => void
+    clear: () => void
+    insertFace: (faceId: number) => void
+    insertImage: (url: string) => void
+    insertAt: (name: string, id?: string) => void
+    replaceAtTrigger: (name: string, id?: string) => void
+    getContent: () => { text: string; segments: MessageSegment[] }
+}
+
+const RichTextEditor = forwardRef<RichTextEditorRef, RichTextEditorProps>(
+    ({ placeholder = '输入消息...', onSend, onChange, onAtTrigger, minHeight = '44px', maxHeight = '200px' }, ref) => {
+        const editorRef = useRef<HTMLDivElement>(null)
+        const atTriggerTextRef = useRef<Text | null>(null)
+
+        // 解析编辑器内容为文本和消息段
+        const parseEditorContent = (): { text: string; segments: MessageSegment[] } => {
+            if (!editorRef.current) return { text: '', segments: [] }
+
+            let text = ''
+            const segments: MessageSegment[] = []
+            const nodes = Array.from(editorRef.current.childNodes)
+
+            for (const node of nodes) {
+                if (node.nodeType === Node.TEXT_NODE) {
+                    const textContent = node.textContent || ''
+                    if (textContent) {
+                        text += textContent
+                        segments.push({ type: 'text', data: { text: textContent } })
+                    }
+                } else if (node.nodeType === Node.ELEMENT_NODE) {
+                    const el = node as HTMLElement
+
+                    if (el.classList.contains('editor-face')) {
+                        const faceId = el.dataset.id
+                        text += `[face:${faceId}]`
+                        segments.push({ type: 'face', data: { id: Number(faceId) } })
+                    } else if (el.classList.contains('editor-image')) {
+                        const imageUrl = el.dataset.url
+                        text += `[image:${imageUrl}]`
+                        segments.push({ type: 'image', data: { url: imageUrl } })
+                    } else if (el.classList.contains('editor-at')) {
+                        const name = el.dataset.name
+                        const id = el.dataset.id
+                        text += `[@${name}]`
+                        segments.push({ type: 'at', data: { name, qq: id } })
+                    } else if (el.tagName === 'BR') {
+                        text += '\n'
+                    }
+                }
+            }
+
+            return { text, segments }
+        }
+
+        // 插入表情
+        const insertFace = (faceId: number) => {
+            if (!editorRef.current) return
+
+            const img = document.createElement('img')
+            img.src = `https://face.viki.moe/apng/${faceId}.png`
+            img.alt = `[face:${faceId}]`
+            img.dataset.type = 'face'
+            img.dataset.id = String(faceId)
+            img.className = 'editor-face'
+
+            insertNodeAtCursor(img)
+            handleChange()
+        }
+
+        // 插入图片
+        const insertImage = (url: string) => {
+            if (!editorRef.current || !url.trim()) return
+
+            const img = document.createElement('img')
+            img.src = url.trim()
+            img.alt = `[image:${url.trim()}]`
+            img.dataset.type = 'image'
+            img.dataset.url = url.trim()
+            img.className = 'editor-image'
+
+            insertNodeAtCursor(img)
+            handleChange()
+        }
+
+        // 插入 @ 提及
+        const insertAt = (name: string, id?: string) => {
+            if (!editorRef.current || !name.trim()) return
+
+            // 创建 @ 标签容器
+            const atBox = document.createElement('span')
+            atBox.dataset.type = 'at'
+            atBox.dataset.name = name
+            if (id) atBox.dataset.id = id
+            atBox.className = 'editor-at'
+            atBox.contentEditable = 'false' // 不可编辑
+            
+            // 创建 @ 符号
+            const atSymbol = document.createElement('span')
+            atSymbol.textContent = '@'
+            atSymbol.className = 'editor-at-symbol'
+            
+            // 创建名称
+            const nameText = document.createElement('span')
+            nameText.textContent = name
+            nameText.className = 'editor-at-name'
+            
+            atBox.appendChild(atSymbol)
+            atBox.appendChild(nameText)
+
+            insertNodeAtCursor(atBox)
+            handleChange()
+        }
+
+        // 在光标位置插入节点
+        const insertNodeAtCursor = (node: Node) => {
+            if (!editorRef.current) return
+
+            // 先聚焦编辑器
+            editorRef.current.focus()
+            const selection = window.getSelection()
+            if (selection && selection.rangeCount > 0) {
+                const range = selection.getRangeAt(0)
+
+                // 检查光标是否在编辑器内部
+                const isInsideEditor = editorRef.current.contains(range.commonAncestorContainer)
+
+                if (isInsideEditor) {
+                    // 光标在编辑器内，插入到光标位置
+                    range.deleteContents()
+                    range.insertNode(node)
+                    range.collapse(false)
+                    selection.removeAllRanges()
+                    selection.addRange(range)
+                } else {
+                    // 光标不在编辑器内，追加到末尾
+                    editorRef.current.appendChild(node)
+
+                    // 移动光标到新插入的节点后面
+                    const newRange = document.createRange()
+                    newRange.setStartAfter(node)
+                    newRange.collapse(true)
+                    selection.removeAllRanges()
+                    selection.addRange(newRange)
+                }
+            } else {
+                // 没有选区，直接追加到末尾
+                editorRef.current.appendChild(node)
+
+                // 创建新选区并移动光标到末尾
+                const selection = window.getSelection()
+                if (selection) {
+                    const newRange = document.createRange()
+                    newRange.setStartAfter(node)
+                    newRange.collapse(true)
+                    selection.removeAllRanges()
+                    selection.addRange(newRange)
+                }
+            }
+
+        }
+
+        // 清空编辑器
+        const clear = () => {
+            if (editorRef.current) {
+                editorRef.current.innerHTML = ''
+                handleChange()
+            }
+        }
+
+        // 聚焦编辑器
+        const focus = () => {
+            editorRef.current?.focus()
+        }
+
+        // 获取内容
+        const getContent = () => {
+            return parseEditorContent()
+        }
+
+        // 检测 @ 输入
+        const checkAtTrigger = () => {
+            if (!editorRef.current || !onAtTrigger) return
+
+            const selection = window.getSelection()
+            if (!selection || selection.rangeCount === 0) {
+                onAtTrigger(false, '')
+                atTriggerTextRef.current = null
+                return
+            }
+
+            const range = selection.getRangeAt(0)
+            
+            // 检查光标是否在编辑器内
+            if (!editorRef.current.contains(range.commonAncestorContainer)) {
+                onAtTrigger(false, '')
+                atTriggerTextRef.current = null
+                return
+            }
+
+            // 获取光标前的文本节点
+            const node = range.startContainer
+            if (node.nodeType !== Node.TEXT_NODE) {
+                onAtTrigger(false, '')
+                atTriggerTextRef.current = null
+                return
+            }
+
+            const textNode = node as Text
+            const textBeforeCursor = textNode.textContent?.substring(0, range.startOffset) || ''
+            
+            // 查找最近的 @ 符号位置
+            const atIndex = textBeforeCursor.lastIndexOf('@')
+            
+            // 检查是否找到 @ 且后面没有空格（表示仍在输入 @提及）
+            if (atIndex !== -1) {
+                const textAfterAt = textBeforeCursor.substring(atIndex + 1)
+                
+                // 如果 @ 后面有空格，则不触发
+                if (textAfterAt.includes(' ') || textAfterAt.includes('\n')) {
+                    onAtTrigger(false, '')
+                    atTriggerTextRef.current = null
+                    return
+                }
+                
+                atTriggerTextRef.current = textNode
+                
+                // 计算 @ 位置
+                const tempRange = document.createRange()
+                tempRange.setStart(textNode, atIndex)
+                tempRange.setEnd(textNode, atIndex + 1)
+                const rect = tempRange.getBoundingClientRect()
+                const editorRect = editorRef.current.getBoundingClientRect()
+                
+                // 传递搜索查询（@ 后面的文本）
+                onAtTrigger(true, textAfterAt, {
+                    top: rect.bottom - editorRect.top,
+                    left: rect.left - editorRect.left
+                })
+            } else {
+                onAtTrigger(false, '')
+                atTriggerTextRef.current = null
+            }
+        }
+
+        // 处理内容变化
+        const handleChange = () => {
+            checkAtTrigger()
+            
+            if (onChange) {
+                const { text, segments } = parseEditorContent()
+                onChange(text, segments)
+            }
+        }
+
+        // 删除触发的 @ 符号和搜索文本并插入用户
+        const replaceAtTrigger = (name: string, id?: string) => {
+            if (!atTriggerTextRef.current) return
+
+            const textNode = atTriggerTextRef.current
+            const text = textNode.textContent || ''
+            const atIndex = text.lastIndexOf('@')
+            
+            if (atIndex !== -1) {
+                // 找到 @ 后面的内容（搜索文本）
+                const textAfter = text.substring(atIndex + 1)
+                const endIndex = atIndex + 1 + textAfter.split(/[\s\n]/)[0].length
+                
+                // 删除 @ 符号和搜索文本
+                const beforeAt = text.substring(0, atIndex)
+                const afterSearch = text.substring(endIndex)
+                textNode.textContent = beforeAt + afterSearch
+                
+                // 移动光标到删除位置
+                const selection = window.getSelection()
+                if (selection) {
+                    const range = document.createRange()
+                    range.setStart(textNode, atIndex)
+                    range.collapse(true)
+                    selection.removeAllRanges()
+                    selection.addRange(range)
+                }
+            }
+            
+            atTriggerTextRef.current = null
+            insertAt(name, id)
+        }
+
+        // 处理键盘事件
+        const handleKeyDown = (e: React.KeyboardEvent<HTMLDivElement>) => {
+            if (e.key === 'Enter' && !e.shiftKey) {
+                e.preventDefault()
+                if (onSend) {
+                    const { text, segments } = parseEditorContent()
+                    onSend(text, segments)
+                }
+            }
+        }
+
+        // 暴露方法给父组件
+        useImperativeHandle(ref, () => ({
+            focus,
+            clear,
+            insertFace,
+            insertImage,
+            insertAt,
+            replaceAtTrigger,
+            getContent
+        }))
+
+        return (
+            <div
+                ref={editorRef}
+                contentEditable
+                suppressContentEditableWarning
+                onInput={handleChange}
+                onKeyDown={handleKeyDown}
+                data-placeholder={placeholder}
+                className="rich-text-editor"
+                style={{
+                    width: '100%',
+                    minHeight,
+                    maxHeight,
+                    padding: '0.5rem 0.75rem',
+                    border: '1px solid var(--gray-6)',
+                    borderRadius: '6px',
+                    backgroundColor: 'var(--gray-1)',
+                    fontSize: 'var(--font-size-2)',
+                    outline: 'none',
+                    overflowY: 'auto',
+                    lineHeight: '1.5',
+                    wordWrap: 'break-word',
+                    color: 'var(--gray-12)'
+                }}
+            />
+        )
+    }
+)
+
+RichTextEditor.displayName = 'RichTextEditor'
+
+export default RichTextEditor
+