Files
marqdo/doc/design/stdlib-foreign.md
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

1.4 KiB
Executable File
Raw Blame History

外联 / 胶水标准库

状态 v1 已落地;v2 设计见 foreign-kernel.md · notebook-session.md · notebook-syntax.md
日期 2026-08-06
相关 stdlib-modules.md · stdlib-math.md(公式同构绑定) · foreign-kernel.md · notebook-session.md · roadmap/foreign-v2.md

1. 原则

导入即用:lib/foreign / lib/外联。解释器来自用户本机(PATH / set_cmd / MARQDO_FOREIGN_*)。live view 可点 Run;静态导出展示源码,Run 禁用。


2. 绑定语法(与公式同构)

`hi` =
```python
print("hello")

*out = > run code=hi *


得到运行时类型 **`code`**(`lang` + `source`)。未绑定的 \`\`\` 围栏仍是叙述注释。

曾用的 \`\`\`python name=hi **已移除**。

---

## 3. API

| 英文 | 中文 | 形参 | 结果 |
|------|------|------|------|
| `set_cmd` | `设置命令` | `lang`, `cmd` | None |
| `run` | `运行` | `code`(code 值) | 文本 stdout |
| `run_lang` | `按语言运行` | `lang`, `source` | 文本 |
| `langs` | `语言表` | | 列表 |

live view:Structure 中 code 卡片带命令框 + Run → `POST /api/foreign-run`。

---

## 4. 一句话

**`name` = + \`\`\`lang 围栏 → code 值;显式 run;本机解释器可配置。**