@bitfun-vsl/plugin 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenBitFun
+
+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

@@ -1,3 +1,62 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @bitfun-vsl/plugin
+
+VSL 是一个面向 DevEco Code、Claude Code 和 BitFun 的精简插件包。插件模块由四类资源组成：Command、Agent、Skill 和 Tool。
+
+当前内置轨迹分析 mock 模块和代码审查模块。轨迹模块用于验证注册和调用链路：
+
+```text
+/vsl:trajectory
+  -> vsl-trajectory Agent
+  -> vsl-trajectory-analysis Skill
+  -> vsl_trajectory_read / analyze / report
+```
+
+代码审查通过 `/vsl:review` 调用 `vsl_cr_review`，完整执行 CR 的 `cr review` 引擎，使用 CR 自己的模型配置。该模块只注册 Command 和 Tool。使用 `/vsl:cr-health` 检查环境。
+
+集成说明见 [CR 代码审查文档](docs/code-review-integration.md)。本地设置 `VSL_CR_BIN` 为原生 CR 程序绝对路径，或将原生程序加入 PATH。
+
+## 安装
+
+需要 Bun、npm；选择 Claude Code 时还需要 Claude CLI。`vsl init` 按顺序显示两个复选列表：先选宿主（DevEco Code、Claude Code、BitFun，可多选），再选模块（默认全部勾选），最后只确认一次是否执行安装。方向键移动，空格勾选，`a` 全选，回车继续，Ctrl+C 取消。
+
+本地包在本目录构建并启动向导：
+
+```powershell
+npm pack
+bun .\dist\cli\index.js init --package "$PWD\bitfun-vsl-plugin-0.0.1.tgz"
+```
+
+发布到 npm 后，用户先安装提供 CLI 的包，再运行同一个向导：
+
+```powershell
+npm install -g @bitfun-vsl/plugin
+vsl init
+```
+
+全局安装只提供 `vsl` 命令；init 负责更新宿主实际加载的依赖和注册。DevEco 安装到 `~/.config/deveco/node_modules/@bitfun-vsl/plugin`；BitFun 在 Windows 安装到 `%APPDATA%/bitfun/config/node_modules/@bitfun-vsl/plugin` 并注册 BitFun 专用入口，同时生成 `~/.config/opencode/command/vsl/*.md`；Claude 使用原生 marketplace/plugin 安装机制。宿主仍按原生插件方式加载资源。
+
+模块包括 `trajectory-analysis` 和 `code-review`。模块中的 Command、Agent、Skill、Tool 随模块一起启停；安装向导不按资源分类让用户选择。代码审查需要独立的 CR 原生程序，可设置 `VSL_CR_BIN` 或使用 `--cr-bin <绝对路径>`。
+
+自动化可明确选择一个或多个宿主并跳过交互：
+
+```powershell
+vsl init --host deveco --host bitfun --modules trajectory-analysis,code-review --yes
+vsl doctor --host deveco --json
+vsl doctor --host bitfun --json
+```
+
+安装后重启宿主，调用 `vsl_runtime_info` 核对 `buildId`、`installationId` 和模块，再执行 `/vsl:trajectory sample.trace`（轨迹 mock）或 `/vsl:cr-health`。`doctor` 仅证明文件及注册正确，宿主加载状态由运行时工具证明。
+
+BitFun 使用斜杠命名：`/vsl/trajectory sample.trace`、`/vsl/cr-health`、`/vsl/review`。需要启用 OpenCode 外部兼容。VSL 会把命令文件安装到 BitFun 扫描的 OpenCode 目录；当前 BitFun CLI 只在进入会话后刷新外部命令，启动页显示需要宿主侧支持。具体配置见 [BitFun 安装说明](docs/init-installation.md)。
+
+已有原生手工安装入口继续保留；init 对同一宿主只注册一个 VSL 入口。已有无安装清单的旧包或未托管的 VSL file URL 会报告冲突，应先备份并移除对应旧注册/依赖，再运行 init。init 不覆盖用户修改的受管文件。详见 [安装与手动验证](docs/init-installation.md)。
+
+## 开发
+
+```bash
+bun install --ignore-scripts
+bun test
+bun run build
+```
+
+共享契约在 `src/plugin`，OpenCode 插件宿主实现在 `src/hosts/shared`，DevEco 适配器在 `src/hosts/deveco`，BitFun kernel 适配器在 `src/hosts/bitfun-kernel`，Claude MCP 适配器在 `src/hosts/claude-code`。

package/assets/bitfun/command/vsl/cr-health.md

@@ -0,0 +1,5 @@
+---
+description: "Check CR executable, CLI compatibility, and optionally its model connection"
+---
+
+Use vsl_cr_health. Only set checkConnection=true when the user asks to test the model connection. Report executable path, version, compatibility and diagnostics. User request: $ARGUMENTS

package/assets/bitfun/command/vsl/review.md

@@ -0,0 +1,5 @@
+---
+description: "Run a complete CR review of workspace, commit, or branch changes"
+---
+
+Use vsl_cr_review to run the complete CR engine. Convert the user's scope to structured arguments; pass the current repository. Default to workspace review. CR uses its own model configuration. Report manifest terminal state and coverage; partial/skipped/failed are not complete. Preserve CR findings and severity; do not substitute your own review. If findingsTruncated or detailsTruncated is true, read resultFile in bounded batches before reporting results. Preview is scope only. Resume requires the original commit or from/to. Do not modify code or publish comments unless requested. User request: $ARGUMENTS

package/assets/bitfun/command/vsl/trajectory.md

@@ -0,0 +1,8 @@
+---
+description: "分析指定轨迹并生成分析结果"
+---
+
+分析用户指定的轨迹。
+先加载 vsl-trajectory-analysis Skill。
+必须调用 vsl_trajectory_analyze，不要仅根据对话内容推测结果。
+用户参数：$ARGUMENTS

package/assets/build.json

@@ -0,0 +1,4 @@
+{
+  "version": "0.0.1",
+  "buildId": "bbceff2246e5fb0e4b93bb05081457dbc113400b937c6148764573618d8534b5"
+}

package/assets/claude-code/.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "vsl",
+  "version": "0.0.1",
+  "description": "VSL shared modules and tools"
+}

package/assets/claude-code/.mcp.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "vsl": {
+      "command": "bun",
+      "args": [
+        "${CLAUDE_PLUGIN_ROOT}/scripts/mcp-server.js"
+      ]
+    }
+  }
+}

package/assets/claude-code/agents/vsl-trajectory.md

@@ -0,0 +1,6 @@
+---
+name: "vsl-trajectory"
+description: "负责组织轨迹分析工具调用"
+---
+
+你负责分析轨迹。先加载 vsl-trajectory-analysis，再调用确定性的轨迹工具。

package/assets/claude-code/commands/cr-health.md

@@ -0,0 +1,7 @@
+---
+description: "Check CR executable, CLI compatibility, and optionally its model connection"
+---
+
+Use the VSL MCP tools with their registered host prefix. Pass the absolute current project as repo when applicable.
+
+Use vsl_cr_health. Only set checkConnection=true when the user asks to test the model connection. Report executable path, version, compatibility and diagnostics. User request: $ARGUMENTS

package/assets/claude-code/commands/review.md

@@ -0,0 +1,7 @@
+---
+description: "Run a complete CR review of workspace, commit, or branch changes"
+---
+
+Use the VSL MCP tools with their registered host prefix. Pass the absolute current project as repo when applicable.
+
+Use vsl_cr_review to run the complete CR engine. Convert the user's scope to structured arguments; pass the current repository. Default to workspace review. CR uses its own model configuration. Report manifest terminal state and coverage; partial/skipped/failed are not complete. Preserve CR findings and severity; do not substitute your own review. If findingsTruncated or detailsTruncated is true, read resultFile in bounded batches before reporting results. Preview is scope only. Resume requires the original commit or from/to. Do not modify code or publish comments unless requested. User request: $ARGUMENTS

package/assets/claude-code/commands/trajectory.md

@@ -0,0 +1,10 @@
+---
+description: "分析指定轨迹并生成分析结果"
+---
+
+Use the VSL MCP tools with their registered host prefix. Pass the absolute current project as repo when applicable.
+
+分析用户指定的轨迹。
+先加载 vsl-trajectory-analysis Skill。
+必须调用 vsl_trajectory_analyze，不要仅根据对话内容推测结果。
+用户参数：$ARGUMENTS