Anlogic Tiller
为 Copilot Agent 提供安路 TD(FPGA)开发流程的 12 个技能,并一键接入两个 MCP 服务:anxinwen(知识检索)和本机 TD MCP(驱动 TD)。
| 你得到什么 |
需要做什么 |
12 个技能:anlogic-td 总入口,以及工程、IP、RTL lint、仿真、时序、I/O、综合、实现、位流、下载、硬件调试 |
安装即可用,不需要任何配置 |
| anxinwen 知识检索 |
粘贴一次个人 Token |
| TD MCP(驱动本机 TD) |
释放服务文件、填两项配置、启动、粘贴一次令牌 |
技能只给出流程和检查方法,不授权 TD 构建或板卡操作。三项互相独立,按需配置。
运行条件
- 桌面版 VS Code 1.109 或更高版本,已启用 GitHub Copilot Chat。
- anxinwen:个人 MCP Token(在安芯问获取)。能否连接取决于你所在的网络和管理员配置,连不上时只影响 anxinwen。
- TD MCP:Linux 机器,已安装 TD,有 Python 3.11 及以上。服务所需的 PyYAML 和 tomlkit 已随扩展提供,不用另外安装。
快速开始
第 1 步:安装,立即可用
在扩展面板搜索 Anlogic Tiller 安装,或运行 code --install-extension AnlogicTiller.anlogic-tiller。在 Copilot Chat 里把模式切到 Agent,直接描述需求,例如:
- “用 anlogic-td 技能帮我分析这份综合日志里的错误”
- “我的时序没收敛,帮我看一下 STA 报告”
第 2 步(可选):连接 anxinwen
- 按
Ctrl+Shift+P(macOS 为 Cmd+Shift+P),运行 Anlogic Tiller: 设置 anxinwen 令牌。
- 粘贴个人 Token,回车。
完成后,Agent 的工具列表里会出现 anxinwen。令牌只保存在 VS Code 的安全存储里。没有令牌时 anxinwen 不会出现,也不提供访客模式。
第 3 步(可选):连接本机 TD
- 运行 Anlogic Tiller: 释放 TD MCP 服务文件,选一个目录,文件会写到其下的
anlogic_eda_dock/。
- 在终端里:
cd <所选目录>/anlogic_eda_dock
cp mcp.env.example mcp.env
用编辑器打开 mcp.env,只改这三项:
PYTHON_BIN="/usr/bin/python3" # Python 3.11 及以上的绝对路径
TD_ROOT="/opt/td" # TD 安装根目录
AI_AGENT_CLIENTS="" # 留空,避免改写其他 AI 工具的配置
- 启动服务,并保持这个终端不关闭:
bash mcp.sh start
- 运行 Anlogic Tiller: 设置 TD MCP 令牌,粘贴
anlogic_eda_dock/.runtime/http.token 文件里的内容。
完成后,工具列表里会出现 Anlogic Tiller (TD MCP)。VS Code 和 TD 不在同一台机器(例如 Windows 连 Linux 服务器)时,见下面“VS Code 与 TD 不在同一台机器”。
详细说明
mcp.env 的各项
| 配置项 |
说明 |
PYTHON_BIN |
必填。Python 3.11 及以上可执行文件的绝对路径 |
TD_ROOT |
必填。TD 安装根目录,其下有 bin/td.sh 或 bin/td |
MCP_PORT |
默认 8765;改端口后要同步改设置 anlogicDock.td.mcpUrl |
AI_AGENT_CLIENTS |
填 ""。默认的 auto 会把服务注册到 Codex、Copilot CLI 等工具的用户配置里 |
“释放 TD MCP 服务文件”只写文件,不启动服务、不创建 mcp.env。已释放过的目录再次运行时,会先确认,只更新服务文件,保留你的 mcp.env 和 .runtime。升级扩展后重新运行一次,才会更新已释放的服务。服务正在运行时,更新前先执行 bash mcp.sh stop。
VS Code 与 TD 不在同一台机器
释放命令在 VS Code 所在的机器上写文件,所以先把释放出的 anlogic_eda_dock/ 目录复制到 TD 所在的 Linux 机器,在那里完成上面的第 2、3 步。然后在 VS Code 所在机器的终端建立 SSH 隧道并保持运行:
ssh -N -L 8765:127.0.0.1:8765 <用户名>@<服务器地址>
本机的 8765 端口被系统拒绝时,把前一个 8765 换成其他空闲端口,例如 18765,并把设置 anlogicDock.td.mcpUrl 改成 http://127.0.0.1:18765/mcp。要先改设置,再设置令牌,因为令牌只会发给设置它时的地址。
出问题时
运行 Anlogic Tiller: 检查安装状态,会输出扩展版本、设置、两个令牌是否已保存和旧版残留,不输出令牌内容。
| 现象 |
处理 |
工具列表里没有 anxinwen |
还没设置令牌,运行“设置 anxinwen 令牌” |
| 提示无法验证 TD MCP 的令牌 |
服务没启动或隧道断了:确认 bash mcp.sh start 的终端和隧道都在运行,再重试;也可点“仍然保存”,之后第一次使用时再验证 |
| 提示令牌连续 3 次被服务拒绝,未保存 |
令牌和服务不匹配,重新复制 .runtime/http.token 的当前内容 |
| 改了服务地址后调用失败 |
令牌只发给设置它的地址,换地址后重新运行“设置令牌” |
| 想更换或删除令牌 |
运行对应的“清除令牌”命令,再重新设置 |
命令
| 命令 |
作用 |
| 设置 / 清除 anxinwen 令牌 |
校验后保存或删除 anxinwen 令牌 |
| 设置 / 清除 TD MCP 令牌 |
校验后保存或删除 TD MCP 令牌 |
| 释放 TD MCP 服务文件 |
把随包的 TD MCP 服务文件(含 PyYAML、tomlkit 的纯 Python 源码)写到你选的目录下的 anlogic_eda_dock/,不启动服务 |
| 打开 TD MCP 运行目录 |
在文件管理器中打开 <anlogicDock.td.serviceRoot>/.runtime |
| 检查安装状态 |
输出版本、设置、令牌是否已保存、旧版残留;不输出令牌 |
设置
| 设置 |
默认值 |
说明 |
anlogicDock.anxinwen.url |
https://ai.anlogic.com/anxinwen/mcp/ |
只接受 https |
anlogicDock.td.mcpUrl |
http://127.0.0.1:8765/mcp |
只接受 https,或回环地址的 http |
anlogicDock.td.serviceRoot |
空 |
释放出的 anlogic_eda_dock 目录的绝对路径,仅供“打开 TD MCP 运行目录”使用 |
更换服务地址的来源(协议、主机、端口)后,已保存的令牌不会发送到新地址,需要重新设置。
令牌与隐私
- 令牌只存于 VS Code 的
SecretStorage,不写文件、不写 mcp.json、不写日志。
- 保存令牌和启动服务前,扩展会向服务发一次
initialize 请求校验令牌;返回 401 时清除令牌并重新询问,最多 3 次;连接失败只报告原因,不清除令牌。
- 扩展不启动、不停止 TD MCP,不运行 TD,也不修改你的
mcp.json、~/.copilot 或其他 AI Agent 工具的配置。发现旧版安装留下的同名服务或技能时,只提示一次。
当前限制
- 令牌放入 MCP 定义请求头并被转发的行为,已在 Windows 本机的 Copilot 和 Local 两种运行方式(harness)下用 anxinwen 验证;TD MCP 已在 Local 运行方式下经 SSH 隧道验证,Copilot 运行方式下尚未验证。
- “释放 TD MCP 服务文件”命令尚未在真机上验证;Remote-SSH 窗口下的行为未验证。
- 技能在列表中可见,被实际调用的情况尚未验证。
- 不提供访客模式:服务端对没有令牌的请求会降级为访客,所以扩展在没有令牌时不提供 anxinwen 的服务定义。