Cangjie Magic

英文版本

仓洁魔法：让应用程序增长智慧和创造力

______________________________________________________________________

• 仓洁魔法：让应用程序增长智慧和创造力

- 运行示例代码 - 使用教程 - API 手册 - 其他构建配置说明 - 构建选项 - 示例程序 - CangjieMagic官方开发者讨论群组 - 教程

运行示例代码

⚠️注意 目前代码仅在 Cangjie 0.56.4（通用版）和 0.53.18/4（鸿蒙外发版）上能够正确编译执行。如果使用了其他版本的 Cangjie SDK，可能需要直接修改项目源代码进行适配。

⚡快速开始

• 1️⃣ 通过 cjpm init 新建项目
• 2️⃣ 添加对本项目的依赖，需要修改新建项目的 cjpm.toml

- 推荐方式一：直接配置 git 依赖

    [dependencies]
      magic = { git = "https://gitcode.com/Cangjie-TPC/CangjieMagic.git", branch = "dev" }

- 方式二：下载本项目代码并配置本地源码依赖

    [dependencies]
      magic = { path = "" }

• 3️⃣ 拷贝如下代码至 main.cj 中，并在代码中设置大语言模型服务商的 API key。
• 4️⃣ 通过 cjpm run --name 运行

import magic.dsl.*
import magic.prelude.*
import magic.config.Config

@agent[model: "deepseek:deepseek-chat"]
class BlackCatAssistant {
    @prompt(
        "你是黑猫警长的助手"
        "当接到群众通知后，你需要唱起黑猫警长的专属 BGM 并安抚群众情绪"
    )
}

main() {
    Config.env["DEEPSEEK_API_KEY"] = ""

    let agent = BlackCatAssistant()
    let result = agent.chat("一只耳来啦")
    println(result)
}

📝 在使用本项目时，一般使用如下的 import 规则。

import magic.dsl.*
import magic.prelude.*

使用教程

👀 详见 docs/tutorial.md

❓ Magic 的各种 How-To 案例 docs/how-to.md

API 手册

👀 详见 docs/api_reference.md

其他构建配置说明

构建选项

在本项目的 cjpm.toml 中提供如下的条件编译选项

📌 额外说明

• 如果构建 faiss、sqlite 或是 llamacpp，需要构建对应的二进制库（详见 第三方libs.md），添加到目录（例如 ./ffi_libs）并修改 cjpm.toml。

  [ffi.c]
    sqlite = { path = "./ffi_libs/" }
    faiss_c = { path = "./ffi_libs/" }

• 如果使用 curl 发送 http 请求需要自行安装。

示例程序

在目录 src/examples 下有一些示例程序：

可以通过 cjpm run --name magic.examples. 运行。

MCP Server 集合示例：https://gitcode.com/Cangjie-TPC/CangjieMagic-MCPServer

CangjieMagic官方开发者讨论群组

欢迎加入官方开发者讨论者群组，一起交流碰撞创意想法，构建最具创意的Agent应用！

教程

大家可以在B站学习东北大学 张引 老师分享的教程 https://www.bilibili.com/video/BV1hQQzYAEHL/?spm_id_from=333.337.search-卡片。全部。单击&vd_source=ac4d1bb6a8e4a3751bba687720bd6fd9