启用工作区

workspace 扩展给每个意识实例一个工作目录和四个工具（bash、read_file、write_file、edit_file），外加技能（skills）注入。适合让 bot 处理文件、跑脚本、维护自己的桌面。

第一步：启用扩展Copy Anchor Link

在 Koishi 插件市场安装 koishi-plugin-ishiki-workspace，再到「插件配置」启用。启用后在 profile 中声明：

extends:
  workspace:
    config:              # 全部字段可省略，以下是常用项
      backend: sandbox   # sandbox | native
      network: false
      javascript: false
      python: false
      skills: []         # 额外技能目录，相对 profile 目录
      mounts: []         # 仅 sandbox：宿主目录挂载

第二步：选后端Copy Anchor Link

backend 决定命令跑在哪：

默认 sandbox 足够大多数场景：bot 能在自己的小天地里跑命令、管理文件，弄不坏宿主机。native 适合让 bot 操作真实项目目录的场景，用前想清楚权限暴露面：

extends:
  workspace:
    config:
      backend: native
      shell: "D:\\Application\\Scoop\\apps\\git\\current\\bin\\bash.exe"   # Windows 下换 bash 的写法

native 模式下 /tmp 没有统一定义：shell 自己按 MSYS 的挂载点解析（Git Bash 通常是 C:/Users/<用户名>/AppData/Local/Temp），由 shell 启动的宿主程序按宿主环境变量解析，文件工具按 shell 自报的同一个位置解析。提示词因此要求把中间文件放在工作目录下的 tmp/，相对路径是这三方都认的写法。

sandbox 的世界长什么样Copy Anchor Link

实例内的路径布局固定：

宿主目录挂载的写法是 "source:target[:ro]"，source 相对 profile 目录解析：

      mounts:
        - "./shared:/opt/shared"          # 可读写
        - "D:/datasets:/data:ro"          # 只读

规则：target 必须是绝对路径、不能互相嵌套、不能落在 /home 之下；可写挂载的 source 目录不存在时会自动创建，只读挂载则直接报错。

read 通过 workspace:///绝对虚拟路径 访问同一个沙箱文件系统。例如 workspace:///home/workspace/report.txt 读取持久文件，workspace:///tmp/result.txt 读取沙箱临时文件，workspace:///data/input.csv 读取上面的挂载文件。目录、二进制媒体和行选择共用 FileScheme。

资源中心中的 asset 与 artifact 也可通过 /home/.ishiki 在沙箱里读取；URL 与挂载路径取得相同字节。native 后端没有虚拟根，workspace URL 指向实际宿主路径，沿用 native 的权限范围。

加法：JavaScript 与 PythonCopy Anchor Link

sandbox 默认只有 bash。开启后 bot 能在沙箱里跑 JS/TS（QuickJS）或 Python（wasm 编译的 CPython），只能访问沙箱内的文件：

      javascript: true
      python: true

两者都会扩大代码执行面，按需开启。

第三步（可选）：放技能Copy Anchor Link

技能（skill）是一个含 SKILL.md 的目录，bot 启动时发现它们并把目录注入系统提示词，bot 用 bash 等工具按目录里的说明行事。

两个放置位置：

• 数据根技能库：<dataPath>/skills/<技能名>/SKILL.md，对启用 workspace 的所有 profile 生效。
• profile 专属：profile 里 skills: ["./my-skills"] 指向的目录（相对 profile 目录），同名技能优先于数据根。

以数据根技能库为例，一个技能目录长这样：

SKILL.md 用 YAML frontmatter：

---
name: report-builder
description: 按模板把周报数据整理成 Markdown 表格
---

## 用法
1. 读取 /home/workspace/weekly.csv …

约束：目录名必须与 name 一致且只含小写字母、数字、连字符（如 report-builder）；description 必填，缺失的技能被跳过并记警告。后发现的同名技能覆盖先发现的。

工具行为速查Copy Anchor Link

命令输出超过 maxExecutionOutputBytes（默认 32 MiB）会被截断，模型可见的展示还受全局文本预算约束（见参考：模型工具）。

验证Copy Anchor Link

激活 profile 后在日志确认扩展装配无 missing required service。然后私聊 bot：「用 bash 看看你的工作目录里有什么」。sandbox 后端它应列出 /home/workspace（初始为空）；native 后端列出真实目录。