Skip to content

Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.

feat(sandbox): browse installed skill files from settings

wizardchenebfd5ef0fba4
diff --git a/client/README.md b/client/README.md
index dfc03710c..de2a2bc6e 100644
--- a/client/README.md
+++ b/client/README.md
@@ -400,6 +400,21 @@ if err != nil {
_ = skillID // 用 skillID 订阅 /sandbox-configs/{id}/skills/{skillID}/install-events
```
+### 示例:查看已安装技能的文件
+
+```go
+files, err := apiClient.ListSandboxSkillFiles(context.Background(), sandboxConfigID, skillID)
+if err != nil {
+ // 处理错误
+}
+content, err := apiClient.GetSandboxSkillFile(context.Background(), sandboxConfigID, skillID, "SKILL.md")
+if err != nil {
+ // 处理错误
+}
+_ = files
+_ = content
+```
+
## 完整示例
请参考 `example.go` 文件中的 `ExampleUsage` 函数,其中展示了客户端的完整使用流程。
\ No newline at end of file
diff --git a/client/README_EN.md b/client/README_EN.md
index 7ee448f18..0f454993f 100644
--- a/client/README_EN.md
+++ b/client/README_EN.md
@@ -213,6 +213,21 @@ if err != nil {
_ = skillID // follow /sandbox-configs/{id}/skills/{skillID}/install-events
```
+### Example: Browse files of an installed skill
+
+```go
+files, err := apiClient.ListSandboxSkillFiles(context.Background(), sandboxConfigID, skillID)
+if err != nil {
+ // Handle error
+}
+content, err := apiClient.GetSandboxSkillFile(context.Background(), sandboxConfigID, skillID, "SKILL.md")
+if err != nil {
+ // Handle error
+}
+_ = files
+_ = content
+```
+
## Complete Example
Please refer to the `ExampleUsage` function in the `example.go` file, which demonstrates the complete usage flow of the client.
diff --git a/client/skill.go b/client/skill.go
index b8f7b9cc3..ce15f4729 100644
--- a/client/skill.go
+++ b/client/skill.go
@@ -118,3 +118,81 @@ func (c *Client) UploadSandboxSkill(
}
return response.Data.SkillID, nil
}
+
+// SandboxSkillFile is one path in an installed skill's stored archive.
+type SandboxSkillFile struct {
+ Path string `json:"path"`
+ Size int64 `json:"size"`
+}
+
+// SandboxSkillFileContent is one file opened from an installed skill.
+type SandboxSkillFileContent struct {
+ Path string `json:"path"`
+ Size int64 `json:"size"`
+ Encoding string `json:"encoding"`
+ Content string `json:"content,omitempty"`
+ MediaType string `json:"media_type,omitempty"`
+ Truncated bool `json:"truncated,omitempty"`
+ Binary bool `json:"binary,omitempty"`
+}
+
+type sandboxSkillFilesResponse struct {
+ Success bool `json:"success"`
+ Data []SandboxSkillFile `json:"data"`
+}
+
+type sandboxSkillFileContentResponse struct {
+ Success bool `json:"success"`
+ Data SandboxSkillFileContent `json:"data"`
+}
+
+// ListSandboxSkillFiles lists the stored archive of one installed skill.
+func (c *Client) ListSandboxSkillFiles(
+ ctx context.Context, configID, skillID string,
+) ([]SandboxSkillFile, error) {
+ if configID == "" {
+ return nil, fmt.Errorf("sandbox config ID is required")
+ }
+ if skillID == "" {
+ return nil, fmt.Errorf("skill ID is required")
+ }
+ path := "/api/v1/sandbox-configs/" + url.PathEscape(configID) +
+ "/skills/" + url.PathEscape(skillID) + "/files"
+ resp, err := c.doRequest(ctx, http.MethodGet, path, nil, nil)
+ if err != nil {
+ return nil, err
+ }
+ var response sandboxSkillFilesResponse
+ if err := parseResponse(resp, &response); err != nil {
+ return nil, err
+ }
+ return response.Data, nil
+}
+
+// GetSandboxSkillFile reads one skill-root-relative file from an installed skill.
+func (c *Client) GetSandboxSkillFile(
+ ctx context.Context, configID, skillID, filePath string,
+) (*SandboxSkillFileContent, error) {
+ if configID == "" {
+ return nil, fmt.Errorf("sandbox config ID is required")
+ }
+ if skillID == "" {
+ return nil, fmt.Errorf("skill ID is required")
+ }
+ if filePath == "" {
+ return nil, fmt.Errorf("skill file path is required")
+ }
+ path := "/api/v1/sandbox-configs/" + url.PathEscape(configID) +
+ "/skills/" + url.PathEscape(skillID) + "/files/content"
+ query := url.Values{}
+ query.Set("path", filePath)
+ resp, err := c.doRequest(ctx, http.MethodGet, path, nil, query)
+ if err != nil {
+ return nil, err
+ }
+ var response sandboxSkillFileContentResponse
+ if err := parseResponse(resp, &response); err != nil {
+ return nil, err
+ }
+ return &response.Data, nil
+}
diff --git a/docs/api/skill.md b/docs/api/skill.md
index fa2b20420..a835ad249 100644
--- a/docs/api/skill.md
+++ b/docs/api/skill.md
@@ -6,6 +6,8 @@
| ---- | --------- | ------------------ |
| GET | `/skills` | 获取预装 Skills 列表 |
| POST | `/sandbox-configs/{id}/skills` | 安装技能(zip 上传或托管平台 source) |
+| GET | `/sandbox-configs/{id}/skills/{skillId}/files` | 列出已安装技能的文件 |
+| GET | `/sandbox-configs/{id}/skills/{skillId}/files/content` | 读取已安装技能中的单个文件 |
## GET `/skills` - 获取预装 Skills 列表
@@ -100,3 +102,48 @@ curl --location 'http://localhost:8080/api/v1/sandbox-configs/{id}/skills' \
}
}
```
+
+## GET `/sandbox-configs/{id}/skills/{skillId}/files` - 列出技能文件
+
+返回该技能存档里的文件路径与大小。路径相对技能根目录(`SKILL.md` 所在目录),不启动沙箱。
+
+```curl
+curl --location 'http://localhost:8080/api/v1/sandbox-configs/{id}/skills/{skillId}/files' \
+--header 'X-API-Key: sk-xxxxx'
+```
+
+**响应**:
+
+```json
+{
+ "success": true,
+ "data": [
+ { "path": "SKILL.md", "size": 412 },
+ { "path": "scripts/extract.py", "size": 1280 }
+ ]
+}
+```
+
+## GET `/sandbox-configs/{id}/skills/{skillId}/files/content` - 读取技能文件
+
+`path` 为技能根目录相对路径。文本以 UTF-8 返回;较小的图片为 base64;其它二进制文件不返回正文,并设置 `binary: true`。
+
+```curl
+curl --location 'http://localhost:8080/api/v1/sandbox-configs/{id}/skills/{skillId}/files/content?path=SKILL.md' \
+--header 'X-API-Key: sk-xxxxx'
+```
+
+**响应**:
+
+```json
+{
+ "success": true,
+ "data": {
+ "path": "SKILL.md",
+ "size": 412,
+ "encoding": "utf-8",
+ "media_type": "text/markdown",
+ "content": "---\nname: pdf-tools\n..."
+ }
+}
+```
diff --git a/docs/docs.go b/docs/docs.go
index cfab866f9..aeeeafc0a 100644
--- a/docs/docs.go
+++ b/docs/docs.go
@@ -11885,6 +11885,135 @@ const docTemplate = `{
}
}
},
+ "/sandbox-configs/{id}/skills/{skillId}/files": {
+ "get": {
+ "security": [
+ {
+ "Bearer": []
+ },
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "description": "List files in the stored skill bundle without starting a sandbox.",
+ "produces": [
+ "application/json"
+ ],
+ "tags": [
+ "SandboxConfig"
+ ],
+ "summary": "List files of an installed skill",
+ "parameters": [
+ {
+ "type": "string",
+ "description": "Sandbox config ID",
+ "name": "id",
+ "in": "path",
+ "required": true
+ },
+ {
+ "type": "string",
+ "description": "Skill ID",
+ "name": "skillId",
+ "in": "path",
+ "required": true
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "Skill files",
+ "schema": {
+ "type": "object",
+ "additionalProperties": true
+ }
+ },
+ "401": {
+ "description": "Unauthorized",
+ "schema": {
+ "type": "object",
+ "additionalProperties": true
+ }
+ },
+ "404": {
+ "description": "Skill or files not found",
+ "schema": {
+ "$ref": "#/definitions/github_com_Tencent_WeKnora_internal_errors.AppError"
+ }
+ }
+ }
+ }
+ },
+ "/sandbox-configs/{id}/skills/{skillId}/files/content": {
+ "get": {
+ "security": [
+ {
+ "Bearer": []
+ },
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "description": "Read one skill file as UTF-8, a small base64 image, or binary.",
+ "produces": [
+ "application/json"
+ ],
+ "tags": [
+ "SandboxConfig"
+ ],
+ "summary": "Read one file of an installed skill",
+ "parameters": [
+ {
+ "type": "string",
+ "description": "Sandbox config ID",
+ "name": "id",
+ "in": "path",
+ "required": true
+ },
+ {
+ "type": "string",
+ "description": "Skill ID",
+ "name": "skillId",
+ "in": "path",
+ "required": true
+ },
+ {
+ "type": "string",
+ "description": "Skill-root-relative file path",
+ "name": "path",
+ "in": "query",
+ "required": true
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "Skill file",
+ "schema": {
+ "type": "object",
+ "additionalProperties": true
+ }
+ },
+ "400": {
+ "description": "Invalid path",
+ "schema": {
+ "$ref": "#/definitions/github_com_Tencent_WeKnora_internal_errors.AppError"
+ }
+ },
+ "401": {
+ "description": "Unauthorized",
+ "schema": {
+ "type": "object",
+ "additionalProperties": true
+ }
+ },
+ "404": {
+ "description": "Skill or file not found",
+ "schema": {
+ "$ref": "#/definitions/github_com_Tencent_WeKnora_internal_errors.AppError"
+ }
+ }
+ }
+ }
+ },
"/sandbox-configs/{id}/skills/{skillId}/install-events": {
"get": {
"security": [
@@ -11983,6 +12112,12 @@ const docTemplate = `{
"type": "string"
}
},
+ "204": {
+ "description": "Install is still preparing; retry once locators exist",
+ "schema": {
+ "type": "string"
+ }
+ },
"401": {
"description": "Unauthorized",
"schema": {
diff --git a/docs/swagger.json b/docs/swagger.json
index 14e2fc59e..36f5256a0 100644
--- a/docs/swagger.json
+++ b/docs/swagger.json
@@ -11878,6 +11878,135 @@
}
}
},
+ "/sandbox-configs/{id}/skills/{skillId}/files": {
+ "get": {
+ "security": [
+ {
+ "Bearer": []
+ },
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "description": "List files in the stored skill bundle without starting a sandbox.",
+ "produces": [
+ "application/json"
+ ],
+ "tags": [
+ "SandboxConfig"
+ ],
+ "summary": "List files of an installed skill",
+ "parameters": [
+ {
+ "type": "string",
+ "description": "Sandbox config ID",
+ "name": "id",
+ "in": "path",
+ "required": true
+ },
+ {
+ "type": "string",
+ "description": "Skill ID",
+ "name": "skillId",
+ "in": "path",
+ "required": true
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "Skill files",
+ "schema": {
+ "type": "object",
+ "additionalProperties": true
+ }
+ },
+ "401": {
+ "description": "Unauthorized",
+ "schema": {
+ "type": "object",
+ "additionalProperties": true
+ }
+ },
+ "404": {
+ "description": "Skill or files not found",
+ "schema": {
+ "$ref": "#/definitions/github_com_Tencent_WeKnora_internal_errors.AppError"
+ }
+ }
+ }
+ }
+ },
+ "/sandbox-configs/{id}/skills/{skillId}/files/content": {
+ "get": {
+ "security": [
+ {
+ "Bearer": []
+ },
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "description": "Read one skill file as UTF-8, a small base64 image, or binary.",
+ "produces": [
+ "application/json"
+ ],
+ "tags": [
+ "SandboxConfig"
+ ],
+ "summary": "Read one file of an installed skill",
+ "parameters": [
+ {
+ "type": "string",
+ "description": "Sandbox config ID",
+ "name": "id",
+ "in": "path",
+ "required": true
+ },
+ {
+ "type": "string",
+ "description": "Skill ID",
+ "name": "skillId",
+ "in": "path",
+ "required": true
+ },
+ {
+ "type": "string",
+ "description": "Skill-root-relative file path",
+ "name": "path",
+ "in": "query",
+ "required": true
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "Skill file",
+ "schema": {
+ "type": "object",
+ "additionalProperties": true
+ }
+ },
+ "400": {
+ "description": "Invalid path",
+ "schema": {
+ "$ref": "#/definitions/github_com_Tencent_WeKnora_internal_errors.AppError"
+ }
+ },
+ "401": {
+ "description": "Unauthorized",
+ "schema": {
+ "type": "object",
+ "additionalProperties": true
+ }
+ },
+ "404": {
+ "description": "Skill or file not found",
+ "schema": {
+ "$ref": "#/definitions/github_com_Tencent_WeKnora_internal_errors.AppError"
+ }
+ }
+ }
+ }
+ },
"/sandbox-configs/{id}/skills/{skillId}/install-events": {
"get": {
"security": [
@@ -11976,6 +12105,12 @@
"type": "string"
}
},
+ "204": {
+ "description": "Install is still preparing; retry once locators exist",
+ "schema": {
+ "type": "string"
+ }
+ },
"401": {
"description": "Unauthorized",
"schema": {
diff --git a/docs/swagger.yaml b/docs/swagger.yaml
index 29ff4cbe6..1847eaa70 100644
--- a/docs/swagger.yaml
+++ b/docs/swagger.yaml
@@ -13856,6 +13856,89 @@ paths:
summary: Update an installed skill
tags:
- SandboxConfig
+ /sandbox-configs/{id}/skills/{skillId}/files:
+ get:
+ description: List files in the stored skill bundle without starting a sandbox.
+ parameters:
+ - description: Sandbox config ID
+ in: path
+ name: id
+ required: true
+ type: string
+ - description: Skill ID
+ in: path
+ name: skillId
+ required: true
+ type: string
+ produces:
+ - application/json
+ responses:
+ "200":
+ description: Skill files
+ schema:
+ additionalProperties: true
+ type: object
+ "401":
+ description: Unauthorized
+ schema:
+ additionalProperties: true
+ type: object
+ "404":
+ description: Skill or files not found
+ schema:
+ $ref: '#/definitions/github_com_Tencent_WeKnora_internal_errors.AppError'
+ security:
+ - Bearer: []
+ - ApiKeyAuth: []
+ summary: List files of an installed skill
+ tags:
+ - SandboxConfig
+ /sandbox-configs/{id}/skills/{skillId}/files/content:
+ get:
+ description: Read one skill file as UTF-8, a small base64 image, or binary.
+ parameters:
+ - description: Sandbox config ID
+ in: path
+ name: id
+ required: true
+ type: string
+ - description: Skill ID
+ in: path
+ name: skillId
+ required: true
+ type: string
+ - description: Skill-root-relative file path
+ in: query
+ name: path
+ required: true
+ type: string
+ produces:
+ - application/json
+ responses:
+ "200":
+ description: Skill file
+ schema:
+ additionalProperties: true
+ type: object
+ "400":
+ description: Invalid path
+ schema:
+ $ref: '#/definitions/github_com_Tencent_WeKnora_internal_errors.AppError'
+ "401":
+ description: Unauthorized
+ schema:
+ additionalProperties: true
+ type: object
+ "404":
+ description: Skill or file not found
+ schema:
+ $ref: '#/definitions/github_com_Tencent_WeKnora_internal_errors.AppError'
+ security:
+ - Bearer: []
+ - ApiKeyAuth: []
+ summary: Read one file of an installed skill
+ tags:
+ - SandboxConfig
/sandbox-configs/{id}/skills/{skillId}/install-events:
get:
description: |-
@@ -13924,6 +14007,10 @@ paths:
description: SSE stream of transcript events
schema:
type: string
+ "204":
+ description: Install is still preparing; retry once locators exist
+ schema:
+ type: string
"401":
description: Unauthorized
schema:
diff --git a/frontend/src/api/system/index.ts b/frontend/src/api/system/index.ts
index 0a7d541eb..92fb5a410 100644
--- a/frontend/src/api/system/index.ts
+++ b/frontend/src/api/system/index.ts
@@ -1084,3 +1084,37 @@ export function configSkillInstallEventsUrl(configId: string, skillId: string):
export function configSkillTranscriptUrl(configId: string, skillId: string): string {
return `/api/v1/sandbox-configs/${configId}/skills/${skillId}/transcript`
}
+
+export interface ConfigSkillFileEntry {
+ path: string
+ size: number
+}
+
+export interface ConfigSkillFileContent {
+ path: string
+ size: number
+ encoding: 'utf-8' | 'base64' | 'binary' | string
+ content?: string
+ media_type?: string
+ truncated?: boolean
+ binary?: boolean
+}
+
+export function listConfigSkillFiles(
+ configId: string,
+ skillId: string,
+): Promise<{ data: ConfigSkillFileEntry[] }> {
+ return get(`/api/v1/sandbox-configs/${configId}/skills/${skillId}/files`) as unknown as Promise<{
+ data: ConfigSkillFileEntry[]
+ }>
+}
+
+export function getConfigSkillFile(
+ configId: string,
+ skillId: string,
+ path: string,
+): Promise<{ data: ConfigSkillFileContent }> {
+ return get(`/api/v1/sandbox-configs/${configId}/skills/${skillId}/files/content`, {
+ params: { path },
+ }) as unknown as Promise<{ data: ConfigSkillFileContent }>
+}
diff --git a/frontend/src/components/SandboxSkillsPanel.vue b/frontend/src/components/SandboxSkillsPanel.vue
index 101c88ede..c94de6e3c 100644
--- a/frontend/src/components/SandboxSkillsPanel.vue
+++ b/frontend/src/components/SandboxSkillsPanel.vue
@@ -173,6 +173,18 @@
@change="(v: any) => toggleEnabled(skill, Boolean(v))"
/>
</t-tooltip>
+ <span class="skill-item__actions-divider" />
+ <t-tooltip :content="$t('settings.sandbox.skillFiles')" placement="top">
+ <button
+ type="button"
+ class="skill-item__icon-btn"
+ :class="{ 'is-on': filesDrawerVisible && filesSkillId === skill.id }"
+ :aria-label="$t('settings.sandbox.skillFiles')"
+ @click="openSkillFiles(skill)"
+ >
+ <t-icon name="folder" size="16px" />
+ </button>
+ </t-tooltip>
<t-popup
v-if="hasTranscript(skill)"
:visible="expandedSkillId === skill.id"
@@ -185,17 +197,14 @@
:overlay-inner-style="{ padding: '0' }"
@visible-change="(visible: boolean) => onTranscriptVisible(skill, visible)"
>
- <t-button
- variant="text"
- shape="square"
+ <button
+ type="button"
class="skill-item__icon-btn"
- :class="{ 'skill-transcript-toggle--on': expandedSkillId === skill.id }"
- :title="$t('settings.sandbox.skillTranscript')"
+ :class="{ 'is-on': expandedSkillId === skill.id }"
+ :aria-label="$t('settings.sandbox.skillTranscript')"
>
- <template #icon>
- <t-icon name="chat-bubble-history" size="16px" />
- </template>
- </t-button>
+ <t-icon name="chat-bubble-history" size="16px" />
+ </button>
<template #content>
<div class="skill-transcript-popup__panel">
<header class="skill-transcript-popup__head">
@@ -243,41 +252,47 @@
@confirm="removeSkill(skill)"
>
<t-tooltip :content="$t('common.delete')" placement="top">
- <t-button
- theme="danger"
- variant="text"
- shape="square"
- class="skill-item__icon-btn"
- :disabled="isBusy(skill)"
- :loading="deletingId === skill.id"
+ <button
+ type="button"
+ class="skill-item__icon-btn skill-item__icon-btn--danger"
+ :disabled="isBusy(skill) || deletingId === skill.id"
+ :aria-label="$t('common.delete')"
>
- <template #icon><t-icon name="delete" size="16px" /></template>
- </t-button>
+ <t-icon name="delete" size="16px" />
+ </button>
</t-tooltip>
</t-popconfirm>
</div>
</div>
- <p
- v-if="skill.description"
- class="skill-item__desc"
- :class="{ 'skill-item__desc--expanded': isCopyExpanded(skill.id) }"
- >
- {{ skill.description }}
- </p>
- <button
- v-if="canToggleCopy(skill)"
- type="button"
- class="skill-item__toggle"
- @click="toggleCopy(skill.id)"
- >
- {{ isCopyExpanded(skill.id) ? $t('common.collapse') : $t('common.expand') }}
- </button>
+ <div v-if="skill.description" class="skill-item__copy">
+ <p
+ class="skill-item__desc"
+ :class="{ 'skill-item__desc--expanded': isCopyExpanded(skill.id) }"
+ >
+ {{ skill.description }}
+ </p>
+ <button
+ v-if="canToggleCopy(skill)"
+ type="button"
+ class="skill-item__toggle"
+ @click="toggleCopy(skill.id)"
+ >
+ {{ isCopyExpanded(skill.id) ? $t('common.collapse') : $t('common.expand') }}
+ </button>
+ </div>
<p v-if="failedError(skill)" class="skill-item__error">{{ failedError(skill) }}</p>
</div>
</li>
</ul>
</section>
</t-loading>
+
+ <SkillFilesDrawer
+ v-model:visible="filesDrawerVisible"
+ :config-id="record?.id || ''"
+ :skill-id="filesSkillId"
+ :skill-name="filesSkillName"
+ />
</div>
</template>
@@ -288,6 +303,7 @@ import { useI18n } from 'vue-i18n'
import { fetchEventSource } from '@microsoft/fetch-event-source'
import ModelSelector from '@/components/ModelSelector.vue'
import SkillInstallTimeline from '@/components/SkillInstallTimeline.vue'
+import SkillFilesDrawer from '@/components/SkillFilesDrawer.vue'
import {
getAgentById,
updateAgent,
@@ -335,6 +351,9 @@ const deletingId = ref('')
// Only one install timeline is open at a time: each one holds an SSE
// connection, and two runs' worth of agent steps in a drawer is unreadable.
const expandedSkillId = ref('')
+const filesSkillId = ref('')
+const filesSkillName = ref('')
+const filesDrawerVisible = ref(false)
const expandedCopyIds = ref<Set<string>>(new Set())
const transcriptEpoch = ref(0)
const focusedSkillId = ref('')
@@ -440,6 +459,7 @@ function revealSkill(skillId: string) {
function onTranscriptVisible(skill: ConfigSkill, visible: boolean) {
if (visible) {
+ filesDrawerVisible.value = false
if (expandedSkillId.value !== skill.id) {
expandedSkillId.value = skill.id
// A run that finished while the popup was closed was tailed from the
@@ -453,6 +473,17 @@ function onTranscriptVisible(skill: ConfigSkill, visible: boolean) {
}
}
+function openSkillFiles(skill: ConfigSkill) {
+ expandedSkillId.value = ''
+ if (filesDrawerVisible.value && filesSkillId.value === skill.id) {
+ filesDrawerVisible.value = false
+ return
+ }
+ filesSkillId.value = skill.id
+ filesSkillName.value = skill.name || skill.id
+ filesDrawerVisible.value = true
+}
+
function progressOf(skill: ConfigSkill): number {
const percent = progressById.value[skill.id]?.percent
if (typeof percent === 'number' && Number.isFinite(percent)) {
@@ -1021,10 +1052,6 @@ onUnmounted(() => {
box-shadow: 0 0 0 2px var(--td-brand-color-focus, rgba(0, 168, 112, 0.18));
}
-.skill-transcript-toggle--on {
- color: var(--td-brand-color);
-}
-
.skill-status-ring {
width: 16px;
height: 16px;
@@ -1084,13 +1111,22 @@ onUnmounted(() => {
.skill-item__desc,
.skill-item__error {
- margin: 6px 0 0;
+ margin: 0;
font-size: 12px;
line-height: 1.5;
word-break: break-word;
}
+.skill-item__copy {
+ display: flex;
+ align-items: flex-end;
+ gap: 8px;
+ margin-top: 6px;
+}
+
.skill-item__desc {
+ min-width: 0;
+ flex: 1;
color: var(--td-text-color-secondary);
}
@@ -1103,33 +1139,72 @@ onUnmounted(() => {
}
.skill-item__error {
+ margin-top: 6px;
color: var(--td-error-color);
}
.skill-item__toggle {
- margin-top: 4px;
+ flex-shrink: 0;
+ margin: 0;
padding: 0;
border: 0;
background: none;
font-size: 12px;
line-height: 1.5;
- color: var(--td-brand-color);
+ color: var(--td-text-color-placeholder);
cursor: pointer;
+
+ &:hover {
+ color: var(--td-brand-color);
+ }
}
.skill-item__actions {
display: flex;
align-items: center;
- gap: 4px;
+ gap: 2px;
flex-shrink: 0;
}
+.skill-item__actions-divider {
+ width: 1px;
+ height: 12px;
+ margin: 0 4px;
+ background: var(--td-component-stroke);
+}
+
.skill-item__icon-btn {
- width: 24px;
- height: 24px;
+ display: inline-flex;
+ align-items: center;
+ justify-content: center;
+ width: 26px;
+ height: 26px;
+ padding: 0;
+ border: 0;
+ border-radius: 6px;
+ background: transparent;
+ color: var(--td-text-color-placeholder);
+ cursor: pointer;
+ transition: background 0.15s ease, color 0.15s ease;
- :deep(.t-button__icon) {
- margin: 0;
+ &:hover:not(:disabled) {
+ background: var(--td-bg-color-secondarycontainer);
+ color: var(--td-text-color-primary);
+ }
+
+ &:disabled {
+ cursor: not-allowed;
+ opacity: 0.4;
+ }
+
+ &.is-on {
+ background: var(--td-bg-color-secondarycontainer);
+ color: var(--td-brand-color);
+ }
+
+ &--danger:hover:not(:disabled) {
+ background: var(--td-error-color-1, var(--td-bg-color-secondarycontainer));
+ color: var(--td-error-color);
}
}
</style>
diff --git a/frontend/src/components/SkillFilesDrawer.vue b/frontend/src/components/SkillFilesDrawer.vue
new file mode 100644
index 000000000..999f4a170
--- /dev/null
+++ b/frontend/src/components/SkillFilesDrawer.vue
@@ -0,0 +1,306 @@
+<template>
+ <teleport to="body">
+ <div
+ v-if="visible"
+ class="skill-files-drawer-resize-handle"
+ :class="{ 'skill-files-drawer-resize-handle--active': resizing }"
+ :style="{ right: `${drawerWidth}px`, '--skill-files-drawer-travel': `${drawerWidth}px` }"
+ role="separator"
+ aria-orientation="vertical"
+ @mousedown.prevent="onResizeStart"
+ >
+ <div class="skill-files-drawer-resize-line" />
+ </div>
+ </teleport>
+ <t-drawer
+ :visible="visible"
+ :z-index="2600"
+ :size="`${drawerWidth}px`"
+ attach="body"
+ :close-btn="false"
+ :footer="false"
+ :header="false"
+ :show-overlay="true"
+ :close-on-overlay-click="true"
+ destroy-on-close
+ placement="right"
+ :class="['skill-files-drawer', { 'skill-files-drawer--resizing': resizing }]"
+ @close="onClose"
+ >
+ <div class="skill-files-drawer__shell">
+ <header class="skill-files-drawer__head">
+ <div class="skill-files-drawer__head-icon">
+ <t-icon name="folder" />
+ </div>
+ <div class="skill-files-drawer__head-text">
+ <div class="skill-files-drawer__title">{{ skillName }}</div>
+ <div class="skill-files-drawer__subtitle">{{ $t('settings.sandbox.skillFilesTitle') }}</div>
+ </div>
+ <button
+ type="button"
+ class="skill-files-drawer__close"
+ :title="$t('common.close')"
+ :aria-label="$t('common.close')"
+ @click="onClose"
+ >
+ <t-icon name="close" size="16px" />
+ </button>
+ </header>
+ <SkillFilesPanel
+ v-if="visible && configId && skillId"
+ :config-id="configId"
+ :skill-id="skillId"
+ :drawer-width="drawerWidth"
+ />
+ </div>
+ </t-drawer>
+</template>
+
+<script setup lang="ts">
+import { onMounted, onUnmounted, ref, watch } from 'vue'
+import SkillFilesPanel from '@/components/SkillFilesPanel.vue'
+
+const WIDTH_KEY = 'skill-files-drawer:width'
+const DEFAULT_WIDTH = 720
+const MIN_WIDTH = 480
+
+const props = defineProps<{
+ visible: boolean
+ configId: string
+ skillId: string
+ skillName: string
+}>()
+
+const emit = defineEmits<{
+ 'update:visible': [value: boolean]
+}>()
+
+const drawerWidth = ref(DEFAULT_WIDTH)
+const resizing = ref(false)
+
+let resizeStartX = 0
+let resizeStartWidth = 0
+
+function maxWidth() {
+ return Math.min(1200, Math.max(MIN_WIDTH, Math.floor(window.innerWidth * 0.92)))
+}
+
+function clampWidth(width: number) {
+ return Math.max(MIN_WIDTH, Math.min(maxWidth(), Math.round(width)))
+}
+
+function loadWidth() {
+ try {
+ const raw = localStorage.getItem(WIDTH_KEY)
+ const parsed = raw ? parseInt(raw, 10) : NaN
+ if (!Number.isNaN(parsed)) drawerWidth.value = clampWidth(parsed)
+ } catch {
+ /* ignore */
+ }
+}
+
+function persistWidth() {
+ try {
+ localStorage.setItem(WIDTH_KEY, String(drawerWidth.value))
+ } catch {
+ /* ignore */
+ }
+}
+
+function onResizeStart(e: MouseEvent) {
+ resizing.value = true
+ resizeStartX = e.clientX
+ resizeStartWidth = drawerWidth.value
+ document.addEventListener('mousemove', onResizeMove)
+ document.addEventListener('mouseup', onResizeEnd)
+ document.body.style.cursor = 'col-resize'
+ document.body.style.userSelect = 'none'
+}
+
+function onResizeMove(e: MouseEvent) {
+ drawerWidth.value = clampWidth(resizeStartWidth + (resizeStartX - e.clientX))
+}
+
+function onResizeEnd() {
+ document.removeEventListener('mousemove', onResizeMove)
+ document.removeEventListener('mouseup', onResizeEnd)
+ document.body.style.cursor = ''
+ document.body.style.userSelect = ''
+ resizing.value = false
+ persistWidth()
+}
+
+function cleanupResize() {
+ document.removeEventListener('mousemove', onResizeMove)
+ document.removeEventListener('mouseup', onResizeEnd)
+ document.body.style.cursor = ''
+ document.body.style.userSelect = ''
+ resizing.value = false
+}
+
+function onWindowResize() {
+ drawerWidth.value = clampWidth(drawerWidth.value)
+}
+
+function onClose() {
+ emit('update:visible', false)
+}
+
+watch(
+ () => props.visible,
+ (open) => {
+ if (open) loadWidth()
+ },
+)
+
+onMounted(() => {
+ loadWidth()
+ window.addEventListener('resize', onWindowResize, { passive: true })
+})
+
+onUnmounted(() => {
+ window.removeEventListener('resize', onWindowResize)
+ cleanupResize()
+})
+</script>
+
+<style lang="less" scoped>
+.skill-files-drawer__shell {
+ display: flex;
+ flex-direction: column;
+ flex: 1;
+ height: 100%;
+ min-height: 0;
+ width: 100%;
+ overflow: hidden;
+ background: var(--td-bg-color-container);
+}
+
+.skill-files-drawer__head {
+ display: flex;
+ align-items: center;
+ gap: 10px;
+ flex-shrink: 0;
+ padding: 14px 18px;
+ border-bottom: 1px solid var(--td-component-stroke);
+}
+
+.skill-files-drawer__head-icon {
+ flex-shrink: 0;
+ width: 32px;
+ height: 32px;
+ border-radius: 9px;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ background: rgba(7, 192, 95, 0.1);
+ color: var(--td-brand-color);
+ font-size: 16px;
+}
+
+.skill-files-drawer__head-text {
+ min-width: 0;
+ flex: 1;
+}
+
+.skill-files-drawer__title {
+ font-size: 15px;
+ font-weight: 600;
+ line-height: 1.4;
+ color: var(--td-text-color-primary);
+ overflow: hidden;
+ text-overflow: ellipsis;
+ white-space: nowrap;
+}
+
+.skill-files-drawer__subtitle {
+ margin-top: 2px;
+ font-size: 12px;
+ line-height: 1.4;
+ color: var(--td-text-color-secondary);
+}
+
+.skill-files-drawer__close {
+ flex-shrink: 0;
+ width: 28px;
+ height: 28px;
+ display: inline-flex;
+ align-items: center;
+ justify-content: center;
+ padding: 0;
+ border: 0;
+ border-radius: 6px;
+ background: transparent;
+ color: var(--td-text-color-secondary);
+ cursor: pointer;
+
+ &:hover {
+ background: var(--td-bg-color-container-hover);
+ color: var(--td-text-color-primary);
+ }
+}
+</style>
+
+<style lang="less">
+.t-drawer.skill-files-drawer .t-drawer__content-wrapper,
+.t-drawer.skill-files-drawer .t-drawer__content {
+ height: 100%;
+ display: flex;
+ flex-direction: column;
+ overflow: hidden;
+ background: var(--td-bg-color-container);
+}
+
+.t-drawer.skill-files-drawer .t-drawer__body {
+ padding: 0 !important;
+ flex: 1;
+ min-height: 0;
+ overflow: hidden;
+ display: flex;
+ flex-direction: column;
+}
+
+.t-drawer.skill-files-drawer--resizing .t-drawer__content,
+.t-drawer.skill-files-drawer--resizing .t-drawer__content-wrapper {
+ transition: none !important;
+}
+
+.skill-files-drawer-resize-handle {
+ position: fixed;
+ top: 0;
+ bottom: 0;
+ width: 12px;
+ margin-left: -6px;
+ cursor: col-resize;
+ z-index: 2601;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ animation: skill-files-drawer-resize-handle-in 0.28s cubic-bezier(0.38, 0, 0.24, 1) both;
+}
+
+@keyframes skill-files-drawer-resize-handle-in {
+ from {
+ transform: translateX(var(--skill-files-drawer-travel));
+ }
+
+ to {
+ transform: translateX(0);
+ }
+}
+
+.skill-files-drawer-resize-line {
+ width: 2px;
+ height: 48px;
+ border-radius: 1px;
+ background: var(--td-component-border);
+ opacity: 0.55;
+ transition: opacity 0.15s ease, background 0.15s ease;
+}
+
+.skill-files-drawer-resize-handle:hover .skill-files-drawer-resize-line,
+.skill-files-drawer-resize-handle--active .skill-files-drawer-resize-line {
+ opacity: 1;
+ background: var(--td-brand-color);
+}
+</style>
diff --git a/frontend/src/components/SkillFilesPanel.vue b/frontend/src/components/SkillFilesPanel.vue
new file mode 100644
index 000000000..b7ce66ad3
--- /dev/null
+++ b/frontend/src/components/SkillFilesPanel.vue
@@ -0,0 +1,833 @@
+<template>
+ <div
+ class="skill-files-panel"
+ :class="{ 'skill-files-panel--splitting': splitting }"
+ :style="{ '--skill-files-nav-width': `${navWidth}px` }"
+ >
+ <aside ref="navEl" class="skill-files-panel__nav">
+ <t-loading :loading="listLoading" size="small">
+ <p v-if="listError" class="skill-files-panel__hint">{{ listError }}</p>
+ <p v-else-if="!listLoading && !visibleRows.length" class="skill-files-panel__hint">
+ {{ $t('settings.sandbox.skillFilesEmpty') }}
+ </p>
+ <ul v-else-if="visibleRows.length" class="skill-files-panel__list">
+ <li v-for="row in visibleRows" :key="row.path">
+ <button
+ type="button"
+ class="skill-files-panel__item"
+ :class="{
+ 'is-active': selectedPath === row.path,
+ 'is-dir': row.isDir,
+ }"
+ :title="row.path"
+ @click="row.isDir ? toggleDir(row.path) : selectFile(row.path)"
+ >
+ <span class="skill-files-panel__indent" :style="{ width: `${row.depth * 12}px` }" />
+ <t-icon
+ class="skill-files-panel__icon"
+ :name="row.isDir ? (expandedDirs.has(row.path) ? 'folder-open' : 'folder') : fileIcon(row.name)"
+ size="16px"
+ />
+ <span class="skill-files-panel__name">{{ row.name }}</span>
+ </button>
+ </li>
+ </ul>
+ </t-loading>
+ </aside>
+
+ <section class="skill-files-panel__main">
+ <div v-if="selectedPath" class="skill-files-panel__bar">
+ <span class="skill-files-panel__path" :title="selectedPath">{{ selectedPath }}</span>
+ <button
+ v-if="canToggleMarkdown"
+ type="button"
+ class="skill-files-panel__link"
+ @click="markdownMode = markdownMode === 'preview' ? 'source' : 'preview'"
+ >
+ {{ markdownMode === 'preview' ? $t('settings.sandbox.skillFilesSource') : $t('settings.sandbox.skillFilesPreview') }}
+ </button>
+ <button
+ v-if="canCopy"
+ type="button"
+ class="skill-files-panel__link"
+ @click="copyContent"
+ >
+ {{ $t('common.copy') }}
+ </button>
+ </div>
+
+ <div class="skill-files-panel__view">
+ <t-loading v-if="fileLoading" size="small" />
+ <p v-else-if="fileError" class="skill-files-panel__hint">{{ fileError }}</p>
+ <p v-else-if="!selectedPath" class="skill-files-panel__hint">
+ {{ $t('settings.sandbox.skillFilesSelectHint') }}
+ </p>
+ <template v-else>
+ <p v-if="file?.truncated" class="skill-files-panel__warn">
+ {{ $t('settings.sandbox.skillFilesTruncated') }}
+ </p>
+ <img
+ v-if="imageSrc"
+ class="skill-files-panel__image"
+ :src="imageSrc"
+ :alt="selectedPath"
+ />
+ <template v-else-if="showMarkdown">
+ <dl v-if="frontmatterFields.length" class="skill-files-panel__meta">
+ <div
+ v-for="field in frontmatterFields"
+ :key="field.key"
+ class="skill-files-panel__meta-row"
+ >
+ <dt>{{ field.key }}</dt>
+ <dd :class="{ 'is-code': field.code }">{{ field.value }}</dd>
+ </div>
+ </dl>
+ <div
+ v-if="markdownHtml"
+ ref="markdownEl"
+ class="skill-files-panel__markdown markdown-content"
+ v-html="markdownHtml"
+ />
+ </template>
+ <pre v-else-if="file?.encoding === 'utf-8'" class="skill-files-panel__code"><code class="hljs" v-html="highlightedHtml" /></pre>
+ <p v-else-if="file?.binary" class="skill-files-panel__hint">
+ {{ $t('settings.sandbox.skillFilesBinary') }}
+ </p>
+ </template>
+ </div>
+ </section>
+ </div>
+ <teleport to="body">
+ <div
+ v-if="drawerWidth > 0 && splitLeft > 0"
+ class="skill-files-split-handle"
+ :class="{ 'skill-files-split-handle--active': splitting }"
+ :style="{ left: `${splitLeft}px` }"
+ role="separator"
+ aria-orientation="vertical"
+ @mousedown.prevent="onSplitStart"
+ >
+ <div class="skill-files-split-handle__line" />
+ </div>
+ </teleport>
+</template>
+
+<script setup lang="ts">
+import { computed, nextTick, onMounted, onUnmounted, ref, watch } from 'vue'
+import { useI18n } from 'vue-i18n'
+import hljs from 'highlight.js'
+import 'katex/dist/katex.min.css'
+import { copyWithToast } from '@/utils/clipboard'
+import { getFileIcon } from '@/utils/files'
+import { sanitizeMarkdownHTML, safeMarkdownToHTML } from '@/utils/security'
+import {
+ createChatMarkdownRenderer,
+ renderChatMarkdown,
+} from '@/utils/chatMarkdownRenderer'
+import {
+ createMermaidCodeRenderer,
+ enhanceMarkdownContainer,
+} from '@/utils/mermaidShared'
+import {
+ getConfigSkillFile,
+ listConfigSkillFiles,
+ type ConfigSkillFileContent,
+ type ConfigSkillFileEntry,
+} from '@/api/system'
+
+interface FileNode {
+ name: string
+ path: string
+ isDir: boolean
+ children?: FileNode[]
+}
+
+interface VisibleRow {
+ name: string
+ path: string
+ isDir: boolean
+ depth: number
+}
+
+interface FrontmatterField {
+ key: string
+ value: string
+ code: boolean
+}
+
+const props = defineProps<{
+ configId: string
+ skillId: string
+ drawerWidth: number
+}>()
+
+const { t } = useI18n()
+
+const NAV_WIDTH_KEY = 'skill-files-panel:nav-width'
+const DEFAULT_NAV_WIDTH = 208
+const MIN_NAV_WIDTH = 156
+const MAX_NAV_WIDTH = 360
+
+const navWidth = ref(DEFAULT_NAV_WIDTH)
+const splitting = ref(false)
+const navEl = ref<HTMLElement | null>(null)
+const splitLeft = ref(0)
+let splitStartX = 0
+let splitStartWidth = 0
+let splitObserver: ResizeObserver | null = null
+
+function clampNavWidth(width: number) {
+ return Math.max(MIN_NAV_WIDTH, Math.min(MAX_NAV_WIDTH, Math.round(width)))
+}
+
+function syncSplitHandle() {
+ const el = navEl.value
+ if (!el) return
+ splitLeft.value = Math.round(el.getBoundingClientRect().right - 12)
+}
+
+function loadNavWidth() {
+ try {
+ const raw = localStorage.getItem(NAV_WIDTH_KEY)
+ const parsed = raw ? parseInt(raw, 10) : NaN
+ if (!Number.isNaN(parsed)) navWidth.value = clampNavWidth(parsed)
+ } catch {
+ /* ignore */
+ }
+}
+
+function persistNavWidth() {
+ try {
+ localStorage.setItem(NAV_WIDTH_KEY, String(navWidth.value))
+ } catch {
+ /* ignore */
+ }
+}
+
+function onSplitStart(e: MouseEvent) {
+ splitting.value = true
+ splitStartX = e.clientX
+ splitStartWidth = navWidth.value
+ document.addEventListener('mousemove', onSplitMove)
+ document.addEventListener('mouseup', onSplitEnd)
+ document.body.style.cursor = 'col-resize'
+ document.body.style.userSelect = 'none'
+}
+
+function onSplitMove(e: MouseEvent) {
+ navWidth.value = clampNavWidth(splitStartWidth + (e.clientX - splitStartX))
+ syncSplitHandle()
+}
+
+function onSplitEnd() {
+ document.removeEventListener('mousemove', onSplitMove)
+ document.removeEventListener('mouseup', onSplitEnd)
+ document.body.style.cursor = ''
+ document.body.style.userSelect = ''
+ splitting.value = false
+ persistNavWidth()
+}
+
+function cleanupSplit() {
+ document.removeEventListener('mousemove', onSplitMove)
+ document.removeEventListener('mouseup', onSplitEnd)
+ document.body.style.cursor = ''
+ document.body.style.userSelect = ''
+ splitting.value = false
+}
+
+onMounted(() => {
+ loadNavWidth()
+ nextTick(() => {
+ syncSplitHandle()
+ if (navEl.value && typeof ResizeObserver !== 'undefined') {
+ splitObserver = new ResizeObserver(() => syncSplitHandle())
+ splitObserver.observe(navEl.value)
+ }
+ })
+ window.addEventListener('resize', syncSplitHandle, { passive: true })
+})
+
+onUnmounted(() => {
+ window.removeEventListener('resize', syncSplitHandle)
+ splitObserver?.disconnect()
+ splitObserver = null
+ cleanupSplit()
+})
+
+watch(
+ () => [navWidth.value, props.drawerWidth],
+ () => {
+ nextTick(syncSplitHandle)
+ },
+)
+
+const listLoading = ref(false)
+const fileLoading = ref(false)
+const listError = ref('')
+const nodes = ref<FileNode[]>([])
+const expandedDirs = ref<Set<string>>(new Set())
+const selectedPath = ref('')
+const file = ref<ConfigSkillFileContent | null>(null)
+const fileError = ref('')
+const markdownHtml = ref('')
+const highlightedHtml = ref('')
+const markdownMode = ref<'preview' | 'source'>('preview')
+const markdownEl = ref<HTMLElement | null>(null)
+const frontmatterFields = ref<FrontmatterField[]>([])
+const markdownRenderer = createChatMarkdownRenderer({
+ codeRenderer: createMermaidCodeRenderer('skill-files-md'),
+})
+
+const langMap: Record<string, string> = {
+ js: 'javascript',
+ mjs: 'javascript',
+ cjs: 'javascript',
+ ts: 'typescript',
+ tsx: 'typescript',
+ jsx: 'javascript',
+ py: 'python',
+ rb: 'ruby',
+ sh: 'bash',
+ bash: 'bash',
+ yml: 'yaml',
+ yaml: 'yaml',
+ md: 'markdown',
+ markdown: 'markdown',
+ rs: 'rust',
+ kt: 'kotlin',
+ go: 'go',
+ json: 'json',
+ xml: 'xml',
+ html: 'xml',
+ css: 'css',
+ sql: 'sql',
+ toml: 'ini',
+ ini: 'ini',
+ conf: 'ini',
+}
+
+function fileIcon(name: string): string {
+ return getFileIcon(name)
+}
+
+function extOf(path: string): string {
+ const base = path.split('/').pop() || path
+ const idx = base.lastIndexOf('.')
+ if (idx < 0) return ''
+ return base.slice(idx + 1).toLowerCase()
+}
+
+function isMarkdown(path: string): boolean {
+ const ext = extOf(path)
+ return ext === 'md' || ext === 'markdown'
+}
+
+function buildTree(entries: ConfigSkillFileEntry[]): FileNode[] {
+ const root: FileNode = { name: '', path: '', isDir: true, children: [] }
+ for (const entry of entries) {
+ const parts = entry.path.split('/').filter(Boolean)
+ let cur = root
+ parts.forEach((part, i) => {
+ const isLast = i === parts.length - 1
+ const nodePath = parts.slice(0, i + 1).join('/')
+ if (!cur.children) cur.children = []
+ let next = cur.children.find((child) => child.name === part)
+ if (!next) {
+ next = {
+ name: part,
+ path: nodePath,
+ isDir: !isLast,
+ children: isLast ? undefined : [],
+ }
+ cur.children.push(next)
+ } else if (!isLast) {
+ next.isDir = true
+ if (!next.children) next.children = []
+ }
+ cur = next
+ })
+ }
+ const sortNodes = (list: FileNode[]) => {
+ list.sort((a, b) => {
+ if (a.path === 'SKILL.md') return -1
+ if (b.path === 'SKILL.md') return 1
+ if (a.isDir !== b.isDir) return a.isDir ? -1 : 1
+ return a.name.localeCompare(b.name)
+ })
+ list.forEach((node) => node.children && sortNodes(node.children))
+ }
+ sortNodes(root.children || [])
+ return root.children || []
+}
+
+function collectDirs(list: FileNode[], out: Set<string>) {
+ for (const node of list) {
+ if (!node.isDir) continue
+ out.add(node.path)
+ if (node.children) collectDirs(node.children, out)
+ }
+}
+
+function flattenVisible(list: FileNode[], depth: number, expanded: Set<string>, out: VisibleRow[]) {
+ for (const node of list) {
+ out.push({ name: node.name, path: node.path, isDir: node.isDir, depth })
+ if (node.isDir && expanded.has(node.path) && node.children?.length) {
+ flattenVisible(node.children, depth + 1, expanded, out)
+ }
+ }
+}
+
+function toggleDir(path: string) {
+ const next = new Set(expandedDirs.value)
+ if (next.has(path)) next.delete(path)
+ else next.add(path)
+ expandedDirs.value = next
+}
+
+const visibleRows = computed(() => {
+ const out: VisibleRow[] = []
+ flattenVisible(nodes.value, 0, expandedDirs.value, out)
+ return out
+})
+const canToggleMarkdown = computed(() =>
+ Boolean(selectedPath.value && isMarkdown(selectedPath.value) && file.value?.encoding === 'utf-8'),
+)
+const canCopy = computed(() => Boolean(file.value?.content && file.value.encoding === 'utf-8'))
+const showMarkdown = computed(() => canToggleMarkdown.value && markdownMode.value === 'preview')
+const imageSrc = computed(() => {
+ const current = file.value
+ if (!current || current.encoding !== 'base64' || !current.content || !current.media_type) return ''
+ return `data:${current.media_type};base64,${current.content}`
+})
+
+function highlightText(text: string, path: string): string {
+ const ext = extOf(path)
+ const lang = langMap[ext] || ext
+ if (lang && hljs.getLanguage(lang)) {
+ try {
+ return hljs.highlight(text, { language: lang }).value
+ } catch {
+ /* fall through */
+ }
+ }
+ try {
+ return hljs.highlightAuto(text).value
+ } catch {
+ return text.replace(/[&<>]/g, (ch) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;' }[ch] || ch))
+ }
+}
+
+function formatFrontmatterValue(raw: string): { value: string; code: boolean } {
+ let value = raw.trim()
+ if (
+ (value.startsWith('"') && value.endsWith('"') && value.length >= 2) ||
+ (value.startsWith("'") && value.endsWith("'") && value.length >= 2)
+ ) {
+ value = value.slice(1, -1)
+ }
+ if (
+ (value.startsWith('{') && value.endsWith('}')) ||
+ (value.startsWith('[') && value.endsWith(']'))
+ ) {
+ try {
+ return { value: JSON.stringify(JSON.parse(value), null, 2), code: true }
+ } catch {
+ return { value, code: true }
+ }
+ }
+ return { value, code: false }
+}
+
+function parseFrontmatterFields(raw: string): FrontmatterField[] {
+ const fields: FrontmatterField[] = []
+ for (const line of raw.split(/\r?\n/)) {
+ const trimmed = line.trim()
+ if (!trimmed || trimmed.startsWith('#')) continue
+ const idx = trimmed.indexOf(':')
+ if (idx <= 0) continue
+ const key = trimmed.slice(0, idx).trim()
+ if (!/^[A-Za-z0-9_-]+$/.test(key)) continue
+ const formatted = formatFrontmatterValue(trimmed.slice(idx + 1))
+ fields.push({ key, ...formatted })
+ }
+ return fields
+}
+
+function splitMarkdownFrontmatter(text: string): { fields: FrontmatterField[]; body: string } {
+ const src = text.replace(/^\uFEFF/, '')
+ const match = src.match(/^(?:[ \t]*\r?\n)*---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/)
+ if (!match) return { fields: [], body: src }
+ return {
+ fields: parseFrontmatterFields(match[1]),
+ body: src.slice(match[0].length),
+ }
+}
+
+function renderMarkdown(text: string) {
+ const { fields, body } = splitMarkdownFrontmatter(text)
+ frontmatterFields.value = fields
+ markdownHtml.value = body.trim()
+ ? renderChatMarkdown(body, {
+ renderer: markdownRenderer,
+ escapeMarkdown: safeMarkdownToHTML,
+ sanitizeHtml: sanitizeMarkdownHTML,
+ })
+ : ''
+}
+
+async function enhancePreview() {
+ if (!showMarkdown.value || fileLoading.value || !markdownHtml.value) return
+ await nextTick()
+ await enhanceMarkdownContainer(markdownEl.value)
+}
+
+async function selectFile(path: string) {
+ if (!props.configId || !props.skillId) return
+ selectedPath.value = path
+ fileLoading.value = true
+ fileError.value = ''
+ file.value = null
+ markdownHtml.value = ''
+ highlightedHtml.value = ''
+ frontmatterFields.value = []
+ markdownMode.value = 'preview'
+ try {
+ const res = await getConfigSkillFile(props.configId, props.skillId, path)
+ const data = res?.data
+ file.value = data || null
+ if (!data) {
+ fileError.value = t('settings.sandbox.skillFilesFileLoadFailed')
+ return
+ }
+ if (data.encoding === 'utf-8' && data.content != null) {
+ highlightedHtml.value = highlightText(data.content, path)
+ if (isMarkdown(path)) renderMarkdown(data.content)
+ }
+ } catch (e: any) {
+ fileError.value = e?.message || t('settings.sandbox.skillFilesFileLoadFailed')
+ } finally {
+ fileLoading.value = false
+ }
+}
+
+async function copyContent() {
+ const text = file.value?.content
+ if (!text) return
+ await copyWithToast(text, 'common.copied')
+}
+
+async function loadFiles() {
+ if (!props.configId || !props.skillId) return
+ listLoading.value = true
+ listError.value = ''
+ nodes.value = []
+ selectedPath.value = ''
+ file.value = null
+ fileError.value = ''
+ try {
+ const res = await listConfigSkillFiles(props.configId, props.skillId)
+ const list = res?.data || []
+ const tree = buildTree(list)
+ nodes.value = tree
+ const dirs = new Set<string>()
+ collectDirs(tree, dirs)
+ expandedDirs.value = dirs
+ const initial = list.some((item) => item.path === 'SKILL.md') ? 'SKILL.md' : list[0]?.path
+ if (initial) await selectFile(initial)
+ } catch (e: any) {
+ listError.value = e?.message || t('settings.sandbox.skillFilesLoadFailed')
+ } finally {
+ listLoading.value = false
+ }
+}
+
+watch(
+ () => [props.configId, props.skillId],
+ () => {
+ void loadFiles()
+ },
+ { immediate: true },
+)
+
+watch(
+ () => [markdownHtml.value, markdownMode.value, fileLoading.value],
+ () => {
+ void enhancePreview()
+ },
+)
+</script>
+
+<style lang="less" scoped>
+@import '@/components/css/chat-markdown.less';
+
+.skill-files-panel {
+ position: relative;
+ display: flex;
+ min-height: 0;
+ height: 100%;
+ flex: 1;
+ overflow: hidden;
+ background: var(--td-bg-color-container);
+}
+
+.skill-files-panel__nav {
+ width: var(--skill-files-nav-width, 208px);
+ flex-shrink: 0;
+ min-width: 0;
+ min-height: 0;
+ height: 100%;
+ border-right: 1px solid var(--td-component-stroke);
+ overflow: auto;
+ padding: 8px 8px 12px;
+ background: var(--td-bg-color-settings-modal);
+
+ &::-webkit-scrollbar {
+ width: 6px;
+ }
+
+ &::-webkit-scrollbar-thumb {
+ background: var(--td-bg-color-component-disabled);
+ border-radius: 3px;
+ }
+}
+
+.skill-files-panel__list {
+ margin: 0;
+ padding: 0;
+ list-style: none;
+}
+
+.skill-files-panel__item {
+ display: flex;
+ align-items: center;
+ width: 100%;
+ margin-bottom: 2px;
+ padding: 6px 12px;
+ border: 0;
+ border-radius: 6px;
+ background: transparent;
+ font-size: 13px;
+ color: var(--td-text-color-primary);
+ cursor: pointer;
+ text-align: left;
+ user-select: none;
+ transition: background-color 0.2s ease, color 0.2s ease;
+
+ &:hover {
+ background-color: var(--td-bg-color-container-hover);
+ color: var(--td-text-color-primary);
+ }
+
+ &.is-active {
+ background-color: var(--td-bg-color-secondarycontainer);
+ color: var(--td-brand-color);
+ font-weight: 500;
+
+ &:hover {
+ background-color: var(--td-bg-color-secondarycontainer);
+ color: var(--td-brand-color);
+ }
+ }
+}
+
+.skill-files-panel__indent {
+ flex-shrink: 0;
+ height: 1px;
+}
+
+.skill-files-panel__icon {
+ flex-shrink: 0;
+ margin-right: 9px;
+ color: inherit;
+}
+
+.skill-files-panel__name {
+ min-width: 0;
+ flex: 1;
+ overflow: hidden;
+ text-overflow: ellipsis;
+ white-space: nowrap;
+ font-size: inherit;
+ line-height: 1.4;
+ color: inherit;
+}
+
+.skill-files-panel__main {
+ min-width: 0;
+ min-height: 0;
+ height: 100%;
+ flex: 1;
+ display: flex;
+ flex-direction: column;
+ overflow: hidden;
+ background: var(--td-bg-color-container);
+}
+
+.skill-files-panel__bar {
+ display: flex;
+ align-items: center;
+ gap: 4px;
+ flex-shrink: 0;
+ min-height: 40px;
+ padding: 0 12px 0 16px;
+ border-bottom: 1px solid var(--td-component-stroke);
+ background: var(--td-bg-color-container);
+}
+
+.skill-files-panel__path {
+ min-width: 0;
+ flex: 1;
+ overflow: hidden;
+ text-overflow: ellipsis;
+ white-space: nowrap;
+ font-size: 12px;
+ color: var(--td-text-color-secondary);
+}
+
+.skill-files-panel__link {
+ flex-shrink: 0;
+ height: 24px;
+ padding: 0 8px;
+ border: 0;
+ border-radius: 4px;
+ background: transparent;
+ font-size: 12px;
+ line-height: 24px;
+ color: var(--td-text-color-secondary);
+ cursor: pointer;
+
+ &:hover {
+ background: var(--td-bg-color-container-hover);
+ color: var(--td-text-color-primary);
+ }
+}
+
+.skill-files-panel__view {
+ min-height: 0;
+ flex: 1;
+ overflow: auto;
+ overscroll-behavior: contain;
+ padding: 16px 20px 32px;
+
+ &::-webkit-scrollbar {
+ width: 8px;
+ height: 8px;
+ }
+
+ &::-webkit-scrollbar-thumb {
+ background: var(--td-bg-color-component-disabled);
+ border-radius: 4px;
+ }
+}
+
+.skill-files-panel__hint {
+ margin: 24px 8px;
+ text-align: center;
+ font-size: 12px;
+ line-height: 1.5;
+ color: var(--td-text-color-placeholder);
+}
+
+.skill-files-panel__warn {
+ margin: 0 0 8px;
+ font-size: 12px;
+ color: var(--td-warning-color);
+}
+
+.skill-files-panel__meta {
+ margin: 0 0 20px;
+ padding: 8px 12px;
+ border: 1px solid var(--td-component-stroke);
+ border-radius: 8px;
+ background: var(--td-bg-color-secondarycontainer);
+}
+
+.skill-files-panel__meta-row {
+ display: grid;
+ grid-template-columns: 108px minmax(0, 1fr);
+ gap: 4px 12px;
+ padding: 6px 0;
+
+ + .skill-files-panel__meta-row {
+ border-top: 1px solid var(--td-component-stroke);
+ }
+
+ dt {
+ margin: 0;
+ font-size: 12px;
+ font-weight: 500;
+ line-height: 1.5;
+ color: var(--td-text-color-secondary);
+ }
+
+ dd {
+ margin: 0;
+ min-width: 0;
+ font-size: 12px;
+ line-height: 1.5;
+ color: var(--td-text-color-primary);
+ word-break: break-word;
+ white-space: pre-wrap;
+
+ &.is-code {
+ font-family: var(--td-font-family-mono, ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace);
+ font-size: 11px;
+ }
+ }
+}
+
+.skill-files-panel__image {
+ max-width: 100%;
+ height: auto;
+}
+
+.skill-files-panel__code {
+ margin: 0;
+ padding: 0;
+ background: transparent;
+ overflow: visible;
+ font-family: var(--td-font-family-mono, ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace);
+ font-size: 12px;
+ line-height: 1.55;
+ color: var(--td-text-color-primary);
+ white-space: pre-wrap;
+ word-break: break-word;
+}
+
+.skill-files-panel__markdown {
+ min-width: 0;
+ .chat-markdown-typography();
+}
+</style>
+
+<style lang="less">
+.skill-files-split-handle {
+ position: fixed;
+ top: 0;
+ bottom: 0;
+ width: 12px;
+ z-index: 2602;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ cursor: col-resize;
+}
+
+.skill-files-split-handle__line {
+ width: 2px;
+ height: 48px;
+ border-radius: 1px;
+ background: var(--td-component-border);
+ opacity: 0.55;
+ pointer-events: none;
+ transition: opacity 0.15s ease, background 0.15s ease;
+}
+
+.skill-files-split-handle:hover .skill-files-split-handle__line,
+.skill-files-split-handle--active .skill-files-split-handle__line {
+ opacity: 1;
+ background: var(--td-brand-color);
+}
+</style>
diff --git a/frontend/src/i18n/locales/en-US.ts b/frontend/src/i18n/locales/en-US.ts
index 9a28be518..bfb97f01b 100755
--- a/frontend/src/i18n/locales/en-US.ts
+++ b/frontend/src/i18n/locales/en-US.ts
@@ -1310,6 +1310,16 @@ export default {
skillTranscriptHide: 'Hide install run',
skillTranscriptEmpty: 'This install left no transcript.',
skillTranscriptWaiting: 'Install has started. Waiting for the process log…',
+ skillFiles: 'View files',
+ skillFilesTitle: 'Files',
+ skillFilesEmpty: 'This skill has no files to browse yet.',
+ skillFilesLoadFailed: 'Failed to load skill files',
+ skillFilesFileLoadFailed: 'Could not read this file',
+ skillFilesBinary: 'This file is binary and cannot be previewed.',
+ skillFilesTruncated: 'The file is large; only the beginning is shown.',
+ skillFilesSelectHint: 'Select a file on the left to view it',
+ skillFilesPreview: 'Preview',
+ skillFilesSource: 'Source',
skillLoadFailed: 'Failed to load skills',
skillToggleFailed: 'Failed to update the skill',
skillDeleteAccepted: 'Skill removal started',
diff --git a/frontend/src/i18n/locales/ko-KR.ts b/frontend/src/i18n/locales/ko-KR.ts
index 94ba10d05..3b6f58abf 100755
--- a/frontend/src/i18n/locales/ko-KR.ts
+++ b/frontend/src/i18n/locales/ko-KR.ts
@@ -5161,6 +5161,16 @@ export default {
skillTranscriptHide: 'Hide install run',
skillTranscriptEmpty: 'This install left no transcript.',
skillTranscriptWaiting: 'Install has started. Waiting for the process log…',
+ skillFiles: '파일 보기',
+ skillFilesTitle: '파일',
+ skillFilesEmpty: '이 스킬에서 볼 수 있는 파일이 아직 없습니다.',
+ skillFilesLoadFailed: '스킬 파일을 불러오지 못했습니다',
+ skillFilesFileLoadFailed: '이 파일을 읽을 수 없습니다',
+ skillFilesBinary: '이 파일은 바이너리라 미리볼 수 없습니다.',
+ skillFilesTruncated: '파일이 커서 앞부분만 표시합니다.',
+ skillFilesSelectHint: '왼쪽에서 파일을 선택하면 내용을 볼 수 있습니다',
+ skillFilesPreview: '미리보기',
+ skillFilesSource: '원본',
skillLoadFailed: 'Failed to load skills',
skillToggleFailed: 'Failed to update the skill',
skillDeleteAccepted: 'Skill removal started',
diff --git a/frontend/src/i18n/locales/ru-RU.ts b/frontend/src/i18n/locales/ru-RU.ts
index 39709d8f5..c889b3f9f 100755
--- a/frontend/src/i18n/locales/ru-RU.ts
+++ b/frontend/src/i18n/locales/ru-RU.ts
@@ -5161,6 +5161,16 @@ export default {
skillTranscriptHide: 'Hide install run',
skillTranscriptEmpty: 'This install left no transcript.',
skillTranscriptWaiting: 'Install has started. Waiting for the process log…',
+ skillFiles: 'Просмотреть файлы',
+ skillFilesTitle: 'Файлы',
+ skillFilesEmpty: 'У этого навыка пока нет файлов для просмотра.',
+ skillFilesLoadFailed: 'Не удалось загрузить файлы навыка',
+ skillFilesFileLoadFailed: 'Не удалось прочитать этот файл',
+ skillFilesBinary: 'Это двоичный файл, его нельзя просмотреть.',
+ skillFilesTruncated: 'Файл слишком большой, показана только начальная часть.',
+ skillFilesSelectHint: 'Выберите файл слева, чтобы просмотреть содержимое',
+ skillFilesPreview: 'Просмотр',
+ skillFilesSource: 'Исходник',
skillLoadFailed: 'Failed to load skills',
skillToggleFailed: 'Failed to update the skill',
skillDeleteAccepted: 'Skill removal started',
diff --git a/frontend/src/i18n/locales/zh-CN.ts b/frontend/src/i18n/locales/zh-CN.ts
index 59fc7fb03..f69c09cdf 100755
--- a/frontend/src/i18n/locales/zh-CN.ts
+++ b/frontend/src/i18n/locales/zh-CN.ts
@@ -5163,6 +5163,16 @@ export default {
skillTranscriptHide: '收起安装过程',
skillTranscriptEmpty: '这次安装没有留下记录。',
skillTranscriptWaiting: '安装已开始,正在等待过程记录…',
+ skillFiles: '查看文件',
+ skillFilesTitle: '文件',
+ skillFilesEmpty: '该技能还没有可查看的文件。',
+ skillFilesLoadFailed: '加载技能文件失败',
+ skillFilesFileLoadFailed: '无法读取该文件',
+ skillFilesBinary: '该文件是二进制内容,无法在线预览。',
+ skillFilesTruncated: '文件较大,仅显示前一部分。',
+ skillFilesSelectHint: '选择左侧文件以查看内容',
+ skillFilesPreview: '预览',
+ skillFilesSource: '源码',
skillLoadFailed: '加载技能列表失败',
skillToggleFailed: '更新技能状态失败',
skillDeleteAccepted: '已开始删除技能',
diff --git a/internal/application/service/tenant_skill_files.go b/internal/application/service/tenant_skill_files.go
new file mode 100644
index 000000000..3341a7911
--- /dev/null
+++ b/internal/application/service/tenant_skill_files.go
@@ -0,0 +1,216 @@
+package service
+
+import (
+ "bytes"
+ "context"
+ "encoding/base64"
+ "fmt"
+ "io"
+ "path"
+ "sort"
+ "strings"
+ "unicode/utf8"
+
+ apperrors "github.com/Tencent/WeKnora/internal/errors"
+)
+
+// skillFileTextLimit is how much of a text file the admin browser is given.
+// The archive itself may hold up to maxSkillBundleFileBytes; dumping that
+// into a JSON response would freeze the settings drawer.
+const skillFileTextLimit = 1 << 20 // 1 MiB
+
+// skillFileImageLimit is the decoded size cap for an inline image preview.
+const skillFileImageLimit = 2 << 20 // 2 MiB
+
+const (
+ skillFileEncodingUTF8 = "utf-8"
+ skillFileEncodingBase64 = "base64"
+ skillFileEncodingBinary = "binary"
+)
+
+// SkillFileEntry is one path in an installed skill's stored archive.
+type SkillFileEntry struct {
+ Path string `json:"path"`
+ Size int64 `json:"size"`
+}
+
+// SkillFileContent is one file the admin browser asked to open.
+type SkillFileContent struct {
+ Path string `json:"path"`
+ Size int64 `json:"size"`
+ Encoding string `json:"encoding"`
+ Content string `json:"content,omitempty"`
+ MediaType string `json:"media_type,omitempty"`
+ Truncated bool `json:"truncated,omitempty"`
+ Binary bool `json:"binary,omitempty"`
+}
+
+// ListSkillFiles lists the stored archive of one installed skill. The files
+// come from the uploaded bundle rather than the live image: browsing must
+// work while the skill is still installing, and without booting a sandbox.
+func (s *TenantSkillService) ListSkillFiles(
+ ctx context.Context, tenantID uint64, configID, skillID string,
+) ([]SkillFileEntry, error) {
+ files, err := s.skillBundleFiles(ctx, tenantID, configID, skillID)
+ if err != nil {
+ return nil, err
+ }
+ names := make([]string, 0, len(files))
+ for name := range files {
+ names = append(names, name)
+ }
+ sort.Strings(names)
+ out := make([]SkillFileEntry, 0, len(names))
+ for _, name := range names {
+ out = append(out, SkillFileEntry{Path: name, Size: int64(len(files[name]))})
+ }
+ return out, nil
+}
+
+// ReadSkillFile returns one file from the stored archive. Binary files are
+// either inlined as base64 (images small enough to preview) or reported
+// without a body so the UI can say they cannot be opened.
+func (s *TenantSkillService) ReadSkillFile(
+ ctx context.Context, tenantID uint64, configID, skillID, relativePath string,
+) (*SkillFileContent, error) {
+ clean, err := safeSkillFilePath(relativePath)
+ if err != nil {
+ return nil, apperrors.NewBadRequestError(err.Error())
+ }
+ files, err := s.skillBundleFiles(ctx, tenantID, configID, skillID)
+ if err != nil {
+ return nil, err
+ }
+ body, ok := files[clean]
+ if !ok {
+ return nil, apperrors.NewNotFoundError("skill file not found")
+ }
+ return projectSkillFileContent(clean, body), nil
+}
+
+func (s *TenantSkillService) skillBundleFiles(
+ ctx context.Context, tenantID uint64, configID, skillID string,
+) (map[string][]byte, error) {
+ skill, err := s.skills.GetSkill(ctx, tenantID, configID, skillID)
+ if err != nil {
+ return nil, err
+ }
+ if skill == nil {
+ return nil, apperrors.NewNotFoundError("skill not found")
+ }
+ ref := strings.TrimSpace(skill.BundleRef)
+ if ref == "" {
+ return nil, apperrors.NewNotFoundError("skill files are not available")
+ }
+ fs, err := s.fileServiceForTenant(ctx, tenantID)
+ if err != nil {
+ return nil, err
+ }
+ reader, err := fs.GetFile(ctx, ref)
+ if err != nil {
+ return nil, fmt.Errorf("download bundle of skill %s: %w", skill.Name, err)
+ }
+ defer func() { _ = reader.Close() }()
+ archive, err := io.ReadAll(io.LimitReader(reader, maxSkillBundleTotalBytes+1))
+ if err != nil {
+ return nil, fmt.Errorf("read bundle of skill %s: %w", skill.Name, err)
+ }
+ if len(archive) > maxSkillBundleTotalBytes {
+ return nil, fmt.Errorf("skill bundle %s is larger than the upload limit", ref)
+ }
+ bundle, err := ParseSkillBundle(archive)
+ if err != nil {
+ return nil, err
+ }
+ return bundle.Files, nil
+}
+
+// safeSkillFilePath normalises a caller-supplied relative path and refuses
+// anything that leaves the skill directory.
+func safeSkillFilePath(relativePath string) (string, error) {
+ trimmed := strings.TrimSpace(relativePath)
+ if trimmed == "" {
+ return "", fmt.Errorf("skill file path is required")
+ }
+ if strings.Contains(trimmed, "\\") {
+ return "", fmt.Errorf("invalid skill file path: %s", relativePath)
+ }
+ if path.IsAbs(trimmed) {
+ return "", fmt.Errorf("invalid skill file path: %s", relativePath)
+ }
+ for _, seg := range strings.Split(trimmed, "/") {
+ if seg == ".." {
+ return "", fmt.Errorf("invalid skill file path: %s", relativePath)
+ }
+ }
+ clean := path.Clean(trimmed)
+ if clean == "." || clean == ".." || strings.HasPrefix(clean, "../") {
+ return "", fmt.Errorf("invalid skill file path: %s", relativePath)
+ }
+ return clean, nil
+}
+
+func projectSkillFileContent(rel string, body []byte) *SkillFileContent {
+ out := &SkillFileContent{
+ Path: rel,
+ Size: int64(len(body)),
+ }
+ if mediaType, ok := skillImageMediaType(rel); ok {
+ out.MediaType = mediaType
+ if len(body) > skillFileImageLimit {
+ out.Encoding = skillFileEncodingBinary
+ out.Binary = true
+ return out
+ }
+ out.Encoding = skillFileEncodingBase64
+ out.Content = base64.StdEncoding.EncodeToString(body)
+ return out
+ }
+ if skillFileLooksBinary(body) {
+ out.Encoding = skillFileEncodingBinary
+ out.Binary = true
+ return out
+ }
+ out.Encoding = skillFileEncodingUTF8
+ if ext := strings.ToLower(path.Ext(rel)); ext != "" {
+ out.MediaType = "text/plain"
+ if ext == ".md" || ext == ".markdown" {
+ out.MediaType = "text/markdown"
+ }
+ }
+ if len(body) > skillFileTextLimit {
+ out.Content = string(body[:skillFileTextLimit])
+ out.Truncated = true
+ return out
+ }
+ out.Content = string(body)
+ return out
+}
+
+func skillFileLooksBinary(body []byte) bool {
+ if bytes.IndexByte(body, 0) >= 0 {
+ return true
+ }
+ return !utf8.Valid(body)
+}
+
+func skillImageMediaType(rel string) (string, bool) {
+ switch strings.ToLower(path.Ext(rel)) {
+ case ".png":
+ return "image/png", true
+ case ".jpg", ".jpeg":
+ return "image/jpeg", true
+ case ".gif":
+ return "image/gif", true
+ case ".webp":
+ return "image/webp", true
+ case ".bmp":
+ return "image/bmp", true
+ case ".ico":
+ return "image/x-icon", true
+ case ".svg":
+ return "image/svg+xml", true
+ default:
+ return "", false
+ }
+}
diff --git a/internal/application/service/tenant_skill_files_test.go b/internal/application/service/tenant_skill_files_test.go
new file mode 100644
index 000000000..f3290092d
--- /dev/null
+++ b/internal/application/service/tenant_skill_files_test.go
@@ -0,0 +1,133 @@
+package service
+
+import (
+ "context"
+ "encoding/base64"
+ "testing"
+
+ "github.com/stretchr/testify/require"
+
+ apperrors "github.com/Tencent/WeKnora/internal/errors"
+ "github.com/Tencent/WeKnora/internal/types"
+)
+
+func TestListSkillFilesReadsTheStoredArchive(t *testing.T) {
+ fx := newInstallFixture(t)
+ fx.seedStoredSkillBundle(t)
+
+ files, err := fx.svc.ListSkillFiles(context.Background(), 7, "cfg-1", "sk-1")
+ require.NoError(t, err)
+ require.Equal(t, []SkillFileEntry{
+ {Path: "SKILL.md", Size: int64(len(validSkillMD))},
+ {Path: "scripts/extract.py", Size: int64(len("print('hi')\n"))},
+ }, files)
+}
+
+func TestListSkillFilesRefusesAnotherWorkspace(t *testing.T) {
+ fx := newInstallFixture(t)
+ fx.seedStoredSkillBundle(t)
+
+ _, err := fx.svc.ListSkillFiles(context.Background(), 8, "cfg-1", "sk-1")
+ require.Error(t, err)
+ appErr, ok := apperrors.IsAppError(err)
+ require.True(t, ok)
+ require.Equal(t, 404, appErr.HTTPCode)
+}
+
+func TestListSkillFilesReportsMissingBundle(t *testing.T) {
+ fx := newInstallFixture(t)
+
+ _, err := fx.svc.ListSkillFiles(context.Background(), 7, "cfg-1", "sk-1")
+ require.Error(t, err)
+ appErr, ok := apperrors.IsAppError(err)
+ require.True(t, ok)
+ require.Equal(t, 404, appErr.HTTPCode)
+}
+
+func TestReadSkillFileReturnsTextContent(t *testing.T) {
+ fx := newInstallFixture(t)
+ fx.seedStoredSkillBundle(t)
+
+ file, err := fx.svc.ReadSkillFile(context.Background(), 7, "cfg-1", "sk-1", "scripts/extract.py")
+ require.NoError(t, err)
+ require.Equal(t, "scripts/extract.py", file.Path)
+ require.Equal(t, skillFileEncodingUTF8, file.Encoding)
+ require.Equal(t, "print('hi')\n", file.Content)
+ require.False(t, file.Binary)
+}
+
+func TestReadSkillFileRejectsPathTraversal(t *testing.T) {
+ fx := newInstallFixture(t)
+ fx.seedStoredSkillBundle(t)
+
+ for _, rel := range []string{"../secret", "/etc/passwd", "scripts/../../SKILL.md", `scripts\extract.py`} {
+ _, err := fx.svc.ReadSkillFile(context.Background(), 7, "cfg-1", "sk-1", rel)
+ require.Error(t, err, rel)
+ appErr, ok := apperrors.IsAppError(err)
+ require.True(t, ok, rel)
+ require.Equal(t, 400, appErr.HTTPCode, rel)
+ }
+}
+
+func TestReadSkillFileReportsMissingPath(t *testing.T) {
+ fx := newInstallFixture(t)
+ fx.seedStoredSkillBundle(t)
+
+ _, err := fx.svc.ReadSkillFile(context.Background(), 7, "cfg-1", "sk-1", "missing.txt")
+ require.Error(t, err)
+ appErr, ok := apperrors.IsAppError(err)
+ require.True(t, ok)
+ require.Equal(t, 404, appErr.HTTPCode)
+}
+
+func TestReadSkillFileInlinesASmallImage(t *testing.T) {
+ fx := newInstallFixture(t)
+ png := []byte{0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a}
+ archive := zipBundle(t, map[string]string{
+ "SKILL.md": validSkillMD,
+ "assets/a.png": string(png),
+ })
+ fx.storeSkillBundle(t, "sk-1", archive)
+
+ file, err := fx.svc.ReadSkillFile(context.Background(), 7, "cfg-1", "sk-1", "assets/a.png")
+ require.NoError(t, err)
+ require.Equal(t, skillFileEncodingBase64, file.Encoding)
+ require.Equal(t, "image/png", file.MediaType)
+ decoded, err := base64.StdEncoding.DecodeString(file.Content)
+ require.NoError(t, err)
+ require.Equal(t, png, decoded)
+}
+
+func TestProjectSkillFileContentMarksBinaryWithoutInlining(t *testing.T) {
+ got := projectSkillFileContent("scripts/tool.bin", []byte{0x00, 0x01, 0xff})
+ require.True(t, got.Binary)
+ require.Equal(t, skillFileEncodingBinary, got.Encoding)
+ require.Empty(t, got.Content)
+}
+
+func (f *installFixture) seedStoredSkillBundle(t *testing.T) {
+ t.Helper()
+ archive, err := zipSkillFiles(map[string][]byte{
+ "SKILL.md": []byte(validSkillMD),
+ "scripts/extract.py": []byte("print('hi')\n"),
+ })
+ require.NoError(t, err)
+ f.storeSkillBundle(t, "sk-1", archive)
+}
+
+func (f *installFixture) storeSkillBundle(t *testing.T, skillID string, archive []byte) {
+ t.Helper()
+ ctx := context.Background()
+ skill, err := f.skillRepo.GetSkill(ctx, 7, "cfg-1", skillID)
+ require.NoError(t, err)
+ require.NotNil(t, skill)
+ skill.BundleRef = "file://bundle.zip"
+ skill.Status = types.SkillStatusReady
+ require.NoError(t, f.skillRepo.UpdateSkill(ctx, skill))
+ if f.storedBundles == nil {
+ f.storedBundles = map[string][]byte{}
+ }
+ copied := make([]byte, len(archive))
+ copy(copied, archive)
+ f.storedBundles["file://bundle.zip"] = copied
+}
diff --git a/internal/application/service/tenant_skill_install_test.go b/internal/application/service/tenant_skill_install_test.go
index a472fbbd9..bd4b8e378 100644
--- a/internal/application/service/tenant_skill_install_test.go
+++ b/internal/application/service/tenant_skill_install_test.go
@@ -1205,6 +1205,9 @@ type installFixture struct {
// whose archive will later be unreadable.
saveErr error
savedBundles int
+ // storedBundles is what GetFile serves back, keyed by the SaveBytes
+ // reference, so ListSkillFiles / ReadSkillFile can open a stored archive.
+ storedBundles map[string][]byte
}
func newInstallFixture(t *testing.T) *installFixture {
@@ -2208,17 +2211,30 @@ func (installFileService) SaveFile(context.Context, *multipart.FileHeader, uint6
return "", nil
}
-func (s installFileService) SaveBytes(context.Context, []byte, uint64, string, bool) (string, error) {
+func (s installFileService) SaveBytes(_ context.Context, data []byte, _ uint64, _ string, _ bool) (string, error) {
if s.fx != nil {
s.fx.savedBundles++
if s.fx.saveErr != nil {
return "", s.fx.saveErr
}
+ if s.fx.storedBundles == nil {
+ s.fx.storedBundles = map[string][]byte{}
+ }
+ copied := make([]byte, len(data))
+ copy(copied, data)
+ s.fx.storedBundles["file://bundle.zip"] = copied
}
return "file://bundle.zip", nil
}
-func (installFileService) GetFile(context.Context, string) (io.ReadCloser, error) { return nil, nil }
-func (installFileService) GetFileURL(context.Context, string) (string, error) { return "", nil }
+func (s installFileService) GetFile(_ context.Context, ref string) (io.ReadCloser, error) {
+ if s.fx != nil {
+ if data, ok := s.fx.storedBundles[ref]; ok {
+ return io.NopCloser(bytes.NewReader(data)), nil
+ }
+ }
+ return nil, errors.New("bundle not found")
+}
+func (installFileService) GetFileURL(context.Context, string) (string, error) { return "", nil }
func (s installFileService) DeleteFile(_ context.Context, ref string) error {
if s.fx != nil {
s.fx.deletedBundles = append(s.fx.deletedBundles, ref)
diff --git a/internal/handler/sandbox_skill.go b/internal/handler/sandbox_skill.go
index a7f25fbbf..b40129681 100644
--- a/internal/handler/sandbox_skill.go
+++ b/internal/handler/sandbox_skill.go
@@ -44,6 +44,12 @@ const (
type sandboxSkillService interface {
ListSkills(ctx context.Context, tenantID uint64, configID string) ([]*types.TenantSkillEntity, error)
GetSkill(ctx context.Context, tenantID uint64, configID, skillID string) (*types.TenantSkillEntity, error)
+ ListSkillFiles(
+ ctx context.Context, tenantID uint64, configID, skillID string,
+ ) ([]service.SkillFileEntry, error)
+ ReadSkillFile(
+ ctx context.Context, tenantID uint64, configID, skillID, relativePath string,
+ ) (*service.SkillFileContent, error)
SetSkillEnabled(
ctx context.Context, tenantID uint64, configID, skillID string, enabled bool,
) (*types.TenantSkillEntity, error)
@@ -185,6 +191,57 @@ func (h *SandboxSkillHandler) Get(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{"success": true, "data": toSkillResponse(skill)})
}
+// ListFiles godoc
+// @Summary List files of an installed skill
+// @Description List files in the stored skill bundle without starting a sandbox.
+// @Tags SandboxConfig
+// @Produce json
+// @Param id path string true "Sandbox config ID"
+// @Param skillId path string true "Skill ID"
+// @Success 200 {object} map[string]interface{} "Skill files"
+// @Failure 401 {object} map[string]interface{} "Unauthorized"
+// @Failure 404 {object} apperrors.AppError "Skill or files not found"
+// @Security Bearer
+// @Security ApiKeyAuth
+// @Router /sandbox-configs/{id}/skills/{skillId}/files [get]
+func (h *SandboxSkillHandler) ListFiles(c *gin.Context) {
+ files, err := h.service.ListSkillFiles(
+ c.Request.Context(), sandboxConfigTenantID(c), c.Param("id"), c.Param("skillId"),
+ )
+ if err != nil {
+ _ = c.Error(err)
+ return
+ }
+ c.JSON(http.StatusOK, gin.H{"success": true, "data": files})
+}
+
+// GetFile godoc
+// @Summary Read one file of an installed skill
+// @Description Read one skill file as UTF-8, a small base64 image, or binary.
+// @Tags SandboxConfig
+// @Produce json
+// @Param id path string true "Sandbox config ID"
+// @Param skillId path string true "Skill ID"
+// @Param path query string true "Skill-root-relative file path"
+// @Success 200 {object} map[string]interface{} "Skill file"
+// @Failure 400 {object} apperrors.AppError "Invalid path"
+// @Failure 401 {object} map[string]interface{} "Unauthorized"
+// @Failure 404 {object} apperrors.AppError "Skill or file not found"
+// @Security Bearer
+// @Security ApiKeyAuth
+// @Router /sandbox-configs/{id}/skills/{skillId}/files/content [get]
+func (h *SandboxSkillHandler) GetFile(c *gin.Context) {
+ file, err := h.service.ReadSkillFile(
+ c.Request.Context(), sandboxConfigTenantID(c),
+ c.Param("id"), c.Param("skillId"), c.Query("path"),
+ )
+ if err != nil {
+ _ = c.Error(err)
+ return
+ }
+ c.JSON(http.StatusOK, gin.H{"success": true, "data": file})
+}
+
// Upload godoc
// @Summary Install a skill
// @Description Install a skill onto this sandbox config's image. Send a zip
diff --git a/internal/handler/sandbox_skill_test.go b/internal/handler/sandbox_skill_test.go
index dd911b258..15fb3b552 100644
--- a/internal/handler/sandbox_skill_test.go
+++ b/internal/handler/sandbox_skill_test.go
@@ -17,6 +17,7 @@ import (
"github.com/stretchr/testify/require"
"github.com/Tencent/WeKnora/internal/application/service"
+ apperrors "github.com/Tencent/WeKnora/internal/errors"
"github.com/Tencent/WeKnora/internal/middleware"
"github.com/Tencent/WeKnora/internal/types"
"github.com/Tencent/WeKnora/internal/types/interfaces"
@@ -41,6 +42,12 @@ type fakeSandboxSkillService struct {
sourceErr error
removeErr error
+ files []service.SkillFileEntry
+ file *service.SkillFileContent
+ filesErr error
+ fileErr error
+ filePath string
+
last service.SkillProgress
hasLast bool
events chan service.SkillProgress
@@ -115,6 +122,39 @@ func (f *fakeSandboxSkillService) SetSkillEnabled(
return skill, nil
}
+func (f *fakeSandboxSkillService) ListSkillFiles(
+ _ context.Context, tenantID uint64, configID, skillID string,
+) ([]service.SkillFileEntry, error) {
+ if f.filesErr != nil {
+ return nil, f.filesErr
+ }
+ skill, err := f.GetSkill(context.Background(), tenantID, configID, skillID)
+ if err != nil {
+ return nil, err
+ }
+ if skill == nil {
+ return nil, apperrors.NewNotFoundError("skill not found")
+ }
+ return f.files, nil
+}
+
+func (f *fakeSandboxSkillService) ReadSkillFile(
+ _ context.Context, tenantID uint64, configID, skillID, relativePath string,
+) (*service.SkillFileContent, error) {
+ f.filePath = relativePath
+ if f.fileErr != nil {
+ return nil, f.fileErr
+ }
+ skill, err := f.GetSkill(context.Background(), tenantID, configID, skillID)
+ if err != nil {
+ return nil, err
+ }
+ if skill == nil {
+ return nil, apperrors.NewNotFoundError("skill not found")
+ }
+ return f.file, nil
+}
+
func (f *fakeSandboxSkillService) InstallSkill(
_ context.Context, tenantID uint64, configID string, archive []byte,
) (string, error) {
@@ -198,6 +238,8 @@ func newSkillTestRouter(h *SandboxSkillHandler) *gin.Engine {
r.GET("/sandbox-configs/:id/skills", h.List)
r.POST("/sandbox-configs/:id/skills", h.Upload)
r.GET("/sandbox-configs/:id/skills/:skillId", h.Get)
+ r.GET("/sandbox-configs/:id/skills/:skillId/files", h.ListFiles)
+ r.GET("/sandbox-configs/:id/skills/:skillId/files/content", h.GetFile)
r.PATCH("/sandbox-configs/:id/skills/:skillId", h.Patch)
r.DELETE("/sandbox-configs/:id/skills/:skillId", h.Delete)
r.GET("/sandbox-configs/:id/skills/:skillId/install-events", h.InstallEvents)
@@ -937,3 +979,88 @@ func transcriptTypes(frames []types.StreamResponse) []string {
}
return out
}
+
+func TestSandboxSkillListFilesReturnsTheArchive(t *testing.T) {
+ svc := &fakeSandboxSkillService{
+ skills: map[string]*types.TenantSkillEntity{
+ "skill-1": {ID: "skill-1", SandboxConfigID: "cfg-a", Name: "pdf"},
+ },
+ files: []service.SkillFileEntry{
+ {Path: "SKILL.md", Size: 12},
+ {Path: "scripts/run.py", Size: 20},
+ },
+ }
+ router := newSkillTestRouter(NewSandboxSkillHandler(svc, nil))
+
+ w := httptest.NewRecorder()
+ req := httptest.NewRequest(http.MethodGet, "/sandbox-configs/cfg-a/skills/skill-1/files", nil)
+ router.ServeHTTP(w, req)
+
+ require.Equal(t, http.StatusOK, w.Code, "body=%s", w.Body.String())
+ var body struct {
+ Success bool `json:"success"`
+ Data []service.SkillFileEntry `json:"data"`
+ }
+ require.NoError(t, json.Unmarshal(w.Body.Bytes(), &body))
+ require.True(t, body.Success)
+ require.Equal(t, svc.files, body.Data)
+}
+
+func TestSandboxSkillListFilesMissingSkillReturns404(t *testing.T) {
+ router := newSkillTestRouter(NewSandboxSkillHandler(&fakeSandboxSkillService{}, nil))
+
+ w := httptest.NewRecorder()
+ req := httptest.NewRequest(http.MethodGet, "/sandbox-configs/cfg-a/skills/missing/files", nil)
+ router.ServeHTTP(w, req)
+
+ require.Equal(t, http.StatusNotFound, w.Code, "body=%s", w.Body.String())
+}
+
+func TestSandboxSkillGetFileReturnsContent(t *testing.T) {
+ svc := &fakeSandboxSkillService{
+ skills: map[string]*types.TenantSkillEntity{
+ "skill-1": {ID: "skill-1", SandboxConfigID: "cfg-a", Name: "pdf"},
+ },
+ file: &service.SkillFileContent{
+ Path: "scripts/run.py",
+ Size: 11,
+ Encoding: "utf-8",
+ Content: "print('hi')",
+ },
+ }
+ router := newSkillTestRouter(NewSandboxSkillHandler(svc, nil))
+
+ w := httptest.NewRecorder()
+ req := httptest.NewRequest(
+ http.MethodGet, "/sandbox-configs/cfg-a/skills/skill-1/files/content?path=scripts/run.py", nil,
+ )
+ router.ServeHTTP(w, req)
+
+ require.Equal(t, http.StatusOK, w.Code, "body=%s", w.Body.String())
+ require.Equal(t, "scripts/run.py", svc.filePath)
+ var body struct {
+ Success bool `json:"success"`
+ Data service.SkillFileContent `json:"data"`
+ }
+ require.NoError(t, json.Unmarshal(w.Body.Bytes(), &body))
+ require.Equal(t, "print('hi')", body.Data.Content)
+}
+
+func TestSandboxSkillGetFileInvalidPathReturns400(t *testing.T) {
+ svc := &fakeSandboxSkillService{
+ skills: map[string]*types.TenantSkillEntity{
+ "skill-1": {ID: "skill-1", SandboxConfigID: "cfg-a"},
+ },
+ fileErr: apperrors.NewBadRequestError("invalid skill file path: ../secret"),
+ }
+ router := newSkillTestRouter(NewSandboxSkillHandler(svc, nil))
+
+ w := httptest.NewRecorder()
+ req := httptest.NewRequest(
+ http.MethodGet, "/sandbox-configs/cfg-a/skills/skill-1/files/content?path=../secret", nil,
+ )
+ router.ServeHTTP(w, req)
+
+ require.Equal(t, http.StatusBadRequest, w.Code, "body=%s", w.Body.String())
+ require.Equal(t, "../secret", svc.filePath)
+}
diff --git a/internal/router/router_api_key_capabilities_test.go b/internal/router/router_api_key_capabilities_test.go
index eae9f309f..e2b970be7 100644
--- a/internal/router/router_api_key_capabilities_test.go
+++ b/internal/router/router_api_key_capabilities_test.go
@@ -406,6 +406,8 @@ func TestSandboxConfigRoutesRequireFullAccessOnly(t *testing.T) {
{http.MethodGet, "/api/v1/sandbox-configs/:id/skills"},
{http.MethodPost, "/api/v1/sandbox-configs/:id/skills"},
{http.MethodGet, "/api/v1/sandbox-configs/:id/skills/:skillId"},
+ {http.MethodGet, "/api/v1/sandbox-configs/:id/skills/:skillId/files"},
+ {http.MethodGet, "/api/v1/sandbox-configs/:id/skills/:skillId/files/content"},
{http.MethodPatch, "/api/v1/sandbox-configs/:id/skills/:skillId"},
{http.MethodDelete, "/api/v1/sandbox-configs/:id/skills/:skillId"},
{http.MethodGet, "/api/v1/sandbox-configs/:id/skills/:skillId/install-events"},
diff --git a/internal/router/routes_infra.go b/internal/router/routes_infra.go
index 76a2fdd57..316287ccc 100644
--- a/internal/router/routes_infra.go
+++ b/internal/router/routes_infra.go
@@ -65,6 +65,8 @@ func RegisterSandboxConfigRoutes(
configs.GET("/:id/skills", g.Admin(), skills.List)
configs.POST("/:id/skills", g.Admin(), skills.Upload)
configs.GET("/:id/skills/:skillId", g.Admin(), skills.Get)
+ configs.GET("/:id/skills/:skillId/files", g.Admin(), skills.ListFiles)
+ configs.GET("/:id/skills/:skillId/files/content", g.Admin(), skills.GetFile)
configs.PATCH("/:id/skills/:skillId", g.Admin(), skills.Patch)
configs.DELETE("/:id/skills/:skillId", g.Admin(), skills.Delete)
configs.GET("/:id/skills/:skillId/install-events", g.Admin(), skills.InstallEvents)