@vasm/console 0.6.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @vasm/console
+
+## 0.6.0
+
+### Minor Changes
+
+- Strengthen activation governance and split the published VASMC packages into fixed-version core, CLI, and console artifacts.

package/README.md

@@ -0,0 +1,56 @@
+# @vasm/console
+
+`@vasm/console` 发布 `vasm-console` 命令，面向人类开发者提供可选的外部模型辅助能力。它不负责 AI 编译入口；`lint` 和 `diff` 这类语义工具只存在于 console 包中。
+
+<a name="console"></a>
+
+## 🧭 @vasm/console：人用控制台与可选外部模型工具
+
+`@vasm/console` 提供 `vasm-console` 命令，面向人类开发者使用。它复用确定性编译能力，但额外提供需要外部模型的语义辅助命令。
+
+### 安装
+
+```bash
+npm install -g @vasm/console
+```
+
+### 语义校验
+
+编译完成后，可以对产物执行 LLM 驱动的语义冲突检测：
+
+```bash
+vasmc build main.vasm.md
+vasm-console lint main.md --model gpt-4o
+```
+
+`lint` 会检查四类问题：指令冲突、人格分裂、逻辑冗余和系统破坏风险。它不属于确定性编译链，失败时不会改变源文件或产物文件。
+
+### 语义 Diff
+
+```bash
+vasm-console diff new.md old.md --model gpt-4o
+```
+
+`diff` 会解释两个编译产物之间的语义和结构影响，而不是只报告文本差异。
+
+### 外部模型配置
+
+`vasm-console` 可以通过环境变量或 `.vasmrc` 配置 OpenAI-compatible 节点。`.vasmrc` 可以放在用户目录或项目根目录；项目内 `.vasmrc` 应加入 `.gitignore`。
+
+```yaml
+lang: "zh-CN"
+llm:
+  baseURL: "https://api.deepseek.com/v1"
+  apiKey: "your-custom-api-key"
+  model: "deepseek-chat"
+```
+
+等价环境变量：
+
+```bash
+VASM_LLM_API_KEY=...
+VASM_LLM_BASE_URL=...
+VASM_LLM_MODEL=...
+```
+
+`lang` 也会影响 VASMC 的交互日志语言；`llm` 只被 `@vasm/console` 的外部模型工具读取。